diff options
author | Markus Hiereth <post@hiereth.de> | 2016-08-08 11:23:56 +0000 |
---|---|---|
committer | Tatsuya Kinoshita <tats@debian.org> | 2016-08-08 11:23:56 +0000 |
commit | 45d40611a8d35ba395e5082688a783dfa886b588 (patch) | |
tree | 5d9b19c673a711dba1aaec0c9c58286370f99a1d /doc | |
parent | Update FAQ.html in English and German (diff) | |
download | w3m-45d40611a8d35ba395e5082688a783dfa886b588.tar.gz w3m-45d40611a8d35ba395e5082688a783dfa886b588.zip |
Update MANUAL.html in English and German
Origin: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=772341#90
Diffstat (limited to '')
-rw-r--r-- | doc-de/MANUAL.html | 2340 | ||||
-rw-r--r-- | doc/MANUAL.html | 2354 |
2 files changed, 3609 insertions, 1085 deletions
diff --git a/doc-de/MANUAL.html b/doc-de/MANUAL.html new file mode 100644 index 0000000..f922314 --- /dev/null +++ b/doc-de/MANUAL.html @@ -0,0 +1,2340 @@ + +<html> + <head> + <title>w3m Handbuch</title> + <style> + span.mono { + font-family:mono; + } + </style> + <meta http-equiv="content-type" content="text/html;charset=UTF-8"> + </head> + <body> + <!-- +insertions tagged with "mh 2016-03-29" and "mh 2016-06-11" come from the latest version of manual page w3m (1) + --> + + <h1>w3m HANDBUCH</h1> + <div align="right"> + Akinori Ito<br> aito@fw.ipsj.or.jp + </div> + <h2>Übersicht</h2> + <ul> + <li> + <a href="#Einführung"> + Einführung + </a> + </li> + <li> + <a href="#Einstellungen"> + Einstellungen + </a> + </li> + <li> + <a href="#Color"> + Farbzuordnung im Dokument + </a> + </li> + <li> + <a href="#Functions"> + Funktionen und Tastaturbelegung + </a> + </li> +<!-- mh 2016-06-13 obsolete + <li> + <a href="#Key:lynx"> + Lynx-like key bindings + </a> + </li> +--> + <li> + <a href="#Mouse"> + Bedienung per Maus + </a> + </li> +<!-- mh 2016-06-13 obsolete + <li> + <a href="#Key:custom"> + Key customization + </a> + </li> + --> + <li> + <a href="#LocalCGI"> + Lokale CGI-Skripte + </a> + </li> + </ul> + <hr> + <h2 id="Einführung"> + Einführung + </h2> + <p> + w3m ist ein textorientierter Browser und Textbetrachter (Pager). In einem Terminalemulator können Sie damit lokale und andere Dokumente anzeigen lassen und Verknüpfungen (Hyperlinks) weiterverfolgen. + </p> + <hr> + <h2 id="Einstellungen"> + Einstellungen + </h2> + <p> + Der Aufruf per Befehlszeile lautet + </p> +<!-- mh 2016-08-06 invocation adapted to w3m(1). w3m accepts several options and several targets --> +<pre> + w3m [Option]… [Datei|Adresse]… +</pre> + <p> + Wenn Sie Dateinamen oder Adressen in der Befehlszeile angeben, werden diese Dokumente angezeigt. Fehlen entsprechende Argumente, wird w3m ein Dokument aus der Standardeingabe erwarten und anzeigen. Erhält das Programm auch hier keine Daten, beendet es sich normalerweise selbstständig. + </p> + <p> + Optionen sind unter anderem: + </p> + <dl> +<h3>Allgemeine Optionen</h3> + <dt> + -B + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + starte mit einer Ansicht aller Lesezeichen (wenn kein anderes Zielobjekt angegeben ist) + </p> + </dd> + <dt> + -M + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + monochrome Anzeige + </p> + </dd> + <dt> + -no-mouse + </dt> + <dd> + <p> + Mausfunktion aus + </p> + </dd> + <dt> + -num + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + zeige Zeilennummern an + + </p> + </dd> +<!-- mh 2016-08-06 commented out. As implementation is not verified. + <dt> + -ppc <i>num</i> + </dt> + <dd> + <p> + width of <i>num</i> pixels per character. Range of 4.0 to 32.0, + default 8.0. Larger values will make tables + narrower. (Implementation not verified) + </p> + </dd> +--> + <dt> + -v + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + begrüße den Benutzer mit einer eingebauten Seite (wenn kein anderes Zielobjekt angegeben ist) + </p> + </dd> + <dt> + -W + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + wechsle zwischen umlaufendem und nicht umlaufendem Suchen + </p> + </dd> + <dt> + -X + </dt> + <dd> + <p> + nach Beenden des Programms das Terminal nicht neu initialisieren. + </p> + </dd> + <dt> + +<i>Zahl</i> + </dt> + <dd> + <!--mh 2016-06-11 --><p> + gehe zu Zeile <i>Zahl</i>. Wirkt nur, wenn <i>Zahl</i> größer ist als die im Terminal verfügbare Zeilenzahl + </p> + </dd> +<h3>Browser-Optionen</h3> + <dt> + -cols <i>Zahl</i> + </dt> + <dd> + <!-- mh 2016-06-11 --><p> + + bei für die Standardausgabe bestimmten Inhalten, nimm bei zur Umsetzung von HTML eine Länge von <i>num</i> Zeichen pro Zeile + </p> + </dd> + <dt> + -cookie + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + verwende gespeicherte Cookies und akzeptiere neue + </p> + </dd> + <dt> + -no-cookie + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + verwende weder gespeicherte Cookies noch akzeptiere neue + + </p> + </dd> + <dt> + -F + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + verarbeite Frames + </p> + </dd> + <dt> + -no-graph + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + verwende bei der Umsetzung von Tabellen und Frames keine grafischen Zeichen + </p> + </dd> + <dt> + -header <i>Zeichenkette</i> + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + füge der HTTP(S)-Anfrage <i>Zeichenkette</i> an. Diese muss der Kopfdaten-Syntax <span class="mono">"Variable: Wert"</span> entsprechen + </p> + </dd> + <dt> + -m + </dt> + <dd> + <!-- mh 2016-03-29 +Render the body of Usenet messages according to the header <q>Content-type</q> +--><p> + arbeite im <q>Internetnachrichten-Modus</q>. Mit dieser Option entnimmt w3m den Typ eines Dokumentes dessen Kopfdaten. Dies ist nützlich beim Lesen von Mails und Usenet-Nachrichten. + + </p> + </dd> + <dt> + -no-proxy + </dt> + <dd> + <!-- mh 2016-06-11--><p> + + verwende keinen Proxy + </p> + </dd> + <dt> + -post <i>Datei</i> + </dt> + <dd> + <!--funktionierend 2016-06-28T08:22>--><p> + verwende die Methode POST, um in <i>Datei</i> hinterlegte Daten hochzuladen. Hierbei wird die Syntax <span class="mono">"var1=wert1[&var2=wert2]…"</span> erwartet + </p> + </dd> +<h3>Textbetrachter-Optionen</h3> + <dt> + -l <i>Zahl</i> + </dt> + <dd> + <!-- mh2016-06-11--><p> + + Anzahl der Zeilen, die zwischengespeichert werden, wenn Text per Standardeingabe übergeben wurde. (Voreinstellung ist 10000) + </p> + </dd> + <dt> + -r + </dt> + <dd> + <!-- mh 2016-03-29 --><p> + + verarbeite spezielle Escape-Zeichen (beispielsweise ANSI-Escape-Zeichen oder nroff-Rückwärtsschritte für fette und unterstrichene Zeichen) nicht, sondern zeige sie stattdessen mittels Caret-Notation. + </p> + </dd> + <dt> + -s + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + mehrere leere Zeilen werden bis auf eine gelöscht + </p> + </dd> + + <!--mh 2016-03-29 --><dt> + -t <i>Zahl</i> + </dt> + <dd> + <!--mh 2016-03-29--><p> + Tab-Zeichen so verwerten, dass Spalten mit einer Weite von <i>Zahl</i> Zeichen entstehen. Wirkt nicht auf Standardausgabe + </p> + </dd> +<h3>Datenart- und Datenkodierungs-Optionen</h3> + <dt> + -I <i>Zeichenkodierung</i> + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + zu benutzende Zeichenkodierung für erhaltene Daten + </p> + </dd> + <dt> + -O <i>Zeichenkodierung</i> + </dt> + <dd> + <!-- mh 2016-03-29 --><p> + + zu benutzende Zeichenkodierung für auszugebende Daten + </p> + </dd> + <dt> + -T <i>Typ</i> + </dt> + <dd> + <!-- mh 2016-06-11--><p> + + legt den MIME-Typ erhaltener Daten fest. Ohne diese Option bestimmt ihn das Programm anhand der Dateinamen-Erweiterung. Wenn dies fehlschlägt, wird text/plain als Typ angenommen. Zum Beispiel: + </p> + <p> + Übernimm HTML-Dokument von der Standardeingabe und zeige es an + </p> +<pre> + cat beispiel.html | w3m -T text/html +</pre> + <p> + Zeige HTML-Quelltext an + </p> +<pre> + w3m -T text/plain beispiel.html +</pre> + </dd> +<h3>Optionen zur Datenausgabe, mit sofortigem Verlassen des Programms</h3> + <dt> + -dump + </dt> + <dd> + <!-- mh 2016-03-29 --><p> + lies das per URL angegebene Dokument und leite es verarbeitet der Standardausgabe zu. Wenn mit der Option -cols nichts anderes eingestellt ist, erhält es eine Breite von 80 Zeichen + </p> + </dd> + <dt> + -dump_source + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + leite den Seitenquelltext der Standardausgabe zu + </p> + </dd> + <dt> + -dump_head + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + leite die Antwort einer HEAD-Anfrage für eine URL der Standardausgabe zu + </p> + </dd> + <dt> + -dump_both + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + leite Antwort auf HEAD-Anfrage und Seitenquelltext der Standardausgabe zu + + </p> + </dd> + <dt> + -dump_extra + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + leite Antwort auf HEAD-Anfrage, Seitenquelltext und Extrainformation der Standardausgabe zu + </p> + </dd> + +<h3>Optionen, die Standards für Einstellungen und Datenquellen außer Kraft setzen</h3> + + <dt> + -bookmark <i>Datei</i> + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + benutze anstelle der Standarddatei bookmark.html für Lesezeichen die Datei <i>Datei</i> + </p> + </dd> + <dt> + -config <i>Datei</i> + </dt> + <dd> + <!--mh 2016-06-11--><p> + + benutze <i>Datei</i> anstelle der Standard-Konfigurationsdatei + </p> + </dd> + <dt> + -o <i>Option</i>=<i>Wert</i> + </dt> + <dd> + <!-- mh 2016-03-29--><p> + + arbeite mit einer Konfiguration, bei der die Einstellung <i>Option</i> mit <i>Wert</i> belegt ist. Ohne <i>Option=Wert</i> gleichwertig mit <i>-show-option</i> + </p> + </dd> + </dl> + <hr> + <h2 id="Color"> + Farbzuordnung im Dokument + </h2> + <p> + Links und Bildelemente werden wie folgt angezeigt: + </p> + <div align="center"> <table border="1"> <tr> + <th> + </th> + <th> + Farbmodus + </th> + <th> + Monochrom-Modus + </th> + </tr> + <tr> + <td> + Hyperlinks + </td> + <td> + blau + </td> + <td> + unterstrichen + </td> + </tr> + <tr> + <td> + Bilder + </td> + <td> + grün + </td> + <td> + invertiert + </td> + </tr> + <tr> + <td> + Formular-Eingabefelder + </td> + <td> + rot + </td> + <td> + invertiert + </td> + </tr> + </table> + </div> + <p> + Diese Farben können nach Eingabe von <q>o</q> im Einstellungs-Dialog anders zugeordnet werden. + </p> + <hr> + <h2 id="Functions"> + Funktionen und Tastaturbelegung + </h2> + + <!-- mh 2016-06-13 obsolete + If you prefer using Lynx-like + key bindings, make w3m start with the respective keymap file keymap.lynx. (see w3m (1)).--><p> + Wenn w3m läuft, bedienen Sie das Programm, indem Sie Funktionen anhand ihres Namens oder der ihr zugeordneten Tastenkombination aufrufen. Es gibt voreingestellte Tastaturbelegungen. + + </p> +<!-- + <h2 id="Key:custom"> + Key customization + </h2> +--> + <p> + Sie können die Tastaturbelegungen (abgesehen von jenen des Menü- und des Texteingabe-Modus) in einer Datei ~/.w3m/keymap anpassen. Beispielsweise bindet + </p> + +<pre> + keymap C-o NEXT_PAGE +</pre> + + <p> + die Funktion <span class="mono">NEXT_PAGE</span> (die normalerweise mit SPC und C-v verknüpft ist) mit C-o. Siehe die Liste verfügbarer Funktionen in <a href="README.func">README.func</a>. Original- und Lynx-artige Tastaturbelegungen enthalten die Beispieldateien <a href="keymap.default">keymap.default</a> und <a href="keymap.lynx">keymap.lynx</a>. + </p> + + <p> + Im Folgenden stehen <i>C-</i> und <i>M-</i> für die Eingabe-Modifikationen mit der <i>Steuerungs-</i> und der <i>Meta-Taste</i>. Die letztere ersetzt die <i>ALT-Taste</i>, wohingegen Drücken der <i>ESC</i>-Taste zwischen <i>Meta</i>-modifiziertem und einfachen Tastendruck wechselt. Das Minus-Zeichen bedeutet das gleichzeitige Drücken von Tasten; der Leerraum dagegen steht dafür, dass eine Taste nach der anderen gedrückt wird. Mit <i>2 M</i> ist also gemeint, die <i>2</i> und dann <i>M</i> zu drücken. + </p> + + + <table border="1" width="100%"> + <colgroup> + <col width="20%"> + <col width="20%"> + <col width="20%"> + <col width="40%"> + </colgroup> + <tr> + <th rowspan="2"> + Funktion + </th> + <th colspan="2">Tastenkombination + </th> + <th rowspan="2"> + Beschreibung + </th> + </tr> + <tr> + <th> + Standard + </th> + <th> + Lynx-ähnlich + </th> + </tr> + <tr> + <td colspan="4"> + <h3>Navigation innerhalb von Seiten</h3> +</td> + </tr> + <tr> + <td> + NEXT_PAGE + </td> + <td> + SPC, C-v, +, PGDN + </td> + <td> + SPC, C-v, + + </td> + <td> + Scrolle eine Seite abwärts + </td> + </tr> + <tr> + <td> + PREVIOUS_PAGE + </td> + <td> + b, M-v, -, PGUP + </td> + <td> + b, M-v, - + </td> + <td> + Scrolle eine Seite aufwärts + </td> + </tr> + <tr> + <td> + MOVE_RIGHT + </td> + <td> + l, C-f, RIGHT + </td> + <td> + l + </td> + <td> + Bewege Cursor nach rechts (mit Verschiebung um halbe Bildschirmbreite an dessen Rand) + </td> + </tr> + <tr> + <td> + C-b, LEFT + </td> + <td> + h, C-b, LEFT + </td> + <td> + h + </td> + <td> + Bewege Cursor nach links (mit Verschiebung um halbe Bildschirmbreite an dessen Rand) + </td> + </tr> + <tr> + <td> + MOVE_DOWN + </td> + <td> + j, C-n, DOWN + </td> + <td> + j + </td> + <td> + Bewege Cursor abwärts (scrolle eine Zeile am Bildschirmrand) + </td> + </tr> + <tr> + <td> + MOVE_UP + </td> + <td> + k, C-p, UP + </td> + <td> + k + </td> + <td> + Bewege Cursor aufwärts (scrolle eine Zeile am Bildschirmrand) + </td> + </tr> + <tr> + <td> + UP + </td> + <td> + J + </td> + <td> + J + </td> + <td> + Scrolle den Anzeigebereich eine Zeile aufwärts + </td> + </tr> + <tr> + <td> + DOWN + </td> + <td> + K + </td> + <td> + K + </td> + <td> + Scrolle den Anzeigebereich eine Zeile abwärts + </td> + </tr> + <tr> + <td> + LINE_BEGIN + </td> + <td> + ^, C-a + </td> + <td> + ^ + </td> + <td> + Gehe zum Zeilenanfang + </td> + </tr> + <tr> + <td> + LINE_END + </td> + <td> + $, C-e + </td> + <td> + $ + </td> + <td> + Gehe zum Zeilenende + </td> + </tr> + <tr> + <td> + NEXT_WORD + </td> + <td> + w + </td> + <td> + w + </td> + <td> + Gehe zum nächsten Wort + </td> + </tr> + <tr> + <td> + PREVIOUS_WORD + </td> + <td> + W + </td> + <td> + W + </td> + <td> + Gehe zum vorherigen Wort + </td> + </tr> + <tr> + <td> + SHIFT_RIGHT + </td> + <td> + > + </td> + <td> + > + </td> + <td> + Anzeigebereich nach rechts versetzen + </td> + </tr> + <tr> + <td> + SHIFT_LEFT + </td> + <td> + < + </td> + <td> + < + </td> + <td> + Anzeigebereich nach links versetzen + </td> + </tr> + <tr> + <td> + RIGHT + </td> + <td> + . + </td> + <td> + . + </td> + <td> + Anzeigebereich um eine Spalte nach rechts verschieben + </td> + </tr> + <tr> + <td> + LEFT + </td> + <td> + , + </td> + <td> + , + </td> + <td> + Anzeigebereich um eine Spalte nach links verschieben + </td> + </tr> + <tr> + <td> + BEGIN + </td> + <td> + g, M-<, HOME + </td> + <td> + C-a, M-< + </td> + <td> + Gehe zur ersten Zeile + </td> + </tr> + <tr> + <td> + END + </td> + <td> + G, M->, END + </td> + <td> + C-e, M-> + </td> + <td> + Gehe zur letzten Zeile + </td> + </tr> + <tr> + <td> + GOTO_LINE + </td> + <td> + M-g + </td> + <td> + G + </td> + <td> + Gehe zur angegebenen Zeile + </td> + </tr> + <tr> + <td> + LINE_INFO + </td> + <td> + C-g + </td> + <td> + C-g + </td> + <td> + Zeige aktuelle Position im Dokument an + </td> + </tr> + <tr> + <td> + CENTER_H + </td> + <td> + Z + </td> +<!--Correction by mh 2014-04-06 +Description for keybinding of z and Z had been mingled +--> + <td> + Z + </td> + <td> + Bildschirm rechts und links des Cursors zentrieren + </td> + </tr> + <tr> + <td> + CENTER_V + </td> + <td> + z + </td> + <td> + z + </td> + <td> + Bildschirm ober- und unterhalb des Cursors zentrieren + </td> + </tr> + <tr> + <td> + NEXT_LINK + </td> + <td> + TAB + </td> + <td> + TAB, C-n, DOWN + </td> + <td> + Gehe zum nächsten Hyperlink + </td> + </tr> + <tr> + <td> + PREVIOUS_LINK + </td> + <td> + M-TAB, C-u + </td> + <td> + M-TAB, C-u, C-p, UP + </td> + <td> + Gehe zum vorangegangen Hyperlink + </td> +<!-- Annotion mh 2016-04-06 +Keybinding description for C-g had been moved as it did not fit to "Hyperlink operation" and position in the default and lynx-like series differed + --> + </tr> + <tr> + <td> + LINK_BEGIN + </td> + <td> + [ + </td> + <td> + [ + </td> + <td> + Gehe zum ersten Hyperlink + </td> + </tr> + <tr> + <td> + LINK_END + </td> + <td> + ] + </td> + <td> + ] + </td> + <td> + Gehe zum letzten Hyperlink + </td> + </tr> +<tr> +<td>MOVE_LIST_MENU</td> +<td>M-m</td> +<td>M-m</td> +<td>Öffne Menü mit vorhandenen Hyperlinks</td> +</tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Umgang mit Hyperlinks</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + GOTO_LINK + </td> + <td> + C-j, C-m, RET + </td> + <td width="100"> + C-f, C-j, C-m, RET, RIGHT + </td> + <td> + Folge dem aktuellen Hyperlink in neuem Puffer + </td> + </tr> +<tr> +<td>LIST_MENU</td> +<td>M-l</td> +<td>M-l</td> +<td>Öffne Menü mit Hyperlinks und folge dem ausgewählten</td> +</tr> + <tr> + <td> + SAVE_LINK + </td> + <td> + a, M-RET + </td> + <td> + d, M-RET + </td> + <td> + Speichere Ziel des Hyperlinks + </td> + </tr> + <tr> + <td> + PEEK_LINK + </td> + <td> + u + </td> + <td> + u + </td> + <td> + Zeige Zieladresse + </td> + </tr> + <tr> + <td> + PEEK_IMG + </td> + <td> + i + </td> + <td> + i + </td> + <td> + Zeige Adresse des Bildes + </td> + </tr> + <tr> + <td> + VIEW_IMAGE + </td> + <td> + I + </td> + <td> + I + </td> + <td> + Zeige Bild in Betrachter + </td> + </tr> + <tr> + <td> + SAVE_IMAGE + </td> + <td> + M-I + </td> + <td> + M-I + </td> + <td> + Speichere Bild + </td> + </tr> +<tr> +<td>MARK_WORD</td> +<td>;</td> +<td>;</td> +<td>Wandle aktuelles Wort in Hyperlink um</td> +</tr> + <tr> + <td> + MARK_URL + </td> + <td> + : + </td> + <td> + : + </td> + <td> + Wandle URL-artige Zeichenketten um in Hyperlinks + </td> + </tr> + <tr> + <td> + MARK_MID + </td> + <td> + M-: + </td> + <td> + M-: + </td> + <!-- changed due to mail dated Mon, 04 Apr 2016 00:47:09 +0900 (JST) +from Tatsuya Kinoshita --><td> + + Wandle Nachrichten-ID-artige Zeichenketten um in Hyperlinks + </td> + </tr> + <tr> + <td> + PEEK + </td> + <td> + c + </td> + <td> + c + </td> + <td> + Zeige aktuelle Adresse an + </td> + </tr> + <tr> + <td> + INFO + </td> + <td> + = + </td> + <td> + = + </td> + <td> + Zeige Informationen über dieses Dokument + </td> + </tr> + <tr> + <td> + HISTORY + </td> + <td> + C-h + </td> + <td> + C-h + </td> + <td> + Chronik aufgesuchter Dokumente + </td> + </tr> + <tr> + <td> + EXTERN + </td> + <td> + M + </td> + <td> + M + </td> + <td> + Zeige das aktuelle Dokument mit einem externen Browser (wird eine Taste von 2 bis 9 gedrückt, also beispielsweise 3 M, eingegeben, kommt ein anderer, in der Konfiguration hinterlegter Browser zum Einsatz) + </td> + </tr> + <tr> + <td> + EXTERN_LINK + </td> + <td> + M-M + </td> + <td> + M-M + </td> + <td> + Bringe das Linkziel mit einem externen Browser zur Anzeige (vorangestellte Zahlen wirken sich wie oben beschrieben aus) + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Verwalten von Lesezeichen</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + BOOKMARK + </td> + <td> + M-b + </td> + <td> + v, M-b + </td> + <td> + Lesezeichen ansehen + </td> + </tr> + <tr> + <td> + ADD_BOOKMARK + </td> + <td> + M-a + </td> + <td> + a, M-a + </td> + <td> + Lege für aktuelle Seite Lesezeichen an + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Umgang mit Dateien und Datenströmen</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + GOTO + </td> + <td> + U + </td> + <td> + g, U + </td> + <td> + Öffne angegebenes Dokument in neuem Puffer + </td> + </tr> +<tr> +<td>GOTO_RELATIVE</td> +<td>M-u</td> +<td>M-u</td> +<td>Öffne relative Adresse in neuem Puffer</td> +</tr> + <tr> + <td> + LOAD + </td> + <td> + V + </td> + <td> + V + </td> + <td> + Öffne lokale Datei in einem neuen Puffer + </td> + </tr> + <tr> + <td> + READ_SHELL + </td> + <td> + @ + </td> + <td> + @ + </td> + <!--Execute shell command and view output--><!--mh 2016-06-13 No difference to PIPE_SHELL could be discerned--><td> + + + Führe einen Shell-Befehl aus und zeige Ausgabe in einem neuen Puffer + </td> + </tr> + <tr> + <td> + PIPE_SHELL + </td> + <td> + # + </td> + <td> + # + </td> + <!--Execute shell command and browse output--><!--mh 2016-06-13 No difference to READ_SHELL could be discerned--><td> + + + Führe einen Shell-Befehl aus und zeige Ausgabe in einem neuen Puffer + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Arbeit an Seiteninhalten</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <!-- is an alias to SOURCE --><td> + VIEW + </td> + <td> + v + </td> + <td> + \ + </td> + <td> + Wechsle zwischen HTML-Quellcode und verarbeitetem Dokument + </td> + </tr> +<tr> +<td>LIST</td> +<td>L</td> +<td>L</td> +<td>Liste Link-Elemente, Hyperlinks und Bilder auf</td> +</tr> + <tr> + <td> + FRAME + </td> + <td> + F + </td> + <td> + F + </td> + <td> + Wechsle zwischen Kennung und Umsetzung von HTML-Frames + </td> + </tr> + <tr> + <td> + REDRAW + </td> + <td> + C-l + </td> + <td> + C-l, C-w + </td> + <td> + Bildschirmanzeige neu aufbauen + </td> + </tr> + <tr> + <td> + RELOAD + </td> + <td> + R + </td> + <td> + R, C-r + </td> + <td> + Aktuelles Dokument erneut laden + </td> + </tr> + <tr> + <td> + EDIT + </td> + <td> + E + </td> + <td> + E + </td> + <td> + Bearbeite lokales Quelldokument + </td> + </tr> + <tr> + <td> + EDIT_SCREEN + </td> + <td> + M-e + </td> + <td> + M-e + </td> + <td> + Bearbeite eine Kopie des verarbeiteten Dokuments + </td> + </tr> +<tr> +<td>PIPE_BUF</td> +<td>|</td> +<td>|</td> +<td>Leite aktuellen Pufferinhalt einem Shell-Befehl zu und zeige Ausgabe an</td> +</tr> + <tr> + <!-- is an alias to SAVE --><td> + DOWNLOAD + </td> + <td> + M-s + </td> + <td> + M-s + </td> + <td> + Dokument-Quellcode speichern + </td> + </tr> + <tr> + <td> + SAVE_SCREEN + </td> + <td> + S + </td> + <td> + S, p + </td> + <td> + Speichere verarbeitetes Dokument + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Navigation zwischen Puffern und Reitern</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + BACK + </td> + <td> + B + </td> + <td> + B, C-b, LEFT + </td> + <td> + Schließe aktuellen Puffer und kehre zu dem im Stapel darunterliegenden zurück + </td> + </tr> + <tr> + <td> + SELECT_MENU + </td> + <td> + s + </td> + <td> + s, C-h + </td> + <td> + Öffne Pufferstapel-Menü + </td> + </tr> + <tr> + <td> + TAB_MENU + </td> + <td> + M-t + </td> + <td> + M-t + </td> + <td> + Öffne das Reiter-Auswahl-Menü + </td> + </tr> + <tr> + <td> + NEW_TAB + </td> + <td> + T + </td> + <td> + T + </td> + <td> + Öffne neuen Reiter (mit aktuellem Dokument) + </td> + </tr> + <tr> + <td> + TAB_LINK + </td> + <td> + C-t + </td> + <td> + C-t + </td> + <td> + Folge dem aktuellen Hyperlink in einem neuen Reiter + </td> + </tr> + <tr> + <td> + NEXT_TAB + </td> + <td> + } + </td> + <td> + } + </td> + <td> + Schalte zum nächsten Reiter + </td> + </tr> + <tr> + <td> + PREV_TAB + </td> + <td> + { + </td> + <td> + { + </td> + <td> + Schalte zum vorherigen Reiter + </td> + </tr> + <tr> + <td> + CLOSE_TAB + </td> + <td> + C-q + </td> + <td> + C-q + </td> + <td> + Schließe aktuellen Reiter + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Suchfunktionen</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + SEARCH + </td> + <td> + / + </td> + <td> + /, C-s + </td> + <td> + Suche vorwärts + </td> + </tr> + <tr> + <td> + SEARCH_BACK + </td> + <td> + ? + </td> + <td> + </td> + <td> + Suche rückwärts + </td> + </tr> + <tr> + <td> + ISEARCH + </td> + <td> + C-s + </td> + <td> + </td> + <td> + Inkrementelle Suche vorwärts + </td> + </tr> + <tr> + <td> + ISEARCH_BACK + </td> + <td> + C-r + </td> + <td> + </td> + <td> + Inkrementelle Suche rückwärts + </td> + </tr> + <tr> + <td> + SEARCH_NEXT + </td> + <td> + n + </td> + <td> + n + </td> + <td> + Setze Suche vorwärts fort + </td> + </tr> + <tr> + <td> + SEARCH_PREV + </td> + <td> + N + </td> + <td> + </td> + <td> + Setze Suche rückwärts fort + </td> + </tr> + <tr> + <td> + WRAP_TOGGLE + </td> + <td> + C-w + </td> + <td> + w + </td> + <td> + Wechsle zwischen umlaufendem und nicht-umlaufendem Suchen + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Arbeit mit Textmarken</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + MARK + </td> + <td> + C-SPC + </td> + <td> + C-SPC + </td> + <td> + Setze/Lösche Markierung + </td> + </tr> + <tr> + <td> + PREV_MARK + </td> + <td> + M-p + </td> + <td> + P + </td> + <td> + Gehe zur vorherigen Markierung + </td> + </tr> + <tr> + <td> + NEXT_MARK + </td> + <td> + M-n + </td> + <td> + N + </td> + <td> + Gehe zur nächsten Markierung + </td> + </tr> + <tr> + <td> + REG_MARK + </td> + <td> + " + </td> + <td> + " + </td> + <td> + Markiere alle Vorkommen eines Zeichenmusters + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Verschiedenes</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + COMMAND + </td> + <td> + M-c + </td> + <td> + M-c + </td> + <td> + Rufe eine oder mehrere durch Strichpunkt getrennte w3m-Funktionen auf + </td> + </tr> +<!-- +TODO: Where does this key binding M-Fn come from. I do not find a Fn-key on my keyboard. I do not know how to type in the keystroke combinations listed in keymap.default which are +keymap M-[E MENU +keymap M-[L MENU +keymap M-[2~ MENU +keymap M-[28~ MENU +<tr> +<td>MENU</td> +<Td>M-Fn</Td> +<td></td> +<td>Pop up menu</td> +</tr> +--> + <tr> + <td> + HELP + </td> + <td> + H + </td> + <td> + H, ? + </td> + <td> + Zeige Hilfe-Übersicht + </td> + </tr> + <tr> + <td> + OPTIONEN + </td> + <td> + o + </td> + <td> + o + </td> + <td> + Einstellungs-Dialog öffnen + </td> + </tr> +<tr> +<td>SET_OPTION</td> +<td>M-o</td> +<td>M-o</td> +<td>Setze Option</td> +</tr> +<tr> +<td>DEFINE_KEY</td> +<td>M-k</td> +<td>M-k</td> +<td>Definiere eine Verbindung zwischen einer Tastenkombination und einem Kommando</td> +</tr> +<tr> +<td>MOUSE_TOGGLE</td> +<td>m</td> +<td>m</td> +<td>Schalte Mausbedienung an oder ab</td> +</tr> +<tr> +<td>DOWNLOAD_LIST</td> +<td>D</td> +<td>D</td> +<td>Übersicht heruntergeladener Dateien anzeigen</td> +</tr> + <tr> + <td> + COOKIE + </td> + <td> + C-k + </td> + <td> + C-k + </td> + <td> + Zeige die gespeicherten Cookies + </td> + </tr> +<!-- +mh 2016-06-12 Interrupt is an alias to SUSPEND, no need to mention it here + <tr> + <td> + INTERRUPT + </td> + <td> + C-c + </td> + <td> + C-c + </td> + <td> + Interrupt + </td> + </tr> +--> +<tr> +<td>UNDO</td> +<td>(</td> +<td>(</td> +<td>Nimm die letzte Cursorbewegung zurück</td> +</tr> +<tr> +<td>REDO</td> +<td>)</td> +<td>)</td> +<td>Den letzten Rücknahmebefehl zurücknehmen</td> +</tr> + <tr> + <!-- is an alias of SHELL --><td> + EXEC_SHELL + </td> + <td> + ! + </td> + <td> + ! + </td> + <td> + Shell-Befehl ausführen + </td> + </tr> +<tr> +<td>DICT_WORD</td> +<td>M-w</td> +<td>M-w</td> +<td>Führe eine Wörterbuch-Funktion aus (siehe <a href="../doc/README.dict">README.dict</a>)</td> +</tr> +<tr> +<td>DICT_WORD_AT</td> +<td>M-W</td> +<td>M-W</td> +<td>Benutze Wörterbuch für Wort unter Cursor</td> +</tr> +<tr> +<td>VERSION</td> +<td>r</td> +<td>r</td> +<td>Zeige die Version von w3m an</td> +</tr> + <tr> + <td> + SUSPEND + </td> + <td> + C-z + </td> + <td> + C-z + </td> + <td> + w3m zum Hintergrundprozess machen. (Wird mit dem Shell-Befehl <span class="mono">fg</span> zurückgenommen.) + </td> + </tr> + <tr> + <td> + QUIT + </td> + <td> + q + </td> + <td> + q + </td> + <td> + Mit Bestätigungsfrage beenden + </td> + </tr> + <tr> + <td> + EXIT + </td> + <td> + Q + </td> + <td> + Q + </td> + <td> + Sofort beenden + </td> + </tr> + </table> + + <p> + Darüber hinaus gibt es die folgenden Bedien-Modi mit fester Tastaturbelegung für die entsprechenden Funktionen. Diese sind nicht durch die Funktion DEFINE_KEY oder Einträge der keymap-Datei veränderbar. + </p> + + <table border="1" width="100%"> + <colgroup> + <col width="20%"> + <col width="40%"> + <col width="40%"> + </colgroup> + <tr> + <th> + Funktion<br>(interner Name) + </th> + <th>Tastenkombination + </th> + <th> + Beschreibung + </th> + </tr> + <tr> + <td colspan="3"> + <h3>Menü-Auswahl-Modus</h3> + </td> + </tr> + <tr> + <td> + BUF:NEXT</td> + <td> + j, C-n, DOWN + </td> + <td> + Nächster Eintrag + </td> + </tr> + <tr> + <td>BUF:PREV + </td> + <td> + k, C-p, UP + </td> + <td> + Vorheriger Eintrag + </td> + </tr> + <tr> + <td> + BUF:DELETE</td> + <td> + D + </td> + <td> + Lösche Eintrag + </td> + </tr> + <tr> + <td> + BUF:GO + </td> + <td> + SPC, RET, RIGHT + </td> + <td> + Wähle Eintrag aus + </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="3"> + <h3>Popup-Menü-Modus</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> +MENU:SELECT + </td> + <td> + SPC, RET, RIGHT</td> + <td> + Wähle Punkt aus + </td> + </tr> + <tr> + <td> +MENU:CLOSE + </td> + <td>C-c + </td> + <td> + Schließe Menü + </td> + </tr> + <tr> + <td> +MENU:CANCEL + </td> + <td> + LEFT, BKSPC, C-h</td> + <td> + Einen Auswahlschritt zurück + </td> + </tr> + <tr> + <td> +MENU:DOWN + </td> + <td>j, C-n, DOWN + </td> + <td> + Gehe zum nächsten Punkt + </td> + </tr> + <tr> + <td> +MENU:UP + </td> + <td> + k, C-p, UP</td> + <td> + Gehe zum vorherigen Punkt + </td> + </tr> + <tr> + <td> +MENU:LINE_UP + </td> + <td>K + </td> + <td> + Scrolle einen Punkt aufwärts + </td> + </tr> + <tr> + <td> +MENU:LINE_DOWN + </td> + <td>J + </td> + <td> + Scrolle einen Punkt abwärts + </td> + </tr> + <tr> + <td> +MENU:TOP + </td> + <td>C-a + </td> + <td> + Gehe zum ersten Punkt + </td> + </tr> + <tr> + <td> +MENU:LAST + </td> + <td>C-e + </td> + <td> + Gehe zum letzten Punkt + </td> + </tr> + <tr> + <td> +MENU:NEXT + </td> + <td>C-v, C-f + </td> + <td>Gehe zur nächsten Seite + </td> + </tr> + <tr> + <td> +MENU:PREV + </td> + <td>ESC v, C-b + </td> + <td> + Gehe zur vorherigen Seite + </td> + </tr> + <tr> + <td> +MENU:SEARCH_FORE + </td> + <td>C-s, / + </td> + <td> + Suche vorwärts + </td> + </tr> + <tr> + <td> +MENU:SEARCH_BACK + </td> + <td> + C-r, ?</td> + <td> + Suche rückwärts + </td> + </tr> + <tr> + <td> +MENU:SEARCH_NEXT + </td> + <td> + n</td> + <td> + Suche weitere Übereinstimmung</td> + </tr> + <tr> + <td> +MENU:SEARCH_PREV + </td> + <td> + N</td> + <td> + Suche frühere Übereinstimmung</td> + </tr> +<!--mh 2016-06-12 Pressing C-z in menu mode (with menu active) has the same effect as in normal operation of w3m: Browser gets in the background + <tr> + <td> +MENU:SUSPEND + </td> + <td> + C-z</td> + <td> + Suspend</td> + </tr> +--> +<!-- </table>--> + <tr> + <td colspan="3"> + <h3>Eingabezeile-Bearbeitungs-Modus</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + LINEEDIT:FORWARD + </td> + <td width="100"> + C-f, RIGHT + </td> + <td> + Bewege Cursor vorwärts + </td> + </tr> + <tr> + <td> +LINEEDIT:BACK + </td> + <td> + C-b, LEFT + </td> + <td> + Bewege Cursor rückwärts + </td> + </tr> + <tr> + <td> +LINEEDIT:BS + </td> + <td> + C-h, BKSPC + </td> + <td> + Vorheriges Zeichen löschen + </td> + </tr> + <tr> + <td> +LINEEDIT:DEL + </td> + <td> + C-d + </td> + <td> + Aktuelles Zeichen löschen + </td> + </tr> + <tr> + <td> +LINEEDIT:KILL_AFTER + </td> + <td> + C-k + </td> + <td> + Lösche alles nach dem Cursor + </td> + </tr> + <tr> + <td> +LINEEDIT:KILL_BEFORE + </td> + <td> + C-u + </td> + <td> + Lösche alles vor dem Cursor + </td> + </tr> + <tr> + <td> +LINEEDIT:TOP + </td> + <td> + C-a + </td> + <td> + Gehe zum Zeilenanfang + </td> + </tr> + <tr> + <td> +LINEEDIT:BOTTOM + </td> + <td> + C-e + </td> + <td> + Gehe zum Zeilenende + </td> + </tr> + <tr> + <td> +LINEEDIT:PREV + </td> + <td> + C-p, UP + </td> + <td> + Hole den vorherigen Chronik-Eintrag + </td> + </tr> + <tr> + <td> +LINEEDIT:NEXT + </td> + <td> + C-n, DOWN + </td> + <td> + Hole den nächsten Chronik-Eintrag + </td> + </tr> + <tr> + <td> +LINEEDIT:COMPLETE + </td> + <td> + TAB, SPC + </td> + <td> + Versuche, den Dateinamen zu komplettieren + </td> + </tr> + <tr> + <td> +LINEEDIT:EDITOR + </td> + <td> + C-o + </td> + <td> + Bearbeite mit externem Editor + </td> + </tr> + <tr> + <td> +LINEEDIT:ACCEPT + </td> + <td> + RET + </td> + <td> + Eingabezeile übernehmen + </td> + </tr> + </table> +<!-- mh 2016-06-12 As it suffices to use the provided keymap file for Lynx-like keybindings and this file is listed in section FILES of man w3m (1), the following hint for getting w3m with Lynx-like key bindings has been deleted. + <p> + If w3m was compiled with <q>Lynx-like key bindings</q>, you can use + the following key bindings. + </p> +--> +<!-- mh 2016-06-12 Remark is obsolete as the two sets key binding are presented along within tables + <hr> + <h2 id="Key:lynx"> + <p> + The Lynx-like configuration leaves keymappings unchanged in the + menu-selection and line-editing modes. + </p> + </h2> +--> + <hr> + <h2 id="Mouse"> + Bedienung per Maus + </h2> + <p> + Wenn w3m mit Mausfunktionen kompiliert wurde und Sie das Programm entweder in einer Konsole mit GPM oder in einem X-Terminal-Emulator starten, ist ein Navigieren mit der Maus möglich. (Im Falle von rxvt müssen Sie die Umgebungsvariable TERM mit <q>xterm</q> oder <q>kxterm</q> belegen.) + </p> + <p>Die Datei <a href="README.mouse">README.mouse</a> erklärt, wie die Bedienung per Maus an eigene Vorlieben angepasst werden kann. + </p> + <table border="1"> + <colgroup> + <col width="20%"> + <col width="80%"> + </colgroup> + <tr> + <th>Handlung + </th> + <th>Beschreibung + </th> + </tr> + <tr> + <td> + Linksklick + </td> + <td> +<b>Zuerst:</b><br> Der Cursor wird an die Mauszeigerposition versetzt.<br> <b>Dann:</b><br> Dem Hyperlink, auf dem der Cursor momentan steht und auf den sich der Mauszeiger richtet, wird gefolgt. + </td> + </tr> + <tr> + <td> + Mittelklick + </td> + <td> + Zurück zum vorherigen Puffer. + </td> + </tr> + <tr> + <td> + Rechtsklick + </td> + <td> + Öffne Menü. Sie können Menüpunkte durch Anklicken auswählen. + </td> + </tr> + <tr> + <td> + Linksziehen + </td> + <td> + Dokument scrollen. Standardmäßig wird das Dokument im Fenster verschoben. Ein Verschieben des Fensters über dem stehenden Dokument erreichen Sie über den Einstellungs-Dialog. + </td> + </tr> + </table> + <hr> + <h2 id="LocalCGI"> + Lokale CGI-Skripte + </h2> + <p> + w3m ist in der Lage, CGI-Skripte direkt laufen zu lassen. Dies bedeutet, dass sich das Programm wie ein HTTP-Server verhält und das CGI-Skript ausführt und dessen Ausgabe anzeigt. Beispielsweise wurden die Lesezeichen-Registrierung und der Verzeichnis-Browser als lokale CGI-Skripte programmiert. Darüber hinaus kann w3m durch solche Skripte als Schnittstelle zum Einholen von Daten aller Art fungieren. + </p> + <p> + Aus Sicherheitsgründen kommen für von w3m benutzte CGI-Skripte nur folgende Verzeichnisse in Frage: + </p> + <ul> + <li> + Das Verzeichnis, in dem w3m-bezogene Dateien abgelegt sind (typischerweise /usr/local/lib/w3m). Auf dieses Verzeichnis kann mit der Variblen $LIB referenziert werden. + </li> + <li> + Das Verzeichnis /cgi-bin/. Sie können /cgi-bin/ im Feld <q>Verzeichnis für ausführbare Skripte</q> des Einstellungs-Dialogs jedem gewünschten Verzeichnis zuordnen. Mehrere Pfade lassen sich durch Doppelpunkt getrennt angeben, also in der Form <span class="mono">/usr/local/cgi-bin:/home/aito/cgi-bin</span>. Es wird davon abgeraten, das aktuelle Verzeichnis hier mitaufzunehmen. Zum Zugriff auf Skripte im Verzeichnis /cgi-bin/ erwartet w3m eine URL folgender Art: + </li> +<pre> + w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi +</pre> + </ul> + <p> + Das CGI-Skript kann zur Steuerung von w3m die spezielle Kopfzeile <span class="mono">w3m-control:</span> enthalten. Darin können alle Funkionen (siehe <a href="README.func">README.func</a>) eingetragen sein. Die angegebene Funktion wird aufgerufen, nachdem das Dokument angezeigt wird. Beispielsweise, wird eine Skriptausgabe + </p> +<pre> +Content-Type: text/plain<br>W3m-control: BACK +</pre> + <p> + eine leere Seite anzeigen und den Puffer sofort löschen. Dies ist nützlich, wenn es nicht gewünscht ist, die Seite nach Aufrufen des Skriptes anzuzeigen. Das nächste Beispiel + </p> +<pre> +Content-Type: text/plain<br>W3m-control: DELETE_PREVBUF contents..... +</pre> + <p> + führt zum Übergehen des aktuellen Puffers. + </p> + <p> + Jede <span class="mono">w3m-control</span>-Kopfzeile kann nur eine Funktion aufrufen. Jedoch können Sie im Kopfteil einer HTTP-Kommunikation mehr als eine <span class="mono">w3m-control</span>-Anweisung hinterlegen. Überdies ist es möglich, die GOTO-Funktion mit einem Argument aufzurufen: + </p> +<pre> +Content-Type: text/plain<br>W3m-control: GOTO http://www.example.org/ +</pre> + <p> + Sie bewirken damit das gleiche wie mit der Anweisung <q>Location:</q> im Kopfteil: + </p> +<pre> +Content-Type: text/plain<br>Location: http://www.example.org/ +</pre> + <p> + Beachten Sie, dass diese Anweisung wirkungslos ist, wenn das CGI-Skript durch einen HTTP-Server angesprochen wird. + </p> + </body> +</html> diff --git a/doc/MANUAL.html b/doc/MANUAL.html index 44379e9..f0710a7 100644 --- a/doc/MANUAL.html +++ b/doc/MANUAL.html @@ -1,23 +1,19 @@ <!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 manual - </title> - </head> - <body> + <head> + <title>w3m manual</title> + <style> + span.mono { + font-family:mono; + } + </style> + <meta http-equiv="content-type" content="text/html;charset=UTF-8"> + </head> + <body> <!-- -Todo: -words anchor, link, hyperlink are used with the meaning link. Decide which one shall be prefered and used throughout the documentation ---> - <!-- -Todo: -Keybindigs: Check whether there are keybindings that contain SHIFT-Letter which shall be replaced with the majuscule. Having this notation all over the documentation, this shall be noted in the introduction paragraph of section "Key bindings" ---> - <!-- -insertions tagged with "mh 2016-03-29" come from the latest version of manual page w3m (1) ---> +insertions tagged with "mh 2016-03-29" and "mh 2016-06-11" come from the latest version of manual page w3m (1) + --> + <h1>w3m MANUAL</h1> <div align="right"> Akinori Ito<br> @@ -37,32 +33,36 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa </li> <li> <a href="#Color"> - Document colors + Document Colors </a> </li> <li> - <a href="#Key:orig"> - Key bindings + <a href="#Functions"> + Functions and Key bindings </a> </li> +<!-- mh 2016-06-13 obsolete <li> <a href="#Key:lynx"> Lynx-like key bindings </a> </li> +--> <li> <a href="#Mouse"> - Mouse operation + Mouse Operation </a> </li> +<!-- mh 2016-06-13 obsolete <li> <a href="#Key:custom"> Key customization </a> </li> + --> <li> <a href="#LocalCGI"> - Local CGI + Local CGI scripts </a> </li> </ul> @@ -81,8 +81,9 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa <p> Command line usage is </p> +<!-- mh 2016-08-06 invocation adapted to w3m(1). w3m accepts several options and several targets --> <pre> - w3m [options] [file|URL] + w3m [option]... [file|URL]... </pre> <p> If you specify filenames/URLs on the command line, these documents @@ -94,143 +95,118 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa Options include: </p> <dl> - <dt> - +<i>number</i> +<h3>General options</h3> + <dt> + -B </dt> <dd> <p> - Move to the specified line-number. + <!-- mh 2016-03-29--> + with no other target defined, use the bookmark page for startup </p> </dd> - <dt> - -t <i>width</i> - <!--mh 2016-03-29 -t <i>num</i>--> + <dt> + -M </dt> <dd> <p> - Specify tab width. Default is 8. - <!--mh 2016-03-29 set tab width to num columns. No effect on stdout--> + <!-- mh 2016-03-29--> + monochrome display </p> </dd> <dt> - -r + -no-mouse </dt> <dd> <p> - When displaying text/plain documents, prohibit emphasis using - backspace. If you don't specify this option, <q>A^H_</q> is - interpreted as an underlined <q>A</q> and <q>A^HA</q> as a bold - <q>A</q>. -<!-- mh 2016-03-29 -use caret notation to display special escape characters (such as ANSI escapes or nroff-style backspaces for bold and underlined characters) instead of processing them ---> + deactivate mouse support. </p> </dd> <dt> - -l <i>number</i> + -num </dt> <dd> <p> - Specify the number of lines that should be cached while reading a - text/plain document from standard input. Default is 10,000. + <!-- mh 2016-03-29--> + display each line's number + </p> </dd> +<!-- mh 2016-08-06 commented out. As implementation is not verified. <dt> - -O <i>charset</i> + -ppc <i>num</i> </dt> <dd> <p> - Specify display/output charset. -<!-- mh 2016-03-29 -user defined character encoding of output data ---> + width of <i>num</i> pixels per character. Range of 4.0 to 32.0, + default 8.0. Larger values will make tables + narrower. (Implementation not verified) </p> </dd> +--> <dt> - -I <i>charset</i> + -v </dt> <dd> <p> - Specify document charset. -<!-- mh 2016-03-29 -user defined character encoding of input data ---> + <!-- mh 2016-03-29--> + with no other target defined, welcome users with a built-in page </p> </dd> <dt> - -T <i>type</i> + -W </dt> <dd> <p> - 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: + <!-- mh 2016-03-29--> + toggle wrapping mode in searches </p> - <p> - Read HTML document from standard input and display it - </p> -<pre> - cat example.html | w3m -T text/html -</pre> - <p> - Display HTML source - </p> -<pre> - w3m -T text/plain example.html -</pre> </dd> <dt> - -m + -X </dt> <dd> <p> - Display document using <q>Internet message mode</q>. With this - option, w3m determines document type from header information. - This is useful when reading e-mail or Usenet news posts. -<!-- mh 2016-03-29 -Render the body of Usenet messages according to the header <q>Content-type</q> ---> + upon exit, do not reinitialize the terminal. </p> </dd> <dt> - -v + +<i>num</i> </dt> <dd> - <p> - Show w3m's startup page. -<!-- mh 2016-03-29 -with no other target defined, welcome users with a built-in page ---> + <p><!--mh 2016-06-11 --> + go to line <i>num</i>; only effective for numbers larger + than the number of lines in the terminal </p> </dd> +<h3>Browser options</h3> <dt> - -B + -cols <i>num</i> </dt> <dd> <p> - Show w3m's bookmarks page. -<!-- mh 2016-03-29 -with no other target defined, use the bookmark page for startup ---> + <!-- mh 2016-06-11 --> + with stdout as destination; HTML is rendered to lines of <i>num</i> + characters </p> </dd> <dt> - -bookmark <i>file</i> + -cookie </dt> <dd> <p> - Specify a custom bookmarks file. + <!-- mh 2016-03-29--> + use stored cookies and accept new ones </p> </dd> <dt> - -M + -no-cookie </dt> <dd> <p> - Monochrome display mode. -<!-- mh 2016-03-29 -monochrome display ---> + <!-- mh 2016-03-29--> + neither use stored cookies nor accept new ones + </p> </dd> <dt> @@ -238,250 +214,238 @@ monochrome display </dt> <dd> <p> - Automatically render HTML frames. -<!-- mh 2016-03-29 -render frames ---> + <!-- mh 2016-03-29--> + render frames </p> </dd> <dt> - -s + -no-graph </dt> <dd> <p> - Squeeze blank lines. -<!-- mh 2016-03-29 -squeeze multiple blank lines into one ---> + <!-- mh 2016-03-29--> + do not use graphic characters for drawing HTML table and frame + borders </p> </dd> <dt> - -X + -header <i>string</i> </dt> <dd> <p> - Upon exit, do not reinitialize the terminal. + <!-- mh 2016-03-29--> + append <i>string</i> to the HTTP(S) request. Expected to match + the header syntax <span class="mono">"Variable: Value"</span> </p> </dd> <dt> - -W + -m </dt> <dd> <p> - Toggle wrapping mode in searches. + display document using <q>Internet message mode</q>. With this + option, w3m determines document type from header information. + This is useful when reading e-mail or Usenet news posts. <!-- mh 2016-03-29 -toggle wrapping in searches +Render the body of Usenet messages according to the header <q>Content-type</q> --> - </p> </dd> <dt> - -o <i>option</i>=<i>value</i> + -no-proxy </dt> <dd> <p> - Specify option. The available option names and values are the - same as in ~/.w3m/config. -<!-- mh 2016-03-29 -modify one configuration item with an explicitly given value; without option=value, equivalent to -show-option ---> - </p> + <!-- mh 2016-06-11--> + do not use proxy + </p> </dd> <dt> - -cookie + -post <i>file</i> </dt> <dd> - <p> - Process cookies. -<!-- mh 2016-03-29 -use stored cookies and accept new ones ---> - + <p><!--funktionierend 2016-06-28T08:22>--> + use POST method to upload data defined in <i>file</i>. The + syntax to be used is <span class="mono">"var1=value1[&var2=value2]…"</span> </p> </dd> +<h3>Text pager options</h3> <dt> - -no-cookie + -l <i>num</i> </dt> <dd> <p> - Don't process cookies. -<!-- mh 2016-03-29 -neither use stored cookies nor accept new ones ---> - + <!-- mh2016-06-11--> + number of lines preserved internally when receiving plain text + from stdin (default 10,000) </p> </dd> <dt> - -num + -r </dt> <dd> <p> - Show line-numbers. -<!-- mh 2016-03-29 -display each line's number ---> + <!-- mh 2016-03-29 --> + use caret notation to display special escape characters (such as + ANSI escapes or nroff-style backspaces for bold and underlined + characters) instead of processing them </p> </dd> <dt> - -dump + -s </dt> <dd> <p> - 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. - -<!-- mh 2016-03-29 -dump rendered page into stdout. Set implicitly when output is directed to a file or pipe ---> - + <!-- mh 2016-03-29--> + squeeze multiple blank lines into one </p> </dd> - <dt> - -cols <i>width</i> + + <dt> + <!--mh 2016-03-29 --> -t <i>num</i> </dt> <dd> <p> - Specify document width. Used with -dump option. + <!--mh 2016-03-29--> set tab width to <i>num</i> columns. No effect on stdout </p> </dd> +<h3>Data type/encoding options</h3> <dt> - -ppc <i>count</i> + -I <i>charset</i> </dt> <dd> <p> - Specify the number of pixels per character (default 8.0). Larger - values will make tables narrower. -<!-- mh 2016-03-29 -width of num pixels per character. Range of 4.0 to 32.0, default 8.0. Larger -values will make tables narrower. (Implementation not verified) ---> + <!-- mh 2016-03-29--> + user defined character encoding of input data </p> </dd> <dt> - -dump_source + -O <i>charset</i> </dt> <dd> <p> - Read document specified by URL and dump the source. -<!-- mh 2016-03-29 -dump the page's source code into stdout ---> + <!-- mh 2016-03-29 --> + user defined character encoding of output data </p> </dd> <dt> - -dump_head + -T <i>type</i> </dt> <dd> + <p> + <!-- mh 2016-06-11--> + explicit characterization of input data by MIME 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: + </p> <p> - Read document specified by URL and dump headers. -<!-- mh 2016-03-29 -dump response of a HEAD request for a URL into stdout ---> + Read HTML document from standard input and display it </p> +<pre> + cat example.html | w3m -T text/html +</pre> + <p> + Display HTML source + </p> +<pre> + w3m -T text/plain example.html +</pre> </dd> +<h3>Options for data output, followed by immediate exit</h3> <dt> - -dump_both + -dump </dt> <dd> - <p> - Read document specified by URL and dump headers and the source. -<!-- mh 2016-03-29 -dump HEAD, and source code for a URL into stdout ---> - - </p> + <p> + read document specified by URL and dump page rendered as text + into standard output. + <!-- mh 2016-03-29 --> + Is set implicitly when output is directed + to a file or pipe. A width of 80 columns is used unless option + -cols sets another value. + </p> </dd> <dt> - -dump_extra + -dump_source </dt> <dd> <p> - Read document specified by URL and dump extra informations, - headers, and the source. -<!-- mh 2016-03-29 -dump HEAD, source code, and extra information for a URL into -stdout ---> - + <!-- mh 2016-03-29--> + dump the page's source code into stdout </p> </dd> <dt> - -post <i>file</i> + -dump_head </dt> <dd> <p> - Use POST method with file content. -<!-- mh 2016-03-29 -use POST method to upload data defined in <q>file</q>. The syntax to be - used is var1=value1[&var2=value2]... ---> - + <!-- mh 2016-03-29--> + dump response of a HEAD request for a URL into stdout </p> </dd> <dt> - -header <i>string</i> + -dump_both </dt> <dd> <p> - Insert string as a header. -<!-- mh 2016-03-29 -append <q>string</q> to the HTTP(S) request. Expected to match the -header syntax Variable: Value ---> + <!-- mh 2016-03-29--> + dump HEAD, and source code for a URL into stdout </p> </dd> <dt> - -no-proxy + -dump_extra </dt> <dd> <p> - Don't use proxy server. + <!-- mh 2016-03-29--> + dump HEAD, source code, and extra information for a URL into + stdout </p> </dd> + +<h3>Options for overriding default settings and resources</h3> + <dt> - -no-graph + -bookmark <i>file</i> </dt> <dd> <p> - Use ASCII characters to draw frames rather than graphical ones. -<!-- mh 2016-03-29 -do not use graphic characters for drawing HTML table and -frame borders ---> - + <!-- mh 2016-03-29--> + use <i>file</i> instead of the default bookmark.html file </p> </dd> <dt> - -no-mouse + -config <i>file</i> </dt> <dd> <p> - Deactivate mouse support. + <!--mh 2016-06-11--> + use <i>file</i> instead of the default configuration file </p> </dd> <dt> - -config <i>file</i> + -o <i>option</i>=<i>value</i> </dt> <dd> <p> - Specify config file. + <!-- mh 2016-03-29--> + modify one configuration item with an explicitly given value; without <i>option=value</i>, equivalent to <i>-show-option</i> </p> </dd> </dl> <hr> <h2 id="Color"> - Document colors + Document Colors </h2> <p> - Links and images are displayed as follows. + Hyperlinks and images are displayed as follows. </p> <div align="center"> <table border="1"> <tr> <th> - </th> <th> Color mode @@ -492,7 +456,7 @@ frame borders </tr> <tr> <td> - links + Hyperlinks </td> <td> blue @@ -503,7 +467,7 @@ frame borders </tr> <tr> <td> - inline images + Inline images </td> <td> green @@ -514,7 +478,7 @@ frame borders </tr> <tr> <td> - form input + Form input </td> <td> red @@ -526,1565 +490,1796 @@ frame borders </table> </div> <p> - These colors can be customized using the option setting command - <q>o</q>. + These colors can be customized using the options setting command + <i>o</i>. </p> <hr> - <h2 id="Key:orig"> - Key bindings + <h2 id="Functions"> + Functions and Key bindings </h2> + + <p> + After invocation, you can control w3m by typing in functions by name + or with keystroke combinations bound to a function. There are + default key bindings. +<!-- mh 2016-06-13 obsolete + If you prefer using Lynx-like + key bindings, make w3m start with the respective keymap file keymap.lynx. (see w3m (1)).--> + </p> <!-- - TODO: reorganise this whole thing into one big table of - FUNCTIONNAME | description | default-binding | Lynxlike-binding -!--> + <h2 id="Key:custom"> + Key customization + </h2> +--> <p> - After invoking w3m, you can control it with keyboard commands. + You can customize the key bindings (except those for menu + operations and line-editing) in a ~/.w3m/keymap file. For example, </p> + +<pre> + keymap C-o NEXT_PAGE +</pre> + <p> - Here's the original key-binding table. If you are using Lynx-like - key bindings, see <a href="#Key:lynx">the Lynx-like key - bindings</a>. Throughout, the <q>C-</q> and <q>M-</q> notations - indicate the modifiers <q>control</q> and <q>meta</q> (which can be - replaced with <q>alt</q> or ESC); on the other hand <q>2 M</q> - simply means <q>2</q> followed by <q>M</q>. + binds the command <span class="mono">NEXT_PAGE</span> (normally bound to SPC and C-v) + to control-o. See <a href="README.func">README.func</a> for a list + of available functions. Original and Lynx-like keymap definitions + are provided as examples: <a href="keymap.default">keymap.default</a> + and <a href="keymap.lynx">keymap.lynx</a>. </p> -<!-- -Correction: -The two equivalents to the meta-key are pressing simultaneously the ALT-key or pressing the ESC-key first and then other mentioned keys. ---> - <h3> - In-page navigation - </h3> - <table> - <tr> - <td width="100"> + + <p> + Throughout, the <i>C-</i> and <i>M-</i> notations indicate the + modifiers <i>control</i> and <i>meta</i>. The <i>ALT</i>-key + replaces the latter whereas pressing the <i>ESC</i>-key toggles + between <i>meta</i>-modified and simple keystrokes. The minus + indicates pressing the keys simultaneously wheras a space + represents that one key is pressed after the other, i.e. <i>2 M</i> + simply means <i>2</i> followed by <i>M</i>. + </p> + + + <table border="1" width="100%"> + <colgroup> + <col width="20%"> + <col width="20%"> + <col width="20%"> + <col width="40%"> + </colgroup> + <tr> + <th rowspan="2"> + Function + </th> + <th colspan="2">Key binding + </th> + <th rowspan="2"> + Description + </th> + </tr> + <tr> + <th> + Default + </th> + <th> + Lynx-like + </th> + </tr> + <tr> + <td colspan="4"> + <h3>In-page navigation</h3> +</td> + </tr> + <tr> + <td> + NEXT_PAGE + </td> + <td> SPC, C-v, +, PGDN </td> <td> - Forward page + SPC, C-v, + + </td> + <td> + Scroll one page downwards </td> </tr> <tr> + <td> + PREVIOUS_PAGE + </td> <td> b, M-v, -, PGUP </td> <td> - Backward page + b, M-v, - + </td> + <td> + Scroll one page upwards </td> </tr> <tr> + <td> + MOVE_RIGHT + </td> <td> l, C-f, RIGHT </td> <td> - Cursor right + l + </td> + <td> + Move cursor right (with a half-screen shift at the screen edge) </td> </tr> <tr> + <td> + MOVE_LEFT + </td> <td> h, C-b, LEFT </td> <td> - Cursor left - </td> - </tr> - <tr> - <td> - j, C-n, DOWN + h </td> <td> - Cursor down + Move cursor left (with a half-screen shift at the screen edge) </td> </tr> <tr> + <td> + MOVE_DOWN + </td> <td> - k, C-p, UP - </td> - <td> - Cursor up + j, C-n, DOWN </td> - </tr> - <tr> <td> - J + j </td> <td> - Scroll screen up one line + Move cursor down (with a one-line scroll at the screen edge) </td> </tr> <tr> + <td> + MOVE_UP + </td> <td> - K - </td> - <td> - Scroll screen down one line + k, C-p, UP </td> - </tr> - <tr> <td> - ^, C-a + k </td> <td> - Go to the beginning of line + Move cursor up (with a one-line scroll at the screen edge) </td> </tr> <tr> + <td> + UP + </td> <td> - $, C-e - </td> - <td> - Go to the end of line + J </td> - </tr> - <tr> <td> - w + J </td> <td> - Go to the next word + Scroll the screen up one line </td> </tr> <tr> + <td> + DOWN + </td> <td> - W - </td> - <td> - Go to the previous word + K </td> - </tr> - <tr> <td> - > + K </td> <td> - Shift screen right + Scroll the screen down one line </td> </tr> <tr> + <td> + LINE_BEGIN + </td> <td> - < - </td> - <td> - Shift screen left + ^, C-a </td> - </tr> - <tr> <td> - . + ^ </td> <td> - Shift screen one column right + Go to the beginning of the line </td> </tr> <tr> + <td> + LINE_END + </td> <td> - , - </td> - <td> - Shift screen one column left + $, C-e </td> - </tr> - <tr> <td> - g, M-<, HOME + $ </td> <td> - Go to the first line + Go to the end of the line </td> </tr> <tr> + <td> + NEXT_WORD + </td> <td> - G, M->, END + w </td> <td> - Go to the last line + w </td> - </tr> - <tr> <td> - M-g - </td> - <td> - Go to the specified line + Move to the next word </td> </tr> <tr> + <td> + PREVIOUS_WORD + </td> <td> - Z - </td> - <td> - Center on cursor column + W </td> - </tr> - <tr> <td> - z + W </td> <td> - Center on cursor line + Move to the previous word </td> </tr> <tr> + <td> + SHIFT_RIGHT + </td> <td> - TAB - </td> - <td> - Move to the next hyperlink + > </td> - </tr> - <tr> <td> - C-u, M-TAB + > </td> <td> - Move to the previous hyperlink + Shift screen right </td> </tr> <tr> + <td> + SHIFT_LEFT + </td> <td> - [ - </td> - <td> - Move to the first hyperlink + < </td> - </tr> - <tr> <td> - ] + < </td> <td> - Move to the last hyperlink + Shift screen left </td> </tr> - </table> - <h3>Hyperlink operation</h3> - <table> <tr> - <td width="100"> - C-j, C-m, RET - </td> + <td> + RIGHT + </td> <td> - Follow hyperlink + . </td> - </tr> - <tr> <td> - a, M-RET + . </td> <td> - Save link to file + Shift screen one column right </td> </tr> <tr> + <td> + LEFT + </td> <td> - u - </td> - <td> - Show link URL + , </td> - </tr> - <tr> <td> - i + , </td> <td> - Show image URL + Shift screen one column left </td> </tr> <tr> + <td> + BEGIN + </td> <td> - I - </td> - <td> - View inline image + g, M-<, HOME </td> - </tr> - <tr> <td> - M-I + C-a, M-< </td> <td> - Save inline image to file + Go to the first line </td> </tr> <tr> + <td> + END + </td> <td> - : - </td> - <td> - Mark URL-like strings as hyperlinks + G, M->, END </td> - </tr> - <tr> <td> - M-: + C-e, M-> </td> <td> - Mark Message-ID-like strings as links + Go to the last line </td> </tr> <tr> + <td> + GOTO_LINE + </td> <td> - c - </td> - <td> - Show current URL + M-g </td> - </tr> - <tr> <td> - = + G </td> <td> - Show information about current document + Go to the specified line </td> </tr> <tr> + <td> + LINE_INFO + </td> <td> C-g </td> <td> - Show current position in page - </td> - </tr> - <tr> - <td> - C-h + C-g </td> <td> - Show browsing history + Display current position in document </td> </tr> <tr> + <td> + CENTER_H + </td> <td> - M - </td> - <td> - Browse current document using external browser (prefix 2, 3, ..., - or 9 to invoke alternate configured browsers, e.g. 3 M) + Z </td> - </tr> - <tr> +<!--Correction by mh 2014-04-06 +Description for keybinding of z and Z had been mingled +--> <td> - M-M + Z </td> <td> - Browse link using external browser (prefixed as above, e.g. - 3 M-M) + Center screen right and left of the cursor column </td> </tr> - </table> - <h3> - Bookmark management - </h3> - <table> <tr> - <td width="100"> - M-b - </td> + <td> + CENTER_V + </td> <td> - Go to the bookmarks page + z </td> - </tr> - <tr> <td> - M-a + z </td> <td> - Bookmark current page + Center screen above and below the cursor line </td> </tr> - </table> - <h3> - File/stream operation - </h3> - <table> <tr> - <td width="100"> - U - </td> + <td> + NEXT_LINK + </td> <td> - Open new URL + TAB </td> - </tr> - <tr> <td> - V + TAB, C-n, DOWN </td> <td> - Open new file + Move to the next hyperlink </td> </tr> <tr> + <td> + PREVIOUS_LINK + </td> <td> - @ - </td> - <td> - Execute shell command and view output + M-TAB, C-u </td> - </tr> - <tr> <td> - # + M-TAB, C-u, C-p, UP </td> <td> - Execute shell command and browse output + Move to the previous hyperlink </td> +<!-- Annotion mh 2016-04-06 +Keybinding description for C-g had been moved as it did not fit to "Hyperlink operation" and position in the default and lynx-like series differed + --> </tr> - </table> - <h3> - Content operations - </h3> - <table> <tr> - <td width="100"> - v - </td> + <td> + LINK_BEGIN + </td> <td> - Toggle viewing as text or rendered HTML + [ </td> - </tr> - <tr> <td> - F + [ </td> <td> - Toggle rendering HTML frames + Move to the first hyperlink </td> </tr> <tr> + <td> + LINK_END + </td> <td> - C-l + ] </td> <td> - Redraw screen - </td> - </tr> - <tr> - <td> - R + ] </td> <td> - Reload + Move to the last hyperlink </td> </tr> +<tr> +<td>MOVE_LIST_MENU</td> +<td>M-m</td> +<td>M-m</td> +<td>Pop up menu to navigate between hyperlinks</td> +</tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Hyperlink Operations</h3> + </td> + </tr> +<!-- <table>--> <tr> + <td> + GOTO_LINK + </td> <td> - E - </td> - <td> - Edit local source + C-j, C-m, RET </td> - </tr> - <tr> - <td> - M-e + <td width="100"> + C-f, C-j, C-m, RET, RIGHT </td> <td> - Edit rendered copy of page + Follow current hyperlink in a new buffer </td> </tr> +<tr> +<td>LIST_MENU</td> +<td>M-l</td> +<td>M-l</td> +<td>Pop up hyperlink menu and select one to be followed</td> +</tr> <tr> + <td> + SAVE_LINK + </td> <td> - M-s - </td> - <td> - Save source + a, M-RET </td> - </tr> - <tr> <td> - S + d, M-RET </td> <td> - Save rendered copy of page + Save the hyperlink target </td> </tr> - </table> - <h3> - Buffer/tab navigation - </h3> - <table> <tr> - <td width="100"> - B - </td> + <td> + PEEK_LINK + </td> <td> - Go back, <q>popping</q> the buffer stack + u </td> - </tr> - <tr> <td> - s + u </td> <td> - Show buffer-stack menu + Show target address </td> </tr> <tr> + <td> + PEEK_IMG + </td> <td> - M-t - </td> - <td> - Show tab menu + i </td> - </tr> - <tr> <td> - T + i </td> <td> - Open current page as new tab + Show image address </td> </tr> <tr> + <td> + VIEW_IMAGE + </td> <td> - C-t - </td> - <td> - Open link as new tab + I </td> - </tr> - <tr> <td> - } + I </td> <td> - Switch to next tab + Display image in viewer </td> </tr> <tr> + <td> + SAVE_IMAGE + </td> <td> - { - </td> - <td> - Switch to previous tab + M-I </td> - </tr> - <tr> <td> - C-q + M-I </td> <td> - Close current tab + Save inline image </td> </tr> - </table> - <h3> - Search - </h3> - <table> +<tr> +<td>MARK_WORD</td> +<td>;</td> +<td>;</td> +<td>Turn current word into hyperlink</td> +</tr> <tr> - <td width="100"> - / - </td> + <td> + MARK_URL + </td> <td> - Search forward + : </td> - </tr> - <tr> <td> - ? + : </td> <td> - Search backward + Turn URL-like strings into hyperlinks </td> </tr> <tr> - <td width="100"> - C-s - </td> + <td> + MARK_MID + </td> <td> - Incremental search forward + M-: </td> - </tr> - <tr> <td> - C-r + M-: </td> <td> - Incremental search backward +<!-- changed due to mail dated Mon, 04 Apr 2016 00:47:09 +0900 (JST) +from Tatsuya Kinoshita --> + Turn Message-ID-like strings into hyperlinks </td> </tr> <tr> + <td> + PEEK + </td> <td> - n - </td> - <td> - Next match + c </td> - </tr> - <tr> <td> - N + c </td> <td> - Previous match + Show current address </td> </tr> <tr> + <td> + INFO + </td> <td> - C-w + = </td> <td> - Toggle wrapping mode in searches - </td> - </tr> - </table> - <h3> - Mark management - </h3> - <table> - <tr> - <td width="100"> - C-SPC + = </td> <td> - Set/unset mark + Display information about the current document </td> </tr> <tr> + <td> + HISTORY + </td> <td> - M-p - </td> - <td> - Go to the previous mark + C-h </td> - </tr> - <tr> <td> - M-n + C-h </td> <td> - Go to the next mark + Show browsing history </td> </tr> <tr> + <td> + EXTERN + </td> <td> - " + M </td> <td> - Mark all occurrences of a regular expression - </td> - </tr> - </table> - <h3> - Miscellany - </h3> - <table> - <tr> - <td width="100"> - ! + M </td> <td> - Execute shell command + Browse current document using external browser (prefix 2, 3, ..., + or 9 to invoke alternate configured browsers, e.g. 3 M) </td> </tr> <tr> + <td> + EXTERN_LINK + </td> <td> - M-c - </td> - <td> - Invoke w3m function + M-M </td> - </tr> - <tr> <td> - H + M-M </td> <td> - Show help panel + Browse link using external browser (prefixed as above, e.g. + 3 M-M) </td> </tr> - <tr> - <td> - o - </td> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Bookmark management</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + BOOKMARK + </td> <td> - Show options panel + M-b </td> - </tr> - <tr> <td> - C-k + v, M-b </td> <td> - Show cookie jar + View bookmarks </td> </tr> <tr> + <td> + ADD_BOOKMARK + </td> <td> - C-c - </td> - <td> - Interrupt + M-a </td> - </tr> - <tr> <td> - C-z + a, M-a </td> <td> - Suspend w3m + Add current page to bookmarks </td> </tr> - <tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>File/Stream Operations</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + GOTO + </td> <td> - q + U </td> <td> - Quit (with confirmation dialog) - </td> - </tr> - <tr> - <td> - Q + g, U </td> <td> - Quit without confirmation + Open specified document in a new buffer </td> </tr> - </table> -<!-- - TODO: import leftovers from current keymap (same in both): - ( UNDO - ) REDO - ; MARK_WORD - D DOWNLOAD_LIST - L LIST - m MOUSE_TOGGLE - r VERSION - | PIPE_BUF - M-W DICT_WORD_AT - M-c COMMAND - M-k DEFINE_KEY - M-l LIST_MENU - M-m MOVE_LIST_MENU - M-o SET_OPTION - M-u GOTO_RELATIVE - M-w DICT_WORD - M-Fn MENU -!--> - <p> - Two special operational modes exist which have built-in (not - redefinable) keymappings: - </p> - <h3> - Menu selection mode - </h3> - <table> - <tr> - <td width="100"> - k, C-p, UP - </td> +<tr> +<td>GOTO_RELATIVE</td> +<td>M-u</td> +<td>M-u</td> +<td>Open relative address in a new buffer</td> +</tr> + <tr> + <td> + LOAD + </td> <td> - Select previous item + V </td> - </tr> - <tr> <td> - j, C-n, DOWN + V </td> <td> - Select next item + Open local file in a new buffer </td> </tr> - <tr> - <td> - D - </td> + <tr> + <td> + READ_SHELL + </td> <td> - Delete current item + @ </td> - </tr> - <tr> <td> - SPC, RET + @ </td> <td> - Go to the selected item + <!--Execute shell command and view output--> + <!--mh 2016-06-13 No difference to PIPE_SHELL could be discerned--> + Execute shell command and display output in a new buffer </td> </tr> - </table> - <h3> - Line-editing mode - </h3> - <table> - <tr> - <td width="100"> - C-f, RIGHT - </td> + <tr> + <td> + PIPE_SHELL + </td> <td> - Move cursor forward + # </td> - </tr> - <tr> <td> - C-b, LEFT + # </td> <td> - Move cursor backward + <!--Execute shell command and browse output--> + <!--mh 2016-06-13 No difference to READ_SHELL could be discerned--> + Execute shell command and display output in a new buffer </td> </tr> - <tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Content Operations</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + VIEW <!-- is an alias to SOURCE --> + </td> <td> - C-h, BKSPC + v </td> <td> - Delete previous character + \ </td> - </tr> - <tr> <td> - C-d + Toggle between source code and rendered view of the document </td> + </tr> +<tr> +<td>LIST</td> +<td>L</td> +<td>L</td> +<td>List link elements, hyperlinks and images</td> +</tr> + <tr> + <td> + FRAME + </td> <td> - Delete current character + F </td> - </tr> - <tr> <td> - C-k + F </td> <td> - Kill everything after cursor + Toggle rendering HTML frames </td> </tr> - <tr> + <tr> + <td> + REDRAW + </td> <td> - C-u + C-l </td> <td> - Kill everything before cursor + C-l, C-w </td> - </tr> - <tr> <td> - C-a + Draw the screen anew </td> + </tr> + <tr> + <td> + RELOAD + </td> <td> - Move to the beginning of line + R </td> - </tr> - <tr> <td> - C-e + R, C-r </td> <td> - Move to the end of line + Load current document anew </td> </tr> - <tr> + <tr> + <td> + EDIT + </td> <td> - C-p, UP + E </td> <td> - Fetch the previous string from the history list + E </td> - </tr> - <tr> <td> - C-n, DOWN + Edit local source </td> + </tr> + <tr> + <td> + EDIT_SCREEN + </td> <td> - Fetch the next string from the history list + M-e </td> - </tr> - <tr> <td> - TAB, SPC + M-e </td> <td> - Try to complete filename + Edit rendered copy of document </td> </tr> - <tr> +<tr> +<td>PIPE_BUF</td> +<td>|</td> +<td>|</td> +<td>Pipe current buffer through a shell command and display output</td> +</tr> + <tr> + <td> + DOWNLOAD <!-- is an alias to SAVE --> + </td> <td> - RET + M-s </td> <td> - Accept - </td> - </tr> - </table> - <hr> - <h2 id="Key:lynx"> - Lynx-like key bindings - </h2> - <p> - If w3m was compiled with <q>Lynx-like key bindings</q>, you can use - the following key bindings. - </p> - <h3> - In-page navigation - </h3> - <table> - <tr> - <td width="100"> - SPC, C-v, + + M-s </td> <td> - Forward page + Save document source </td> </tr> - <tr> + <tr> + <td> + SAVE_SCREEN + </td> <td> - b, M-v, - + S </td> <td> - Backward page - </td> - </tr> - <tr> - <td> - l + S, p </td> <td> - Cursor right + Save rendered document </td> </tr> - <tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Buffer/Tab Navigation</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + BACK + </td> <td> - h + B + </td> + <td> + B, C-b, LEFT </td> <td> - Cursor left + Close current buffer and return to the one below in stack </td> </tr> - <tr> + <tr> + <td> + SELECT_MENU + </td> <td> - j + s </td> <td> - Cursor down + s, C-h </td> - </tr> - <tr> <td> - k + Pop up buffer-stack menu </td> + </tr> + <tr> + <td> + TAB_MENU + </td> <td> - Cursor up + M-t </td> - </tr> - <tr> <td> - J + M-t </td> <td> - Scroll screen up one line + Pop up tab selection menu </td> </tr> - <tr> + <tr> + <td> + NEW_TAB + </td> <td> - K + T </td> <td> - Scroll screen down one line + T </td> - </tr> - <tr> <td> - ^ + Open a new tab (with current document) </td> + </tr> + <tr> + <td> + TAB_LINK + </td> <td> - Go to the beginning of line + C-t </td> - </tr> - <tr> <td> - $ + C-t </td> <td> - Go to the end of line + Follow current hyperlink in a new tab </td> </tr> - <tr> + <tr> + <td> + NEXT_TAB + </td> <td> - > + } </td> <td> - Shift screen right + } </td> - </tr> - <tr> <td> - < + Switch to the next tab </td> + </tr> + <tr> + <td> + PREV_TAB + </td> <td> - Shift screen left + { </td> - </tr> - <tr> <td> - . + { </td> <td> - Shift screen one column right + Switch to the previous tab </td> </tr> - <tr> + <tr> + <td> + CLOSE_TAB + </td> <td> - , + C-q </td> <td> - Shift screen one column left + C-q </td> - </tr> - <tr> <td> - C-a, M-< + Close the current tab </td> + </tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Searches</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + SEARCH + </td> <td> - Go to the first line + / </td> - </tr> - <tr> <td> - C-e, M-> + /, C-s </td> <td> - Go to the last line + Search forward </td> </tr> - <tr> + <tr> + <td> + SEARCH_BACK + </td> <td> - G + ? </td> + <td> + </td> <td> - Go to the specified line + Search backward </td> </tr> - <tr> + <tr> + <td> + ISEARCH + </td> <td> - w + C-s </td> + <td> + </td> <td> - Go to the next word + Incremental search forward </td> </tr> - <tr> + <tr> + <td> + ISEARCH_BACK + </td> <td> - W + C-r </td> + <td> + </td> <td> - Go to the previous word + Incremental search backward </td> </tr> - <tr> + <tr> + <td> + SEARCH_NEXT + </td> <td> - Z + n </td> <td> - Center on cursor line - </td> - </tr> - <tr> - <td> - z + n </td> <td> - Center on cursor column + Continue search forward </td> </tr> - <tr> + <tr> + <td> + SEARCH_PREV + </td> <td> - TAB, C-n, DOWN + N </td> + <td> + </td> <td> - Move to the next hyperlink + Continue search backward </td> </tr> - <tr> - <td> - M-TAB, C-p, C-u, UP - </td> + <tr> + <td> + WRAP_TOGGLE + </td> <td> - Move to the previous link + C-w </td> - </tr> - <tr> <td> - C-g + w </td> <td> - Show current position in page + Toggle wrapping mode in searches </td> </tr> - <tr> - <td> - [ - </td> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Mark Management</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + MARK + </td> <td> - Move to the first hyperlink + C-SPC </td> - </tr> - <tr> <td> - ] + C-SPC </td> <td> - Move to the last hyperlink + Set/unset mark </td> </tr> - </table> - <h3> - Hyperlink operation - </h3> - <table> - <tr> - <td width="100"> - C-f, C-j, C-m, RET, RIGHT - </td> + <tr> + <td> + PREV_MARK + </td> <td> - Follow hyperlink + M-p </td> - </tr> - <tr> <td> - d, M-RET + P </td> <td> - Save link to file + Go to the previous mark </td> </tr> - <tr> - <td> - u - </td> + <tr> + <td> + NEXT_MARK + </td> <td> - Show link URL + M-n </td> - </tr> - <tr> <td> - i + N </td> <td> - Show image URL + Go to the next mark </td> </tr> - <tr> + <tr> + <td> + REG_MARK + </td> <td> - I + " </td> <td> - View inline image - </td> - </tr> - <tr> - <td> - M-I + " </td> <td> - Save inline image to file + Mark all occurrences of a pattern </td> </tr> - <tr> +<!-- </table>--> + <tr> + <td colspan="4"> + <h3>Miscellaneous</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + COMMAND + </td> <td> - : + M-c </td> <td> - Mark URL-like strings as hyperlinks + M-c </td> - </tr> - <tr> <td> - M-: + Invoke one or more semicolon-separated w3m functions </td> + </tr> +<!-- +TODO: Where does this key binding M-Fn come from. I do not find a Fn-key on my keyboard. I do not know how to type in the keystroke combinations listed in keymap.default which are +keymap M-[E MENU +keymap M-[L MENU +keymap M-[2~ MENU +keymap M-[28~ MENU +<tr> +<td>MENU</td> +<Td>M-Fn</Td> +<td></td> +<td>Pop up menu</td> +</tr> +--> + <tr> + <td> + HELP + </td> <td> - Mark Message-ID-like strings as news anchors + H </td> - </tr> - <tr> <td> - c + H, ? </td> <td> - Show current URL + Show help panel </td> </tr> - <tr> + <tr> + <td> + OPTIONS + </td> <td> - = + o </td> <td> - Show information about current document + o </td> - </tr> - <tr> <td> - C-h - </td> + Display options setting panel + </td> + </tr> +<tr> +<td>SET_OPTION</td> +<td>M-o</td> +<td>M-o</td> +<td>Set option</td> +</tr> +<tr> +<td>DEFINE_KEY</td> +<td>M-k</td> +<td>M-k</td> +<td>Define a binding between a key stroke combination and a command</td> +</tr> +<tr> +<td>MOUSE_TOGGLE</td> +<td>m</td> +<td>m</td> +<td>Toggle mouse support</td> +</tr> +<tr> +<td>DOWNLOAD_LIST</td> +<td>D</td> +<td>D</td> +<td>Display downloads panel</td> +</tr> + <tr> + <td> + COOKIE + </td> <td> - Show browsing history + C-k </td> - </tr> - <tr> <td> - M + C-k </td> <td> - Browse current document using external browser (prefix 2, 3, ..., - or 9 to invoke alternate configured browsers, e.g. 3 M) + Show cookie jar </td> </tr> +<!-- +mh 2016-06-12 Interrupt is an alias to SUSPEND, no need to mention it here <tr> + <td> + INTERRUPT + </td> <td> - M-M + C-c </td> <td> - Browse link using external browser (prefixed as above, e.g. - 3 M-M) - </td> - </tr> - </table> - <h3> - Bookmark management - </h3> - <table> - <tr> - <td width="100"> - v, M-b + C-c </td> <td> - Go to the bookmarks page + Interrupt </td> </tr> - <tr> +--> +<tr> +<td>UNDO</td> +<td>(</td> +<td>(</td> +<td>Cancel the last cursor movement</td> +</tr> +<tr> +<td>REDO</td> +<td>)</td> +<td>)</td> +<td>Cancel the last undo</td> +</tr> + <tr> + <td> + EXEC_SHELL <!-- is an alias of SHELL --> + </td> <td> - a, M-a + ! </td> <td> - Bookmark current page - </td> - </tr> - </table> - <h3> - File/stream operation - </h3> - <table> - <tr> - <td width="100"> - g, U + ! </td> <td> - Open new URL + Execute shell command </td> </tr> - <tr> - <td> - V - </td> +<tr> +<td>DICT_WORD</td> +<td>M-w</td> +<td>M-w</td> +<td>Execute dictionary command (see <a href="README.dict">README.dict</a>)</td> +</tr> +<tr> +<td>DICT_WORD_AT</td> +<td>M-W</td> +<td>M-W</td> +<td>Execute dictionary command for word at cursor</td> +</tr> +<tr> +<td>VERSION</td> +<td>r</td> +<td>r</td> +<td>Display the version of w3m</td> +</tr> + <tr> + <td> + SUSPEND + </td> <td> - Open new file + C-z </td> - </tr> - <tr> <td> - @ + C-z </td> <td> - Execute shell command and view output + Suspend w3m to background. (To be withdrawn with shell + command <span class="mono">fg</span>.) </td> </tr> - <tr> + <tr> + <td> + QUIT + </td> <td> - # + q </td> <td> - Execute shell command and browse output - </td> - </tr> - </table> - <h3> - Content operations - </h3> - <table> - <tr> - <td width="100"> - \ + q </td> <td> - Toggle viewing as text or rendered HTML + Quit with confirmation request </td> </tr> - <tr> - <td> - F - </td> + <tr> + <td> + EXIT + </td> <td> - Toggle rendering HTML frames + Q </td> - </tr> - <tr> <td> - C-l, C-w + Q </td> <td> - Redraw screen + Quit at once </td> </tr> - <tr> + </table> + + <p> + There are the following operational modes with built-in key + bindings for relevant functions. These bindings are not subject to + the DEFINE_KEY function or entries in the file keymap. + </p> + + <table border="1" width="100%"> + <colgroup> + <col width="20%"> + <col width="40%"> + <col width="40%"> + </colgroup> + <tr> + <th> + Function<br>(internal name) + </th> + <th>Key binding + </th> + <th> + Description + </th> + </tr> + <tr> + <td colspan="3"> + <h3>Menu Selection Mode</h3> + </td> + </tr> + <tr> + <td> + BUF:NEXT</td> <td> - R, C-r + j, C-n, DOWN </td> <td> - Reload + Next item </td> </tr> - <tr> + <tr> + <td>BUF:PREV + </td> <td> - E + k, C-p, UP </td> <td> - Edit local source + Previous item </td> </tr> - <tr> + <tr> + <td> + BUF:DELETE</td> <td> - M-e + D </td> <td> - Edit rendered copy of page + Delete item </td> </tr> - <tr> + <tr> + <td> + BUF:GO + </td> <td> - M-s + SPC, RET, RIGHT </td> <td> - Save source + Select item </td> </tr> - <tr> +<!-- </table>--> + <tr> + <td colspan="3"> + <h3>Popup Menu Mode</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> +MENU:SELECT + </td> <td> - S, p - </td> + SPC, RET, RIGHT</td> <td> - Save rendered copy of page + Select </td> </tr> - </table> - <h3> - Buffer/tab navigation - </h3> - <table> - <tr> - <td width="100"> - B, C-b, LEFT + <tr> + <td> +MENU:CLOSE + </td> + <td>C-c </td> <td> - Go back, <q>popping</q> the buffer stack + Close menu </td> </tr> - <tr> - <td> - s, C-h - </td> + <tr> + <td> +MENU:CANCEL + </td> + <td> + LEFT, BKSPC, C-h</td> <td> - Show buffer-stack menu + One selection step backward </td> </tr> - <tr> - <td> - M-t + <tr> + <td> +MENU:DOWN + </td> + <td>j, C-n, DOWN </td> <td> - Show tab menu + Move to the next item </td> </tr> - <tr> - <td> - T - </td> + <tr> + <td> +MENU:UP + </td> + <td> + k, C-p, UP</td> <td> - Open current page as new tab + Move to the previous item </td> </tr> - <tr> - <td> - C-t + <tr> + <td> +MENU:LINE_UP + </td> + <td>K </td> <td> - Open link as new tab + Scroll up one item </td> </tr> - <tr> - <td> - } + <tr> + <td> +MENU:LINE_DOWN + </td> + <td>J </td> <td> - Switch to next tab + Scroll down one item </td> </tr> - <tr> - <td> - { + <tr> + <td> +MENU:TOP + </td> + <td>C-a </td> <td> - Switch to previous tab + Move to the first item </td> </tr> - <tr> - <td> - C-q + <tr> + <td> +MENU:LAST + </td> + <td>C-e </td> <td> - Close current tab + Move to the final item </td> </tr> - </table> - <h3> - Search - </h3> - <table> - <tr> - <td width="100"> - /, C-s + <tr> + <td> +MENU:NEXT + </td> + <td>C-v, C-f </td> - <td> - Search forward + <td>Go to the next page </td> </tr> - <tr> - <td> - n + <tr> + <td> +MENU:PREV + </td> + <td>ESC v, C-b </td> <td> - Next match + Go to the previous page </td> </tr> - <tr> - <td> - w + <tr> + <td> +MENU:SEARCH_FORE + </td> + <td>C-s, / </td> <td> - Toggle wrapping mode in searches + Search forward </td> </tr> - </table> - <h3> - Mark management - </h3> - <table> - <tr> + <tr> + <td> +MENU:SEARCH_BACK + </td> + <td> + C-r, ?</td> + <td> + Search backward + </td> + </tr> + <tr> + <td> +MENU:SEARCH_NEXT + </td> + <td> + n</td> + <td> + Search for the next match</td> + </tr> + <tr> + <td> +MENU:SEARCH_PREV + </td> + <td> + N</td> + <td> + Search for the previous match</td> + </tr> +<!--mh 2016-06-12 Pressing C-z in menu mode (with menu active) has the same effect as in normal operation of w3m: Browser gets in the background + <tr> + <td> +MENU:SUSPEND + </td> + <td> + C-z</td> + <td> + Suspend</td> + </tr> +--> +<!-- </table>--> + <tr> + <td colspan="3"> + <h3>Line-editing Mode</h3> + </td> + </tr> +<!-- <table>--> + <tr> + <td> + LINEEDIT:FORWARD + </td> <td width="100"> - C-SPC + C-f, RIGHT </td> <td> - Set/unset mark + Move cursor forward </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:BACK + </td> <td> - P + C-b, LEFT </td> <td> - Go to the previous mark + Move cursor backward </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:BS + </td> <td> - N + C-h, BKSPC </td> <td> - Go to the next mark + Delete previous character </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:DEL + </td> <td> - " + C-d </td> <td> - Mark all occurrences of a regular expression + Delete current character </td> </tr> - </table> - <h3> - Miscellany - </h3> - <table> - <tr> - <td width="100"> - ! + <tr> + <td> +LINEEDIT:KILL_AFTER + </td> + <td> + C-k </td> <td> - Execute shell command + Delete everything after cursor </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:KILL_BEFORE + </td> <td> - M-c + C-u </td> <td> - Invoke w3m function + Delete everything before cursor </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:TOP + </td> <td> - H, ? + C-a </td> <td> - Show help panel + Move to the beginning of the line </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:BOTTOM + </td> <td> - o + C-e </td> <td> - Show options panel + Move to the end of the line </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:PREV + </td> <td> - C-k + C-p, UP </td> <td> - Show cookie jar + Fetch the previous string from the history list </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:NEXT + </td> <td> - C-c + C-n, DOWN </td> <td> - Interrupt + Fetch the next string from the history list </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:COMPLETE + </td> <td> - C-z + TAB, SPC </td> <td> - Suspend w3m + Try to complete filename </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:EDITOR + </td> <td> - q + C-o </td> <td> - Quit (with confirmation dialog) + Edit with external editor </td> </tr> - <tr> + <tr> + <td> +LINEEDIT:ACCEPT + </td> <td> - Q + RET </td> <td> - Quit without confirmation + Accept input line </td> </tr> </table> - <p> +<!-- mh 2016-06-12 As it suffices to use the provided keymap file for Lynx-like keybindings and this file is listed in section FILES of man w3m (1), the following hint for getting w3m with Lynx-like key bindings has been deleted. + <p> + If w3m was compiled with <q>Lynx-like key bindings</q>, you can use + the following key bindings. + </p> +--> +<!-- mh 2016-06-12 Remark is obsolete as the two sets key binding are presented along within tables + <hr> + <h2 id="Key:lynx"> + <p> The Lynx-like configuration leaves keymappings unchanged in the menu-selection and line-editing modes. </p> + </h2> +--> <hr> <h2 id="Mouse"> - Mouse operation + Mouse Operation </h2> <p> If w3m is compiled with mouse support and you are invoking w3m @@ -2092,15 +2287,29 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p can use the mouse for navigation (in the case of rxvt, you need to set the TERM environment variable to <q>xterm</q> or <q>kterm</q>). </p> - <table border="0"> - <tr> + <p>An introduction to configure mouse actions is provided + with <a href="README.mouse">README.mouse</a>. + </p> + <table border="1"> + <colgroup> + <col width="20%"> + <col width="80%"> + </colgroup> + <tr> + <th>Operation + </th> + <th>Description + </th> + </tr> + <tr> <td> left click </td> <td> - 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. +<b>First:</b><br> +Moves the cursor to the place indicated by the mouse pointer.<br> +<b>Then:</b><br> +Follows a hyperlink the cursor is currently located and the mouse points to. </td> </tr> <tr> @@ -2126,33 +2335,13 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p <td> 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. + drag it) with the options setting panel. </td> </tr> </table> <hr> - <h2 id="Key:custom"> - Key customization - </h2> - <p> - You can customize the key bindings (except the line-editing keymap) - in a ~/.w3m/keymap file. For example, - </p> -<pre> - - keymap C-o NEXT_PAGE - -</pre> - <p> - binds the <q>NEXT_PAGE</q> function (normally bound to SPC and C-v) - to control-o. See <a href="README.func">README.func</a> for a - list of available functions. Original and Lynx-like keymap - definitions are provided (<a href="keymap.default">keymap.default</a> - and <a href="keymap.lynx">keymap.lynx</a>) as examples. - </p> - <hr> <h2 id="LocalCGI"> - Local CGI + Local CGI scripts </h2> <p> You can run CGI scripts using w3m, without any HTTP server. @@ -2174,28 +2363,27 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p </li> <li> The /cgi-bin/ directory. You can map /cgi-bin/ to any directory you - like in the option setting panel (the <q>Directory corresponds to + like in the options setting panel (the <q>Directory corresponds to /cgi-bin</q> field). You can specify multiple paths separated by - <q>:</q>, 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: + <q>:</q>, like /usr/local/cgi-bin:/home/aito/cgi-bin. It is not + recommended to include the current directory to this path. To use + a /cgi-bin/ directory, you must use a file:/cgi-bin URL as follows: + </li> <pre> w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi </pre> - It is not recommended to include the current directory to this path. - </li> </ul> <p> - The CGI script can use the special header <q>w3m-control:</q> to + The CGI script can use the special header + <span class="mono">w3m-control:</span> to control w3m. This field can take any function (see <a href="README.func">README.func</a>), and the specified function is invoked after the document is displayed. For example, the CGI output </p> <pre> - Content-Type: text/plain W3m-control: BACK - </pre> <p> will display a blank page and delete that buffer immediately. @@ -2203,34 +2391,30 @@ W3m-control: BACK the script is invoked. The next example </p> <pre> - Content-Type: text/plain W3m-control: DELETE_PREVBUF - contents..... </pre> <p> will override the current buffer. </p> <p> - Each w3m-control: header can contain only one function, but you can - include more than one w3m-control: line in the HTTP header. + Each header <span class="mono">w3m-control:</span> can + contain only one function, but you can + include more than one <span class="mono">w3m-control:</span> + line in the HTTP header. In addition, you can specify an argument to the GOTO function: </p> <pre> - Content-Type: text/plain W3m-control: GOTO http://www.example.org/ - </pre> <p> This example works exactly the same way as the Location header: </p> <pre> - Content-Type: text/plain Location: http://www.example.org/ - </pre> <p> Note that this header has no effect when the CGI script is invoked |