如何在服務器上製作reStructuredText渲染器，通過瀏覽器訪問來實現它？

Question

我有一些rst格式的文檔，想通過apache像簡單的html頁面一樣分享它。用於渲染的最佳工具 - 來自python-docutils的rst2html。但是，我仍然不知道如何把這些東西放在一起。 因此，如果我在瀏覽器中輸入uri，像這樣：myhost/public_docs/doc1.rst它會向我展示漂亮的呈現文檔。

Answer 1

我已經做到了！這裏有一個簡單的解決方案：

1）安裝python-docutils的有可用的rst2html腳本（如果未安裝）

2）找出包含內容目錄不同CONFIGS爲你的httpd（Apache）的版本，在我的Fedora：

ScriptAlias /cgi-bin/ /var/www/cgi-bin/ 
Action RSTHandler /cgi-bin/rst2html.sh 
AddHandler RSTHandler .rst 

：與內容/etc/httpd/conf.d/*.conf

3）在這裏添加自己的conf文件（如/etc/httpd/conf.d/docs_rst.conf）

4）根據此配置將文件rst2html.sh添加到/ var/www/cgi-bin /內容：

#!/bin/sh 
echo "Content-type: text/html" 
echo "" 
/usr/bin/rst2html /var/www/html/${REQUEST_URI} 
exit 0 

5）現在你可以把任何文件首先將在/ var/www/html等，並通過瀏覽器訪問它（在我的情況下，任何文件夾：本地主機/文檔/ test.rst）

附：不要忘記重新加載httpd來應用配置文件中的所有更改！