3.4 That’s a favorite with me!

Like all modern browsers, emacs-w3m has advanced features related to bookmarks: it lets you classify them in categories, edit them and of course, browse them easily.

3.4.1 Adding a URL to your favorites

There are several ways to add a URL to your bookmarks. The first one is to use the a key (or call the w3m-bookmark-add-current-url command) to add the page you’re currently browsing: it will prompt you for a section to where the bookmark should go (completion is available with the <TAB> key) and will let you edit the title of the bookmark (the default being the title of the current page). Complete these two steps, validating each with <RET>, and you will see the message “Added” in the minibuffer, which means (surprise!) that the page has been added to your bookmarks.

Another way to add a bookmark is to use the M-a key (or call the w3m-bookmark-add-this-url command): it adds the URL under point (that means, the URL you would be taken to if you followed the link) to the bookmarks. As before, you will have to input the section for this bookmark and its title, the default being this time the name of the link itself.

The third and final way to do this is to use C-u a, this time you will be prompted for the URL to add, its section, and the title to use for it in the bookmarks.

a

Add the current page to the bookmarks, or if called with a prefix argument, prompt for a URL and add it (w3m-bookmark-add-current-url).

M-a

Add the URL under point to the bookmarks (w3m-bookmark-add-this-url).

3.4.2 Browse your bookmarks

The easiest way to see the bookmarks is to use the v key in an emacs-w3m buffer; another possibility is to go to the special URL about://bookmark/. You will see your bookmarks, organized by section, each line being one bookmark. You can browse them exactly like you would browse any other page.

On the bookmarks page a w3m minor mode is activated, the bookmark mode. It adds key bindings to edit the bookmarks. See section How to change your bookmarks.

v

Visit the bookmarks page (w3m-bookmark-view).

3.4.3 How to change your bookmarks

The bookmark minor mode (see section Browse your bookmarks) offers several key bindings related to bookmark edition, most noticeably C-k to kill (i.e. delete) a bookmark, and E (e for the ‘Info-like’ keymap) to edit the bookmark file.

Bookmarks are kept in an HTML file, so you can edit the file by hand, but be very careful: if you erase the comments emacs-w3m needs to recognize section names, things can break easily. If you know the basics of HTML, the file should otherwise be quite self-explanatory.

C-k

Kill the bookmark under point (w3m-bookmark-kill-entry).

E

Visit the bookmarks file (w3m-bookmark-edit).

C-_

Undo the last changes (w3m-bookmark-undo).

This document was generated by TSUCHIYA Masatoshi on January 30, 2019 using texi2html 1.82.