Using the site
The keys, icons, and shortcuts for getting around
Navigation
The sidebar lists every chapter of the site. The menu button (three horizontal bars) at the top left opens and closes it, and so does the b key. Click any chapter to open it. On a narrow window, a phone especially, the sidebar starts closed; the menu button brings it up.
The menu bar along the top holds the icons described below. Clicking the site’s name in the middle takes you back to the top of the page. As you scroll down, the menu bar slides out of the way; scroll up a little and it comes back.
The ← and → keys move you to the previous and next chapter; the large arrow buttons do the same, at the sides of the page on a wide screen and at the bottom of the page on a narrow window or a phone. ↑ and ↓ scroll the page, and PgUp, PgDn, Space and Shift+Space scroll a whole screen at a time. Press ? any time for the full list of keys.
This is not unique to Docwright, but in case you didn’t know: Alt+← and Alt+→ move you back and forward through your browser history. If a link took you somewhere, Alt+← brings you back.
On a phone or tablet
There’s no keyboard, so here’s what stands in for each key.
| To do this | On a computer | On a phone or tablet |
|---|---|---|
| Open or close the sidebar | b | Tap the three bars, or swipe right from the left edge to open it and swipe left to close it |
| Previous or next chapter | ← → | Tap the arrow buttons at the bottom of the page |
| Search | s or / | Tap the magnifying glass |
| Back to the top | Click the site’s name | Tap the site’s name |
| Back to where you were | Alt+← | Your phone’s back button or back gesture |
| Read offline | Click the cloud, then Save for offline | Tap the cloud, then Save for offline; on an iPhone or iPad, open the site from your Home Screen first (in Safari: Share, then Add to Home Screen) |
Swipes need to be quick: a slow drag scrolls the page instead.
Menu bar icons
| Icon | What it does |
|---|---|
| Three bars | Opens and closes the sidebar. Same as b. |
| Paintbrush | Switches between the site’s colour themes. Your pick is remembered for your next visit. |
| Magnifying glass | Opens the search bar. Same as s or /. |
| Pencil | Opens the source of this page on GitHub, so you can suggest a fix if you spot a mistake. |
| Printer | Lays the whole site out as one long page, for printing or saving as a PDF. To print only the page you’re reading, press Ctrl+p instead. |
| Cloud | Saves the site in this browser, to read without a connection, or gives you a copy to keep on any computer. Once the site is saved, the cloud becomes a tick. See Reading offline. |
One icon lives outside the menu bar: hover over any code block and a copy button appears at its top right. It copies the code exactly as written, ready to paste into the terminal.
Search
Open the search bar (the magnifying glass, s or /) and start typing; matching chapters and headings appear as you type. ↑ and ↓ move through the results, Enter opens the one you’re on, and Esc closes the search bar.
Reading offline
The cloud at the right end of the menu bar gives you two ways to read Docwright without a connection.
Save for offline keeps the whole site in the browser you’re using, search included. You need to be online once, to save it; after that the site opens from your saved copy, online or not. Once it’s saved, the cloud turns into a tick, or a plane while you’re offline. When a new version is out, a dot appears on the tick and the top of each page says so: tap the tick, then Update to v…, which downloads only what changed. Remove saved copy takes you back to the live site. The copy lives in that one browser. On an iPhone or iPad, add the site to your Home Screen first (in Safari: Share, then Add to Home Screen) and save it from there: Safari deletes a site saved in the browser after seven days of browsing without opening it.
Download a copy gives you the whole site to keep on any computer, including one that’s never online. Unpack it and open index.html in the folder it makes; it needs no connection. Under the button are the download’s SHA-256 checksum and a checksum file, and the README.txt inside shows how to use them to check the download on Linux, macOS or Windows. A downloaded copy doesn’t update itself: its cloud shows which version you have and the site’s address, where you can get a newer one.
If the cloud offers only Download a copy, this browser can’t keep the site offline: use another browser, or the download.
The version line
At the very bottom of the sidebar, under the last chapter, you’ll find a small grey line like v1.2 · updated 2026-03-14 · a3f9c1e. It tells you which build of the site you’re reading: the version, the day it was published, and the exact commit it was built from. The commit is a link, so you can see on GitHub exactly what changed.