yatex

annotate docs/htmlqa @ 77:1b172d26b55e

find changesets by author, revision, files, or words in the commit message
Fix auto-fill movement on Emacs21. Fix YaTeX:ref. Support jump/change on AMS-LaTeX's parentheses.
author yuuji
date Thu, 01 May 2003 13:38:27 +0000
parents 7e361fb5401d
children 9b4354af748c
rev   line source
yuuji@72 1 %%
yuuji@72 2 %% Q and A on yahtml
yuuji@72 3 %%
yuuji@72 4 %% C-u C-x $ とすると質問項目だけ表示されます。C-x $ で元に戻ります。
yuuji@72 5 %%
yuuji@72 6 (新項目: ・font-lockって使えますか?)
yuuji@72 7
yuuji@72 8
yuuji@72 9 ■インストール関連
yuuji@72 10 ・LaTeX使わないんだけど野鳥も入れなきゃダメですか?
yuuji@72 11
yuuji@72 12 や、別にええっす。
yuuji@72 13 http://www.yatex.org/ のソースアーカイブリンク
yuuji@72 14 のなかに、"yahtml" で始まるファイルがあるので次からはそれを持っ
yuuji@72 15 て来ればよござんす。
yuuji@72 16
yuuji@72 17 ■カスタマイズ関連
yuuji@72 18 ・font-lockって使えますか?
yuuji@72 19
yuuji@72 20 はい。yahtml-1.69から使えます。あらかじめ font-lock をロードしてお
yuuji@72 21 きましょう。以前、yahtml が font-lock に対応する前に
yuuji@72 22
yuuji@72 23 (put 'yahtml-mode 'font-lock-defaults 'another-html-mode)
yuuji@72 24
yuuji@72 25 などを ~/.emacs に書いた人は、その設定を削除して下さい。
yuuji@72 26
yuuji@72 27 ・いつもは EUC にしてたまに JIS コードのファイルを作りたいんだけど。
yuuji@72 28
yuuji@72 29 ~/.emacs で
yuuji@72 30 (setq yahtml-kanji-code 3) ;3はEUC
yuuji@72 31 しておけば普段のhtmlコードはEUCになります。で局所的に変える方法。
yuuji@72 32 サーバーはApacheですね? ならそのディレクトリに .htaccess という
yuuji@72 33 ファイルを用意して、
yuuji@72 34
yuuji@72 35 AddType "text/html; charset=iso-2020-jp" .html
yuuji@72 36
yuuji@72 37 という行を書きましょう。するとApache君はそのディレクトリのhtmlファ
yuuji@72 38 イルを「iso-2022-jp(いわゆるJIS)だよー」とお客さんにあらかじめ伝
yuuji@72 39 えるようになります。yahtmlもこれに従い、そのディレクトリ以下のファ
yuuji@72 40 イルは漢字コードをJISに設定します。
yuuji@72 41
yuuji@72 42 なに、apacheではないとな。なら明示的にhtmlソースのお尻に、
yuuji@72 43
yuuji@72 44 <!-- Local Variables: -->
yuuji@72 45 <!-- file-coding-system: *junet* -->
yuuji@72 46 <!-- End: -->
yuuji@72 47
yuuji@72 48 と書いておけばそのファイルだけJISになります。
yuuji@72 49 ただし、Emacs-20 や XEmacs の場合、漢字コードのシンボルの両端の*
yuuji@72 50 は付きません。
yuuji@72 51
yuuji@72 52 ・<META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=x-sjis">を
yuuji@72 53 認識して漢字コードを設定して欲しいなー。
yuuji@72 54
yuuji@72 55 文書の中にファイルのエンコード法を書いてもそもそもそのMETAなんちゃ
yuuji@72 56 らを読めない可能性があるので charset をMETAで指定するのは本当に
yuuji@72 57 期待した通りには機能しません。たとえば、多国語文書を書く必要が出
yuuji@72 58 たとします。すると今のところUTF-7でエンコードするのが一番無難で
yuuji@72 59 しょう。NetscapeでもIEでもUTF-7はちゃんと読むことができます。と
yuuji@72 60 ういことで、ファイルを開いてブラウザがちゃんとUTF-7と認識するよ
yuuji@72 61 うに、HTML文書の先頭に次のように書きました。
yuuji@72 62
yuuji@72 63 <META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=utf-7">
yuuji@72 64
yuuji@72 65 このように書いたものが
yuuji@72 66 http://www.yatex.org/charset/hello-meta.file にあります。
yuuji@72 67 NetscapeとIEならUTF-7は読めるはずなので、どちらかでアクセスして
yuuji@72 68 みましょう。読めますか? 読めませんね。IEの場合はUTF-7の部分を自
yuuji@72 69 動判別するので、一見読めてるように見えますがtext/html とは解釈さ
yuuji@72 70 れておらず、結局METAが判別できなかったことが分かります。つまり、
yuuji@72 71 違うエンコード法を利用する場合、<META...> の部分さえもサーバに解
yuuji@72 72 釈不能な状態になり得るので、文書の中にcharset指定を埋め込むのは
yuuji@72 73 賢い方法ではありません。
yuuji@72 74
yuuji@72 75 かわりに、上記で説明した .htaccess を利用しましょう。*.utf7 とい
yuuji@72 76 う拡張子を持つファイルは、UTF-7 でエンコードしたHTML文書である、
yuuji@72 77 という定義は、以下のように書けます。
yuuji@72 78
yuuji@72 79 AddType "text/html; charset=utf-7" .utf7
yuuji@72 80
yuuji@72 81 .htaccess ファイルにこのように定義しておけば、無駄な<META〜
yuuji@72 82 charset〜>など綴らなくてもしっかりとサーバがエンコーディングを理
yuuji@72 83 解できます。このようにして書かれた UTF-7 のHTML文書が
yuuji@72 84 http://www.yatex.org/charset/hello.utf7
yuuji@72 85 にありますので、同じくNetscapeかIEで読んでみましょう。
yuuji@72 86
yuuji@72 87 AddTypeは~/public_html などに置けばそれ以下の *.utf7 という拡張
yuuji@72 88 子全てに適用できます。一個だけAddTypeを書くだけでいいのです。
yuuji@72 89
yuuji@72 90 HTML屋では、気休め程度にしかならないMETAによるcharset指定を推奨
yuuji@72 91 しない事を選びました。かわりに、もっと確実で簡単な .htaccess に
yuuji@72 92 よるエンコーディング指定を推奨するために、そちらをサポートします。
yuuji@72 93
yuuji@72 94 関係ありませんが今(2000年現在)では x-sjisじゃなくて、Shift_JIS
yuuji@72 95 と綴ることになってます:-p
yuuji@72 96
yuuji@72 97 ・<li>の直後に空白入るとhtmllintに怒られるから空白なしにしたいんだけど…
yuuji@72 98
yuuji@72 99 それ、htmllintがやりすぎなんです。タグ直後の空白に対して文句いう
yuuji@72 100 のは
yuuji@72 101 http://www.cre.canon.co.uk/%7Eneilb/weblint/www5-paper.html
yuuji@72 102 によると、空白があることで変なレイアウトになってしまうへぼブラウ
yuuji@72 103 ザへの配慮によるものなのでHTML的にはまるで問題ないんです。とかく
yuuji@72 104 htmllintを使うとhtmllintに怒られないこと自体が目的となりがちです
yuuji@72 105 が、わたしはそれは本末転倒であると思います。
yuuji@72 106
yuuji@77 107 ・<a href="...">の途中で auto-fill されちゃうと悲しい
yuuji@77 108
yuuji@77 109 使っているのがMule2(Emacs-19)以降なら auto-fill-inhibit-regexp
yuuji@77 110 という変数でコントロールできます。 yahtml-mode-hook を使って以下
yuuji@77 111 のように設定しましょう。
yuuji@77 112
yuuji@77 113 (add-hook 'yahtml-mode-hook
yuuji@77 114 '(lambda ()
yuuji@77 115 (setq auto-fill-inhibit-regexp
yuuji@77 116 "^[ ]*\\(<a href\\|<img src=\\)")))
yuuji@77 117
yuuji@72 118 ■どうにかならんかなあ関連
yuuji@72 119 ・長い文書の下の方だとインデントがめちゃ遅いんだけど。
yuuji@72 120
yuuji@72 121 今は直ってるはずです…。
yuuji@72 122
yuuji@72 123 ・いつも雛型として使っている template.html を簡単に入れたい
yuuji@72 124
yuuji@72 125 autoinsert.el (Emacs19/Mule2付属)を使いましょう。もしくは、それ
yuuji@72 126 の機能強化版 auto-insert-tkld を使いましょう。後者は、
yuuji@72 127 ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/auto-inset-tkld.tar.Z
yuuji@72 128 で入手できます。
yuuji@72 129 http://www-nagao.kuee.kyoto-u.ac.jp/member/tsuchiya/elisp/yahtml-mode.html
yuuji@72 130 に設定例が書いてあります。
yuuji@72 131
yuuji@72 132 ■その他
yuuji@72 133 ・yahtmlってなんてよむの?
yuuji@72 134
yuuji@72 135 がーん、良く聞かれます。
yuuji@72 136 作者も良く分かってません。えへん。
yuuji@72 137 というかかちょいい読み方が思い浮かばないもので。
yuuji@72 138 なんかいい読み方ないすか?
yuuji@72 139 突然思い付きました。正しい呼称は
yuuji@72 140
yuuji@72 141 『HTML屋』
yuuji@72 142
yuuji@72 143 とします。
yuuji@72 144
yuuji@72 145 ・メイリングリストはないんですか?
yuuji@72 146
yuuji@72 147 っていう質問項目があるくらいだからあります。「yahtml」およびそのVz
yuuji@72 148 への移植版「laihtml」(by KATSURAGAWA, Naoki)、Wzへの移植版
yuuji@72 149 「hackhtml」(by TAKENAKA, Hiroshi) に関する情報交換の
yuuji@72 150 ためのメイリングリスト「fj野鳥の会」がそれです。
yuuji@72 151
yuuji@72 152 To: yatex@yatex.org
yuuji@75 153 Subject: subscribe
yuuji@72 154 -----
yuuji@72 155 たぐでーし。明けましておめでとうございまーす。
yuuji@72 156
yuuji@72 157 のようにメイルを送れば加入できます。この時本文に書いた内容がプロ
yuuji@72 158 フィールとして登録されます(変更可)。手続きは全て自動で行われ、登
yuuji@72 159 録が完了すると確認とともに、参加/休止/脱会等の制御コマンドの利用
yuuji@72 160 方法が返送されます。是非参加して一緒に野鳥/雷鳥/白鳥を育ててくだ
yuuji@72 161 さい。
yuuji@72 162
yuuji@72 163 ・yahtmlの最新情報は?
yuuji@72 164
yuuji@72 165 もしあなたが、WWWにアクセスできるなら、
yuuji@72 166 http://www.yatex.org/
yuuji@72 167 を覗いてみて下さい。このなかの、「yatex-current」というリンクを
yuuji@72 168 たどると最新版の野鳥を入手することができます。ただし、正式リリー
yuuji@72 169 ス版ではなく、作者がデバッグ中だったりして正常に動作しない可能性
yuuji@72 170 があるので、current版に関する問い合わせは受けかねますのでご注意
yuuji@72 171 下さい。
yuuji@72 172
yuuji@72 173 ・とにかくわかりませーん!
yuuji@72 174
yuuji@72 175 回答を得るまでの早い順に
yuuji@72 176
yuuji@72 177 ・近くにいる詳しい人に聞く
yuuji@72 178 ・メイリングリストに質問を出す
yuuji@72 179 ・yuuji@yatex.org に質問を出す
yuuji@72 180
yuuji@72 181 でしょうか。お好きな方法でどうぞ。
yuuji@72 182
yuuji@72 183
yuuji@72 184 Local Variables:
yuuji@72 185 mode: indented-text
yuuji@72 186 fill-column: 72
yuuji@72 187 fill-prefix: " "
yuuji@72 188 buffer-file-coding-system: shift_jis-dos
yuuji@72 189 End: