fix: update template by mdbook v0.4.52#85
Merged
RadxaYuntian merged 4 commits intoSep 5, 2025
Conversation
mdbook v0.4.41 后修改了加载侧边栏目录的逻辑，需要同步修改模板。目前模板与部署时使用的 mdbook 版本不匹配导致侧边栏链接错误。通过 mdbook init --theme 生成新模板替换目前模板。 link: rust-lang/mdBook#2414
Contributor
Author
|
fixes #86 |
Contributor
|
Fixes要写在PR正文或者提交消息里面才有效果 |
Contributor
Author
哭 |
RadxaYuntian
requested changes
Sep 4, 2025
RadxaYuntian
left a comment
RadxaYuntian
left a comment
Contributor
There was a problem hiding this comment.
另外也要把src/share/rsdk/infra-package里面的docs workflow和devenv.lock更新，去使用devenv提供的mdbook
chenchongbiao
force-pushed
the
20250904-update-mdbook-version
branch
2 times, most recently
from
6ba6ba9 to
64f7872
Compare
chenchongbiao
force-pushed
the
20250904-update-mdbook-version
branch
from
64f7872 to
d4c28ee
Compare
Contributor
Author
RadxaYuntian
requested changes
Sep 5, 2025
RadxaYuntian
left a comment
RadxaYuntian
left a comment
Contributor
There was a problem hiding this comment.
不是说要用devenv的环境来配置mdbook,不要在workflow里面安装了么
https://devenv.sh/integrations/github-actions/#run-multiple-commands
Contributor
|
另外如果devenv的安装有问题的话，可以参考这里在我们devcontainer里面运行，这里面会预装devenv |
Contributor
Author
搞定了，没注意根根目录也配了个，只改了 rsdk/src/share/rsdk/infra-package 里面的 |
Contributor
|
根目录的是rsdk自己实际使用的，usr/share里面是用于更新其他仓库的模板 |
Contributor
Author
1 |
chenchongbiao
force-pushed
the
20250904-update-mdbook-version
branch
from
d4c28ee to
6e07b1a
Compare
Contributor
Author
RadxaYuntian
reviewed
Sep 5, 2025
指定 mdbook 的版本, 避免后续 mdbook 更新版本与模板不匹配引入错误, 本地版本与部署版本保持一致, 方便发现问题. workflows 使用 devenv 运行运行环境.
chenchongbiao
force-pushed
the
20250904-update-mdbook-version
branch
from
6e07b1a to
8f6b6ab
Compare
RadxaYuntian
approved these changes
Sep 5, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
1.mdbook v0.4.41 后修改了加载侧边栏目录的逻辑, 需要同步修改模板. 目前模板与部署时使用的 mdbook 版本不匹配导致侧边栏链接错误. 通过 mdbook init --theme 生成新模板替换目前模板.
2.giscus 客户端和语言切换按钮单独提交, 方便比对与模板的差异.
3.git restore 操作应该根据 po 文件的 PO-Revision-Date 字段, POT-Creation-Date 字段是创建时的时间, 后续更新 po 文件应该手动或者自动化工具更新 PO-Revision-Date 字段, 保证 git restore 还原 docs 文件夹到指定时间.
4.指定 mdbook 的版本, 避免后续 mdbook 更新版本与模板不匹配引入错误, 本地版本与部署版本保持一致, 方便发现问题.
link: rust-lang/mdBook#2414
fix #86