Repository navigation
fix(docs): 修复 6 条构建告警,使 mkdocs build --strict 通过 - #174
Closed
SZ-lizhouyi wants to merge 1 commit into
Closed
SZ-lizhouyi wants to merge 1 commit into
SZ-lizhouyi wants to merge 1 commit into
Conversation
Contributor
|
是一个合理的修复方案 |
donghaiwang
requested changes
Oct 13, 2026
donghaiwang
left a comment
Member
There was a problem hiding this comment.
PR信息不能直接用大模型输出,输出太多废话,干扰人的阅读
|
|
||
| ## 1. 简介 <span id="list"></span> | ||
|
|
||
| - [OpenHUTB 模拟器简介](./simulator.md) |
Member
There was a problem hiding this comment.
这是该仓库已有的内容,一般不能删除,即使删除也需要给出理由
|
|
||
| - [Markdown 一键发到各个社交平台](./markdown2anything.md) | ||
|
|
||
| - [宣传](./propagate.md) |
Member
There was a problem hiding this comment.
这是该仓库已有的内容,一般不能删除,即使删除也需要给出理由
5 tasks done
SZ-lizhouyi
force-pushed
the
fix/strict-build-warnings
branch
from
October 20, 2026 10:52
5f1a480 to
651c970
Compare
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
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.
mkdocs build --strict有 2 条误报,退出码 1:docs/index.md第 66 行:YouTube 链接https://www.youtube.com/@OpenHUTB里的@OpenHUTB被当成引用键docs/bib_reference_guide.md第 60 行:代码块里的@article{example1,被当成引用键bibtex 插件的行内引用解析不跳过代码块,
@后面跟字母就当引用键。仓库里没有页面使用[@key]这种写法,所以在mkdocs.yml里把它关掉。改动 1 个文件 +1 行。本地
mkdocs build --strict:退出码 1 → 0,告警 2 → 0。改前改后各构建一次,26 个页面逐个对比,除构建时间戳外输出完全一致。