Bug#772341: w3m: i18n, l10n for FAQ.html, MANUAL.html and README.func.gz for German

Sun, 03 Apr 2016 03:24:24 -0700 

Hello Tatsuya,

Tatsuya Kinoshita schrieb am  2. April 2016 um 00:45

> >   FAQ.html,
> >   as attachment to message
> >   https://lists.debian.org/debian-l10n-english/2014/12/msg00002.html
> >
> >   MANUAL.html
> >   as attachment to message
> >   https://lists.debian.org/debian-l10n-english/2014/12/msg00030.html
> >
> >   README.func.gz
> >   as attachment to message
> >   https://lists.debian.org/debian-l10n-english/2015/02/msg00011.html
> >
> > Please introduce these improved documentation files to the sources of
> > w3m. They shall serve as basics for my translation into German.
 
> Merged in the development repo, see the latest master branch.
> 
>   - https://anonscm.debian.org/cgit/collab-maint/w3m.git/tree/doc
 
> Though not gettextized, if these documents are translated into
> German, I'll include them in the doc-de directory (will be
> installed in /usr/share/doc/w3m/de for Debian packages).

thanks for intruducing them into the development repo.

For translating the documentation, I'm using the packages po4a and
translate-toolkit. This is efficient as phrases/descriptions appear
several times throughout the documentation.

But html2po from translate-toolkit complains about a few HTML-syntax
errors in FAQ.html and MANUAL.html. This forced me to revise Justin
Ryes files.

Moreover, I found as well clear errors:

For example in FAQ.html

       <q>Display with color</q> as ON
shall be
       <q>Display with color</q> as <q>YES</q>


In MANUAL.html, I found that the English phrases are still difficult
to understand, for example

     An 80 column width is used unless set with the -cols option.

shall be

     A width of 80 columns is used unless option -cols sets another
     value.

And often the article the could be inserted, for example

    Go to bookmarks page

shall be

    Go to the bookmarks page


I suggest that I add new FAQ.html and MANUAL.html to the mail with
which I am going pass my German translations of these two documents.

In MANUAL.html, it would make sense to perform what Justin noted as
"TODO": Replacing explanations to options with those from the current
version of manual page w3m (1). Currently, I inserted hidden, using
HTML-comments <!-- -->.

I case You want to have a look on my working versions of the two
documents, I attach them to this mail.

Presently, German versions of w3m.1 and w3mman.1 are about to be
revised by the German language team.

