summaryrefslogtreecommitdiff
path: root/res/about/help.gmi
diff options
context:
space:
mode:
authorJaakko Keränen <jaakko.keranen@iki.fi>2020-12-05 21:21:45 +0200
committerJaakko Keränen <jaakko.keranen@iki.fi>2020-12-05 21:21:45 +0200
commit408c2ba3ca06e219c20c9bf49e2a25d44fde6070 (patch)
treef90a4b22eb911276e58815b43df3783218eb717f /res/about/help.gmi
parentf32b1ab5f171b5f83ae4b1a98e178e99c6d19152 (diff)
Updated Help
Multiple sidebars, no more hover outline.
Diffstat (limited to 'res/about/help.gmi')
-rw-r--r--res/about/help.gmi15
1 files changed, 7 insertions, 8 deletions
diff --git a/res/about/help.gmi b/res/about/help.gmi
index af534c2e..5e9ececd 100644
--- a/res/about/help.gmi
+++ b/res/about/help.gmi
@@ -63,7 +63,7 @@ Lagrange's user interface is modeled after web browsers:
63 63
64* There is a navigation bar at the top with Back and Forward buttons. 64* There is a navigation bar at the top with Back and Forward buttons.
65* There is a tab bar for switching tabs. The tab bar is hidden if there is only one tab open. 65* There is a tab bar for switching tabs. The tab bar is hidden if there is only one tab open.
66* There is a sidebar for managing bookmarks and TLS identities, and viewing history and the page outline. The sidebar is hidden by default. 66* There is a sidebar for managing bookmarks and TLS identities, and viewing history and the page outline. Sidebars are hidden by default.
67* There is a search bar that appears at the bottom when searching text on the page. 67* There is a search bar that appears at the bottom when searching text on the page.
68 68
69Tip: Try pressing ${CTRL+}5 now to see the page outline. 69Tip: Try pressing ${CTRL+}5 now to see the page outline.
@@ -126,17 +126,17 @@ Press ${CTRL+}T to open a new tab, and ${CTRL+}W to close the current tab. Right
126 126
127The set of open tabs is restored when you launch Lagrange. 127The set of open tabs is restored when you launch Lagrange.
128 128
129## Sidebar 129## Sidebars
130 130
131The sidebar can be toggled via menus or by pressing ${SHIFT+}${CTRL+}L. It has five tabs: 131The sidebars can be toggled via menus or by pressing ${SHIFT+}${CTRL+}L or ${SHIFT+}${CTRL+}P (for the left/right sidebar, respectively). Both sidebars have five tabs:
132 132
133* Bookmarks: List of bookmarks that you've created. These appear first in search results for quick and easy access. 133* Bookmarks: List of bookmarks that you've created. These appear first in search results for quick and easy access.
134* Feeds: Entries found on subscribed feed index pages. 134* Feeds: Entries found on subscribed pages.
135* History: Chronological list of visited URLs. This is not a full history of all the URLs you've accessed over time — only unique URLs are shown at the latest access time. 135* History: Chronological list of visited URLs. This is not a full history of all the URLs you've accessed over time — only unique URLs are shown at the latest access time.
136* Identities: TLS client certificates. 136* Identities: TLS client certificates.
137* Outline: List of the headings in the currently open tab. Useful when reading longer documents. 137* Outline: List of the headings in the currently open tab. Useful when reading longer documents.
138 138
139${CTRL+}1 through ${CTRL+}5 switch between the sidebar tabs, or hide the sidebar if the current tab's key is pressed. You can also press Escape to dismiss the sidebar. 139${CTRL+}1 through ${CTRL+}5 switch between the left sidebar tabs, or hide the sidebar if the current tab's key is pressed. You can also press Escape to dismiss sidebars.
140 140
141## Bookmarks 141## Bookmarks
142 142
@@ -150,10 +150,11 @@ In addition to a title, bookmarks can have tags. Some tags have a special meanin
150 150
151* Set a "homepage" tag on a bookmark to make it one of the pages that will be opened when pressing the 🏠 button. If multiple bookmarks are tagged as homepages, a random one is selected. 151* Set a "homepage" tag on a bookmark to make it one of the pages that will be opened when pressing the 🏠 button. If multiple bookmarks are tagged as homepages, a random one is selected.
152* A "subscribed" tag means that Lagrange will periodically fetch the bookmarked page and look for Gemini feed links. All the found links that match the required style ("YYYY-MM-DD Entry title") will appear in the Feeds sidebar tab. 152* A "subscribed" tag means that Lagrange will periodically fetch the bookmarked page and look for Gemini feed links. All the found links that match the required style ("YYYY-MM-DD Entry title") will appear in the Feeds sidebar tab.
153* "headings" can be used together with "subscribed" to subscribe to new headings instead of Gemini feed links.
153 154
154## Feeds 155## Feeds
155 156
156You may be familiar with RSS and Atom XML feeds from the web. Lagrange does _not_ support RSS/Atom, only Gemini feeds. A Gemini feed is simply a regular 'text/gemini' page that contains one or more links whose labels are formatted in a particular way. 157You may be familiar with RSS and Atom XML feeds from the web. Lagrange does _not_ support RSS or Atom, only Gemini feeds. A Gemini feed is simply a regular 'text/gemini' page that contains one or more links whose labels are formatted in a particular way.
157 158
158=> gemini://gemini.circumlunar.space/docs/companion/subscription.gmi See "Subscribing to Gemini pages" for more information. 159=> gemini://gemini.circumlunar.space/docs/companion/subscription.gmi See "Subscribing to Gemini pages" for more information.
159 160
@@ -213,8 +214,6 @@ You can find a number of settings in Preferences to customize the user interface
213 214
214### Browsing behavior 215### Browsing behavior
215 216
216The "Outline on scrollbar" option shows the page outline when the mouse cursor is moved over the scrollbar, allowing one to better navigate long documents. The outline will disappear after the mouse cursor is moved away. If you need a persistent outline, one is always available in the sidebar.
217
218One important characteristic of Gemini is that you remain in control of what gets loaded and when. The browser will not suddenly fetch a ton of images, autoplay videos, or make surreptitious connections to any tracking servers — each network request is purposeful and manually triggered. With this in mind, the "Load image on scroll" option is provided to assist keyboard-only browsing and to facilitate a focused reading experience. When enabled, if there is an image link visible on the page and you press Space or ↓, it will be loaded and shown inline _instead_ of the view scrolling down. This allows you to read and see all the content of the page while only tapping on a single key on the keyboard. 217One important characteristic of Gemini is that you remain in control of what gets loaded and when. The browser will not suddenly fetch a ton of images, autoplay videos, or make surreptitious connections to any tracking servers — each network request is purposeful and manually triggered. With this in mind, the "Load image on scroll" option is provided to assist keyboard-only browsing and to facilitate a focused reading experience. When enabled, if there is an image link visible on the page and you press Space or ↓, it will be loaded and shown inline _instead_ of the view scrolling down. This allows you to read and see all the content of the page while only tapping on a single key on the keyboard.
219 218
220### Window and UI options 219### Window and UI options