Как добавить Google Analytics в reStructuredText?

Я только что обнаружил простой способ добавления пользовательского содержимого в файлы .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

Я думаю, вам придется расширить docutils HTML Translator или Writer, чтобы включить GA.

Если возможно, я бы рекомендовал отказаться от rst2html и обычных docutils и вместо этого использовать Sphinx. Он основан на docutils, но гораздо мощнее. Его HTML-шаблоны можно легко расширить, включив в них произвольные HTML-теги, такие как скриптовые теги для Google Analytics.

Вы можете вставить html в первые файлы, используя . .raw:: директива.

В качестве решения вашей проблемы вы можете использовать инструмент массового поиска/замены, чтобы добавить код Google Analytics в файлы после их обработки переводчиком. Просто найдите тег </body> и замените его на <!--your tracking code--></body>.

Я проверил, можно ли включить необработанный HTML в reStructuredText (и оставить его нетронутым), но это не представляется возможным...