Mercurial > hgrepos > hgweb.cgi > yatex
diff docs/yahtmlj @ 299:d0c09133ced7 yatex-1.77
Rebuild info.
| author | HIROSE Yuuji <yuuji@gentei.org> |
|---|---|
| date | Mon, 01 Apr 2013 23:03:29 +0900 |
| parents | 784b25b062cc |
| children | d69fd7b1ac4d |
line wrap: on
line diff
--- a/docs/yahtmlj Mon Apr 01 23:03:08 2013 +0900 +++ b/docs/yahtmlj Mon Apr 01 23:03:29 2013 +0900 @@ -1,7 +1,7 @@ Info file: yahtmlj, -*-Text-*- produced by `texinfo-format-buffer' from file `yahtmlj.tex' -using `texinfmt.el' version 2.42 of 7 Jul 2006. +using `texinfmt.el' version 2.38 of 3 July 1998. START-INFO-DIR-ENTRY * yahtml: (yahtmlj). Yet Another html-mode for Emacs (Japanese). @@ -35,11 +35,10 @@ はじめに ******** -yahtmlは GNU Emacs 上で HTML文書を作成する時に、繁雑なHTMLタグの入力を -補完機能によってスムーズに行えるようにするだけでなく、weblintなどの構文 -チェックプログラム、カーソル位置のURLやファイル名に依存したブラウザ/イ -メージヴューアの起動などを Emacs 編集画面中から行えるようにするパッケー -ジです。 +yahtmlは GNU Emacs 上で HTML文書を作成する時に、繁雑なHTMLタグの入力を補完 +機能によってスムーズに行えるようにするだけでなく、weblintなどの構文チェッ +クプログラム、カーソル位置のURLやファイル名に依存したブラウザ/イメージヴュー +アの起動などを Emacs 編集画面中から行えるようにするパッケージです。 (このInfoは未完成です(__)…) @@ -69,17 +68,17 @@ (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist)) (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t) -次にyahtmlに必要なファイル(`yahtml.el', `yatexlib.el', -`yatexprc.el') を置くディレクトリを load-path に加えます。たとえば、 -`~/src/emacs/yahtml'に置くのであれば、 +次にyahtmlに必要なファイル(`yahtml.el', `yatexlib.el', `yatexprc.el') を置 +くディレクトリを load-path に加えます。たとえば、 `~/src/emacs/yahtml'に置 +くのであれば、 (setq load-path (cons (expand-file-name "~/src/emacs/yahtml") load-path)) などとします。 以上の設定により、拡張子が .html であるファイルを編集すると自動的に -yahtml がロードされます。yahtmlが正常に起動できたときはモードラインの表 -示が「yahtml」に変わります。 +yahtml がロードされます。yahtmlが正常に起動できたときはモードラインの表示 +が「yahtml」に変わります。 @@ -88,8 +87,8 @@ lintプログラム/ブラウザ/イメージヴューア環境等の設定 ==================================================== -利用する外部プログラムなどに関する以下の変数を確認し、必要なら正しい値 -に変更します(括弧内はデフォルト値)。 +利用する外部プログラムなどに関する以下の変数を確認し、必要なら正しい値に変 +更します(括弧内はデフォルト値)。 `yahtml-www-browser' ... 起動するブラウザのコマンド名(netscape) `yahtml-image-viewer' @@ -111,13 +110,13 @@ ... ファイルシステム上のPATH名と、URLの対応表 `yahtml-directory-index' ... URL指定でファイル名を省略したときに表示されるインデックス - ファイル名(NCSA系httpdなら `index.html', CERN系なら - `Welcome.html'が一般的) + ファイル名(NCSA系httpdなら `index.html', CERN系なら`Welcome.html'が一 + 般的) 変数 `yahtml-path-url-alist' の設定例を示します。例えば、自宅では、 -`/home/yuuji/http/' が `http://localhost/~yuuji' で参照でき、職場では -`/usr/home/yuuji/www/' が`http://www.keio.ac.jp/~yuuji/' で参照できるよ -うになっている場合は以下のように設定します。 +`/home/yuuji/http/' が `http://localhost/~yuuji' で参照でき、職場では +`/usr/home/yuuji/www/' が`http://www.keio.ac.jp/~yuuji/' で参照できるよう +になっている場合は以下のように設定します。 (setq yahtml-path-url-alist '(("/home/yuuj/http" . "http://localhost/~yuuji") @@ -147,27 +146,26 @@ 補完入力 ******** -「野鳥」で利用できる、「begin型補完」、「section型補完」、「large型補 -完」、「maketitle型補完」、「アクセント補完」と全く同じキー操作で対応す -るHTMLタグの補完入力ができます。それぞれの型の補完は順に、「複数行に渡 -るタグ入力」、「空要素タグ(imgなど)の補完」、「一行内での開始/終了タグ -の入力」、「空要素空属性タグの入力」、「文字参照入力」に対応しています。 -具体的には +「野鳥」で利用できる、「begin型補完」、「section型補完」、「large型補完」、 +「maketitle型補完」、「アクセント補完」と全く同じキー操作で対応するHTMLタ +グの補完入力ができます。それぞれの型の補完は順に、「複数行に渡るタグ入力」、 +「空要素タグ(imgなど)の補完」、「一行内での開始/終了タグの入力」、「空要素 +空属性タグの入力」、「文字参照入力」に対応しています。具体的には `[prefix] b (野鳥のbegin補完に対応)' ... <ul> </ul> - のように開始タグと終了タグを二行に渡って書きたい場合の補完を指しま - す。おもにブロック型タグが補完候補に含まれます。 + のように開始タグと終了タグを二行に渡って書きたい場合の補完を指します。 + おもにブロック型タグが補完候補に含まれます。 `[prefix] s (野鳥のsection型補完に対応)' ... <img src="foo.gif" alt="photo"> - のように終了タグを持たず、かつ属性値のみで機能を指定するタグを補完 - します。補完候補としては、img, input が存在します。 + のように終了タグを持たず、かつ属性値のみで機能を指定するタグを補完し + ます。補完候補としては、img, input が存在します。 `[prefix] l (野鳥のlarge型補完に対応)' ... begin型補完とほぼ同じですが、 @@ -177,13 +175,13 @@ のように一行内に開始/終了タグを入れたいときに利用します。 `[prefix] m (野鳥のmaketitle型補完に対応)' - ... 要素も属性値も持たないタグを補完入力します。<br> + ... 要素も属性値も持たないタグを補完入力します。<br> などが補完候補に相当します。 `[prefix] a (野鳥のアクセント補完に対応)' ... エンティティ参照による文字表記を入力するときに用います。 - デフォルトでは < (<), > (>), & (&), " ("), ' - ('),ブランク ( ) の補完入力が行えます。 + デフォルトでは < (<), > (>), & (&), " ("), ' ('), + ブランク ( ) の補完入力が行えます。 @@ -196,8 +194,8 @@ `[prefix] g' ... 対応するオブジェクトにジャンプ -を押すことにより、カーソル位置のHTML構文に対応する場所にジャンプします。 -対応関係が存在すると解釈されるコマンドには以下のものがあります。 +を押すことにより、カーソル位置のHTML構文に対応する場所にジャンプします。対 +応関係が存在すると解釈されるコマンドには以下のものがあります。 * `<TAG>' ←→ `</TAG>' * `<img src="画像ファイル">' → 対応するviewer起動 @@ -229,8 +227,8 @@ `[prefix] c' ... 対応するタグ等を変更 -を押すことにより、カーソル位置のHTML構文に応じた記述内容の変更を行いま -す。カーソル位置と変更する内容の対応は以下の通りです。 +を押すことにより、カーソル位置のHTML構文に応じた記述内容の変更を行います。 +カーソル位置と変更する内容の対応は以下の通りです。 * `<TAG>'〜`</TAG>' ... `TAG' の変更 @@ -243,16 +241,15 @@ 文字参照への変更 ================ -文字としての < や > を表現するときは、文字参照を用いて< や > と表 -記する必要がありますが、HTML以外のファイルからこれらの文字を含むテキス -トを張り込んだ場合などに、これらの文字を一括して文字参照形式に変換でき -ます。 +文字としての < や > を表現するときは、文字参照を用いて< や > と表記 +する必要がありますが、HTML以外のファイルからこれらの文字を含むテキストを張 +り込んだ場合などに、これらの文字を一括して文字参照形式に変換できます。 `[prefix] ;' ... 指定した領域の文字参照に置き換えるべき文字の置換 `[prefix] :' - ... 指定した領域の文字参照を参照文字そのものに置換 - ([prefix] ; の逆変換) + ... 指定した領域の文字参照を参照文字そのものに置換([prefix] ; + の逆変換) @@ -262,9 +259,9 @@ リジョン内文字のURLencode ========================= `[prefix] #' - - ... 指定した領域内に URLencode すべき文字があればそれらを - エンコード表記に置換。 + + ... 指定した領域内に URLencode すべき文字があればそれらをエン + コード表記に置換。 @@ -272,24 +269,23 @@ td括り/tr括り ============= -空白区切りで書いた表形式の行レコードを <td> 括りの並び，あるいはそれら -をさらに <tr> で括った行並びに変換できます。 +空白区切りで書いた表形式の行レコードを <td> 括りの並び，あるいはそれらをさ +らに <tr> で括った行並びに変換できます。 `[prefix] }' - - ... 現在のリジョンにあるデータを空白区切りごとに + + ... 現在のリジョンにあるデータを空白区切りごとに <td>...</td> で括る `[prefix] ]' - - ... 現在のリジョンにある行を上記td括りをほどこしてからさらに行 -ごとに <tr>...</tr> で括るデフォルトでは空白区切りですが，これを変える -ときはDelimiter: の問い合わせに区切り文字を指定します。たとえばカンマ -(,)を指定するとCSVから表を作ることができます。 + + ... 現在のリジョンにある行を上記td括りをほどこしてからさらに行ごと +に <tr>...</tr> で括るデフォルトでは空白区切りですが，これを変えるときは +Delimiter: の問い合わせに区切り文字を指定します。たとえばカンマ(,) を指定 +するとCSVから表を作ることができます。 -td以外の要素，具体的には th で括りたい場合は universal-argument -(`C-u') をつけて上記2つのコマンドを呼びます。どの要素で括るかの質問が増 -えるのでそれに th と入れれば，各フィールドを <th>...</th>で括ります。も -し，第1フィールドのみ th で，残りを全部 td 括りにしたいときは thd と入 -力して下さい。 +td以外の要素，具体的には th で括りたい場合は universal-argument (`C-u') を +つけて上記2つのコマンドを呼びます。どの要素で括るかの質問が増えるのでそれ +に th と入れれば，各フィールドを <th>...</th> で括ります。もし，第1フィー +ルドのみ th で，残りを全部 td 括りにしたいときは thd と入力して下さい。 @@ -309,22 +305,22 @@ CSSクラス名補完 =============== -HTML屋はCSS(Cascading Style Sheets)のクラス名を補完入力することができま -す。スタイル定義として +HTML屋はCSS(Cascading Style Sheets)のクラス名を補完入力することができます。 +スタイル定義として h1.foo, h2.foo { background-color: 0xffffff; } h1.bar, h2.bar { font-size: 120%; } -のようなものがあった場合に、h1またはh2タグを [prefix] b や [prefix] l -で補完入力した場合に、それらに有効な class 名である foo, bar を候補とし -て補完入力することが可能です。また +のようなものがあった場合に、h1またはh2タグを [prefix] b や [prefix] l で補 +完入力した場合に、それらに有効な class 名である foo, bar を候補として補完 +入力することが可能です。また .caution { font-size: 120%; background-color: 0xc00000;} -のような全てのエレメントに働くclassが定義されていた場合は、全てのタグの -補完入力時にclass参照入力を求められます。これが煩わしい場合はエレメント -名入力確定のときにリターンキー(またはC-m)ではなく、C-jを押せばclass補完 -入力をキャンセルできます。たとえば +のような全てのエレメントに働くclassが定義されていた場合は、全てのタグの補 +完入力時にclass参照入力を求められます。これが煩わしい場合はエレメント名入 +力確定のときにリターンキー(またはC-m)ではなく、C-jを押せばclass補完入力を +キャンセルできます。たとえば [prefix] l 行内タグ補完を起動 (または[prefix] l SPC) @@ -346,9 +342,9 @@ CSS定義ファイルの読み直し ========================= -htmlファイルを編集中にCSS定義ファイルを修正し、追加した -classを補完候補として直ちに読み込ませたい場合は、 -`M-x yahtml-mode' として再起動を行ってください。 +htmlファイルを編集中にCSS定義ファイルを修正し、追加したclassを補完候補とし +て直ちに読み込ませたい場合は、`M-x yahtml-mode' として再起動を行ってくださ +い。 @@ -375,8 +371,7 @@ yahtml-mode 中のプリフィクスキー (`\C-c') -- Variable: yahtml-image-viewer - imgで参照している画像ファイルを表示するときに起動するコマンド - (xv) + imgで参照している画像ファイルを表示するときに起動するコマンド (xv) -- Variable: yahtml-www-browser `[prefix]g' で外部ページを表示するときに起動するブラウザ (netscape) @@ -384,8 +379,8 @@ -- Variable: yahtml-kanji-code デフォルトの漢字コード。1=sjis, 2=jis, 3=euc, 4=utf-8 (2) .htaccess ファイルに - AddType "text/html; charset=xxx" .htmlの記述があった場合はそ - れに従う + AddType "text/html; charset=xxx" .html の記述があった場合はそれ + に従う -- Variable: yahtml-fill-column auto-fillするときのカラム数 (72) @@ -394,19 +389,17 @@ yahtml-mode 固有のfill-prefix (`nil') -- Variable: yahtml-path-url-alist - OSのファイルシステム上でのフルパス名と、その外部公開時のURLの対応 - 表。 + OSのファイルシステム上でのフルパス名と、その外部公開時のURLの対応表。 -- Variable: yahtml-directory-index - サーバアクセス時ファイル名を省略したときにデフォルトで開かれるイン - デックスファイルの名前。多くの場合 index.html。(`"index.html"') + サーバアクセス時ファイル名を省略したときにデフォルトで開かれるインデッ + クスファイルの名前。多くの場合 index.html。(`"index.html"') -- Variable: yahtml-lint-program HTML構文チェックプログラム。(`"jweblint"') -- Variable: yahtml-hate-too-deep-indentation - ネストした列挙系環境でのインデントが深すぎるときにtにする。 - (`nil') + ネストした列挙系環境でのインデントが深すぎるときにtにする。(`nil') -- Variable: yahtml-always-/p `<p>' をいれたら必ず `</p>' したい人向け。`nil' @@ -430,27 +423,26 @@ ./.htaccess を参照するかどうかを決定する。`'apache' -- Variable: yahtml-apache-access-file - `yahtml-server-type' が `'apache' のときにアクセス制限ファイル名を - 指定。`".htaccess"' + `yahtml-server-type' が `'apache' のときにアクセス制限ファイル名を指 + 定。`".htaccess"' -- Variable: yahtml-shell-command-option シェルで別コマンドを起動するときのオプション。 -- Variable: yahtml-translate-hyphens-when-comment-region - 領域コメントアウトをするときに既に存在するハイフンを `-' に変 - 更するかどうか。(`t') + 領域コメントアウトをするときに既に存在するハイフンを `-' に変更す + るかどうか。(`t') -- Variable: yahtml-entity-reference-chars-alist - エンティティ参照(Entity Reference)で記述すべき文字群を`'(?文 - 字 . "エンティティ表記")' という形式を列挙したalistで並べる。デフォ - ルトで `<', `>', `&', `'', `"' に対するalistが設定されているので、 - 追加したい分だけを記述すれば良い。cdr部 `"エンティティ表記"' は、 - 先頭の `&' と 末尾の`;'は含めずに書く。 + エンティティ参照(Entity Reference)で記述すべき文字群を`'(?文字 . "エ + ンティティ表記")' という形式を列挙したalistで並べる。デフォルトで + `<', `>', `&', `'', `"' に対するalistが設定されているので、追加したい + 分だけを記述すれば良い。cdr部 `"エンティティ表記"' は、先頭の `&' と + 末尾の`;' は含めずに書く。 -- Variable: yahtml-faithful-to-htmllint - 構文チェッカとして htmllint を利用する場合ちょっとした余計な空白な - どに対しても警告を示すので、これを回避するときにはこの変数を`t'に - する。 + 構文チェッカとして htmllint を利用する場合ちょっとした余計な空白など + に対しても警告を示すので、これを回避するときにはこの変数を`t'にする。 -- Variable: yahtml-use-css CSSの補完機能を使うかどうか (`t') @@ -459,12 +451,12 @@ 画像ファイルのサイズを調べるときに読み込むバイト数 (`10000') -- Variable: yahtml:img-default-alt-format - <img src...>のALT属性のデフォルト文字列の書式。%xは画像の幅、%yは - 画像の高さ、%sはファイルサイズに置換される (`"%xx%y(%sbytes)"') + <img src...>のALT属性のデフォルト文字列の書式。%xは画像の幅、%yは画像 + の高さ、%sはファイルサイズに置換される (`"%xx%y(%sbytes)"') -- Variable: yahtml-escape-chars - href補完などのときに予約文字をURLエンコードするか; 'askのときは確 - 認してから置換する (`'ask') + href補完などのときに予約文字をURLエンコードするか; 'askのときは確認し + てから置換する (`'ask') -- Variable: yahtml-use-font-lock ソースの色づけパッケージとして font-lock を利用するか(`(featurep @@ -475,8 +467,7 @@ 'hilit19)') -- Variable: yahtml-indentation-boundary - インデント計算を打ち切ってよい境界となる正規表現(`"^\\s - *<h[1-3]>"') + インデント計算を打ち切ってよい境界となる正規表現(`"^\\s *<h[1-3]>"') @@ -493,19 +484,19 @@ 取り扱い ******** - 本プログラムはフリーソフトウェアです。本プログラムを使用して生じたい -かなる結果に対しても作者は責任を負わないこととします。転載等に関しては -制限いたしません。常識的に扱ってください。また、使用している旨をメイル -でお知らせいただくと、作者は喜んでサポートに励むことでしょう。 + 本プログラムはフリーソフトウェアです。本プログラムを使用して生じたいかな +る結果に対しても作者は責任を負わないこととします。転載等に関しては制限いた +しません。常識的に扱ってください。また、使用している旨をメイルでお知らせい +ただくと、作者は喜んでサポートに励むことでしょう。 - 苦情、希望、バグ報告、感想等は歓迎いたします。連絡は yuuji@yatex.org -まで(2000年12月現在)。継続的に使用してくださる方はメイリングリスト「fj -野鳥の会」に是非加入してください。加入方法については本パッケージの -`docs/htmlqa'ファイルの「その他」の章を御覧ください。 + 苦情、希望、バグ報告、感想等は歓迎いたします。連絡は yuuji@yatex.org ま +で(2000年12月現在)。継続的に使用してくださる方はメイリングリスト「fj野鳥の +会」に是非加入してください。加入方法については本パッケージの `docs/htmlqa' +ファイルの「その他」の章を御覧ください。 仕様は、予告なく確実に(気分次第で)変更されます:-p。 - 広瀬雄二 + 広瀬雄二 @@ -517,35 +508,38 @@ * Menu: -* カスタマイズ[かすたまいす]: Customizations. (line 5) -* キーアサイン[きいあさいん]: Customizations. (line 5) -* Demacs: Intro. (line 5) -* HTML屋[HTMLや]: Intro. (line 5) -* LaTeX: Intro. (line 5) -* Mule: Intro. (line 5) +* カスタマイズ[かすたまいす]: Customizations. 4. +* キーアサイン[きいあさいん]: Customizations. 4. +* Demacs: Intro. 4. +* HTML屋[HTMLや]: Intro. 4. +* LaTeX: Intro. 4. +* Mule: Intro. 4. + + + Tag table: Node: Top260 Node: Intro729 -Node: Installation1009 -Node: yahtml起動のための設定1197 -Node: lintプログラム/ブラウザ/イメージヴューア環境等の設定1849 -Node: WWWページ環境用変数の設定2349 -Node: Command Invocation3151 -Node: Completion3478 -Node: Jump4460 -Node: Changing and Deleting4859 -Node: 対タグの変更5033 -Node: 文字参照への変更5383 -Node: リジョン内文字のURLencode5767 -Node: td括り/tr括り5998 -Node: CSS Support6619 -Node: CSS-class completion6817 -Node: Reread CSS file7800 -Node: Customizations8022 -Node: All customizable variables8246 -Node: Hook variables11270 -Node: Copying11382 -Node: Concept Index11878 +Node: Installation1008 +Node: yahtml起動のための設定1196 +Node: lintプログラム/ブラウザ/イメージヴューア環境等の設定1850 +Node: WWWページ環境用変数の設定2350 +Node: Command Invocation3121 +Node: Completion3448 +Node: Jump4432 +Node: Changing and Deleting4831 +Node: 対タグの変更5005 +Node: 文字参照への変更5355 +Node: リジョン内文字のURLencode5738 +Node: td括り/tr括り5972 +Node: CSS Support6601 +Node: CSS-class completion6799 +Node: Reread CSS file7783 +Node: Customizations8005 +Node: All customizable variables8229 +Node: Hook variables11227 +Node: Copying11339 +Node: Concept Index11842 End tag table
