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