common/locale/en-US/buffer.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="buffer"
   8     title="&dactyl.appName; Buffer"
   9     xmlns="&xmlns.dactyl;"
  10     xmlns:html="&xmlns.html;">
  11
  12 <h1 tag="buffer document">Buffer</h1>
  13 <toc start="2"/>
  14
  15 <p>
  16     A buffer is a container that holds the given web page, including
  17     all of its history and frames. Each tab contains exactly one
  18     buffer, and for most purposes the two terms are interchangeable.
  19     See <t>tabs</t> for more.
  20 </p>
  21
  22 <h2 tag="buffer-information">Buffer information</h2>
  23
  24 <item>
  25     <tags><![CDATA[<page-info> <C-g>]]></tags>
  26     <strut/>
  27     <spec>&lt;C-g></spec>
  28     <description>
  29         <p>
  30             Print the current file name along with basic page
  31             information including last modification time, the number
  32             of feeds present, and the page title.
  33         </p>
  34     </description>
  35 </item>
  36
  37 <item>
  38     <tags><![CDATA[<more-page-info> g<C-g>]]></tags>
  39     <spec>g&lt;C-g></spec>
  40     <description short="true">
  41         <p>Print file information. Same as <ex>:pa<oa>geinfo</oa></ex>.</p>
  42     </description>
  43 </item>
  44
  45 <item>
  46     <tags>:pa :pageinfo</tags>
  47     <spec>:pa<oa>geinfo</oa> <oa>items</oa></spec>
  48     <description>
  49         <p>
  50             Show various page information. The information provided
  51             is determined by the value of <o>pageinfo</o>, or
  52             <oa>items</oa> if present.
  53         </p>
  54     </description>
  55 </item>
  56
  57 <item>
  58     <tags><![CDATA[<view-source> gf]]></tags>
  59     <strut/>
  60     <spec>gf</spec>
  61     <description>
  62         <p>
  63             View source. Toggles between the source and rendered
  64             content of the page.
  65         </p>
  66     </description>
  67 </item>
  68
  69 <item>
  70     <tags><![CDATA[<view-source-externally> gF]]></tags>
  71     <strut/>
  72     <spec>gF</spec>
  73     <description>
  74         <p>
  75             View source with an external editor. Opens the source
  76             code of the current web site with the external editor
  77             specified by the <o>editor</o> option.
  78         </p>
  79     </description>
  80 </item>
  81
  82 <item>
  83     <tags>:vie :viewsource</tags>
  84     <spec>:vie<oa>wsource</oa><oa>!</oa> <oa>url</oa></spec>
  85     <description>
  86         <p>
  87             View source code of current document. If <oa>url</oa> is
  88             specified then view the source of that document. When
  89             <oa>!</oa> is given, it is opened with the external
  90             editor.
  91         </p>
  92     </description>
  93 </item>
  94
  95 <h2 tag="motion scrolling">Motion commands</h2>
  96
  97 <item>
  98     <tags>&lt;scroll-begin> ^ 0</tags>
  99     <strut/>
 100     <spec>0</spec>
 101     <description>
 102         <p>
 103             Scroll to the absolute left of the document. Unlike in
 104             Vim, <k>0</k> and <k>^</k> work exactly the same way.
 105         </p>
 106     </description>
 107 </item>
 108
 109 <item>
 110     <tags>&lt;scroll-end> $</tags>
 111     <spec>$</spec>
 112     <description short="true">
 113         <p>Scroll to the absolute right of the document</p>
 114     </description>
 115 </item>
 116
 117 <item>
 118     <tags><![CDATA[<scroll-top> <Home> gg]]></tags>
 119     <strut/>
 120     <spec><oa>count</oa>gg</spec>
 121     <description>
 122         <p>
 123             Go to the top of the document. With <oa>count</oa>,
 124             scroll vertically to <oa>count</oa> percent of the
 125             document.
 126         </p>
 127     </description>
 128 </item>
 129
 130 <item>
 131     <tags><![CDATA[<scroll-bottom> <End> G]]></tags>
 132     <strut/>
 133     <spec><oa>count</oa>G</spec>
 134     <description>
 135         <p>
 136             Go to the end of the document. With <oa>count</oa>,
 137             behaves exactly the same as <oa>gg</oa>.
 138         </p>
 139     </description>
 140 </item>
 141
 142 <item>
 143     <tags>&lt;scroll-percent> N%</tags>
 144     <spec><a>count</a>%</spec>
 145     <description short="true">
 146         <p>Scroll to <a>count</a> percent of the document.</p>
 147     </description>
 148 </item>
 149
 150 <item>
 151     <tags><![CDATA[<scroll-left-column> <Left> h]]></tags>
 152     <strut/>
 153     <spec><oa>count</oa>h</spec>
 154     <description>
 155         <p>
 156             Scroll document to the left. If <oa>count</oa> is specified,
 157             repeat <oa>count</oa> times.
 158         </p>
 159     </description>
 160 </item>
 161
 162 <item>
 163     <tags><![CDATA[<scroll-down-line> <C-e> <Down> j]]></tags>
 164     <strut/>
 165     <spec><oa>count</oa>j</spec>
 166     <description>
 167         <p>
 168             Scroll document to the down. If <oa>count</oa> is specified,
 169             repeat <oa>count</oa> times.
 170         </p>
 171     </description>
 172 </item>
 173
 174 <item>
 175     <tags><![CDATA[<scroll-up-line> <C-y> <Up> k]]></tags>
 176     <strut/>
 177     <spec><oa>count</oa>k</spec>
 178     <description>
 179         <p>
 180             Scroll document to the up. If <oa>count</oa> is specified,
 181             repeat <oa>count</oa> times.
 182         </p>
 183     </description>
 184 </item>
 185
 186 <item>
 187     <tags><![CDATA[<scroll-right-column> <Right> l]]></tags>
 188     <strut/>
 189     <spec><oa>count</oa>l</spec>
 190     <description>
 191         <p>
 192             Scroll document to the right. If <oa>count</oa> is specified,
 193             repeat <oa>count</oa> times.
 194         </p>
 195     </description>
 196 </item>
 197
 198 <item>
 199     <tags><![CDATA[<scroll-down> <C-d>]]></tags>
 200     <strut/>
 201     <spec><oa>count</oa>&lt;C-d></spec>
 202     <description>
 203         <p>
 204             Scroll window downwards by the amount specified in the
 205             <o>scroll</o> option. With <oa>count</oa>, scroll as if
 206             <o>scroll</o> were set to <oa>count</oa>.
 207         </p>
 208     </description>
 209 </item>
 210
 211 <item>
 212     <tags><![CDATA[<scroll-up> <C-u>]]></tags>
 213     <strut/>
 214     <spec><oa>count</oa>&lt;C-u></spec>
 215     <description>
 216         <p>
 217             Scroll window upwards by the amount specified in the
 218             <o>scroll</o> option. With <oa>count</oa>, scroll as if
 219             <o>scroll</o> were set to <oa>count</oa>.
 220         </p>
 221     </description>
 222 </item>
 223
 224 <item>
 225     <tags><![CDATA[<scroll-up-page> <S-Space> <PageUp> <C-b>]]></tags>
 226     <strut/>
 227     <spec><oa>count</oa>&lt;C-b></spec>
 228     <description>
 229         <p>
 230             Scroll up a full page. With <oa>count</oa>, scroll up
 231             <oa>count</oa> full pages.
 232         </p>
 233     </description>
 234 </item>
 235
 236 <item>
 237     <tags><![CDATA[<scroll-down-page> <Space> <PageDown> <C-f>]]></tags>
 238     <strut/>
 239     <spec><oa>count</oa>&lt;C-f></spec>
 240     <description>
 241         <p>
 242             Scroll down a full page. With <oa>count</oa>, scroll
 243             down <oa>count</oa> full pages.
 244         </p>
 245     </description>
 246 </item>
 247
 248 <h2 tag="jumping">Jumping to elements</h2>
 249
 250 <item>
 251     <tags><![CDATA[<Tab>]]></tags>
 252     <spec>&lt;Tab></spec>
 253     <description short="true">
 254         <p>Advance keyboard focus to the next element.</p>
 255     </description>
 256 </item>
 257
 258 <item>
 259     <tags><![CDATA[<S-Tab>]]></tags>
 260     <spec>&lt;S-Tab></spec>
 261     <description short="true">
 262         <p>Rewind keyboard focus to the previous element.</p>
 263     </description>
 264 </item>
 265
 266 <item>
 267     <tags>&lt;focus-input> gi</tags>
 268     <strut/>
 269     <spec><oa>count</oa>gi</spec>
 270     <description>
 271         <p>
 272             Focus last used input field. If there is no last input
 273             field, focus the first input field. With <oa>count</oa>,
 274             focus the <oa>count</oa>th input field.
 275         </p>
 276     </description>
 277 </item>
 278
 279 <item>
 280     <tags>&lt;next-frame> ]f</tags>
 281     <strut/>
 282     <spec><oa>count</oa>]f</spec>
 283     <description>
 284         <p>
 285             Transfer keyboard focus to the <oa>count</oa>th next
 286             frame. The newly focused frame is briefly highlighted
 287             with <h>FrameIndicator</h>.
 288         </p>
 289     </description>
 290 </item>
 291
 292 <item>
 293     <tags>&lt;previous-frame> [f</tags>
 294     <strut/>
 295     <spec><oa>count</oa>[f</spec>
 296     <description>
 297         <p>
 298             Transfer keyboard focus to the <oa>count</oa>th next
 299             previous frame. The newly focused frame is briefly highlighted
 300             with <h>FrameIndicator</h>.
 301         </p>
 302     </description>
 303 </item>
 304
 305 <item>
 306     <tags>&lt;next-page> ]]</tags>
 307     <strut/>
 308     <spec><oa>count</oa>]]</spec>
 309     <description>
 310         <p>
 311             Follow the last link matching <o>nextpattern</o>. Used,
 312             for instance, to move to the next page of search
 313             results.
 314         </p>
 315     </description>
 316 </item>
 317
 318 <item>
 319     <tags>&lt;previous-page> [[</tags>
 320     <strut/>
 321     <spec><oa>count</oa>[[</spec>
 322     <description>
 323         <p>
 324             Follow the last link matching <o>previouspattern</o>. Used,
 325             for instance, to move to the previous page of search
 326             results.
 327         </p>
 328     </description>
 329 </item>
 330
 331 <item>
 332     <tags>[h [p [</tags>
 333     <spec><oa>count</oa>[<a>arg</a></spec>
 334     <description short="true">
 335         <p>Jump to the previous element as defined by <o>jumptags</o>.</p>
 336     </description>
 337 </item>
 338
 339 <item>
 340     <tags>]h ]p ]</tags>
 341     <spec><oa>count</oa>]<a>arg</a></spec>
 342     <description short="true">
 343         <p>Jump to the next element as defined by <o>jumptags</o>.</p>
 344     </description>
 345 </item>
 346
 347 <item>
 348     <tags>{</tags>
 349     <spec><oa>count</oa>{</spec>
 350     <description short="true">
 351         <p>Jump to the previous paragraph. Identical to <k>[p</k>.</p>
 352     </description>
 353 </item>
 354
 355 <item>
 356     <tags>}</tags>
 357     <spec><oa>count</oa>}</spec>
 358     <description short="true">
 359         <p>Jump to the next paragraph. Identical to <k>]p</k>.</p>
 360     </description>
 361 </item>
 362
 363
 364 <h2 tag="zooming zoom">Zooming</h2>
 365
 366 <p>
 367     The zooming commands are dependent on two properties—a zoom
 368     range and a series of levels within that range.
 369 </p>
 370
 371 <p>
 372     The absolute value of the page zoom is limited to a value within
 373     the configured zoom range (default: 30%–300%). By default,
 374     commands which zoom in or out select between the zoom levels,
 375     30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%, 170%,
 376     200%, 240%, 300%.
 377 </p>
 378
 379 <p>
 380     The available zoom range can be changed by setting the
 381     <pref>zoom.minPercent</pref>
 382     and
 383     <pref>zoom.maxPercent</pref>
 384     &dactyl.host; preferences. The zoom levels can be changed using the
 385     <pref>toolkit.zoomManager.zoomValues</pref>
 386     preference.
 387 </p>
 388
 389 <note>
 390     <pref>toolkit.zoomManager.zoomValues</pref> is specified as a
 391     list of values between <em>0</em> and <em>1</em> rather than
 392     percentages. For instance, <em>0.5</em> is equivalent to
 393     <em>50%</em>.
 394 </note>
 395
 396 <item>
 397     <tags><![CDATA[<text-zoom-in> + zi]]></tags>
 398     <spec><oa>count</oa>zi</spec>
 399     <description short="true">
 400         <p>Enlarge text zoom of current web page. Mnemonic: zoom in.</p>
 401     </description>
 402 </item>
 403
 404 <item>
 405     <tags><![CDATA[<text-zoom-more> zm]]></tags>
 406     <strut/>
 407     <spec><oa>count</oa>zm</spec>
 408     <description>
 409         <p>Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 410     </description>
 411 </item>
 412
 413 <item>
 414     <tags><![CDATA[<text-zoom-out> - zo]]></tags>
 415     <spec><oa>count</oa>zo</spec>
 416     <description short="true">
 417         <p>Reduce text zoom of current web page. Mnemonic: zoom out.</p>
 418     </description>
 419 </item>
 420
 421 <item>
 422     <tags><![CDATA[<text-zoom-reduce> zr]]></tags>
 423     <spec><oa>count</oa>zr</spec>
 424     <description short="true">
 425         <p>Reduce text zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
 426     </description>
 427 </item>
 428
 429 <item>
 430     <tags><![CDATA[<text-zoom> zz]]></tags>
 431     <strut/>
 432     <spec><oa>count</oa>zz</spec>
 433     <description>
 434         <p>
 435             Set text zoom value of current web page. Zoom value can
 436             be between 30% and 300%.  If it is omitted, text zoom is
 437             reset to 100%.
 438         </p>
 439     </description>
 440 </item>
 441
 442 <item>
 443     <tags><![CDATA[<full-zoom-in> ZI zI]]></tags>
 444     <spec><oa>count</oa>ZI</spec>
 445     <description short="true">
 446         <p>Enlarge full zoom of current web page. Mnemonic: zoom in.</p>
 447     </description>
 448 </item>
 449
 450 <item>
 451     <tags><![CDATA[<full-zoom-more> ZM zM]]></tags>
 452     <strut/>
 453     <spec><oa>count</oa>ZM</spec>
 454     <description>
 455         <p>Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more.</p>
 456     </description>
 457 </item>
 458
 459 <item>
 460     <tags><![CDATA[<full-zoom-out> ZO zO]]></tags>
 461     <spec><oa>count</oa>ZO</spec>
 462     <description short="true">
 463         <p>Reduce full zoom of current web page. Mnemonic: zoom out.</p>
 464     </description>
 465 </item>
 466
 467 <item>
 468     <tags><![CDATA[<full-zoom-reduce> ZR zR]]></tags>
 469     <spec><oa>count</oa>ZR</spec>
 470     <description short="true">
 471         <p>Reduce full zoom of current web page by a larger amount. Mnemonic: zoom reduce.</p>
 472     </description>
 473 </item>
 474
 475 <item>
 476     <tags><![CDATA[<full-zoom> zZ]]></tags>
 477     <strut/>
 478     <spec><oa>count</oa>zZ</spec>
 479     <description>
 480         <p>
 481             Set full zoom value of current web page. Zoom value can be between 30 and
 482             300%. If it is omitted, full zoom is reset to 100%.
 483         </p>
 484     </description>
 485 </item>
 486
 487 <item>
 488     <tags>:zo :zoom</tags>
 489     <spec>:zo<oa>om</oa><oa>!</oa> <oa>value</oa></spec>
 490     <spec>:zo<oa>om</oa><oa>!</oa> +<a>value</a></spec>
 491     <spec>:zo<oa>om</oa><oa>!</oa> -<a>value</a></spec>
 492     <description>
 493         <p>
 494             Set zoom value of current web page. <oa>value</oa> can be an absolute value
 495             between 30% and 300% or a relative value if prefixed with "-" or "+". If
 496             <oa>value</oa> is omitted, zoom is reset to 100%.
 497         </p>
 498
 499         <p>
 500             Normally this command operates on the text zoom; if used with <oa>!</oa>, it
 501             operates on full zoom.
 502         </p>
 503     </description>
 504 </item>
 505
 506 <h2 tag="frames">Working with frames</h2>
 507
 508 <item>
 509     <tags>:frameo :frameonly</tags>
 510     <spec>:frameo<oa>nly</oa></spec>
 511     <description short="true">
 512         <p>Show only the current frame's page.</p>
 513     </description>
 514 </item>
 515
 516 <h2 tag="copying yanking">Copying text</h2>
 517
 518 <p>
 519     When running in X11, the text of the following commands is not only
 520     copied to the clipboard but is also put into the X11 selection, which
 521     can be pasted with the middle mouse button:
 522 </p>
 523
 524 <item>
 525     <tags>&lt;yank-location> y</tags>
 526     <spec>y</spec>
 527     <description short="true">
 528         <p>Yank current location to the clipboard.</p>
 529     </description>
 530 </item>
 531
 532 <item>
 533     <tags>&lt;yank-word> Y</tags>
 534     <spec>Y</spec>
 535     <description short="true">
 536         <p>Copy currently selected text to the system clipboard.</p>
 537     </description>
 538 </item>
 539
 540 <h2 tag="alternate-stylesheet">Alternate style sheets</h2>
 541
 542 Page authors may specify alternate style sheets for an HTML
 543 document. Users can then switch between these various style sheets,
 544 selecting their favorite.
 545
 546 <item>
 547     <tags>:pagest :pagestyle</tags>
 548     <spec>:pagest<oa>yle</oa> <oa>stylesheet</oa></spec>
 549     <description>
 550         <p>
 551             Select the author style sheet to apply. If
 552             <oa>stylesheet</oa> is not specified the page's default
 553             style sheet is used.
 554         </p>
 555
 556         <p>All author styling can be removed by setting the <o>usermode</o> option.</p>
 557     </description>
 558 </item>
 559
 560 </document>
 561
 562 <!-- vim:se sts=4 sw=4 et: -->