備忘録

20 備忘録

（注）ここはFYIではなく，FMIなので， heveaなどを使ってみようという人以外には無用の長物である．他もそうでしょと言われそうだが...

20.1 H^EV^EAに行き着くまでと使用にあたってのドタバタ

　Blog的記録を残すに当たって，最初からhtmlで書くのも手だが， Webデサイン的に凝る必要もないので，手慣れたT_EXがいいだろうとなった．次に，どのようにhtml化するか？ T_EXのソースをhtml化するのと, pdfの清書をhtml化する, の選択肢がある．この辺りいろいろなソフトがあるらしく，選択にも迷った．どれも 100点満点はない．pdfにした場合，T_EXの内部での相互参照はPDFにも反映され，さらにhtmlでも受け継がれる (どちらもクリック1つで目的地に飛ぶ)．画像の配置なども問題なく受け継がれるようだ．候補としてはpdftohtmlというソフトが一番良さげであった．

問題はクリックした時に別窓を開いて画像を表示したり，別のweb siteを表示したりするのをどうするか．これを T_EXのレベルから受け継がせることは至難の技のようで，PDFにしてから，手作業で，対応する部分を埋め込む必要がある．そうした効果を入れることは 2，3のPDFソフトで可能なようであるが，それを自動化することはできない．PDF一回作って一箇所埋め込めば終わり，ならいいが，何回もupdateなど繰り返してやるのは気が狂う．　今回は数式はほぼ無縁であるが，PDFレベルで　綺麗な数式が出ていてもpdftohtmlではよれよれになる．そこで，この線は却下．

T_EXソースから変換するのはtex2htmlとかいうのもあったが，H^EV^EAというのが圧倒的によさそうだ． H^EV^EAはソースから変換するから，T_EXのプログラムを作るのと同じような大変な作業をやっていることになる．耳慣れない Objective Camlというので書かかれている． Installは簡単で，camlをインストールしてから，ソースを使って一発でいけた．

その後，見本のソースの変換をしてみると，フランス語のアクセント記号のところでT_EXが転けてしまう(作者はフランス人Maranget氏)．いろいろな見本には，画像ファイルを使うものがない．やっと見つけてやってみると，heveaは終了するのだが，画像を扱うためにimagenというスクリプトを走らせる必要がある．これは画像データをpngに変換するなどの作業をするらしいが， dvipsも使うようで，そこでダンマリになってしまう．これはdvips システムの違いか，なにか，根本がおかしいようだ．
htmlファイルはほぼできているようだ．そこで，imagenは使用しないで，こちらで適当なスクリプトを作って誤魔化すことにした．したがって，複雑な数式をT_EXのレベルの綺麗さで出すことはできず，heveaの第1段階の出力のまま，という感じになる．今回は数式はほぼないので問題はないだろう．練習ではこれでOKと思って本格船出をしたのであるが，その後，いろいろと問題が判明した．原因の一部は簡体字を使うことにもありそうだ．T_EXの方では大文字太字などの日本語部分がうまく出ない．みな標準の大きさになってしまう． htmlでは問題ないのだが．

hyperrefパッケージを使って，pdfレベルで相互参照を可能にすると，htmlでは “第3節参照”といったところが‘第??節参照”となってしまう．ただし，リンクは生きているのでクリックすればちゃんと飛ぶ．これはhyperrefが原因だとは思わなかったので，突き止めるまで時間がかかった．T_EXの出力はまあどうでもいいので， hyperrefのデフォルトは何もしないようにリンクを貼った．

次に判明したのは，目次が3つしか出ない，ことだった．これも追求していくうちに何も出なくるなど不思議なことになった．最後にhtml用にhachaというスクリプトをカマして，節ごとにページを分割してみたら，なんと，現在のページの様にまともなhtmlができた．
H^EV^EAの処理スピードの速さにはびっくりする．　 hachaをカマしたときはreturnを押した瞬間に終了したので，これ絶対おかしいと思ったがまともな結果でできていたので，びっくりした．

20.2 通常の使い方メモ

