小编Cyb*_*ead的帖子

如何向 Markdown 导航文件 (mkdocs.yml) 中的树节点添加永久链接?

我正在使用的 mkdocs.yml nav 文件包含手册网站的层次结构树,其中包含内容文章所属的多个类别和子类别;该树绝对是虚拟的,不基于文件夹结构/网站路径。我正在寻找一种为每个树节点(类别)生成永久链接的方法。如果 Markdown 或其扩展不可能做到这一点,那么也许可以使用 html/css 元素。

我对 Markdown 和 mkdocs 很陌生;我彻底用谷歌搜索来找到解决方案,但未能找到。

site_name: My Site
site_dir: docs/guides/
site_url: http://example.net/
docs_dir: 'src'
nav:
  - 'TOP LEVEL CATEGORY':
    - 'BOTTOM LEVEL CATEGORY':
         - Manual 1: 'manuals/Manual1.md'
         - Manual 2: 'manuals/Manual2.md'
    - 'BOTTOM LEVEL 2':
{...}
  - 'TOP LEVEL CATEGORY 2':
{...}

markdown_extensions:
    - smarty
    - toc:
        permalink: True
        separator: "_"
    - sane_lists
    - tables
    - meta
    - fenced_code
    - admonition
    - footnotes
Run Code Online (Sandbox Code Playgroud)

构建的具有可扩展节点的虚拟层次树是可以的,但我确实需要为每个类别和子类别生成永久链接,例如 example.net/docs/guides/toplevelcat/bottomlevelcat 或 example.net/docs/guides/toplevelcat# Bottomlevelcat 链接的组织方式以及它们是自动生成还是手动预设并不重要

该链接可能会指向包含属于该类别的所有手册的索引页面,或者仅显示根mysite.net/docs/guides/页面,并展开所需的类别

markdown mkdocs

5
推荐指数
1
解决办法
2559
查看次数

标签 统计

markdown ×1

mkdocs ×1