Mercurial > hg > xemacs-beta
comparison man/w3.texi @ 26:441bb1e64a06 r19-15b96
Import from CVS: tag r19-15b96
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:51:32 +0200 |
parents | 4103f0995bd7 |
children | ec9a17fef872 |
comparison
equal
deleted
inserted
replaced
25:383a494979f8 | 26:441bb1e64a06 |
---|---|
69 are preserved on all copies. | 69 are preserved on all copies. |
70 | 70 |
71 @end titlepage | 71 @end titlepage |
72 @page | 72 @page |
73 @ifinfo | 73 @ifinfo |
74 @node Top, Getting Started,, (DIR) | 74 @node Top, Getting Started, (dir), (dir) |
75 @top W3 | |
76 | |
75 Users can browse the World Wide Web from within Emacs by using Emacs-W3. | 77 Users can browse the World Wide Web from within Emacs by using Emacs-W3. |
76 All of the widely used (and even some not very widely used) @sc{url} | 78 All of the widely used (and even some not very widely used) @sc{url} |
77 schemes are supported, and it is very easy to add new methods as the | 79 schemes are supported, and it is very easy to add new methods as the |
78 need arises. | 80 need arises. |
79 | 81 |
81 from any program in Emacs. Users and other package writers are | 83 from any program in Emacs. Users and other package writers are |
82 encouraged to @i{Web-enable} their applications and daily work routines | 84 encouraged to @i{Web-enable} their applications and daily work routines |
83 with the library. | 85 with the library. |
84 | 86 |
85 Emacs-W3 is completely customizable, both from Emacs-Lisp and from | 87 Emacs-W3 is completely customizable, both from Emacs-Lisp and from |
86 stylesheets @xref{Style Sheets} If there is any aspect of Emacs-W3 that | 88 stylesheets @xref{Stylesheets} If there is any aspect of Emacs-W3 that |
87 cannot be modified to your satisfaction, please send mail to the | 89 cannot be modified to your satisfaction, please send mail to the |
88 @t{w3-beta@@indiana.edu} mailing list with any suggestions. | 90 @t{w3-beta@@indiana.edu} mailing list with any suggestions. |
89 @xref{Reporting Bugs} | 91 @xref{Reporting Bugs} |
90 | 92 |
91 @menu | 93 @menu |
92 * Getting Started:: Getting up and running with Emacs-W3 | 94 * Getting Started:: Getting up and running with Emacs-W3 |
93 * Basic Usage:: Basic movement and usage of Emacs-W3. | 95 * Basic Usage:: Basic movement and usage of Emacs-W3. |
94 * Compatibility:: Explanation of compatibility with | 96 * Compatibility:: Explanation of compatibility with |
95 other browsers. | 97 other browsers. |
96 * Stylesheets:: How to control the look of web pages | 98 * Stylesheets:: How to control the look of web pages |
97 * Supported URLs:: What @sc{URL} schemes are supported. | 99 * Supported URLs:: What @sc{URL} schemes are supported. |
98 * MIME Support:: Support for @sc{mime} | 100 * MIME Support:: Support for @sc{mime} |
99 * Security:: Various security methods supported | 101 * Security:: Various security methods supported |
100 * Non-Unix Operating Systems:: Special considerations necessary to get | 102 * Non-Unix Operating Systems:: Special considerations necessary to get |
101 up and running correctly under non-unix | 103 up and running correctly under non-unix |
102 OS's. | 104 OS's. |
103 * Speech Integration:: Outputting to a speech synthesizer. | 105 * Speech Integration:: Outputting to a speech synthesizer. |
104 * Advanced Features:: Some of the more arcane features. | 106 * Advanced Features:: Some of the more arcane features. |
105 * More Help:: How to get more help---mailing lists, | 107 * More Help:: How to get more help---mailing lists, |
142 * Preferences Panel:: Quick configuration of common options. | 144 * Preferences Panel:: Quick configuration of common options. |
143 @end menu | 145 @end menu |
144 | 146 |
145 @node Downloading, Building and Installing, Getting Started, Getting Started | 147 @node Downloading, Building and Installing, Getting Started, Getting Started |
146 @section Downloading | 148 @section Downloading |
149 | |
147 :: WORK :: What you need, and why | 150 :: WORK :: What you need, and why |
148 :: WORK :: Where to download Emacs, XEmacs, various platforms | 151 :: WORK :: Where to download Emacs, XEmacs, various platforms |
149 :: WORK :: Where to download Emacs-W3 | 152 :: WORK :: Where to download Emacs-W3 |
150 :: WORK :: Where to download related utilities (netpbm, xv, gimp, etc.) | 153 :: WORK :: Where to download related utilities (netpbm, xv, gimp, etc.) |
151 | 154 |
152 @node Building and Installing, Startup Files, Downloading, Getting Started | 155 @node Building and Installing, Startup Files, Downloading, Getting Started |
153 @section Building and Installing | 156 @section Building and Installing |
157 | |
154 :: WORK :: Document makefile variables | 158 :: WORK :: Document makefile variables |
155 :: WORK :: Document what gets installed where, why | 159 :: WORK :: Document what gets installed where, why |
156 | 160 |
157 @node Startup Files, Preferences Panel, Building and Installing, Getting Started | 161 @node Startup Files, Preferences Panel, Building and Installing, Getting Started |
158 @section Startup Files | 162 @section Startup Files |
159 @cindex Startup files | 163 @cindex Startup files |
160 @cindex Default stylesheet | 164 @cindex Default stylesheet |
165 | |
161 :: WORK :: startup files | 166 :: WORK :: startup files |
162 This section should document where emacs-w3 looks for its startup files, | 167 This section should document where emacs-w3 looks for its startup files, |
163 and what each one does. 'profile' 'stylesheet' 'hotlist' 'history' etc. | 168 and what each one does. 'profile' 'stylesheet' 'hotlist' 'history' etc. |
164 | 169 |
165 @node Preferences Panel, , Startup Files, Getting Started | 170 @node Preferences Panel, , Startup Files, Getting Started |
166 @section Preferences Panel | 171 @section Preferences Panel |
167 @cindex Preferences | 172 @cindex Preferences |
168 @kindex M-x w3-preferences-edit | 173 @kindex M-x w3-preferences-edit |
174 | |
169 :: WORK :: pref panel | 175 :: WORK :: pref panel |
170 This should document the quick preferences panel. M-x w3-preferences-edit | 176 This should document the quick preferences panel. M-x w3-preferences-edit |
171 | 177 |
172 @node Basic Usage, Movement , Getting Started, Top | 178 @node Basic Usage, Compatibility, Getting Started, Top |
173 @chapter Basic Usage | 179 @chapter Basic Usage |
174 @cindex Basic Usage | 180 @cindex Basic Usage |
175 @kindex space | 181 @kindex space |
176 @kindex backspace | 182 @kindex backspace |
177 @kindex return | 183 @kindex return |
203 hypertext link @b{under the cursor}. | 209 hypertext link @b{under the cursor}. |
204 | 210 |
205 There are several areas that the keybindings fall into: movement, | 211 There are several areas that the keybindings fall into: movement, |
206 information, action, and miscellaneous. | 212 information, action, and miscellaneous. |
207 | 213 |
208 @ifinfo | |
209 @menu | 214 @menu |
210 * Movement:: Moving around in the buffer. | 215 * Movement:: Moving around in the buffer. |
211 * Information:: Getting information about a document. | 216 * Information:: Getting information about a document. |
212 * Action:: Following links, printing, etc. | 217 * Action:: Following links, printing, etc. |
213 * Miscellaneous:: Everything else. | 218 * Miscellaneous:: Everything else. |
214 @end menu | 219 @end menu |
215 @end ifinfo | 220 |
216 @node Movement, Information, Basic Usage, Basic Usage | 221 @node Movement, Information, Basic Usage, Basic Usage |
217 @section Movement | 222 @section Movement |
223 | |
218 All the standard Emacs bindings for movement are still in effect, with a | 224 All the standard Emacs bindings for movement are still in effect, with a |
219 few additions for convenience. | 225 few additions for convenience. |
220 | 226 |
221 @table @kbd | 227 @table @kbd |
222 @findex w3-scroll-up | 228 @findex w3-scroll-up |
271 Bury this buffer, but don't kill it | 277 Bury this buffer, but don't kill it |
272 @end table | 278 @end table |
273 | 279 |
274 @node Information, Action, Movement, Basic Usage | 280 @node Information, Action, Movement, Basic Usage |
275 @section Information | 281 @section Information |
282 | |
276 These functions relate information about one or more links on the | 283 These functions relate information about one or more links on the |
277 current document. | 284 current document. |
278 | 285 |
279 @table @kbd | 286 @table @kbd |
280 @kindex v | 287 @kindex v |
319 the current window-system's clipboard, if possible. | 326 the current window-system's clipboard, if possible. |
320 @end table | 327 @end table |
321 | 328 |
322 @node Action, Miscellaneous, Information, Basic Usage | 329 @node Action, Miscellaneous, Information, Basic Usage |
323 @section Action | 330 @section Action |
331 | |
324 First, here are the keys and functions that bring up a new hypertext | 332 First, here are the keys and functions that bring up a new hypertext |
325 page, usually creating a new buffer. | 333 page, usually creating a new buffer. |
326 @table @kbd | 334 @table @kbd |
327 @kindex m | 335 @kindex m |
328 @findex w3-complete-link | 336 @findex w3-complete-link |
458 @item HF, F | 466 @item HF, F |
459 Takes one step forward along the path in the current history. Has no | 467 Takes one step forward along the path in the current history. Has no |
460 effect if at the end of the session history. | 468 effect if at the end of the session history. |
461 @end table | 469 @end table |
462 | 470 |
463 @node Miscellaneous, Compatibility, Action, Basic Usage | 471 @node Miscellaneous, , Action, Basic Usage |
464 @section Miscellaneous | 472 @section Miscellaneous |
473 | |
465 @table @kbd | 474 @table @kbd |
466 @kindex M-m | 475 @kindex M-m |
467 @findex w3-mail-current-document | 476 @findex w3-mail-current-document |
468 @item M-m | 477 @item M-m |
469 Mails the current document to someone. Choose from several different | 478 Mails the current document to someone. Choose from several different |
561 first asks what type of link to follow (Normal or Reverse), then does | 570 first asks what type of link to follow (Normal or Reverse), then does |
562 a @code{completing-read} on only the links that have that type of | 571 a @code{completing-read} on only the links that have that type of |
563 relationship. | 572 relationship. |
564 @end table | 573 @end table |
565 | 574 |
566 @node Compatibility, Emulation, Miscellaneous, Top | 575 @node Compatibility, Stylesheets, Basic Usage, Top |
567 @chapter Compatibility with other Browsers | 576 @chapter Compatibility with other Browsers |
568 Due to the popularity of several other browsers, Emacs-W3 offers an easy | 577 Due to the popularity of several other browsers, Emacs-W3 offers an easy |
569 transition to its much better way of life. This ranges from being able | 578 transition to its much better way of life. This ranges from being able |
570 to share the same preferences files and disk cache to actually emulating | 579 to share the same preferences files and disk cache to actually emulating |
571 the keybindings used in other browsers. | 580 the keybindings used in other browsers. |
572 | 581 |
573 @ifinfo | |
574 @menu | 582 @menu |
575 * Emulation:: Emacs-W3 can emulate the keybindings and | 583 * Emulation:: Emacs-W3 can emulate the keybindings and |
576 other behaviours of other browsers. | 584 other behaviours of other browsers. |
577 * Hotlist Handling:: A hotlist is an easy way to keep track of | 585 * Hotlist Handling:: A hotlist is an easy way to keep track of |
578 interesting Web pages without having to | 586 interesting Web pages without having to |
579 remember the exact path to get there. | 587 remember the exact path to get there. |
580 * Session History:: Keeping a history of documents visited | 588 * Session History:: Keeping a history of documents visited |
581 in one Emacs sessions allows the use of | 589 in one Emacs sessions allows the use of |
582 'forward' and 'back' buttons easily. | 590 'forward' and 'back' buttons easily. |
583 * Global History:: Keeping a history of all the places ever | 591 * Global History:: Keeping a history of all the places ever |
584 visited on the web. | 592 visited on the web. |
585 @end menu | 593 @end menu |
586 @end ifinfo | 594 |
587 @node Emulation, Hotlist Handling, Compatibility, Compatibility | 595 @node Emulation, Hotlist Handling, Compatibility, Compatibility |
588 @section Emulation | 596 @section Emulation |
589 @cindex Browser emulation | 597 @cindex Browser emulation |
590 @cindex Emulation of other browsers | 598 @cindex Emulation of other browsers |
591 @cindex Netscape emulation | 599 @cindex Netscape emulation |
593 @findex turn-on-netscape-emulation | 601 @findex turn-on-netscape-emulation |
594 @findex turn-on-lynx-emulation | 602 @findex turn-on-lynx-emulation |
595 @findex w3-netscape-emulation-minor-mode | 603 @findex w3-netscape-emulation-minor-mode |
596 @findex w3-lynx-emulation-minor-mode | 604 @findex w3-lynx-emulation-minor-mode |
597 @vindex w3-mode-hook | 605 @vindex w3-mode-hook |
606 | |
598 :: WORK :: Document lynx emulation | 607 :: WORK :: Document lynx emulation |
599 @table @bullet | 608 @table @bullet |
600 @item Down arrow | 609 @item Down arrow |
601 Highlight next topic | 610 Highlight next topic |
602 @item Up arrow | 611 @item Up arrow |
722 | 731 |
723 @end example | 732 @end example |
724 | 733 |
725 @node Hotlist Handling, Session History, Emulation, Compatibility | 734 @node Hotlist Handling, Session History, Emulation, Compatibility |
726 @section Hotlist Handling | 735 @section Hotlist Handling |
736 | |
727 :: WORK :: Document that it supports different types of hotlist formats | 737 :: WORK :: Document that it supports different types of hotlist formats |
728 :: WORK :: Make sure everything hotlist related can be accessed via 'h' | 738 :: WORK :: Make sure everything hotlist related can be accessed via 'h' |
729 In order to avoid having to traverse many documents to get to the same | 739 In order to avoid having to traverse many documents to get to the same |
730 document over and over, Emacs-W3 supports a ``hotlist'' like Mosaic. This is | 740 document over and over, Emacs-W3 supports a ``hotlist'' like Mosaic. This is |
731 a file that contains @sc{url}s and aliases. Hotlists allow quick access to any | 741 a file that contains @sc{url}s and aliases. Hotlists allow quick access to any |
790 Appends another hotlist file to the one currently in memory. | 800 Appends another hotlist file to the one currently in memory. |
791 @end table | 801 @end table |
792 @node Session History, Global History, Hotlist Handling, Compatibility | 802 @node Session History, Global History, Hotlist Handling, Compatibility |
793 @section History | 803 @section History |
794 @cindex History Lists | 804 @cindex History Lists |
805 | |
795 Almost all web browsers keep track of the @sc{url}s followed from a page, so | 806 Almost all web browsers keep track of the @sc{url}s followed from a page, so |
796 that it can provide @b{forward} and @b{back} buttons to keep a @i{path} | 807 that it can provide @b{forward} and @b{back} buttons to keep a @i{path} |
797 of @sc{url}s that can be traversed easily. | 808 of @sc{url}s that can be traversed easily. |
809 | |
798 @vindex url-keep-history | 810 @vindex url-keep-history |
799 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3 | 811 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3 |
800 keeps a list of all the @sc{url}s visited in a session. | 812 keeps a list of all the @sc{url}s visited in a session. |
813 | |
801 @findex w3-show-history | 814 @findex w3-show-history |
802 To view a listing of the history for this session of Emacs-W3, use | 815 To view a listing of the history for this session of Emacs-W3, use |
803 @code{M-x w3-show-history} from any buffer, and Emacs-W3 generates an | 816 @code{M-x w3-show-history} from any buffer, and Emacs-W3 generates an |
804 @sc{html} document showing every @sc{url} visited since Emacs started (or | 817 @sc{html} document showing every @sc{url} visited since Emacs started (or |
805 cleared the history list), and then format it. Any of the links can | 818 cleared the history list), and then format it. Any of the links can |
815 from that buffer. This means that the user can go forwards and | 828 from that buffer. This means that the user can go forwards and |
816 backwards very easily along the path taken to reach a particular | 829 backwards very easily along the path taken to reach a particular |
817 document. To go forward, use the function @code{w3-forward-in-history}, | 830 document. To go forward, use the function @code{w3-forward-in-history}, |
818 to go backward, use the function @code{w3-backward-in-history}. | 831 to go backward, use the function @code{w3-backward-in-history}. |
819 | 832 |
820 @node Global History, Stylesheets, Session History, Compatibility | 833 @node Global History, , Session History, Compatibility |
821 @section Global History | 834 @section Global History |
835 | |
822 :: WORK :: Document that the global history can have diff. formats | 836 :: WORK :: Document that the global history can have diff. formats |
823 Most web browsers also support the idea of a ``history'' of @sc{url}s the | 837 Most web browsers also support the idea of a ``history'' of @sc{url}s the |
824 user has visited, and it displays them in a different style than normal | 838 user has visited, and it displays them in a different style than normal |
825 @sc{url}s. | 839 @sc{url}s. |
826 | 840 |
846 the @kbd{tab} or @kbd{space} key will show all completions for a | 860 the @kbd{tab} or @kbd{space} key will show all completions for a |
847 partial @sc{url}. This is very useful, especially for very long @sc{url}s that | 861 partial @sc{url}. This is very useful, especially for very long @sc{url}s that |
848 are not in a hotlist, or for seeing all the pages from a particular web | 862 are not in a hotlist, or for seeing all the pages from a particular web |
849 site before choosing which to retrieve. | 863 site before choosing which to retrieve. |
850 | 864 |
851 @node Stylesheets, Terminology, Global History, Top | 865 @node Stylesheets, Supported URLs, Compatibility, Top |
852 @chapter Stylesheets | 866 @chapter Stylesheets |
853 The way in which Emacs-W3 formats a document is very customizable. All | 867 The way in which Emacs-W3 formats a document is very customizable. All |
854 formatting is now controlled by a default stylesheet set by the user | 868 formatting is now controlled by a default stylesheet set by the user |
855 with the @code{w3-default-stylesheet} variable. Emacs-W3 currently | 869 with the @code{w3-default-stylesheet} variable. Emacs-W3 currently |
856 supports the @sc{W3C} recommendation for Cascading Style Sheets, Level 1 | 870 supports the @sc{W3C} recommendation for Cascading Style Sheets, Level 1 |
866 it should be very easy to look up what Emacs-W3 supports when browsing | 880 it should be very easy to look up what Emacs-W3 supports when browsing |
867 through the @sc{CSS1} specification. Please note that a lot of the text | 881 through the @sc{CSS1} specification. Please note that a lot of the text |
868 in the following sections comes directly from the specification as | 882 in the following sections comes directly from the specification as |
869 well. | 883 well. |
870 | 884 |
871 @ifinfo | |
872 @menu | 885 @menu |
873 * Terminology:: Terms used in the rest of this chapter. | 886 * Terminology:: Terms used in the rest of this chapter. |
874 * Basic Concepts:: Why are stylesheets useful? Getting started. | 887 * Basic Concepts:: Why are stylesheets useful? Getting started. |
875 * Pseudo-Classes/Elements:: Special classes for elements. | 888 * Pseudo-Classes/Elements:: Special classes for elements. |
876 * The Cascade:: How stylesheets are combined. | 889 * The Cascade:: How stylesheets are combined. |
877 * Properties:: What properties you can set on elements. | 890 * Properties:: What properties you can set on elements. |
878 * Units:: What you can set them to. | 891 * Units:: What you can set them to. |
879 @end menu | 892 @end menu |
880 @end ifinfo | |
881 | 893 |
882 @node Terminology, Basic Concepts, Stylesheets, Stylesheets | 894 @node Terminology, Basic Concepts, Stylesheets, Stylesheets |
883 @section Terminology | 895 @section Terminology |
884 | 896 |
885 @table @dfn | 897 @table @dfn |
976 The priority of a rule. | 988 The priority of a rule. |
977 @end table | 989 @end table |
978 | 990 |
979 @node Basic Concepts, Pseudo-Classes/Elements, Terminology, Stylesheets | 991 @node Basic Concepts, Pseudo-Classes/Elements, Terminology, Stylesheets |
980 @section Basic Concepts | 992 @section Basic Concepts |
993 | |
981 Designing simple style sheets is easy. One needs only to know a little | 994 Designing simple style sheets is easy. One needs only to know a little |
982 HTML and some basic desktop publishing terminology. E.g., to set the | 995 HTML and some basic desktop publishing terminology. E.g., to set the |
983 text color of 'H1' elements to blue, one can say: | 996 text color of 'H1' elements to blue, one can say: |
984 | 997 |
985 @example | 998 @example |
998 The selector is the link between the HTML document and the style sheet, and | 1011 The selector is the link between the HTML document and the style sheet, and |
999 all HTML element types are possible selectors. | 1012 all HTML element types are possible selectors. |
1000 | 1013 |
1001 @node Pseudo-Classes/Elements, The Cascade, Basic Concepts, Stylesheets | 1014 @node Pseudo-Classes/Elements, The Cascade, Basic Concepts, Stylesheets |
1002 @section Pseudo-Classes/Elements | 1015 @section Pseudo-Classes/Elements |
1016 | |
1003 In @sc{css1}, style is normally attached to an element based on its | 1017 In @sc{css1}, style is normally attached to an element based on its |
1004 position in the document structure. This simple model is sufficient for | 1018 position in the document structure. This simple model is sufficient for |
1005 a wide variety of styles, but doesn't cover some common effects. The | 1019 a wide variety of styles, but doesn't cover some common effects. The |
1006 concept of pseudo-classes and pseudo-elements extend addressing in | 1020 concept of pseudo-classes and pseudo-elements extend addressing in |
1007 @sc{css1} to allow external information to influence the formatting | 1021 @sc{css1} to allow external information to influence the formatting |
1206 assumed to be at the start of the author style sheet and may be | 1220 assumed to be at the start of the author style sheet and may be |
1207 overridden by subsequent style sheet rules. In a transition phase, this | 1221 overridden by subsequent style sheet rules. In a transition phase, this |
1208 policy will make it easier for stylistic attributes to coexist with | 1222 policy will make it easier for stylistic attributes to coexist with |
1209 style sheets. | 1223 style sheets. |
1210 | 1224 |
1211 @node Properties, Font Properties, The Cascade, Stylesheets | 1225 @node Properties, Units, The Cascade, Stylesheets |
1212 @section Properties | 1226 @section Properties |
1213 | 1227 |
1214 In the text below, the allowed values for each property are listed | 1228 In the text below, the allowed values for each property are listed |
1215 with a syntax like the following: | 1229 with a syntax like the following: |
1216 | 1230 |
1267 @item Applies to: @tab What type of elements this property can be attached to. | 1281 @item Applies to: @tab What type of elements this property can be attached to. |
1268 @item Inherited: @tab Yes or no | 1282 @item Inherited: @tab Yes or no |
1269 @item Percentage values: @tab What a percentage value applies to when given. | 1283 @item Percentage values: @tab What a percentage value applies to when given. |
1270 @end multitable | 1284 @end multitable |
1271 | 1285 |
1272 @ifinfo | |
1273 @menu | 1286 @menu |
1274 * Font Properties:: Selecting fonts, styles, and sizes. | 1287 * Font Properties:: Selecting fonts, styles, and sizes. |
1275 * Colors and Backgrounds:: Controlling colors, front and back. | 1288 * Colors and Backgrounds:: Controlling colors, front and back. |
1276 * Text Properties:: Alignment, decoration, and more! | 1289 * Text Properties:: Alignment, decoration, and more! |
1277 * Box Properties:: Borders, padding, and margins, oh my! | 1290 * Box Properties:: Borders, padding, and margins, oh my! |
1278 * Classification:: Changing whitespace and display policies. | 1291 * Classification:: Changing whitespace and display policies. |
1279 * Media Selection:: Conditionalize stylesheets on media-type. | 1292 * Media Selection:: Conditionalize stylesheets on media-type. |
1280 * Speech Properties:: Speech output controlled by stylesheets. | 1293 * Speech Properties:: Speech output controlled by stylesheets. |
1281 @end menu | 1294 @end menu |
1282 @end ifinfo | 1295 |
1283 | 1296 @node Font Properties, Colors and Backgrounds, Properties, Properties |
1284 @node Font Properties, font-family, Properties, Properties | |
1285 @subsection Font Properties | 1297 @subsection Font Properties |
1298 | |
1286 Setting font properties will be among the most common uses of style | 1299 Setting font properties will be among the most common uses of style |
1287 sheets. Unfortunately, there exists no well-defined and universally | 1300 sheets. Unfortunately, there exists no well-defined and universally |
1288 accepted taxonomy for classifying fonts, and terms that apply to one | 1301 accepted taxonomy for classifying fonts, and terms that apply to one |
1289 font family may not be appropriate for others. E.g. 'italic' is commonly | 1302 font family may not be appropriate for others. E.g. 'italic' is commonly |
1290 used to label slanted text, but slanted text may also be labeled as | 1303 used to label slanted text, but slanted text may also be labeled as |
1291 being @b{Oblique}, @b{Slanted}, @b{Incline}, @b{Cursive} or | 1304 being @b{Oblique}, @b{Slanted}, @b{Incline}, @b{Cursive} or |
1292 @b{Kursiv}. Therefore it is not a simple problem to map typical font | 1305 @b{Kursiv}. Therefore it is not a simple problem to map typical font |
1293 selection properties to a specific font. | 1306 selection properties to a specific font. |
1294 | 1307 |
1295 The properties defined by CSS1 are described in the following sections. | 1308 The properties defined by CSS1 are described in the following sections. |
1296 @ifinfo | |
1297 @menu | 1309 @menu |
1298 * font-family:: Groups of fonts. | 1310 * font-family:: Groups of fonts. |
1299 * font-style:: Normal, italic, or oblique? | 1311 * font-style:: Normal, italic, or oblique? |
1300 * font-variant:: Small-caps, etc. | 1312 * font-variant:: Small-caps, etc. |
1301 * font-weight:: How bold can you go? | 1313 * font-weight:: How bold can you go? |
1302 * font-size:: How big is yours? | 1314 * font-size:: How big is yours? |
1303 * font:: Shorthand for all of the above. | 1315 * font:: Shorthand for all of the above. |
1304 @end menu | 1316 @end menu |
1305 @end ifinfo | |
1306 | 1317 |
1307 @node font-family, font-style, Font Properties, Font Properties | 1318 @node font-family, font-style, Font Properties, Font Properties |
1308 @subsubsection font-family | 1319 @subsubsection font-family |
1309 | 1320 |
1310 @multitable @columnfractions .20 .8 | 1321 @multitable @columnfractions .20 .8 |
1541 @end example | 1552 @end example |
1542 | 1553 |
1543 If the suggested scaling factor of 1.5 is used, the last three | 1554 If the suggested scaling factor of 1.5 is used, the last three |
1544 declarations are identical. | 1555 declarations are identical. |
1545 | 1556 |
1546 @node font, Colors and Backgrounds, font-size, Font Properties | 1557 @node font, , font-size, Font Properties |
1547 @subsubsection font | 1558 @subsubsection font |
1548 | 1559 |
1549 @multitable @columnfractions .2 .8 | 1560 @multitable @columnfractions .2 .8 |
1550 @item Value: @tab [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height> ]? <font-family> | 1561 @item Value: @tab [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height> ]? <font-family> |
1551 @item Initial: @tab not defined for shorthand properties | 1562 @item Initial: @tab not defined for shorthand properties |
1585 (120% of the parent's font), the 'line-height' (120% times the font | 1596 (120% of the parent's font), the 'line-height' (120% times the font |
1586 size) and the 'font-family' ('fantasy'). It follows that the keyword | 1597 size) and the 'font-family' ('fantasy'). It follows that the keyword |
1587 'normal' applies to the two remaining properties: 'font-style' and | 1598 'normal' applies to the two remaining properties: 'font-style' and |
1588 'font-weight'. | 1599 'font-weight'. |
1589 | 1600 |
1590 @node Colors and Backgrounds, color, font, Properties | 1601 @node Colors and Backgrounds, Text Properties, Font Properties, Properties |
1591 @subsection Colors and Backgrounds | 1602 @subsection Colors and Backgrounds |
1603 | |
1592 These properties describe the color (often called foreground color) and | 1604 These properties describe the color (often called foreground color) and |
1593 background of an element (i.e. the surface onto which the content is | 1605 background of an element (i.e. the surface onto which the content is |
1594 rendered). One can set a background color and/or a background image. The | 1606 rendered). One can set a background color and/or a background image. The |
1595 position of the image, if/how it is repeated, and whether it is fixed or | 1607 position of the image, if/how it is repeated, and whether it is fixed or |
1596 scrolled relative to the canvas can also be set. | 1608 scrolled relative to the canvas can also be set. |
1601 'background-color'. | 1613 'background-color'. |
1602 | 1614 |
1603 NOTE: Currently, Emacs-W3 can only show background images under XEmacs. | 1615 NOTE: Currently, Emacs-W3 can only show background images under XEmacs. |
1604 Emacs 19 doesn't have the support in its display code yet. | 1616 Emacs 19 doesn't have the support in its display code yet. |
1605 | 1617 |
1606 @ifinfo | |
1607 @menu | 1618 @menu |
1608 * color:: Foreground colors. | 1619 * color:: Foreground colors. |
1609 * background-color:: Background colors. | 1620 * background-color:: Background colors. |
1610 * background-image:: Background images. | 1621 * background-image:: Background images. |
1611 * background-repeat:: Controlling repeating of background images. | 1622 * background-repeat:: Controlling repeating of background images. |
1612 * background-attachment:: Where background images are drawn. | 1623 * background-attachment:: Where background images are drawn. |
1613 * background-position:: Where background images are drawn. | 1624 * background-position:: Where background images are drawn. |
1614 * background:: Shorthand for all background properties. | 1625 * background:: Shorthand for all background properties. |
1615 @end menu | 1626 @end menu |
1616 @end ifinfo | |
1617 | 1627 |
1618 @node color, background-color, Colors and Backgrounds, Colors and Backgrounds | 1628 @node color, background-color, Colors and Backgrounds, Colors and Backgrounds |
1619 @subsubsection color | 1629 @subsubsection color |
1630 | |
1620 @multitable @columnfractions .2 .8 | 1631 @multitable @columnfractions .2 .8 |
1621 @item Value: @tab <color> | 1632 @item Value: @tab <color> |
1622 @item Initial: @tab User specific | 1633 @item Initial: @tab User specific |
1623 @item Applies to: @tab all elements | 1634 @item Applies to: @tab all elements |
1624 @item Inherited: @tab yes | 1635 @item Inherited: @tab yes |
1635 | 1646 |
1636 See @ref{Color Units} for a description of possible color values. | 1647 See @ref{Color Units} for a description of possible color values. |
1637 | 1648 |
1638 @node background-color, background-image, color, Colors and Backgrounds | 1649 @node background-color, background-image, color, Colors and Backgrounds |
1639 @subsubsection background-color | 1650 @subsubsection background-color |
1651 | |
1640 @multitable @columnfractions .2 .8 | 1652 @multitable @columnfractions .2 .8 |
1641 @item Value: @tab <color> | transparent | 1653 @item Value: @tab <color> | transparent |
1642 @item Initial: @tab transparent | 1654 @item Initial: @tab transparent |
1643 @item Applies to: @tab all elements | 1655 @item Applies to: @tab all elements |
1644 @item Inherited: @tab no | 1656 @item Inherited: @tab no |
1651 H1 @{ background-color: #F00 @} | 1663 H1 @{ background-color: #F00 @} |
1652 @end example | 1664 @end example |
1653 | 1665 |
1654 @node background-image, background-repeat, background-color, Colors and Backgrounds | 1666 @node background-image, background-repeat, background-color, Colors and Backgrounds |
1655 @subsubsection background-image | 1667 @subsubsection background-image |
1668 | |
1656 @multitable @columnfractions .2 .8 | 1669 @multitable @columnfractions .2 .8 |
1657 @item Value: @tab <url> | none | 1670 @item Value: @tab <url> | none |
1658 @item Initial: @tab none | 1671 @item Initial: @tab none |
1659 @item Applies to: @tab all elements | 1672 @item Applies to: @tab all elements |
1660 @item Inherited: @tab no | 1673 @item Inherited: @tab no |
1671 P @{ background-image: none @} | 1684 P @{ background-image: none @} |
1672 @end example | 1685 @end example |
1673 | 1686 |
1674 @node background-repeat, background-attachment, background-image, Colors and Backgrounds | 1687 @node background-repeat, background-attachment, background-image, Colors and Backgrounds |
1675 @subsubsection background-repeat | 1688 @subsubsection background-repeat |
1689 | |
1676 This property is not supported at all under Emacs-W3. | 1690 This property is not supported at all under Emacs-W3. |
1677 | 1691 |
1678 @node background-attachment, background-position, background-repeat, Colors and Backgrounds | 1692 @node background-attachment, background-position, background-repeat, Colors and Backgrounds |
1679 @subsubsection background-attachment | 1693 @subsubsection background-attachment |
1694 | |
1680 This property is not supported at all under Emacs-W3. | 1695 This property is not supported at all under Emacs-W3. |
1681 | 1696 |
1682 @node background-position, background, background-attachment, Colors and Backgrounds | 1697 @node background-position, background, background-attachment, Colors and Backgrounds |
1683 @subsubsection background-position | 1698 @subsubsection background-position |
1699 | |
1684 This property is not supported at all under Emacs-W3. | 1700 This property is not supported at all under Emacs-W3. |
1685 | 1701 |
1686 @node background, Text Properties, background-position, Colors and Backgrounds | 1702 @node background, , background-position, Colors and Backgrounds |
1687 @subsubsection background | 1703 @subsubsection background |
1704 | |
1688 @multitable @columnfractions .2 .8 | 1705 @multitable @columnfractions .2 .8 |
1689 @item Value: @tab <background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position> | 1706 @item Value: @tab <background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position> |
1690 @item Initial: @tab not defined for shorthand properties | 1707 @item Initial: @tab not defined for shorthand properties |
1691 @item Applies to: @tab all elements | 1708 @item Applies to: @tab all elements |
1692 @item Inherited: @tab no | 1709 @item Inherited: @tab no |
1710 properties. In the first rule of the above example, only a value for | 1727 properties. In the first rule of the above example, only a value for |
1711 'background-color' has been given and the other individual properties | 1728 'background-color' has been given and the other individual properties |
1712 are set to their initial value. In the second rule, all individual | 1729 are set to their initial value. In the second rule, all individual |
1713 properties have been specified. | 1730 properties have been specified. |
1714 | 1731 |
1715 @node Text Properties, word-spacing, background, Properties | 1732 @node Text Properties, Box Properties, Colors and Backgrounds, Properties |
1716 @subsection Text Properties | 1733 @subsection Text Properties |
1717 | 1734 |
1718 @ifinfo | |
1719 @menu | 1735 @menu |
1720 * word-spacing:: | 1736 * word-spacing:: |
1721 * letter-spacing:: | 1737 * letter-spacing:: |
1722 * text-decoration:: | 1738 * text-decoration:: |
1723 * vertical-align:: | 1739 * vertical-align:: |
1724 * text-transform:: | 1740 * text-transform:: |
1725 * text-align:: | 1741 * text-align:: |
1726 * text-indent:: | 1742 * text-indent:: |
1727 * line-height:: | 1743 * line-height:: |
1728 @end menu | 1744 @end menu |
1729 @end ifinfo | |
1730 | 1745 |
1731 @node word-spacing, letter-spacing, Text Properties, Text Properties | 1746 @node word-spacing, letter-spacing, Text Properties, Text Properties |
1732 @subsubsection word-spacing | 1747 @subsubsection word-spacing |
1748 | |
1733 @multitable @columnfractions .2 .8 | 1749 @multitable @columnfractions .2 .8 |
1734 @item Supported Values: @tab normal | 1750 @item Supported Values: @tab normal |
1735 @item Unsupported Values: @tab <length> | 1751 @item Unsupported Values: @tab <length> |
1736 @item Initial: @tab normal | 1752 @item Initial: @tab normal |
1737 @item Applies to: @tab all elements | 1753 @item Applies to: @tab all elements |
1755 NOTE: Emacs-W3 cannot currently support this, due to limitations in | 1771 NOTE: Emacs-W3 cannot currently support this, due to limitations in |
1756 Emacs. It may be implemented in the future. | 1772 Emacs. It may be implemented in the future. |
1757 | 1773 |
1758 @node letter-spacing, text-decoration, word-spacing, Text Properties | 1774 @node letter-spacing, text-decoration, word-spacing, Text Properties |
1759 @subsubsection letter-spacing | 1775 @subsubsection letter-spacing |
1760 @multitable @columnfractions .2 .8 | 1776 |
1761 @item Supported Values: normal | 1777 @multitable @columnfractions .2 .8 |
1778 @item Supported Values: @tab normal | |
1762 @item Unsupported Values: @tab <length> | 1779 @item Unsupported Values: @tab <length> |
1763 @item Initial: @tab normal | 1780 @item Initial: @tab normal |
1764 @item Applies to: @tab all elements | 1781 @item Applies to: @tab all elements |
1765 @item Inherited: @tab yes | 1782 @item Inherited: @tab yes |
1766 @item Percentage values: @tab N/A | 1783 @item Percentage values: @tab N/A |
1780 would be increased by '0.1em'. | 1797 would be increased by '0.1em'. |
1781 | 1798 |
1782 NOTE: Emacs-W3 cannot currently support this, due to limitations in | 1799 NOTE: Emacs-W3 cannot currently support this, due to limitations in |
1783 Emacs. It may be implemented in the future. | 1800 Emacs. It may be implemented in the future. |
1784 | 1801 |
1785 @node text-decoration, vertical-align, letter-spacing , Text Properties | 1802 @node text-decoration, vertical-align, letter-spacing, Text Properties |
1786 @subsubsection text-decoration | 1803 @subsubsection text-decoration |
1804 | |
1787 @multitable @columnfractions .2 .8 | 1805 @multitable @columnfractions .2 .8 |
1788 @item Supported Values: @tab none | underline | line-through | blink | 1806 @item Supported Values: @tab none | underline | line-through | blink |
1789 @item Unsupported Values: @tab overline | 1807 @item Unsupported Values: @tab overline |
1790 @item Initial: @tab none | 1808 @item Initial: @tab none |
1791 @item Applies to: @tab all elements | 1809 @item Applies to: @tab all elements |
1818 support for this, but it has not made it into the main distribution | 1836 support for this, but it has not made it into the main distribution |
1819 yet. | 1837 yet. |
1820 | 1838 |
1821 @node vertical-align, text-transform, text-decoration, Text Properties | 1839 @node vertical-align, text-transform, text-decoration, Text Properties |
1822 @subsubsection vertical-align | 1840 @subsubsection vertical-align |
1841 | |
1823 This is currently unsupported in Emacs-W3. | 1842 This is currently unsupported in Emacs-W3. |
1824 | 1843 |
1825 @node text-transform, text-align, vertical-align, Text Properties | 1844 @node text-transform, text-align, vertical-align, Text Properties |
1826 @subsubsection text-transform | 1845 @subsubsection text-transform |
1846 | |
1827 @multitable @columnfractions .2 .8 | 1847 @multitable @columnfractions .2 .8 |
1828 @item Supported Values: @tab none | 1848 @item Supported Values: @tab none |
1829 @item Unsupported Values: @tab capitalize | uppercase | lowercase | 1849 @item Unsupported Values: @tab capitalize | uppercase | lowercase |
1830 @item Initial: @tab none | 1850 @item Initial: @tab none |
1831 @item Applies to: @tab all elements | 1851 @item Applies to: @tab all elements |
1856 not been reimplemented in the new display code yet. Please feel free to | 1876 not been reimplemented in the new display code yet. Please feel free to |
1857 send me patches. | 1877 send me patches. |
1858 | 1878 |
1859 @node text-align, text-indent, text-transform, Text Properties | 1879 @node text-align, text-indent, text-transform, Text Properties |
1860 @subsubsection text-align | 1880 @subsubsection text-align |
1881 | |
1861 @multitable @columnfractions .2 .8 | 1882 @multitable @columnfractions .2 .8 |
1862 @item Value: @tab left | right | center | justify | 1883 @item Value: @tab left | right | center | justify |
1863 @item Initial: @tab User specific | 1884 @item Initial: @tab User specific |
1864 @item Applies to: @tab block-level elements | 1885 @item Applies to: @tab block-level elements |
1865 @item Inherited: @tab yes | 1886 @item Inherited: @tab yes |
1878 element with 'CLASS=center' will be centered. Note that alignments are | 1899 element with 'CLASS=center' will be centered. Note that alignments are |
1879 relative to the width of the element, not the canvas. | 1900 relative to the width of the element, not the canvas. |
1880 | 1901 |
1881 @node text-indent, line-height, text-align, Text Properties | 1902 @node text-indent, line-height, text-align, Text Properties |
1882 @subsubsection text-indent | 1903 @subsubsection text-indent |
1904 | |
1883 Not currently implemented in Emacs-W3. | 1905 Not currently implemented in Emacs-W3. |
1884 | 1906 |
1885 @node line-height, Box Properties, text-indent, Text Properties | 1907 @node line-height, , text-indent, Text Properties |
1886 @subsubsection line-height | 1908 @subsubsection line-height |
1909 | |
1887 Not currently implemented in Emacs-W3. | 1910 Not currently implemented in Emacs-W3. |
1888 | 1911 |
1889 @node Box Properties, Classification, line-height, Properties | 1912 @node Box Properties, Classification, Text Properties, Properties |
1890 @subsection Box Properties | 1913 @subsection Box Properties |
1891 @multitable @columnfractions .2 .8 | 1914 |
1892 @end multitable | 1915 @multitable @columnfractions .2 .8 |
1893 | 1916 @end multitable |
1894 @node Classification, display, Box Properties, Properties | 1917 |
1918 @node Classification, Media Selection, Box Properties, Properties | |
1895 @subsection Classification | 1919 @subsection Classification |
1920 | |
1896 These properties classify elements into categories more than they set | 1921 These properties classify elements into categories more than they set |
1897 specific visual parameters. | 1922 specific visual parameters. |
1898 | 1923 |
1899 The list-style properties describe how list items (i.e. elements with a | 1924 The list-style properties describe how list items (i.e. elements with a |
1900 'display' value of 'list-item') are formatted. The list-style properties | 1925 'display' value of 'list-item') are formatted. The list-style properties |
1901 can be set on any element, and it will inherit normally down the | 1926 can be set on any element, and it will inherit normally down the |
1902 tree. However, they will only be have effect on elements with a | 1927 tree. However, they will only be have effect on elements with a |
1903 'display' value of 'list-item'. In HTML this is typically the case for | 1928 'display' value of 'list-item'. In HTML this is typically the case for |
1904 the 'LI' element. | 1929 the 'LI' element. |
1905 | 1930 |
1906 @ifinfo | |
1907 @menu | 1931 @menu |
1908 * display:: | 1932 * display:: |
1909 * white-space:: | 1933 * white-space:: |
1910 * list-style-type:: | 1934 * list-style-type:: |
1911 * list-style-image:: | 1935 * list-style-image:: |
1912 * list-style-position:: | 1936 * list-style-position:: |
1913 * list-style:: | 1937 * list-style:: |
1914 @end menu | 1938 @end menu |
1915 @end ifinfo | |
1916 | 1939 |
1917 @node display, white-space, Classification, Classification | 1940 @node display, white-space, Classification, Classification |
1918 @subsubsection display | 1941 @subsubsection display |
1942 | |
1919 @multitable @columnfractions .2 .8 | 1943 @multitable @columnfractions .2 .8 |
1920 @item Value: @tab block | inline | list-item | none | 1944 @item Value: @tab block | inline | list-item | none |
1921 @item Extensions: @tab line | 1945 @item Extensions: @tab line |
1922 @item Initial: @tab inline | 1946 @item Initial: @tab inline |
1923 @item Applies to: @tab all elements | 1947 @item Applies to: @tab all elements |
1955 NOTE: Emacs-W3 defaults to using 'inline' for this property, which is a | 1979 NOTE: Emacs-W3 defaults to using 'inline' for this property, which is a |
1956 slight deviation from the specification. | 1980 slight deviation from the specification. |
1957 | 1981 |
1958 @node white-space, list-style-type, display, Classification | 1982 @node white-space, list-style-type, display, Classification |
1959 @subsubsection white-space | 1983 @subsubsection white-space |
1984 | |
1960 @multitable @columnfractions .2 .8 | 1985 @multitable @columnfractions .2 .8 |
1961 @item Value: @tab normal | pre | nowrap | 1986 @item Value: @tab normal | pre | nowrap |
1962 @item Initial: @tab normal | 1987 @item Initial: @tab normal |
1963 @item Applies to: @tab block-level elements | 1988 @item Applies to: @tab block-level elements |
1964 @item Inherited: @tab yes | 1989 @item Inherited: @tab yes |
1975 P @{ white-space: normal @} | 2000 P @{ white-space: normal @} |
1976 @end example | 2001 @end example |
1977 | 2002 |
1978 @node list-style-type, list-style-image, white-space, Classification | 2003 @node list-style-type, list-style-image, white-space, Classification |
1979 @subsubsection list-style-type | 2004 @subsubsection list-style-type |
2005 | |
1980 @multitable @columnfractions .2 .8 | 2006 @multitable @columnfractions .2 .8 |
1981 @item Value: @tab disc | circle | square | decimal | lower-roman | upper-roman | lower-alpha | upper-alpha | none | 2007 @item Value: @tab disc | circle | square | decimal | lower-roman | upper-roman | lower-alpha | upper-alpha | none |
1982 @item Initial: @tab disc | 2008 @item Initial: @tab disc |
1983 @item Applies to: @tab elements with 'display' value 'list-item' | 2009 @item Applies to: @tab elements with 'display' value 'list-item' |
1984 @item Inherited: @tab yes | 2010 @item Inherited: @tab yes |
1996 OL @{ list-style-type: lower-roman @} /* i ii iii iv v etc. */ | 2022 OL @{ list-style-type: lower-roman @} /* i ii iii iv v etc. */ |
1997 @end example | 2023 @end example |
1998 | 2024 |
1999 @node list-style-image, list-style-position, list-style-type, Classification | 2025 @node list-style-image, list-style-position, list-style-type, Classification |
2000 @subsubsection list-style-image | 2026 @subsubsection list-style-image |
2027 | |
2001 @multitable @columnfractions .2 .8 | 2028 @multitable @columnfractions .2 .8 |
2002 @item Value: @tab <url> | none | 2029 @item Value: @tab <url> | none |
2003 @item Initial: @tab none | 2030 @item Initial: @tab none |
2004 @item Applies to: @tab elements with 'display' value 'list-item' | 2031 @item Applies to: @tab elements with 'display' value 'list-item' |
2005 @item Inherited: @tab yes | 2032 @item Inherited: @tab yes |
2016 UL @{ list-style-image: url(http://png.com/ellipse.png) @} | 2043 UL @{ list-style-image: url(http://png.com/ellipse.png) @} |
2017 @end example | 2044 @end example |
2018 | 2045 |
2019 @node list-style-position, list-style, list-style-image, Classification | 2046 @node list-style-position, list-style, list-style-image, Classification |
2020 @subsubsection list-style-position | 2047 @subsubsection list-style-position |
2048 | |
2021 @multitable @columnfractions .2 .8 | 2049 @multitable @columnfractions .2 .8 |
2022 @item Supported Values: @tab outside | 2050 @item Supported Values: @tab outside |
2023 @item Unsupported Values: @tab inside | 2051 @item Unsupported Values: @tab inside |
2024 @item Initial: @tab outside | 2052 @item Initial: @tab outside |
2025 @item Applies to: @tab elements with 'display' value 'list-item' | 2053 @item Applies to: @tab elements with 'display' value 'list-item' |
2029 | 2057 |
2030 The value of 'list-style-position' determines how the list-item marker | 2058 The value of 'list-style-position' determines how the list-item marker |
2031 is drawn with regard to the content. For a formatting example see | 2059 is drawn with regard to the content. For a formatting example see |
2032 section 4.1.3. | 2060 section 4.1.3. |
2033 | 2061 |
2034 @node list-style, Media Selection, list-style-position, Classification | 2062 @node list-style, , list-style-position, Classification |
2035 @subsubsection list-style | 2063 @subsubsection list-style |
2036 @multitable @columnfractions .2 .8 | 2064 |
2037 @item Value: <keyword> || <position> || <url> | 2065 @multitable @columnfractions .2 .8 |
2066 @item Value: @tab <keyword> || <position> || <url> | |
2038 @item Initial: @tab not defined for shorthand properties | 2067 @item Initial: @tab not defined for shorthand properties |
2039 @item Applies to: @tab elements with 'display' value 'list-item' | 2068 @item Applies to: @tab elements with 'display' value 'list-item' |
2040 @item Inherited: @tab yes | 2069 @item Inherited: @tab yes |
2041 @item Percentage values: @tab N/A | 2070 @item Percentage values: @tab N/A |
2042 @end multitable | 2071 @end multitable |
2090 @end example | 2119 @end example |
2091 | 2120 |
2092 In the example above, the 'disc' will be used when the image is | 2121 In the example above, the 'disc' will be used when the image is |
2093 unavailable. | 2122 unavailable. |
2094 | 2123 |
2095 @node Media Selection, Speech Properties, list-style, Properties | 2124 @node Media Selection, Speech Properties, Classification, Properties |
2096 @subsection Media Selection | 2125 @subsection Media Selection |
2126 | |
2097 To specify that a stylesheet declaration should only apply when using a | 2127 To specify that a stylesheet declaration should only apply when using a |
2098 certain media type (ie: different font families preferred when printing | 2128 certain media type (ie: different font families preferred when printing |
2099 versus on-screen presentation), the declarations should be wrapped in | 2129 versus on-screen presentation), the declarations should be wrapped in |
2100 the proposed @b{@@media} directive. | 2130 the proposed @b{@@media} directive. |
2101 | 2131 |
2139 The stylesheet will only be applied if the user is running in XEmacs 19. | 2169 The stylesheet will only be applied if the user is running in XEmacs 19. |
2140 @item All | 2170 @item All |
2141 The default value, the style sheet applies to all output devices | 2171 The default value, the style sheet applies to all output devices |
2142 @end table | 2172 @end table |
2143 | 2173 |
2144 @node Speech Properties, volume, Media Selection, Properties | 2174 @node Speech Properties, , Media Selection, Properties |
2145 @subsection Speech Properties | 2175 @subsection Speech Properties |
2176 | |
2146 Those of us who are sighted are accustomed to visual presentation of | 2177 Those of us who are sighted are accustomed to visual presentation of |
2147 @sc{html} documents, frequently on a bitmapped display. This is not the | 2178 @sc{html} documents, frequently on a bitmapped display. This is not the |
2148 only possible presentation method, however. Aural presentation, using a | 2179 only possible presentation method, however. Aural presentation, using a |
2149 combination of speech synthesis and 'audio icons', provides an | 2180 combination of speech synthesis and 'audio icons', provides an |
2150 alternative presentation. This form of presentation is in current use by | 2181 alternative presentation. This form of presentation is in current use by |
2168 @item | 2199 @item |
2169 Allows browsers to optionally implement both aural and visual views to | 2200 Allows browsers to optionally implement both aural and visual views to |
2170 produce truly multimodal documents. | 2201 produce truly multimodal documents. |
2171 @end itemize | 2202 @end itemize |
2172 | 2203 |
2173 @ifinfo | |
2174 @menu | 2204 @menu |
2175 * volume:: | 2205 * volume:: |
2176 * pause-before:: | 2206 * pause-before:: |
2177 * pause-after:: | 2207 * pause-after:: |
2178 * pause:: | 2208 * pause:: |
2179 * cue-before:: | 2209 * cue-before:: |
2180 * cue-after:: | 2210 * cue-after:: |
2181 * cue:: | 2211 * cue:: |
2182 * play-during:: | 2212 * play-during:: |
2183 * speed:: | 2213 * speed:: |
2184 * voice-family:: | 2214 * voice-family:: |
2185 * pitch:: | 2215 * pitch:: |
2186 * pitch-range:: | 2216 * pitch-range:: |
2187 * stress:: | 2217 * stress:: |
2188 * richness:: | 2218 * richness:: |
2189 * speak-punctuation:: | 2219 * speak-punctuation:: |
2190 * speak-date:: | 2220 * speak-date:: |
2191 * speak-numeral:: | 2221 * speak-numeral:: |
2192 * speak-time:: | 2222 * speak-time:: |
2193 @end menu | 2223 @end menu |
2194 @end ifinfo | |
2195 | 2224 |
2196 @node volume, pause-before, Speech Properties, Speech Properties | 2225 @node volume, pause-before, Speech Properties, Speech Properties |
2197 @subsubsection volume | 2226 @subsubsection volume |
2227 | |
2198 @multitable @columnfractions .2 .8 | 2228 @multitable @columnfractions .2 .8 |
2199 @item Value: @tab <percentage> | mute | x-soft | soft | medium | loud | x-loud | 2229 @item Value: @tab <percentage> | mute | x-soft | soft | medium | loud | x-loud |
2200 @item Initial: @tab medium | 2230 @item Initial: @tab medium |
2201 @item Applies to: @tab all elements | 2231 @item Applies to: @tab all elements |
2202 @item Inherited: @tab yes | 2232 @item Inherited: @tab yes |
2249 The same authors stylesheet could be used in all cases, simply by | 2279 The same authors stylesheet could be used in all cases, simply by |
2250 mapping the 0 and 100 points suitably at the client side. | 2280 mapping the 0 and 100 points suitably at the client side. |
2251 | 2281 |
2252 @node pause-before, pause-after, volume, Speech Properties | 2282 @node pause-before, pause-after, volume, Speech Properties |
2253 @subsubsection pause-before | 2283 @subsubsection pause-before |
2284 | |
2254 @multitable @columnfractions .2 .8 | 2285 @multitable @columnfractions .2 .8 |
2255 @item Value: @tab <time> | <percentage> | 2286 @item Value: @tab <time> | <percentage> |
2256 @item Initial: @tab UA specific | 2287 @item Initial: @tab UA specific |
2257 @item Applies to: @tab all elements | 2288 @item Applies to: @tab all elements |
2258 @item Inherited: @tab no | 2289 @item Inherited: @tab no |
2269 Using relative units gives more robust stylesheets in the face of large | 2300 Using relative units gives more robust stylesheets in the face of large |
2270 changes in speed. | 2301 changes in speed. |
2271 | 2302 |
2272 @node pause-after, pause, pause-before, Speech Properties | 2303 @node pause-after, pause, pause-before, Speech Properties |
2273 @subsubsection pause-after | 2304 @subsubsection pause-after |
2305 | |
2274 @multitable @columnfractions .2 .8 | 2306 @multitable @columnfractions .2 .8 |
2275 @item Value: @tab <time> | <percentage> | 2307 @item Value: @tab <time> | <percentage> |
2276 @item Applies to: @tab all elements | 2308 @item Applies to: @tab all elements |
2277 @item Inherited: @tab no | 2309 @item Inherited: @tab no |
2278 @item Percentage values: @tab speed | 2310 @item Percentage values: @tab speed |
2281 This property specifies the pause after elements. Values are specified | 2313 This property specifies the pause after elements. Values are specified |
2282 the same way as 'pause-before'. | 2314 the same way as 'pause-before'. |
2283 | 2315 |
2284 @node pause, cue-before, pause-after, Speech Properties | 2316 @node pause, cue-before, pause-after, Speech Properties |
2285 @subsubsection pause | 2317 @subsubsection pause |
2318 | |
2286 @multitable @columnfractions .2 .8 | 2319 @multitable @columnfractions .2 .8 |
2287 @item Value: @tab [<time> | <percentage> ]@{1,2@}; | 2320 @item Value: @tab [<time> | <percentage> ]@{1,2@}; |
2288 @item Applies to: @tab all elements | 2321 @item Applies to: @tab all elements |
2289 @item Inherited: @tab no | 2322 @item Inherited: @tab no |
2290 @item Percentage values: @tab speed | 2323 @item Percentage values: @tab speed |
2302 H3 @{ pause-after: 10ms @} /* pause-before: ?; pause-after: 10ms */ | 2335 H3 @{ pause-after: 10ms @} /* pause-before: ?; pause-after: 10ms */ |
2303 @end example | 2336 @end example |
2304 | 2337 |
2305 @node cue-before, cue-after, pause, Speech Properties | 2338 @node cue-before, cue-after, pause, Speech Properties |
2306 @subsubsection cue-before | 2339 @subsubsection cue-before |
2340 | |
2307 @multitable @columnfractions .2 .8 | 2341 @multitable @columnfractions .2 .8 |
2308 @item Value: @tab <url> | none | 2342 @item Value: @tab <url> | none |
2309 @item Initial: @tab none | 2343 @item Initial: @tab none |
2310 @item Applies to: @tab all elements | 2344 @item Applies to: @tab all elements |
2311 @item Inherited: @tab no | 2345 @item Inherited: @tab no |
2322 H1 @{ cue: url(pop.au) @} /* same as previous */ | 2356 H1 @{ cue: url(pop.au) @} /* same as previous */ |
2323 @end example | 2357 @end example |
2324 | 2358 |
2325 @node cue-after, cue, cue-before, Speech Properties | 2359 @node cue-after, cue, cue-before, Speech Properties |
2326 @subsubsection cue-after | 2360 @subsubsection cue-after |
2361 | |
2327 @xref{cue-before} | 2362 @xref{cue-before} |
2328 | 2363 |
2329 @node cue, play-during, cue-after, Speech Properties | 2364 @node cue, play-during, cue-after, Speech Properties |
2330 @subsubsection cue | 2365 @subsubsection cue |
2366 | |
2331 @xref{cue-before} | 2367 @xref{cue-before} |
2332 | 2368 |
2333 @node play-during, speed, cue, Speech Properties | 2369 @node play-during, speed, cue, Speech Properties |
2334 @subsubsection cue-during | 2370 @subsubsection cue-during |
2371 | |
2335 @multitable @columnfractions .2 .8 | 2372 @multitable @columnfractions .2 .8 |
2336 @item Value: @tab <url> | mix | none | 2373 @item Value: @tab <url> | mix | none |
2337 @item Initial: @tab mix | 2374 @item Initial: @tab mix |
2338 @item Applies to: @tab all elements | 2375 @item Applies to: @tab all elements |
2339 @item Inherited: @tab no | 2376 @item Inherited: @tab no |
2348 BLOCKQUOTE.sad @{ cue-during: url(violins.aiff) @} | 2385 BLOCKQUOTE.sad @{ cue-during: url(violins.aiff) @} |
2349 @end example | 2386 @end example |
2350 | 2387 |
2351 @node speed, voice-family, play-during, Speech Properties | 2388 @node speed, voice-family, play-during, Speech Properties |
2352 @subsubsection speed | 2389 @subsubsection speed |
2390 | |
2353 @multitable @columnfractions .2 .8 | 2391 @multitable @columnfractions .2 .8 |
2354 @item Value: @tab <words-per-minute> | x-slow | slow | medium | fast | x-fast | faster | slower | 2392 @item Value: @tab <words-per-minute> | x-slow | slow | medium | fast | x-fast | faster | slower |
2355 @item Initial: @tab medium | 2393 @item Initial: @tab medium |
2356 @item Applies to: @tab all elements | 2394 @item Applies to: @tab all elements |
2357 @item Inherited: @tab yes | 2395 @item Inherited: @tab yes |
2360 Specifies the speaking rate. Note that both absolute and relative | 2398 Specifies the speaking rate. Note that both absolute and relative |
2361 keyword values are allowed (compare with @ref{font-weight}). | 2399 keyword values are allowed (compare with @ref{font-weight}). |
2362 | 2400 |
2363 @node voice-family, pitch, speed, Speech Properties | 2401 @node voice-family, pitch, speed, Speech Properties |
2364 @subsubsection voice-family | 2402 @subsubsection voice-family |
2403 | |
2365 @multitable @columnfractions .2 .8 | 2404 @multitable @columnfractions .2 .8 |
2366 @item Value: @tab [[<specific-voice> | <generic-voice>],]* [<specific-voice> | <generic-voice>] | 2405 @item Value: @tab [[<specific-voice> | <generic-voice>],]* [<specific-voice> | <generic-voice>] |
2367 @item Initial: @tab device-specific | 2406 @item Initial: @tab device-specific |
2368 @item Applies to: @tab all elements | 2407 @item Applies to: @tab all elements |
2369 @item Inherited: @tab yes | 2408 @item Inherited: @tab yes |
2382 P.part.juliet @{ voice-family: juliet, female @} | 2421 P.part.juliet @{ voice-family: juliet, female @} |
2383 @end example | 2422 @end example |
2384 | 2423 |
2385 @node pitch, pitch-range, voice-family, Speech Properties | 2424 @node pitch, pitch-range, voice-family, Speech Properties |
2386 @subsubsection pitch | 2425 @subsubsection pitch |
2426 | |
2387 @multitable @columnfractions .2 .8 | 2427 @multitable @columnfractions .2 .8 |
2388 @end multitable | 2428 @end multitable |
2389 | 2429 |
2390 @node pitch-range, stress, pitch, Speech Properties | 2430 @node pitch-range, stress, pitch, Speech Properties |
2391 @subsubsection pitch-range | 2431 @subsubsection pitch-range |
2432 | |
2392 @multitable @columnfractions .2 .8 | 2433 @multitable @columnfractions .2 .8 |
2393 @end multitable | 2434 @end multitable |
2394 | 2435 |
2395 @node stress, richness, pitch-range, Speech Properties | 2436 @node stress, richness, pitch-range, Speech Properties |
2396 @subsubsection stress | 2437 @subsubsection stress |
2438 | |
2397 @multitable @columnfractions .2 .8 | 2439 @multitable @columnfractions .2 .8 |
2398 @item Value: @tab <percentage> | 2440 @item Value: @tab <percentage> |
2399 @item Initial: @tab medium | 2441 @item Initial: @tab medium |
2400 @item Applies to: @tab all elements | 2442 @item Applies to: @tab all elements |
2401 @item Inherited: @tab yes | 2443 @item Inherited: @tab yes |
2411 strongly inflected. It is in a sense dual to property 'pitch-range' and | 2453 strongly inflected. It is in a sense dual to property 'pitch-range' and |
2412 is provided to allow developers to exploit higher-end auditory displays. | 2454 is provided to allow developers to exploit higher-end auditory displays. |
2413 | 2455 |
2414 @node richness, speak-punctuation, stress, Speech Properties | 2456 @node richness, speak-punctuation, stress, Speech Properties |
2415 @subsubsection richness | 2457 @subsubsection richness |
2458 | |
2416 @multitable @columnfractions .2 .8 | 2459 @multitable @columnfractions .2 .8 |
2417 @item Value: @tab <percentage> | 2460 @item Value: @tab <percentage> |
2418 @item Initial: @tab medium (50%) | 2461 @item Initial: @tab medium (50%) |
2419 @item Applies to: @tab all elements | 2462 @item Applies to: @tab all elements |
2420 @item Inherited: @tab yes | 2463 @item Inherited: @tab yes |
2427 The effect of increasing richness is to produce a voice that carries -- | 2470 The effect of increasing richness is to produce a voice that carries -- |
2428 reducing richness produces a soft, mellifluous voice. | 2471 reducing richness produces a soft, mellifluous voice. |
2429 | 2472 |
2430 @node speak-punctuation, speak-date, richness, Speech Properties | 2473 @node speak-punctuation, speak-date, richness, Speech Properties |
2431 @subsubsection speak-punctuation | 2474 @subsubsection speak-punctuation |
2475 | |
2432 @multitable @columnfractions .2 .8 | 2476 @multitable @columnfractions .2 .8 |
2433 @item Value: @tab code | none | 2477 @item Value: @tab code | none |
2434 @item Initial: @tab none | 2478 @item Initial: @tab none |
2435 @item Applies to: @tab all elements | 2479 @item Applies to: @tab all elements |
2436 @item Inherited: @tab yes | 2480 @item Inherited: @tab yes |
2441 punctuation is not spoken but instead is rendered naturally as various | 2485 punctuation is not spoken but instead is rendered naturally as various |
2442 pauses. | 2486 pauses. |
2443 | 2487 |
2444 @node speak-date, speak-numeral, speak-punctuation, Speech Properties | 2488 @node speak-date, speak-numeral, speak-punctuation, Speech Properties |
2445 @subsubsection speak-date | 2489 @subsubsection speak-date |
2490 | |
2446 @multitable @columnfractions .2 .8 | 2491 @multitable @columnfractions .2 .8 |
2447 @item Value: @tab myd | dmy | ymd | none | 2492 @item Value: @tab myd | dmy | ymd | none |
2448 @item Initial: @tab none | 2493 @item Initial: @tab none |
2449 @item Applies to: @tab all elements | 2494 @item Applies to: @tab all elements |
2450 @item Inherited: @tab no | 2495 @item Inherited: @tab no |
2457 This should really be an HTML tag not a stylesheet property, since it | 2502 This should really be an HTML tag not a stylesheet property, since it |
2458 gives semantic information about the content. | 2503 gives semantic information about the content. |
2459 | 2504 |
2460 @node speak-numeral, speak-time, speak-date, Speech Properties | 2505 @node speak-numeral, speak-time, speak-date, Speech Properties |
2461 @subsubsection speak-numeral | 2506 @subsubsection speak-numeral |
2507 | |
2462 @multitable @columnfractions .2 .8 | 2508 @multitable @columnfractions .2 .8 |
2463 @item Value: @tab digits | continous | 2509 @item Value: @tab digits | continous |
2464 @item Initial: @tab none | 2510 @item Initial: @tab none |
2465 @item Applies to: @tab all elements | 2511 @item Applies to: @tab all elements |
2466 @item Inherited: @tab yes | 2512 @item Inherited: @tab yes |
2467 @end multitable | 2513 @end multitable |
2468 | 2514 |
2469 @node speak-time, Units, speak-numeral, Speech Properties | 2515 @node speak-time, , speak-numeral, Speech Properties |
2470 @subsubsection speak-time | 2516 @subsubsection speak-time |
2517 | |
2471 @multitable @columnfractions .2 .8 | 2518 @multitable @columnfractions .2 .8 |
2472 @item Value: @tab 24 | 12 | none | 2519 @item Value: @tab 24 | 12 | none |
2473 @item Initial: @tab none | 2520 @item Initial: @tab none |
2474 @item Applies to: @tab all elements | 2521 @item Applies to: @tab all elements |
2475 @item Inherited: @tab yes | 2522 @item Inherited: @tab yes |
2476 @end multitable | 2523 @end multitable |
2477 | 2524 |
2478 @node Units, Length Units, speak-time, Stylesheets | 2525 @node Units, , Properties, Stylesheets |
2479 @section Units | 2526 @section Units |
2480 | 2527 |
2481 @ifinfo | |
2482 @menu | 2528 @menu |
2483 * Length Units:: | 2529 * Length Units:: |
2484 * Percentage Units:: | 2530 * Percentage Units:: |
2485 * Color Units:: | 2531 * Color Units:: |
2486 * URLs:: | 2532 * URLs:: |
2487 * Angle Units:: | 2533 * Angle Units:: |
2488 * Time Units:: | 2534 * Time Units:: |
2489 @end menu | 2535 @end menu |
2490 @end ifinfo | |
2491 | 2536 |
2492 @node Length Units, Percentage Units, Units, Units | 2537 @node Length Units, Percentage Units, Units, Units |
2493 @subsection Length Units | 2538 @subsection Length Units |
2494 | 2539 |
2495 @node Percentage Units, Color Units, Length Units, Units | 2540 @node Percentage Units, Color Units, Length Units, Units |
2501 @node URLs, Angle Units, Color Units, Units | 2546 @node URLs, Angle Units, Color Units, Units |
2502 @subsection URLs | 2547 @subsection URLs |
2503 | 2548 |
2504 @node Angle Units, Time Units, URLs, Units | 2549 @node Angle Units, Time Units, URLs, Units |
2505 @subsection Angle Units | 2550 @subsection Angle Units |
2551 | |
2506 These are the legal angle units: | 2552 These are the legal angle units: |
2507 @itemize @bullet | 2553 @itemize @bullet |
2508 @item | 2554 @item |
2509 deg: degrees | 2555 deg: degrees |
2510 @item | 2556 @item |
2511 grad | 2557 grad |
2512 @item | 2558 @item |
2513 rad: radians | 2559 rad: radians |
2514 @end itemize | 2560 @end itemize |
2515 | 2561 |
2516 @node Time Units, Supported URLs, Angle Units, Units | 2562 @node Time Units, , Angle Units, Units |
2517 @subsection Time Units | 2563 @subsection Time Units |
2564 | |
2518 These are the legal time units: | 2565 These are the legal time units: |
2519 | 2566 |
2520 @itemize @bullet | 2567 @itemize @bullet |
2521 @item | 2568 @item |
2522 ms: milliseconds | 2569 ms: milliseconds |
2523 @item | 2570 @item |
2524 s: seconds | 2571 s: seconds |
2525 @end itemize | 2572 @end itemize |
2526 | 2573 |
2527 @node Supported URLs, MIME Support, Time Units, Top | 2574 @node Supported URLs, MIME Support, Stylesheets, Top |
2528 @chapter Supported URLs | 2575 @chapter Supported URLs |
2529 | 2576 |
2530 ::WORK:: List supported URL types, specific RFCs, etc. | 2577 ::WORK:: List supported URL types, specific RFCs, etc. |
2531 | 2578 |
2532 @ifinfo | |
2533 @menu | 2579 @menu |
2580 * file:: Local file access. | |
2581 * ftp:: Remote file access via ftp. | |
2582 * nfs:: Remote file access via NFS. | |
2583 * info:: Access to the Emacs Info system. | |
2584 * http/https:: @sc{http/1.0} support. | |
2585 * mailto:: Sending simple electronic mail. | |
2586 * news/nntp/snews:: Reading and sending Usenet news. | |
2587 * rlogin/telnet/tn3270:: Legacy host connections. | |
2588 * irc:: Internet Relay Chat. | |
2589 * data:: Embedding the data within the URL itself. | |
2590 * mailserver:: Slightly more complicated electronic mail. | |
2591 * gopher:: Gopher and Gopher+. | |
2592 * finger:: The old favorite. | |
2534 @end menu | 2593 @end menu |
2535 @end ifinfo | 2594 |
2536 | 2595 @node file, ftp, Supported URLs, Supported URLs |
2537 @node MIME Support, Adding MIME types based on file extensions, Supported URLs, Top | 2596 @section file |
2597 | |
2598 @node ftp, nfs, file, Supported URLs | |
2599 @section ftp | |
2600 | |
2601 @node nfs, info, ftp, Supported URLs | |
2602 @section nfs | |
2603 | |
2604 @node info, http/https, nfs, Supported URLs | |
2605 @section info | |
2606 | |
2607 @node http/https, mailto, info, Supported URLs | |
2608 @section http/https | |
2609 | |
2610 @node mailto, news/nntp/snews, http/https, Supported URLs | |
2611 @section mailto | |
2612 | |
2613 @node news/nntp/snews, rlogin/telnet/tn3270, mailto, Supported URLs | |
2614 @section news/nntp/snews | |
2615 | |
2616 @node rlogin/telnet/tn3270, irc, news/nntp/snews, Supported URLs | |
2617 @section rlogin/telnet/tn3270 | |
2618 | |
2619 @node irc, data, rlogin/telnet/tn3270, Supported URLs | |
2620 @section irc | |
2621 | |
2622 @node data, mailserver, irc, Supported URLs | |
2623 @section data | |
2624 | |
2625 @node mailserver, gopher, data, Supported URLs | |
2626 @section mailserver | |
2627 | |
2628 @node gopher, finger, mailserver, Supported URLs | |
2629 @section gopher | |
2630 | |
2631 @node finger, , gopher, Supported URLs | |
2632 @section finger | |
2633 | |
2634 @node MIME Support, Security, Supported URLs, Top | |
2538 @chapter MIME Support | 2635 @chapter MIME Support |
2539 @sc{mime} is an emerging standard for multimedia mail. It offers a very | 2636 @sc{mime} is an emerging standard for multimedia mail. It offers a very |
2540 flexible typing mechanism. The type of a file or message is specified | 2637 flexible typing mechanism. The type of a file or message is specified |
2541 in two parts, separated by a '/'. The first part is the general | 2638 in two parts, separated by a '/'. The first part is the general |
2542 category of the data (text, application, image, etc.). The second part | 2639 category of the data (text, application, image, etc.). The second part |
2550 servers can now send back content-type headers in response to a request, | 2647 servers can now send back content-type headers in response to a request, |
2551 and not have the client second-guess it based on file extensions. @sc{html} | 2648 and not have the client second-guess it based on file extensions. @sc{html} |
2552 files can now be named @file{something.png} (not a great idea, but | 2649 files can now be named @file{something.png} (not a great idea, but |
2553 possible). | 2650 possible). |
2554 | 2651 |
2555 @ifinfo | |
2556 @menu | 2652 @menu |
2557 * Adding MIME types based on file extensions:: How to map file | 2653 * Adding MIME types based on file extensions:: How to map file |
2558 extensions onto MIME | 2654 extensions onto MIME |
2559 types (e.g., @samp{.png -> | 2655 types (e.g., @samp{.png -> |
2560 image/png)}. | 2656 image/png)}. |
2561 * Specifying Viewers:: How to specify external and internal viewers | 2657 * Specifying Viewers:: How to specify external and internal viewers |
2562 for files that Emacs-W3 cannot handle natively. | 2658 for files that Emacs-W3 cannot handle natively. |
2563 @end menu | 2659 @end menu |
2564 @end ifinfo | |
2565 | 2660 |
2566 @node Adding MIME types based on file extensions, Specifying Viewers, MIME Support, MIME Support | 2661 @node Adding MIME types based on file extensions, Specifying Viewers, MIME Support, MIME Support |
2567 @section Adding MIME types based on file extensions | 2662 @section Adding MIME types based on file extensions |
2663 | |
2568 @vindex mm-mime-extensions | 2664 @vindex mm-mime-extensions |
2569 For some protocols however, it is still necessary to guess the content | 2665 For some protocols however, it is still necessary to guess the content |
2570 of a file based on the file extension. This type of guess-work should | 2666 of a file based on the file extension. This type of guess-work should |
2571 only be needed when accessing files via @sc{ftp}, local file access, or old | 2667 only be needed when accessing files via @sc{ftp}, local file access, or old |
2572 @sc{http}/0.9 servers. | 2668 @sc{http}/0.9 servers. |
2617 | 2713 |
2618 type/subtype is the MIME-like type of the document. ext* is any number | 2714 type/subtype is the MIME-like type of the document. ext* is any number |
2619 of space-separated filename extensions which correspond to the MIME | 2715 of space-separated filename extensions which correspond to the MIME |
2620 type. | 2716 type. |
2621 | 2717 |
2622 @node Specifying Viewers, ,Adding MIME types based on file extensions, MIME Support | 2718 @node Specifying Viewers, , Adding MIME types based on file extensions, MIME Support |
2623 @section Specifying Viewers | 2719 @section Specifying Viewers |
2720 | |
2624 Not all files look as they should when parsed as an @sc{html} document | 2721 Not all files look as they should when parsed as an @sc{html} document |
2625 (whitespace is stripped, paragraphs are reformatted, and lots of little | 2722 (whitespace is stripped, paragraphs are reformatted, and lots of little |
2626 changes that make the document look unrecognizable). Files may be | 2723 changes that make the document look unrecognizable). Files may be |
2627 passed to external programs or Emacs Lisp functions to be viewed. | 2724 passed to external programs or Emacs Lisp functions to be viewed. |
2628 | 2725 |
2637 arguments, the major type ("@i{image}"), the minor type ("@i{png}"), and | 2734 arguments, the major type ("@i{image}"), the minor type ("@i{png}"), and |
2638 an assoc list of information about the viewer. Please see the @sc{url} | 2735 an assoc list of information about the viewer. Please see the @sc{url} |
2639 documentation for more specific information on what this assoc list | 2736 documentation for more specific information on what this assoc list |
2640 should look like. | 2737 should look like. |
2641 | 2738 |
2642 @node Security, Non-Unix Operating Systems, , Top | 2739 @node Security, Non-Unix Operating Systems, MIME Support, Top |
2643 @chapter Security | 2740 @chapter Security |
2644 @cindex Security | 2741 @cindex Security |
2645 @cindex Paranoia | 2742 @cindex Paranoia |
2646 There are an increasing number of ways to authenticate a user to a web | 2743 There are an increasing number of ways to authenticate a user to a web |
2647 service. Emacs-W3 tries to support as many as possible. Emacs-W3 | 2744 service. Emacs-W3 tries to support as many as possible. Emacs-W3 |
2676 Communications @footnote{http://www.netscape.com/}. Emacs-W3 supports | 2773 Communications @footnote{http://www.netscape.com/}. Emacs-W3 supports |
2677 @sc{http} transfers over an SSL encrypted channel, if the appropriate files | 2774 @sc{http} transfers over an SSL encrypted channel, if the appropriate files |
2678 have been installed.@xref{Installing SSL} | 2775 have been installed.@xref{Installing SSL} |
2679 @end table | 2776 @end table |
2680 | 2777 |
2681 @node Non-Unix Operating Systems, VMS, Security, Top | 2778 @node Non-Unix Operating Systems, Speech Integration, Security, Top |
2682 @chapter Non-Unix Operating Systems | 2779 @chapter Non-Unix Operating Systems |
2683 @cindex Non-Unix Operating Systems | 2780 @cindex Non-Unix Operating Systems |
2684 @ifinfo | 2781 |
2685 @menu | 2782 @menu |
2686 * VMS:: The wonderful world of VAX|AXP-VMS! | 2783 * VMS:: The wonderful world of VAX|AXP-VMS! |
2687 * OS/2:: The next-best thing to Unix. | 2784 * OS/2:: The next-best thing to Unix. |
2688 * MS-DOS:: The wonderful world of MS-DOG! | 2785 * MS-DOS:: The wonderful world of MS-DOG! |
2689 * Windows:: Windows NT, Chicago/Windows 95. | 2786 * Windows:: Windows NT, Chicago/Windows 95. |
2690 @end menu | 2787 @end menu |
2691 @end ifinfo | |
2692 | 2788 |
2693 @node VMS, OS/2, Non-Unix Operating Systems, Non-Unix Operating Systems | 2789 @node VMS, OS/2, Non-Unix Operating Systems, Non-Unix Operating Systems |
2694 @section VMS | 2790 @section VMS |
2695 @cindex VAX-VMS | 2791 @cindex VAX-VMS |
2696 @cindex AXP-VMS | 2792 @cindex AXP-VMS |
2697 @cindex Digital VMS | 2793 @cindex Digital VMS |
2698 @cindex VMS | 2794 @cindex VMS |
2795 | |
2699 :: WORK :: VMS Specific instriuctions | 2796 :: WORK :: VMS Specific instriuctions |
2700 | 2797 |
2701 @node OS/2, MS-DOS, VMS, Non-Unix Operating Systems | 2798 @node OS/2, MS-DOS, VMS, Non-Unix Operating Systems |
2702 @section OS/2 | 2799 @section OS/2 |
2703 @cindex OS/2 | 2800 @cindex OS/2 |
2704 @cindex Warp | 2801 @cindex Warp |
2802 | |
2705 :: WORK :: OS/2 Specific instructions | 2803 :: WORK :: OS/2 Specific instructions |
2706 | 2804 |
2707 @node MS-DOS, Windows, OS/2, Non-Unix Operating Systems | 2805 @node MS-DOS, Windows, OS/2, Non-Unix Operating Systems |
2708 @section MS-DOS | 2806 @section MS-DOS |
2709 @cindex MS-DOS | 2807 @cindex MS-DOS |
2710 @cindex Microsloth | 2808 @cindex Microsloth |
2711 @cindex DOS | 2809 @cindex DOS |
2712 @cindex MS-DOG | 2810 @cindex MS-DOG |
2811 | |
2713 :: WORK :: DOS Specific instructions | 2812 :: WORK :: DOS Specific instructions |
2714 | 2813 |
2715 @node Windows, Speech Integration , MS-DOS, Non-Unix Operating Systems | 2814 @node Windows, , MS-DOS, Non-Unix Operating Systems |
2716 @section Windows | 2815 @section Windows |
2717 @cindex Windows (32-Bit) | 2816 @cindex Windows (32-Bit) |
2718 @cindex 32-Bit Windows | 2817 @cindex 32-Bit Windows |
2719 @cindex Microsloth | 2818 @cindex Microsloth |
2720 @cindex Windows '95 | 2819 @cindex Windows '95 |
2820 | |
2721 :: WORK :: 32bit Windows Specific instructions | 2821 :: WORK :: 32bit Windows Specific instructions |
2722 | 2822 |
2723 @node Speech Integration, Advanced Features, Windows, Top | 2823 @node Speech Integration, Advanced Features, Non-Unix Operating Systems, Top |
2724 @chapter Speech Integration | 2824 @chapter Speech Integration |
2825 | |
2725 :: WORK :: Emacspeak integration | 2826 :: WORK :: Emacspeak integration |
2726 | 2827 |
2727 @node Advanced Features, Style Sheets, Speech Integration, Top | 2828 @node Advanced Features, More Help, Speech Integration, Top |
2728 @chapter Advanced Features | 2829 @chapter Advanced Features |
2729 | 2830 |
2730 @ifinfo | |
2731 @menu | 2831 @menu |
2732 * Style Sheets:: Formatting control, the right way | 2832 * Disk Caching:: Improving performance by using a local disk cache |
2733 * Disk Caching:: Improving performance by using a local disk cache | 2833 * Interfacing to Mail/News:: How to make VM understand hypertext links |
2734 * Interfacing to Mail/News:: How to make VM understand hypertext links | 2834 * Debugging HTML:: How to make Emacs-W3 display warnings about invalid |
2735 * Debugging HTML:: How to make Emacs-W3 display warnings about invalid | 2835 @sc{html}/@sc{html}+ constructs. |
2736 @sc{html}/@sc{html}+ constructs. | 2836 * Hooks:: Various hooks to use throughout Emacs-W3 |
2737 * Native WAIS Support:: How to make Emacs-W3 understand WAIS links without | 2837 * Other Variables:: Miscellaneous variables that control the real |
2738 using a gateway. | 2838 guts of Emacs-W3. |
2739 * Rating Links:: How to make Emacs-W3 put an 'interestingness' value | |
2740 next to each link. | |
2741 * Gopher Plus Support:: How Emacs-W3 makes use of the Gopher+ protocol. | |
2742 * Hooks:: Various hooks to use throughout Emacs-W3 | |
2743 * Other Variables:: Miscellaneous variables that control the real | |
2744 guts of Emacs-W3. | |
2745 @end menu | 2839 @end menu |
2746 @end ifinfo | 2840 |
2747 | 2841 @node Disk Caching, Interfacing to Mail/News, Advanced Features, Advanced Features |
2748 @node Style Sheets, Disk Caching, Advanced Features, Advanced Features | |
2749 @section Style Sheets | |
2750 @cindex Formatting control | |
2751 @cindex Style sheets | |
2752 @cindex Look and Feel | |
2753 @cindex Layout control | |
2754 @cindex Experimental style sheet mechanism | |
2755 Emacs-W3 currently supports the experimental style sheet mechanism | |
2756 proposed by H&kon W. Lie of the W3 Consortium. This allows for the | |
2757 author to specify what a document should look like, and yet allow the | |
2758 end user to override any of the stylistic changes. This allows for | |
2759 people with special needs (most notably the visually impaired) to | |
2760 override style bindings that could make a document totally | |
2761 unreadable. | |
2762 | |
2763 @example | |
2764 <style notation="css"> | |
2765 /* This is a comment | |
2766 ** These will be ignored, up to the terminating */ | |
2767 | |
2768 h1 @{ align: center, | |
2769 color: yellow, | |
2770 background: red, | |
2771 font-size: 24pt | |
2772 @} | |
2773 h2 @{ align: right, | |
2774 font-family: palatino, | |
2775 font-size: 18pt | |
2776 @} | |
2777 </style> | |
2778 @end example | |
2779 | |
2780 :: WORK :: Much more information on stylesheets | |
2781 | |
2782 @cindex <style> | |
2783 To include a stylesheet into a document, simply use the <style> tag. | |
2784 Use the @b{notation} attribute to specify what language the stylesheet | |
2785 is specified in. The default is @b{css}. The data between the <style> | |
2786 and </style> tags is the stylsheet proper - no @sc{html} parsing is done to | |
2787 this data - it is treated similar to an <XMP> section of text. To | |
2788 reference an external stylesheet, use the <link> tag. | |
2789 @example | |
2790 <link rel="stylesheet" href="/bill.style"> | |
2791 @end example | |
2792 If these two mechanisms are mixed, then the @sc{url} is resolved first, and | |
2793 the contents of the <style> tag take precedence if there are any | |
2794 conflicting directives. | |
2795 | |
2796 @cindex DSSSL | |
2797 @cindex DSSSL-lite | |
2798 In the future, DSSSL and DSSSL-lite will be supported as valid | |
2799 stylesheet languages, but not in this release. For more information on | |
2800 DSSSL-lite see http://www.falch.no/~pepper/DSSSL-Lite/ - for more | |
2801 information on full DSSSL, see | |
2802 ftp://ftp.jclark.com/pub/dsssl/dsssl.ps.gz | |
2803 | |
2804 @node Disk Caching, Interfacing to Mail/News, Style Sheets, Advanced Features | |
2805 @section Disk Caching | 2842 @section Disk Caching |
2806 @cindex Caching | 2843 @cindex Caching |
2807 @cindex Persistent Cache | 2844 @cindex Persistent Cache |
2808 @cindex Disk Cache | 2845 @cindex Disk Cache |
2846 | |
2809 A cache stores the information on a page on the local machine. When | 2847 A cache stores the information on a page on the local machine. When |
2810 requesting a page that is in the cache, Emacs-W3 can retrieve the page | 2848 requesting a page that is in the cache, Emacs-W3 can retrieve the page |
2811 from the cache more quickly than retrieving the page again from its | 2849 from the cache more quickly than retrieving the page again from its |
2812 location out on the network. With a well-populated cache, browsing the | 2850 location out on the network. With a well-populated cache, browsing the |
2813 web is dramatically faster. | 2851 web is dramatically faster. |
2889 @cindex Using Emacs-W3 with VM | 2927 @cindex Using Emacs-W3 with VM |
2890 @cindex GNUS | 2928 @cindex GNUS |
2891 @cindex Using Emacs-W3 with Gnus | 2929 @cindex Using Emacs-W3 with Gnus |
2892 @cindex RMAIL | 2930 @cindex RMAIL |
2893 @cindex Using Emacs-W3 with RMAIL | 2931 @cindex Using Emacs-W3 with RMAIL |
2932 | |
2894 More and more people are including @sc{url}s in their signatures, and within | 2933 More and more people are including @sc{url}s in their signatures, and within |
2895 the body of mail messages. It can get quite tedious to type these into | 2934 the body of mail messages. It can get quite tedious to type these into |
2896 the minibuffer to follow one. | 2935 the minibuffer to follow one. |
2897 | 2936 |
2898 @vindex browse-url-browser-function | 2937 @vindex browse-url-browser-function |
2910 (lambda () | 2949 (lambda () |
2911 (define-key rmail-mode-map [mouse-2] 'w3-maybe-follow-link-mouse) | 2950 (define-key rmail-mode-map [mouse-2] 'w3-maybe-follow-link-mouse) |
2912 (define-key rmail-mode-map "\r" 'w3-maybe-follow-link)))) | 2951 (define-key rmail-mode-map "\r" 'w3-maybe-follow-link)))) |
2913 @end example | 2952 @end example |
2914 | 2953 |
2915 @node Debugging HTML, Native WAIS Support, Interfacing to Mail/News, Advanced Features | 2954 @node Debugging HTML, Hooks, Interfacing to Mail/News, Advanced Features |
2916 @section Debugging HTML | 2955 @section Debugging HTML |
2917 @cindex Debugging | 2956 @cindex Debugging |
2918 @cindex Invalid HTML | 2957 @cindex Invalid HTML |
2919 @cindex Bad HTML | 2958 @cindex Bad HTML |
2920 @vindex w3-debug-buffer | 2959 @vindex w3-debug-buffer |
2921 @vindex w3-debug-html | 2960 @vindex w3-debug-html |
2961 | |
2922 For those people that are adventurous, or are just as anal as I am about | 2962 For those people that are adventurous, or are just as anal as I am about |
2923 people writing valid @sc{html}, set the variable @code{w3-debug-html} to | 2963 people writing valid @sc{html}, set the variable @code{w3-debug-html} to |
2924 @code{t} and see what happens. | 2964 @code{t} and see what happens. |
2925 | 2965 |
2926 | 2966 |
2928 message is displayed. | 2968 message is displayed. |
2929 | 2969 |
2930 :: WORK :: Need to list the different values w3-debug-html can have, and | 2970 :: WORK :: Need to list the different values w3-debug-html can have, and |
2931 :: WORK :: what they do :: | 2971 :: WORK :: what they do :: |
2932 | 2972 |
2933 @node Native WAIS Support, Rating Links, Debugging HTML, Advanced Features | 2973 @node Hooks, Other Variables, Debugging HTML, Advanced Features |
2934 @section Native WAIS Support | |
2935 This version of Emacs-W3 supports native WAIS querying (earlier | |
2936 versions required the use of a gateway program). In order to use the | |
2937 native WAIS support, a working @dfn{waisq} binary is required. I | |
2938 recommend the distribution from think.com - | |
2939 ftp://think.com/wais/wais-8-b6.1.tar.Z is a good place to start. | |
2940 | |
2941 @vindex url-waisq-prog | |
2942 @vindex url-wais-gateway-server | |
2943 @vindex url-wais-gateway-port | |
2944 The variable @code{url-waisq-prog} must point to this executable, and | |
2945 one of @code{url-wais-gateway-server} or @code{url-wais-gateway-port} | |
2946 should be @code{nil}. | |
2947 | |
2948 When a WAIS @sc{url} is encountered, a form will be automatically generated | |
2949 and displayed. After typing in the search term, the query will be sent | |
2950 to the server by running the @code{url-waisq-prog} in a subprocess. The | |
2951 results will be converted into @sc{html} and displayed. | |
2952 | |
2953 @node Rating Links, Gopher Plus Support, Native WAIS Support, Advanced Features | |
2954 @section Rating Links | |
2955 The @code{w3-link-info-display-function} variable can be used to 'rate' a @sc{url} | |
2956 when it shows up in an @sc{html} page. If non-@code{nil}, then this should | |
2957 be a list specifying (or a symbol specifying the name) of a function. | |
2958 This function should expect one argument, a fully specified @sc{url}, and | |
2959 should return a string. This string is inserted after the link | |
2960 text. | |
2961 | |
2962 If a user has decided that all links served from blort.com are too laden | |
2963 with images, and wants to be warned that a link points at this host, | |
2964 they could do something like this: | |
2965 | |
2966 @example | |
2967 (defun check-url (url) | |
2968 (if (string-match "://[^/]blort.com" url) | |
2969 "[SLOW!]" "")) | |
2970 | |
2971 (setq w3-link-info-display-function 'check-url) | |
2972 @end example | |
2973 | |
2974 So that all links pointing to any site at blort.com shows up as "Some | |
2975 link[SLOW!]" instead of just "Some link". | |
2976 | |
2977 @node Gopher Plus Support, Hooks, Rating Links, Advanced Features | |
2978 @section Gopher+ Support | |
2979 @cindex Gopher+ | |
2980 The gopher+ support in Emacs-W3 is limited to the conversion of ASK | |
2981 blocks into @sc{html} 3.0 forms, and the usage of the content-length given by | |
2982 the gopher+ server to give a nice status bar on the bottom of the | |
2983 screen. | |
2984 | |
2985 This will hopefully be extended to include the Gopher+ method of | |
2986 content-type negotiation, but this may be a while. | |
2987 | |
2988 @node Hooks, Other Variables, Gopher Plus Support, Advanced Features | |
2989 @section Hooks | 2974 @section Hooks |
2990 @cindex Hooks | 2975 @cindex Hooks |
2976 | |
2991 These are the various hooks that can be used to customize some of | 2977 These are the various hooks that can be used to customize some of |
2992 Emacs-W3's behavior. They are arranged in the order in which they would | 2978 Emacs-W3's behavior. They are arranged in the order in which they would |
2993 happen when retrieving a document. All of these are functions (or lists | 2979 happen when retrieving a document. All of these are functions (or lists |
2994 of functions) that are called consecutively. | 2980 of functions) that are called consecutively. |
2995 | 2981 |
3015 before any inlined images are downloaded and converted. | 3001 before any inlined images are downloaded and converted. |
3016 @item w3-source-file-hooks | 3002 @item w3-source-file-hooks |
3017 These hooks are run after displaying a document's source | 3003 These hooks are run after displaying a document's source |
3018 @end table | 3004 @end table |
3019 | 3005 |
3020 @node Other Variables, , Hooks, Advanced Features | 3006 @node Other Variables, , Hooks, Advanced Features |
3021 @section Miscellaneous variables | 3007 @section Miscellaneous variables |
3008 | |
3022 There are lots of variables that control the real nitty-gritty of Emacs-W3 | 3009 There are lots of variables that control the real nitty-gritty of Emacs-W3 |
3023 that the beginning user probably shouldn't mess with. Here they are. | 3010 that the beginning user probably shouldn't mess with. Here they are. |
3024 | 3011 |
3025 @table @code | 3012 @table @code |
3026 @item url-bad-port-list | 3013 @item url-bad-port-list |
3114 @item url-uncompressor-alist | 3101 @item url-uncompressor-alist |
3115 @vindex url-uncompressor-alist | 3102 @vindex url-uncompressor-alist |
3116 An assoc list of file extensions and the appropriate uncompression | 3103 An assoc list of file extensions and the appropriate uncompression |
3117 programs for each. This is used to build the Accept-encoding header for | 3104 programs for each. This is used to build the Accept-encoding header for |
3118 @sc{http}/1.0 requests. | 3105 @sc{http}/1.0 requests. |
3119 @item url-waisq-prog | |
3120 @vindex url-waisq-prog | |
3121 Name of the waisq executable on this system. This should be the | |
3122 @file{waisq} program from think.com's wais8-b5.1 distribution. | |
3123 @end table | 3106 @end table |
3124 | 3107 |
3125 @node More Help, Future Directions, , Top | 3108 @node More Help, Future Directions, Advanced Features, Top |
3126 @chapter More Help | 3109 @chapter More Help |
3127 @cindex Relevant Newsgroups | 3110 @cindex Relevant Newsgroups |
3128 @cindex Newsgroups | 3111 @cindex Newsgroups |
3129 @cindex Support | 3112 @cindex Support |
3130 For more help on Emacs-W3, please send me mail | 3113 For more help on Emacs-W3, please send me mail |
3429 @example | 3412 @example |
3430 (setq url-proxy-services '(("http" . "http://proxy.aventail.com/") | 3413 (setq url-proxy-services '(("http" . "http://proxy.aventail.com/") |
3431 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\.com"))) | 3414 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\.com"))) |
3432 @end example | 3415 @end example |
3433 | 3416 |
3434 @node Installing SSL, Mailcap Files, Proxy Gateways, Top | 3417 @node Installing SSL, Mailcap Files, Proxy Gateways, Top |
3435 @appendix Installing SSL | 3418 @appendix Installing SSL |
3436 @cindex HTTP/1.0 Authentication | 3419 @cindex HTTP/1.0 Authentication |
3437 @cindex Secure Sockets Layer | 3420 @cindex Secure Sockets Layer |
3438 @cindex SSL | 3421 @cindex SSL |
3439 @cindex Gag Puke Retch | 3422 @cindex Gag Puke Retch |
3607 :: WORK :: Document how you can never see another ad from them again | 3590 :: WORK :: Document how you can never see another ad from them again |
3608 | 3591 |
3609 @node General Index, Key Index, Down with DoubleClick, Top | 3592 @node General Index, Key Index, Down with DoubleClick, Top |
3610 @appendix General Index | 3593 @appendix General Index |
3611 @printindex fn | 3594 @printindex fn |
3612 @node Key Index, , General Index, Top | 3595 @node Key Index, , General Index, Top |
3613 @appendix Key Index | 3596 @appendix Key Index |
3614 @printindex ky | 3597 @printindex ky |
3615 @contents | 3598 @contents |
3616 @bye | 3599 @bye |
3617 | |
3618 @c @node Supported Protocols, , Stylesheets, Introduction | |
3619 @c @chapter Supported Protocols | |
3620 @c @cindex Network Protocols | |
3621 @c @cindex Protocols Supported | |
3622 @c @cindex Supported Protocols | |
3623 @c Emacs-W3 supports the following protocols | |
3624 @c @table @b | |
3625 @c @item Usenet News | |
3626 @c Can either display an entire newsgroup or specific articles by | |
3627 @c Message-ID: header. Instead of rewriting a newsreader, this integrates | |
3628 @c with the Gnus newsreader. It requires at least Gnus 5.0, but it is | |
3629 @c always safest to use the latest version. Gnus supports some very | |
3630 @c advanced features, including virtual newsgroups, mail and news | |
3631 @c integration, and reading news from multiple servers. @inforef{Gnus, | |
3632 @c Top,gnus}, for more info. | |
3633 | |
3634 @c To be more in line with the other @sc{url} schemes, the hostname and port of | |
3635 @c an @sc{nntp} server can be specified. @sc{url}s of the form | |
3636 @c news://hostname:port/messageID work, but might not work in some other | |
3637 @c browsers. | |
3638 | |
3639 @c @item @sc{http} | |
3640 @c Supports the @sc{http}/0.9, @sc{http}/1.0, and parts of the @sc{http}/1.1 protocols. | |
3641 @c @item Gopher | |
3642 @c Support for all gopher types, including CSO queries. | |
3643 @c @item Gopher+ | |
3644 @c Support for Gopher+ retrievals. Support for converting ASK blocks into | |
3645 @c HTML forms and submitting them back to the server. | |
3646 @c @item @sc{ftp} | |
3647 @c @sc{ftp} is handled by either ange-ftp or efs. | |
3648 @c @inforef{Ange-FTP,Top,ange-ftp}, for more information on Ange-FTP, or | |
3649 @c @inforef{EFS, Top,efs}, for information on EFS. | |
3650 @c @item Local files | |
3651 @c Local files are of course handled, and MIME content-types are derived | |
3652 @c from the file extensions. | |
3653 @c @item telnet, tn3270, rlogin | |
3654 @c Telnet, tn3270, and rogin are handled by running the appropriate program | |
3655 @c in an emacs buffer, or running an external process. | |
3656 @c @item mailto | |
3657 @c Causes a mail message to be started to a specific address. Supports the | |
3658 @c Netscape @i{extensions} to specify arbitrary headers on the message. | |
3659 @c @item data | |
3660 @c A quick and easy way to `inline' small pieces of information that you do | |
3661 @c not necessarily want to download over the net separately. Can speed up | |
3662 @c display of small icons, stylesheet information, etc. See the internet | |
3663 @c draft draft-masinter-url-data-02.txt for more information. | |
3664 @c @item mailserver | |
3665 @c A more powerful version of mailto, which allows the author to specify | |
3666 @c the subject and body text of the mail message. This type of link is | |
3667 @c never fully executed without user confirmation, because it is possible | |
3668 @c to insert insulting or threatening (and possibly illegal) data into the | |
3669 @c message. The mail message is displayed, and the user must confirm the | |
3670 @c message before it is sent. | |
3671 @c @item x-exec | |
3672 @c A @sc{url} can cause a local executable to be run, and its output interpreted | |
3673 @c as if it had come from an @sc{http} server. This is very useful, but is | |
3674 @c still an experimental protocol, hence the X- prefix. This @sc{url} protocol | |
3675 @c is deprecated, but might be useful in the future. | |
3676 @c @item @sc{nfs} | |
3677 @c Retrieves information over @sc{nfs}. This requires that your operating | |
3678 @c system support auto-mounting of @sc{nfs} volumes. | |
3679 @c @item finger | |
3680 @c Retrieves information about a user via the 'finger' protocol. | |
3681 @c @item Info | |
3682 @c Creates a link to an GNU-style info file. @inforef{Info,Top,info}, for more | |
3683 @c information on the Info format. | |
3684 @c @item SSL | |
3685 @c SSL requires a set of patches to the Emacs C code and SSLRef 2.0, or an | |
3686 @c external program to run in a subprocess (similar to the @file{tcp.el} | |
3687 @c package that comes with GNUS. @xref{Installing SSL} | |
3688 @c @end table | |
3689 |