- w3m MANUAL
- Options
- Document color
- Key binding
- Page/Cursor motion
- Hyperlink operation
- File/Stream operation
- Buffer operation
- Buffer selection mode
- Bookmark operation
- Search
- Mark operation
- Miscellany
- Line-edit mode
- Lynx-like key binding
- Page/Cursor motion
- Hyperlink operation
- File/Stream operation
- Buffer operation
- Buffer selection mode
- Bookmark operation
- Search
- Mark operation
- Miscellany
- Line-edit mode
- Mouse operation
- Key customization
- Local CGI
w3m MANUAL
w3m is a pager/text-based WWW browser. You can browse local documents and/or documents on the WWW using a terminal emulator.
Options
If you specify filenames/URLs on command line, these documents are displayed. If you specify nothing, w3m reads a document from standard input and display it. If no filename and/or URLs are specified and standard input is tty, w3m terminates without displaying anything.
Options are as follows: + Move to the specified line. -t width Specify tab width. Default is 8. -r When displaying text/plain document, prohibit emphasis using backspace. If you don’t specify this option, «A^H_» is interpreted as underlined character and «A^HA» as a bold character. -l number Specify line number preserved internally when reading text/plain document fron standard input. Default is 10000. -s Display documents with Shift_JIS code. -e Display documents with EUC_JP code. -j Display documents with ISO-2022-JP code. -T type Specify document type. Without this option, document type is determined from extension of a file. If the determination fails, the document is regarded as text/plain.
Example:
Read HTML document from standard input and display it
cat hoge.html | w3m -T text/html
-m Display document with Internet message mode. With this option, w3m determines document type from header information. It is useful when reading E-mail or NetNews messages. -v visual startup mode. -B Show the bookmark. -bookmark file Specify bookmark file. -M Monochrome display mode. -F Automatically render frame. -S Squeeze blank lines. -X Upon exit, do not display preserved screen. -W Toggle wrap search mode. -o option=value Specify option. The option names and values are same as that appears in ~/.w3m/config. -cookie Process cookies. -no-cookie Don’t process cookies. -pauth username:password Set username and password for (basic) proxy authentication. -num Show linenumber. -dump Read document specified by URL and dump formatted text into standard output. The width of the document become 80. This width can be overridden with -cols option. -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 Don’t use graphic character to draw frames. -no-mouse Don’t activate mouse. -config file specify config file.
Document color
Key binding
Here’s the original key-binding table. If you are using Lynx-like key bindings, see the Lynx-like key binding.
Page/Cursor motion
Hyperlink operation
File/Stream operation
Buffer operation
Buffer selection mode
Bookmark operation
Search
Mark operation
Miscellany
Line-edit mode
Lynx-like key binding
If you have chosen `Lynx-like key binding’ at the compile time, you can use the following key binding.
Page/Cursor motion
File/Stream operation
Buffer operation
Buffer selection mode
Bookmark operation
Search
Mark operation
Miscellany
Line-edit mode
Mouse operation
If w3m is compiled with mouse option and you are using xterm/kterm/rxvt (in this case, you have to set the TERM environment variable to `xterm’ or `kterm’.) or GPM environment, you can use mouse for the navigation.
Key customization
You can customize the key binding (except line-editing keymap) by describing ~/.w3m/keymap. For example,
binds `NEXT_PAGE’ function (normally bound to SPC and C-v) to control-o. See README.func for 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. It means that w3m behaves like an HTTP server and activates CGI script, then w3m reads the output of the script and display it. The bookmark registration and helper-app editor are realized as local CGI scripts. Using local CGI, w3m can be used as a general purpose form interface.
- The directory where w3m-related files are stored (typically /usr/local/lib/w3m). This directory can be referred as $LIB.
- /cgi-bin/ directory. You can map /cgi-bin/ to any directory you like with option setting panel («Directory corresponds to /cgi-bin» field). You can specify multiple paths separated by `:’, like /usr/local/cgi-bin:/home/aito/cgi-bin. It is not recommended to include current directory to this path.
The CGI script can use 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 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.
One w3m-control: header have to contain only one function, but you can include more than one w3m-control: lines in the HTTP header. In addition, you can specify an argument to GOTO function:
Content-Type: text/plain W3m-control: GOTO http://www.yahoo.com/
Content-Type: text/plain Location: http://www.yahoo.com/Adblock
detector