Best regards
Markus

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
<html>
 <head>
  <meta http-equiv=content-type content="text/html;charset=US-ASCII">
  <title>W3M FAQ</title>
 </head>
 <body>
  <h1 align="center">
   Frequently Asked Questions and Answers about w3m
  </h1>
  <p align="right">
   Akinori Ito<br>
   [email protected]<br>
   Corrected by Tom Berger &lt;[email protected]&gt;
  </p>
  <h2 id="index">
   <u>
    Index
   </u>
  </h2>
  <ul>
   <li>
    <a href="#general">
     <b>
      General Questions, How to Get It, Required Environment
     </b>
    </a>
   </li>
    <ul>
     <li>
      <b>
       How do I pronounce <q>w3m</q>?
      </b>
     </li>
     <li>
      <b>
       Why is it called <q>w3m</q>?
      </b>
     </li>
     <li>
      <b>
       On which platforms does w3m work?
      </b>
     </li>
     <li>
      <b>
       Where can I get more information about w3m?
      </b>
     </li>
     <li>
      <b>
       Is there a mailing list for w3m?
      </b>
     </li>
     <li>
      <b>
       Are there any binary distributions?
      </b>
     </li>
    </ul>
   <li>
    <a href="#install">
     <b>
      Compile and Install
     </b>
    </a>
   </li>
   <li>
    <a href="#command">
     <b>
      Options, Commands, Usage
     </b>
    </a>
   </li>
    <ul>
     <li>
      <b>
       w3m quits if started without parameters. What's wrong?
      </b>
     </li>
     <li>
      <b>
       w3m starts with black characters on a black background. How do
       I change this?
      </b>
     </li>
     <li>
      <b>
       Does w3m support colors?
      </b>
     </li>
     <li>
      <b>
       Does w3m support monochrome displays?
      </b>
     </li>
     <li>
      <b>
       How do I shift the display?
      </b>
     </li>
     <li>
      <b>
       How do I move from anchor to anchor?
      </b>
     </li>
     <li>
      <b>
       Graphical browsers display a word red, but w3m doesn't. Why?
      </b>
     </li>
     <li>
      <b>
       How do I change the color of anchor/image/form links?
      </b>
     </li>
     <li>
      <b>
       w3m doesn't seem to use the variable EDITOR. Why?
      </b>
     </li>
     <li>
      <b>
       How do I quit a search or URL text input?
      </b>
     </li>
    </ul>
   <li>
    <a href="#www">
     <b>
      Questions about WWW usage
     </b>
    </a>
   </li>
    <ul>
     <li>
      <b>
       How do I fill in forms with w3m?
      </b>
     </li>
     <li>
      <b>
       Seems like w3m is slower than some other browsers. Why?
      </b>
     </li>
     <li>
      <b>
       Loading time doesn't decrease when loading a previously seen
       page.
      </b>
     </li>
     <li>
      <b>
       How do I download a linked file?
      </b>
     </li>
     <li>
      <b>
       How do I specify a proxy server?
      </b>
     </li>
     <li>
      <b>
       w3m freezes when I invoke an external browser.
      </b>
     </li>
     <li>
      <b>
       How do I change the default image viewer?
      </b>
     </li>
     <li>
      <b>
       How do I enter a URL?
      </b>
     </li>
     <li>
      <b>
       w3m appends a URL to the former one even when I clear the line
       with Ctrl-u. What should I do?
      </b>
     </li>
    </ul>
   <li>
    <a href="#other">
     <b>
      Miscellaneous
     </b>
    </a>
   </li>
    <ul>
     <li>
      <b>
       What is w3m's configuration file?
      </b>
     </li>
     <li>
      <b>
       What are these w3mxxxx files in my ~/.w3m directory for?
      </b>
     </li>
    </ul>
  </ul>
  <h2 id="general">
   <u>
    General Questions, How to Get It, Required Environment
   </u>
  </h2>
  <dl>
   <dt>
    <b>
     How do I pronounce <q>w3m</q>?
    </b>
   </dt>
   <dd>
    <p>
     It's <q>W-three-M</q>. It doesn't rhyme with <q>pteranodon</q>.
    </p>
   </dd>
   <dt>
    <b>
     Why is it called <q>w3m</q>?
    </b>
   </dt>
   <dd>
    <p>
     It's an abbreviation of <q>WWW-wo-Miru</q>, which is Japanese
     for <q>See the WWW</q>. So in English the name of this browser
     would be something like <q>stw3</q>.
    </p>
   </dd>
   <dt>
    <b>
     On which platforms does w3m work?
    </b>
   </dt>
   <dd>
    <p>
     It runs on various versions of Unix, since version 990226 on OS/2
     and since version 990303 also on MS-Windows with Cygwin32.
    </p>
    <p>
     More recent versions have been confirmed to run on:
    </p>
    <ul>
     <li>
      SunOS 4.1.x
     </li>
     <li>
      HP-UX 9.x, 10.x
     </li>
     <li>
      Solaris 2.5.x, 2.6, 8
     </li>
     <li>
      Linux 2.0.1 to 3.17
     </li>
     <li>
      FreeBSD 2.2.8, 3.1, 3.2, 4.6
     </li>
     <li>
      NetBSD/macppc, m68k
     </li>
     <li>
      EWS4800 Rel.12.2 Rev.A
     </li>
     <li>
      Digital UNIX: v3.2D, v4.0D
     </li>
     <li>
      IRIX 5.3, IRIX 6.5
     </li>
     <li>
      OS/2 with emx
      </li>
     <li>
      Windows 9x/NT with Cygwin32 b20.1
     </li>
     <li>
      MS-DOS with DJGPP and WATT32 packet driver
     </li>
     <li>
      MacOS X Server
     </li>
     <li>
      MacOS X 10.1, 10.2
     </li>
    </ul>
   </dd>
   <dt>
    <b>
     Where can I get more information about w3m?
    </b>
   </dt>
   <dd>
    <p>
     At the
     <a href="http://w3m.sourceforge.net/index.en.html";>English w3m
     home page</a>.
    </p>
   </dd>
   <dt>
    <b>
     Is there a mailing list for w3m?
    </b>
   </dt>
   <dd>
    <p>
     There is a mailing list for developers (w3m-dev-en). Please see
     the <a href="http://w3m.sourceforge.net/index.en.html";>w3m home
     page</a> for details. You may also mail your comments to
     <a href="mailto:[email protected]";>the author</a>.
    </p>
   </dd>
   <dt>
    <b>
     Are there any binary distributions?
    </b>
   </dt>
   <dd>
    <p>
     So far there are only binaries for the win/cygnus32 version.
