很少人用 rst (reStructuredText) ä¾†ç•¶æ–‡ä»¶æ ¼å¼ã€‚
ä¸éŽï¼Œrst 很棒ï¼é™¤äº†é‚„çœ‹ä¸æ‡‚ TeX 數å¼ä¹‹å¤–,幾乎é©ç”¨æ–¼æ‰€æœ‰ç¨®é¡žçš„æ–‡ç¨¿ã€‚å¯ä»¥ç”¨ä¾†å¯«æ—¥è¨˜ã€å¯«å¿ƒå¾—ã€å¯«å ±å‘Šã€å¯«æ›¸ã€‚當然,rst æ˜¯ã€Œæ–‡ç¨¿ã€æ ¼å¼ï¼Œæ‰€ä»¥ä¸ç¬¦åˆæŽ’版需è¦ã€‚但是,rst å¯ä»¥è½‰æˆ LaTeX å†ä½œå¾Œè™•ç†ï¼
我用 rst 寫文稿寫了好多年;這個 blog 主è¦çš„稿å都是用 rst 寫就的。當然,本站的讀者看ä¸åˆ° rst markup (æƒ³æƒ³çœŸå¯æƒœï¼Œrst æ ¼å¼æ¯”è¼ƒç°¡æ½”ï¼Œä¹Ÿè¨±ä»¥å¾Œæ”¹ç‰ˆåŠ ä¸Š rst format download link?)ï¼Œå› ç‚ºæ¯ç™¼ä½ˆä¸€æ¬¡æ–‡ç« ,後å°å°±æœƒæŠŠè©²æ–‡ç¨¿ç”¨ docutils 把 rst æ ¼å¼è½‰ç‚º HTML æ ¼å¼ã€‚
docutils 是什麼?其實就是 rst 文稿處ç†å™¨ï¼Œç¾åœ¨å·²ç¶“算是 Python 世界裡 de facto çš„æ–‡ç¨¿è™•ç†æ¨™æº–了。
docutils 為 rst æä¾›äº†å¥½äº›è½‰æ›ç¨‹å¼ï¼Œè®“ rst éžå¸¸å¥½å¯«å¥½ç”¨ã€‚坿˜¯ï¼Œé€™æ¨£é‚„ä¸èƒ½è§£æ”¾ rst 完整的å¨åŠ›ï¼å¦‚æžœè¦ç”¨ rst å†å¼·åŒ–我們的文稿撰寫效率,那就è¦è‡ªå·±å¯«ç¨‹å¼è½‰æª”,這樣æ‰èƒ½è¼‰å…¥æ‰¹æ¬¡å¨èƒ½ï¼Œå¼•入ベルカå¼ç³»çµ±èƒ½åŠ›ã€‚
為了在撰寫 script æ‰¹æ¬¡è½‰æ› rst 檔為 HTML 的時候,å¯ä»¥æŠŠ docutils 組態寫在 script æœ¬é«”è£¡é¢ (å°±ä¸è¦å†å¤šä¸€å€‹ docutils.conf 組態檔啦,累贅),就這麼作:
settings_overrides = { # general. 'language_code': 'zh_tw', 'input_encoding': 'utf-8', 'output_encoding': 'utf-8', 'footnote_backlinks': 1, 'toc_backlinks': 'top', # html4css1 writer. 'compact_lists': True, 'embed_stylesheet': True, 'stylesheet_path': os.path.splitext(__file__)[0]+'.css', 'footnote_references': 'superscript', } src = "source text" dst = "destination path" writer_name = "html" publish_file( source_path=src, destination_path=dst, writer_name=writer_name, settings_overrides=settings_overrides, )
快樂 docutils scriptingï¼