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

Question

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

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

Answer 3

Полагаю, вам нужно расширить переводчик HTML Writer или Writer, чтобы включить GA.

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

Answer 4

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

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