<!--
     You can get them from
     <a href="http://prdownloads.sourceforge.net/w3m/";>here</a>.
!-->
     Contact <a href="mailto:[email protected]";>the author</a> if you
     want to contribute binaries for other platforms.
    </p>
   </dd>
  </dl>
  <p align="right">
   <i>
    Up to <a href="#index">index</a>
   </i>
  </p>
  <h2 id="install">
   <u>
    Compile and Install
   </u>
  </h2>
  <p>
   No problem :-)
  </p>
  <h2 id="command">
   <u>
    Options, Commands, Usage
   </u>
  </h2>
  <dl>
   <dt>
    <b>
     w3m quits if started without parameters. What's wrong?
    </b>
   </dt>
   <dd>
    <p>
     w3m is a <b>pager</b>. Therefore it just quits when invoked
     without any arguments. Possible arguments are:
    </p>
    <ol>
     <li>
      A filename or URL
     </li>
     <li>
      Pipe from standard input
     </li>
     <li>
      The -B option (show bookmark file)
     </li>
     <li>
      The -v option (visual startup)
     </li>
     <li>
      A specified HTTP_HOME or WWW_HOME variable
     </li>
    </ol>
   </dd>
   <dt>
    <b>
     w3m starts with black characters on a black background. How do I
     change this?
    </b>
   </dt>
   <dd>
    <p>
     When compiled with color support, w3m assumes a white background
     and therefore displays black characters.
    </p>
    <p>
     You may either change the background color of your terminal
     (e.g. with the -bg option in a xterm) or take these steps:
    </p>
    <ul>
     <li>
      invoke w3m with <q>w3m -M</q> (for monochrome),
     </li>
     <li>
      type <q>o</q> to get to the options screen
     </li>
     <li>
      Mark <q>Display with color</q> as <q>YES</q> and choose an
      arbitrary color.
     </li>
     <li>
      Click on [OK].
     </li>
    </ul>
   </dd>
   <dt>
    <b>
     Does w3m support colors?
    </b>
   </dt>
   <dd>
    <p>
     Yes. When you run <q>./configure</q>, answer the question
    </p>
<pre>
Let's do some configurations. Choose config option among the list.

