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 @@ + + + + w3m Handbuch + + + + + + +

w3m HANDBUCH

+
+ Akinori Ito
aito@fw.ipsj.or.jp +
+

Übersicht

+ +
+

+ Einführung +

+

+ 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. +

+
+

+ Einstellungen +

+

+ Der Aufruf per Befehlszeile lautet +

+ +
+  w3m [Option]… [Datei|Adresse]…
+
+

+ 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. +

+

+ Optionen sind unter anderem: +

+
+

Allgemeine Optionen

+
+ -B +
+
+

+ + starte mit einer Ansicht aller Lesezeichen (wenn kein anderes Zielobjekt angegeben ist) +

+
+
+ -M +
+
+

+ + monochrome Anzeige +

+
+
+ -no-mouse +
+
+

+ Mausfunktion aus +

+
+
+ -num +
+
+

+ + zeige Zeilennummern an + +

+
+ +
+ -v +
+
+

+ + begrüße den Benutzer mit einer eingebauten Seite (wenn kein anderes Zielobjekt angegeben ist) +

+
+
+ -W +
+
+

+ + wechsle zwischen umlaufendem und nicht umlaufendem Suchen +

+
+
+ -X +
+
+

+ nach Beenden des Programms das Terminal nicht neu initialisieren. +

+
+
+ +Zahl +
+
+

+ gehe zu Zeile Zahl. Wirkt nur, wenn Zahl größer ist als die im Terminal verfügbare Zeilenzahl +

+
+

Browser-Optionen

+
+ -cols Zahl +
+
+

+ + bei für die Standardausgabe bestimmten Inhalten, nimm bei zur Umsetzung von HTML eine Länge von num Zeichen pro Zeile +

+
+
+ -cookie +
+
+

+ + verwende gespeicherte Cookies und akzeptiere neue +

+
+
+ -no-cookie +
+
+

+ + verwende weder gespeicherte Cookies noch akzeptiere neue + +

+
+
+ -F +
+
+

+ + verarbeite Frames +

+
+
+ -no-graph +
+
+

+ + verwende bei der Umsetzung von Tabellen und Frames keine grafischen Zeichen +

+
+
+ -header Zeichenkette +
+
+

+ + füge der HTTP(S)-Anfrage Zeichenkette an. Diese muss der Kopfdaten-Syntax "Variable: Wert" entsprechen +

+
+
+ -m +
+
+

+ arbeite im Internetnachrichten-Modus. Mit dieser Option entnimmt w3m den Typ eines Dokumentes dessen Kopfdaten. Dies ist nützlich beim Lesen von Mails und Usenet-Nachrichten. + +

+
+
+ -no-proxy +
+
+

+ + verwende keinen Proxy +

+
+
+ -post Datei +
+
+

+ verwende die Methode POST, um in Datei hinterlegte Daten hochzuladen. Hierbei wird die Syntax "var1=wert1[&var2=wert2]…" erwartet +

+
+

Textbetrachter-Optionen

+
+ -l Zahl +
+
+

+ + Anzahl der Zeilen, die zwischengespeichert werden, wenn Text per Standardeingabe übergeben wurde. (Voreinstellung ist 10000) +

+
+
+ -r +
+
+

+ + 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. +

+
+
+ -s +
+
+

+ + mehrere leere Zeilen werden bis auf eine gelöscht +

+
+ +
+ -t Zahl +
+
+

+ Tab-Zeichen so verwerten, dass Spalten mit einer Weite von Zahl Zeichen entstehen. Wirkt nicht auf Standardausgabe +

+
+

Datenart- und Datenkodierungs-Optionen

+
+ -I Zeichenkodierung +
+
+

+ + zu benutzende Zeichenkodierung für erhaltene Daten +

+
+
+ -O Zeichenkodierung +
+
+

+ + zu benutzende Zeichenkodierung für auszugebende Daten +

+
+
+ -T Typ +
+
+

+ + 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: +

+

+ Übernimm HTML-Dokument von der Standardeingabe und zeige es an +

+
+   cat beispiel.html | w3m -T text/html
+
+

+ Zeige HTML-Quelltext an +

+
+   w3m -T text/plain beispiel.html
+
+
+

Optionen zur Datenausgabe, mit sofortigem Verlassen des Programms

+
+ -dump +
+
+

+ 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 +

+
+
+ -dump_source +
+
+

+ + leite den Seitenquelltext der Standardausgabe zu +

+
+
+ -dump_head +
+
+

+ + leite die Antwort einer HEAD-Anfrage für eine URL der Standardausgabe zu +

+
+
+ -dump_both +
+
+

+ + leite Antwort auf HEAD-Anfrage und Seitenquelltext der Standardausgabe zu + +

+
+
+ -dump_extra +
+
+

+ + leite Antwort auf HEAD-Anfrage, Seitenquelltext und Extrainformation der Standardausgabe zu +

+
+ +

Optionen, die Standards für Einstellungen und Datenquellen außer Kraft setzen

+ +
+ -bookmark Datei +
+
+

+ + benutze anstelle der Standarddatei bookmark.html für Lesezeichen die Datei Datei +

+
+
+ -config Datei +
+
+

+ + benutze Datei anstelle der Standard-Konfigurationsdatei +

+
+
+ -o Option=Wert +
+
+

