============================================================
kagiPDF
============================================================
:Author: 
:Date: today

kagiPDFϡreStructuredText [#]_ ʪΤץ [#]_ Ǥγĥ̿ޤˤ顢
 |latex| **ˤ뤤ܸPDFե** פ
ǤñˤĤ뤿Υޥɥ饤ġǤ

.. [#] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html
.. [#] http://hooktail.org/wiki/


ưĶ
============================================================

LinuxCygwinʤɤδĶưޤ
ưǧVine Linux 3.2Windows XPCygwin 1.5.13ˤƹԤäƤޤ
¹ԤˤϤĤΥեȥɬפǤ
äˡDocutilslvϺǽ餫äƤʤ礬¿Ǥ顢
۸ꤷƥ󥹥ȡ [#]_ ƤƤ

- Docutils 3.7 or later (http://docutils.sourceforge.net/)
- lv (http://www.ff.iij4u.or.jp/~nrt/lv/)
- Ruby 1.8 or later
- pLaTeX
- jsarticle, jsbookܸ LaTeX ɥȥ饹
- dvipdfmx
- ImageMagick

.. [#]
  Vine Linux 3.xξ硢󥹥ȡ뤬ɬפʤΤDocutilslvΤߤǤ
  lvapt-getǽǤ


󥹥ȡ
============================================================

Linux
-----

binǥ쥯ȥˤ3ĤΥե ``extension.rb, fairlatex.rb, kagipdf.rb`` 
ѥ̤äǥ쥯ȥ֤Ƥ3ĤȤƱǥ쥯ȥ֤Ƥˡ
``kagipdf.rb`` ϼ¹Բǽ ``chmod a+x`` ˤˤƤƤ

Ĥˡstyleǥ쥯ȥˤLaTeXե 
``kagipdf_hooktail.sty, kagipdf_report.sty, kagipdf_thesis.sty, mydefinition.sty`` 
Ķѿ ``TEXIPUTS`` ̤äǥ쥯ȥ֤Ƥ
ޤϡstyleǥ쥯ȥ˴Ķѿ ``TEXIPUTS`` ̤Ƥ
Τˤϡbashkshξ硢 ``~/.bash_profile`` 
::

  TEXINPUTS=$TEXINPUTS:~/kagipdf/style
  export TEXINPUTS

ʤɤȵҤޤ

Cygwin
------

嵭ƱǤ¹Բǽ°ϤĤʤƤ⤷ޤ
CygwinĶW32TeXѤ硢
styleǥ쥯ȥˤLaTeXե
::

 C:\tex\share\texmf\ptex\platex\misc

ʤɤLaTeXѥɤ߹ޤǥ쥯ȥ֤Ƥ


ˡ
============================================================

PDFƥȥեΤǥ쥯ȥ˰ư
::

  $ kagipdf.rb infile

Τ褦˼¹Ԥޤ ``infile`` reStructuredText
+ʪΤץȳĥˤǽ񤤤ƥȥեǤ
եޤϡƱǥ쥯ȥˤʤФޤ
ޤԤСޥɰȯPDFե뤬ޤ
ΤȤPDFե̾ϡϥեγĥҤ ``pdf`` ֤ΤǤ
ƱˡTeXեʳĥ ``tex`` ˤDVIեʳĥ ``dvi`` ˤϤޤ

ޤ쥯::

  kagipdf.rb < stream

䡢ѥ::

 stream | kagipdf.rb

鵯ư뤳ȤǤޤξ硢ɸϤϥեȤƽ
ϤpdfեΥե̾ ``kagipdf_default.pdf`` Ȥʤޤ

CygwinǻѤ硢ΥCygwinǻѤΥҥȡפ⤪ɤߤ


ץ
============================================================

_`-o <string>`
  ȥץåpdfե̾ꡣ

  ) ``$ kagipdf.rb -o index.pdf infile``

_`-k <type>`
  LaTeXեʸɤ˥åȡ
  ǥեͤCygwinĶShift_JISʳEUC-JP
  <type> ˤ s, u, e Τ줫ꡣ
  줾ʸɤShift_JISUTF-8EUC-JP˥åȡ

  ) ``$ kagipdf.rb -ks infile``

_`-q`
  åϽϤʤ

_`-c`
  pdfեΤ߻ĤơtexdviեϺ

_`-l`
  ֥ե򤹤٤ƻĤ

_`--notex`
  platexѥ¹Ԥʤ

  ) ``$ kagipdf.rb --notex infile``

_`--nopdf`
  dvipdfmxˤpdfեԤʤ

  ) ``$ kagipdf.rb --nopdf infile``

_`--noeps`
  EPSեԤʤ

  ) ``$ kagipdf.rb --noeps infile``

_`--style <type>`
  LaTeXΥե
  <type> ˤ hooktail, report, thesis ǽ
  ǥեȤhooktail

  ) ``$ kagipdf.rb --style thesis infile``

_`--help`
  ץ򼨤إפɽ

_`--version`
  Сɽ

ʤ쥯Ȥӥѥפ ``kagipdf.rb`` ư硢
``-q`` ץդƼ¹ԤΤƱȤˤʤޤ


CygwinǻѤΥҥ
============================================================

Cygwinܸ ``platex`` 򥤥󥹥ȡ뤷Ƥ餺
W32TeXǥѥ뤷Ȥϡ

1. TeXեϤ ``kagipdf.rb`` μ¹Ԥߤ
2. CygwinW32TeXƤӽФ褦ˤ

ĤβޤˤĤƾޤ

TeXեϤ ``kagipdf.rb`` μ¹Ԥߤ
-----------------------------------------------

TeXեϤޤǤǻߤ硢¹Ի ``--notex`` ץդ::

  $ kagipdf.rb -notex infile

ȤɤǤ礦TeXե뤬ǤΤǡ
ȤW32TeXĶǲƥѥ뤷Ƥ
Cygwin ``kagipdf.rb`` ¹Ԥ硢
TeXեʸɤϼưŪShift_JIS˥åȤΤǡ
ΤޤW32TeXǥѥ뤹뤳ȤǤޤ
¾ʸɤTeXեϤϡ 
``-k`` ץǻꤷƤ


CygwinW32TeXƤӽФ褦ˤ
--------------------------------------

ʲǤCygwinW32TeXƤ֤ˤϡ
::

   C:\cygwin\etc\profile.d\lilypond-profile.sh

Ȥե74ܤˤ
::

  if [ -z `echo \$TEXMF | grep "\$datadir"` ]; then
      TEXMF="{\$datadir,"`kpsexpand  \\\$TEXMF`"}"
      export TEXMF
  fi

򥳥ȥȡʹƬ ``#`` ɲáˤƤ::

  $ kagipdf.rb infile

Τ褦˼¹ԤƤ


Ѵμ
============================================================

ʪΤץȤǻѤƤֳĥ [*]_ äreStructuredTextե::

  foo.txt

顢λͤ˽äե::

  foo.reST

ޤ ``rst2latex.py`` ǥѥ뤷TeXϡ
˥ץꥢ֥ʤɤ˽ä::

  foo.tex

ޤθ塢 ``platex`` ǥѥ롢 ``dvipdfmx`` PDFեޤ

ޤfigureimageǥ쥯ƥ֤ˤƤϡ
pnggifˤĤƤepsեѴơ
jpgˤĤƤϤΤޤPDFե˼ߤޤ

.. [*]
   TeX̿ƤӽФδǲ
   ܺ٤ http://tinyurl.com/czukc 򻲾ȤƤ


ΤΥХ
============================================================

- ĥ̿ΥפޤäƤʤʬ
- replaceǥ쥯ƥ֤ͳƿޤ硢EPSѴʤ
- reStructuredTextŪȥȤѤʤ㡧imageǥ쥯ƥ֡


ToDo
============================================================

- rawǥ쥯ƥǤϳĥǽOFFˤ
- ե뤬̥ǥ쥯ȥǤפʤ褦ˤ
- ΤΤϤǤ褦ˤ
- ϥ쥤Ȥҡʥݡȡʸץ쥼ˤ
- ֡reference:פб
- ֡information:פб


Ͽ
============================================================

[ 2006-01-26 *Ver.0.4.0* ]
  ``--style thesis`` εưʸ˽
  ``\ ref{}`` ̿ľܽ񤱤褦ˤ
  kagipdf_thesis.styΥ쥤Ȥ
  LaTeX̿ѥ饹mydefinition.styɤ߹褦ˤ
  mydefinition.styĤɲá
  EPSեؤѴԤʤץ ``-noeps`` ɲá
  READMEؤβɮ

[ 2005-12-25 *Ver.0.3.4* ]
  JPEGEPSեؤѴߥ

[ 2005-10-24 *Ver.0.3.3* ]
  ϥեʸɤUTF-8LaTeXѥ˼ԤΤ
  URL󥳡ɤޤϥѡ󥯤꤯ƯʤΤ
  URL󥳡ɤޤϥѡ󥯤꤯ƯʤΤ
  Vinerpmˤdvipdfmxjpgľܼߤ꤬뤿ᡢJPEGEPSѴ뤳Ȥѹ
  ʥץŬڤ˻ꤹСۤɥե륵Ѥʤˡ
  sourceforge.jpˡkagiPDFפȤƥץϿ

[ 2005-10-21 *Ver.0.3.2* ]
  ``-q`` , ``-c`` , ``-l`` ץɲá
  쥯Ȥӥѥפεư ``-qc`` ץƱͤư褦ˤ
   \$ ΤΤ򵭽ҤǤ褦ɲá
  reportɲáthesisɲá
  align.../align䥿褦ˤ
  äݳĥν򤷤ʤ ``--strict`` ץɲá

[ 2005-10-13 *Ver.0.3.0* ]
  륹ץȤRubyߤƤΤRuby줷
  ˡľƥʥĥ⤯
  ``platex`` ¹Ԥ ``-interaction=nonstopmode`` ץĤ
  顼äƤǻߤޤʤ褦ˤ
  TeXץꥢ֥Ǥ̥̿եȤѰա
  tex䥿ľ˲Ԥʤȿ꤯ɽʤХ

[ 2005-07-25 *Ver.0.2.2* ] 
  JPEGե ``convert`` ޥɤepsѴ
  礭ʤΤǡJPEGѴľPDF˼ˤѹ
  Adobe ReaderǳȤν֤˹碌פꡣ
  ޥ˥奢䥳ι

[ 2005-07-24 *Ver.0.2.1* ] 
  ϥե̾ꤹ륪ץ ``-o`` ɲá

[ 2005-07-19 *Ver.0.2.0* ] 
  Ȥֹ椬ʤХ
  ꡢϥѡ󥯤ͭˤ
  ¹Ի ``platex`` ѥ뤷ʤ褦ˤ륪ץ ``-n`` ɲá
  texեʸ򥪥ץ ``-k`` ɲá

[ 2005-07-16 *Ver.0.1.0* ] 
  


.. [ 2005-xx-xx *Ver.0.x.x* ]
  rst2hooktailǤHTMLȤθߴΤᡢ
  `\label{}`  `\ ref{}` ̿򤽤줾 
  `\tag{#def(maf)}`  `#ref(maf)` Ѵե륿 `ref2ref.rb` Ĥä


.. |latex| raw:: latex

  \LaTeX
