如何将Google Analytics添加到reStructuredText？

Question

我正在使用reStructured文本来创建一些简单的网站。 所以我有很多* .rst文件，我想在其中添加Google Analytics代码。 但据我所知，不可能添加这样的东西？！

我使用rst2html将文件转换为html。

Answer 1

我刚刚发现了一种向.rst文件添加自定义内容的简便方法。您只需要修改html文件的模板即可。

制作一个新模板template.txt及其以下内容（基于默认模板）：

%(head_prefix)s
%(head)s
<!--your tracking code-->
%(stylesheet)s
%(body_prefix)s
%(body_pre_docinfo)s
%(docinfo)s
%(body)s
%(body_suffix)s

格式非常自我解释，它也是删除默认CSS并指定模板等中另一个链接的好方法。

现在，您可以将自定义模板与rst2html编写器一起使用：

rst2html.py --template=template.txt document.rst

Answer 2

我想，您必须将docutils HTML Translator或Writer扩展为包含GA。

如果可能的话，我建议放弃rst2html和普通的docutils并改用Sphinx。它基于docutils，但功能更强大。它的HTML模板可以轻松扩展，以包含任意HTML，如Google Analytics的脚本标记。

Answer 3

您可以使用.. raw:: directive将html插入rst文件。

Answer 4

作为解决问题的方法，您可以使用批量搜索/替换工具将分析代码添加到文件后，通过翻译器。只需搜索</body>代码并将其替换为<!--your tracking code--></body>。

我检查了你是否可以在reStructuredText中包含原始HTML（并且不受影响），但似乎不可能......