1 - Baby model    (no color, no menu, no mouse, no cookie, no SSL)
2 - Little model  (color, menu, no mouse, no cookie, no SSL)
3 - Mouse model   (color, menu, mouse, no cookie, no SSL)
4 - Cookie model  (color, menu, mouse, cookie, no SSL)
5 - Monster model (with everything; you need openSSL library)
6 - Customize
Which?
</pre>
    <p>
     with 2, 3, 4, or 5.
    </p>
   </dd>
   <dt>
    <b>
     Does w3m support monochrome displays?
    </b>
   </dt>
   <dd>
    <p>
     Yes. You may either
    </p>
    <ol>
     <li>
      Answer the above-mentioned <q>configure</q> question with 1,
      or
     </li>
     <li>
      Invoke w3m with the -M option, or
     </li>
     <li>
      Type <q>o</q> within w3m to enter the options screen and turn
      off color display mode.
     </li>
    </ol>
   </dd>
   <dt>
    <b>
     How do I shift the display?
    </b>
   </dt>
   <dd>
    <p>
     You can shift the display by moving the cursor to the edge of
     the screen. You may also use the <q>&gt;</q>/<q>&lt;</q> or
     <q>.</q>/<q>,</q> keys.
    </p>
    <p>
     Another idea would be adjusting the xterm with the -geometry
     option (e.g. something like <q>xterm -geometry 110x45 -bg white
     -name w3m -e w3m -B</q>).
    </p>
   </dd>
   <dt>
    <b>
     How do I move from anchor to anchor?
    </b>
   </dt>
   <dd>
    <p>
     You can move to the next anchor using TAB. ESC TAB moves the
     cursor to the previous anchor.
    </p>
   </dd>
   <dt>
    <b>
     Graphical browsers display a word red, but w3m doesn't. Why?
    </b>
   </dt>
   <dd>
    <p>
     w3m doesn't support the HTML COLOR="..." attribute. It wouldn't
     be impossible to implement this, but I think it would make
     documents more difficult to read.
    </p>
   </dd>
   <dt>
    <b>
     How do I change the color of anchor/image/form links?
    </b>
   </dt>
   <dd>
    <p>
     Type <q>o</q> within w3m to get the <q>options</q> screen. You
     can change these settings there.
    </p>
   </dd>
   <dt>
    <b>
     w3m doesn't seem to use the variable EDITOR. Why?
    </b>
   </dt>
    <dd>
     <p>
     Go to the <q>options</q> screen using the <q>o</q> key. Any
     entry in the <q>Editor</q> field will override the environment
     variable.
    </p>
    <p>
     If you want to use the editor specified by EDITOR, blank the
     field and press [OK].
     </p>
   </dd>
   <dt>
    <b>
     How do I quit a search or URL text input?
    </b>
   </dt>
   <dd>
    <p>
     Clear input text using CTRL-u and hit RETURN.
    </p>
   </dd>
  </dl>
  <p align="right">
   <i>
    Up to <a href="#index">index</a>
   </i>
  </p>
  <h2 id="www">
   <u>
    Questions about WWW usage
   </u>
  </h2>
  <dl>
   <dt>
    <b>
     How do I fill in forms with w3m?
    </b>
   </dt>
   <dd>
    <p>
     Form input fields are displayed in red (or reverse). Move the
     cursor to them and hit RETURN. Then,
    </p>
    <ul>
     <li>
      if it is a text input field, put in your text on the bottom
      line,
     </li>
     <li>
      if it is a radiobutton or checkbox, that item is selected,
     </li>
     <li>
      if it is a textarea, an editor is spawned,
     </li>
     <li>
      if it is <q>submit</q> or <q>reset</q>, well, just do it.
     </li>
    </ul>
   </dd>
   <dt>
    <b>
     Seems like w3m is slower than some other browsers. Why?
    </b>
   </dt>
   <dd>
    <p>
     w3m renders a HTML document in two passes. Therefore it doesn't
     start to display the document until it has finished reading it.
    </p>
    <p>
     Most other browsers display the document before having read the
     whole page, and therefore seem faster.
    </p>
   </dd>
   <dt>
    <b>
     Loading time doesn't decrease when loading a previously seen
     page.
    </b>
   </dt>
   <dd>
    <p>
     w3m doesn't have its own cache. Therefore, it reads the document
     from the server each time it accesses it. If possible, use a
     cache server.
    </p>
   </dd>
   <dt>
    <b>
     How do I download a linked file?
    </b>
   </dt>
   <dd>
    <p>
     Use <q>a</q> (or <q>d</q> with Lynx-like keybindings) or ESC RET.
     If you want to download an inline image, use ESC <q>I</q>.
    </p>
   </dd>
   <dt>
    <b>
     How do I specify a proxy server?
    </b>
   </dt>
   <dd>
    <p>
     Set the environment variable HTTP_PROXY or use the option
     setting panel (<q>o</q> key). For example, if you want to use
     port 8000 of proxy.example.org, specify
    </p>
<pre>
    http://proxy.example.org:8000/
</pre>
   </dd>
   <dt>
    <b>
     w3m freezes when I invoke an external browser.
    </b>
   </dt>
   <dd>
    <p>
     Enter w3m's option screen using the <q>o</q> key and specify
    </p>
<pre>
    firefox %s &
</pre>
    <p>
     (if you are using Firefox).
    </p>
   </dd>
   <dt>
    <b>
     How do I change the default image viewer?
    </b>
    </dt>
    <dd>
     <p>
      By default w3m uses xv to view images. If you want to change it
      into, let's say, <q>display</q>, add the following line to
      ~/.w3m/mailcap or /etc/mailcap.
     </p>
