yatex

annotate docs/htmlqa @ 566:2ef9f21dd13b

Add note on YaTeX::usepackage-alist-default
author HIROSE Yuuji <yuuji@gentei.org>
date Thu, 24 Jan 2019 15:19:32 +0900
parents d6952c7e35cc
children
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@475 55 HTML5 で書くのであればこの構文を使うのはやめ、文字集合はUTF-8に
yuuji@475 56 絞り <meta charset="utf--8"> と記しましょう。
yuuji@475 57
yuuji@72 58 文書の中にファイルのエンコード法を書いてもそもそもそのMETAなんちゃ
yuuji@72 59 らを読めない可能性があるので charset をMETAで指定するのは本当に
yuuji@72 60 期待した通りには機能しません。たとえば、多国語文書を書く必要が出
yuuji@72 61 たとします。すると今のところUTF-7でエンコードするのが一番無難で
yuuji@72 62 しょう。NetscapeでもIEでもUTF-7はちゃんと読むことができます。と
yuuji@72 63 ういことで、ファイルを開いてブラウザがちゃんとUTF-7と認識するよ
yuuji@72 64 うに、HTML文書の先頭に次のように書きました。
yuuji@72 65
yuuji@72 66 <META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=utf-7">
yuuji@72 67
yuuji@72 68 このように書いたものが
yuuji@72 69 http://www.yatex.org/charset/hello-meta.file にあります。
yuuji@72 70 NetscapeとIEならUTF-7は読めるはずなので、どちらかでアクセスして
yuuji@72 71 みましょう。読めますか? 読めませんね。IEの場合はUTF-7の部分を自
yuuji@72 72 動判別するので、一見読めてるように見えますがtext/html とは解釈さ
yuuji@72 73 れておらず、結局METAが判別できなかったことが分かります。つまり、
yuuji@72 74 違うエンコード法を利用する場合、<META...> の部分さえもサーバに解
yuuji@72 75 釈不能な状態になり得るので、文書の中にcharset指定を埋め込むのは
yuuji@72 76 賢い方法ではありません。
yuuji@72 77
yuuji@72 78 かわりに、上記で説明した .htaccess を利用しましょう。*.utf7 とい
yuuji@72 79 う拡張子を持つファイルは、UTF-7 でエンコードしたHTML文書である、
yuuji@72 80 という定義は、以下のように書けます。
yuuji@72 81
yuuji@72 82 AddType "text/html; charset=utf-7" .utf7
yuuji@72 83
yuuji@72 84 .htaccess ファイルにこのように定義しておけば、無駄な<META〜
yuuji@72 85 charset〜>など綴らなくてもしっかりとサーバがエンコーディングを理
yuuji@72 86 解できます。このようにして書かれた UTF-7 のHTML文書が
yuuji@72 87 http://www.yatex.org/charset/hello.utf7
yuuji@72 88 にありますので、同じくNetscapeかIEで読んでみましょう。
yuuji@72 89
yuuji@72 90 AddTypeは~/public_html などに置けばそれ以下の *.utf7 という拡張
yuuji@72 91 子全てに適用できます。一個だけAddTypeを書くだけでいいのです。
yuuji@72 92
yuuji@72 93 HTML屋では、気休め程度にしかならないMETAによるcharset指定を推奨
yuuji@72 94 しない事を選びました。かわりに、もっと確実で簡単な .htaccess に
yuuji@72 95 よるエンコーディング指定を推奨するために、そちらをサポートします。
yuuji@72 96
yuuji@72 97 関係ありませんが今(2000年現在)では x-sjisじゃなくて、Shift_JIS
yuuji@72 98 と綴ることになってます:-p
yuuji@72 99
yuuji@72 100 ・<li>の直後に空白入るとhtmllintに怒られるから空白なしにしたいんだけど…
yuuji@72 101
yuuji@72 102 それ、htmllintがやりすぎなんです。タグ直後の空白に対して文句いう
yuuji@72 103 のは
yuuji@72 104 http://www.cre.canon.co.uk/%7Eneilb/weblint/www5-paper.html
yuuji@72 105 によると、空白があることで変なレイアウトになってしまうへぼブラウ
yuuji@72 106 ザへの配慮によるものなのでHTML的にはまるで問題ないんです。とかく
yuuji@72 107 htmllintを使うとhtmllintに怒られないこと自体が目的となりがちです
yuuji@72 108 が、わたしはそれは本末転倒であると思います。
yuuji@72 109
yuuji@77 110 ・<a href="...">の途中で auto-fill されちゃうと悲しい
yuuji@77 111
yuuji@77 112 使っているのがMule2(Emacs-19)以降なら auto-fill-inhibit-regexp
yuuji@77 113 という変数でコントロールできます。 yahtml-mode-hook を使って以下
yuuji@77 114 のように設定しましょう。
yuuji@77 115
yuuji@77 116 (add-hook 'yahtml-mode-hook
yuuji@77 117 '(lambda ()
yuuji@77 118 (setq auto-fill-inhibit-regexp
yuuji@77 119 "^[ ]*\\(<a href\\|<img src=\\)")))
yuuji@77 120
yuuji@72 121 ■どうにかならんかなあ関連
yuuji@72 122 ・長い文書の下の方だとインデントがめちゃ遅いんだけど。
yuuji@72 123
yuuji@72 124 今は直ってるはずです…。
yuuji@72 125
yuuji@72 126 ・いつも雛型として使っている template.html を簡単に入れたい
yuuji@72 127
yuuji@72 128 autoinsert.el (Emacs19/Mule2付属)を使いましょう。もしくは、それ
yuuji@72 129 の機能強化版 auto-insert-tkld を使いましょう。後者は、
yuuji@72 130 ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/auto-inset-tkld.tar.Z
yuuji@72 131 で入手できます。
yuuji@80 132 http://namazu.org/~tsuchiya/elisp/yahtml-mode.html
yuuji@72 133 に設定例が書いてあります。
yuuji@72 134
yuuji@72 135 ■その他
yuuji@72 136 ・yahtmlってなんてよむの?
yuuji@72 137
yuuji@72 138 がーん、良く聞かれます。
yuuji@72 139 作者も良く分かってません。えへん。
yuuji@72 140 というかかちょいい読み方が思い浮かばないもので。
yuuji@72 141 なんかいい読み方ないすか?
yuuji@72 142 突然思い付きました。正しい呼称は
yuuji@72 143
yuuji@72 144 『HTML屋』
yuuji@72 145
yuuji@72 146 とします。
yuuji@72 147
yuuji@72 148 ・メイリングリストはないんですか?
yuuji@72 149
yuuji@72 150 っていう質問項目があるくらいだからあります。「yahtml」およびそのVz
yuuji@72 151 への移植版「laihtml」(by KATSURAGAWA, Naoki)、Wzへの移植版
yuuji@72 152 「hackhtml」(by TAKENAKA, Hiroshi) に関する情報交換の
yuuji@72 153 ためのメイリングリスト「fj野鳥の会」がそれです。
yuuji@72 154
yuuji@72 155 To: yatex@yatex.org
yuuji@75 156 Subject: subscribe
yuuji@72 157 -----
yuuji@72 158 たぐでーし。明けましておめでとうございまーす。
yuuji@72 159
yuuji@72 160 のようにメイルを送れば加入できます。この時本文に書いた内容がプロ
yuuji@72 161 フィールとして登録されます(変更可)。手続きは全て自動で行われ、登
yuuji@72 162 録が完了すると確認とともに、参加/休止/脱会等の制御コマンドの利用
yuuji@72 163 方法が返送されます。是非参加して一緒に野鳥/雷鳥/白鳥を育ててくだ
yuuji@72 164 さい。
yuuji@72 165
yuuji@72 166 ・yahtmlの最新情報は?
yuuji@72 167
yuuji@72 168 もしあなたが、WWWにアクセスできるなら、
yuuji@72 169 http://www.yatex.org/
yuuji@72 170 を覗いてみて下さい。このなかの、「yatex-current」というリンクを
yuuji@72 171 たどると最新版の野鳥を入手することができます。ただし、正式リリー
yuuji@72 172 ス版ではなく、作者がデバッグ中だったりして正常に動作しない可能性
yuuji@72 173 があるので、current版に関する問い合わせは受けかねますのでご注意
yuuji@72 174 下さい。
yuuji@72 175
yuuji@72 176 ・とにかくわかりませーん!
yuuji@72 177
yuuji@72 178 回答を得るまでの早い順に
yuuji@72 179
yuuji@72 180 ・近くにいる詳しい人に聞く
yuuji@72 181 ・メイリングリストに質問を出す
yuuji@72 182 ・yuuji@yatex.org に質問を出す
yuuji@72 183
yuuji@72 184 でしょうか。お好きな方法でどうぞ。
yuuji@72 185
yuuji@72 186
yuuji@72 187 Local Variables:
yuuji@72 188 mode: indented-text
yuuji@72 189 fill-column: 72
yuuji@72 190 fill-prefix: " "
yuuji@72 191 End: