### Launch xterm with w3m Source: https://github.com/tats/w3m/blob/master/doc/FAQ.html Example of launching an xterm terminal with specific geometry and executing w3m within it. This demonstrates how to configure the terminal environment for w3m. ```shell xterm -geometry 110x45 -bg white -name w3m -e w3m -B ``` -------------------------------- ### w3m Configuration File Structure Source: https://github.com/tats/w3m/blob/master/doc/FAQ.html Illustrates the basic structure of the w3m configuration file, showing how to set options. It also explains the role of the W3M_DIR environment variable and system-wide configuration. ```shell # ~/.w3m/config # OptionName OptionValue ``` -------------------------------- ### w3m General Commands Source: https://github.com/tats/w3m/blob/master/doc-jp/MANUAL.html Provides documentation for general commands like executing shell commands, displaying help, managing options, and quitting the application. ```APIDOC ! : Execute Shell Command Executes a shell command. H, ? : Display Help File Displays the help file. o : Show Options Panel Displays the options configuration panel. C-k : Show Cookie List Displays the list of cookies. C-c : Interrupt Document Loading Interrupts the loading of the current document. C-z : Suspend Suspends the w3m process. q : Quit w3m Exits w3m. May prompt for confirmation based on settings. Q : Force Quit w3m Exits w3m without confirmation. ``` -------------------------------- ### w3m Command-line Options Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html Provides command-line options to customize w3m's behavior, such as specifying alternative bookmark files, configuration files, or modifying configuration items directly. ```APIDOC -bookmark _file_ use _file_ instead of the default bookmark.html file -config _file_ use _file_ instead of the default configuration file -o _option_=_value_ modify one configuration item with an explicitly given value; without _option=value_, equivalent to _-show-option_ ``` -------------------------------- ### w3m Command-Line Options Source: https://github.com/tats/w3m/blob/master/doc-de/MANUAL.html Options to override defaults for settings and data sources. These allow customization of bookmark files, configuration files, and runtime settings. ```APIDOC Command-Line Options: -bookmark _FILE_ Description: Use the specified _FILE_ instead of the default bookmark.html file for bookmarks. -config _FILE_ Description: Use the specified _FILE_ instead of the default configuration file. -o _OPTION_=_VALUE_ Description: Configure the setting _OPTION_ with _VALUE_. If _OPTION_=_VALUE_ is omitted, it is equivalent to -show-option. Example: -o display_color=true ``` -------------------------------- ### w3m Bookmark Operations Source: https://github.com/tats/w3m/blob/master/doc-jp/MANUAL.html Covers keybindings for managing bookmarks, including loading and adding them. ```APIDOC v, ESC b : Load Bookmarks Loads and displays the bookmark list. a, ESC a : Add Current Page to Bookmarks Adds the currently viewed page to the bookmark list. ``` -------------------------------- ### Development Environment Details Source: https://github.com/tats/w3m/blob/master/w3mimg/fb/readme.txt Details of the development environment, including w3m version, Linux kernel, GCC, libraries, and hardware information. ```APIDOC Development Environment: w3m version: w3m/0.3+cvs-1.353-m17n-20020316 OS: linux 2.4.18 (Vine Linux 2.5) Compiler: gcc 2.95.3 Libraries: - GdkPixbuf: 0.16.0 - Imlib2: 1.0.6 System Logs: dmesg | grep vesafb: vesafb: framebuffer at 0xe2000000, mapped to 0xc880d000, size 8192k vesafb: mode is 1024x768x16, linelength=2048, pages=4 vesafb: protected mode interface info at c000:4785 vesafb: scrolling: redraw vesafb: directcolor: size=0:5:6:5, shift=0:11:5:0 Video Card: VGA compatible controller: ATI Technologies Inc 3D Rage Pro AGP 1X/2X (rev 92). Master Capable. Latency=64. Min Gnt=8. Non-prefetchable 32 bit memory at 0xe2000000 [0xe2ffffff]. I/O at 0xd800 [0xd8ff]. Non-prefetchable 32 bit memory at 0xe1800000 [0xe1800fff]. ``` -------------------------------- ### w3m Lynx-style Navigation Commands Source: https://github.com/tats/w3m/blob/master/doc-jp/MANUAL.html Documents keybindings for page and cursor movement, mimicking Lynx browser behavior. ```APIDOC Page Movement: SPC, C-v, + : Next Page Displays the next page of content. b, ESC v, - : Previous Page Displays the previous page of content. Cursor Movement: l : Move Cursor Right Moves the cursor one position to the right. h : Move Cursor Left Moves the cursor one position to the left. j : Move Cursor Down Moves the cursor one line down. k : Move Cursor Up Moves the cursor one line up. J : Scroll Screen Up Scrolls the view one line up (moves content down). K : Scroll Screen Down Scrolls the view one line down (moves content up). ^ : Move to Beginning of Line Moves the cursor to the start of the current line. $ : Move to End of Line Moves the cursor to the end of the current line. > : Shift View Right Shifts the entire screen view to the right (content moves left). < : Shift View Left Shifts the entire screen view to the left (content moves right). C-a : Move to Top of Document Moves the cursor to the very first line of the document. C-e : Move to Bottom of Document Moves the cursor to the very last line of the document. G : Go to Line Number Prompts for a line number to jump to. Entering '$' moves to the last line. Z : Center Cursor Line Centers the line containing the cursor within the screen view. z : Center Current Line Centers the current line on the screen. Link Navigation: TAB, C-n, Down Arrow : Next Link Moves the cursor to the next hyperlink. ESC TAB, C-p, Up Arrow : Previous Link Moves the cursor to the previous hyperlink. Information: C-g : Show Current Position Displays the current position within the page. ``` -------------------------------- ### w3m Miscellaneous Commands Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html Various utility commands for invoking functions, managing help, options, keys, mouse, downloads, cookies, undo/redo, shell execution, dictionary lookups, version display, suspension, and quitting. ```APIDOC COMMAND (M-c) Invoke one or more semicolon-separated w3m functions. HELP (H, ?) Show help panel. OPTIONS (o) Display options setting panel. SET_OPTION (M-o) Set option. DEFINE_KEY (M-k) Define a binding between a key stroke combination and a command. MOUSE_TOGGLE (m) Toggle mouse support. DOWNLOAD_LIST (D) Display downloads panel. COOKIE (C-k) Show cookie jar. UNDO (()) Cancel the last cursor movement. REDO ())) Cancel the last undo. EXEC_SHELL (!) Execute shell command. DICT_WORD (M-w) Execute dictionary command (see [README.dict]). DICT_WORD_AT (M-W) Execute dictionary command for word at cursor. VERSION (r) Display the version of w3m. SUSPEND (C-z) Suspend w3m to background. (To be withdrawn with shell command fg.). QUIT (q) Quit with confirmation request. EXIT (Q) Quit without confirmation. ``` -------------------------------- ### w3m Buffer/Tab Navigation Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html Commands for navigating between buffers, tabs, and managing the browsing history. ```APIDOC BACK (B, C-b, LEFT) Close current buffer and return to the one below in stack. GOTO_HOME (C-_) Return to the homepage (specified HTTP_HOME or WWW_HOME variable). SELECT_MENU (s, C-h) Pop up buffer-stack menu. TAB_MENU (M-t) Pop up tab selection menu. NEW_TAB (T) Open a new tab (with current document). TAB_LINK (C-t) Follow current hyperlink in a new tab. NEXT_TAB (}, }) Switch to the next tab. PREV_TAB ({, {) Switch to the previous tab. CLOSE_TAB (C-q) Close the current tab. ``` -------------------------------- ### Compilation Instructions Source: https://github.com/tats/w3m/blob/master/w3mimg/fb/readme.txt Instructions for compiling the framebuffer tools, requiring modification of Makefile flags to enable either Imlib2 or GdkPixbuf. ```makefile Makefile: - Uncomment CFLAGS and LDFLAGS corresponding to your chosen library (Imlib2 or GdkPixbuf). - Run 'make' to compile. ``` -------------------------------- ### Miscellaneous Commands Source: https://github.com/tats/w3m/blob/master/doc-de/MANUAL.html Various utility commands for executing w3m functions, accessing help, managing options, defining keys, toggling mouse mode, downloading lists, managing cookies, undo/redo, executing shell commands, dictionary lookups, version display, suspending, and quitting. ```APIDOC COMMAND (M-c) Description: Execute one or more w3m functions separated by semicolons. HELP (H, ?) Description: Display the help overview. OPTIONS (o) Description: Open the settings dialog. SET_OPTION (M-o) Description: Set an option. DEFINE_KEY (M-k) Description: Define a mapping between a key combination and a command. MOUSE_TOGGLE (m) Description: Toggle mouse operation on or off. DOWNLOAD_LIST (D) Description: View the list of downloaded files. COOKIE (C-k) Description: Display stored cookies. UNDO (()) Description: Undo the last cursor movement. REDO ())) Description: Redo the last undo command. EXEC_SHELL (!) Description: Execute a shell command. DICT_WORD (M-w) Description: Perform a dictionary function (see README.dict). DICT_WORD_AT (M-W) Description: Use the dictionary for the word under the cursor. VERSION (r) Description: Display the w3m version. SUSPEND (C-z) Description: Suspend w3m to the background (can be resumed with 'fg'). QUIT (q) Description: Exit with a confirmation prompt. EXIT (Q) Description: Exit immediately. ``` -------------------------------- ### w3m Buffer Selection Mode Commands Source: https://github.com/tats/w3m/blob/master/doc-jp/MANUAL.html Details keybindings specific to the buffer selection mode, used for navigating and managing open buffers. ```APIDOC Buffer Selection Mode (entered via 's'): k, C-p : Select Previous Buffer Moves the selection up to the previous buffer in the list. j, C-n : Select Next Buffer Moves the selection down to the next buffer in the list. D : Delete Selected Buffer Deletes the currently selected buffer from the list. RET : Display Selected Buffer Loads and displays the buffer that is currently selected. ``` -------------------------------- ### w3m File/Stream Operations Key Bindings Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html Details key bindings for opening documents from files or streams, including relative addresses, shell commands, and piping output. ```APIDOC GOTO Default: U Lynx-like: g, U Description: Open specified document in a new buffer GOTO_RELATIVE Default: M-u Lynx-like: M-u Description: Open relative address in a new buffer LOAD Default: V Lynx-like: V Description: Open local file in a new buffer READ_SHELL Default: @ Lynx-like: @ Description: Execute shell command and display output in a new buffer PIPE_SHELL Default: # Lynx-like: # Description: Execute shell command and display output in a new buffer ``` -------------------------------- ### Buffer and Tab Navigation Commands Source: https://github.com/tats/w3m/blob/master/doc-de/MANUAL.html Commands for navigating between buffers and tabs, including closing buffers, switching tabs, and managing tab lists. ```APIDOC BACK (B, C-b, LEFT) Description: Close the current buffer and return to the previous one in the stack. GOTO_HOME (C-_) Description: Return to the home page (as specified by HTTP_HOME or WWW_HOME variables). SELECT_MENU (s, C-h) Description: Open the buffer stack menu. TAB_MENU (M-t) Description: Open the tab selection menu. NEW_TAB (T) Description: Open a new tab with the current document. TAB_LINK (C-t) Description: Follow the current hyperlink in a new tab. NEXT_TAB (}) Description: Switch to the next tab. PREV_TAB ({) Description: Switch to the previous tab. CLOSE_TAB (C-q) Description: Close the current tab. ``` -------------------------------- ### w3m Command-Line Options Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html This section details the various command-line options available for the w3m browser, categorized by functionality. These options control general behavior, browser features, text paging, data encoding, and output methods. ```APIDOC w3m Command-Line Usage: w3m [option]... [file|URL]... General Options: -B Use the bookmark page for startup when no other target is defined. -H Use high-intensity colors for display. -M Enable monochrome display. -no-mouse Deactivate mouse support. -num Display each line's number. -v Display a built-in welcome page when no other target is defined. -W Toggle wrapping mode in searches. -X Upon exit, do not reinitialize the terminal. +_num_ Go to line _num_; only effective for numbers larger than the number of lines in the terminal. Browser Options: -cols _num_ When stdout is the destination, render HTML to lines of _num_ characters. -cookie Use stored cookies and accept new ones. -no-cookie Neither use stored cookies nor accept new ones. -F Render frames. -no-graph Do not use graphic characters for drawing HTML table and frame borders. -header _string_ Append _string_ to the HTTP(S) request. Expected to match the header syntax "Variable: Value". -m Display document using Internet message mode. Determines document type from header information, useful for reading e-mail or Usenet news posts. -no-proxy Do not use proxy. -post _file_ Use POST method to upload data defined in _file_. The syntax is "var1=value1[&var2=value2]…". Text Pager Options: -l _num_ Number of lines preserved internally when receiving plain text from stdin (default 10,000). -r Use caret notation to display special escape characters (e.g., ANSI escapes, nroff-style backspaces) instead of processing them. -s Squeeze multiple blank lines into one. -t _num_ Set tab width to _num_ columns. Has no effect on stdout. Data Type/Encoding Options: -I _charset_ User-defined character encoding of input data. -O _charset_ User-defined character encoding of output data. -T _type_ Explicit characterization of input data by MIME type. Without this option, document type is determined from the file extension. If determination fails, the document is regarded as text/plain. Example: cat example.html | w3m -T text/html Example: w3m -T text/plain example.html Options for Data Output (followed by immediate exit): -dump Read document specified by URL and dump page rendered as text into standard output. Implicitly set when output is directed to a file or pipe. A width of 80 columns is used unless -cols sets another value. -dump_source Dump the page's source code into stdout. -dump_head Dump response of a HEAD request for a URL into stdout. -dump_both Dump HEAD and source code for a URL into stdout. -dump_extra Dump HEAD, source code, and extra information for a URL into stdout. ``` -------------------------------- ### File and Stream Handling Commands Source: https://github.com/tats/w3m/blob/master/doc-de/MANUAL.html Commands for opening documents, local files, and executing shell commands, displaying their output in new buffers. ```APIDOC GOTO (g, U) Description: Open a specified document in a new buffer. GOTO_RELATIVE (M-u) Description: Open a relative address in a new buffer. LOAD (V) Description: Open a local file in a new buffer. READ_SHELL (@) Description: Execute a shell command and display its output in a new buffer. PIPE_SHELL (#) Description: Execute a shell command and display its output in a new buffer. ``` -------------------------------- ### w3m Popup Menu Mode Bindings Source: https://github.com/tats/w3m/blob/master/doc/MANUAL.html Key bindings for navigating and interacting with w3m's Popup Menu Mode. ```APIDOC MENU:SELECT (SPC, RET, RIGHT) Select. MENU:CLOSE (C-c) Close menu. MENU:CANCEL (LEFT, BKSPC, C-h) One selection step backward. MENU:DOWN (j, C-n, DOWN) Move to the next item. MENU:UP (k, C-p, UP) Move to the previous item. MENU:LINE_UP (K) Scroll up one item. MENU:LINE_DOWN (J) Scroll down one item. MENU:TOP (C-a) Move to the first item. MENU:LAST (C-e) Move to the final item. MENU:NEXT (C-v, C-f) Go to the next page. MENU:PREV (ESC v, C-b) Go to the previous page. MENU:SEARCH_FORE (C-s, /) Search forward. MENU:SEARCH_BACK (C-r, ?) Search backward. MENU:SEARCH_NEXT (n) Search for the next match. MENU:SEARCH_PREV (N) Search for the previous match. ```