Shibu's Diary: Pythonã£ã¦ä½•ï¼Ÿã¨ã„ã†äººã®ãŸã‚ã®Sphinxインストール入門
渋日記@shibu.jp 渋å·ã‚ˆã—ãã®æ—¥è¨˜ã§ã™ã€‚ソフトウェア開発ã¨ã‹ã€ãƒ©ã‚¤ãƒ•ãƒãƒƒã‚¯ã‚’ä¸å¿ƒã«è¨˜äº‹ã‚’書ã„ã¦ã„ãã¾ã™ã€‚ ã“ã®å‰ã®ãƒ–ãƒã‚°ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã«ã‚‚書ãã¾ã—ãŸãŒã€Sphinxã¨ã„ã†ã‚¹ãƒ†ã‚ã™ãŽã‚‹ãƒ„ールãŒã‚ã‚Šã¾ã™ã€‚ドã‚ュメントãŒã©ã‚“ã©ã‚“書ããŸããªã£ã¡ã‚ƒã†ã‚¹ãƒ†ã‚ãªãƒ„ールã§ã™ã€‚ã§ã™ãŒã€æ®‹å¿µãªãŒã‚‰ã€ä½¿ç”¨ã™ã‚‹ãŸã‚ã«ã¯ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚Pythonã£ã¦ä½•ï¼Ÿã¨ã„ã†äººã«ã¯å°‘々敷居ãŒé«˜ã„ãŸã‚ã€è§£èª¬ã®è¨˜äº‹ã‚’書ã„ã¦ã¿ã¾ã—ãŸã€‚ [STEP 1] Pythonã‹ã‚‰ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å ´åˆ Windowsã§ã¯Pythonã‹ã‚‰ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚一発ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã§ãる環境をæŒã£ã¦ã„る人ã¯æœ€å¾Œã®æ–¹ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«æ³•ã«é£›ã‚“ã§ãã ã•ã„。ã¾ãŸã€Mac OS Xã¿ãŸã„ã«ã€æœ€åˆã‹ã‚‰Pythonã‹ã‚‰å…¥ã£ã¦ã„る人ã¯[STEP 1]ã¯é£›ã°ã—ã¦ãã ã•ã„。 Windwsã®å ´åˆ http://python.orgã‚’é–‹ãã¾ã™ã€‚P
restructuredtext用ã®ã‚¨ãƒ‡ã‚£ã‚¿ã‚’作ã£ã¦ã¿ãŸ - åã£ãŸè¨€èªžä¿¡è€…ã®åž‚ã‚Œæµã—
å°‘ã—å‰ã«ä½œã£ã¦æ”¾ç½®ã—ã¦ãŸã€‚使ã£ã¦ã¿ãŸã‘ã‚Œã°ã©ã†ãžã€‚Windows専用ã§ã™ã€‚ tokibito / rstedit / Downloads — Bitbucket 追記 Vistaã€Windows7ã§ã¯IEコンãƒãƒ¼ãƒãƒ³ãƒˆé–¢é€£ã®å•é¡Œã§å‹•ã‹ãªã„よã†ã§ã™ã€‚ã‚„ã£ã‹ã„ãªå•é¡Œãªã®ã§ã€è§£æ±ºç–見ã¤ã‹ã‚‹ã¾ã§ã¯æ”¾ç½®ã§ã™ã€‚ã™ã¿ã¾ã›ã‚“。
reStructuredText(reST)ã‚’Emacsã§æ›¸ãéš›ã®ã¾ã¨ã‚ - YAMAGUCHI::weblog
ã¯ã˜ã‚ã« ã“ã‚“ã«ã¡ã¯ã€éžãƒ¢ãƒ†ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã§ã™ã€‚長らãExcelã§ä»•æ§˜æ›¸ã‚’書ãã®ãŒãƒ–ームらã—ã„ã§ã™ãŒã€Sphinxã§ãƒ‰ã‚ュメントを書ãã¨è€³ã‹ã‚‰è„³æ¼¿åž‚ã‚Œæµã—ã«ãªã£ã¦ã—ã¾ã†ã»ã©æ¥½ã—ããªã£ã¦ã—ã¾ã†ã¨ã„ã†ã‚‚ã£ã±ã‚‰ã®å™‚（俺ã®ä¸ã§ï¼‰ãªã®ã§ã€Emacsã§reSTを書ãéš›ã®ä¾¿åˆ©æ©Ÿèƒ½ã‚’ã¾ã¨ã‚ã¦ã¿ã¾ã—ãŸã€‚ å‚ç…§ 404 Not Found 手å‰å‘³å™Œã§ã™ãŒè‡ªåˆ†ãŒé–¢ã‚ã£ã¦ã„ã‚‹Sphinxã®æ—¥æœ¬ãƒ¦ãƒ¼ã‚¶ä¼šã®ã‚µã‚¤ãƒˆã§ã™ã€‚ãã‚‚ãã‚‚Sphinxã£ã¦ãªã«ã‚ˆï¼ŸSphinx自体をã©ã†ã‚„ã£ã¦å°Žå…¥ã—ãŸã‚‰ã„ã„ã®ã‚ˆï¼Ÿã£ã¦æ–¹ã¯ã”å‚ç…§ãã ã•ã„。もã¡ã‚ã‚“æ—¢ã«ã”å˜çŸ¥ã®æ–¹ã«ã‚‚æœ€æ–°æƒ…å ±å«ã‚有益ãªæƒ…å ±ãŒæº€è¼‰ã§ã™ã€‚ Emacs Support for reStructuredText rst.elã®æœ¬å®¶ã€‚英語ã§ã™ãŒrst-modeã«ã¤ã„ã¦ä¸€ç•ªè©³ã—ã„説明ãŒã‚ã‚‹å ´æ‰€ã ã¨æ€ã„ã¾ã™ã€‚ rst.elã®è‰²è¨å®š - DiaryException 色è¨å®šã«ã¤ã„ã¦è©³ã—ã説明
reST モード覚ãˆæ›¸ã - SPEAKER BREAKA
Sphinx ã®ãŠã‹ã’㧠reST ãŒã¾ãŸè¦‹ç›´ã•ã‚Œã¦ã‚‹ãžï¼ ã¨ã„ã†ã“ã¨ã§ Emacs 用 reStructuredText モードã®ã‚³ãƒžãƒ³ãƒ‰ã‚ーマップ セクションデコレーション セクションã®ã‚¿ã‚¤ãƒˆãƒ«è£…飾 C-c C-a rst-adjust C-c C-= rst-adjust C-= st-adjust (Mac OSX ã˜ã‚ƒå‹•ã‹ãªã„よ) ドã‚ュメント内ã®ã‚»ã‚¯ã‚·ãƒ§ãƒ³éšŽå±¤ã‚’表示 C-c C-h rst-display-decorations-hierarchy ドã‚ュメント内ã®è£…飾をå‡ä¸€åŒ– C-c C-s rst-straighten-decorations セクションã®ç§»å‹•ã¨é¸æŠž カーソルã®ã‚るサブセクションをé¸æŠž C-c C-m rst-mark-section セクション間を進む/戻る C-c C-n rst-forward-section C-c C-p rst-backward-
Overview — Sphinx v1.0 (hg) documentation
ダウンãƒãƒ¼ãƒ‰ ã“ã®ãƒ‰ã‚ュメントã¯ãƒãƒ¼ã‚¸ãƒ§ãƒ³1.0 (hg)ã®ãŸã‚ã®ã‚‚ã®ã§ã™ã€‚ã¾ã リリースã•ã‚Œã¦ã„ã¾ã›ã‚“。 Mercurialリãƒã‚¸ãƒˆãƒªã®ã‚³ãƒ¼ãƒ‰ã‚’利用ã™ã‚‹ã‹ã€Python Package Indexã«ã‚るリリースãƒãƒ¼ã‚¸ãƒ§ãƒ³ã‚’探ã—ã¦ãã ã•ã„。 ç–‘å•? æ„見? Googleグループã¸ã®å‚åŠ : ã‚‚ã—ãã¯ã€FreeNodeã®#python-docsãƒãƒ£ãƒ³ãƒãƒ«ã¸ã©ã†ãž 何ã‹æ°—ã¥ã„ãŸã“ã¨ãŒã‚ã‚Œã°ã€issue trackerを使用ã—ã¦é€šçŸ¥ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã€‚ Sphinxã¯çŸ¥çš„ã§ç¾Žã—ã„ドã‚ュメントを簡å˜ã«ä½œã‚Œã‚‹ã‚ˆã†ã«ã™ã‚‹ãƒ„ールã§ã™ã€‚Georg Brandlã«ã‚ˆã£ã¦é–‹ç™ºã•ã‚Œã€BSDライセンスã®ã‚‚ã¨ã§å…¬é–‹ã•ã‚Œã¦ã„ã¾ã™ã€‚ ã“ã®ãƒ„ールã¯ã‚‚ã¨ã‚‚ã¨ã€æ–°ã—ã„Pythonã®ãƒ‰ã‚ュメントã®å¤‰æ›ã®ãŸã‚ã«ä½œã‚‰ã‚Œã¾ã—ãŸã€‚ãã—ã¦ã€ä»Šã¾ã§ã«æ•°ã€…ã®Pythonã‚„ã€ä»–ã®è¨€èªžã§é–‹ç™ºã•ã‚Œã¦ã„るプãƒã‚¸ã‚§ã‚¯ãƒˆã«å¯¾ã—ã¦ã€ã™ã°ã‚‰ã—ã„ドã‚ュメンテーシ
Docutils: Documentation Utilities
Docutils: Documentation Utilities Written in Python, for General- and Special-Purpose Use Docutils is an open-source text processing system for processing plaintext documentation into useful formats, such as HTML, LaTeX, man-pages, OpenDocument, or XML. It includes reStructuredText, the easy to read, easy to use, what-you-see-is-what-you-get plaintext markup language. Overview To get up & running
ã¯ã‚„ã‚ã‹ã‚Š reStructuredText
本マークアップ記法ã®å®Œå…¨ãªè©³ç´°ã¯ reStructuredText ã®ãƒšãƒ¼ã‚¸ã«ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ãƒ†ã‚ストã¯ã€è¦šæ›¸ã¨ã—ã¦ã®æ€§æ ¼ã®æ–‡æ›¸ã§ã™ã€‚ "(詳細)" ã¨ã„ã†ãƒªãƒ³ã‚¯ã‚’辿る㨠reStructuredText 仕様書をå‚ç…§ã§ãã¾ã™ã€‚ ãŸã ã—ã€ç›¸å¯¾ãƒªãƒ³ã‚¯ã¨ãªã£ã¦ã„ã¾ã™ã®ã§ã€ãƒªãƒ³ã‚¯åˆ‡ã‚Œã®å ´åˆã¯ã€ 原版㮠"Quick reStructuredText" ã‹ã‚‰å‚ç…§ã—ã¦ãã ã•ã„。 目次 インライン マークアップ ãƒãƒƒã‚¯ã‚¹ãƒ©ãƒƒã‚·ãƒ¥ã«ã‚ˆã‚‹ã‚¨ã‚¹ã‚±ãƒ¼ãƒ— ç« ç«‹ã¦ã®æ§‹é€ æ®µè½ è¨˜å·ã¤ãリスト 番å·ã¤ãリスト 定義リスト フィールドリスト オプションリスト 整形済ã¿ãƒ–ãƒãƒƒã‚¯ ラインブãƒãƒƒã‚¯ 引用 Doctestブãƒãƒƒã‚¯ 表 区切り線 明示的マークアップ 脚注 出典 リンクターゲット 外部ターゲット 内部ターゲット 間接ターゲット 暗黙ターゲット ディレクティブ 代入å‚ç…§ã¨ãã®å®šç¾© コメント 助ã‘ã‚’å¾—ãŸã„å ´åˆã¯
1
ランã‚ング
ランã‚ング
障害
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
Welcome to git-sphinx’s documentation! — git-sphinx v1.0 documentation
Blog | Enthought, Inc.
{{#tags}}- {{label}}
{{/tags}}