+ + arbeite mit einer Konfiguration, bei der die Einstellung Option mit Wert belegt ist. Ohne Option=Wert gleichwertig mit -show-option +

+
+
+
+

+ Farbzuordnung im Dokument +

+

+ Links und Bildelemente werden wie folgt angezeigt: +

+
+ + + + + + + + + + + + + + + + + + + +
+ + Farbmodus + + Monochrom-Modus +
+ Hyperlinks + + blau + + unterstrichen +
+ Bilder + + grün + + invertiert +
+ Formular-Eingabefelder + + rot + + invertiert +
+
+

+ Diese Farben können nach Eingabe von o im Einstellungs-Dialog anders zugeordnet werden. +

+
+

+ Funktionen und Tastaturbelegung +

+ +

+ Wenn w3m läuft, bedienen Sie das Programm, indem Sie Funktionen anhand ihres Namens oder der ihr zugeordneten Tastenkombination aufrufen. Es gibt voreingestellte Tastaturbelegungen. + +

+ +

+ Sie können die Tastaturbelegungen (abgesehen von jenen des Menü- und des Texteingabe-Modus) in einer Datei ~/.w3m/keymap anpassen. Beispielsweise bindet +

+ +
+   keymap C-o NEXT_PAGE
+
+ +

+ die Funktion NEXT_PAGE (die normalerweise mit SPC und C-v verknüpft ist) mit C-o. Siehe die Liste verfügbarer Funktionen in README.func. Original- und Lynx-artige Tastaturbelegungen enthalten die Beispieldateien keymap.default und keymap.lynx. +

+ +

+ Im Folgenden stehen C- und M- für die Eingabe-Modifikationen mit der Steuerungs- und der Meta-Taste. Die letztere ersetzt die ALT-Taste, wohingegen Drücken der ESC-Taste zwischen Meta-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 2 M ist also gemeint, die 2 und dann M zu drücken. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Funktion + Tastenkombination + + Beschreibung +
+ Standard + + Lynx-ähnlich +
+

Navigation innerhalb von Seiten

+
+ NEXT_PAGE + + SPC, C-v, +, PGDN + + SPC, C-v, + + + Scrolle eine Seite abwärts +
+ PREVIOUS_PAGE + + b, M-v, -, PGUP + + b, M-v, - + + Scrolle eine Seite aufwärts +
+ MOVE_RIGHT + + l, C-f, RIGHT + + l + + Bewege Cursor nach rechts (mit Verschiebung um halbe Bildschirmbreite an dessen Rand) +
+ C-b, LEFT + + h, C-b, LEFT + + h + + Bewege Cursor nach links (mit Verschiebung um halbe Bildschirmbreite an dessen Rand) +
+ MOVE_DOWN + + j, C-n, DOWN + + j + + Bewege Cursor abwärts (scrolle eine Zeile am Bildschirmrand) +
+ MOVE_UP + + k, C-p, UP + + k + + Bewege Cursor aufwärts (scrolle eine Zeile am Bildschirmrand) +
+ UP + + J + + J + + Scrolle den Anzeigebereich eine Zeile aufwärts +
+ DOWN + + K + + K + + Scrolle den Anzeigebereich eine Zeile abwärts +
+ LINE_BEGIN + + ^, C-a + + ^ + + Gehe zum Zeilenanfang +
+ LINE_END + + $, C-e + + $ + + Gehe zum Zeilenende +
+ NEXT_WORD + + w + + w + + Gehe zum nächsten Wort +
+ PREVIOUS_WORD + + W + + W + + Gehe zum vorherigen Wort +
+ SHIFT_RIGHT + + > + + > + + Anzeigebereich nach rechts versetzen +
+ SHIFT_LEFT + + < + + < + + Anzeigebereich nach links versetzen +
+ RIGHT + + . + + . + + Anzeigebereich um eine Spalte nach rechts verschieben +
+ LEFT + + , + + , + + Anzeigebereich um eine Spalte nach links verschieben +
+ BEGIN + + g, M-<, HOME + + C-a, M-< + + Gehe zur ersten Zeile +
+ END + + G, M->, END + + C-e, M-> + + Gehe zur letzten Zeile +
+ GOTO_LINE + + M-g + + G + + Gehe zur angegebenen Zeile +
+ LINE_INFO + + C-g + + C-g + + Zeige aktuelle Position im Dokument an +
+ CENTER_H + + Z + + Z + + Bildschirm rechts und links des Cursors zentrieren +
+ CENTER_V + + z + + z + + Bildschirm ober- und unterhalb des Cursors zentrieren +
+ NEXT_LINK + + TAB + + TAB, C-n, DOWN + + Gehe zum nächsten Hyperlink +
+ PREVIOUS_LINK + + M-TAB, C-u + + M-TAB, C-u, C-p, UP + + Gehe zum vorangegangen Hyperlink +
+ LINK_BEGIN + + [ + + [ + + Gehe zum ersten Hyperlink +
+ LINK_END + + ] + + ] + + Gehe zum letzten Hyperlink +
MOVE_LIST_MENUM-mM-mÖffne Menü mit vorhandenen Hyperlinks
+

Umgang mit Hyperlinks

