ドã‚ãƒ¥ãƒ¡ãƒ³ãƒ†ãƒ¼ã‚·ãƒ§ãƒ³ã‚’åŠ é€Ÿã™ã‚‹ã‚¹ãƒˆãƒ¬ã‚¹ãƒ•ãƒªãƒ¼ã®ä½œå›³ãƒ„ール『blockdiag〠jus2011å¹´6月勉強会
システム開発やä¿å®ˆã€é‹ç”¨ã®ç¾å ´ã«ãŠã„ã¦ãƒ‰ã‚ュメントã¯å¿…é ˆã®ã‚‚ã®ã§ã™ã€‚ ã—ã‹ã—ã€ãƒ‰ã‚ュメントã®ä½œæˆãƒ»ç¶æŒã«ã¯å¤šãã®ãƒ‘ワーãŒã‹ã‹ã‚‹ãŸã‚ã€ãƒ‰ã‚ュ メントãŒå˜åœ¨ã—ãªã„ã€è³‡æ–™ãŒå¤ã„ã¾ã¾ã«ãªã£ã¦ã„ã‚‹ãªã©ã¨ã„ã£ãŸç¾çŠ¶ã‚’多ã 耳ã«ã—ã¾ã™ã€‚ 本勉強会ã§ã¯ã“れらã®ãƒ‰ã‚ュメントã§ã‚ˆã利用ã•ã‚Œã‚‹ã€Œå›³ã€ã«ãƒ•ã‚©ãƒ¼ã‚«ã‚¹ã—〠ã¿ã‚‹ã¿ã‚‹ã†ã¡ã«å›³ã‚’作æˆã§ãる「blockdiagã€ã‚’ã”紹介ã—ã¾ã™ã€‚ 「blockdiagã€ã¯ã‚·ãƒ³ãƒ—ルãªãƒ†ã‚スト記述ã‹ã‚‰ãƒ–ãƒãƒƒã‚¯å›³ã€ãƒãƒƒãƒˆãƒ¯ãƒ¼ã‚¯å›³ãªã©ã® ç”»åƒãƒ•ã‚¡ã‚¤ãƒ«ã‚’出力å¯èƒ½ãªã‚ªãƒ¼ãƒ—ンソースã®ç”»åƒç”Ÿæˆãƒ„ールã§ã™ã€‚書ã ã‚„ã™ã•ã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ã—ã‚„ã™ã•ã‚’ä¸å¿ƒã«ãƒ‡ã‚¶ã‚¤ãƒ³ã•ã‚Œã¦ãŠã‚Šã€å›³ã‚’作るã®ã« é…置や並ã¹æ›¿ãˆã«è‹¦åŠ´ã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。 blockdiagã®ã‚µãƒ³ãƒ—ルã¯ã“ã¡ã‚‰ ã“ã®ã‚ˆã†ãªç‰¹å¾´ã‚’æŒã¤ã€Œblockdiagã€ã¨ã€ã‚·ãƒ³ãƒ—ルãªè¨˜è¿°ã§ãƒ‰ã‚ãƒ¥ãƒ¡ãƒ³ãƒˆã‚’ä½œæˆ ã™ã‚‹ãƒ„ール「Sphinxã€ã‚’組ã¿åˆã‚ã›ã‚‹ã“ã¨ã«ã‚ˆã£ã¦
渋日記: Pythonã£ã¦ä½•ï¼Ÿã¨ã„ã†äººã®ãŸã‚ã®Sphinxãƒãƒ¥ãƒ¼ãƒˆãƒªã‚¢ãƒ«
渋日記@shibu.jp 渋å·ã‚ˆã—ãã®æ—¥è¨˜ã§ã™ã€‚ソフトウェア開発ã¨ã‹ã€ãƒ©ã‚¤ãƒ•ãƒãƒƒã‚¯ã‚’ä¸å¿ƒã«è¨˜äº‹ã‚’書ã„ã¦ã„ãã¾ã™ã€‚ å‰å›žã€ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã®ã‚¨ãƒ³ãƒˆãƒªãƒ¼ã‚’書ãã¾ã—ãŸãŒã€Tornadeドã‚ュメントã®ç¿»è¨³ã‚’例ã«ã€å®Ÿéš›ã«Sphinxã§ã®ä½œæ¥ã®æµã‚Œã‚’ãŠè¦‹ã›ã—ãŸã„ã¨æ€ã„ã¾ã™ã€‚ ã¾ãšã¯ãƒ¯ãƒ¼ã‚¯ãƒ•ã‚©ãƒ«ãƒ€ã‚’作る 作æ¥ã‚’ã™ã‚‹ã«ã¯ã€ãƒ•ã‚¡ã‚¤ãƒ«ã‚’ç½®ãå ´æ‰€ãŒå¿…è¦ã§ã™ã€‚ソースコードã€è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã€ãƒ“ルド後ã®æˆæžœç‰©ãªã©ãªã©ã€ã„ã‚ã„ã‚å¿…è¦ã«ãªã‚Šã¾ã™ã€‚ãã“ã§ãƒ•ã‚©ãƒ«ãƒ€ã‚’作æˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚僕ã®å ´åˆã¯ç¿»è¨³ã¨ã‹ã®ä½œæ¥ã¯(ホーム)/work/(作æ¥ãƒ•ã‚©ãƒ«ãƒ€)ã¨ã„ã†å ´æ‰€ã§è¡Œã†ã“ã¨ãŒå¤šã„ã®ã§ã€ãã®å‰æã§è©±ã—ã‚’ã™ã™ã‚ã¾ã™ã€‚Tornadoã®ç¿»è¨³ã®å ´åˆã¯ãƒãƒ¼ãƒ ã§ä½œæ¥ã‚’ã—ãŸã®ã§ã€bitbucketを使ã£ã¦å…±æœ‰ç’°å¢ƒã‚’用æ„ã—ã¾ã—ãŸã®ã§ãã®èª¬æ˜Žã‚‚一緒ã«ã€‚ 共有をã™ã‚‹å ´åˆã¯Mercurialをインストールã—ã¦ãã ã•ã„。Windowsã®å ´åˆã¯Tortoise
Macã§rst2pdfを使ã£ã¦ãƒ’ラギノãªPDFを作æˆã™ã‚‹ã€‚ - ãã“ã¯ã‹ã¨ãªã書ãよ。
http://sphinx-users.jp/cookbook/pdf/rst2pdf.html ã‚’å‚考ã«ã•ã›ã¦é ‚ãã¾ã—ãŸã€‚ 準備 macportsã§sphinxã¨rst2pdfを入れã¾ã™ã€‚ % sudo port install sphinx % sudo port install rst2pdf今回使用ã—ãŸãƒãƒ¼ã‚¸ãƒ§ãƒ³ã¯ sphinx v1.0.4 rst2pdf 0.16 ã§ã™ã€‚ ãªãŠã€å‚考ã«ã•ã›ã¦ã„ãŸã ã„ãŸãƒšãƒ¼ã‚¸ã§ã¯IPAフォントãªã©ã‚’使ã£ã¦ã„ã¾ã™ãŒã€Macãªã®ã§ãƒ’ラギノフォントを使ã„ã¾ã™ã€‚ãªã®ã§ã€ãƒ•ã‚©ãƒ³ãƒˆã‚’別途インストールã™ã‚‹å¿…è¦ã¯ã‚ã‚Šã¾ã›ã‚“。 プãƒã‚¸ã‚§ã‚¯ãƒˆã®ä½œæˆ ã„ã¤ã‚‚通り㫠sphinx-quickstart コマンドを利用ã—ã¦ãƒ‰ã‚ュメントを作りã¾ã™ã€‚ conf.pyã®ç·¨é›† å‰è¿°ã®rst2pdfã®ãƒšãƒ¼ã‚¸ã‚’å‚考ã«ã—ã¦ãã ã•ã„。 extentionã«è¿½åŠ ã™ã‚‹ã»ã‹ã¯ã€ pdf_doc
Sphinxã§ã‹ã‚“ãŸã‚“ePubファイル作æˆ
è¦å‘Š ã“ã®è¨˜äº‹ã¯å¤ã„為 easy_install ã®ä½¿ç”¨ç‰ã€ç¾åœ¨ã§ã¯éžæŽ¨å¥¨ã®èª¬æ˜ŽãŒã‚ã‚Šã¾ã™ã€‚インストール周りã«ã¤ã„ã¦ã¯ Windowsã¸ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã®æ‰‹é †ã‚’å‚ç…§ã—ã¦ãã ã•ã„。 日時: 2010/05/21 作者: 渋å·ã‚ˆã—ã 最終更新: 2021/02/12 Sphinxã®1.0ã‹ã‚‰ã¯ã€ePubファイルã®ãƒ“ルドãŒã§ãるよã†ã«ãªã‚Šã¾ã™ã€‚ePubファイルã¨ã„ã†ã®ã¯ã€iPadやソニーã®é›»åブックリーダーãªã©ã§åˆ©ç”¨ã§ãã‚‹ã€é›»åブックã®ãƒ•ã‚©ãƒ¼ãƒžãƒƒãƒˆã§ã™ã€‚原ç†çš„ã«ã¯HTMLã«ã€æ±ºã¾ã£ãŸå½¢å¼ã®ãƒ¡ã‚¿ãƒ‡ãƒ¼ã‚¿ã‚’å«ã‚€ãƒ•ã‚¡ã‚¤ãƒ«ã‚’è¿½åŠ ã—ã¦ã€zipã§å›ºã‚ã¦æ‹¡å¼µã—ã‚’epubã«ã—ãŸã‚‚ã®ã§ã™ãŒã€Sphinxを使ãˆã°ç°¡å˜ã«å‡ºåŠ›ã™ã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚
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
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ã‚„ã€ä»–ã®è¨€èªžã§é–‹ç™ºã•ã‚Œã¦ã„るプãƒã‚¸ã‚§ã‚¯ãƒˆã«å¯¾ã—ã¦ã€ã™ã°ã‚‰ã—ã„ドã‚ュメンテーシ
SPHINX ã«ã‚ˆã‚‹ãƒ‰ã‚ュメント生æˆã¨ã€Pygment ã«ã‚ˆã‚‹ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®ãƒã‚¤ãƒ©ã‚¤ãƒˆ - 傀儡師ã®é¤¨.Python：楽天ブãƒã‚°
2008.03.23 SPHINX ã«ã‚ˆã‚‹ãƒ‰ã‚ュメント生æˆã¨ã€Pygment ã«ã‚ˆã‚‹ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®ãƒã‚¤ãƒ©ã‚¤ãƒˆ (317) テーマ：プãƒã‚°ãƒ©ãƒŸãƒ³ã‚°è¨€èªž Python を使ã†(336) カテゴリ：Python SPHINX: PYTHON DOCUMENTATION GENERATOR を見る。SPHINX ã¯ã€Georg Brandl æ°ã«ã‚ˆã£ã¦ä½œã‚‰ã‚ŒãŸ Python プãƒã‚¸ã‚§ã‚¯ãƒˆã®ãƒ‰ã‚ュメントを生æˆã—ã¦ãれるプãƒã‚°ãƒ©ãƒ 。reStructuredText ã®ã‚½ãƒ¼ã‚¹ã‚’ HTMLã€Windows HTML Helpã€LaTeXã€PDF ã¨ã„ã£ãŸå‡ºåŠ›å½¢å¼ã§å‡ºåŠ›ã—ã¦ãれる。reStructuredText ã®ãƒ‘ースã¯ã€Docutils を使ã£ã¦ã„るよã†ã 。元ã¯ã€Python Documentation ã®ãŸã‚ã«ä½œã‚‰ã‚Œã¦ã€ä»–ã§ã‚‚使ãˆã‚‹ã‚ˆã†ã«ã€ãã‚Œã„ã«æ›¸ãç›´ã•ã‚ŒãŸã‚‚ã®ã®ã‚ˆã†ã 。 対象ã¨ãªã‚‹ã®ã¯ã€åŸºæœ¬çš„ã«
1
リリースã€éšœå®³æƒ…å ±ãªã©ã®ã‚µãƒ¼ãƒ“スã®ãŠçŸ¥ã‚‰ã›
最新ã®äººæ°—エントリーã®é…ä¿¡
j次ã®ãƒ–ックマーク
kå‰ã®ãƒ–ックマーク
lã‚ã¨ã§èªã‚€
eコメント一覧を開ã
oページを開ã
EuroPython2011_HighPerformanceComputing/docs at master · ianozsvald/EuroPython2011_HighPerformanceComputing
PHP Domain — sphinxcontrib-phpdomain 0.1 documentation
https://sphinx-users.jp/doc11/rest.html
rst2pdf拡張を使ã£ãŸPDFãƒ•ã‚¡ã‚¤ãƒ«ä½œæˆ â€” Python製ドã‚ュメンテーションビルダーã€Sphinxã®æ—¥æœ¬ãƒ¦ãƒ¼ã‚¶ä¼š
{{#tags}}- {{label}}
{{/tags}}