2010-07-04 49 views

回答

7

我剛剛發現了一種將自定義內容添加到.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 
2

我猜你必須擴展docutils HTML Translator或Writer以包含GA。

如果可能,我建議放棄rst2html和普通文檔,並使用Sphinx來代替。它基於docutils,但功能更強大。其HTML模板可以很容易地擴展爲包含任意HTML,如Google Analytics的腳本標記。

+0

我會看看獅身人面像。謝謝。 – Mark 2010-07-06 11:44:37

+1

Sphinxis非常適合用於手冊,但對於您可能更喜歡rest2web的網站http://www.voidspace.org.uk/python/rest2web/ – 2010-07-06 17:12:04

1

作爲解決您問題的解決方法,您可以使用海量搜索/替換工具將Google Analytics代碼添加到之後的文件他們已經通過翻譯器。只需搜索</body>標籤並將其替換爲<!--your tracking code--></body>即可。

我檢查,看看是否可以包含在新結構化原始的HTML(並且有它被改動),但它似乎並不可能......

+0

實際上,您可以使用'.. comment'語法在RST中添加不可見文本,它將被轉換爲轉換爲HTML – mykhal 2010-07-05 02:10:45

+2

的評論我不認爲你可以包括HTML標記...這是一條評論。 – alecwh 2010-07-05 02:30:53

+0

好主意!謝謝。但我需要更全面的東西。 – Mark 2010-07-06 17:58:27

2

可以插入HTML使用.. raw:: directive第一個文件。

+0

不幸的是我需要將HTML添加到標題。據我所見,這是不可能的原始::指令?! – Mark 2010-07-06 16:14:30

+0

在GA的情況下,您不需要將代碼添加到標題中,但恰好在標記之前,這意味着您將其放置在.rst文檔的末尾。 – 2010-07-06 16:31:57

+0

Google說: 請複製下面的代碼,然後將其粘貼到您要在關閉頭標記之前立即跟蹤的每個頁面上。 但我也發現這個: http://www.google.com/support/analytics/bin/answer.py?hl=zh_CN&answer=55488 我想將它添加到標題更好... – Mark 2010-07-06 18:07:02

相關問題