+
+ GOTO_LINK + + C-j, C-m, RET + + C-f, C-j, C-m, RET, RIGHT + + Folge dem aktuellen Hyperlink in neuem Puffer +
LIST_MENUM-lM-lÖffne Menü mit Hyperlinks und folge dem ausgewählten
+ SAVE_LINK + + a, M-RET + + d, M-RET + + Speichere Ziel des Hyperlinks +
+ PEEK_LINK + + u + + u + + Zeige Zieladresse +
+ PEEK_IMG + + i + + i + + Zeige Adresse des Bildes +
+ VIEW_IMAGE + + I + + I + + Zeige Bild in Betrachter +
+ SAVE_IMAGE + + M-I + + M-I + + Speichere Bild +
MARK_WORD;;Wandle aktuelles Wort in Hyperlink um
+ MARK_URL + + : + + : + + Wandle URL-artige Zeichenketten um in Hyperlinks +
+ MARK_MID + + M-: + + M-: + + + Wandle Nachrichten-ID-artige Zeichenketten um in Hyperlinks +
+ PEEK + + c + + c + + Zeige aktuelle Adresse an +
+ INFO + + = + + = + + Zeige Informationen über dieses Dokument +
+ HISTORY + + C-h + + C-h + + Chronik aufgesuchter Dokumente +
+ EXTERN + + M + + M + + 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) +
+ EXTERN_LINK + + M-M + + M-M + + Bringe das Linkziel mit einem externen Browser zur Anzeige (vorangestellte Zahlen wirken sich wie oben beschrieben aus) +
+

Verwalten von Lesezeichen

+
+ BOOKMARK + + M-b + + v, M-b + + Lesezeichen ansehen +
+ ADD_BOOKMARK + + M-a + + a, M-a + + Lege für aktuelle Seite Lesezeichen an +
+

Umgang mit Dateien und Datenströmen

+
+ GOTO + + U + + g, U + + Öffne angegebenes Dokument in neuem Puffer +
GOTO_RELATIVEM-uM-uÖffne relative Adresse in neuem Puffer
+ LOAD + + V + + V + + Öffne lokale Datei in einem neuen Puffer +
+ READ_SHELL + + @ + + @ + + + + Führe einen Shell-Befehl aus und zeige Ausgabe in einem neuen Puffer +
+ PIPE_SHELL + + # + + # + + + + Führe einen Shell-Befehl aus und zeige Ausgabe in einem neuen Puffer +
+

Arbeit an Seiteninhalten

+
+ VIEW + + v + + \ + + Wechsle zwischen HTML-Quellcode und verarbeitetem Dokument +
LISTLLListe Link-Elemente, Hyperlinks und Bilder auf
+ FRAME + + F + + F + + Wechsle zwischen Kennung und Umsetzung von HTML-Frames +
+ REDRAW + + C-l + + C-l, C-w + + Bildschirmanzeige neu aufbauen +
+ RELOAD + + R + + R, C-r + + Aktuelles Dokument erneut laden +
+ EDIT + + E + + E + + Bearbeite lokales Quelldokument +
+ EDIT_SCREEN + + M-e + + M-e + + Bearbeite eine Kopie des verarbeiteten Dokuments +
PIPE_BUF||Leite aktuellen Pufferinhalt einem Shell-Befehl zu und zeige Ausgabe an
+ DOWNLOAD + + M-s + + M-s + + Dokument-Quellcode speichern +
+ SAVE_SCREEN + + S + + S, p + + Speichere verarbeitetes Dokument +
+

Navigation zwischen Puffern und Reitern

