我正在使用材料mkdocs。它在一个网站上运行得很好。我现在想基于相同的内容生成两个不同的站点,只需通过定制mkdocs配置文件中的nav:来选择性地选择每个站点中的内容。

目标:

  • 站点1:目标受众A(显示所有页面,所有导航)
  • 站点2:目标受众B(仅显示1页,非常简单的导航)

我通过以下方式实现了这一点:

站点1=mkdocs build -v -d builtdocs_site1 -f /docs/mkdocs-site1.yml

站点2=mkdocs build -v -d builtdocs_site2 -f /docs/mkdocs-site2.yml

  1. mkdocs-site1.yml
nav:
  - Home: 
    - Home: index.md
    - More: more.md
    - more2: more2.md
    - lotsmore: lotsmore.md
  1. mkdocs-site2.yml
nav:
  - Home: 
    - Justone: index.md

这将导致:

Site1:当我打开/docs/builtdocs_site1/index.html时,我看到4个导航选项,这是预期/期望的结果。

站点2:当我打开/docs/builtdocs_site2/index.html时,我看到1导航选项,这是预期/期望的结果。

问题:

当我构建这些站点时,输出包括所有文件,而不管在相应yml文件的nav:部分中指定了什么。

站点1:

/docs/builtdocs_site1/
- index.html
- more.html
- more2.html
- lotsmore.html

站点2:

/docs/builtdocs_site1/
- index.html
- more.html
- more2.html
- lotsmore.html

这意味着site2实际上拥有site1中的内容,即使它不容易访问(没有链接),但任何可以列出/查看目录的人都可以访问它(在我的情况下,由于各种原因,这是正确的)。

如何将mkdocs配置为仅生成nav:中指定的文件?

mkdocs构建输出包含所有不应包含的文件的更多相关文章

  1. mkdocs构建输出包含所有不应包含的文件

    我正在使用材料mkdocs。我现在想基于相同的内容生成两个不同的站点,只需通过定制mkdocs配置文件中的nav:来选择性地选择每个站点中的内容。目标:站点1:目标受众A站点2:目标受众B我通过以下方式实现了这一点:站点1=mkdocsbuild-v-dbuiltdocs_site1-f/docs/mkdocs-site1.yml站点2=mkdocsbuild-v-dbuiltdocs_site2-f/docs/mkdocs-site2.ymlmkdocs-site1.ymlmkdocs-site2.ym

随机推荐

  1. 如何扩展ATmega324PB微控制器的以下宏寄存器?

    我目前正在学习嵌入式,我有以下练习:展开以下宏寄存器:如果有人解决了这个问题,我将不胜感激,以便将来参考

  2. Python将ONNX运行时设置为返回张量而不是numpy数组

    在python中,我正在加载预定义的模型:然后我加载一些数据并运行它:到目前为止,它仍在正常工作,但我希望它默认返回Tensor列表,而不是numpy数组。我对ONNX和PyTorch都是新手,我觉得这是我在这里缺少的基本内容。这将使转换中的一些开销相同。

  3. 在macOS上的终端中使用Shell查找文件中的单词

    我有一个文本文件,其中有一行:我需要找到ID并将其提取到变量中。我想出了一个RexEx模式:但它似乎对我尝试过的任何东西都不起作用:grep、sed——不管怎样。我的一个尝试是:我为这样一个看似愚蠢的问题感到抱歉,但我在互联网上找不到任何东西:我在SO和SE上读了几十个类似的问题,并在谷歌上搜索了几个教程,但仍然无法找到答案。欢迎提供任何指导!

  4. react-chartjs-2甜甜圈图中只有标题未更新

    我正在使用react-chartjs-2在我的网站中实现甜甜圈图。下面是我用来呈现图表的代码。我将甜甜圈图的详细信息从父组件传递到子组件,所有道具都正确传递。当我在beforeDraw函数外部记录props.title时,它会记录正确的值,但当我在beforeDraw函数内部记录props.title时,它将记录标题的前一个值,从而呈现标题的前值。我在这里做错了什么?

  5. 如何在tkinter中使用Python生成器函数?

    生成器函数承诺使某些代码更易于编写。但我并不总是知道如何使用它们。假设我有一个斐波那契生成器函数fib(),我想要一个显示第一个结果的tkinter应用程序。当我点击“下一步”按钮时,它会显示第二个数字,依此类推。我如何构建应用程序来实现这一点?我可能需要在线程中运行生成器。但如何将其连接回GUI?

  6. 如何为每次提交将存储库历史记录拆分为一行?

    我正在尝试获取存储库的历史记录,但结果仅以单行文本的形式返回给我。

  7. 尝试在颤振项目上初始化Firebase时出错

    当尝试在我的颤振项目上初始化firebase时,我收到了这个错误有人知道我能做什么吗?应用程序分级Gradle插件Gradle项目颤振相关性我已经将firebase设置为Google文档已经在另一个模拟器上尝试过,已经尝试过创建一个全新的模拟器,已经在不同的设备上尝试过了,已经尝试了特定版本的firebase,已经尝试添加但没有任何效果,已经在youtube上看到了关于它的每一个视频,该应用程序在android和iOS两个平台上都抛出了这个错误

  8. 在unix中基于当前日期添加新列

    我试图在unix中基于时间戳列在最后一个单元格中添加一个状态列。我不确定如何继续。

  9. 麦克斯·蒙特利。我一直得到UncaughtReferenceError:当我在终端中写入node-v时,节点未定义

    如果这是您应该知道的,请确认:我已将所有shell更改为默认为zsh。当我在终端中写入node-v时,我一直收到“UncaughtReferenceError:nodeisnotdefined”。但它显示节点已安装。我是个新手,在这方面经验不足。

  10. 如何在前端单击按钮时调用后端中的函数?

    那么如何在后端添加一个新的端点,点击按钮调用这个函数。

返回
顶部