rev |
line source |
yuuji@70
|
1 \def\lang{eng} % -*- texinfo -*- for Texinfo V.3.1
|
yuuji@70
|
2 \input texinfo
|
yuuji@70
|
3 @setfilename yahtmle
|
yuuji@70
|
4 @settitle Yet Another html-mode for Emacs
|
yuuji@272
|
5 @direntry
|
yuuji@272
|
6 * yahtml-e: (yahtmle). Yet Another html-mode for Emacs (English).
|
yuuji@272
|
7 @end direntry
|
yuuji@70
|
8
|
yuuji@70
|
9 @iftex
|
yuuji@70
|
10 @c @syncodeindex fn cp
|
yuuji@272
|
11 @c Last modified Fri May 11 15:42:22 2012 on firestorm
|
yuuji@70
|
12 @syncodeindex vr cp
|
yuuji@70
|
13 @end iftex
|
yuuji@70
|
14
|
yuuji@70
|
15 @titlepage
|
yuuji@70
|
16 @sp 10
|
yuuji@70
|
17 @center
|
yuuji@70
|
18 @subtitle Yet Another html-mode for emacs
|
yuuji@70
|
19 @title // yahtml //
|
yuuji@70
|
20 %@subtitle // yahtml //
|
yuuji@271
|
21 @author @copyright{} 1994-2012 by HIROSE, Yuuji [yuuji@@yatex.org]
|
yuuji@70
|
22 @end titlepage
|
yuuji@70
|
23
|
yuuji@70
|
24 @node Top, Intro, (dir), (dir)
|
yuuji@70
|
25 @comment node-name, next, previous, up
|
yuuji@70
|
26
|
yuuji@70
|
27 @menu
|
yuuji@70
|
28 * Intro:: Introduction
|
yuuji@70
|
29 * Installation:: Installing yahtml
|
yuuji@70
|
30 * Command Invocation:: Using External Commands
|
yuuji@70
|
31 * Completion:: Input with Completion
|
yuuji@70
|
32 * Jump:: Moving the Cursor
|
yuuji@70
|
33 * Changing and Deleting:: Changing and Deleting
|
yuuji@70
|
34 * CSS Support:: Style Sheet Support
|
yuuji@70
|
35 * Customizations:: List of Customize Variables
|
yuuji@70
|
36 * Copying:: Copyright
|
yuuji@70
|
37 * Concept Index:: Index
|
yuuji@70
|
38 @end menu
|
yuuji@70
|
39
|
yuuji@70
|
40 @node Intro, Installation, Top, Top
|
yuuji@70
|
41 @comment node-name, next, previous, up
|
yuuji@70
|
42 @chapter Introduction
|
yuuji@70
|
43 @cindex Demacs
|
yuuji@70
|
44 @cindex Mule
|
yuuji@70
|
45 @cindex LaTeX
|
yuuji@70
|
46 @cindex yahtml
|
yuuji@70
|
47
|
yuuji@70
|
48 yahtml is a package to support creating HTML documents on Emacsens. Easy
|
yuuji@70
|
49 input of elements (tags) by completion, syntax checking with programs like
|
yuuji@70
|
50 weblint, and invoking the appropriate browser or image viewer depending on
|
yuuji@70
|
51 the cursor position is its main features.
|
yuuji@70
|
52
|
yuuji@70
|
53 (This Info is still incomplete)
|
yuuji@70
|
54
|
yuuji@70
|
55 @node Installation, Command Invocation, Intro, Top
|
yuuji@70
|
56 @comment node-name, next, previous, up
|
yuuji@70
|
57 @chapter Installing yahtml
|
yuuji@70
|
58 @menu
|
yuuji@70
|
59 * Setting up yahtml::
|
yuuji@70
|
60 * Setting environments for weblint browsers and image viewers::
|
yuuji@70
|
61 * Setting environment variables for WWW pages::
|
yuuji@70
|
62 @end menu
|
yuuji@70
|
63
|
yuuji@70
|
64 @node Setting up yahtml, Setting environments for weblint browsers and image viewers, Installation, Installation
|
yuuji@70
|
65 @comment node-name, next, previous, up
|
yuuji@70
|
66 @section Setting up yahtml
|
yuuji@70
|
67
|
yuuji@70
|
68
|
yuuji@70
|
69 Add the following to @file{~/.emacs}
|
yuuji@70
|
70
|
yuuji@70
|
71 @lisp
|
yuuji@70
|
72 (setq auto-mode-alist
|
yuuji@70
|
73 (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist))
|
yuuji@70
|
74 (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t)
|
yuuji@70
|
75 @end lisp
|
yuuji@70
|
76
|
yuuji@70
|
77 Next, add to load-path the directory with the yahtml files
|
yuuji@70
|
78 (@file{yahtml.el}, @file{yatexlib.el}, @file{yatexprc.el}). For example,
|
yuuji@70
|
79 if you put them in @file{~/src/emacs/yahtml},
|
yuuji@70
|
80
|
yuuji@70
|
81 @lisp
|
yuuji@70
|
82 (setq load-path (cons (expand-file-name "~/src/emacs/yahtml") load-path))
|
yuuji@70
|
83 @end lisp
|
yuuji@70
|
84
|
yuuji@265
|
85 @noindent
|
yuuji@70
|
86 is what you add.
|
yuuji@70
|
87
|
yuuji@70
|
88 By this, yahtml will be automatically loaded when editing files with .html
|
yuuji@70
|
89 extensions. "yahtml" will be displayed on the mode line if no errors
|
yuuji@265
|
90 occurred.
|
yuuji@70
|
91
|
yuuji@70
|
92 @node Setting environments for weblint browsers and image viewers, Setting environment variables for WWW pages, Setting up yahtml, Installation
|
yuuji@70
|
93 @comment node-name, next, previous, up
|
yuuji@70
|
94 @section Setting environments for weblint, browsers, and image viewers
|
yuuji@70
|
95
|
yuuji@70
|
96 Check the variables for invoking external commands and modify as needed.
|
yuuji@70
|
97 Defaults are in parenthesis.
|
yuuji@70
|
98
|
yuuji@70
|
99 @table @code
|
yuuji@70
|
100 @item yahtml-www-browser
|
yuuji@70
|
101 @dots{} browser command name (netscape)
|
yuuji@70
|
102 @item yahtml-image-viewer
|
yuuji@70
|
103 @dots{} image viewer command name (xv)
|
yuuji@70
|
104 @item yahtml-lint-program
|
yuuji@70
|
105 @dots{} syntax check programs command name (jweblint)
|
yuuji@70
|
106 @item yahtml-kanji-code
|
yuuji@70
|
107 @dots{} kanji code for HTML files
|
yuuji@70
|
108 @end table
|
yuuji@70
|
109
|
yuuji@70
|
110 @node Setting environment variables for WWW pages, , Setting environments for weblint browsers and image viewers, Installation
|
yuuji@70
|
111 @comment node-name, next, previous, up
|
yuuji@70
|
112 @section Setting environment variables for WWW pages
|
yuuji@70
|
113
|
yuuji@70
|
114 Variables regarding path names for files that will be your home page.
|
yuuji@70
|
115 @table @code
|
yuuji@70
|
116 @item yahtml-path-url-alist
|
yuuji@70
|
117 @dots{} list of matching path name on file system and URLs
|
yuuji@70
|
118 @item yahtml-directory-index
|
yuuji@70
|
119 @dots{} index file displayed when none is given in URL. Usually
|
yuuji@70
|
120 @file{index.html} on NCSA type httpd and @file{Welcome.html} on
|
yuuji@265
|
121 CERN types.
|
yuuji@70
|
122 @end table
|
yuuji@70
|
123
|
yuuji@70
|
124 Examples for @code{yahtml-path-url-alist}. If @file{/home/yuuji/http/}
|
yuuji@70
|
125 is @code{http://localhost/~yuuji} at home and @file{/usr/home/yuuji/www/}
|
yuuji@70
|
126 is @code{http://www.keio.ac.jp/~yuuji/} at work, then
|
yuuji@70
|
127
|
yuuji@70
|
128 @lisp
|
yuuji@70
|
129 (setq yahtml-path-url-alist
|
yuuji@70
|
130 '(("/home/yuuji/http" . "http://localhost/~yuuji")
|
yuuji@70
|
131 ("/usr/home/yuuji/www" . "http://www.keio.ac.jp/~yuuji")))
|
yuuji@70
|
132 @end lisp
|
yuuji@70
|
133
|
yuuji@70
|
134 Any number of additions can be made to this list.
|
yuuji@70
|
135
|
yuuji@70
|
136 @node Command Invocation, Completion, Installation, Top
|
yuuji@70
|
137 @comment node-name, next, previous, up
|
yuuji@70
|
138 @chapter Invoking external commands
|
yuuji@70
|
139
|
yuuji@70
|
140 For easy use of commands that are handy when editing HTML files.
|
yuuji@70
|
141 @table @kbd
|
yuuji@70
|
142 @item [prefix] t j
|
yuuji@70
|
143 @dots{} Invoke HTML syntax checker (jweblint)
|
yuuji@70
|
144 @item [prefix] t p
|
yuuji@70
|
145 @dots{} Display current page in browser
|
yuuji@70
|
146 @item [prefix] t r
|
yuuji@70
|
147 @dots{} Reload current page if browser is already running
|
yuuji@70
|
148 @end table
|
yuuji@70
|
149
|
yuuji@70
|
150 @node Completion, Jump, Command Invocation, Top
|
yuuji@70
|
151 @comment node-name, next, previous, up
|
yuuji@70
|
152 @chapter Completion Input
|
yuuji@70
|
153
|
yuuji@70
|
154 Completion input of HTML elements is done through the same key strokes as
|
yuuji@70
|
155 YaTeX's begin-type completion, section-type completion, large-type
|
yuuji@70
|
156 completion, maketitle-type completion, and accent completion.
|
yuuji@70
|
157 Corresponding elements in this order is; elements that span multiple
|
yuuji@70
|
158 lines, empty elements such as img, tags that start and end in a
|
yuuji@70
|
159 single line, elements with no attributes or contents, and special or
|
yuuji@70
|
160 symbol entities.
|
yuuji@70
|
161
|
yuuji@70
|
162 @table @kbd
|
yuuji@70
|
163 @item [prefix] b (YaTeX begin-type completion)
|
yuuji@70
|
164 @dots{}
|
yuuji@70
|
165 @example
|
yuuji@70
|
166 <ul>
|
yuuji@70
|
167 </ul>
|
yuuji@70
|
168 @end example
|
yuuji@70
|
169
|
yuuji@70
|
170 @noindent
|
yuuji@70
|
171 Completion for elements that the start tag and the end tag span multiple
|
yuuji@70
|
172 lines. Mostly block-level elements.
|
yuuji@70
|
173
|
yuuji@70
|
174 @item [prefix] s (YateX section-type completion)
|
yuuji@70
|
175 @dots{}
|
yuuji@70
|
176 @example
|
yuuji@70
|
177 <img src="foo.gif" alt="photo">
|
yuuji@70
|
178 @end example
|
yuuji@70
|
179
|
yuuji@70
|
180 @noindent
|
yuuji@70
|
181 Completion for elements that do not have end tags and require only
|
yuuji@70
|
182 attributes. Possible completions are, <img>, <input>.
|
yuuji@70
|
183
|
yuuji@70
|
184 @item [prefix] l (YaTeX large-type completion)
|
yuuji@265
|
185 @dots{}
|
yuuji@70
|
186
|
yuuji@70
|
187 @example
|
yuuji@72
|
188 <big> $B!A(B </big>
|
yuuji@70
|
189 @end example
|
yuuji@70
|
190
|
yuuji@70
|
191 @noindent
|
yuuji@70
|
192 Similar to begin-type completion but used for elements that start and end
|
yuuji@70
|
193 on a single line.
|
yuuji@70
|
194
|
yuuji@70
|
195
|
yuuji@70
|
196 @item [prefix] m (YaTeX maketitle-type completion)
|
yuuji@70
|
197 @dots{} Completion for elements without attributes or contents. Possible
|
yuuji@70
|
198 completion is <br>
|
yuuji@70
|
199
|
yuuji@70
|
200 @item [prefix] a (YaTeX accent completion)
|
yuuji@70
|
201 @dots{} Used to enter special or symbol entities. By default completion
|
yuuji@70
|
202 for < (<), > (>), & (&), " ("), ' ('), blank ( )
|
yuuji@70
|
203 is possible.
|
yuuji@70
|
204 @end table
|
yuuji@70
|
205
|
yuuji@70
|
206 @node Jump, Changing and Deleting, Completion, Top
|
yuuji@70
|
207 @comment node-name, next, previous, up
|
yuuji@70
|
208 @chapter Cursor Movement
|
yuuji@265
|
209 By using
|
yuuji@70
|
210
|
yuuji@70
|
211 @table @kbd
|
yuuji@70
|
212 @item [prefix] g
|
yuuji@70
|
213 @dots{} move to corresponding object
|
yuuji@70
|
214 @end table
|
yuuji@70
|
215
|
yuuji@265
|
216 @noindent
|
yuuji@70
|
217 the cursor will go to the corresponding object according to the context.
|
yuuji@70
|
218 Recognized contexts are
|
yuuji@70
|
219
|
yuuji@70
|
220 @itemize @bullet
|
yuuji@70
|
221 @item @code{<TAG>} <--> @code{</TAG>}
|
yuuji@70
|
222 @item @code{<img src="image.file">} -> invoke viewer
|
yuuji@70
|
223 @item @code{<a href="link.to.somewhere">} -> move cursor to linked target
|
yuuji@70
|
224 @item @code{<applet code="program">} -> open Java source
|
yuuji@72
|
225 @c @item @code{\include(\input)} $B"*(B $BBP1~$9$k%U%!%$%k(B
|
yuuji@70
|
226 @end itemize
|
yuuji@70
|
227
|
yuuji@70
|
228 @node Changing and Deleting, CSS Support, Jump, Top
|
yuuji@70
|
229 @comment node-name, next, previous, up
|
yuuji@70
|
230 @chapter Changing and Deleting
|
yuuji@70
|
231
|
yuuji@70
|
232 @menu
|
yuuji@70
|
233 * Changing tags in pairs::
|
yuuji@70
|
234 * Changing entities::
|
yuuji@70
|
235 * URLencoding of strings within region::
|
yuuji@269
|
236 * td-enclosure/tr-enclosure::
|
yuuji@70
|
237 @end menu
|
yuuji@70
|
238
|
yuuji@70
|
239 @node Changing tags in pairs, Changing entities, Changing and Deleting, Changing and Deleting
|
yuuji@70
|
240 @comment node-name, next, previous, up
|
yuuji@70
|
241 @section Changing tags in pairs
|
yuuji@70
|
242 By using
|
yuuji@70
|
243
|
yuuji@70
|
244 @table @kbd
|
yuuji@70
|
245 @item [prefix] c
|
yuuji@70
|
246 @dots{} change tags in matching pairs
|
yuuji@70
|
247 @end table
|
yuuji@70
|
248
|
yuuji@265
|
249 @noindent
|
yuuji@70
|
250 the content can be changed according to the context of the HTML document
|
yuuji@70
|
251 where the cursor is located.
|
yuuji@70
|
252
|
yuuji@70
|
253 @itemize @bullet
|
yuuji@72
|
254 @item @code{<TAG>}$B!A(B@code{</TAG>}
|
yuuji@70
|
255 @dots{} change @code{TAG} element name
|
yuuji@70
|
256 @item attributes such as @code{<img src="image.file" alt="photo">}
|
yuuji@70
|
257 @dots{} change attributes
|
yuuji@70
|
258 @end itemize
|
yuuji@70
|
259
|
yuuji@70
|
260 @node Changing entities, URLencoding of strings within region, Changing tags in pairs, Changing and Deleting
|
yuuji@70
|
261 @comment node-name, next, previous, up
|
yuuji@70
|
262 @section Changing entities
|
yuuji@70
|
263 Special characters such as < or > must be written as < and >. Easy
|
yuuji@70
|
264 conversion of these characters can be done when importing text from non
|
yuuji@70
|
265 HTML files.
|
yuuji@70
|
266
|
yuuji@70
|
267
|
yuuji@70
|
268 @table @kbd
|
yuuji@70
|
269 @item [prefix] ;
|
yuuji@70
|
270 @dots{} convert char to special entity in marked region
|
yuuji@70
|
271 @item [prefix] :
|
yuuji@70
|
272 @dots{} convert special entity to original char in marked region
|
yuuji@70
|
273 (reverse of [prefix] ;)
|
yuuji@70
|
274 @end table
|
yuuji@70
|
275
|
yuuji@70
|
276
|
yuuji@158
|
277 @node URLencoding of strings within region, td-enclosure/tr-enclosure, Changing entities, Changing and Deleting
|
yuuji@70
|
278 @comment node-name, next, previous, up
|
yuuji@70
|
279 @section URLencoding of strings within region
|
yuuji@70
|
280
|
yuuji@70
|
281 @table @kbd
|
yuuji@70
|
282 @item [prefix] #
|
yuuji@70
|
283 @dots{} encode chars that needs to be URLencoded within region
|
yuuji@70
|
284 @end table
|
yuuji@70
|
285
|
yuuji@158
|
286 @node td-enclosure/tr-enclosure, , URLencoding of strings within region, Changing and Deleting
|
yuuji@158
|
287 @comment node-name, next, previous, up
|
yuuji@158
|
288 @section td-enclosure/tr-enclosure
|
yuuji@158
|
289 If you wan to convert series of field into <td>...</td> repetitions for
|
yuuji@158
|
290 table element, td-enclosure or tr-enclosure is convenient.
|
yuuji@158
|
291
|
yuuji@158
|
292 @table @kbd
|
yuuji@223
|
293 @item [prefix] @}
|
yuuji@158
|
294 @dots{} Enclose each field in a region into <td>...</td>'s.
|
yuuji@158
|
295 @item [prefix] ]
|
yuuji@158
|
296 @dots{} Enclose each line in a region into <tr>...</tr>'s, with
|
yuuji@158
|
297 every line converted to <td>...</td> repetition.
|
yuuji@158
|
298 @end table
|
yuuji@158
|
299 They presume white space as field separator by default.
|
yuuji@158
|
300 To change this, enter other delimiting character for a query.
|
yuuji@158
|
301 You can convert CSV, for example, into table by specifying
|
yuuji@158
|
302 comma(,) as a delimiter.
|
yuuji@158
|
303
|
yuuji@158
|
304 If you want to enclose fields with th, call with
|
yuuji@158
|
305 universal-argument (@kbd{C-u}). Enter `th' to enclose fields
|
yuuji@158
|
306 with <th>...</th>. The special answer `thd' means that
|
yuuji@158
|
307 enclose the only first column with th, and the rest with td.
|
yuuji@158
|
308
|
yuuji@70
|
309 @node CSS Support, Customizations, Changing and Deleting, Top
|
yuuji@70
|
310 @comment node-name, next, previous, up
|
yuuji@70
|
311 @chapter CSS(Style Sheets) Support
|
yuuji@70
|
312
|
yuuji@70
|
313 @menu
|
yuuji@70
|
314 * CSS-class completion::
|
yuuji@70
|
315 * Reread CSS definition::
|
yuuji@70
|
316 @end menu
|
yuuji@70
|
317
|
yuuji@70
|
318 @node CSS-class completion, Reread CSS definition, CSS Support, CSS Support
|
yuuji@70
|
319 @comment node-name, next, previous, up
|
yuuji@70
|
320 @section CSS class-name completion
|
yuuji@70
|
321 You can input a class name in your CSS definition with completion.
|
yuuji@70
|
322 If you have CSS defined as below;
|
yuuji@70
|
323
|
yuuji@70
|
324 @display
|
yuuji@70
|
325 h1.foo, h2.foo @{ background-color: 0xffffff; @}
|
yuuji@70
|
326 h1.bar, h2.bar @{ font-size: 120%; @}
|
yuuji@70
|
327 @end display
|
yuuji@70
|
328
|
yuuji@70
|
329 when you input h1(or h2) tag with completing-read by [prefix] b or
|
yuuji@70
|
330 [prefix] l, yahtml prompts you to input class name with completion from
|
yuuji@265
|
331 the words which are effective to h1 or h2. And if you defined
|
yuuji@70
|
332 global class like this;
|
yuuji@70
|
333
|
yuuji@70
|
334 @display
|
yuuji@70
|
335 .caution @{ font-size: 120%; background-color: 0xc00000;@}
|
yuuji@70
|
336 @end display
|
yuuji@70
|
337
|
yuuji@70
|
338 when you input any tags via completing-read, yahtml prompts you to input
|
yuuji@70
|
339 class name. If this is bothering, typing @kbd{C-j} instead of
|
yuuji@70
|
340 @kbd{RET} (or @kbd{C-m}) cancels the next prompt to class name completion.
|
yuuji@70
|
341
|
yuuji@70
|
342 @node Reread CSS definition, , CSS-class completion, CSS Support
|
yuuji@70
|
343 @comment node-name, next, previous, up
|
yuuji@70
|
344 @section Re-reading CSS definition
|
yuuji@70
|
345 If you add some class to your CSS file and you want yahtml to load
|
yuuji@70
|
346 new definitions, type @kbd{M-x yahtml-mode RET} to make yahtml do.
|
yuuji@70
|
347
|
yuuji@70
|
348 @node Customizations, Copying, CSS Support, Top
|
yuuji@70
|
349 @comment node-name, next, previous, up
|
yuuji@70
|
350 @chapter Customizations
|
yuuji@70
|
351 @cindex Customize
|
yuuji@70
|
352 @cindex Key Assign
|
yuuji@70
|
353
|
yuuji@70
|
354 Variables that modify yahtml's behavior.
|
yuuji@70
|
355
|
yuuji@70
|
356 @menu
|
yuuji@70
|
357 * All customizable variables:: List of customizable variables
|
yuuji@70
|
358 * Hook variables:: hook variables
|
yuuji@70
|
359 @end menu
|
yuuji@70
|
360
|
yuuji@70
|
361 @node All customizable variables, Hook variables, Customizations, Customizations
|
yuuji@70
|
362 @comment node-name, next, previous, up
|
yuuji@70
|
363 @section List of customizable variables. Defaults in parenthesis
|
yuuji@70
|
364
|
yuuji@70
|
365 @defvar yahtml-prefix
|
yuuji@70
|
366 Prefix key for yahtml-mode. (@kbd{\C-c})
|
yuuji@70
|
367 @end defvar
|
yuuji@70
|
368
|
yuuji@70
|
369 @defvar yahtml-image-viewer
|
yuuji@70
|
370 Command to view image files refered by img. (xv)
|
yuuji@70
|
371 @end defvar
|
yuuji@70
|
372
|
yuuji@70
|
373 @defvar yahtml-www-browser
|
yuuji@70
|
374 Browser to view external pages with @kbd{[prefix]g}. (netscape)
|
yuuji@70
|
375 @end defvar
|
yuuji@70
|
376
|
yuuji@70
|
377 @defvar yahtml-kanji-code
|
yuuji@118
|
378 Default kanji code. 1=sjis, 2=jis, 3=euc, 4=utf-8 (2)
|
yuuji@70
|
379 If
|
yuuji@70
|
380 @quotation
|
yuuji@70
|
381 AddType "text/html; charset=xxx" .html
|
yuuji@70
|
382 @end quotation
|
yuuji@70
|
383 is written in .htaccess, this will override yahtml-kanji-code.
|
yuuji@70
|
384 @end defvar
|
yuuji@70
|
385
|
yuuji@70
|
386 @defvar yahtml-fill-column
|
yuuji@70
|
387 Columns to auto-fill (72)
|
yuuji@70
|
388 @end defvar
|
yuuji@70
|
389
|
yuuji@70
|
390 @defvar yahtml-fill-prefix
|
yuuji@70
|
391 fill-prefix specific to yahtml-mode. (@code{nil})
|
yuuji@70
|
392 @end defvar
|
yuuji@70
|
393
|
yuuji@70
|
394 @defvar yahtml-path-url-alist
|
yuuji@70
|
395 Matching list of URL and full path name on OS's file system.
|
yuuji@70
|
396 @end defvar
|
yuuji@70
|
397
|
yuuji@70
|
398 @defvar yahtml-directory-index
|
yuuji@70
|
399 Default index filed opened when accessing a server without a filename,
|
yuuji@70
|
400 usually index.html. (@code{"index.html"})
|
yuuji@70
|
401 @end defvar
|
yuuji@70
|
402
|
yuuji@70
|
403 @defvar yahtml-lint-program
|
yuuji@70
|
404 HTML syntax check program. (@code{"jweblint"})
|
yuuji@70
|
405 @end defvar
|
yuuji@70
|
406
|
yuuji@70
|
407 @defvar yahtml-hate-too-deep-indentation
|
yuuji@70
|
408 setq to t when indentations for nested enumerate elements are too deep.
|
yuuji@70
|
409 (@code{nil})
|
yuuji@70
|
410 @end defvar
|
yuuji@70
|
411
|
yuuji@70
|
412 @defvar yahtml-always-/p
|
yuuji@70
|
413 setq to t if you always want @code{</p>} after @code{</p>}. @code{nil}
|
yuuji@70
|
414 @end defvar
|
yuuji@70
|
415
|
yuuji@70
|
416 @defvar yahtml-p-prefered-env-regexp
|
yuuji@75
|
417 Elements that @code{<p>} will be automatically inserted.
|
yuuji@75
|
418 (@code{"^\\(body\\|dl\\|blockquote\\)"})
|
yuuji@70
|
419 @end defvar
|
yuuji@70
|
420
|
yuuji@70
|
421 @defvar yahtml-template-file
|
yuuji@70
|
422 File to automatically insert when editing a new HTML file.
|
yuuji@70
|
423 @file{"~/http/template.html"}
|
yuuji@70
|
424 @end defvar
|
yuuji@70
|
425
|
yuuji@70
|
426 @defvar yahtml-prefer-upcases
|
yuuji@70
|
427 Use uppercase for tags. @code{nil}
|
yuuji@70
|
428 @end defvar
|
yuuji@70
|
429
|
yuuji@70
|
430 @defvar yahtml-prefer-upcase-attributes
|
yuuji@70
|
431 Use uppercase for attributes. @code{nil}
|
yuuji@70
|
432 @end defvar
|
yuuji@70
|
433
|
yuuji@70
|
434 @defvar yahtml-server-type
|
yuuji@70
|
435 setq to 'apache if using a Apache server, and will refer ./.htaccess.
|
yuuji@70
|
436 @code{'apache}
|
yuuji@70
|
437 @end defvar
|
yuuji@70
|
438
|
yuuji@70
|
439 @defvar yahtml-apache-access-file
|
yuuji@70
|
440 When @code{yahtml-server-type} is @code{'apache}, define name of access
|
yuuji@70
|
441 restriction file. @file{".htaccess"}
|
yuuji@70
|
442 @end defvar
|
yuuji@70
|
443
|
yuuji@70
|
444 @defvar yahtml-shell-command-option
|
yuuji@70
|
445 Options needed to invoke shell commands.
|
yuuji@70
|
446 @end defvar
|
yuuji@70
|
447
|
yuuji@70
|
448 @defvar yahtml-translate-hyphens-when-comment-region
|
yuuji@70
|
449 Whether to change hyphens to @code{-} when commenting out region.
|
yuuji@70
|
450 (@code{t})
|
yuuji@70
|
451 @end defvar
|
yuuji@70
|
452
|
yuuji@70
|
453 @defvar yahtml-entity-reference-chars-alist
|
yuuji@70
|
454 alist of characters that needs to be written by Entity Reference. Enter
|
yuuji@70
|
455 as @code{'(?char . "EntityReference")}. By default, @code{<}, @code{>},
|
yuuji@70
|
456 @code{&}, @code{'}, is set. Add as needed. Do not include @code{&} at
|
yuuji@70
|
457 beginning and @code{;} at end of cdr portion of @code{"EntityReference"}.
|
yuuji@70
|
458 @end defvar
|
yuuji@70
|
459
|
yuuji@70
|
460 @defvar yahtml-faithful-to-htmllint
|
yuuji@70
|
461 When using htmllint to check syntax, it will complain about excess spaces.
|
yuuji@70
|
462 setq to @code{t} to avoid this.
|
yuuji@70
|
463 @end defvar
|
yuuji@70
|
464
|
yuuji@72
|
465 @defvar yahtml-use-css
|
yuuji@72
|
466 Use style-sheet support or not (@code{t})
|
yuuji@72
|
467 @end defvar
|
yuuji@72
|
468
|
yuuji@72
|
469 @defvar yahtml-image-inspection-bytes
|
yuuji@72
|
470 Number of bytes to inspect the image for geometry information (@code{10000})
|
yuuji@72
|
471 @end defvar
|
yuuji@72
|
472
|
yuuji@72
|
473 @defvar yahtml:img-default-alt-format
|
yuuji@72
|
474 format of img entity's ALT attributes.
|
yuuji@72
|
475 %x: width, %y: height, %s: size in bytes, %c: first comment string,
|
yuuji@72
|
476 %f: filename (@code{"%xx%y(%sbytes)"})
|
yuuji@72
|
477 @end defvar
|
yuuji@72
|
478
|
yuuji@72
|
479 @defvar yahtml-escape-chars
|
yuuji@72
|
480 When, completing href-s, Escape reserved characters to URL-encoding or not.
|
yuuji@72
|
481 Nil for never, t for everytime, and 'ask for inquiring
|
yuuji@72
|
482 at each reserved chars. (@code{'ask})
|
yuuji@72
|
483 @end defvar
|
yuuji@72
|
484
|
yuuji@72
|
485 @defvar yahtml-use-font-lock
|
yuuji@72
|
486 Use font-lock to fontify buffer or not
|
yuuji@72
|
487 (@code{(featurep 'font-lock)})
|
yuuji@72
|
488 @end defvar
|
yuuji@72
|
489
|
yuuji@75
|
490 @defvar yahtml-use-hilit19
|
yuuji@72
|
491 Use hilit19 to highlight buffer or not
|
yuuji@72
|
492 (@code{(featurep 'hilit19)})
|
yuuji@72
|
493 @end defvar
|
yuuji@72
|
494
|
yuuji@75
|
495 @defvar yahtml-indentation-boundary
|
yuuji@75
|
496 Boundary regexp for indentation calculation.
|
yuuji@75
|
497 (@code{"^\\s *<h[1-3]>"})
|
yuuji@75
|
498 @end defvar
|
yuuji@70
|
499
|
yuuji@70
|
500 @node Hook variables, , All customizable variables, Customizations
|
yuuji@70
|
501 @comment node-name, next, previous, up
|
yuuji@70
|
502 @section hook variables
|
yuuji@70
|
503
|
yuuji@70
|
504
|
yuuji@70
|
505 @node Copying, Concept Index, Customizations, Top
|
yuuji@70
|
506 @comment node-name, next, previous, up
|
yuuji@70
|
507 @chapter Copying
|
yuuji@70
|
508
|
yuuji@70
|
509 This program is distributed as freesoftware. The author will take no
|
yuuji@70
|
510 responsibility to any damages due to the usage of this software
|
yuuji@70
|
511 whatsoever. There are no restrictions to its redistribution, just use
|
yuuji@70
|
512 common sense. Mail me your thoughts on this program and I will be more
|
yuuji@70
|
513 than willing to help.
|
yuuji@70
|
514
|
yuuji@70
|
515 Complaints, requests, bug reports and comments are welcome. Make contacts
|
yuuji@72
|
516 to yuuji@@yatex.org$B!!(B(as of December 2000)
|
yuuji@70
|
517
|
yuuji@70
|
518 If you like this program and use it on a regular basis, please join the
|
yuuji@70
|
519 mailing list "fj Wild Bird Society". Procedures can be found in the "etc"
|
yuuji@72
|
520 section of @file{docs/htmlqa.eng} in this package.
|
yuuji@70
|
521
|
yuuji@70
|
522
|
yuuji@70
|
523 @flushright
|
yuuji@70
|
524 HIROSE, Yuuji
|
yuuji@70
|
525 @end flushright
|
yuuji@70
|
526
|
yuuji@70
|
527
|
yuuji@70
|
528 @node Concept Index, , Copying, Top
|
yuuji@70
|
529 @comment node-name, next, previous, up
|
yuuji@70
|
530 @unnumbered Index
|
yuuji@70
|
531 @printindex cp
|
yuuji@70
|
532
|
yuuji@70
|
533
|
yuuji@70
|
534 @contents
|
yuuji@70
|
535
|
yuuji@70
|
536 @bye
|
yuuji@70
|
537
|
yuuji@70
|
538 @c Local Variables:
|
yuuji@70
|
539 @c fill-column: 74
|
yuuji@70
|
540 @c fill-prefix: nil
|
yuuji@70
|
541 @c End:
|
yuuji@70
|
542
|
yuuji@70
|
543 Tag table:
|
yuuji@70
|
544
|
yuuji@70
|
545 End tag table
|