mytex BJBlog1　（or mytex BJBlog1.tex)
../../myhevea.sh BJBlog1.tex (2回やるのが安全?)
open ../HTML/BJBlog1.html

上記の解説

mytex: ソースの作成，修正，コンパイル，プレヴューを同時進行でやる．
```
\usepackage[utf8]{inputenc}
\usepackage{hevea}
\input{fancysection.hva}
\usepackage{CJKutf8}
```
あたりが今回のキモスタイルファイル．
myhevea.sh: heveaでhtmlをつくるのがキモだが，まず
- fancysection.hvaが真のfancysection.hvaになるようにリンクを張る．これは，heveaの出力の HTMLでセクション名に緑の背景つけるため．通常のT_EXではこれがあるとエラーになる．
- hevea BJBlog1.tex を実行．　これで，BJBlog1.htmlができる．
- imagenの代わりに，modify-html.shを走らせる． BJBlog1.htmlが修正される． Fig.関係の手当てをやっている: heveaは図の番号をxxxx001.pngのように機械的な連番を振って扱う．この名前では人間様は図がどのようなものかを想像できない．そこで図には通常と同じ様に，MianBld.pngのような名前をつけておく．それを使う順番に FigListにの載せておく．heveaが使えるようにするため，これを使ってList中のn 番目の図には ln -s ../Fig/MainBld.png xxx00n.png の様にリンクを貼る．新しい図を途中に挿入したなどのときには，その図の名前をFigList中の正しい順番位置に登録する手間はあるが，たいした作業ではない． FigListには図のWeb page上でのサイズ，また，右寄せか，左寄せか，任せるかも指定する．
- webページの背景をセットするため bodyタグに background="../BG/bg4.jpg"を加える．
- fancysection.hvaがT_EXに無害のダミーのfancysection.hvaになるようにリンクを張りなおす．
- 出来上がったhtmlファイルにhachaをカマす．　セクションごとん分割．目次も無事できる．（注) 最終htmlをxxx.htmlにしたいならmv xxx.html zzz.html と一度名前を変更して，
  hacha -o xxx.html zzz.html
  のようにしないとダメ．hach -o aaa.html xxx.htmlとして aaa.htmlを最終的に使うと，リンク先がないと怒られる．
open: web pageの表示．　
調子悪い時は *.aux, *.log, *.outを消す．

上記は，以下のような階層構造のファイルを想定している． Blog1の代わりに，Blog2を作れば，同じ様に処理はできる．

ファイルの階層関係は

    Blog---Blog1---TeX---BJBlog1.tex
                          hevea.sty (link to the one in Blog) 
                          fancysection.hva ( // )
                          fancysection.hvaTrue (//)
                          fancysection.hvaDummy (//) 
                          ForHyperRef.tex (link to the of one next two)
                          ForHyperRef.texForHevea (contains only  %)             
                          ForHyperRef.texForTeX (real lines)
                   HTML---BJBlog1.html to be made by hevea
                           some hand made html files 
                   Fig---..
                   Movie---...
                   Sound---...
                   Slidshow---...
                   KML---...
                   BG---...
                   FigList
           myhevea.sh
           modify-html.sh
           その他，準備部品など

20.3 日程

　これまでの，日程と今後の予定(7月9日現在)．

日時克昌和子

4月17日出発出発

4月30日帰国

5月18日帰国

6月2日出発出発

6月15日帰国

7月1日出発

7月29日　帰国　　帰国　

9月15日出発出発

10月14日帰国

10月31日出発

11月13日　帰国　　帰国　

2018/3月あたり

日時	克昌	和子
4月17日	出発	出発
4月30日		帰国
5月18日	帰国
6月2日	出発	出発
6月15日		帰国
7月1日		出発
7月29日	帰国	帰国
9月15日	出発	出発
10月14日		帰国
10月31日		出発
11月13日	帰国	帰国
2018/3月あたり

20 備忘録

20.1 HEVEAに行き着くまでと使用にあたってのドタバタ

20.2 通常の使い方メモ

20.3 日程

20.1 H^EV^EAに行き着くまでと使用にあたってのドタバタ