Thu, 12 Mar 2009
reStructuredText
Directive
Image Directive
イメージの貼り付け。
.. raw:: html
<a href="http://log-rotation.jp/pyblosxom/images/vim/vim01.png"
title="vim01.jpg">
.. image:: /pyblosxom/images/vim/vim01.png
:alt: vim01.png
:align: left
.. raw:: html
</a>
|CLEAR|
イメージの幅は200にしよう。
Include Directive
外部ファイルをインクルードする。 自分で定義したファイルと docutils のソースについてくるファイルでは書き方が少し違う。
自分のファイルをインクルードしたい場合。
$ head /home/hoge/www/pyblosxom/include/icon/icon_mini.inc
.. |AKU| image:: http://log-rotation.jp/pyblosxom/images/mini/AKU.png
:alt: AKU.png
.. |ATARASII| image:: http://log-rotation.jp/pyblosxom/images/mini/ATARASII.png
:alt: ATARASII.png
.. |AWARE| image:: http://log-rotation.jp/pyblosxom/images/mini/AWARE.png
:alt: AWARE.png
.. |AYAMARI| image:: http://log-rotation.jp/pyblosxom/images/mini/AYAMARI.png
:alt: AYAMARI.png
.. |BIKKURI| image:: http://log-rotation.jp/pyblosxom/images/mini/BIKKURI.png
:alt: BIKKURI.png
.
.
こんなファイルを用意しておき、reStructuredText ファイルでインクルードして使う。
.. include:: /home/hoge/www/pyblosxom/include/icon/icon_mini.inc |AKU| |ATARASII| |AWARE| |AYAMARI| |BIKKURI|
こういう風に表示される。

Docutils についてくるファイルをインクルードする場合。
$ head local/lib/python/docutils/parsers/rst/include/isobox.txt .. This data file has been placed in the public domain. .. Derived from the Unicode character mappings available from <http://www.w3.org/2003/entities/xml/>. Processed by unicode2rstsubs.py, part of Docutils: <http://docutils.sourceforge.net>. .. |boxDL| unicode:: U+02557 .. BOX DRAWINGS DOUBLE DOWN AND LEFT .. |boxDl| unicode:: U+02556 .. BOX DRAWINGS DOWN DOUBLE AND LEFT SINGLE .. |boxdL| unicode:: U+02555 .. BOX DRAWINGS DOWN SINGLE AND LEFT DOUBLE .. |boxdl| unicode:: U+02510 .. BOX DRAWINGS LIGHT DOWN AND LEFT . . .. include:: <isobox.txt> |boxDL| |boxDl| |boxdL| |boxdl|
こういう風に表示される。
╗ ╖ ╕ ┐
インクルードディレクトリは知ってるんだな。
Memo
Table Of Contents
日本語のみのセクション名の場合、id[num] というかたちでページ内リンクが 作成されるようだ。 このサイトの場合、一つのページ内に複数のWikiページが存在しているような形なので、 セクション名が一意でないとページ内リンクが正常に動作しない。
苦肉の策としてセクション名の末尾に[hoge hoge hoge]などとキーワード的なものを付け、 エントリー全体でセクション名が一意になるようにした。
セクションへのページ内リンクを id[セクション名] とかにしてくれればなぁ。
posted at: 10:59 | category: Draft/reStructuredText | permanent link