<pre>
image/*; display %s
</pre>
     <p>
      You can specify external viewers of other file types as well:
     </p>
<pre>
image/*;                     display %s
application/postscript;      ghostview %s
application/x-dvi;           xdvi %s
</pre>
    </dd>
    <dt>
     <b>
      How do I enter a URL?
     </b>
   </dt>
   <dd>
    <p>
     Type SHIFT-u
    </p>
   </dd>
   <dt>
    <b>
     w3m appends a URL to the former one even when I clear the line
     with CTRL-u. What should I do?
    </b>
   </dt>
   <dd>
    <p>
     Enter the <i>complete</i> address, e.g. http://www.slashdot.org.
    </p>
   </dd>
  </dl>
  <p align="right">
   <i>
    Up to <a href="#index">index</a>
   </i>
  </p>
  <h2 id="other">
   <u>
    Miscellaneous
   </u>
  </h2>
  <dl>
   <dt>
    <b>
     What is w3m's configuration file?
    </b>
   </dt>
   <dd>
    <p>
     It is ~/.w3m/config.
    </p>
    <p>
     With this file, you can adjust w3m's behavior by changing the
     values of options whose effects are described in the option
     setting panel. Each line contains one option setting, consisting
     of an option name and its value with a space as a separator.
    </p>
   </dd>
   <dt>
    <b>
     What are these w3mxxxx files in my ~/.w3m directory for?
    </b>
   </dt>
   <dd>
    <p>
     These are temporary files used by w3m when reading documents
     from a WWW server. They are not cache files and are usually
     deleted when w3m is terminated. If any temp files are left
     behind, please remove them yourself.
    </p>
   </dd>
  </dl>
  <p align="right">
   <i>
    Up to <a href="#index">index</a>
   </i>
  </p>
 </body>
</html>
Title: w3m manual

w3m MANUAL

Akinori Ito
[email protected]

Index

Introduction

w3m is a pager/text-based WWW browser. You can browse local documents and/or documents on the WWW using a terminal emulator.

Options

Command line usage is 

    w3m [options] [file|URL]

If you specify filenames/URLs on the command line, these documents are displayed. If you specify nothing, w3m will read a document from standard input and display it. If it doesn't find a document there either then normally w3m will terminate.

Options include:

+number

Move to the specified line-number.

-t width

Specify tab width. Default is 8.

-r

When displaying text/plain documents, prohibit emphasis using backspace. If you don't specify this option, A^H_ is interpreted as an underlined A and A^HA as a bold A.

-l number

Specify the number of lines that should be cached while reading a text/plain document from standard input. Default is 10,000.

-O charset

Specify display/output charset.

-I charset

Specify document charset.

-T type

Specify document type. Without this option, document type is determined from the extension of a file. If the determination fails, the document is regarded as text/plain. For example:

Read HTML document from standard input and display it 

   cat example.html | w3m -T text/html

Display HTML source 

   w3m -T text/plain example.html
-m

Display document using Internet message mode. With this option, w3m determines document type from header information. This is useful when reading e-mail or Usenet news posts.

-v

Show w3m's startup page.

-B

Show w3m's bookmarks page.

-bookmark file

Specify a custom bookmarks file.

-M

Monochrome display mode.

-F

Automatically render HTML frames.

-s

Squeeze blank lines.

-X

Upon exit, do not reinitialize the terminal.

-W

Toggle wrapping mode in searches.

-o option=value

Specify option. The available option names and values are the same as in ~/.w3m/config.

-cookie

Process cookies.

-no-cookie

Don't process cookies.

-num

Show line-numbers.

-dump

Read document specified by URL and dump page rendered as text into standard output. A width of 80 columns is used unless option -cols sets another value.

-cols width

Specify document width. Used with -dump option.

-ppc count

Specify the number of pixels per character (default 8.0). Larger values will make tables narrower.

-dump_source

Read document specified by URL and dump the source.

-dump_head

Read document specified by URL and dump headers.

-dump_both

Read document specified by URL and dump headers and the source.

-dump_extra

Read document specified by URL and dump extra informations, headers, and the source.

-post file

Use POST method with file content.

-header string

Insert string as a header.

-no-proxy

Don't use proxy server.

-no-graph

Use ASCII characters to draw frames rather than graphical ones.

-no-mouse

Deactivate mouse support.

-config file

Specify config file.

Document colors

Links and images are displayed as follows.

  Color mode Monochrome mode
links blue underline
inline images green reverse
form input red reverse

These colors can be customized using the option setting command o.

Key bindings

After invoking w3m, you can control it with keyboard commands.

Here's the original key-binding table. If you are using Lynx-like key bindings, see the Lynx-like key bindings. Throughout, the C- and M- notations indicate the modifiers control and meta (which can be replaced with alt or ESC); on the other hand 2 M simply means 2 followed by M.

In-page navigation

SPC, C-v, +, PGDN Forward page
b, M-v, -, PGUP Backward page
l, C-f, RIGHT Cursor right
h, C-b, LEFT Cursor left
j, C-n, DOWN Cursor down
k, C-p, UP Cursor up
J Scroll screen up one line
K Scroll screen down one line
^, C-a Go to the beginning of line
$, C-e Go to the end of line
w Go to the next word
W Go to the previous word
> Shift screen right
< Shift screen left
. Shift screen one column right
, Shift screen one column left
g, M-<, HOME Go to the first line
G, M->, END Go to the last line
M-g Go to the specified line
Z Center on cursor column
z Center on cursor line
TAB Move to the next hyperlink
C-u, M-TAB Move to the previous hyperlink
[ Move to the first hyperlink
] Move to the last hyperlink

Hyperlink operation

C-j, C-m, RET Follow hyperlink
a, M-RET Save link to file
u Show link URL
i Show image URL
I View inline image
M-I Save inline image to file
: Mark URL-like strings as hyperlinks
M-: Mark Message-ID-like strings as links
c Show current URL
= Show information about current document
C-g Show current position in page
C-h Show browsing history
M Browse current document using external browser (prefix 2 or 3 to invoke alternate configured browsers, e.g. 3 M)
M-M Browse link using external browser (prefixed as above, e.g. 3 M-M)

Bookmark management

M-b Go to the bookmarks page
M-a Bookmark current page

File/stream operation

U Open new URL
V Open new file
@ Execute shell command and view output
# Execute shell command and browse output

Content operations

v Toggle viewing as text or rendered HTML
F Toggle rendering HTML frames
C-l Redraw screen
R Reload
E Edit local source
M-e Edit rendered copy of page
M-s Save source
S Save rendered copy of page

Buffer/tab navigation

B Go back, popping the buffer stack
s Show buffer-stack menu
M-t Show tab menu
T Open current page as new tab
C-t Open link as new tab
} Switch to next tab
{ Switch to previous tab
C-q Close current tab

Search

/ Search forward
? Search backward
C-s Incremental search forward
C-r Incremental search backward
n Next match
N Previous match
C-w Toggle wrapping mode in searches

Mark management

C-SPC Set/unset mark
M-p Go to the previous mark
M-n Go to the next mark
" Mark all occurrences of a regular _expression_

Miscellany

! Execute shell command
M-c Invoke w3m function
H Show help panel
o Show options panel
C-k Show cookie jar
C-c Interrupt
C-z Suspend w3m
q Quit (with confirmation dialog)
Q Quit without confirmation

Two special operational modes exist which have built-in (not redefinable) keymappings:

Menu selection mode

k, C-p, UP Select previous item
j, C-n, DOWN Select next item
D Delete current item
SPC, RET Go to the selected item

Line-editing mode

C-f, RIGHT Move cursor forward
C-b, LEFT Move cursor backward
C-h, BKSPC Delete previous character
C-d Delete current character
C-k Kill everything after cursor
C-u Kill everything before cursor
C-a Move to the beginning of line
C-e Move to the end of line
C-p, UP Fetch the previous string from the history list
C-n, DOWN Fetch the next string from the history list
TAB, SPC Try to complete filename
RET Accept

Lynx-like key bindings

If w3m was compiled with Lynx-like key bindings, you can use the following key bindings.

In-page navigation

SPC, C-v, + Forward page
b, M-v, - Backward page
l Cursor right
h Cursor left
j Cursor down
k Cursor up
J Scroll screen up one line
K Scroll screen down one line
^ Go to the beginning of line
$ Go to the end of line
> Shift screen right
< Shift screen left
. Shift screen one column right
, Shift screen one column left
C-a, M-< Go to the first line
C-e, M-> Go to the last line
G Go to the specified line
w Go to the next word
W Go to the previous word
Z Center on cursor line
z Center on cursor column
TAB, C-n, DOWN Move to the next hyperlink
M-TAB, C-p, C-u, UP Move to the previous link
C-g Show current position in page
[ Move to the first hyperlink
] Move to the last hyperlink

Hyperlink operation

C-f, C-j, C-m, RET, RIGHT Follow hyperlink
d, M-RET Save link to file
u Show link URL
i Show image URL
I View inline image
M-I Save inline image to file
: Mark URL-like strings as hyperlinks
M-: Mark Message-ID-like strings as news anchors
c Show current URL
= Show information about current document
C-h Show browsing history
M Browse current document using external browser (prefix 2 or 3 to invoke alternate configured browsers, e.g. 3 M)
M-M Browse link using external browser (prefixed as above, e.g. 3 M-M)

Bookmark management

v, M-b Go to the bookmarks page
a, M-a Bookmark current page

File/stream operation

g, U Open new URL
V Open new file
@ Execute shell command and view output
# Execute shell command and browse output

Content operations

\ Toggle viewing as text or rendered HTML
F Toggle rendering HTML frames
C-l, C-w Redraw screen
R, C-r Reload
E Edit local source
M-e Edit rendered copy of page
M-s Save source
S, p Save rendered copy of page

Buffer/tab navigation

B, C-b, LEFT Go back, popping the buffer stack
s, C-h Show buffer-stack menu
M-t Show tab menu
T Open current page as new tab
C-t Open link as new tab
} Switch to next tab
{ Switch to previous tab
C-q Close current tab

Search

/, C-s Search forward
n Next match
w Toggle wrapping mode in searches

Mark management

C-SPC Set/unset mark
P Go to the previous mark
N Go to the next mark
" Mark all occurrences of a regular _expression_

Miscellany

! Execute shell command
M-c Invoke w3m function
H, ? Show help panel
o Show options panel
C-k Show cookie jar
C-c Interrupt
C-z Suspend w3m
q Quit (with confirmation dialog)
Q Quit without confirmation

The Lynx-like configuration leaves keymappings unchanged in the menu-selection and line-editing modes.

Mouse operation

If w3m is compiled with mouse support and you are invoking w3m either from a console with GPM or from an X terminal emulator, you can use the mouse for navigation (in the case of rxvt, you need to set the TERM environment variable to xterm or kterm).

left click Move the cursor to the place indicated by the mouse cursor. If you click the cursor and it is on a hyperlink, follow the link.
middle click Back to the previous buffer.
right click Open pop-up menu. You can choose an item by clicking it.
left drag Scroll document. The default behavior is to grab the document and drag it. You can reverse the behavior (grab the window and drag it) with the option setting panel.

Key customization

You can customize the key bindings (except the line-editing keymap) in a ~/.w3m/keymap file. For example, 


   keymap C-o NEXT_PAGE

binds the NEXT_PAGE function (normally bound to SPC and C-v) to control-o. See README.func for a list of available functions. Original and Lynx-like keymap definitions are provided (keymap.default and keymap.lynx) as examples.

Local CGI

You can run CGI scripts using w3m, without any HTTP server. This means that w3m behaves like an HTTP server and runs the CGI script, then reads the output of the script and displays it. For example, the bookmark registration system and default directory browser are realized as local CGI scripts. Moreover, such scripts allow w3m to be used as a form interface to acquire all kinds of data.

For security reason, CGI scripts invoked by w3m must be in one of the following directories:

  • The directory where w3m-related files are stored (typically /usr/local/lib/w3m). This directory can be referenced as $LIB.
  • The /cgi-bin/ directory. You can map /cgi-bin/ to any directory you like in the option setting panel (the Directory corresponds to /cgi-bin field). You can specify multiple paths separated by :, like /usr/local/cgi-bin:/home/aito/cgi-bin. To use a /cgi-bin/ directory, you must use a file:/cgi-bin URL as follows: 
     w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi
    It is not recommended to include the current directory to this path.

The CGI script can use the special header w3m-control: to control w3m. This field can take any function (see README.func), and the specified function is invoked after the document is displayed. For example, the CGI output 


Content-Type: text/plain
W3m-control: BACK

will display a blank page and delete that buffer immediately. This is useful when you don't want to display any page after the script is invoked. The next example 


Content-Type: text/plain
W3m-control: DELETE_PREVBUF

contents.....

will override the current buffer.

Each w3m-control: header can contain only one function, but you can include more than one w3m-control: line in the HTTP header. In addition, you can specify an argument to the GOTO function: 


Content-Type: text/plain
W3m-control: GOTO http://www.example.org/

This example works exactly the same way as the Location header: 


Content-Type: text/plain
Location: http://www.example.org/

Note that this header has no effect when the CGI script is invoked through an HTTP server.

Reply via email to