]> git.donarmstrong.com Git - dactyl.git/blob - common/locale/en-US/styling.xml
Import 1.0b7.1 supporting Firefox up to 8.*
[dactyl.git] / common / locale / en-US / styling.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
3
4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
5
6 <document
7     name="styling"
8     title="&dactyl.appName; Styling"
9     xmlns="&xmlns.dactyl;"
10     xmlns:html="&xmlns.html;">
11
12 <h1 tag="styling">Styling the GUI and web pages</h1>
13 <toc start="2"/>
14
15 <p>
16     &dactyl.appName; allows you to apply custom CSS styling to the web pages
17     you view as well as to the browser itself. Although it is possible to
18     style any user interface element via the <ex>:style</ex> command, most
19     &dactyl.appName; elements can be styled more easily by means of the
20     more specialized <ex>:highlight</ex> command.
21 </p>
22
23 <item>
24     <tags>E185 :colo :colorscheme</tags>
25     <spec>:colo<oa>rscheme</oa> <a>name</a></spec>
26     <description>
27         <p>
28             Load a color scheme. <a>name</a> is found by searching the <o>runtimepath</o> for the
29             first file matching <tt>colors/<a>name</a>.&dactyl.fileExt;</tt>.
30             The special scheme <em>default</em> can be used to reload the
31             default highlight settings.
32         </p>
33
34         <p>
35             The ColorScheme autocommand is triggered after the color scheme has been
36             sourced.
37         </p>
38     </description>
39 </item>
40
41 <item>
42     <tags>:hi :highlight</tags>
43     <spec>:hi<oa>ghlight</oa><oa>!</oa> <a>group</a><oa>selector</oa></spec>
44     <spec>:hi<oa>ghlight</oa><oa>!</oa> <oa>-append</oa> <oa>-link=<a>group</a>,…</oa> <a>group</a><oa>selector</oa> <oa>css</oa></spec>
45     <description>
46         <p>
47             Highlight <a>group</a> with <oa>css</oa>. <oa>css</oa> is one or more
48             semicolon-separated CSS declarations (E.g. <em>color: blue;
49             background-color: red</em>). <oa>selector</oa>, if provided, may
50             be any valid CSS selector (such as <em>:hover</em> or
51             <em>[href]</em>), and will restrict the highlighting to matching
52             elements.
53         </p>
54
55         <p>
56             If <em>-link</em> (short name <em>-l</em>) is supplied, the value of
57             each of the listed groups is prepended to the style of this group.
58         </p>
59
60         <p>Valid groups include:</p>
61
62         <dl dt="width: 12em;">
63             <dt>Addon</dt>                      <dd>An add-on in the <ex>:addons</ex> manager</dd>
64             <dt>AddonBar</dt>                   <dd></dd>
65             <dt>AddonButton</dt>                <dd></dd>
66             <dt>AddonButtons</dt>               <dd></dd>
67             <dt>AddonCell</dt>                  <dd>A cell in tell <ex>:addons</ex> manager</dd>
68             <dt>AddonDescription</dt>           <dd></dd>
69             <dt>AddonHead</dt>                  <dd>A heading in the <ex>:addons</ex> manager</dd>
70             <dt>AddonName</dt>                  <dd></dd>
71             <dt>AddonStatus</dt>                <dd></dd>
72             <dt>AddonVersion</dt>               <dd></dd>
73             <dt>Addons</dt>                     <dd>The <ex>:addons</ex> manager</dd>
74             <dt>AppmenuButton</dt>              <dd>The app-menu button</dd>
75             <dt>Bell</dt>                       <dd>&dactyl.appName;'s visual bell</dd>
76             <dt>Boolean</dt>                    <dd>JavaScript booleans</dd>
77             <dt>Button</dt>                     <dd>A button widget</dd>
78             <dt>Buttons</dt>                    <dd>A group of buttons</dd>
79             <dt>CmdCmdLine</dt>                 <dd></dd>
80             <dt>CmdErrorMsg</dt>                <dd></dd>
81             <dt>CmdInfoMsg</dt>                 <dd></dd>
82             <dt>CmdInput</dt>                   <dd></dd>
83             <dt>CmdLine</dt>                    <dd>The command line</dd>
84             <dt>CmdModeMsg</dt>                 <dd></dd>
85             <dt>CmdMoreMsg</dt>                 <dd></dd>
86             <dt>CmdNormal</dt>                  <dd></dd>
87             <dt>CmdOutput</dt>                  <dd>The output of commands executed by <ex>:run</ex></dd>
88             <dt>CmdPrompt</dt>                  <dd></dd>
89             <dt>CmdQuestion</dt>                <dd></dd>
90             <dt>CmdWarningMsg</dt>              <dd></dd>
91             <dt>Comment</dt>                    <dd>JavaScriptor CSS comments</dd>
92             <dt>CompDesc</dt>                   <dd>The description column of the completion list</dd>
93             <dt>CompGroup</dt>                  <dd>Item group in completion output</dd>
94             <dt>CompIcon</dt>                   <dd>The favicon of a completion row</dd>
95             <dt>CompIcon>img</dt>               <dd></dd>
96             <dt>CompItem</dt>                   <dd>A single row of output in the completion list</dd>
97             <dt>CompItem[selected]</dt>         <dd>A selected row of completion list</dd>
98             <dt>CompLess::after</dt>            <dd>The character of indicator shown when completions may be scrolled up</dd>
99             <dt>CompLess</dt>                   <dd>The indicator shown when completions may be scrolled up</dd>
100             <dt>CompMore::after</dt>            <dd>The character of indicator shown when completions may be scrolled down</dd>
101             <dt>CompMore</dt>                   <dd>The indicator shown when completions may be scrolled down</dd>
102             <dt>CompMsg</dt>                    <dd>The message which may appear at the top of a group of completion results</dd>
103             <dt>CompResult</dt>                 <dd>The result column of the completion list</dd>
104             <dt>CompTitle</dt>                  <dd>Completion row titles</dd>
105             <dt>CompTitleSep</dt>               <dd>The element which separates the completion title from its results</dd>
106             <dt>Dense</dt>                      <dd>Arbitrary elements which should be packed densely together</dd>
107             <dt>Disabled</dt>                   <dd>Disabled item indicator text</dd>
108             <dt>Download[active]</dt>           <dd>A currently active download</dd>
109             <dt>Download</dt>                   <dd>A download in the <ex>:downloads</ex> manager</dd>
110             <dt>DownloadButtons</dt>            <dd>A button group in the <ex>:downloads</ex> manager</dd>
111             <dt>DownloadCell</dt>               <dd>A table cell in the <ex>:downloads</ex> manager</dd>
112             <dt>DownloadHead</dt>               <dd>A heading in the <ex>:downloads</ex> manager</dd>
113             <dt>DownloadPercent</dt>            <dd>The percentage column for a download</dd>
114             <dt>DownloadProgress</dt>           <dd>The progress column for a download</dd>
115             <dt>DownloadProgressHave</dt>       <dd>The completed portion of the progress column</dd>
116             <dt>DownloadProgressTotal</dt>      <dd>The remaining portion of the progress column</dd>
117             <dt>DownloadSource</dt>             <dd>The download source column for a download</dd>
118             <dt>DownloadState</dt>              <dd>The download state column for a download</dd>
119             <dt>DownloadTime</dt>               <dd>The time remaining column for a download</dd>
120             <dt>DownloadTitle</dt>              <dd>The title column for a download</dd>
121             <dt>Downloads</dt>                  <dd>The <ex>:downloads</ex> manager</dd>
122             <dt>EditorBlink1</dt>               <dd>Text fields briefly after successfully running the external editor, alternated with EditorBlink2</dd>
123             <dt>EditorBlink2</dt>               <dd>Text fields briefly after successfully running the external editor, alternated with EditorBlink1</dd>
124             <dt>EditorEditing</dt>              <dd>Text fields for which an external editor is open</dd>
125             <dt>EditorError</dt>                <dd>Text fields briefly after an error has occurred running the external editor</dd>
126             <dt>Enabled</dt>                    <dd>Enabled item indicator text</dd>
127             <dt>ErrorMsg</dt>                   <dd>Error messages</dd>
128             <dt>Filter</dt>                     <dd>The matching text in a completion list</dd>
129             <dt>FontCode</dt>                   <dd>The font used for code listings</dd>
130             <dt>FontFixed</dt>                  <dd>The font used for fixed-width text</dd>
131             <dt>FontProportional</dt>           <dd>The font used for proportionally spaced text</dd>
132             <dt>Find</dt>                       <dd>Text find highlighting. Only background and foreground colors apply.</dd>
133             <dt>FrameIndicator</dt>             <dd>The styling applied to briefly indicate the active frame</dd>
134             <dt>Function</dt>                   <dd>JavaScript functions</dd>
135             <dt>Help</dt>                       <dd>A help page</dd>
136             <dt>HelpArg</dt>                    <dd>A required command argument indicator</dd>
137             <dt>HelpBody</dt>                   <dd>The body of a help page</dd>
138             <dt>HelpBorder</dt>                 <dd>The styling of bordered elements</dd>
139             <dt>HelpCode</dt>                   <dd>Code listings</dd>
140             <dt>HelpDefault</dt>                <dd>The default value of a help item</dd>
141             <dt>HelpDescription</dt>            <dd>The description of a help item</dd>
142             <dt>HelpDescription[short]</dt>     <dd></dd>
143             <dt>HelpEm</dt>                     <dd>Emphasized text</dd>
144             <dt>HelpEx</dt>                     <dd>An Ex command</dd>
145             <dt>HelpExample</dt>                <dd>An example</dd>
146             <dt>HelpHead1</dt>                  <dd>Any help heading</dd>
147             <dt>HelpHead2</dt>                  <dd>A first-level help heading</dd>
148             <dt>HelpHead3</dt>                  <dd>A second-level help heading</dd>
149             <dt>HelpHead4</dt>                  <dd>A third-level help heading</dd>
150             <dt>HelpHead</dt>                   <dd>A fourth-level help heading</dd>
151             <dt>HelpInclude</dt>                <dd>A help page included in the consolidated help listing</dd>
152             <dt>HelpInfo</dt>                   <dd>Arbitrary information about a help item</dd>
153             <dt>HelpInfoLabel</dt>              <dd>The label for a HelpInfo item</dd>
154             <dt>HelpInfoValue</dt>              <dd>The details for a HelpInfo item</dd>
155             <dt>HelpItem</dt>                   <dd>A help item</dd>
156             <dt>HelpKey</dt>                    <dd>A keyboard key specification</dd>
157             <dt>HelpKeyword</dt>                <dd>A keyword</dd>
158             <dt>HelpLink</dt>                   <dd>A hyperlink</dd>
159             <dt>HelpLink[rel=external]</dt>     <dd>A hyperlink to an external resource</dd>
160             <dt>HelpList</dt>                   <dd>An unordered list</dd>
161             <dt>HelpListItem</dt>               <dd>A list item, ordered or unordered</dd>
162             <dt>HelpNews</dt>                   <dd>A news item</dd>
163             <dt>HelpNewsNew</dt>                <dd>A new news item</dd>
164             <dt>HelpNewsOld</dt>                <dd>An old news item</dd>
165             <dt>HelpNewsTag</dt>                <dd>The version tag for a news item</dd>
166             <dt>HelpNote</dt>                   <dd>The indicator for a note</dd>
167             <dt>HelpOpt</dt>                    <dd>An option name</dd>
168             <dt>HelpOptInfo</dt>                <dd>Information about the type and default values for an option entry</dd>
169             <dt>HelpOptionalArg</dt>            <dd>An optional command argument indicator</dd>
170             <dt>HelpOrderedList1</dt>           <dd>A first-level ordered list</dd>
171             <dt>HelpOrderedList2</dt>           <dd>A second-level ordered list</dd>
172             <dt>HelpOrderedList3</dt>           <dd>A third-level ordered list</dd>
173             <dt>HelpOrderedList4</dt>           <dd>A fourth-level ordered list</dd>
174             <dt>HelpOrderedList</dt>            <dd>Any ordered list</dd>
175             <dt>HelpParagraph</dt>              <dd>An ordinary paragraph</dd>
176             <dt>HelpSpec</dt>                   <dd>The specification for a help entry</dd>
177             <dt>HelpString</dt>                 <dd>A quoted string</dd>
178             <dt>HelpTOC</dt>                    <dd>The Table of Contents for a help page</dd>
179             <dt>HelpTOC>ol</dt>                 <dd></dd>
180             <dt>HelpTT</dt>                     <dd>Teletype text</dd>
181             <dt>HelpTab</dt>                    <dd></dd>
182             <dt>HelpTabColumn</dt>              <dd></dd>
183             <dt>HelpTabDescription</dt>         <dd>The description column of description tables</dd>
184             <dt>HelpTabRow</dt>                 <dd>Entire rows in description tables</dd>
185             <dt>HelpTabTitle</dt>               <dd>The title column of description tables</dd>
186             <dt>HelpTag</dt>                    <dd>A help tag</dd>
187             <dt>HelpTags</dt>                   <dd>A group of help tags</dd>
188             <dt>HelpTopic</dt>                  <dd>A link to a help topic</dd>
189             <dt>HelpType</dt>                   <dd>An option type</dd>
190             <dt>HelpWarning</dt>                <dd>The indicator for a warning</dd>
191             <dt>HelpXML</dt>                    <dd>Highlighted XML</dd>
192             <dt>HelpXMLAttribute</dt>           <dd></dd>
193             <dt>HelpXMLBlock</dt>               <dd></dd>
194             <dt>HelpXMLComment</dt>             <dd></dd>
195             <dt>HelpXMLNamespace</dt>           <dd></dd>
196             <dt>HelpXMLProcessing</dt>          <dd></dd>
197             <dt>HelpXMLString</dt>              <dd></dd>
198             <dt>HelpXMLTagEnd</dt>              <dd></dd>
199             <dt>HelpXMLTagStart</dt>            <dd></dd>
200             <dt>HelpXMLText</dt>                <dd></dd>
201             <dt>Hint</dt>                       <dd></dd>
202             <dt>HintActive</dt>                 <dd>The hint element of link which will be followed by <k name="CR"/></dd>
203             <dt>HintElem</dt>                   <dd>The hintable element</dd>
204             <dt>HintImage</dt>                  <dd>The indicator which floats above hinted images</dd>
205             <dt>Hint[active]</dt>               <dd></dd>
206             <dt>Indicator</dt>                  <dd>The <em>#</em> and  <em>%</em> in the <ex>:buffers</ex> list</dd>
207             <dt>InfoMsg</dt>                    <dd>Information messages</dd>
208             <dt>InlineHelpLink</dt>             <dd>A help link shown in the command line or multi-line output area</dd>
209             <dt>Key</dt>                        <dd>Keywords</dd>
210             <dt>Keyword</dt>                    <dd>A bookmark keyword for a URL</dd>
211             <dt>LineNr</dt>                     <dd>The line number of an error</dd>
212             <dt>Link</dt>                       <dd>A link with additional information shown on hover</dd>
213             <dt>LinkInfo</dt>                   <dd>Information shown when hovering over a link</dd>
214             <dt>Message</dt>                    <dd></dd>
215             <dt>Message</dt>                    <dd>A message as displayed in <ex>:messages</ex></dd>
216             <dt>ModeMsg</dt>                    <dd>The mode indicator</dd>
217             <dt>MoreMsg</dt>                    <dd>The indicator that there is more text to view</dd>
218             <dt>NonText</dt>                    <dd>The <em>~</em> indicators which mark blank lines in the completion list</dd>
219             <dt>Normal</dt>                     <dd>Normal text</dd>
220             <dt>Null</dt>                       <dd>JavaScript null values</dd>
221             <dt>Number</dt>                     <dd>JavaScript numbers</dd>
222             <dt>Object</dt>                     <dd>JavaScript objects</dd>
223             <dt>Preview</dt>                    <dd>The completion preview displayed in the &tag.command-line;</dd>
224             <dt>Question</dt>                   <dd>A prompt for a decision</dd>
225             <dt>REPL-E</dt>                     <dd>Evaled input in REPL mode</dd>
226             <dt>REPL-P</dt>                     <dd>Evaled output in REPL mode</dd>
227             <dt>REPL-R</dt>                     <dd>Prompts in REPL mode</dd>
228             <dt>REPL</dt>                       <dd>Read-Eval-Print-Loop output</dd>
229             <dt>StatusInfoMsg</dt>              <dd>Information messages in the status line</dd>
230             <dt>StatusLine</dt>                 <dd>The status bar</dd>
231             <dt>StatusLineBroken</dt>           <dd>The status bar for a broken web page</dd>
232             <dt>StatusLineExtended</dt>         <dd>The status bar for a secure web page with an Extended Validation (EV) certificate</dd>
233             <dt>StatusLineNormal</dt>           <dd>The status bar for an ordinary web page</dd>
234             <dt>StatusLineSecure</dt>           <dd>The status bar for a secure web page</dd>
235             <dt>StatusModeMsg</dt>              <dd>The mode indicator in the status line</dd>
236             <dt>StatusMoreMsg</dt>              <dd></dd>
237             <dt>StatusNormal</dt>               <dd>Normal text in the status line</dd>
238             <dt>StatusQuestion</dt>             <dd>A prompt for a decision in the status line</dd>
239             <dt>StatusWarningMsg</dt>           <dd>A warning message in the status line</dd>
240             <dt>String</dt>                     <dd>String values</dd>
241             <dt>TabClose</dt>                   <dd>The close button of a browser tab</dd>
242             <dt>TabIcon</dt>                    <dd>The icon of a browser tab</dd>
243             <dt>TabIconNumber</dt>              <dd>The number of a browser tab, over its icon</dd>
244             <dt>TabNumber</dt>                  <dd>The number of a browser tab, next to its icon</dd>
245             <dt>TabText</dt>                    <dd>The text of a browser tab</dd>
246             <dt>Tag</dt>                        <dd>A bookmark tag for a URL</dd>
247             <dt>Title</dt>                      <dd>The title of a listing, including <ex>:pageinfo</ex>, <ex>:jumps</ex></dd>
248             <dt>URL:hover</dt>                  <dd></dd>
249             <dt>URL</dt>                        <dd>A URL</dd>
250             <dt>URLExtra</dt>                   <dd>Extra information about a URL</dd>
251             <dt>Usage</dt>                      <dd>Output from the :*usage commands</dd>
252             <dt>UsageBody</dt>                  <dd>The body of listings in output from the :*usage commands</dd>
253             <dt>UsageHead</dt>                  <dd>Headings in output from the :*usage commands</dd>
254             <dt>UsageItem</dt>                  <dd>Individual items in output from the :*usage commands</dd>
255             <dt>WarningMsg</dt>                 <dd>A warning message</dd>
256         </dl>
257
258         <p>
259             The help system also has a comprehensive set of styling groups
260             which are not explained here, but many of which are described
261             along with <t>writing-docs</t>.
262         </p>
263
264         <p>
265             Every invocation completely replaces the styling of any previous
266             invocation, unless <em>-append</em> (short name <em>-a</em>) is
267             provided, in which case <a>css</a> is appended to its current
268             value. If <a>css</a> is not provided, any styles beginning with
269             <a>group</a> are listed.
270         </p>
271     </description>
272 </item>
273
274 <item>
275     <tags>:highlight-clear</tags>
276     <spec>:hi<oa>ghlight</oa> clear <oa>group</oa></spec>
277     <description>
278         <p>
279             Reset the highlighting for <oa>group</oa> to its default value. If
280             <oa>group</oa> is not given, reset all highlighting groups.
281         </p>
282     </description>
283 </item>
284
285 <item>
286     <tags>:sty :style</tags>
287     <strut/>
288     <spec>:sty<oa>le</oa> <oa>-name=<a>name</a></oa> <oa>-group=<a>name</a></oa> <oa>-agent</oa> <a>filter</a> <a>css</a></spec>
289     <spec>:sty<oa>le</oa> -name=<a>name</a> -append <a>filter</a> <a>css</a></spec>
290     <spec>:sty<oa>le</oa> <oa>-name=<a>name</a></oa> <oa>-group=<a>name</a></oa> <oa>filter</oa></spec>
291     <strut/>
292     <description>
293         <p>
294             Add CSS styles to the browser or to web pages. <a>filter</a> is a
295             comma-separated list of <t>site-filters</t> for which the style will
296             apply. The <tt>!</tt> character may not be used to invert the sense
297             of the match. <oa>css</oa> is a full CSS rule set (e.g., <tt>body {
298             color: blue; }</tt>).
299         </p>
300
301         <p>The following options are available:</p>
302         <dl>
303             <dt>-append</dt>
304             <dd>If provided along with <em>-name</em>, <a>css</a> and
305                 <a>filter</a> are appended to its current value. (short name
306                 <em>-a</em>)</dd>
307
308             <dt>-agent</dt>
309             <dd>If provided, the style is installed as an Agent sheet, which
310                 applies to contents user interface widgets as well as normal
311                 elements. (short name <em>-A</em>)</dd>
312
313             <dt>-group=<a>group</a></dt>
314             <dd>The <t>group</t> to which to add this style. Please note that
315                 this grouping is for semantic and cleanup purposes only. No
316                 additional site filtering is applied.</dd>
317
318             <dt>-name=<a>name</a></dt>
319             <dd>If provided, any existing style with the same name is
320                 overridden, and the style may later be deleted using
321                 <a>name</a>. (short name <em>-n</em>)</dd>
322
323         </dl>
324
325         <p>If <oa>css</oa> isn't provided, matching styles are listed.</p>
326     </description>
327 </item>
328
329 <item>
330     <tags>:dels :delstyle</tags>
331     <strut/>
332     <spec>:dels<oa>tyle</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
333     <description>
334         <p>
335             Delete any matching styles. With <oa>!</oa>, delete all styles.
336             If <oa>filter</oa> is provided, only matching elements of the
337             filter are disabled. For instance, when run with a filter
338             <str delim="">mozilla.org</str>, an existing style with a filter
339             <str delim="">www.google.com,mozilla.org</str>, will result in a style for
340             <str delim="">www.google.com</str>.
341         </p>
342
343         <p>The available options are:</p>
344
345         <dl>
346             <dt>-name</dt>  <dd>The name provided to <ex>:style</ex> (short name <em>-n</em>)</dd>
347             <dt>-index</dt> <dd>For unnamed styles, the index listed by <ex>:style</ex>
348                 (short name <em>-i</em>)</dd>
349         </dl>
350     </description>
351 </item>
352
353 <item>
354     <tags>:styleenable :stylee</tags>
355     <tags>:styenable :stye</tags>
356     <strut/>
357     <spec>:styled<oa>isable</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
358     <description>
359         <p>Enable any matching styles. With <oa>!</oa>, enable all styles. Arguments are the same as for <ex>:delstyle</ex></p>
360     </description>
361 </item>
362
363 <item>
364     <tags>:styledisable :styled</tags>
365     <tags>:stydisable :styd</tags>
366     <strut/>
367     <spec>:stylee<oa>nable</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
368     <description>
369         <p>Disable any matching styles. With <oa>!</oa>, disable all styles. Arguments are the same as for <ex>:delstyle</ex></p>
370     </description>
371 </item>
372
373 <item>
374     <tags>:styletoggle :stylet</tags>
375     <tags>:stytoggle :styt</tags>
376     <strut/>
377     <spec>:stylet<oa>oggle</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
378     <description>
379         <p>Toggle any matching styles. With <oa>!</oa>, toggle all styles. Arguments are the same as for <ex>:delstyle</ex></p>
380     </description>
381 </item>
382
383 </document>
384
385 <!-- vim:se sts=4 sw=4 et: -->