3

给 mdbook 增加备案号显示

 1 year ago
source link: https://www.ixiqin.com/2023/07/25/add_id_into_mdbook/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client
rustlang

给 mdbook 增加备案号显示

由于 Gitbook 长期不维护，为了保障整个架构持续可用，所以导致我不得不从 Gitbook 迁移到 mdbook。

在使用 mdbook 的时候，有个问题是，我的不少电子书域名都是备案过后的，mdbook 又不像 gitbook 支持可以在目录里跳转外链，因此我需要自己实现给 mdbook 添加一个外链。

由于没办法直接通过在 Markdown 当中实现跳转外链，那么一个比较简单粗暴的方法就是直接在模板当中添加，刚好 mdbook 在文档中有说明具体的操作方法。

你只需要在 mdbook 的根目录中创建一个 theme 文件夹，并生成一个 index.hbs 文件，用于渲染页面。

接下来，你只需要在适当的位置添加上你需要的代码即可（下方的 toc 后面的 有序列表便是我手动添加的）

   <nav id="sidebar" class="sidebar" aria-label="Table of contents">
            <div class="sidebar-scrollbox">
                {{#toc}}{{/toc}}

                 <ol class="chapter">
                    <li class="chapter-item expanded "><a href="https://beian.miit.gov.cn/" target="_blank">这里是你的备案号</a></li>
                </ol>

            </div>
            <div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>

        </nav>

https://github.com/rust-lang/mdBook/issues/1354

本条目发布于2023年7月25日。属于技术分类，被贴了 mdbook、Rust、随笔 标签。 ← 淄博之旅 云南之旅支出分析 →

发表回复 取消回复

您的电子邮箱地址不会被公开。 必填项已用*标注

评论 *

显示名称 *

电子邮箱地址 *

网站地址

在此浏览器中保存我的显示名称、邮箱地址和网站地址，以便下次评论时使用。

如果有人回复我的评论，请通过电子邮件通知我。


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK