Repository navigation
[PR] feat: website article library — sync repository long-form markdown into the site - #4564
ranxianglei wants to merge 2 commits into
Conversation
…to the site - shared rendering kit tools/lib/md-web.mjs (markdown subset renderer, frontmatter, page shell) extracted from tools/build-blog.mjs; blog output byte-identical apart from the new 文库 nav link and cross-links - tools/build-articles.mjs + website/articles.json manifest: renders listed repo sources (paper/, root *.md, ...) into website/docs/articles/ with bilingual twins, per-page source links, copied local media under website/docs/assets/<slug>/ explicit-over-implicit: only listed files are ever published - seeded with the paper preprint (EN + 中文) - pages.yml: re-render at deploy time, extra trigger paths for article sources, */30 scheduled refresh so published articles lag master by at most half an hour
📦 Built Package ArtifactBranch: Latest build — install this exact versionnpm install -g billion-context@0.0.5526-pr.4564.dcb496fThis exact version is immutable and reproducible. The rolling Recent builds (commit → version)
Download artifact
tar xzf billion-context-pr4564.tgz
npm install -g packageInstall instructions are refreshed on each push. |
…in docs/assets/, sibling of docs/articles/
(ai: vllm-qwen/qwen3.8-27b) 查重:不重复。 open/closed issue 与 PR 里检索「article library / website / blog / pages.yml / docs articles」均无同主题条目;本 PR 对应原始需求 #4561(官网缺长文同步),是第一个实现它的 PR。 已拉取分支 |
(ai: vllm-qwen/qwen3.8-27b) 标签: pr(原有)+ scope/ui + p3(功能票,站点展示面,无缺陷)。 审核完成。方向、回归面、代码、CI 四关都过了一遍,结论如下。 结构化八问
顺带发现(均已处置为备注,无需动作)
判定代码层面可合。本 PR 专属的所有 CI 道(guards/static-gates/e2e 全系/lock-sync/docs-sync/config-surface-guard/Build Artifact)全绿;test shard 的红是 #4591 家族的存量 master 红,base 上同签名复现,与 diff 零交集。建议等 master 测试道转绿后合并,或你认定存量红已有人接手就直接合——合并不受本 PR 自身质量阻碍。 |
[bot] 🏷 PR #4564 can't be mechanically rebased — the "conflict" is two owner-level design decisions colliding, not a textual merge. I did a dry-run rebase onto current master ( 3 conflicting files, 2 root causes: Root cause 1 — the PR's premise is blocked by #4598.
Root cause 2 —
A naive union would: (a) render the two blog posts into BOTH Options:
Recommendation: A (hold) as the default — re-enabling Pages auto-deploy is explicitly gated on the owner's "publishing direction" decision (#4598), which isn't the CI engineer's call, and the manifest is double-booked either way. If you want forward motion now, C is the cleanest mechanical path — I can do the manifest split + keep the suspension the moment you confirm. Not done (per the auto-fix lane): no force-push, no behavior change, no new issue. |
[ework] CI fix verified green ✓ |
4 similar comments
[ework] CI fix verified green ✓ |
[ework] CI fix verified green ✓ |
[ework] CI fix verified green ✓ |
[ework] CI fix verified green ✓ |
[bot] 🏷 Re-verified live this run: PR head unchanged ( The two blocking owner decisions are unchanged:
Recommendation unchanged: A (hold) as the default; C (split the manifest) is the cleanest forward path if you want motion now — I can do the manifest split + keep the suspension the moment you confirm. |
[ework] CI fix verified green ✓ |
2 similar comments
[ework] CI fix verified green ✓ |
[ework] CI fix verified green ✓ |
[bot] 🏷 New this run: checked the branch head per the CI-hold push discipline — it is the original PR head ( Live state unchanged: The two blocking owner decisions are unchanged: (1) #4598 publishing direction (re-enable Pages auto-deploy vs. keep suspended), and (2) the double-booked |
[bot] 🏷 Live state unchanged this run: Recommendation unchanged: A (hold) as the default; C (split the manifest) is the cleanest forward path if you want motion now. |
[ework] CI fix verified green ✓ |
2 similar comments
[ework] CI fix verified green ✓ |
[ework] CI fix verified green ✓ |
[bot] 🏷 Live state unchanged: Recommendation unchanged: A (hold) as the default; C (split the manifest) is the cleanest forward path if you want motion now. |
[ework] CI fix verified green ✓ |
这是什么
官网新增「文库」/docs/articles/:仓库里的长文(paper、根级 *.md 等)按显式清单渲染成静态页上站,由 CI 定时重新发布,文章改动最多半小时出现在站上。
改动
tools/lib/md-web.mjs(新)——从 build-blog 抽出的共享渲染器/页壳(markdown 子集解析、frontmatter、四链接顶栏)tools/build-blog.mjs——变薄壳引用共享模块;输出除新增导航与互链外逐字节不变(重跑两次 md5 全同验证)tools/build-articles.mjs(新)+website/articles.json(新)——清单驱动的同步构建器:双语孪生、每页 source on GitHub 溯源链接、相对路径图片自动拷贝到 docs/assets//、只发清单里列的(显式优于隐式,devlog 之类默认不上站)pages.yml——每次部署先全量重渲染(不信任提交旧 HTML);触发路径扩到文章源目录/根级 *.md/构建脚本;新增 cron */30 定时重发不变的东西
站点本体仍零外部依赖纯静态;访问端无任何运行时网络请求;不碰 bili 配置面(无 config surface 变化);package.json version 未动。
验证
Closes #4561