Navigating on the web efficiently with "view" and "feed"

The basics

When you want to know where you are, simply type:

Url returns the current url. It can also easily be shared with your system clipboard thanks to the "copy url" command:

See "help copy" for other use of copy.

If "url" is not enough, you can get plenty of information about the current page with "info".

View full to get the full page when something is missing

When you are in a gemini page, the page is straightforward. But, for HTML pages, Offpunk will try to extract the important information and remove useless cruft.

This doesn’t always work. If you want to see the full page, use "view full" (or "v full"). Go back with "v normal". You can switch with "v switch".

The reason you may no see the whole content in "normal" mode is because Offpunk uses "readability". Readability is sometimes overzealous, especially when it comes to lists of links.

Readability is still very much needed because, without it, most "modern web pages" have hundred (if not thousands) of links. During synchronization, Offpunk would try to cache all those links. Readability keep Offpunk sane by default, at the price of not always showing the full content.

There are multiple way to navigate websites which are not perfectly displayed. The first one is getting used to check "v full", as we saw.

The second solution is to use RSS feeds to navigate through a website. On a given homepage, scroll to the bottom (where available feeds are listed) or type:

If multiple feeds exists, select the one you want to use. Through the feeds, you can quickly navigate between articles of a given website.

By default, the feed view only list the items and you can follow links to read each of them individually. Some feeds contains the information directly. If you want to view the feed in full, not only as a list of items, you will use… Well, you guessed right:

Better rendering using unmerdify

The third solution for better rendering of websites is to use unmerdify, which relies on a crowdsourced list of rules of each domain.

You will need to get that list of rules and store it anywhere on your computer:

Then, you should add the path to that repository in your offpunkrc:

Remember to periodically refresh the rules by going in the ftr-site-config folder and typing:

You can also contribute rules for your favorites website:

Contributing to fivefilters

Whitelisting a website

If a given website is permanently badly displayed with readability and you want to enforce a full view for all its pages, you can whitelist this website with:

The whitelist can be undone with

Before following a link, you can simply preview it with "view" or "v".

(where X is the link number).

You can similarly copy the url of a given link

Viewing images

When browsing a page, images are "pixelated", even if you use a terminal that can display pictures. The reason is that the browsing of the page happens in "less", and less doesn’t support displaying pictures.

The workaround is to simply follow the picture link (by default in yellow) to see the picture in your terminal then go back to where you were reading.

Imagine your are reading an article and want to see image with number 7:

This requies a sixel-compatible terminal that can display images.

When Offpunk is not enough

Then, you may need to open a content in an external tool:

Open outside of Offpunk

Back to the tutorial