いくつか注意を述べます。下から順に新しくなっていきます。
また、日本語化パッチ version 1.4 以前の情報、
および latex2tml-2K.1beta 以前の情報に関しては、
古い LaTeX2HTML に関する注意
をご覧下さい。
また、開発版の日本語化パッチに関する情報については、
開発版の日本語化パッチのページ
をご覧下さい。
ページが長いので「しおり」の仕組みを用意してみました。
「しおり用」と書かれた所をクリックしてからブックマークに入れると、
それはページの先頭ではなく、その箇所へのブックマークになります。
(03/03 2006)
- (03/11 2010)
(しおり用)
-title で明示的にタイトルをつける場合、
そこに「sinnx」のような上付き文字、
下付き文字を入れることができるようになっているようです。
直接 <SUP>, </SUP> のようなコードを書いて
latex2html -title 'sin<SUP>n</SUP>x'
のように指定すればいいだけです。
下付き文字の場合は <SUB>, </SUB> で囲みます。
これによってタイトル、各ページのリンク先等にもこれが反映されます。
ただし、HTML 的には本来タグ名は小文字 (sin<sup>n</sup>x)
でも構わないのですが、
latex2html の -title の指定の場合はタグ名を小文字で書くと
そのタグは消されてしまいます。
実際には、latex2html の purify というサブルーチンで
title 文字列の HTML タグの削除を行っているのですが、
そこで SUB, SUP のタグだけを残すようにしています。
逆に SUB, SUP 以外のタグを使用してもそれらは消されてしまいます。
それ以外のタグを残したい場合は、
latex2html の purify を修正すれば可能かもしれません
(が、副作用が出るかもしれません)。
- (03/09 2010)
(しおり用)
鷹合＠金沢工大 さん (takago@neptune.kanazawa-it.ac.jp) から、
MS-IE だと、title タグが meta タグでの charset 指定の前にあると
真っ白なページが表示される場合がある (firefox は問題なし)、
という問題とその解決法を教えて頂きました。
具体的には、以下のパッチを latex2html.pin に
(インストール済みの場合には latex2html 自体に)
当てればいいようです。
次期パッチでは採用させて頂きたいと思います。
どうもありがとうございました。
- (01/22 2010)
(しおり用)
「注意、その他 (01/20 2010)」 に書いた
Tgif の斜線パターンが latex2html で変換すると斑点状になってしまう問題ですが、
TeX QandA 掲示板 で達さんから丁寧に教えて頂きました
(
TeX QandA 掲示板 54402 番の記事)。
それによると Tgif の斜線の塗り潰しは、実際には斜線を書いているのではなく、
小さい正方形を並べて書いていて、
そのため pstoimg で拡大縮小するときにそのようなことが起こってしまうようです。
Tgif 自体を改良して、EPS 出力が拡大縮小されても斜線が崩れないようにする、
という方法もあるでしょうが、少なくとも私には無理です。
よって、「注意、その他 (01/20 2010)」
に書いたような色での塗り潰しにするのがとりあえずは良さそうです。
また、手動で自前でその画像だけ変換するという手もあります。
例えば netpbm の pstopnm で手動で PNM にしてから
gif 等に変換すればよいのですが、
その際 pstopnm を使うときに -xsize などに大きな数値を指定して
かなり拡大して出力させると斜線等のパターンが崩れずに出力されます。
その後で netpbm の pnmscale 等で必要な大きさに縮小すれば
斜線パターンは正常なまま出力されるようです。
ただし、「注意、その他 (01/20 2010)」
にも書いたように HTML にするのなら、
むしろ色塗りにした方が見やすく、
無理にパターンでの塗り潰しにこだわる必要もないだろうと思います。
- (01/20 2010)
(しおり用)
Tgif などで図形の一部を斜線などのパターンで埋めたものを EPS にして
includegraphics で取り込んだ場合、
latex2html にかけるとその出力には問題がある場合があります。
一つは、「注意、その他 (04/06 2007)」
等でも紹介した背景色や透明化などの問題ですが、
もう一つ、そのパターンが斑点状になってしまうことがあります。
サンプルを以下に示します。
GIF 画像の方はなぜか斜線パターンが全体に塗り潰されておらず、
斑点のようになっていることがわかると思います。
EPS 画像の方は、一応全体にパターンが入っていますが、
調べてみると、これは pstoimg の内部で gs を使って
EPS から PNM ファイルへの変換を行っている部分で起きていることがわかりました。
gs のパラメータを色々変えて試してみたのですが、
多少は変化するものの完全に解決するには至っていません。
TeX QandA 掲示板 で聞いてもみたのですが、
どうもこれという解決法はなさそうです。
ということで、LaTeX では最終出力として白黒印刷を意識するので斜線の図とし、
latex2html にかけるときは HTML だからカラーでの塗り潰しにすることにして、
そのような 2 つの図を用意して \latexhtml で場合分けすることにしました。
Tgif では、パターンの塗り潰しを色での塗り潰しに変更することは
簡単にできますので、そのようなファイルを用意することは面倒ではありません。
実際そのようなものを用意することで、
上の代わりに以下のような GIF ファイルが作られました。
むしろ、この方がその中に書いた文字も見やすいので、
まあいいかなと思っています。
(cf. 「注意、その他 (01/22 2010)」)
- (01/06 2010)
(しおり用)
latex2html の隠しコマンドのようなものですが、
初期化ファイル .latex2html-init に
$target = "contents";
のような行を入れておくと、HTML version 指定が 4.0 以上のときは、
html ファイルへのリンク (目次、ヘッダやフッタのナビゲーション) の部分が
<A NAME="tex2html1"
HREF="node2.html">...</A>
から、
<A NAME="tex2html1" target="contents"
HREF="node2.html">...</A>
のように変わります。
この a タグの target 指定は指定した名前のフレームに
表示させることを意味しますので、目次のページを残したまま、
もう一つのページに各セクションのページ内容を
表示させることができるようになります。
なぜか latex2html のオプションにもなっていなくて、
latex2html のソースを読まないとこういう仕組みがあることがわからないのですが
(隠しオプション ?)、
それなりに便利な機能だと思います。
- (12/26 2008)
(しおり用)
最近少し CSS 関連について調べているのですが、
現在の latex2html (2002-2-1 (rev.1.71), 2008) での問題点を見つけました。
\TeX, \LaTeX および html パッケージ使用時での \latextohtml コマンドなどは、
latex2html にかけると次のように変換されるようです
(スペースが入ってる箇所もありますが、実際にはスペースは入りません)。
- \TeX:
「<SPAN CLASS="logo-TeX">
T<SMALL>E</SMALL>X</SPAN>」
- \LaTeX:
「<SPAN CLASS="logo,LaTeX">
L<SUP><SMALL>A</SMALL></SUP>
T<SMALL>E</SMALL>X</SPAN>」
- \latextohtml:
「<SPAN CLASS="logo,LaTeX2HTML">
L<SUP><SMALL>A</SMALL></SUP>
T<SMALL>E</SMALL>X2<TT>HTML</TT></SPAN>」
そして、CSS ファイルの方には、次のようなエントリがそれぞれ作られます。
- \TeX:「DIV.logo-TeX { }」
- \LaTeX: 「DIV.LaTeX { }」「DIV.logo-LaTeX { }」
- \latextohtml: 「DIV.LaTeX2HTML { }」「DIV.logo-LaTeX2HTML { }」
見て分かる通り、これらにはおかしな点がいくつかあります。
例えば \LaTeX の場合で言えば以下の点があげられます。
- HTML の class 属性内では、
複数のクラスを指定する場合はスペース区切りであり
カンマ (,) 区切りではないので、上のようにしているせいで
"logo,LaTeX" のようなクラスが作られてしまうことになる。
しかしそれは、CSS では SPAN.logo,LaTeX では参照できず (ブラウザ依存 ?)、
SPAN[class="logo,LaTeX"] のようにしないと参照できない。
- CSS の方ではクラスの名前が logo-LaTeX や、LaTeX
になってしまっているので、上の形だとそのどれにも対応しない。
- しかも CSS では SPAN 要素の設定とすべきなのに、
DIV 要素になってしまっている。
本来は多分、クラスの方は「LaTeX と logo-LaTeX」か、
あるいは「LaTeX と logo」を想定していたのではないかと思うのですが、
いずれも中途半端におかしくなっていて、そのどちらにもなっていないわけです。
よって、例えば以下のような改良が必要なのではないかと思います。
- HTML では
「<SPAN CLASS="logo LaTeX logo-LaTeX">
L<SUP><SMALL>A</SMALL></SUP>
T<SMALL>E</SMALL>X</SPAN>」
- CSS では
「SPAN.logo { }」「SPAN.LaTeX { }」「SPAN.logo-LaTeX { }」
この改良案は、上の「LaTeX と logo-LaTeX」と「LaTeX と logo」
の両方を含む形にしてありますが、
実際には後者のみサポートすれば、多分前者は不要だろうとは思います。
また、この修正自体は全然難しくはなく、latex2html 自体
(インストール前なら latex2html.pin) の do_cmd_LaTeX、
およびその付近にある TeX のロゴ関連のコマンドを
以下のように修正するだけです。
- CSS を出力するための命令の
$env_style{'LaTeX'} = ' ' unless ($env_style{'LaTeX'});
$env_style{'logo-LaTeX'} = ' ' unless ($env_style{'logo-LaTeX'});
のように の変数名を env_style から txt_style に
変更し、必要なクラスの分だけそれを書く:
$txt_style{'logo'} = ' ' unless ($txt_style{'logo'});
$txt_style{'LaTeX'} = ' ' unless ($txt_style{'LaTeX'});
$txt_style{'logo-LaTeX'} = ' ' unless ($txt_style{'logo-LaTeX'});
- HTML を出力するための命令
join('',"<SPAN CLASS=\"logo,LaTeX\">",$Laname,
$TeXname,"</SPAN>",$_);
の、CLASS の部分のカンマ (,) を取り、必要なクラス名を並べる
必要なら latex2html-ML で、どれを想定しているものなのかを聞いてみて、
次期版のパッチではこの修正を行ったものにしたいと思います。
- (12/25 2008)
(しおり用)
latex2html はデフォルトの .css も作りますが、
html パッケージを使用すると、
\htmlsetstyle, \htmladdtostyle コマンドでその .css ファイル中の要素も
latex 側で設定できます。
- \htmlsetstyle[tag]{class}{value}: tag.class に value の定義を入れる
- \htmladdtostyle[tag]{class}{value}: tag.class に value の定義を追加する
例えば
\htmlsetstyle[DIV]{displaymath}{color:red}
とすると、.css には
DIV.displaymath { color : red }
が書き出されます。なお、value 部分は '=' を ':' に変換してくれますので、
\htmlsetstyle[DIV]{displaymath}{color=#ff00ff}
のような書き方も可能ですし、複数行定義することもできるようです。
ただ、例えばセクションタイトル部分の背景色を設定するために
H1 { background-color : #ffccff }
とする場合は、単に class 部分を省略して
\htmlsetstyle[H1]{}{background-color=#ff00ff}
とすると、tag 部分が DIV となって
DIV.H1 { background-color : #ffccff }
となってしまいます。このような場合は
\htmlsetstyle[H1.]{}{background-color=#ff00ff}
とする必要がありますので注意してください
(この点で、「LaTeX Web コンパニオン」の 3.3.4 節の最後のサンプルは
現在の latex2html の版とは異なる記述になっています)。
環境単位で .css の記述を適用させるためにクラスを設定するには、
「LaTeX Web コンパニオン」の 3.3.4 節にあるように、
環境の \begin 部分にオプション引数を与えますが、
もう少し小さい単位で適用させたい場合は、
\HTMLcode コマンドを利用します。例えば、
\texttt{hoge}
という部分に SPAN タグを使用して mytt クラスを設定するには、
\HTMLcode[class="mytt"]{SPAN}{\texttt{hoge}}
のようにするといいようです。これは latex2html によって
<SPAN CLASS="mytt"><TT>hoge</TT></SPAN>
のように展開されますので、
\htmlsetstyle[SPAN]{mytt}{...} によって .css に
必要なプロパティを設定すればいいわけです。
なお、上のような \HTMLcode をいちいち書くのは面倒なので、
通常はマクロを利用することになるでしょう。
- (12/22 2008)
(しおり用)
ページの背景色の設定は、
.latex2html-init 内に $BODYTEXT を定義することでも行えますが、
html パッケージを使用すると、
\bodytext コマンドでページの背景色を変更できます。
これを使うと、例えば以下のようにして
ページ毎に背景色を変えることもできます:
\begin{document}
\section{赤いセクション}
\bodytext{bgcolor="#ffcccc"}
「赤い」という形容詞はある。
\section{青いセクション}
\bodytext{bgcolor="#ccccff"}
「青い」という形容詞もある。
\section{緑のセクション}
\bodytext{bgcolor="#ccffcc"}
「緑い」という形容詞はない。
\end{document}
しかし、この方法では、latex2html が自動的に最後に付加する
「この文書について」のセクション (section* として扱われる)
の色を指定することはできず、
最後のセクションの色がそのまま引き継がれます。
何か方法はないものかと調べてみたのですが、
残念ながら latex2html か japanese.perl を改造するしかなさそうです。
japanese.perl の改造は、例えば以下のようにすればいいでしょう。
- japanese.perl に書かれている japanese_infopage の 4 行目位に
以下の行を入れる:
&infopagehook if defined &infopagehook;
- ~/.latex2html-init (個人用の初期設定ファイル) に以下の行を入れる:
sub infopagehook {
$BODYTEXT = 'bgcolor="#ffffff"';
}
この改造自体は害にはなりませんし、
$BODYTEXT 以外にも infopage (「この文書について」のページ)
になんらかの設定をできる余地を作ることにもなりますので、
current 版の次期版では導入も検討してみようかと思います。
- (12/14 2008)
(しおり用)
netpbm コマンドをパスの通っていないところに置いていて、
latex2html のインストール時に一時的にパスを通してインストールした場合、
一部のコマンドが起動できない、という問題が起こる事例があります。
そのようにインストールした場合、確かに pstoimg には
ほとんどの netpbm コマンドは絶対パスで登録されるので
うまく起動できるのですが、
最近の netpbm では例えば ppmquant はラッパースクリプト (perl スクリプト)
になっていて、
その内部で pnmquant を「パスをつけずに」呼びだしています。
そのために、実際の latex2html の実行時に netpbm コマンドのある
ディレクトリにパスが通っていないと ppmquant が失敗する、
ということになってしまいます。
回避するには、netpbm コマンドのあるディレクトリに
パスを通す (環境変数 PATH にそのディレクトリを追加する) のが
一番楽なのですが、もしそれをしたくなければ以下のような手が考えられます。
- latex2html 自体を起動するラッパースクリプトを作成し、
その内部で latex2html 起動前に PATH にそのディレクトリを追加する
- netpbm の ppmquant 自体を修正し、
絶対パスをつけて外部コマンドを実行するようにする
ただし、この後者には注意が必要で、実は ppmquant が内部で呼びだす
pnmquant もラッパースクリプト (perl スクリプト) になっていて、
さらに内部で pnmcolormap, pnmremap を呼び出していますから、
そこも修正する必要があります。
簡単に調べてみると、netpbm 内部には
バイナリではないスクリプトコマンドが 15~20 位はあるようです。
それらがそれぞれ内部で「パスをつけずに」netpbm コマンドを呼んでいる
可能性がありますので、それらを全部修正しないといけないかもしれません。
それなら、多分素直にパスを通した方が楽でしょうね。
- (10/03 2008)
(しおり用)
「注意、その他 (09/24 2008)」
で報告した latex2html-2008 のリリースに伴う日本語化パッチですが、
とりあえず開発版の方の日本語化パッチを更新しました。
詳しくは、以下を参照してください。
しばらくはそちらのみ対応させる予定ですので、
必要ならばそちらを取得してください。
なお、「注意、その他 (09/24 2008)」
でも書いたように、実質的な変更はありませんので、
従来の latex2html-2002-2-1 用の日本語化パッチでも
そのまま当たると思いますし、そのまま使えると思います。
- (09/24 2008)
(しおり用)
latex2html-2008 がリリースされました。以下参照。
latex2html-2002-2-1 に対する更新部分は以下の通りのようです。
- Licence が GPL になった
- 現在の開発者 (Ross Moore) のメールアドレス、URL 等の修正
ということで、実質的なコードの変更はありませんので、
今までの latex2html-2002-2-1 用の日本語化パッチは
そのまま利用できると思いますが、
上記の変更に合わせた修正を行った日本語化パッチを新たに作るかどうか
考えてみたいと思います。
(cf. 「注意、その他 (10/03 2008)」)
- (03/24 2008)
(しおり用)
最近一つ書いた文書を latex2html で変換したのですが、
その際、図番号がつかない問題が発生しました。
基本的には、latex2html の QandA に書いた、
「Q.30. figure 環境の図番号が出ないものがあります」
に書いたように、
\caption 内に書いたコマンドが .aux で展開されるのを防ぐように、
適宜コマンドに \protect をつけていけばいいのですが、
今回は少しはまってしまったので報告します。
今回は、\boldmath を使う以下のようなマクロを一つ使っていました:
\newcommand{\Vecb}[1]{\mbox{\boldmath $#1$}}
...
\caption{$\Vecb{\bar{e}_y}$ 軸}
このまま latex2html にかけると全然だめで、
.aux ファイルを見ると、\bar, \boldmath, \mbox が展開されているようでした。
よって、以下のいずれの対処でもうまくいきます。
- \Vecb と \bar を展開しないようにする
- \Vecb は展開させて \mbox, \boldmath, \bar を展開しないようにする
それぞれ以下のようにするわけです。
- 1. の方法:
\newcommand{\Vecb}[1]{\mbox{\boldmath $#1$}}
...
\caption{\protect\Vecb{\protect\bar{e}_y} 軸}
- 2. の方法:
\newcommand{\Vecb}[1]{\protect\mbox{\protect\boldmath $#1$}}
...
\caption{\Vecb{\protect\bar{e}_y} 軸}
こういう作業は、.aux ファイルをチェックしながら、
修正と LaTeX のコンパイルを繰り返すといいでしょう。
ところで、最初のだめなソースでは \Vecb{...} 自体を $$ で囲んであります。
\mbox{} で全体が囲まれているので、
本来これを $$ で囲む必要はないのですが、
一応数式なので、気分的に $$ で囲むことが多く、
\caption 内でもそうしていたのですが (LaTeX ではどちらも問題ない)、
実はこれが latex2html では問題があるようで、
この $$ を外さないとだめなようです。
となると、さらに複雑なマクロを書いてしまうと、
もっと面倒なことになる可能性がありそうです。
よって、latex2html にかける場合、
それも考慮してマクロの組み方も考える必要があるかもしれません。
- (01/22 2008)
(しおり用)
プログラムのソースコードのようなものは、
以前は verbatim 環境で書いていて、
その場合はインデントも含めてうまく latex2html で変換できていたのですが、
今回 quote 環境内に \tt を置いて書いてみました。
問題はインデントなのですが、インデントは最初は
全角スペース 2 つをタブインデントとして並べて書いていました。
確かにそれならば latex2html でもそれがそのまま使われるので、
WWW ページでもそれなりにインデントに見えるのですが、
その WWW ページをマウスでコピー & ペーストして貼り付けて
そのままプログラムソースとして使おうとすると、
一見インデントスペースに見えるところに全角スペースが入っているので、
そのまま使うことはできません
(むしろ厄介なバグの元になってしまいます)。
それで、全角スペースの代わりに「\ \ \ \ 」あるいは「\mbox{\ \ \ \ }」
のようなものに変えてみたのですが、
これは latex ではインデントに見えるのですが、
latex2html ではこのスペースが無視されてしまいます
(原因は後で調べてみます) ので、インデントになりません。
これは、\usepackage{html} の元、
以下のようにすればとりあえずは回避できるようです。
\latexhtml{\ \ \ \ }{%
\begin{rawhtml} \end{rawhtml}}
\latexhtml は、latex にかけるときは最初の {} 内を有効にし、
latex2html にかけるときは後ろの {} 内を有効にするマクロで、
また rawhtml 環境は、HTML の命令を直接記述するための環境です。
これで、HTML でも「\ \ \ \ 」と同等のスペース 4 つに展開されました。
- (01/13 2008)
(しおり用)
数式モード以外で ">>" や "<<" を使うと、
latex2html ではこれは、"&187;" や "&171;"
と変換されます。
最近のブラウザでは問題なく表示されるかもしれませんが、
古いブラウザではこの部分が表示されないなどの問題がでますので、
その場合は、\usepackage{html} の元、
\latexhtml{>>}{{>}{>}}
のような書き換えをすればいいようで、
これで ">>" にしてくれます。
- (04/06 2007; no.2)
(しおり用)
春休みを利用して、少し長い LaTeX ファイルを書いて、
それを latex2html にかけたところ色々問題が出ました。
そのうち、いくつかをここに上げます。
-
\renewcommand でコマンドを再定義したのですが、
それによる障害が起きましたので、
なるべく使わない方がいいようです。
例えば、カウンタを定義すると、
自動的にその名前に \the のついた命令が定義されるのですが、
それを \renewcommand で再定義したら問題が起きました。
\def\the... のようにしたら問題はありませんでした。
-
Appendix 内のサブセクションの番号付けが変になります。
通常のセクションは 1, 2, 3, ...,
\appendix 命令以降のセクションは A, B, C, ... のような
セクション名になるのですが、
元々 Appendix 以降のセクションには、
サブセクションは入れないことになっているのか、
latex2html では、正確には通常は「1」「2」、
\appendix 以降は「A.」「B.」のように、'.' がついています。
そのため、A. のサブセクションのセクション名が
「A..1」のようになってしまいます。
これは、latex2html 内で、&do_cmd_the_appendix() の定義が、
sub do_cmd_the_appendix {
local($val,$level) = (0,$_[0]);
if ($level == 3) { $val=$global{'section'} }
elsif ($level == 2) { $val=$global{'chapter'} }
join('', &fAlph($val), '.', $_[1]);
}
となっているためで、この最後の join の行を
join('', &fAlph($val), $_[1]);
のようにすれば解決します。
しかし latex2html を自体を修正するのもなんなので、
それに対処する perl ファイルを作って読み込ませることで
回避しました。
上のように修正した &do_cmd_the_appendix() の定義を書いて、
最後に
1;
と書いた perl ファイル (例えば test1.perl) と、
それに対応する空の package ファイル (test1.sty) を用意して、
それを usepackage (\usepackage{test1}) で読み込んでいます。
latex2html は、package ファイルに対応する .perl という
名前の perl スクリプトを読み込みますので、
それで上の新たな定義が適用されます。
-
塗り潰しを使った画像の背景が灰色になっていました
(cf. 「注意、その他 (04/06 2007)」)。
-
psfrag を使ったのですが、
それによる置き換え文字が latex2html によって画像化されると
切れる問題が起きました
(古い latex2html に関するページ の
「注意、その他 (09/23 2001)」
参照)。
かなりたくさん (32 個) あったので、手動でない方法での対処を考えました。
まず、これが起こる原因は、dvips の挙動にあります。
dvips -E で EPS ファイルを作る際、dvips が作成する BoundingBox は
その変換後の文字列の幅を考慮しておらず、
その BoundingBox で EPS 画像から画像を切りだすと、
画像部分は収まるのですが、はみでた文字が切れてしまいます。
切れるのは右端の文字だけのようなので、
pstoimg の中の gs の呼び出しに細工をして、
BoundingBox による横幅よりも広い横幅で切り出すようにして、
その右端の余分な余白を pnmcrop -r で切り捨てる、
としてみました。以下にそのパッチを置きます。
pstoimg に -psfrag というオプションをつけて実行すると
そのような挙動になります (ただし、正しく動作する保証はありません)。
対象となる psfrag を使った画像 (img*.gif) だけを
latex2html の作ったディレクトリから一旦削除して、
latex2html に -debug をかけて再実行します。
その出力から pstoimg の実行部分を grep と sed でとりだして、
その pstoimg に -psfrag オプションをつけて、
そのコマンド列を実行する、という処理をスクリプトにして実行しました。
本当は、\htmlimage{} でそういう指定を行えるようにすると
いいのかなと思いましたので、今後少し考えてみたいと思います。
-
ある画像は、画像自体は同じで、その中の文字列だけが違うものだったので、
LaTeX ファイルでは同じ EPS ファイルを includegraphics して、
文字だけ別の文字を psfrag で置き換えをして使っていたのですが、
latex2html は、EPS ファイル名が同じだと同じ画像だと思ってしまうので、
同じ GIF ファイルを貼り付けてしまいます。
よって、そのような場合もあえて別の EPS ファイル名にして
(シンボリックリンクでよい)、includegraphics しないといけませんでした。
-
log 型コマンドを一つ、
\makeatletter
\newcommand{\supp}{\mathop{\operator@font supp}\nolimits}
\makeatother
のように定義していたのですが、psfrag を利用したら、
LaTeX ではいいのですが、latex2html では置き換え文字列が
"@font supp" のようになってしまいました。
よって、この定義を
\newcommand{\supp}{\mathop{\mathrm{supp}}\nolimits}
のように変えました。
- (04/06 2007)
(しおり用)
「注意、その他 (06/08 2004)」,
「注意、その他 (12/14 2004; no.3)」,
「注意、その他 (01/07 2005)」
と書いてきた、
「Tgif で書いた EPS 画像などの『白での塗りつぶし』の透明化に失敗する問題」
の第 4 段です。
今回新たな問題が起きたことに関して、2 つの解決策を見つけましたので、
報告します。
「注意、その他 (12/14 2004; no.3)」 に書いた
原因によって起こる問題は、そこに書いたように手動で latex2html (pstoimg)
と同じようにして GIF (または PNG) 画像を作ってやるという手もあるのですが、
psfrag を使っている場合はそれではだめです。
一度画像を LaTeX と dvips にかけないと画像内の文字が正しく変更されません。
今回、この問題に対して以下のような 2 つの方法を考えてみました。
- latex2html にその画像を -debug で再生成させることで残る
中間画像ファイルを利用して、手動の作業を行う
- 環境変数 TRANSPARENT_COLOR を利用する
順に説明します。
まず、1. の方ですが、latex2html は画像を生成する場合、
その中間画像ファイルを /tmp/l2hXXXX のような名前のディレクトリに作成して、
作業が終わったらそのディレクトリを削除するのですが、
-debug オプションをつけるとそのディレクトリは削除せずに終了します。
よって、そこに残った画像ファイルを利用するわけです。
今、例えば file.tex 内の hoge1.eps というファイルを
latex2html が画像化した file/img9.gif というファイルに問題があるとします。
このとき、まず問題になっている画像を file/ から取り除きます:
% mv file/img9.gif .
-debug つきで latex2html を起動します。
その実行時に表示される画面も残しておきます。
% latex2html -image_type gif -debug file.tex > log
このログ log には、以下のようなものが記録されていると思います:
...
Running "/usr/local/bin/pnmcrop -verbose < /tmp/l2h1465/p1495.pnm
| /usr/local/bin/ppmquant 256
| /usr/local/bin/ppmtogif -interlace -trans '#ffffff' > img9.gif"
pstoimg: Written img9.gif
...
この例では、/tmp/l2h1234 が中間画像のあるディレクトリで、
その p1495.pnm という画像を変換して GIF ファイルを作っていることがわかります。
その transparent オプションを変えて、
手動で以下のようにして正しい gif ファイルを作ればいいわけです。
% pnmcrop /tmp/l2h1465/p1495.pnm | ppmquant 256 \
| ppmtogif -interlace -trans '#b2b2b2' > file/img9.gif
次は 2. の方ですが、実はこの transparent の色指定を変えるだけならば、
pstoimg が内部で参照する環境変数 TRANSPARENT_COLOR を利用する、
という手があります。こちらの方は、以下のようにして、
その画像を作り直すだけです:
% mv file/img9.gif .
% setenv TRANSPARENT_COLOR "#b2b2b2"
% latex2html -image_type gif file.tex
(setenv は csh 系のシェルの場合。bash などの sh 系のシェルの場合は
「TRANSPARENT_COLOR="#b2b2b2"; export TRANSPARENT_COLOR」)
画像自体に #b2b2b2 に近い色が含まれていない場合で、
白の塗り潰しなどがあるために画像の色がおかしくなる場合は、
psfrag でない場合でも多分この 2. の対処が一番楽なのではないかと思います。
(cf. 「注意、その他 (04/06 2007; no.2)」)
- (03/28 2007)
(しおり用)
l2h-ML に、
gnuplot の吐き出したカラー EPS ファイルを
pstoimg で PNG 画像に変換しようとしているんだけどうまくいかない、
という質問が来ました。
白黒画像だとうまくいくんだけど、ということでした。
pstoimg は latex2html に付属する Perl スクリプトで、
数式や includegraphics で張り込んだ EPS 画像を PNG や GIF 画像に
変換して HTML に貼り付けるために latex2html 内部から呼びだされる
latex2html の付属ツールです。
実際、-debug オプション付で、
gnuplot のカラー EPS ファイルを変換しようとすると次のようになって
うまくいきません:
% pstoimg test1.eps
pstoimg V2002-2-1 (Revision 1.19, Perl 5.008008)
pstoimg: Processing test1.eps
pstoimg: Error: "/usr/local/bin/netpbm/ppmquant 256
< /tmp/p29317.pnm | /usr/local/bin/netpbm/pnmtopng
> test1.png" failed: Illegal seek
-debug オプションをつけて詳しく見ると、次のようになります:
% pstoimg -debug test1.eps
pstoimg V2002-2-1 (Revision 1.19, Perl 5.008008)
pstoimg: Temporary directory is /tmp
pstoimg: Processing test1.eps
pstoimg: EPSF dimensions are 360x252
pstoimg: Running /usr/local/bin/gs -sDEVICE=pnmraw -g360x252
-sOutputFile=/tmp/p29558.pnm
GS>-50 -50 translate
GS>(test1.eps) run
GS>showpage
GS>quit
GNU Ghostscript 7.07 (2003-05-17)
Copyright (C) 2003 artofcode LLC, Benicia, CA. All rights reserved.
This software comes with NO WARRANTY: see the file PUBLIC for details.
GS>GS>Loading StandardSymL font from
/usr/local/share/ghostscript/fonts/s050000l.pfb...
1980440 623432 1783296 480146 1 done.
Loading NimbusSanL-Regu font from
/usr/local/share/ghostscript/fonts/n019003l.pfb...
2020632 672552 1783296 485810 1 done.
>>showpage, press <return> to continue<<
GS>>>showpage, press <return> to continue<<
GS>Image "/tmp/p29558.pnm" is PPM, 360x252
Running "/usr/local/bin/netpbm/ppmquant 256 < /tmp/p29558.pnm
| /usr/local/bin/netpbm/pnmtopng > test1.png"
pnmcolormap: making histogram...
pnmcolormap: Scanning image 0
pnmcolormap: 3 colors so far
pnmcolormap: Scanning image 1
pnmcolormap: Image 1 depth (1) is not the same as Image 0 (3)
pnmcolormap failed, rc=256
pnmtopng: Error reading magic number from Netpbm image stream.
Most often, this means your input file is empty.
pstoimg: Error: "/usr/local/bin/netpbm/ppmquant 256
< /tmp/p29558.pnm | /usr/local/bin/netpbm/pnmtopng
> test1.png" failed: Illegal seek
pnmcolormap (現在はスクリプトである ppmquant の内部で呼び出されるコマンド)
の出力で、"image 0", "image 1" と出ていて、
それらの depth が違うので失敗、となっていることがわかります。
実は、pstoimg の内部で呼び出される gs が、
1 つの PNM ファイル内に 2 つのイメージを書き出していて、
それでそのようなことが起きてしまっています。
実際に、gs の作る PNM ファイル (上の例の場合 /tmp/p29558.pnm) には、
"P6" から始まるバイナリ PPM 画像の最後に、
なぜか "P4" から始まるバイナリ PBM 画像 (全く空白)
がついています。
gv でその EPS ファイルを確認すると、
1 ページ目はグラフが出るのですが、
スペースキーで次のページへ行こうとすると
確かに空白のページが表示されるので、
この EPS ファイルのそのような構造のせいでそのようなことが
起きているのかもしれません。
回避策としては、pstoimg に '-antialias' や '-antialias -depth 1'
のようなオプションを使ってみる、という手があります。
こうすると、少くともうちの環境では
(Solaris 9, gs 7.07, netpbm 10.31.0, pstoimg 1.19)
なぜか image 0, image 1 の色数が同じになって、
上記のエラーは発生しませんでした。
ただし、元記事の人はそれではうまくいかなかったようです。
もう一つの回避策としては、pstoimg の '-multipage' オプションを使う
という手があります。
これは、複数ページからなる PS ファイルに対して使うオプションで、
これを使用すると正しい画像ファイル
(上の例のように test1.eps を変換する場合は
test11.png というファイル名になる) と、
空白の画像ファイル (test12.png) ができます。
もちろん、pstoimg は、元々は汎用のツールではなく、
latex2html が内部で呼びだしたときに正しく動作すればいいので、
本来は dvips の出力する EPS ファイルさえ処理できればいいわけで、
gnuplot の EPS を直接変換できなくてもバグでも問題でもありません。
実際、gnuplot のカラー EPS ファイルを
「LaTeX ファイルの内部に includegraphics で取り込んで、
それを latex2html にかけた」場合は、
pstoimg によって何の問題もなく正しい画像ファイルが生成されます。
だから、汎用目的で使う場合に、多少 PS ファイルによって
うまくいかないことがあってもおかしくはないでしょうし、
上に書いたように、gnuplot の作成する EPS にも多少問題があるのでは、
とも思います。
ただし、ここに書いたように、
必ずしも汎用目的で個別のツールとして使えないわけではありませんから、
その場合は上記のような点に注意するといいでしょう。
- (01/30 2007; no.2)
(しおり用)
「注意、その他 (01/30 2007)
の続きのもう 1 件の質問は、
「LaTeX2HTML で変換された HTML ファイルから、
逆に LaTeX のソースを作る、あるいは PDF にできるか」
というものでした。
残念ながら、LaTeX2HTML 自体にはそのような機能はありません。
なんとかするとすれば、以下のような感じでしょうか。
- HTML から LaTeX 等に変換するツールを使う
検索するとこのようなツールはいくつかみつかります。
ただ、私は一つも使ったことがありませんので、
使いやすさ等についてはわかりません。
さらに、以下にそのようなソフトの詳しいリストがあります。
- ブラウザの機能で印刷する
- 著者に頼んで、LaTeX のソースか PDF 化したものを公開してもらう
HTML 化したものを公開してくれるやさしい人ですから、
そうしてもらえる可能性もあるかもしれません。
実際、HTML と同時に PDF を公開している人も多いですね。
- LaTeX2HTML で変換した最後のページ「この文書について」から
LaTeX ファイルが取得できる場合がある
これは、「この文書について」の最後に、コマンド行が書かれていますが、
そこに LaTeX ファイルへのリンクがついている場合があります。
そしてそのファイルが実際にそのリンクから取得できる場合があります。
ただし、そうでないことの方が多いので
(HTML に変換したもののみを WWW サーバに移動することが多い)、
これで取得できることの方がまれかもしれません。
私だったら、まず wget で全体を取得して、
画像がなければ w3m などでテキスト化して印刷するか、
画像があれば、HTML ファイルをなんとか 1 file につなげて、
ブラウザで PS に直して印刷する、といった感じでしょうかね。
- (01/30 2007)
(しおり用)
珍しく 2 件も質問が来ました。分けて書きます。
1 件目は、
「LaTeX で \newpage を入れても latex2html では無視されてしまうが、
そこで HTML を分割するには」
という質問でした。
LaTeX2HTML では、各 HTML ページに節番号をつけて
前後のページへのリンクを貼るような形式を取りますので、
\newpage では HTML ページの分割は起こりません。
逆に言うと、LaTeX2HTML のスタイルから考えて \newpage で
別 HTML に分けるとすると、
その 2 つの HTML ファイルは同じセクションに属しているわけですから、
次のページへのナビゲーションパネルにどう書いたらいいかわからなくなります。
同じセクションの同じ名前、にするわけにもいきませんから、
LaTeX2HTML の原理から言って \newpage で別 HTML にはできません。
よって、HTML ファイルを分割したければ、
そこに subsection を入れるなどして
どうしてもセクションを分ける必要があります。
もし、LaTeX の方では subsection を入れたくなくて、
HTML だけそうしたいなら、\usepackage{html} の元、
\latexhtml{\newpage}{\subsection{2 ページ目}}
のようにすれば、LaTeX にかけるときは \newpage、
latex2html にかけるときは \subsection{2 ページ目}、
がそれぞれ解釈されるようになります。
後は、もし必要ならば、こうやって作った HTML ファイルを
手で編集するとかでしょうか。
そもそも、HTML には物理ページサイズはありませんから、
\newpage でページ分割するのは、物理ページサイズが固定されている
印刷形式にのみ意味があるものだろうと思います。
よって、個人的には HTML では \newpage の場所に <hr>
でも入れる、つまり
\latexhtml{\newpage}{\htmlrule}
位でどうかなと思います。
(cf. 「注意、その他 (01/30 2007; no.2)」)
- (01/14 2007)
(しおり用)
latex2html のページ
の質問の投稿フォームに、
「l2h-2002-2-1+jp2.0 で、init file で $charset="UTF-8";
として、init file や styles/japanese.perl などを UTF-8 に変換したら
UTF-8 に変換できたんだけど、
ページに charset=UTF-8 を定義する META タグがつかない」
という質問が来ました。
まず、最初に注意しておきますが、
jp2.0 パッチは UTF-8 出力は想定外です。
利用している TeX の環境がどうなのか、
それと UTF-8 の関係はどうなっているのかわかりませんが、
色々な日本語の文字化けなどが起こる可能性はありますし、
こちらでの動作確認等もできません。
よって、回答も適当な回答しかできません。
UTF-8 の HTML 出力をしたければ、
jp1.X 系列 (例えば jp1.9) を使用するのが一応本来の使用法です。
jp2.0 で UTF-8 用の META タグをつけたい場合は、上記の他に
多分パッチを当てた latex2html 本体を修正する必要があって、
/(EUC[-_]JP|Shift[-_]JIS)/
とか書いてあるところ (3 箇所位) を
/(UTF[-_]8|EUC[-_]JP|Shift[-_]JIS)/
とかしてみるとうまくいくかもしれません。
ただし、こちらでは未確認ですし、
上に書いたように問題が起こる場合もあります。
なお、この質問者には書かれていたメールアドレスへ
メールで返答したのですが、
そのメールアドレスは有効ではない、とエラーメールが戻ってきました。
メールアドレスは、本人の了解なしに公開することはしませんから、
到達可能なメールアドレスを書いていただきたいと思います。
- (11/24 2006)
(しおり用)
「注意、その他 (05/11 2006)」 に書いた、
netpbm が rgb.txt を参照できなくて
画像ファイルが生成されないことがある件ですが、
最近、Debian GNU/Linux 上でのそのような事例を 2 つほど目にしました。
いずれも、Netpbm が rgb.txt を探そうとする検索パスと、
実際の rgb.txt のパスが合っていないことによるもののようです。
これ自身は、latex2html の問題というよりは Netpbm の問題なので、
コンパイル前の設定を正しく修正して (pm_config.h の RGB_DB*)
Netpbm を再インストールするか、
環境変数 RGBDEF を設定するかで回避できますが、
「注意、その他 (05/11 2006)」 に書いたように
pstoimg を修正することでも回避できます。
- (11/06 2006)
(しおり用)
開発版の日本語化パッチを更新しました (jp1.10beta2.7, jp2.1beta1.7)。
詳しくは
を参照してください。
- (10/25 2006)
(しおり用)
「注意、その他 (10/20 2006)」
に書いた fleqn のテストをしていて、一つ (既知の) バグを見つけました。
latex2html に "-html_version 3.2,math" のように
math モジュールを使って数式の変換をやると、
"mathend000#" のような文字列が HTML ファイルに残る場合があります。
これは、l2h-ml に既に報告されているバグのようです。
そこにパッチもありますが、インストール後の latex2html
(インストール前なら latex2html.pin) にパッチを当てれば解消されます。
以下にもパッチを置きますが、
2 箇所だけなのでパッチファイルを見て手で修正してもいいでしょう。
次期日本語化パッチでも採用する予定です。
- (10/20 2006)
(しおり用)
私は普段 documentclass に fleqn オプションを使って
LaTeX の文書を書くことが多いのですが、
それを latex2html で変換した数式の位置が変だなあと
ぼんやりと思ってはいましたがちゃんと調べてはいませんでした。
それを今回少し調べて考えてみましたので
ここに書いておきます。
まず、fleqn を使う場合、
オリジナルの latex2html と日本語化パッチの当った latex2html では
挙動が少し違います。それは、
古い latex2html に関するページ の
「注意、その他 (08/09 2001)」
に書いた対処によります。以下に、
- \[ \] (displaymath 環境)
- equation 環境
- eqnarray* 環境 (eqnarray 環境で数式番号なし)
- eqnarray 環境
で書いた数式を含む LaTeX ファイルを latex2html にかけたサンプルを上げます。
いずれもデフォルトの設定の latex2html-2002-2-1 による変換結果です。
「オリジナル」と書いたものも完全にはオリジナルそのものではなく、
日本語化パッチの、上の修正部分を元の挙動に戻したものです。
-
オリジナルの latex2html で fleqn なし
-
オリジナルの latex2html + fleqn
-
日本語化パッチの latex2html で fleqn なし
-
日本語化パッチの latex2html + fleqn
これらのブラウザでの表示、およびその HTML ソースを見ると、
以下のことがわかります。
- オリジナルは、fleqn のあるなしで違いがあるのは equation 環境のみで
displaymath 環境や eqnarray* 環境は常にセンタリング、
eqnarray 環境は常に左寄せに見える
- 日本語化パッチは、displaymath 環境が fleqn で左寄せになっているが
その他はオリジナルと同じ
- fleqn の equation 環境と日本語化パッチの fleqn の displaymath
環境は数式が左寄せになるが、左にピッタリつきすぎ
(LaTeX では多少インデントがある)
- eqnarray* 環境はそれ全体が一つの画像に変換されているが、
eqnarray 環境は、各行の & で区切られる 3 要素がそれぞれ画像化され、
table タグを用いて書かれている
- displaymath 環境は画像を img タグで貼っているだけだが
equation 環境は table タグで書かれている
これらの取り扱いは、いずれも versions/html*.pl (*=3_2, 4_0 等)
で定義されていて、
よって latex2html のオプションによって多少挙動は変わりますが、
少なくともデフォルトでは以上のようになります。
これらの挙動は、できれば以下のように改善したいように思います。
- [a] displaymath 環境と equation 環境の fleqn の場合の左寄せを、
LaTeX 同様多少字下げのついた形式にしたい
(fleqn なしの場合はセンタリングにしたい)
- [b] eqnarray* 環境も fleqn の場合はインデントのある左寄せにしたい
- [c] eqnarray 環境の fleqn なしの場合はセンタリングしたい
displaymath 環境のセンタリング、センタリングなしは、
div タグの align オプションで実現されているのですが、
fleqn の場合はその代わりに blockquote タグを使えば
[a] は解決できそうに思います。
なお、本来はそのような処理は css を使って、
div タグに displaymath クラスを定義しておいて、
その場合のインデント処理を css ファイルで定義するのがいいのかもしれません。
実際 latex2html の生成するデフォルトの css ファイルには
"DIV.displaymath" という項目が見られます。
しかし、デフォルトでは HTML ファイルには class の定義はなされず
(よって "DIV.displaymath" は有効に働いてはいない)、
それに修正に css の知識が必要、というのでは一般ユーザには
敷居が高いようにも思います。
[b] も [a] と同じようにすれば実現できそうです。
あとの残りは [c] なのですが、実は [c] については、
今のやり方を残しつつ改善するのはやや難しいように見えます。
一応 [a],[b] に上記のような対処 (blockquote を使用)
をしたもので変換すると、
上のサンプルは以下のようになります (fleqn の場合のみ)。
blockquote を使用した場合は画像の上下のスペースをカットした方がいいかなど、
まだ検討すべき点もありますし、
多くの場合に問題ないかという点も確認はしていませんが、
一応それなりの表示にはなるように思います。
今後これを日本語化パッチに含めるか、
あるいは別パッチとして単独に公開するか、
日本語化パッチに含めたとしてこの挙動を選択できるようにするか、
等に関しても色々検討してみたいと思います。
(cf. 「注意、その他 (10/25 2006)」)
- (08/10 2006)
(しおり用)
「注意、その他 (08/09 2006)」
に書いた Shift_JIS 環境での latex2html に関する追加情報ですが、
jp1.9 でそこに書いたような処置をした場合、
初期化ファイル ~/.latex2html-init の漢字コードも EUC-JP にしておく
必要があります。
もちろん、l2hconf.pm 内に漢字を書いた場合は、
それも EUC-JP にしておかないといけません。
例えば ~/.latex2html-init 内で変換者の名前を漢字で定義している場合は、
それを EUC-JP にしておかないと (Shift_JIS のままだと)
その名前だけが文字化けしてしまいますので注意してください。
- (08/09 2006)
(しおり用)
Mac OS や Cygwin 上でのことのようですが、最近 WWW 上で、
「Shift_JIS 環境で latex2html のインストールがうまくいかない」
というものを複数目にしましたので、気になって少し試してみました。
すると、やはり多少修正が必要なことに気がつきましたので
報告します。
なお、以下の話は (Cygwin ではない) MS-Windows 版
(阿部＠北教大 さんのもの) の場合は当てはまらないと思いますので
注意してください。
- jp1.9 版の日本語化パッチ (nkf 使用版) の場合
付属ドキュメント (README.patch-2002jp) に書いてある作業の代わりに
以下の作業を行なって下さい:
「config/config.pl に書かれている
$newcfg{'TONATIVE'} = "|$nkf -e";
$newcfg{'TOHTML'} = "|$nkf -j";
$newcfg{'FROMNATIVE'} = "$nkf -e";
を
$newcfg{'TONATIVE'} = "|$nkf -s";
$newcfg{'TOHTML'} = "|$nkf -j";
$newcfg{'FROMNATIVE'} = "$nkf -e";
に直してください。
styles/japanese.perl の漢字コードは変換しないでください。」
付属ドキュメントと違う部分は、
- FROMNATIVE の方は -e のままいじらないこと
- styles/japanese.perl の漢字コードを変換しないこと
の 2 点です。
上記の修正により、LaTeX ファイルを EUC-JP に変換して読み込んで
(latex2html の内部処理は EUC-JP で行ない)、
LaTeX ファイルを吐き出して画像化する際は Shift_JIS で出力し、
HTML ファイルは 7bit JIS (iso-2022-jp) で出力する、
ということになります。
これは、阿部＠北教大さんの MS-Windows 版のやり方と
ほぼ同じやり方だと思います。
Shift_JIS のまま内部処理を行うと色々問題があるようです
(perl-5.8.X の機能などを利用しない限り。jp2.0 版の方を参照)。
- jp2.0 版の日本語化パッチ (nkf 非使用版) の場合
この場合は、現在のところ、完全には修正できませんが、
ある程度なら修正できます。
付属ドキュメント (README.patch-2002jp) に書いてある作業の代わりに
以下の作業を行なって下さい。
- styles/japanese.perl の漢字コードを Shift_JIS に変換
(付属ドキュメントには書いてない)
- 付属ドキュメントに書いてある
styles/japanese.perl の修正 ($charset を EUC-JP から Shift_JIS に)
- styles/japanese.perl の 2 箇所にある「表」を「表\」に変更
しかし、jp2.0 の場合はこの修正は十分ではなく、
「表」などの Shift_JIS コードで 2Byte 目が '\' (0x5c) に等しい漢字が
地の文に含まれると、そこが文字化けするようです。
jp2.0 は nkf を使わないわけですから、
となるとこちらの場合根本的な解決は、
perl-5.8.X の機能を積極的に利用した形に
書き直しを行うしかないかもしれません。
この他にも何かお気づきの方はご連絡
(shige@iee.niit.ac.jp)
ください。
今までは、実際に Shift_JIS 環境の pLaTeX を使っていませんでしたので、
良くわかりませんでしたが、今後、付属ドキュメントを修正したいと思います。
(cf. 「注意、その他 (08/10 2006)」)
- (06/23 2006)
(しおり用)
latex2html は、tabbing 環境の処理は苦手で、
場合によっては tabular 環境に変えてくれ、
というメッセージがでることがあります。
今回、tabbing 環境を使ったサンプルを書いたので、一つ紹介します。
最初、tabbing 環境で以下のようなものを書きました。
\begin{tabbing}
1st \= 2nd \= 3rd \= 4th \= 5th \= 6th \kill
\> (1) 1 行入力する (暗黙の getline)\\
\> (2) 現在行が「ア」の行かチェック\\
\> \> (3) 「ア」ならば、その行を保存して\\
\> \> (4) その行が「イ」であるかチェック\\
\> \> \> (5) 「イ」ならば、次の行を取得し
...
\end{tabbing}
つまり、tabbing 環境を使って、字下げを実現しようとしたわけです。
これを、latex2html にかけるにあたって、以下のように修正しました。
\usepackage{html}
...
\begin{latexonly}
\begin{tabbing}
1st \= 2nd \= 3rd \= 4th \= 5th \= 6th \kill
\> (1) 1 行入力する (暗黙の getline)\\
\> (2) 現在行が「ア」の行かチェック\\
\> \> (3) 「ア」ならば、その行を保存して\\
\> \> (4) その行が「イ」であるかチェック\\
\> \> \> (5) 「イ」ならば、次の行を取得し
...
\end{tabbing}
\end{latexonly}
\begin{htmlonly}
\begin{tabular}{lllll}
\multicolumn{5}{l}{(1) 1 行入力する (暗黙の getline)}\\
\multicolumn{5}{l}{(2) 現在行が「ア」の行かチェック}\\
& \multicolumn{4}{l}{(3) 「ア」ならば、その行を保存して}\\
& \multicolumn{4}{l}{(4) その行が「イ」であるかチェック}\\
&& \multicolumn{3}{l}{(5) 「イ」ならば、次の行を取得し
...
\end{tabular}
\end{htmlonly}
つまり、LaTeX にかけるとき (latexonly 環境内) はそのまま、
latexh2html にかけるとき (htmlonly 環境内) は、
枠線のない tabular 環境と multicolumn の組み合わせで
簡単な字下げになるようにしたのですが、
これを latex2html は、以下のように展開してくれるようです。
<TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT" COLSPAN=5>(1) 1 行入力する (暗黙の getline)</TD>
</TR>
<TR><TD ALIGN="LEFT" COLSPAN=5>(2) 現在行が「ア」の行かチェック</TD>
</TR>
<TR><TD ALIGN="LEFT"> </TD>
<TD ALIGN="LEFT" COLSPAN=4>(3) 「ア」ならば、その行を保存して</TD>
</TR>
<TR><TD ALIGN="LEFT"> </TD>
<TD ALIGN="LEFT" COLSPAN=4>(4) その行が「イ」であるかチェック</TD>
</TR>
<TR><TD ALIGN="LEFT"> </TD>
<TD ALIGN="LEFT"> </TD>
<TD ALIGN="LEFT" COLSPAN=3>(5) 「イ」ならば、次の行を取得し
...
</TABLE>
つまり、table タグの colspan を使って、
丁度 table 環境 + multicolumn に対応することをやってくれています
(何もないところは でスペースを入れてくれています)。
よって、tabbing 環境を使いたときは、
上のような手が使えるようです。
なお、上記のサンプルは以下から取ったものです。
- (05/26 2006)
(しおり用)
「TeX Q&A 掲示版」 の 43063 番の記事で、Ken さんから、
HTML ファイルの上の方に JavaScript の
<script language="javascript"
src="hoge"></script>
のような行をつけたいんだけど、うまくいかない、という報告がありました。
確かに、そのような行を .latex2html-init の top_navigation_panel の中に
"<script language=\"javascript\"
src=\"hoge\">" .
"</script>" .
のように入れても、消されてしまいます。
実は、latex2html は、内容のないタグ (らしきもの) を削除して出力しています。
これを行っているのは text_cleanup() というサブルーチンで、
実際に、その中の以下のような部分 (正確にはその最後の行)
によって消されているようです。
### DANGEROUS ?? ###
# remove redundant (not <P></P>) empty tags, incl.
with attributes
s/\n?<([^PD >][^>]*)>\s*<\/\1>//g;
s/\n?<([^PD >][^>]*)>\s*<\/\1>//g;
# remove redundant empty tags (not </P><P>
or <TD> or <TH>)
s/<\/(TT|[^PTH][A-Z]+)><\1>//g;
s/<([^PD ]+)(\s[^>]*)?>\n*<\/\1>//g;
よって、これをコメントアウトすれば消されなくなるのですが、
副作用が起こることもありうるので、
むしろこのパターンにマッチしないようにすればいいので、
例えば
"<script language=\"javascript\"
src=\"hoge\">" .
" </script>" .
のようにスペースを一つ入れるとか、
"<script language=\"javascript\"
src=\"hoge\">" .
"<!-- --></script>" .
のようにコメント記号を入れてしまえば消えなくなります。
なお、
"<takeno></takeno>" .
のようなタグ (これは自身は実在しませんが) の場合は、
上の 1 番目と 2 番目の行で消されてしまうので、
この場合はスペースを入れて
"<takeno> </takeno>" .
としてもその行にマッチしてしまって消されてしまうので、この場合は、
"<takeno><!-- --></takeno>" .
のようにコメント記号のようなものを入れる必要があります。
- (05/16 2006)
(しおり用)
l2h-ML でのやりとりで気がつきましたが、
latex2html が変換する数式に下線がついてしまう事例として、
その画像の部分を \smash (plain TeX のコマンド) のコマンドで
高さを 0 にしてしまうとそういうことが起きます。
latex2html は画像を作る際に、
画像の高さを計算して表示の深さを調整するために、
元々画像の左と下に「L 字型」の黒線をつけて画像を作ります。
latex2html に -debug オプションをつけてつくられる、
XXX/images.dvi (XXX は変換する TeX のファイル名) を見てみればわかります。
そして、それを画像化した後、
Netpbm の pnmcrop というツールで、
この L 字型の黒線を外枠の基準として画像を切りだして、
その黒線自体も切りとるのですが、
pnmcrop は、
- 画像の上下左右の空白部分を切り捨てる (左端の上から下までと、
下端の左から右までに黒線が残る)
- 下端の黒線を切り捨てる
- 左端の黒線を切り捨てる
という風に使われます。
しかし、その画像に \smash が使われていると
画像の高さが 0 になってしまうので、
下端であるはずの黒線よりも下にその画像がはみでることがあります。
そうなると、「上下左右の空白を切り捨てる」というときには、
そのはみ出た部分までしか切りとられないので、
次の「下端の黒線を切り捨てる」ことができなくなってしまい、
黒線が残ってしまう、といったことになってしまいます。
その場合の回避策としては、とりあえず \smash を
使わないようにするしかありませんが、
dvi ファイルを作るときには \smash を使いたい、
というのであれば、latex2html にかけるときだけ \smash を使わないように、
\latexhtml コマンドを使って、
\latexhtml{ % ここは LaTeX が使う
% \smash を使って書く
}{ % ここは latex2html が使う
% \smash を使わないで書く
}
のように書けばいいでしょう (\usepackage{html} が必要)。
- (05/11 2006)
(しおり用)
latex2html が使用する Netpbm に関して l2h-ML に質問が流れ、
2 つの問題点があることがわかりました。
一つ目は、Netpbm のバージョン番号の問題です。
新しい Netpbm のバージョン番号は、
通常は 9.24 とか 10.25 といったバージョン番号で、
これをそのまま小数と見てバージョン番号の比較が行えるのですが、
中に 10.18.4, 10.26.13 といったバージョン番号のものがあるようです。
このような Netpbm を使っている場合、
latex2html のインストールの最中 (configure 時) に、
Argument "10.18.4" isn't numeric in numeric gt (>)
at config\config.pl line 1246
のような行が出力されてしまうようです。
もちろん、本来はちゃんとそれに対処する必要がありますが、
実際にはこのような行が出力されるものの本質的な実害はない
(正しく条件分岐はされる) ようなので、
とりあえずは無視してもいいようです。
新しい日本語パッチでは対処したいと思います。
もう一つの問題は、rgb.txt の問題です。
latex2html は、pnmtopng などを使って透明化する場合、
色名 'gray85' を使って透明化を行う場合があります。
しかしその場合、特に MS-Windows 環境の場合、
色名を参照できずに pnmtopng が失敗する場合があるようです。
その場合、以下のような行が表示されることがあります。
Converting image #2
pstoimg.bat: Error: "pnmtopng.exe -interlace -trans gray85 <
c:\Temp\l2h1368\p3692.pnm > img1.png" failed: Bad file descriptor
Error while converting image
ML での報告者は、Cygwin 版の Netpbm を使っていて、
それが configure 時 (config.bat の実行時) に認識されてしまっていて、
それが rgb.txt というファイルを参照できなくてそのようになっていたようでした。
手動で pnmtopng をやった結果は以下のようになったそうです。
C:\tmp>pnmtopng.exe -interlace -trans gray85 <
c:\Temp\l2h3832\p660.pnm > img2.png
c:\Program1\GnuWin32\bin\pnmtopng.exe: can't open color names dictionary
file named /usr/lib/X11/rgb.txt, /usr/openwin/lib/rgb.txt, or
/usr/X11R6/lib/X11/rgb.txt and Environment variable RGBDEF not set.
Set RGBDEF to the pathname of your rgb.txt file or don't use color names.
この場合、ここに表示されているように、
RGBDEF という環境変数を rgb.txt があるディレクトリに
設定すればいいようですが、
そもそも rgb.txt がない場合は、
latex2html の配布物に rgb.txt が含まれています (styles/ の中) から、
それを利用すればいいでしょう。
/usr/lib/X11 というディレクトリを作って、
そこにこれをコピーすればうまくいくかもしれません。
または、latex2html が色名 'gray85' を使用しなければいいので、
pstoimg (MS-Windows の場合は pstoimg.bat) に書かれている
'gray85' という文字列 (latex2html-2002-2-1 の場合は 1510 行目付近) を
RGB 形式の表現 '#d9d9d9' に変えればいいのではないかと思います。
(cf. 「注意、その他 (11/24 2006)」)
- (05/09 2006; no.2)
(しおり用)
LaTeX2HTML 用の環境 makeimage
(LaTeX2HTML で HTML 化するときは、その環境全体を画像化する) ですが、
その中に LaTeX のコメント行として $ が含まれている場合エラーが起きるようです。
例えば以下のようなものでも起きます。
\documentclass{jarticle}
\usepackage{html}
\begin{document}
\begin{makeimage}
% $
こんなんどや。
\end{makeimage}
\end{document}
これを latex2html にかけると
*** Error: unclosed math or extra `$', before:
のように言われます。
latex2html の、makeimage 環境内でのコメント行の処理に
多分問題があるのだと思いますので、
少し調べてみますが、
とりあえずはそのようなコメント行を makeimage 環境内に
入れないようにするといいでしょう。
- (05/09 2006)
(しおり用)
Yasufumi Haga さんが公開しておられる LaTeX2HTML のマニュアルの日本語訳が
更新されたようです (1.1 Beta)。
- (03/16 2006)
(しおり用)
「TeX Q&A 掲示版」 の 42043 番の記事で、takashina さんから、
MS-Windows 版の latex2html がうまく動かない (対象ディレクトリの下に
TMP なるディレクトリができるだけ、という情報がありました。
実行時には以下のようなエラーメッセージが出るそうです。
texexpand: Error: More than one input file specified.
texexpand failed: No such file or directory
結局、"C:\Documents and Settings\hoge\..." のように、
パスに空白が含まれているディレクトリ上で実行したのが原因らしく、
"c:\work\" のような上で実行したらうまくいったそうです。
Unix 由来のソフトの場合、パスに空白や日本語が含まれていたりすると
問題が起こることがありがちですが、
latex2html も同様のようです。
- (02/17 2006)
(しおり用)
LaTeX2HTML では内部で Netpbm を使用していますが、
Netpbm の version 10.30, 10.31 辺りの pnmtopng にはバグがあり、
そのため画像が生成されないことがあります。この場合、
(-debug オプションをつけると) 以下のように表示されるでしょう。
ppmquant -floyd 256 </tmp/l2h16891/p17166.pnm | pnmtopng -interlace > img577.png
pnmcolormap: making histogram...
pnmcolormap: Scanning image 0
pnmcolormap: 14 colors so far
pnmcolormap: 14 colors found
pnmcolormap: Image already has few enough colors (<=256). Keeping same colors.
pnmremap: 14 colors found in colormap
pnmremap failed, rc=13
Segmentation fault
(cf. l2h-ml に流れた情報:
[l2h] Image conversion)
次の Netpbm 10.32 位からは修正されるようですが、
Netpbm を 10.26 辺りにバージョンダウンするか、
Netpbm 10.31 用の以下のパッチを使ってみるといいかもしれません。
- (09/19 2005)
(しおり用)
開発版の日本語化パッチ jp1.10beta, jp2.1beta を公開します (ようやく)。
今までのパッチとは挙動が異なる点もありますので、
新しいパッチに関する注意等は
新しいパッチ専用の WWW ページ
に載せることにします。
- (09/16 2005)
(しおり用)
今まで ~/.latex2html-init を使っていたので気がつきませんでしたが、
初期化ファイルを使っていない場合、ナビゲーションパネルの
"Next:", "Up:", "Previous:"
(Next, Up, Previous などの画像の下の行に出る、
各リンクの前につくはずのもの)
が出ないことに気がつきました。
これは share/lib/latex2html/styles/japanese.perl の
japanese_titles 内で、本来定義すべきである変数
$next_name, $up_name, $previous_name 等が
定義されていないことが原因です。
~/.latex2html-init を使っている場合、その中で定義されている
{top,bottom}_navigation_panel() 内で直接 Next: などと書かれているため、
$next_name の設定とは無関係にこれが使われます
(よって逆に自分用にカスタマイズしたければ、
初期化ファイルを直接修正すれば可能です)。
とりあえずはそれで対処できます。
他の各国語用の perl ファイルを見ると、以下のような
3 通り (2 通りとも言える) の対応があるようです。
- 各国語での「next」等が定義されている (duch,french,german 等)
- 英語の「next」が定義されている (american,english)
- japanese.perl 同様定義されていない (czech,esperant,italian 等)
となると、あながち現在の japanese.perl の対応は間違いではないのですが、
このままというのも何なので、
次期パッチでは一旦 english_titles を読み込んだ後で、
その設定を japanse_titles の設定を行う、
というやり方に変えてみようかと思います
(他の perl ファイルでは行われていない手法なんで何ですが)。
いっそ、
$next_name="次へ", $up_name="上へ",
$prev_name="前へ"
のように日本語の設定してもいいのですが
(実際そのようにカスタマイズされている方もおられるようですが)、
その上に貼られるナビゲーションボタンが "Next"
等になっているので、まあとりあえずは "Next:" のままにして、
カスタマイズしたい人が ~/.latex2html-init などでカスタマイズする
という方向でいいのではないかと思います。
もちろん、「注意、その他 (12/08 2003)」
で述べたように、
ここを日本語にして、かつナビゲーションボタンも日本語にする、
という手もあるでしょう。
- (08/10 2005; no.2; (09/14 2005; 一部修正))
(しおり用)
多分最もカスタマイズの要望が強くて、
なおかつうまくいかない事例が多いと思われる、
ユーザ名と日付のカスタマイズについて、
現在の日本語化パッチの状況とその方法について説明しておきます。
設定ファイル、およびそれらの優先順位に関する記述
(「注意、その他 (08/10 2005)」)
も合わせてご覧ください。
まず、各ページの下に出力される名前と日付の部分は、
latex2html では $ADDRESS という変数を書き出しています。
これは、
「注意、その他 (08/10 2005)」
でいうと、
- l2hconf.pm (あまり意味はない)
- styles/japanese.perl
- latex2html 本体のユーザ初期化ファイルを読み込む前の部分
で 3 度定義されていますが、
それらはいずれも初期化ファイルで上書き可能ですし、
コマンドラインオプションの -address でも変更可能です。
例えば、.latex2html-init で
$ADDRESS = "これがページの一番下 (竹の)\n";
のように書けば、署名も日付もなく、上に書いたものに置き変わります。
なお、styles/japanese.perl、latex2html 本体では、
$ADDRESS は以下のように定義されています:
@address_data = &address_data('ISO');
$ADDRESS = "$address_data[0]\n$address_data[1]";
ユーザ名は、ページ下の署名と、
最後の「この文書について」の変換者として使用されますが、
それは styles/japanese.perl 内の japanese_infopage() 内で
$address_data[0] が使われていますので、
これは .latex2html-init で
$address_data[0] = "竹のでんねん";
$ADDRESS = "これがページの一番下 (竹の)\n";
と書いておけば、
これが変換者としても使われますので、
ユーザ名の問題はこれで解決します。
問題は日付の方です。日付を絶対的な日付とするなら、
上と同様に、.latex2html-init で
$address_data[1] = "2005年 吉日";
$ADDRESS = "$address_data[0]\n$address_data[1]";
と書いておけば、ページ下の日付も、最終ページの日付も
これで指定したものになります。
しかし、\today コマンドの出力はこれとは無関係ですし、
通常は絶対的な日付にしたいのではなく、
その書式 (西暦か元号かとか) を変更したい場合が
ほとんどだと思いますので、それについて説明します。
通常、以下の 3 つが自動的に日付が計算されて展開されています:
- \today
- 各ページ下の日付
- 最終ページの「この文書について」の変換日
\today は latex2html では do_cmd_today()
という関数で生成されているのですが、
これは "japanese_today()" という関数があればそれを使い
(default ではなし)、
なければ get_date() という関数を使ってそれを
default_today() という関数内で加工したものをデフォルトの日付とします。
このデフォルトの日付は "月名 日, 年号" となりますが、
月名には @Month という配列の値が使われています。
実はここからが厄介なのですが、現在の日本語化パッチでは
styles/japanese.perl 内で、
本来は日本用の日付生成関数として japanese_today() を作るべきが、
それより低いレベルの関数である get_date()
を日本用に再定義していて、それが呼びだされています。
月名用の配列 @Month もここで日本用のものが定義されてしまっています。
各ページ下の日付は、上に書いたように address_data('ISO')
が生成する配列の 2 つ目の成分 $address_data[1] を使うのですが、
それも実は get_date() の出力なので、
やはり style/japanese.perl で再定義されたものが使われています。
最終ページの変換日は、$address_data[1] が使われていますので、
これはデフォルトでは address_data('ISO') の 2 つ目の成分で、
これも上と同じものになります。
だから、自動的に日付を計算させて、かつ \today の出力も、
ページの下の日付や変換日の日付も同じ日付の書式にしようとする場合は、
get_date(), japanese_today() を .latex2html-init で
定義 (再々定義) する必要があるのです。
例えば、.latex2html-init に以下のようなものを入れます:
########### 日付のカスタマイズ (ここから) ##########
$MySeireki=1; # 元号にするにはここを 0 にする
sub get_date {
local($format,$order) = @_;
local(@lt) = localtime;
local($d,$m,$y) = @lt[3,4,5];
sprintf("%d/%d/%d", $m+1, $d, 1900+$y);
}
sub japanese_today {
local($today) = &get_date();
local(@Month) = ('', '睦月', '如月', '弥生', '卯月', '皐月',
'水無月', '文月', '葉月', '長月', '神無月',
'霜月', '師走');
local($y);
if ( $MySeireki ) {
$today =~ s|(\d+)/0?(\d+)/(\d+)|$3年 $Month[$1] $2日|;
} else {
$today =~ /(\d+)\/0?(\d+)\/(\d+)/;
$y = $3 -1988;
$today = "平成 $y年 $Month[$1] $2日";
}
# $today;
# 09/14 2005 修正
join('',$today,$_[0]);
}
$address_data[0]="たけのでんねん";
$address_data[1]=&japanese_today();
# $mygd=&get_date();
# $ADDRESS = "こんなんでっせ ($mygd)";
# get_date() の確認用
$ADDRESS = "$address_data[0]\n$address_data[1]";
########### 日付のカスタマイズ (ここまで) ##########
こんな風にすると、\today もページ下の日付も、変換日も
"2005年 葉月 10日" のようになります。
月名を "1月 2月 ..." のようにしたいならば、
既に styles/japanese.perl 内でそのように定義されていますので、
上の @Month 局所変数を消せばうまくいくでしょう (多分)。
ただ、上のような状況はやはりあまりよろしくないので、
新しいパッチでは、styles/japanese.perl 内の
get_date() の再定義はやめ、japanese_today() を作る予定です
(上のものの拡張版です)。
- (08/10 2005)
(しおり用)
現在の latex2html の日本語化パッチの設定ファイルの
優先順位について説明しておきます。
これは次期パッチで変更されますので、
付属のドキュメントで説明する予定です。
latex2html には l2hconf.pm、.latex2html-init のような
設定ファイルの他に、
日本語化用のファイル styles/japanese.perl、
コマンドラインオプション、latex2html 本体内の設定、
-init_file で指定したファイルでの設定などがあり、
その設定の読み込まれる順番は以下のようになっています:
- l2hconf.pm
- l2hconf.pm の最後 (の方) で読み込まれる styles/japanese.perl
- latex2html に書かれたデフォルトの設定
- HOME またはカレントディレクトリの .latex2html-init (あれば)
- コマンドラインオプションの設定
- -init_file で指定したファイルによる設定
後で読み込まれるものの設定が、前に読み込んだ設定を上書きしますので、
原則、この下にあるものの方が優先順位は上ということになります。
ただし、色々な理由で、設定がうまくいかない場合もかなりあります。
例えば、生成される META タグにつけられる charset の設定
(変数 $charset) は、
styles/japanese.perl で設定されているのみなので、
.latex2html-init で変更できるのですが、
それが META タグに使用される前に
実は latex2html 本体内でクリアされてしまっています。
よって、jp1.9, jp2.0 の日本語化パッチでは、
$charset が日本語の locale の場合は
それをクリアしないような仕組みがしてあります
(jp2.0 の場合はコード変換をしないので EUC-JP と Shift_JIS のみ有効)。
(cf. 「注意、その他 (08/10 2005; no.2)」)
- (08/05 2005; no.4)
(しおり用)
「TeX Q&A 掲示版」 の 37246 番の記事で、T.WATANABE さんから
MS-Windows 版の latex2html では、l2hconf.pm, .latex2html-init,
latex2html.bat のどれが正しい設定ファイルなのか、
という質問がありました。
MS-Windows 版だと確かにそのように思うこともあるかもしれませんね。
最後の latex2html.bat は、
MS-Windows 版では latex2html 本体をこのような名前にしているそうです。
だからもちろん設定ファイルではありません。
37248 番の記事にも書きましたが、本来は
- l2hconf.pm: システム管理者の設定ファイル
- .latex2html-init: 各ユーザ毎の設定ファイル
のような住み分けになっています。
ただ、MS-Windows では「システム管理者＝唯一人のユーザ」
(最近の Linux も ?) という構図が多いでしょうから、
確かにどちらでもいいような気もします。
ただ、l2hconf.pm を個人設定ファイルとして使う場合、
- 新しくインストールし直したときに個人設定をまた書き直す必要がある
(.latex2html-init はインストールで上書きされないので必要ない)
- 少し l2hconf.pm と .latex2html-init は内容が違うし、
latex2html での扱われかたも少し違う
という問題点もあります。
だから、やはり無難なのは本来の個人設定ファイルである
.latex2html-init を使うべきなのでしょう。
なお、元記事の方は、
日付とユーザ名のカスタマイズがしたかったそうですが、
これは現在作成中 (^^;) の新しい日本語化パッチで対処と
説明書きを加えるつもりのものですが、
今の日本語化パッチでは少し厄介な問題です。
その方も、.latex2html-init や l2hconf.pm でもうまくいかず、
結局 latex2html.bat (latex2html 本体) を修正して対処されたそうです。
新しいパッチの公表の前に、
現在のパッチの場合の状況と対処法を一度何かにまとめて
報告しておいた方がいいかもしれませんね。
そうすれば、新しいドキュメント書きにも役立つかもしれませんし
(そう、これが全く進んでいないのです <(_ _)>)。
- (08/05 2005; no.3)
(しおり用)
「TeX Q&A 掲示版」 の 37165,37183 番あたりで、
duke さんから MS-Windows 版の latex2html での
初期化ファイル (.latex2html-init) の置き場所がわからない、
という話がありました。
Win32 版では、環境変数 HOME を見ているようなので、
適当なディレクトリを環境変数 HOME を設定して、
そこに .latex2html-init という名前で置けばいいようです。
HOME が設定されていない場合はカレントディレクトリを探すようですから、
latex2html を実行するディレクトリを固定するなら
そのディレクトリに置いておく、という手もあると思います。
latex2html に dot.latex2html-init というファイルが
付属していると思いますが、
その名前を変更して使えばいいでしょう。
「注意、その他 (05/26 2005)」
にそのファイルの日本語訳 (と補足の追加) も置いてあります
(ただし漢字コードは EUC-JP)。
なお、latex2html は Unix 由来のプログラムなので、
パス名にはスペースが入らないようにした方が無難だと思います
(そのような問題も、37235 番の記事で報告されました)。
また、37183 番の記事は元々はナビゲーションアイコンボタンの配列を
"[Next][Up][Previous]" から
"[Previous][Up][Next]" に変えたい、というものだったのですが、
これは初期化ファイルの sub top_navigation_panel{} にある
"$NEXT $UP $PREVIOUS $CONTENTS $INDEX $CUSTOM_BUTTONS" .
"$PREVIOUS $UP $NEXT $CONTENTS $INDEX $CUSTOM_BUTTONS" .
に変えるだけです。もちろん、整合性を取るために、
その下の $NEXT_TITLE と $PREVIOUS_TITLE の入れ換えとか、
sub_bot_navigation_panel{} もついでに直しておくといいでしょう。
- (08/05 2005; no.2)
(しおり用)
「TeX Q&A 掲示版」 の 37151 番の記事で
栗山さんから報告がありましたが、
\usepackage{amsmath} を使っていると、
数式の部分の画像の作られ方がかなり違います。
例えば、display 数式環境内の \mbox{文字} のような部分も、
画像化されずにそのまま文字として出力されます。
これは仕様で、amsmath や amstex を使っている場合は
こんな風になるようです。
「LaTeX Web コンパニオン」
の 3.3 節にも書かれていますが、
いわゆるプロフェッショナルモードでの数式モードなんだそうです
(私にはよくわかりません <(_ _)>)。
AMS パッケージを使うということは、
たくさん色んな数式が出てくるだろうということを見越した仕様のようです。
- (08/05 2005)
(しおり用)
最近たて続けに
「TeX Q&A 掲示版」 で latex2html の話題が取り上げられました。
ここでひっくるめてまとめておこうと思いましたが、
検索の都合も考えて、今まで同様、
一つの話題毎に区切って書いておきます。
「LaTeX2HTML に関するページ」の
「latex2html に関する QandA」Q.1. や
「注意、その他 (08/26 2002)」 に書いた、
dvips のオプションに '-Ppdf' がついていると数式の下に
黒線が残ることがある問題ですが、
「TeX Q&A 掲示版」 の 37151,37161 番以降のたくさんの記事で
栗山さん、角藤さんに色々教えてもらって、
その状況や問題点などが明らかになってきました。
私の理解した範囲でまとめておきます。
- 黒線の残る画像を調べると、
gs で PPM 画像に落としたときに
本来 L 字型の黒枠が左と下につくはずなのだが、
黒線が残るものはその縦線が下に少し (1 ドット幅) 突き出ている
- そのために、その後の処理の pnmcrop が下の黒線を削除するのに
失敗している
- これは dvips のオプションによって
そういうことが起こることがあるようで (例えば -Z をつける)、
細かくいうと dvips で alt-rule.pro の後で tex.pro や texc.pro
を読みこむようにして作った EPS ファイルではそういうことは
起こらない (Vine Linux や W32TeX ではそのために起こらないらしい)
- しかし、-Ppdf の場合、tex.pro や texc.pro を、
PDF 用により適切な再定義をしている alt-rule.pro を、
その後でまた tex.pro や texc.pro で上書きするのはおかしい
- -Ppdf の場合、まれにフォントの生成で失敗して出力できない可能性もある
- そもそも、PDF 出力用のオプションである -Ppdf を使って作った EPS を
PNG/GIF を作るために PPM に落すということ自体がナンセンス
ということで、やはり -Ppdf は使わない方がいい、
ということがわかりました。
新しい日本語化パッチでも、
-Ppdf は使わないようにしておきたいと思います。
栗山さん、角藤さん、どうも色々ありがとうございました。
- (07/31 2005; no.3)
(しおり用)
「TeX Q&A 掲示版」 の 37151 番の記事で報告されましたが
(by 栗山さん)、Vine 版の latex2html では、
どうも wrapper スクリプトの l2h と、
それ用の l2hconf*.pm が合っていないようで、
l2h は jp1.6 以降用、l2hconf*.pm は j1.6 より前の形のものに
なっていて、
l2h がうまく動かないようになっているようです。
対処法も上の記事に書かれています (以前のやり方にする方法)
ので、そちらをご覧ください。
- (07/31 2005; no.2)
(しおり用)
「TeX Q&A 掲示版」 の 37149 番の記事や
「注意、その他 (02/26 2004)」
でも報告していますが、
数式に 'y' のようにベースラインよりも下につきぬける文字が
入る場合、latex2html は、その画像に適当に下にスペースを追加し、
その画像を align="middle"
(通常はそのようなスペースは追加せずに align="bottom")
として、うまくベースラインが合うようにします。
日本語が入っている場合もこのようになるようです。
ただ、その計算は、ブラウザによってはあまりうまくは表示されないようで、
実際に Netscape や MS-IE6 ではそれなりに見えますが、
FireFox では少し浮いた形で表示されてしまうようです。
これは各ブラウザの癖のようなもので、
例えばもっと大きな画像では
むしろ Netscape と FireFox が似たような表示になって
MS-IE6 では違ったように見えてしまいますので、
よって完璧にこれを合わせる、というのは、
見る側が使うブラウザを仮定しない限り無理なんだと思います。
- (07/31 2005)
(しおり用)
「TeX Q&A 掲示版」 の 37148 番の記事あたりで気がつきましたが、
日本語化されていない gs (Ghostscript) でも、
dvips で日本語をビットマップに展開することができるなら
それで一応数式部分に日本語が入っている場合も latex2html が使えます。
W32TeX の dvipsv は、dvipsk に VFlib 対応機能を追加したものだそうで、
それがこれに相当します。
逆に、数式部分の日本語が出ない、という問題が、
W32TeX で dvipsk ではうまくいかないのに dvipsv でうまくいく、
という場合は、多分 gs が日本語化されていない
(または設定がうまくいってない) のだろうと思います。
- (07/30 2005)
(しおり用)
「TeX Q&A 掲示版」 (の 37109 番の記事) で、
数式内の日本語の最後が切れてしまう、という問題が報告されました
(by 本田さん)。
これはどうやら最近の日本語版の dvips(k) の問題のようで、
角藤さんにより、対処法
(dvips(k) の texk/dvipsk/bbox.c を 1 行修正して再コンパイルする)
が報告されました (37114 番の記事)。
これで確かに直るようです。
例えば dvips(k) 5.95a p1.7 などがこれに該当します。
MS-Windows 版の W32TeX では、
dvipsk の代わりに dvipsv を使う、という解もあるようです
(37113 番の記事)。
- (06/10 2005)
(しおり用)
うちでも最近 TeX を入れ換えたので、
ついでに netpbm のバージョンを上げて
latex2html のインストールのし直しをしたのですが、
make test でこけてしまいました。
原因は netpbm-10.2X の ppmquant のようです。
netpbm-10.19 辺りから ppmquant は perl script に変わっています
(pnmquant への wrapper になっていて、
pnmquant 自体も pnmcolormap と pnmremap の wrapper である
perl script です)。
それが原因なのか、pstoimg のデフォルトで設定されている
ppmquant の -floyd オプションを使うと
pnmcolormap: making histogram...
pnmcolormap: 16 colors found
pnmcolormap: Image already has few enough colors (<=256). Keeping same colors.
pnmremap: 16 colors found in colormap
pnmremap: Out of memory allocating Floyd-Steinberg structures
pnmremap failed, rc=256
のように言われて正常に出力されません。
対処法は、pstoimg に書かれている -floyd オプション (2 箇所) の部分
$reduce_color = "$PPMQUANT -floyd 256";
を、-floyd オプションを取って
$reduce_color = "$PPMQUANT 256";
のように変更するといいようです。以下にパッチを置きます。
なお、ppmquant 自体が obsolete で pnmquant を使え、
と manual にも書かれていますし、
pnmquant にしても perl script になっていて
そこでオーバーヘッドが生じますから、
netpbm-10.19 以降では $PPMQUANT を
pnmcolormap と pnmremap の組合せにした方がよさそうですが、
それについてはまた調べてみたいと思います。
- (05/26 2005)
(しおり用)
「注意、その他 (04/03 2005)」
でもお話しした新しい日本語化パッチですが、
dot.latex2html-init の訳と補足等の追加を行ったものを、
これだけでも多少は役に立つかも知れないと思いますので、
先行して公開します。
なお、新しい日本語化パッチに含まれる (予定の) 新機能に対する記述は
まだ行われていません。
なお、このヘッダにも書いてありますが、
単なる訳ではなく改変部分も含まれていますので
オリジナルのものも参照してください。
ライセンスは、オリジナルの latex2html に従うものとします。
また、そこに書かれていることに関しては、オリジナルの作者ではなく、
私 (shige) に連絡して下さい。
(cf. 「注意、その他 (08/05 2005; no.3)」)
- (05/14 2005)
(しおり用)
「TeX Q&A 掲示版」 (の 35834 番の記事) で、
MS-Windows 版の latex2html の変換者名 (ユーザ名) に日本語が入っていると
そこが文字化けする、という問題とその対処法が報告されました。
perl 5.8.X 用の対処ですが、L2hos/Win32.pm の
user(), fullname() 修正することで対処できるようです。
どうも、阿部＠北教大さんの MS-Windows 版は、
一旦入力を EUC-JP に変換してから latex2html の (perl の) 処理を行って、
LaTeX の処理や HTML 出力では Shift_JIS に変換する、
ということになっているようです。
詳しくは分かりませんが、Shift_JIS のまま perl にかけると、
例えば 2byte 目のバックスラッシュの問題とかがあって
perl とはあまり相性がよくないのかも知れません。
perl 5.8.X を使うなら、nkf を使わないようにして、
perl 5.8.X 自身の機能で日本語コードを処理するという手もあるのでしょうが、
それはそれで面倒そうなので、
今後もしばらくは nkf (MS-Windows では ack32)
の力を借り続けることになるでしょう。
- (04/03 2005)
(しおり用)
「注意、その他 (12/03 2004)」,
「注意、その他 (12/09 2004)」,
「注意、その他 (12/14 2004)」
辺りでちらっと報告していた日本語化パッチの新版ですが、
春休み中にリリースする予定だったのですが
(最初の計画では冬休み中)、
結局春休み中の公開はできませんでした。
進んでいないのは主に付属ドキュメントの更新なのですが、
現在、
- 最新版の latex2html-2002-2-1 に対応
- -lang (jis|euc|sjis|jutf) オプションを新設した版も用意
(今までの 2 系統から 3 系統になる予定 (^^;))
- dot.latex2html-init を訳し、補足や新しい機能等を追加
- 付属ドキュメントが長くなったので「注意」の部分を別ファイルに
- 日本語パッチの技術情報に関する新たなドキュメントを追加
等の作業を行って/予定しています。
気長にお待ち頂けるとありがたいですが、
パッチ自体はほぼできているので、
暫定的にパッチと最小のドキュメント
(今までのとは色々挙動が変わりますので最小限のものは必要だと思います)
のみを公開することも考えています。
(cf. 「注意、その他 (05/26 2005)」)
- (01/29 2005)
(しおり用)
最近、阿部＠北教大さんの、MS-Windows 用の latex2html に関する WWW ページ
「LaTeX2HTML for Win32」
が更新され、latex2html-2002-2-1 対応 (jp1.9) になったようです。
- (01/11 2005)
(しおり用)
Linux でインストールした latex2html で
数式部分の日本語が文字化けするが、
それはデフォルトのインストールでは日本語化されていない dvips が
使われる設定になってしまうからだ、という情報を頂きました
(Thanks 山本昌志さん)。
Linux では、日本語化された dvips が "pdvips" という名前に
なっている (ことがある ?) ようですが、その場合は、
- インストール前なら、
prefs.pm の $pref{'DVIPS'} のところの dvips を pdvips に
- インストール後なら、
lib/latex2html/l2hconf.pm の $DVIPS のところの dvips を pdvips に
に修正すれば OK です。
- (01/09 2005)
(しおり用)
(j)report スタイルで chapter の下に section を作った場合、
それを latex2html にかけると chapter は <h1> で表示されるが、
その下のレベルであるはずの section も <h1> で表示される、
という話が出ました。
これは latex2html 内に
%standard_section_headings =
('part' , 'H1' , 'chapter' , 'H1', 'section', 'H1',
'subsection', 'H2' , 'subsubsection', 'H3',
'paragraph', 'H4', 'subparagraph', 'H5'
,%standard_section_headings );
と定義されているからで、これを解消するには、
~/.latex2html-init に例えば次のようなものを書くか、
またはそれだけを書いた別なファイルを作って、
それを "-init_file" オプションで指定すればできるようです。
%standard_section_headings =
('part' , 'H1' , 'chapter' , 'H1', 'section', 'H2',
'subsection', 'H3', 'subsubsection', 'H4',
'paragraph', 'H5', 'subparagraph', 'H6' );
- (01/07 2005)
(しおり用)
「注意、その他 (12/14 2004; no.3)」
に書いた、Tgif で書いた EPS 画像などの「白での塗りつぶし」
の透明化に失敗する問題にも少し関係する話です。
例えばその場合の解消法の一つとして、latex2html のオプション
"-white -notransparent" を使って画像背景を白にしてしまう、
という手があります。
ところがそれにも問題があるようで、
別な意味で背景が灰色になってしまう問題とそのパッチが
latex2html-ML に流れました。
元々は Fedora Core package の bug の報告に現れた問題のようです。
うちの環境でもこの問題は再現しました。
現在開発/テスト中の次期日本語化パッチは
これも取り入れたものにする予定です。
(cf. 「注意、その他 (04/06 2007)」)
- (12/14 2004; no.3)
(しおり用)
「注意、その他 (06/08 2004)」
に書いた、Tgif で書いた EPS 画像などに「白での塗りつぶし」を
使った場合、その部分の透明化に失敗する問題ですが、
以下のようなことで起こっているようです (GIF 化の場合)。
- EPS を GIF に変換する場合、
images.tex で LaTeX ファイルと同じ様式で \includegraphics で
取り込んで dvi ==> PS ==> PPM ==> GIF という変換をする
- その際、画像の切り出しのために、images.tex で背景を灰色
(#B2B2B2 位の色) に設定する
- その背景は、EPS ファイルの背景にも及ぶが、
Tgif で白での塗りつぶしを行なった部分や図形内等の白い色には
それが及ばない
- PPM ==> GIF への変換で ppmtogif の -transparent オプションを使って
透明化を行なうが、
その透明色の指定は images.tex 内に書かれた灰色ではなく、
白 (#FFFFFF) になっている
- (少なくとも最近の) ppmtogif は、transparent として指定された色に
もっとも近い色を透明色として選ぶので、
画像内に白があるとそちらが透明化の対象になってしまう
ということのようです。PNG の場合は透明色として灰色が選ばれていますが、
やはり図形によっては同様のことが起こり得るのではないかと思います。
対処法としては、images.tex で背景を灰色にするのをやめる、
というのが良さそうですが、
何らかの意味があってそうしているのだとすると
どこかで不具合が起きかねません。
他の回避策としては、おかしくなる画像だけ手動で GIF 画像にしてやる、
というものがあります。
「注意、その他 (01/21 2004)」
でも紹介したように、
latex2html 上では includegraphics で GIF 画像を取り込むことができ、
その場合は単純にその画像が link されます。
よって、LaTeX ファイルの
\includegraphics[...]{hoge.eps}
を、
\usepackage{html}
....
\latexhtml{%
\includegraphics[...]{hoge.eps}}{%
\includegraphics{hoge.gif}}
のように書き換え、hoge.gif は
pstopnm -stdout -portrait hoge.eps | pnmcrop | pnmscale -xsize 450 \
| ppmquant 256 | ppmtogif -transparent='#FFFFFF' > hoge.gif
のように作っておけばいいわけです。なお、pnmscale の -xsize の値は、
latex2html が作った (失敗している) 画像サイズの大きさを
調べて、その xsize に合わせれば良いでしょう。
latex2html に -debug オプションをつけて、
pstoimg のオプション (-geometry) を調べることでも
ほぼ大体の数値はわかります。
そのようにして、
「注意、その他 (06/08 2004)」
で上げた失敗例を直してみたのが以下のサンプルです。
「注意、その他 (06/08 2004)」
のものと見比べてみて下さい。
(cf. 「注意、その他 (01/07 2005)」,
「注意、その他 (04/06 2007)」)
- (12/14 2004; no.2)
(しおり用)
このメモ内で別の日に書いたものを参照している部分があったのですが、
逆にたどれるようにもしてみました。
- (12/14 2004)
(しおり用)
次期日本語化パッチのテストを行なっていて、
latex2html 本体のアクセントに関するバグと問題点を見つけましたので
報告します。
- \t{oo} がうまく画像化されない (バグ)
アクセントの中で \t だけは 2 つの文字を引数としますが、
これは HTML の entity がなく、
よって latex2html は画像化しようとします (-accent_image がついている時)
が、そこにバグがあり、\t{o} として画像化してしまいます。
この問題は次期パッチで対処する予定です。
- \i,\j にアクセントをつける場合の画像化の問題 (回避策あり)
i,j の上にアクセントをつける場合、LaTeX では通常
\i,\j を使って上の点を取った物にアクセントをつけます。
latex2html でも、HTML entity がある場合は問題なく働くのですが、
HTML entity がない場合に問題が発生します。
具体的には、\H{\i},\H{\j} などで問題が起こるのですが、
このように書くと latex2html は \H{i} や \H{j} で、
つまり上の点を取らずに画像化してしまいます。
これもバグだとは思うのですが、
\H{\i} の代わりに \H\i
(後ろにアルファベットが続く場合は \H\i{}) と書くと回避されます。
とりあえずはそのように書いて下さい。
i の上にアクセントをつける場合は、\H{i} であろうと \H{\i} であろうと
常に上の点を取る、という仕様にするなら対処もできるのですが、
今の所簡単な修正を行なう方法は見つかっていませんので、
上の方法で回避して下さい。
(cf. 「注意、その他 (04/03 2005)」)
- (12/09 2004)
(しおり用)
多分あまり使われてはいないと思いますが、
現在の日本語化パッチに取り入れられている UNUSEACCENT の機能は、
不具合があることが分りましたので、
新しいパッチからは取り除くことにしました。
今後、もし UNUSEACCENT の改良ができてそれを公開するとしても、
それを日本語化パッチ本体には取り入れず、
それとは分離した形にする予定です。
もし何かご要望等があれば、ご連絡下さい。
(cf. 「注意、その他 (04/03 2005)」)
- (12/07 2004)
(しおり用)
「注意、その他 (11/04 2004)」 で報告した、
Linux で日本語化パッチが有効になっている latex2html が入っている件ですが、
松浦さんが作業をされて、jlatex2html という別名のコマンドになり、
開発板の RPM (tetex-latex-2.0.2-26; SRPM は tetex-2.0.2-26.src.rpm)
に取り込まれ、Fedora Core 4 では対応されることになったそうです
(Thanks 松浦さん)。
- (12/03 2004)
(しおり用)
日本語化パッチ jp1.X 系列の新しいものとして、
現在次のような 2 つを候補として試作してみたのですが、
どちらを採用するかを少し迷っています。
- latex2html 本体に -lang オプションを新設して、
-lang (jis|euc|sjis|jutf) 等で、
charset を iso-2022-jp/EUC-JP/Shift_JIS/UTF-8 等と選ぶことができるもの
- LaTeX ファイルの文書クラスを見て、それが jarticle 等であれば
自動的に日本語文書とみなして charset を日本語の物
(iso-2022-jp 等) にするもの
いずれの場合も、
- それぞれの charset 用の l2hconf.pm を用意して
それらを切り替えて使用するような wrapper script は不要になる
- .latex2html-init で charset を定義したりする必要がなくなる
- 元々の latex2html の仕様とは異なる、
"l2hconf.pm 内で japanese.perl を require"
する必要がなくなる
- 英語文書に対して、オリジナルの latex2html と同じ処理をさせるのが
簡単になる
という利点があるのですが、前者にするか後者にするかで少し違いがあります。
前者の場合 (-lang オプションを新規に設置) は、
- latex2html 本体のコマンドラインオプションで行なえるので、
最後のページにどのような charset 指定をしたのかの記録が残る
- japanese.perl を読み込むタイミングもほぼ従来と同じなので
日本語化に対する問題は多分あまり出ない
- -lang はさらに他の言語 (ロシア語、スペイン語等) のスイッチを
追加することも可能で、
多分そのようなオプションは、他言語のユーザに取ってもわかりやすい
(現在は Bable パッケージのオプション等で自動判別させるか、
.latex2html-init で指定するか、l2hconf.pm で指定するか、
という方法が取られている)
といった長所がありますが、しかし、
- 元々の latex2html にないオプションを追加するのは、
最終的なマージも考えるとあまりいい形ではないし、
問題がある可能性もある
とも思います。
後者の場合 (jarticle 等で自動判別) は、
- 自動判別になるので、オプションによる設定すらいらない
- 元々の latex2html の挙動/方針により近くなる
といった特徴がありますが、
- japanese.perl が読み込まれるタイミングが
今までの日本語化パッチよりも遅くなるので、
それにより今まで起きていなかった問題が発生する可能性がある
- charset を切り替えることができない、あるいは切り替えるのが難しい
という問題もあります。
個人的には後者の方が自然かなと思うのですが、
そちらは今までの日本語化のものと挙動が変わるため
色んな問題が出てくるだろうと思いますし、
charset に関する部分が前者に比べてかなり不利です。
ただ、いずれの方法を取るにせよ、
多少今までのような不自然な形式からは脱却できるので、
そのいずれか (あるいは両者をインストール時に切り替えられるようにするか)
の方向に jp1.X は切り替えて行きたいと思っています。
何か意見、要望等ありましたらご連絡下さい。
(cf. 「注意、その他 (04/03 2005)」)
- (11/05 2004)
(しおり用)
「注意、その他 (09/25 2004)」
で書いたように、jp1.X 系列は jp1.8 からは
wrapper script のオプション -jis/sjis/euc で出力コードを指定したり、
~/.latex2html-init に出力コードと nkf の設定を書くように
できるようになりましたが、
ついでに、UTF-8 の出力もできるようにしてみました (jp1.9)。
変更点については、「更新履歴」
を参照して下さい。
「注意、その他 (09/28 2004)」,
「注意、その他 (10/01 2004)」 で報告した
more_amsmath.perl の bug に対するパッチも取り込んであります
(jp2.X 系列のパッチにはまだ取り込んでいません)。
ただし、UTF-8 出力に関しては、注意が必要です。
- UTF-8 の出力が行なえる漢字フィルタが必要です。
デフォルトでは nkf (2.X) の -w を仮定しています。
それがなくて他のソフト (tcs や iconv 等) を使用する場合は、
~/.latex2html-init や mkwrapper
(wrapper script インストール後なら l2hconf_utf8.pm)
を適宜修正して下さい。
詳しくは
付属のドキュメント (の「3. 注意」の [35]) をごらん下さい。
- latex2html 自体がオプションとして
-html_version=4.0,unicode
-html_version=4.0,unicode,utf8
のようなものを持っています (versions/unicode.pl, versions/utf8.pl)。
しかし、現在のところ、このパッチによる UTF-8 化と
これらのオプションとの関連づけはなされていませんので、
UTF-8 対応としてはかなり不十分です。
実際にこれらのオプションと同時に使用すると
どのような問題が起こるかについては詳しくは確認していませんが、
少なくとも versions/utf8.pl と同時に使用した場合は問題が起こり、
正しくは変換されません。
- ~/.latex2html-init に $charset を指定する場合は、
(JIS/EUC/SJIS の場合もそうですが)
必ずドキュメントに書かれているように書いて下さい。
大文字小文字が違っても正しく動作しません。
特に UTF-8 化については、小文字で「$charset="utf-8";」
のように設定してしまうと versions/unicode.pl や versions/utf8.pl の
設定とぶつかって不具合がでる可能性があります。
- (11/04 2004)
(しおり用)
「注意、その他 (11/03 2004)」 で報告した、
Linux で日本語化パッチが有効になっている latex2html が入っている件ですが、
色々問題があるようなので多少修正しておきました。
修正したのは、
- tetex-latex-2.0.2-11 から 2.0.2-15 までの版のユーザは、
何もしなくても日本語化が利用できている
という点で、これは実際にはそうではなく、
やはりそれなりに設定しないとちゃんと使えないことが分かりました。
なお、
「TeX Q&A 掲示版」 (の 32338 番の記事)
で松浦さんが報告しておられるように、
今後は日本語化パッチが当たったものは、
jlatex2html という別名のコマンドになるように作業されているようです
(Thanks 松浦さん)。
(cf. 「注意、その他 (12/07 2004)」)
- (11/03 2004; 11/04 2004 修正)
(しおり用)
「注意、その他 (11/02 2004)」 で報告した、
Linux で日本語化パッチが有効になっている latex2html が入っている件に
補足しておきますと、
今回の問題は日本語圏のユーザには問題はありませんが、
だからといって、すぐに日本語化された latex2html が利用できるわけでは
ありません。
以上の作業で多分日本語化機能が有効になると思います
(11/04 2004 修正)。
(cf. 「注意、その他 (11/04 2004)」)
- (11/02 2004)
(しおり用)
「注意、その他 (11/02 2004)」 で報告した、
非日本語圏のユーザが日本語化パッチの当たった latex2html を
使っている件ですが、
迫田誠治さん (sakoda@cc.nda.ac.jp) からメールで、また
「TeX Q&A 掲示版」 で松浦さんに情報をいただきました。
それで調べてみたところ、
といったことがわかりました。
迫田さん、松浦さん、どうもありがとうございました。
日本語化パッチは、多少本体のバグを fix しているパッチも含んでいるのですが、
非日本語圏のユーザに取っては迷惑な部分もありますので、
本来は、
日本語化された xdvi や dvips が pxdvi や pdvips 等として入っているように、
日本語化パッチの当たった latex2html も jlatex2html のように
別名で入れてもらった方がいいように思います。
もちろん、本体の latex2html に日本語化作業をマージしてもらうのが
一番なんですが、まだ色々問題が解決してませんのでそれはまた先の話です。
(cf. 「注意、その他 (11/03 2004)」)
- (11/02 2004)
(しおり用)
「注意、その他 (10/13 2004)」 で報告した、
非日本語圏のユーザが日本語化パッチの当たった latex2html を
使っている件ですが、
どうやら Fedora Core 2 Linux のようです。
latex2html-ML に以下のようなメールが流れました。
もし、Fedora Core 2 の latex2html のデフォルトが日本語版なのだとしたら
ユーザに取っても、また私に取ってもかなり迷惑な状況です。
何とかしたいと思うのですがどうしたらよろしいでしょうか。
Fedora Core に詳しい方は教えていただけるとありがたいです。
(cf. 「注意、その他 (11/02 2004)」)
- (10/26 2004)
(しおり用)
「注意、その他 (01/08 2004)」 で報告した、
最新版の latex2html-2002-2-1.tar.gz ですが、
久しぶりにまた新しいものがでました (ファイル名はそのまま)。
- size 1124233 Byte (2004 10/25 release)
今回の変更は、以下の通りです。
- styles/russian.perl (for Babel package) の追加
- styles/graphics-support.perl のバグの修正
(@GRAPHICS_SCALEEOPTS ==> @GRAPHICS_SCALEOPTS)
いずれも latex2html-ML で流れた問題の報告によるものです。
詳しくは latex2html-ML の記事:
をごらん下さい。
- (10/24 2004)
(しおり用)
LaTeX2HTML の日本語マニュアルを公開されておられる
Yasufumi Haga さんのページの URL が変わったようですので、
リンク等を張り直しました。
以下をご覧下さい。
- (10/13 2004)
(しおり用)
最近少し妙なことに気がつきました。
明らかに日本語 LaTeX ユーザ以外の方で、
日本語パッチが当たった状態の latex2html を使っている例が
見受けられます。
これは間違った使われ方で、
「この文書について」、日付などが日本語化されてしまいます。
例えば以下の物などがそれです。
中には 8bit の文字を使っている物もあり、
そのため (少なくともうちでは) 文字化けして表示される物もあります。
多分彼らも「この文書について」や日付などは読めていないでしょう。
これらは、
- ドメインはバラバラなので、
誰か単一の人がインストールしたものを使っているわけではないよう
- 数からして、そして日付が似通っていることからして、
たまたま私の所から間違えてダウンロードしたものを使用している、
とは考えにくい
- 使用している latex2html、および日本語化パッチのバージョンが
すべて同じ (2002-2-1 (1.70) JA patch-2.0)
- latex2html 実行ユーザ名が表示されている、ということは
多分 Unix 上で実行
のような感じですが、そこから想像するに、
なんらかの Linux ディストリビューション (日本用でないもの) に、
latex2html を簡単にインストールできるパッケージが
日本語化パッチが当たってかつ有効な状態で出てしまっている、
あるいはそのディストリビューションに最初から入ってしまっている
といったことが起きてしまっているのではないかと思われます。
もちろん、たまたま多くの人が目にする情報として
取り上げられてしまった、という可能性もあるとは思いますが、
それよりは上にあげたような可能性の方が高いのでは、と思っています。
これは非日本語圏のユーザに取っても、latex2html 自身に取っても
不幸なことだと思います。
もし、事情をご存知の方がおられたら連絡して下さい。
対処が取れるようなら取りたいと思っています。
なお、このバージョンの日本語パッチは、
現在 FreeBSD の ports package に採用されていますので、
FreeBSD ユーザである可能性はあります。
しかし、FreeBSD では日本語化パッチの方は
"japanese/" に分類されていて、
オリジナルの latex2html-2002-2-1 もちゃんと "textproc/"
に登録されていますので、
なんとなく FreeBSD の package ではないような気がしています
(確認はしていません)。
(cf. 「注意、その他 (11/02 2004)」)
- (10/01 2004; no.2)
(しおり用)
「注意、その他 (09/28 2004)」
に書いたスタイルシートのファイル名の問題ですが、
-style [ディレクトリ]/[ファイル].css
でちゃんと
<LINK REL="STYLESHEET" HREF="[ディレクトリ]/[ファイル].css">
なるものがヘッダに付くようになるようです。
うまく働いていない、というのは勘違いでした。どうもすみません。
もちろん、この指定には http: で始まる URL を書くこともできます。
- (10/01 2004)
(しおり用)
「注意、その他 (09/28 2004)」
で紹介した styles/more_amsmath.perl に対するパッチですが、
少し改良しました。
ただ、多分前のものでも問題はないと思います。
これから当てる場合はこちらの方が良いかも知れません。
次期バージョンの日本語化パッチにはこのパッチも入れたいと思いますが、
単に 1 行の修正だけですので手で修正してもらっても結構です。
(cf. 「注意、その他 (11/05 2004)」)
- (09/28 2004; 09/30 2004 修正)
(しおり用)
またインターネット上で LaTeX2HTML に関する問題を見つけました
(cf.
http://akita-nct.jp/~yamamoto/comp/latex/latex2html/latex2html.html)。
- スタイルシートのファイル名が固定されてしまうので、
それを一つ一つ変更するのが面倒
- 数式環境内に % で始まるコメント行を書くと、
画像に "<tex2htmlcommentmark>" なるものが入ってしまう
前者は、-style オプションで対処できるような気もしますが、
うまく働いてないようなので少し調べてみます。
後者ですが、どうも amsmath パッケージを取り込んだ場合の
equation 環境で起こるようです。
少し調べてみたのですが、なんとなくバグのような気がします。
多分以下のパッチ (styles/more_amsmath.perl) で対処できると思いますので
何でしたらご利用下さい。
次期バージョンの日本語化パッチにはこのパッチも入れたいと思いますが、
手で修正してもらっても結構です。
一応本家にも報告しておきたいと思います。
(cf. 「注意、その他 (11/05 2004)」,
「注意、その他 (10/01 2004)」,
「注意、その他 (10/01 2004)」)
- (09/25 2004)
(しおり用)
「注意、その他 (09/23 2004)」
に書いた日本語コードの問題ですが、
jp1.X では nkf によるコード変換を行なっているので、
日本語化パッチを更新して (jp1.8)、
- LaTeX ファイルが JIS である場合も使えるように
- HTML 出力のコードを、ユーザレベルで ~/.latex2html-init ファイル
(や l2hconfig.pm) でも設定できるように
としてみました。
ついでに wrapper script のオプション (-jis/sjis/euc) で
その出力コードを指定できるようにもしてみました。
ただし、問題もあります。
- charset の指定は "iso-2022-jp", "EUC-JP",
"Shift_JIS" のいずれかで、
これは大文字と小文字が違っていてもうまく動作しない (多分)
- ~/.latex2html-init による出力コードの指定 ($charset) と
wrapper script によるオプション (-jis/-sjis/-euc) は、
今の所 (jp1.8) ~/.latex2html-init の設定の方が優先してしまう
- 出力コード指定を行なうと HTML ファイルの META タグに
charset が書かれるが、これをつけたくない場合は
~/.latex2html-init に '$charset = "";' のように書くしかない
- JIS 入力ファイルを受け付けるために
texexpand で nkf を通してファイルを開くようにしたので、
8bit の「英語」の LaTeX ファイルに関しては
思わぬ不具合が起こる可能性がある
(wrapper script をインストールすれば "l2h -en" で
nkf を使わないようにできる)
-jis/euc/sjis などのオプションを latex2html のオプションに昇格させれば
いいのでしょうがそれも何なので、少し考えてみたいと思います。
(cf. 「注意、その他 (11/05 2004)」)
- (09/23 2004)
(しおり用)
「注意、その他 (09/21 2004)」
に書いた「数式内の日本語が文字化けする」という件ですが、
原因としては
- ghostscript が日本語対応になってない
- latex2html の仮定している日本語コードと
pLaTeX の日本語コードが合ってない
- latex2html の仮定している日本語コードと
LaTeX ファイルの日本語コードが合ってない
辺りが考えられます。
2 つ目のものですが、通常 Unix では EUC-JP 環境が多いと思いますが、
pLaTeX が Shift_JIS 環境である場合に
latex2html (jp2.0) を EUC-JP のままインストールしたり、
pLaTeX が EUC-JP 環境である場合に
latex2html (jp2.0) を Shift_JIS にしてインストールしたりすると
起きるような気がしますが、確認は取っていません。
また、3 つ目のものですが、これは少しテストしてみましたが、
問題が起こるときは数式内の日本語だけでなく本文から化けるようで、
「数式内の日本語の文字化け」という問題に関しては
最初の 2 つの方が可能性としては高いように思います。
なお、そのテストで気がつきましたが (うちは EUC-JP の pLaTeX 環境)、
- JIS の LaTeX ファイルは、通常の platex によるコンパイルや
dvips では問題は発生しないが、latex2html では jp1.7 でも jp2.0 でも
本文から文字化けする
- Shift_JIS の LaTeX ファイルは、通常の platex によるコンパイルや
dvips では文字化けしてしまうが (EUC-JP の pLaTeX 環境の場合)、
latex2html jp1.7 では nkf を通して処理するので、
一応問題ない JIS コードの HTML が作られるよう
(jp2.0 では本文も数式内も化ける)
のようになるようです。
JIS の LaTeX ファイルを使用している場合は、
latex2html ではうまく処理されないようですので
EUC-JP (Shift_JIS 環境では Shift_JIS) に直してから
latex2html にかけて下さい。
(cf. 「注意、その他 (09/25 2004)」)
- (09/21 2004)
(しおり用)
少しインターネットで LaTeX2HTML について検索してみたのですが、
最近は新しい版 (2000 以降) の LaTeX2HTML の利用が
広まってきているようで、少し安心しました。
有益な情報を持つ WWW ページもありましたので、
またリンクを追加しておきたいと思います。
ただ、まだ不具合が起こる、こういうことがしたいんだけどうまくいかない、
といった話題も見られます。
それらもできれば QandA などに取り上げていきたいと思います。
今回気がついたのは、
- MS-Windows にインストールするにはどうしたらいいか
- 数式の左下に黒い線が出る
- 画像の背景がグレーになってしまう
- .latex2html-init で指定した charset (CHARSET) などが効かない
- 数式内の日本語が文字化けする
- LaTeX2HTML を使いたいわけじゃなくて、
数式を単に画像にしたいだけなんだけど
- Vine Linux 版の LaTeX2HTML (2002-1 (1.68) JA patch-1.5) では、
「この文書について」に貼られているリンクがちょっとおかしい
(2002-2-1 (1.70) JA patch-1.6 では修正されています)
などでした。最初の 3 つは既に QandA
に載せてありますし、
.latex2html-init に書いた charset などが効かないのは既知の問題
(というより仕様) で、
charset (と文書の漢字コード) を適切に設定したいなら
日本語化パッチの付属ドキュメントを参照すれば良い話だと思います。
数式内の日本語が文字化けする、というのは
どういう状況かを確認できませんので正確なコメントはできませんが、
多分そう難しい話ではないと思います。
そういう現象が発生する、という方はこちらにご連絡下さい。
「数式を単に画像にしたい」というのは、
CGI で利用して掲示版に数式を書けるようにするとか、
手軽に WWW ページに数式を書くとか、
そういった話のようです。
確かに LaTeX2HTML を経由すればそれで数式を画像化できますが、
数式を画像化するだけなら、
LaTeX2HTML の手法を真似てなんらかのスクリプトを書けば良いでしょう。
少し以下で説明します。
なお、LaTeX2HTML は内部で pstoimg というスクリプトを使用していますが、
これを利用する、というのはあまりお薦めではありません
(オプションが多いし、出来上がる画像は LaTeX2HTML 用に少し手が入っている)。
LaTeX2HTML は images.tex という LaTeX ファイルに
一ページ一つの数式を書き出し、
それを dvips, netpbm を経由して画像化していますが、
基本的に以下のような手順を取ればいいわけです。
- \pagestyle{empty} を使ってページ番号を出力させない
- 数式一つ毎に \newpage を入れて一ページに数式一つのファイルにする
- できた DVI ファイルを dvips -E -i にかけて各ページ毎の EPS ファイルを
作る (file.001, file.002, ...)
- 各 EPS ファイルの BoundingBox の値を取得して、画像の横幅を計算する
- 後は netpbm のツールを使って
pstopnm -xsize=[横幅× 2 位] -stdout file.001 | pnmcrop | pnmmargin 5
| ppmtogif > file1.gif
とすれば数式の GIF 画像ができる
スクリプト化もそう難しくはありません。
ppmtogif を pnmtopng や pnmtojpeg にすれば PNG/JPEG 画像にできます。
img-tgif-pat.ps (EPS ファイル)
img-tgif-pat.gif (GIF ファイル)
img-tgif-color.gif (GIF ファイル)