javascript - 将脚本标签添加到降价文件

Question

我正在 MKdocs 中开发文档，需要将一些脚本文件加载到我的 markdown 文件中。如何在markdown中添加js函数和脚本标签？

Answer 1

你有两个选择：你可以在你的 Markdown 中包含原始的 HTML<script>标签，或者你可以使用 MkDocs 的extra_javascript设置来指向你自己的 JavaScript 文件。

使用原始 HTML

正如 Markdown 文档所解释的：

对于 Markdown 语法未涵盖的任何标记，您只需使用 HTML 本身。无需为它加上前缀或定界以表明您正在从 Markdown 切换到 HTML；您只需使用标签。

唯一的限制是块级 HTML 元素（例如 <div>、<table>、<pre>、<p>等）必须用空行与周围的内容隔开，并且块的开始和结束标记不应使用制表符或空格缩进。

当然，任何此类脚本对于包含它们的一页都是唯一的。

利用extra_javascript

如果您希望脚本在所有页面上可用，MkDocs 提供了extra_javascript配置设置，这将导致script指向指定文件的 a which 包含在每个页面上。只需确保该文件在您的docs_dir.

例如，如果您创建一个文件myscript.js，则将以下内容添加到您的mkdocs.yml配置文件中：

extra_javascript:
    myscript.js