问题标签 [mkdocs]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
237 浏览

python - 在循环中修改的变量不会在循环外持续存在

{{ title_mod }}尽管在循环中连接,但它是一个空字符串。如何{{ title_mod }}在 for 循环外检索更新?

0 投票
1 回答
492 浏览

python - 如何使用第三方 python 插件\扩展?

我在文档上读到只有很少的插件被预装在构建发生的 virtualenv 中。那么如何使用带有自定义插件的阅读文档服务呢?

mkdocs用来构建一些文档,在mkdocs.yml配置文件中我添加了以下扩展:

在本地环境中,提供的预览mkdocs serve工作正常,当部署以读取文档(通过连接的 github 存储库)时,构建失败,因为它找不到pymdownx插件,但我认为 RTD 会自动获取它们构建环境中存在的默认插件。

0 投票
1 回答
4936 浏览

html - 在 mkdocs 中使用静态 html

是否有在 Markdown 文件中使用 HTML 的解决方案 - 或显示一个纯 HTML 的整个额外页面的选项?

问题:我想在我的 mkdocs 生成的 wiki 中包含一个 html 片段,该 wiki 使用了一些内联 Javascript。

试过:我已经搜索了几个小时,在这里或官方文档中找不到答案。

0 投票
1 回答
251 浏览

caching - mkdocs 模板中是否有 cachebust 变量?

有什么类似{{ time() }}甚至更理想{{ sha1sum('main.js') }}的东西可以用作我的主题模板中的 cachebust 参数吗?

是的,我知道服务器端缓存标头,但我无法控制这些标头。

0 投票
2 回答
2053 浏览

markdown - 有没有办法用 Markdown 语言对标题、部分和小节进行编号?

我想用 Markdown 语言对标题、部分和小节进行编号。因此 TOC 如下所示:

我正在使用 MKDOCS 创建我的静态网页 apython 包。是否有任何降价扩展可以做到这一点?

刚开始使用markdown语言,欢迎任何帮助和建议。

0 投票
1 回答
1308 浏览

mkdocs - Mkdocs 超链接在静态页面中不起作用

我正在尝试使用 mkdocs 构建文档。问题是静态创建页面中的链接不起作用。我没有转到 [folder]/index.html,而是显示如下页面,如下图所示

但是,当我尝试 mkdocs 服务时,问题不存在

0 投票
1 回答
1181 浏览

web - mkdocs:如何创建类似文件夹的结构

我想用我的个人讲义创建一个小的本地文件。我想要的结构是

索引 1(包含子文件夹的概述,但不是它们的全部内容) 索引 1.1(包含子文件夹的概述,但不是它们的全部内容) 索引 1.1.1(包含部分的内容)

目前我的 mkdocs.yml 看起来像

但是前面的代码并没有像我想要的那样显示它。

0 投票
0 回答
427 浏览

special-characters - mkdocs 如何将德语变音符号与 Mathjax 结合使用?

我想使用 Mathjax 在 mkdocs 中键入以下公式

问题是我正在使用的德语变音符号ä。如果我删除它,那么一切都很好。我试图更换它,但它不起作用。

  • \text{音量{\"a}nderungsarbeit}
  • \text{音量"anderungsarbeit}
  • \text{音量}{\"a}\text{nderungsarbeit}
  • \text{音量\"anderungsarbeit}
0 投票
3 回答
1010 浏览

plugins - MKDOCS - 如何根据内容中的关键字启用超链接?

我正在使用MkDocs,我的问题是 - 我知道在文档文件中我可以说: [My Link Name](My link URL)

但是当我想改变我的导航或改变我的关键词时,这真是太麻烦了。

任何人都可以建议一个插件 - 在构建文档时,自动查找与mkdocs.yml文件中的关键字匹配的关键字并创建指向它们的超链接。

提前致谢!

0 投票
1 回答
39 浏览

codeship - mkdocs 站点在基于 codeship 构建后不存在

我正在尝试使用 codeship 自动从存储库构建文档。在执行命令之后,mkdocs build --clean我得到了我的站点文件夹应该在的路径。

问题是我无法使用 ssh 控制台进行调试找到该文件夹​​。