+
+ BACK + + B + + B, C-b, LEFT + + Schließe aktuellen Puffer und kehre zu dem im Stapel darunterliegenden zurück +
+ SELECT_MENU + + s + + s, C-h + + Öffne Pufferstapel-Menü +
+ TAB_MENU + + M-t + + M-t + + Öffne das Reiter-Auswahl-Menü +
+ NEW_TAB + + T + + T + + Öffne neuen Reiter (mit aktuellem Dokument) +
+ TAB_LINK + + C-t + + C-t + + Folge dem aktuellen Hyperlink in einem neuen Reiter +
+ NEXT_TAB + + } + + } + + Schalte zum nächsten Reiter +
+ PREV_TAB + + { + + { + + Schalte zum vorherigen Reiter +
+ CLOSE_TAB + + C-q + + C-q + + Schließe aktuellen Reiter +
+

Suchfunktionen

+
+ SEARCH + + / + + /, C-s + + Suche vorwärts +
+ SEARCH_BACK + + ? + + + Suche rückwärts +
+ ISEARCH + + C-s + + + Inkrementelle Suche vorwärts +
+ ISEARCH_BACK + + C-r + + + Inkrementelle Suche rückwärts +
+ SEARCH_NEXT + + n + + n + + Setze Suche vorwärts fort +
+ SEARCH_PREV + + N + + + Setze Suche rückwärts fort +
+ WRAP_TOGGLE + + C-w + + w + + Wechsle zwischen umlaufendem und nicht-umlaufendem Suchen +
+

Arbeit mit Textmarken

+
+ MARK + + C-SPC + + C-SPC + + Setze/Lösche Markierung +
+ PREV_MARK + + M-p + + P + + Gehe zur vorherigen Markierung +
+ NEXT_MARK + + M-n + + N + + Gehe zur nächsten Markierung +
+ REG_MARK + + " + + " + + Markiere alle Vorkommen eines Zeichenmusters +
+

Verschiedenes

+
+ COMMAND + + M-c + + M-c + + Rufe eine oder mehrere durch Strichpunkt getrennte w3m-Funktionen auf +
+ HELP + + H + + H, ? + + Zeige Hilfe-Übersicht +
+ OPTIONEN + + o + + o + + Einstellungs-Dialog öffnen +
SET_OPTIONM-oM-oSetze Option
DEFINE_KEYM-kM-kDefiniere eine Verbindung zwischen einer Tastenkombination und einem Kommando
MOUSE_TOGGLEmmSchalte Mausbedienung an oder ab
DOWNLOAD_LISTDDÜbersicht heruntergeladener Dateien anzeigen
+ COOKIE + + C-k + + C-k + + Zeige die gespeicherten Cookies +
UNDO((Nimm die letzte Cursorbewegung zurück
REDO))Den letzten Rücknahmebefehl zurücknehmen
+ EXEC_SHELL + + ! + + ! + + Shell-Befehl ausführen +
DICT_WORDM-wM-wFühre eine Wörterbuch-Funktion aus (siehe README.dict)
DICT_WORD_ATM-WM-WBenutze Wörterbuch für Wort unter Cursor
VERSIONrrZeige die Version von w3m an
+ SUSPEND + + C-z + + C-z + + w3m zum Hintergrundprozess machen. (Wird mit dem Shell-Befehl fg zurückgenommen.) +
+ QUIT + + q + + q + + Mit Bestätigungsfrage beenden +
+ EXIT + + Q + + Q + + Sofort beenden +
+ +

+ 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. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Funktion
(interner Name) + 		Tastenkombination + + Beschreibung +
+

Menü-Auswahl-Modus

+
+ BUF:NEXT + j, C-n, DOWN + + Nächster Eintrag +
BUF:PREV + + k, C-p, UP + + Vorheriger Eintrag +
+ BUF:DELETE + D + + Lösche Eintrag +
+ BUF:GO + + SPC, RET, RIGHT + + Wähle Eintrag aus +
+

Popup-Menü-Modus

+
+MENU:SELECT + + SPC, RET, RIGHT + Wähle Punkt aus +
+MENU:CLOSE + C-c + + Schließe Menü +
+MENU:CANCEL + + LEFT, BKSPC, C-h + Einen Auswahlschritt zurück +
+MENU:DOWN + j, C-n, DOWN + + Gehe zum nächsten Punkt +
+MENU:UP + + k, C-p, UP + Gehe zum vorherigen Punkt +
+MENU:LINE_UP + K + + Scrolle einen Punkt aufwärts +
+MENU:LINE_DOWN + J + + Scrolle einen Punkt abwärts +
+MENU:TOP + C-a + + Gehe zum ersten Punkt +
+MENU:LAST + C-e + + Gehe zum letzten Punkt +
+MENU:NEXT + C-v, C-f + Gehe zur nächsten Seite +
+MENU:PREV + ESC v, C-b + + Gehe zur vorherigen Seite +
+MENU:SEARCH_FORE + C-s, / + + Suche vorwärts +
+MENU:SEARCH_BACK + + C-r, ? + Suche rückwärts +
+MENU:SEARCH_NEXT + + n + Suche weitere Übereinstimmung
+MENU:SEARCH_PREV + + N + Suche frühere Übereinstimmung
+

Eingabezeile-Bearbeitungs-Modus

+
+ LINEEDIT:FORWARD + + C-f, RIGHT + + Bewege Cursor vorwärts +
+LINEEDIT:BACK + + C-b, LEFT + + Bewege Cursor rückwärts +
+LINEEDIT:BS + + C-h, BKSPC + + Vorheriges Zeichen löschen +
+LINEEDIT:DEL + + C-d + + Aktuelles Zeichen löschen +
+LINEEDIT:KILL_AFTER + + C-k + + Lösche alles nach dem Cursor +
+LINEEDIT:KILL_BEFORE + + C-u + + Lösche alles vor dem Cursor +
+LINEEDIT:TOP + + C-a + + Gehe zum Zeilenanfang +
+LINEEDIT:BOTTOM + + C-e + + Gehe zum Zeilenende +
+LINEEDIT:PREV + + C-p, UP + + Hole den vorherigen Chronik-Eintrag +
+LINEEDIT:NEXT + + C-n, DOWN + + Hole den nächsten Chronik-Eintrag +
+LINEEDIT:COMPLETE + + TAB, SPC + + Versuche, den Dateinamen zu komplettieren +
+LINEEDIT:EDITOR + + C-o + + Bearbeite mit externem Editor +
+LINEEDIT:ACCEPT + + RET + + Eingabezeile übernehmen +
+ + +
+

+ Bedienung per Maus +

+

+ 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 xterm oder kxterm belegen.) +

+

Die Datei README.mouse erklärt, wie die Bedienung per Maus an eigene Vorlieben angepasst werden kann. +

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Handlung + Beschreibung +
+ Linksklick + +Zuerst:
Der Cursor wird an die Mauszeigerposition versetzt.
Dann:
Dem Hyperlink, auf dem der Cursor momentan steht und auf den sich der Mauszeiger richtet, wird gefolgt. +
+ Mittelklick + + Zurück zum vorherigen Puffer. +
+ Rechtsklick + + Öffne Menü. Sie können Menüpunkte durch Anklicken auswählen. +
+ Linksziehen + + Dokument scrollen. Standardmäßig wird das Dokument im Fenster verschoben. Ein Verschieben des Fensters über dem stehenden Dokument erreichen Sie über den Einstellungs-Dialog. +
+
+

+ Lokale CGI-Skripte +

+

+ 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. +

+

+ Aus Sicherheitsgründen kommen für von w3m benutzte CGI-Skripte nur folgende Verzeichnisse in Frage: +

+ +

+ Das CGI-Skript kann zur Steuerung von w3m die spezielle Kopfzeile w3m-control: enthalten. Darin können alle Funkionen (siehe README.func) eingetragen sein. Die angegebene Funktion wird aufgerufen, nachdem das Dokument angezeigt wird. Beispielsweise, wird eine Skriptausgabe +

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

+ 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 +

+
+Content-Type: text/plain
W3m-control: DELETE_PREVBUF contents.....
+
+

+ führt zum Übergehen des aktuellen Puffers. +

+

+ Jede w3m-control-Kopfzeile kann nur eine Funktion aufrufen. Jedoch können Sie im Kopfteil einer HTTP-Kommunikation mehr als eine w3m-control-Anweisung hinterlegen. Überdies ist es möglich, die GOTO-Funktion mit einem Argument aufzurufen: +

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

+ Sie bewirken damit das gleiche wie mit der Anweisung Location: im Kopfteil: +

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

+ Beachten Sie, dass diese Anweisung wirkungslos ist, wenn das CGI-Skript durch einen HTTP-Server angesprochen wird. +

+ + 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 @@ - - - - w3m manual - - - + + w3m manual + + + + - - +insertions tagged with "mh 2016-03-29" and "mh 2016-06-11" come from the latest version of manual page w3m (1) + --> +

w3m MANUAL

Akinori Ito
@@ -37,32 +33,36 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa
  • - Document colors + Document Colors
  • - - Key bindings + + Functions and Key bindings
    • +
  • - Mouse operation + Mouse Operation
    • +
  • - Local CGI + Local CGI scripts
    • @@ -81,8 +81,9 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa

    Command line usage is

    + 
    -    w3m [options] [file|URL]
+  w3m [option]... [file|URL]...

    If you specify filenames/URLs on the command line, these documents @@ -94,22 +95,189 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa Options include:

    -
    - +number +

    General options

    +
    + -B

    - Move to the specified line-number. + + with no other target defined, use the bookmark page for startup

    -
    - -t width - +
    + -M

    - Specify tab width. Default is 8. - + + monochrome display +

    +
    +
    + -no-mouse +
    +
    +

    + deactivate mouse support. +

    +
    +
    + -num +
    +
    +

    + + display each line's number + +

    +
    + +
    + -v +
    +
    +

    + + with no other target defined, welcome users with a built-in page +

    +
    +
    + -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 +
    +
    +

    + + with stdout as destination; HTML is rendered 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. With this + option, w3m determines document type from header information. + This is useful when 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 to be used is "var1=value1[&var2=value2]…" +

    +
    +

    Text pager options

    +
    + -l num +
    +
    +

    + + number of lines preserved internally when receiving plain text + from stdin (default 10,000)

    @@ -117,22 +285,38 @@ insertions tagged with "mh 2016-03-29" come from the latest version of manual pa

    - When displaying text/plain documents, prohibit emphasis using - backspace. If you don't specify this option, A^H_ is - interpreted as an underlined A and A^HA as a bold - A. - + + 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

    - -l number + -s

    - Specify the number of lines that should be cached while reading a - text/plain document from standard input. Default is 10,000. + + squeeze multiple blank lines into one +

    +
    + +
    + -t num +
    +
    +

    + set tab width to num columns. No effect on stdout +

    +
    +

    Data type/encoding options

    +
    + -I charset +
    +
    +

    + + user defined character encoding of input data

    @@ -140,32 +324,21 @@ use caret notation to display special escape characters (such as ANSI escapes or

    - Specify display/output charset. - -

    -
    -
    - -I charset -
    -
    -

    - Specify document charset. - + + user defined character encoding of output data

    -T type
    -

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

    +

    + + 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: +

    Read HTML document from standard input and display it

    @@ -179,194 +352,27 @@ user defined character encoding of input data w3m -T text/plain example.html
    -
    - -m -
    -
    -

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

    -
    -
    - -v -
    -
    -

    - Show w3m's startup page. - -

    -
    -
    - -B -
    -
    -

    - Show w3m's bookmarks page. - -

    -
    -
    - -bookmark file -
    -
    -

    - Specify a custom bookmarks file. -

    -
    -
    - -M -
    -
    -

    - Monochrome display mode. - -

    -
    -
    - -F -
    -
    -

    - Automatically render HTML frames. - -

    -
    -
    - -s -
    -
    -

    - Squeeze blank lines. - -

    -
    -
    - -X -
    -
    -

    - Upon exit, do not reinitialize the terminal. -

    -
    -
    - -W -
    -
    -

    - Toggle wrapping mode in searches. - - -

    -
    -
    - -o option=value -
    -
    -

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

    -
    -
    - -cookie -
    -
    -

    - Process cookies. - - -

    -
    -
    - -no-cookie -
    -
    -

    - Don't process cookies. - - -

    -
    -
    - -num -
    -
    -

    - Show line-numbers. - -

    -
    +

    Options for data output, followed by immediate exit

    -dump
    -

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

    + read document specified by URL and dump page rendered as text + into standard output. + + 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. - - - -

    -
    -
    - -cols width -
    -
    -

    - Specify document width. Used with -dump option. -

    -
    -
    - -ppc count -
    -
    -

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

    +

    -dump_source

    - Read document specified by URL and dump the source. - + + dump the page's source code into stdout

    @@ -374,10 +380,8 @@ dump the page's source code into stdout

    - Read document specified by URL and dump headers. - + + dump response of a HEAD request for a URL into stdout

    @@ -385,10 +389,8 @@ dump response of a HEAD request for a URL into stdout

    - Read document specified by URL and dump headers and the source. - + + dump HEAD, and source code for a URL into stdout

    @@ -397,68 +399,21 @@ dump HEAD, and source code for a URL into stdout

    - Read document specified by URL and dump extra informations, - headers, and the source. - + + dump HEAD, source code, and extra information for a URL into + stdout +

    +
    -

    - +

    Options for overriding default settings and resources

    +
    - -post file + -bookmark file

    - Use POST method with file content. - - -

    -
    -
    - -header string -
    -
    -

    - Insert string as a header. - - -

    -
    -
    - -no-proxy -
    -
    -

    - Don't use proxy server. -

    -
    -
    - -no-graph -
    -
    -

    - Use ASCII characters to draw frames rather than graphical ones. - - -

    -
    -
    - -no-mouse -
    -
    -

    - Deactivate mouse support. + + use file instead of the default bookmark.html file

    @@ -466,22 +421,31 @@ frame borders

    - Specify 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

    - Document colors + Document Colors

    - Links and images are displayed as follows. + Hyperlinks and images are displayed as follows.

    -   Color mode @@ -492,7 +456,7 @@ frame borders
    - links + Hyperlinks blue @@ -503,7 +467,7 @@ frame borders
    - inline images + Inline images green @@ -514,7 +478,7 @@ frame borders
    - form input + Form input red @@ -526,996 +490,288 @@ frame borders

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

    -

    - Key bindings +

    + Functions and Key bindings

    - +

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

    -

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

    -

    - In-page navigation -

    - - -
    +

    + Key customization +

    +--> +

    + You can customize the key bindings (except those for menu + operations and line-editing) in a ~/.w3m/keymap file. For example, +

    + +
    +   keymap C-o NEXT_PAGE
+
    + +

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

    + +

    + Throughout, the C- and M- notations indicate the + modifiers control and meta. The ALT-key + replaces the latter whereas pressing the ESC-key toggles + between meta-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. 2 M + simply means 2 followed by M. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    + Function + Key binding + + Description +
    + Default + + Lynx-like +
    +

    In-page navigation

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

    Hyperlink operation

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

    - Bookmark management -

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

    - File/stream operation -

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

    - Content operations -

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

    - Buffer/tab navigation -

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

    - Search -

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

    - Mark management -

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

    - Miscellany -

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

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

    -

    - Menu selection mode -

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

    - Line-editing mode -

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

    - Lynx-like key bindings -

    -

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

    -

    - In-page navigation -

    - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1524,6 +780,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -1532,22 +794,40 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + + + + + @@ -1556,38 +836,57 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + + - - - + + Center screen right and left of the cursor column + + + + + @@ -1596,22 +895,29 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + + + - - - @@ -1620,6 +926,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -1627,92 +939,180 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Move to the last hyperlink -
    - SPC, C-v, + - - Forward page -
    - b, M-v, - - - Backward page -
    - l - - Cursor right -
    h - Cursor left + Move cursor left (with a half-screen shift at the screen edge)
    + MOVE_DOWN + + j, C-n, DOWN + j - Cursor down + Move cursor down (with a one-line scroll at the screen edge)
    + MOVE_UP + + k, C-p, UP + k - Cursor up + Move cursor up (with a one-line scroll at the screen edge)
    + UP + J - Scroll screen up one line + J + + Scroll the screen up one line
    + DOWN + K - Scroll screen down one line + K + + Scroll the screen down one line
    + LINE_BEGIN + + ^, C-a + ^ - Go to the beginning of line + Go to the beginning of the line
    + LINE_END + + $, C-e + $ - Go to the end of line + Go to the end of the line
    + NEXT_WORD + - > + w + + w + + Move to the next word +
    + PREVIOUS_WORD + + W + + W + + Move to the previous word +
    + SHIFT_RIGHT + + > + + > Shift screen right
    + SHIFT_LEFT + - < + < + + < Shift screen left
    + RIGHT + + . + .
    + LEFT + + , + ,
    + BEGIN + - C-a, M-< + g, M-<, HOME + + C-a, M-< Go to the first line
    + END + - C-e, M-> + G, M->, END + + C-e, M-> Go to the last line
    + GOTO_LINE + + M-g + G
    + LINE_INFO + - w + C-g - Go to the next word + C-g + + Display current position in document
    + CENTER_H + - W + Z - Go to the previous word -
    Z - Center on cursor line -
    + CENTER_V + z - Center on cursor column + z + + Center screen above and below the cursor line
    + NEXT_LINK + + TAB + TAB, C-n, DOWN
    + PREVIOUS_LINK + - M-TAB, C-p, C-u, UP + M-TAB, C-u - Move to the previous link + M-TAB, C-u, C-p, UP + Move to the previous hyperlink +
    + LINK_BEGIN + - C-g + [ - Show current position in page -
    [
    + LINK_END + + ] + ]
    -

    - Hyperlink operation -

    - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1721,6 +1121,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -1730,6 +1136,12 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p + + @@ -1738,78 +1150,148 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p 3 M-M) -
    MOVE_LIST_MENUM-mM-mPop up menu to navigate between hyperlinks
    +

    Hyperlink Operations

    +
    + GOTO_LINK + + C-j, C-m, RET + C-f, C-j, C-m, RET, RIGHT - Follow hyperlink + Follow current hyperlink in a new buffer
    LIST_MENUM-lM-lPop up hyperlink menu and select one to be followed
    + SAVE_LINK + + a, M-RET + d, M-RET - Save link to file + Save the hyperlink target
    + PEEK_LINK + u - Show link URL + u + + Show target address
    + PEEK_IMG + i - Show image URL + i + + Show image address
    + VIEW_IMAGE + I - View inline image + I + + Display image in viewer
    + SAVE_IMAGE + M-I - Save inline image to file + M-I + + Save inline image
    MARK_WORD;;Turn current word into hyperlink
    + MARK_URL + : - Mark URL-like strings as hyperlinks + : + + Turn URL-like strings into hyperlinks
    + MARK_MID + M-: - Mark Message-ID-like strings as news anchors + M-: + + + Turn Message-ID-like strings into hyperlinks
    + PEEK + c - Show current URL + c + + Show current address
    + INFO + = - Show information about current document + = + + Display information about the current document
    + HISTORY + + C-h + C-h
    + EXTERN + + M + M
    + EXTERN_LINK + + M-M + M-M
    -

    - Bookmark management -

    - - - + + + + + + + + + -
    + +
    +

    Bookmark management

    +
    + BOOKMARK + + M-b + v, M-b - Go to the bookmarks page + View bookmarks
    + ADD_BOOKMARK + + M-a + a, M-a - Bookmark current page + Add current page to bookmarks
    -

    - File/stream operation -

    - - - + + + + + + + - + + + + + + + + + - + + + - + + + -
    + +
    +

    File/Stream Operations

    +
    + GOTO + + U + g, U - Open new URL + Open specified document in a new buffer
    GOTO_RELATIVEM-uM-uOpen relative address in a new buffer
    + LOAD + V - Open new file + V + + Open local file in a new buffer
    + READ_SHELL + @ - Execute shell command and view output + @ + + + + Execute shell command and display output in a new buffer
    + PIPE_SHELL + # - Execute shell command and browse output + # + + + + Execute shell command and display output in a new buffer
    -

    - Content operations -

    - - - + + + + + + + - + + + + + + + + + @@ -1817,23 +1299,41 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Toggle rendering HTML frames - + + + - + + + - + + + @@ -1841,121 +1341,267 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Edit local source - + + + - + + + + + + + + + - + + + -
    + +
    +

    Content Operations

    +
    + VIEW + + v + \ - Toggle viewing as text or rendered HTML + Toggle between source code and rendered view of the document
    LISTLLList link elements, hyperlinks and images
    + FRAME + + F + F
    + REDRAW + + C-l + C-l, C-w - Redraw screen + Draw the screen anew
    + RELOAD + + R + R, C-r - Reload + Load current document anew
    + EDIT + + E + E
    + EDIT_SCREEN + M-e - Edit rendered copy of page + M-e + + Edit rendered copy of document
    PIPE_BUF||Pipe current buffer through a shell command and display output
    + DOWNLOAD + M-s - Save source + M-s + + Save document source
    + SAVE_SCREEN + + S + S, p - Save rendered copy of page + Save rendered document
    -

    - Buffer/tab navigation -

    - - - + + + + + + + - + + + - + + + - + + + - + + + - + + + - + + + - + + + -
    + +
    +

    Buffer/Tab Navigation

    +
    + BACK + + B + B, C-b, LEFT - Go back, popping the buffer stack + Close current buffer and return to the one below in stack
    + SELECT_MENU + + s + s, C-h - Show buffer-stack menu + Pop up buffer-stack menu
    + TAB_MENU + M-t - Show tab menu + M-t + + Pop up tab selection menu
    + NEW_TAB + T - Open current page as new tab + T + + Open a new tab (with current document)
    + TAB_LINK + C-t - Open link as new tab + C-t + + Follow current hyperlink in a new tab
    + NEXT_TAB + } - Switch to next tab + } + + Switch to the next tab
    + PREV_TAB + { - Switch to previous tab + { + + Switch to the previous tab
    + CLOSE_TAB + C-q - Close current tab + C-q + + Close the current tab
    -

    - Search -

    - - - + + + + + + + - + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + @@ -1963,20 +1609,34 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Toggle wrapping mode in searches -
    + +
    +

    Searches

    +
    + SEARCH + + / + /, C-s Search forward
    + SEARCH_BACK + + ? + + + Search backward +
    + ISEARCH + + C-s + + + Incremental search forward +
    + ISEARCH_BACK + + C-r + + + Incremental search backward +
    + SEARCH_NEXT + n - Next match + n + + Continue search forward
    + SEARCH_PREV + + N + + + Continue search backward +
    + WRAP_TOGGLE + + C-w + w
    -

    - Mark management -

    - - - + + + + + + + - + + + @@ -1984,7 +1644,13 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Go to the previous mark - + + + @@ -1992,36 +1658,61 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Go to the next mark - + + - -
    + +
    +

    Mark Management

    +
    + MARK + + C-SPC + C-SPC Set/unset mark
    + PREV_MARK + + M-p + P
    + NEXT_MARK + + M-n + N
    + REG_MARK + " - Mark all occurrences of a regular expression -
    -

    - Miscellany -

    - - - - + + + + + + + + - + + + + @@ -2029,15 +1720,51 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Show help panel - + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2045,7 +1772,15 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p Show cookie jar + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + - + + +
    - ! + " - Execute shell command + Mark all occurrences of a pattern
    +

    Miscellaneous

    +
    + COMMAND + M-c - Invoke w3m function + M-c + + Invoke one or more semicolon-separated w3m functions
    + HELP + + H + H, ?
    + OPTIONS + o - Show options panel + o + + Display options setting panel
    SET_OPTIONM-oM-oSet option
    DEFINE_KEYM-kM-kDefine a binding between a key stroke combination and a command
    MOUSE_TOGGLEmmToggle mouse support
    DOWNLOAD_LISTDDDisplay downloads panel
    + COOKIE + + C-k + C-k
    UNDO((Cancel the last cursor movement
    REDO))Cancel the last undo
    + EXEC_SHELL + + ! + + ! + + Execute shell command +
    DICT_WORDM-wM-wExecute dictionary command (see README.dict)
    DICT_WORD_ATM-WM-WExecute dictionary command for word at cursor
    VERSIONrrDisplay the version of w3m
    + SUSPEND + C-z - Suspend w3m + C-z + + Suspend w3m to background. (To be withdrawn with shell + command fg.)
    + QUIT + q - Quit (with confirmation dialog) + q + + Quit with confirmation request
    + EXIT + Q - Quit without confirmation + Q + + Quit at once
    -

    + +

    + 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. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Function
    (internal name) +     		Key binding + + Description +
    +

    Menu Selection Mode

    +
    + BUF:NEXT + j, C-n, DOWN + + Next item +
    BUF:PREV + + k, C-p, UP + + Previous item +
    + BUF:DELETE + D + + Delete item +
    + BUF:GO + + SPC, RET, RIGHT + + Select item +
    +

    Popup Menu Mode

    +
    +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
    +

    Line-editing Mode

    +
    + LINEEDIT:FORWARD + + C-f, RIGHT + + Move cursor forward +
    +LINEEDIT:BACK + + C-b, LEFT + + Move cursor backward +
    +LINEEDIT:BS + + C-h, BKSPC + + Delete previous character +
    +LINEEDIT:DEL + + C-d + + Delete current character +
    +LINEEDIT:KILL_AFTER + + C-k + + Delete everything after cursor +
    +LINEEDIT:KILL_BEFORE + + C-u + + Delete everything before cursor +
    +LINEEDIT:TOP + + C-a + + Move to the beginning of the line +
    +LINEEDIT:BOTTOM + + C-e + + Move to the end of the line +
    +LINEEDIT:PREV + + C-p, UP + + Fetch the previous string from the history list +
    +LINEEDIT:NEXT + + C-n, DOWN + + Fetch the next string from the history list +
    +LINEEDIT:COMPLETE + + TAB, SPC + + Try to complete filename +
    +LINEEDIT:EDITOR + + C-o + + Edit with external editor +
    +LINEEDIT:ACCEPT + + RET + + Accept input line +
    + +

    - Mouse operation + Mouse Operation

    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 xterm or kterm).

    - - +

    An introduction to configure mouse actions is provided + with README.mouse. +

    +
    + + + + + + + + + @@ -2126,33 +2335,13 @@ The two equivalents to the meta-key are pressing simultaneously the ALT-key or p
    Operation + Description +
    left click - Move the cursor to the place indicated by the mouse cursor. - If you click the cursor and it is on a hyperlink, follow the - link. +First:
    +Moves the cursor to the place indicated by the mouse pointer.
    +Then:
    +Follows a hyperlink the cursor is currently located and the mouse points to.
    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.
    -

    - Key customization -

    -

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

    -
    -
-   keymap C-o NEXT_PAGE
-
-
    -

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

    -

    - Local CGI + Local CGI scripts

    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

  • The /cgi-bin/ directory. You can map /cgi-bin/ to any directory you - like in the option setting panel (the Directory corresponds to + like in the options setting panel (the Directory corresponds to /cgi-bin field). You can specify multiple paths separated by - :, like /usr/local/cgi-bin:/home/aito/cgi-bin. To use a - /cgi-bin/ directory, you must use a file:/cgi-bin URL as follows: + :, 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: + 
    •   w3m -o cgi_bin=/path/to/cgi-bin file:/cgi-bin/script.cgi
    - It is not recommended to include the current directory to this path. -

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

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

    will display a blank page and delete that buffer immediately. @@ -2203,34 +2391,30 @@ W3m-control: BACK the script is invoked. The next example 

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

    will override the current buffer.

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

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

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

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

    Note that this header has no effect when the CGI script is invoked