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にしよう。

文書追加 2009年 3月12日 木曜日 10時57分48秒 JST

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|

こういう風に表示される。

AKU.png ATARASII.png AWARE.png AYAMARI.png BIKKURI.png

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[セクション名] とかにしてくれればなぁ。

追加 2007年 2月14日 水曜日 14時56分42秒 JST

posted at: 10:59 | category: Draft/reStructuredText | permanent link

bernd_hilla_becher_17.jpg bernd_hilla_becher_22.jpg bernd_hilla_becher_06.jpg bernd_hilla_becher_04.jpg bernd_hilla_becher_14.jpg bernd_hilla_becher_21.jpg bernd_hilla_becher_09.jpg

skirtdress_small.jpg hot_small.jpg wallet_small.jpg devil_small.jpg policemilitaryboss_small.jpg garden_small.jpg gun_small.jpg





































































































wittgenstein_04.jpg
Tractatus Logico-Philosophicus