[B! reStructuredText] shiumachiã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯

shiumachi id:shiumachi

reStructuredTextã«é–¢ã™ã‚‹shiumachiã®ãƒ–ãƒƒã‚¯ãƒžãƒ¼ã‚¯ (7)

${{author_name}}$

{{{comment_expanded}}}

{{label}}

{{#is_bookmark}}ãƒªã‚¹ãƒˆ{{/is_bookmark}}{{^is_bookmark}}ãƒªãƒ³ã‚¯{{/is_bookmark}}

${{author_name}}$
{{author_name}}{{created}}
{{ #comment }}{{ comment }}{{ /comment }}
- {{ label }}

${{author_name}}$

{{{comment_expanded}}}

{{label}}

{{#is_bookmark}}ãƒªã‚¹ãƒˆ{{/is_bookmark}}{{^is_bookmark}}ãƒªãƒ³ã‚¯{{/is_bookmark}}

reSTãŠã‚ˆã³Sphinxã§æ–‡ç« ã‚’æ›¸ãéš›ã®tips - ãã“ã¯ã‹ã¨ãªãæ›¸ãã‚ˆã€‚
Sphinxã‚’ä½¿ã£ã¦è«–æ–‡ã£ã½ã„æ–‡ç« ã‚’æ›¸ãã¨ãã®tipsã‚’ã¾ã¨ã‚ã¦ãŠãã¾ã™ã€‚ è¿½è¨˜: ã“ã®å†…å®¹ã¯ Sphinxé€†å¼•ãè¾žå…¸ã«ã‚ˆã‚Šè©³ç´°ã«ã—ã¦è¼‰ã£ã¦ã„ã¾ã™ã€‚ ç”¨èªžã‚’æ›¸ãéš›ã¯replaceã‚’ä½¿ã† .. |hoge| replace:: ã»ã’ã‚‰ã“ã†å®šç¾©ã—ã¦ãŠãã¨æ¬¡ã‹ã‚‰ã¯ |hoge| ã¨ã™ã‚‹ã ã‘ã§ã€ã»ã’ã‚‰ã¨è‡ªå‹•çš„ã«å±•é–‹ã—ã¦ãã‚Œã¾ã™ã€‚ã¤ã¾ã‚Šã€ã‚ã¨ã‹ã‚‰ã“ã®ç”¨èªžåã‚’å¤‰ãˆãŸã„ãªã€ã¨æ€ã£ãŸã¨ãã«ã¯ã“ã®å®šç¾©ã®ã¨ã“ã‚ã ã‘ã‚’å¤‰ãˆã‚Œã°å‹æ‰‹ã«å…¨éƒ¨å…¥ã‚Œæ›¿ãˆã¦ãã‚Œã‚‹ã€ã¨ã„ã†ã‚ã‘ã§ã™ã€‚ ãŸã ã—ã€è¤‡æ•°ã®rstãƒ•ã‚¡ã‚¤ãƒ«ã«åˆ†ã‘ã¦ã„ã‚‹å ´åˆã«ã¯ä½¿ãˆãªã„ã®ã§ã€åˆ¥ã®ãƒ•ã‚¡ã‚¤ãƒ«(ä¾‹ãˆã°definition.txt)ã« replace ã‚’æ›¸ã„ã¦ãŠãã€ .. include:: definition.txtã¨å„rstãƒ•ã‚¡ã‚¤ãƒ«ã®å…ˆé ã«æ›¸ã„ã¦ãŠãã¾ã™ã€‚ã“ã®æ™‚ã€.rstã§ã¯ãªã.txtãªã©ä»–ã®æ‹¡å¼µåã®ãƒ•ã‚¡ã‚¤ãƒ«ã«æ›¸ã„ã¦ã„ã‚‹ã“ã¨ã«æ³¨æ„ã—ã¦ãã ã•ã„ã€‚ãã†ã—ãªã„
shiumachi 2011/12/26
Sphinx

reStructuredText
ãƒªãƒ³ã‚¯
emacs ã® rest-mode ã®ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚° - ç§‘å¦ã¨éžç§‘å¦ã®è¿·å®®
id:ymotongpooã®reSTè¨˜äº‹ã¯ç´ æ™´ã‚‰ã—ã„ã®ã§ã™ãŒã€ç¾åœ¨ã® rst.el ã®ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã¯è¨˜äº‹ã‚’æ›¸ã„ãŸã¨ãã‚ˆã‚Šã‚‚å¤§åˆ†å¤‰ã‚ã£ã¦ã„ã‚‹ã‚ˆã†ãªã®ã§ã¾ã¨ã‚ã¦ãŠãã¾ã™ã€‚ ãƒ˜ãƒ«ãƒ—ã®ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ä¸€è¦§ã‹ã‚‰å¼•ã£å¼µã£ã¦ããŸã ã‘ã§ã‚ãã«ãƒã‚§ãƒƒã‚¯ã—ã¦ã¾ã›ã‚“(ä¸€å¿œä¸€é€šã‚Šå‹•ä½œç¢ºèªã¯ã—ã¾ã—ãŸãŒ)ã€‚ å¤šåˆ†ãã®ã†ã¡æ›´æ–°ã™ã‚‹ã¨æ€ã„ã¾ã™ã€‚ DLç‰ˆ rst.el ã¨ MacOS X Lion ä»˜å±ž rst.el ã¨ã§ãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãŒé•ã£ã¦ã„ãŸã®ã§æ›´æ–°ã—ã¾ã—ãŸ(2011/12/26) åŸºæœ¬ç³» ã‚ãƒ¼(MacOS X Lion æ¨™æº–ä»˜å±ž) ã‚ãƒ¼(DLç‰ˆ) é–¢æ•°å èª¬æ˜Ž C-=, C-c C-=, C-c C-a C-=, C-c C-= rst-adjust è¦‹å‡ºã—ãƒ¬ãƒ™ãƒ«ã®å¤‰æ›´ C-c C-n C-M-a rst-forward-section æ¬¡ã®(ä¸‹ã®)è¦‹å‡ºã—ã«ã‚¸ãƒ£ãƒ³ãƒ— C-c C-p C-M-e rst-backwa
shiumachi 2011/12/21
rst-adjust, rst-toc, rst-*-section ã‚ãŸã‚Šã¯ã»ã‚“ã¨ã«æœ‰ç”¨ã€‚ã¦ã„ã†ã‹ã“ã‚ŒãŒãªã„ã¨ rest ç·¨é›†ã™ã‚‹æ°—ãŒãŠããªã„ #sphinxjp

ã‚»ãƒ«ã‚¯ãƒž

reStructuredText

Sphinx

emacs
ãƒªãƒ³ã‚¯
rst.elã®è‰²è¨å®š - DiaryException
rst.elã¯ã“ã“ã«ã‚ã‚‹ã€‚ ç°è‰²èƒŒæ™¯ã«ãªã£ã¦ã€ç« ã‚¿ã‚¤ãƒˆãƒ«ãŒè¦‹é›£ã„ã€‚ rst.elã«ã¯ (setq frame-background-mode 'dark) ã¨ã™ã‚‹ã¨ã€è‰²ãŒé»’èƒŒæ™¯ã«å¯¾å¿œã—ãŸã‚‚ã®ã«å¤‰ã‚ã‚‹ã¨æ›¸ã„ã¦ã‚ã‚‹ã®ã ãŒã€ä½•ã‹ä»–ã®è¨å®šã¨ãƒãƒƒãƒ†ã‚£ãƒ³ã‚°ã—ã¦ã„ã‚‹ã®ã‹ä¸Šæ‰‹ãã„ã‹ãªã„ã®ã§ã€å…¨éƒ¨æ‰‹å‹•ã§è¨å®šã—ã¦ã¿ãŸã€‚ å‚è€ƒã«ã—ãŸã®ã¯ã€org-modeã®é…è‰²(Carbon Emacsã ã¨ /Applications/Emacs.app/Contents/Resources/lisp/textmodes/org.el)ã€‚æŠ˜è§’ãªã®ã§greyã«ã‚ˆã‚‹èƒŒæ™¯ã‚°ãƒ©ãƒ‡ãƒ¼ã‚·ãƒ§ãƒ³ã¯ãã®ã¾ã¾æŽ¡ç”¨ã—ãŸã€‚ M-x customize-face > rst-level-1-face ~ rst-level-6-faceã¾ã§ã‚’org-level-*ã«åˆã‚ã›ã¦å¤‰æ›´ M-x customize > [Faces group]-[Rst Fac
shiumachi 2011/12/21
reStructuredText

emacs

Sphinx
ãƒªãƒ³ã‚¯
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 è‰²è¨å®šã«ã¤ã„ã¦è©³ã—ãèª¬æ˜Ž
shiumachi 2010/11/06
"ã“ã‚“ã«ã¡ã¯ã€éžãƒ¢ãƒ†ã‚¨ãƒ³ã‚¸ãƒ‹ã‚¢ã§ã™"ã“ã“ã ã‘ã¯å…¨ãç´å¾—ã§ããªã„ãŒä»–ã¯ã™ã”ãå½¹ã«ç«‹ã£ãŸ

reStructuredText

emacs

Sphinx
ãƒªãƒ³ã‚¯
ã¯ã‚„ã‚ã‹ã‚Š reStructuredText
æœ¬ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ—è¨˜æ³•ã®å®Œå…¨ãªè©³ç´°ã¯ reStructuredText ã®ãƒšãƒ¼ã‚¸ã«ç¤ºã•ã‚Œã¦ã„ã¾ã™ã€‚ã“ã®ãƒ†ã‚ã‚¹ãƒˆã¯ã€è¦šæ›¸ã¨ã—ã¦ã®æ€§æ ¼ã®æ–‡æ›¸ã§ã™ã€‚ "(è©³ç´°)" ã¨ã„ã†ãƒªãƒ³ã‚¯ã‚’è¾¿ã‚‹ã¨ reStructuredText ä»•æ§˜æ›¸ã‚’å‚ç…§ã§ãã¾ã™ã€‚ ãŸã ã—ã€ç›¸å¯¾ãƒªãƒ³ã‚¯ã¨ãªã£ã¦ã„ã¾ã™ã®ã§ã€ãƒªãƒ³ã‚¯åˆ‡ã‚Œã®å ´åˆã¯ã€ åŽŸç‰ˆã® "Quick reStructuredText" ã‹ã‚‰å‚ç…§ã—ã¦ãã ã•ã„ã€‚ ç›®æ¬¡ ã‚¤ãƒ³ãƒ©ã‚¤ãƒ³ ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ— ãƒãƒƒã‚¯ã‚¹ãƒ©ãƒƒã‚·ãƒ¥ã«ã‚ˆã‚‹ã‚¨ã‚¹ã‚±ãƒ¼ãƒ— ç« ç«‹ã¦ã®æ§‹é€ æ®µè½ è¨˜å·ã¤ããƒªã‚¹ãƒˆ ç•ªå·ã¤ããƒªã‚¹ãƒˆ å®šç¾©ãƒªã‚¹ãƒˆ ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ãƒªã‚¹ãƒˆ ã‚ªãƒ—ã‚·ãƒ§ãƒ³ãƒªã‚¹ãƒˆ æ•´å½¢æ¸ˆã¿ãƒ–ãƒãƒƒã‚¯ ãƒ©ã‚¤ãƒ³ãƒ–ãƒãƒƒã‚¯ å¼•ç”¨ Doctestãƒ–ãƒãƒƒã‚¯ è¡¨ åŒºåˆ‡ã‚Šç·š æ˜Žç¤ºçš„ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ— è„šæ³¨ å‡ºå…¸ ãƒªãƒ³ã‚¯ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ å¤–éƒ¨ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ å†…éƒ¨ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ é–“æŽ¥ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ æš—é»™ã‚¿ãƒ¼ã‚²ãƒƒãƒˆ ãƒ‡ã‚£ãƒ¬ã‚¯ãƒ†ã‚£ãƒ– ä»£å…¥å‚ç…§ã¨ãã®å®šç¾© ã‚³ãƒ¡ãƒ³ãƒˆ åŠ©ã‘ã‚’å¾—ãŸã„å ´åˆã¯
shiumachi 2008/10/21
reStructuredText

python
ãƒªãƒ³ã‚¯
ReStructuredText å…¥é–€
ä»¥ä¸‹ã®æ–‡ç« ä¸ã« "(quickref)" ã¨ã„ã†å½¢å¼ã®ãƒªãƒ³ã‚¯ãŒã‚ã‚Šã¾ã™ã€‚ã“ã‚Œã¯ã€ Quick reStructuredText ãƒ¦ãƒ¼ã‚¶ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã¸ã®ç›¸å¯¾ãƒªãƒ³ã‚¯ã§ã™ã€‚ã“ã®ãƒªãƒ³ã‚¯ãŒ åˆ‡ã‚Œã¦ã„ã‚‹å ´åˆã¯ã€ ã‚ªãƒ³ãƒ©ã‚¤ãƒ³ã®ã‚¯ã‚¤ãƒƒã‚¯ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ ã‚’å‚ç…§ã—ã¦ãã ã•ã„ã€‚ æ§‹é€ ã¾ãšã¯ã˜ã‚ã«ã€"Structured Text" ï¼ˆæ§‹é€ åŒ–ã•ã‚ŒãŸãƒ†ã‚ã‚¹ãƒˆï¼‰ã¨ã„ã†å‘¼ã³æ–¹ã«ã¯ã€ ã„ãã¶ã‚“ä¸é©åˆ‡ãªã¨ã“ã‚ãŒã‚ã‚‹ã¨æŒ‡æ‘˜ã—ã¦ãŠãã¾ã™ã€‚å®Ÿéš›ã«ã¯ã€é¦–å°¾ä¸€è²«ã—ãŸãƒ‘ã‚¿ãƒ¼ãƒ³ã‚’ä½¿ã† "Relaxed Text" ï¼ˆå½¢å¼ã°ã‚‰ãªã„ãƒ†ã‚ã‚¹ãƒˆï¼‰ã¨ã§ã‚‚å‘¼ã¶ã¹ãã‚‚ã®ã§ã™ã€‚ãã®ãƒ‘ã‚¿ãƒ¼ãƒ³ã‚’ HTML ã‚³ãƒ³ãƒãƒ¼ã‚¿ã§å¤‰æ›ã™ã‚‹ã“ã¨ã§ã€WEB ãƒ–ãƒ©ã‚¦ã‚¶ã§æ‰±ãˆã‚‹ã‚ˆã†ãªã€Œéžå¸¸ã«æ§‹é€ åŒ–ã•ã‚ŒãŸ ãƒ†ã‚ã‚¹ãƒˆã€ãŒç”Ÿæˆã•ã‚Œã‚‹ã®ã§ã™ã€‚ æœ€ã‚‚åˆ†ã‹ã‚Šæ˜“ãã¦åŸºæœ¬çš„ãªãƒ‘ã‚¿ãƒ¼ãƒ³ã¯ã€ ãƒ‘ãƒ©ã‚°ãƒ©ãƒ•ï¼ˆæ®µè½ï¼‰ (quickref) ã§ã™ã€‚ ï¼ˆ1ã¤ä»¥ä¸Šã®ï¼‰ç©ºè¡Œã§åŒºåˆ†ã•ã‚ŒãŸãƒ†ã‚ã‚¹ãƒˆã®ã²ã¨ã‹ãŸã¾ã‚ŠãŒ
shiumachi 2008/10/21
reStructuredText

python
ãƒªãƒ³ã‚¯
reStructuredText - Wikipedia
reStructuredText ã¯ã€è»½é‡ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ—è¨€èªžã®ã²ã¨ã¤ã€‚ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®çŠ¶æ…‹ã§é«˜ã„å¯èªæ€§ã‚’æŒã¤ã‚ˆã†ã«è¨è¨ˆã•ã‚Œã¦ã„ã‚‹ã€‚reStructuredText ãƒ‘ãƒ¼ã‚µã¯ã€ãƒ†ã‚ã‚¹ãƒˆå‡¦ç†ãƒ•ãƒ¬ãƒ¼ãƒ ãƒ¯ãƒ¼ã‚¯ã§ã‚ã‚‹ Docutils ã®ã‚³ãƒ³ãƒãƒ¼ãƒãƒ³ãƒˆã®ã²ã¨ã¤ã§ã‚ã‚Šã€Python ã§å®Ÿè£…ã•ã‚Œã¦ã„ã‚‹ã€‚ reStructuredText ã¯ã€RSTã€reSTã€ReST ã¨ç•¥ã•ã‚Œã‚‹ã“ã¨ã‚‚ã‚ã‚‹ã€‚
shiumachi 2008/06/16
reStructuredText

ãƒžãƒ¼ã‚¯ã‚¢ãƒƒãƒ—è¨€èªž

æ§‹é€ åŒ–ãƒ†ã‚ã‚¹ãƒˆ
ãƒªãƒ³ã‚¯
1