TeX to HTML オンラインマニュアル

1.はじめに
2.プログラムの説明
3.動作環境
4.本プログラムの制限
5.使用方法
6.同梱されているt2hw.pyについて
7.変換したHTMLを表示する際の注意

1.はじめに

TeX to HTMLはTeX(LaTeX)で書かれた文系論文をHTMLに変換すること目的として製作したプログラムです。
また、TeX to HTMLを製作するにあたり、仕様を以下のように設定し製作しました。

2.プログラムの説明

このプログラムは以下のような構成となっています。

3.動作環境

pythonが動作する環境(動作確認済みOS: Windows98/2000)
python-2.2.3及び2.3.4での動作確認をしています。

注)python環境が無い方は以下より入手してください
こちら

4.本プログラムにおける制限

TeX to HTMLには私の技術不足の為、変換における制限及び未対応の部分があります。
変換する際にはお手数ですがTeX文章の校正をお願いします。

《制限のある箇所》

・特殊文字表記はコマンドの最後に必ず{}を表記してください
＜例＞\copyright{}

・段落の中に改行がある場合、その改行を削除してください。段落中に改行があると段落が分かれてしまいます。
＜例＞
春は、あけぼの。
やうやう白くなりゆく山ぎは、
少し明りて、
紫だちたる雲の、
細くたなびきたる。

の場合

春は、あけぼの。やうやう白くなりゆく山ぎは、少し明りて、紫だちたる雲の、細くたなびきたる。

のように改行を削除して下さい。

・\title{}\author{}\date{}は\begin{document}より上に記述し、\maketitleは\begin{document}以下に記述してください。
＜例＞
\title{}
\author{}
\date{}
\begin{document}
\maketitle

・\verbで表記をそのまま表示する場合、表示する部分は必ず「|」の記号ではさんで下さい。
＜例＞\verb|\begin{document}|

《未対応の箇所》

・複雑な表の処理は対応していません。
\multicolumnは一応対応していますが、\multicolumnが&以下に来る場合は正常に変換できません。
＜例＞
りんご & みかん & \multicolumn{3}{c}{いちご}
このような場合正常に変換できません。

・文系論文を対象にしている為、数式等のコマンドには対応していません。

・パッケージ、及び個人で定義されたコマンドには対応していません。

・その他、複雑なコマンドは未対応の部分はまだまだあります。
未対応の場合、<span class="未対応のコマンド">未対応のコマンド</span>と変換されます

5.使用方法

tex2html.pyと変換したいTeXファイルを同じフォルダに保存する。（プロンプトの入力をできるだけ簡素にするため。）

コマンドプロンプトを起動しプログラムのあるフォルダまで移動する。
＜例＞C:\homeにファイルを保存した場合。
>>cd C:\home

以下のように入力しEnterを押す。

python tex2html.py 変換するTeXファイル
＜例＞python tex2html.py sample.tex

また、新しいファイルに変更内容を保存する場合は、以下のように入力して下さい。

python tex2html.py 変換するTeXファイル > 変換したいファイル名
＜例＞python tex2html.py sample.tex > sample.html

6.同梱されているt2hw.pyについて

t2hw.pyはtex2html.pyをプログラムを実行する際に新しいファイル名を入力しなくてもTeXファイルをHTMLファイルに 置き換えてくれるように書き換えたプログラムです。t2hw.pyを使用して変換すると『sample.tex ⇒ sample.html』のように変換されます。

t2hw.pyの使用する場合は、コマンドプロンプトで

python t2hw.py 変換するTeXファイル
＜例＞python t2hw.py sample.tex

と入力すると自動でHTMLファイルに変換内容が保存されます。(例ではsample.htmlとなって保存される。)

7.変換したHTMLを表示する際の注意

変換したHTMLファイルを表示する場合、必ず同じ場所にstyle.cssを置いて下さい。style.cssが無いと正常に表示されません。



TOP
2004.12.4作成