summaryrefslogtreecommitdiff
path: root/res/about
diff options
context:
space:
mode:
Diffstat (limited to 'res/about')
-rw-r--r--res/about/help.gmi28
1 files changed, 22 insertions, 6 deletions
diff --git a/res/about/help.gmi b/res/about/help.gmi
index b845c6fb..15485571 100644
--- a/res/about/help.gmi
+++ b/res/about/help.gmi
@@ -31,11 +31,12 @@ Like Gemini, Lagrange has been designed with minimalism in mind. It depends on a
31* Sidebar for page outline, managing bookmarks and identities, and viewing history 31* Sidebar for page outline, managing bookmarks and identities, and viewing history
32* Multiple tabs 32* Multiple tabs
33* Identity management — create and use TLS client certificates 33* Identity management — create and use TLS client certificates
34* Subscribe to Gemini feeds 34* Subscribe to Gemini and Atom feeds
35* Use Gemini pages as a source of bookmarks 35* Use Gemini pages as a source of bookmarks
36* Light and dark color themes 36* Light and dark color themes
37* Select and copy text with the mouse 37* Select and copy text with the mouse
38* Find text on the page 38* Find text on the page
39* Search engine integration
39* Open image links inline on the same page 40* Open image links inline on the same page
40* Audio playback: MP3, Ogg Vorbis, WAV 41* Audio playback: MP3, Ogg Vorbis, WAV
41* Open links via keyboard shortcuts 42* Open links via keyboard shortcuts
@@ -88,6 +89,8 @@ Search within cached pages is limited to the (small) set of pages that Lagrange
88 89
89Note that the navigation stack is saved to a file when Lagrange is shut down and restored on the next launch. This means the next time you launch Lagrange, you can still search the contents of past pages. However, navigation stacks are tab-specific, so closing a tab will delete its history as well. 90Note that the navigation stack is saved to a file when Lagrange is shut down and restored on the next launch. This means the next time you launch Lagrange, you can still search the contents of past pages. However, navigation stacks are tab-specific, so closing a tab will delete its history as well.
90 91
92You can also make online search queries via the URL input field. When a search URL is configured on the "Network" tab of Preferences, text entered in the URL field is passed to the search URL as a query parameter. A search query will only occur when Enter is pressed while the [⇒ Search Query] indicator is visible.
93
91### 1.1.2 Links 94### 1.1.2 Links
92 95
93The type and destination of a link are indicated by the link's icon and color: ➤ links to the same domain, and 🌐 to a different domain. The colors are: 96The type and destination of a link are indicated by the link's icon and color: ➤ links to the same domain, and 🌐 to a different domain. The colors are:
@@ -127,7 +130,13 @@ You can give it a try now with the link below. Either hold down ${ALT}, or press
127 130
128Press ${CTRL+}T to open a new tab, and ${CTRL+}W to close the current tab. Right-clicking on buttons in the tab bar shows a context menu for additional tab-related functions. 131Press ${CTRL+}T to open a new tab, and ${CTRL+}W to close the current tab. Right-clicking on buttons in the tab bar shows a context menu for additional tab-related functions.
129 132
130The set of open tabs is restored when you launch Lagrange. 133The set of open tabs and their full contents are saved when you quit the application and restored when relaunch it.
134
135### 1.2.1 Auto-reloading
136
137A tab can be set to auto-reload at given intervals. The setting is remembered until the tab is closed. This is helpful if you keep a periodically updated page open for longer periods of time.
138
139The feature can be found in the page context menu: right-click and select "Set Auto-Reload...".
131 140
132## 1.3 Sidebars 141## 1.3 Sidebars
133 142
@@ -149,6 +158,8 @@ Bookmarks are listed in alphabetic order in the sidebar. There is no support for
149 158
150In addition to a title, bookmarks can have tags. Some tags have a special meaning, but you are free to enter whatever you want in the tags field. In quick search results, tags are given extra weight so they appear higher in results. 159In addition to a title, bookmarks can have tags. Some tags have a special meaning, but you are free to enter whatever you want in the tags field. In quick search results, tags are given extra weight so they appear higher in results.
151 160
161By default bookmarks are assigned random icons. You can enter a custom icon for a bookmark in the bookmark edit dialog to make it easier to recognize a particular site at a glance. The icon must be a single Unicode character. It will appear in the bookmark list, tab titles, feed entry list, quick search results, and page top banners.
162
152### 1.4.1 Exporting and importing 163### 1.4.1 Exporting and importing
153 164
154=> about:bookmarks The special page "about:bookmarks" is used for exporting bookmarks out of Lagrange. 165=> about:bookmarks The special page "about:bookmarks" is used for exporting bookmarks out of Lagrange.
@@ -183,10 +194,11 @@ Note that remote bookmarks are read-only: they cannot be edited or tagged. This
183 194
184## 1.5 Subscribing to feeds 195## 1.5 Subscribing to feeds
185 196
186You 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. 197You may be familiar with XML-based RSS and Atom feeds from the web. The Gemini equivalent of these is 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. This makes it very easy to write pages that clients can subscribe to.
187
188=> gemini://gemini.circumlunar.space/docs/companion/subscription.gmi See "Subscribing to Gemini pages" for more information. 198=> gemini://gemini.circumlunar.space/docs/companion/subscription.gmi See "Subscribing to Gemini pages" for more information.
189 199
200Lagrange supports Gemini and Atom feed subscriptions. Atom feeds are automatically translated to the Gemini feed format so they can be viewed and subscribed to like a normal 'text/gemini' page. RSS feeds are not supported.
201
190Subscriptions are managed via bookmarks. When you subscribe to a feed page, a bookmark is created and the special "subscribed" tag is applied on it. In the Bookmarks list, this is indicated by a ★ icon. There is no other difference between normal bookmarks and feed subscriptions — you may tag any bookmark as "subscribed" and Lagrange will look through it for feed-style links. The bookmark title is used as the feed title. This defaults to the top heading of the feed index page, but you can edit it to suit your needs. 202Subscriptions are managed via bookmarks. When you subscribe to a feed page, a bookmark is created and the special "subscribed" tag is applied on it. In the Bookmarks list, this is indicated by a ★ icon. There is no other difference between normal bookmarks and feed subscriptions — you may tag any bookmark as "subscribed" and Lagrange will look through it for feed-style links. The bookmark title is used as the feed title. This defaults to the top heading of the feed index page, but you can edit it to suit your needs.
191 203
192Feeds are refreshed periodically while Lagrange is running, and also immediately after launching if it has been a while since the previous refresh. You may also manually refresh all feeds via the menus or by pressing ${SHIFT+}${CTRL+}R. 204Feeds are refreshed periodically while Lagrange is running, and also immediately after launching if it has been a while since the previous refresh. You may also manually refresh all feeds via the menus or by pressing ${SHIFT+}${CTRL+}R.
@@ -260,6 +272,8 @@ There are four different color schemes for the UI: two for dark mode, and two fo
260 272
261On macOS, Lagrange will automatically switch between dark and light modes if the "Use system theme" setting is enabled. On other platforms you'll need to switch manually. 273On macOS, Lagrange will automatically switch between dark and light modes if the "Use system theme" setting is enabled. On other platforms you'll need to switch manually.
262 274
275On Windows, an option is provided to use a custom window frame. This provides a more consistent visual style for the application. However, the custom frame overrides default behaviors of the window, so if you are a Windows power user expect it to not support all the special interactions. For example, when pressing the Windows+Left/Right key, the window is resized to take over one half of the screen. Normally, Windows would then prompt to select another window to fill the rest of the screen, but this does not happen with the custom window frame.
276
263Options for wide window sizes: 277Options for wide window sizes:
264 278
265* Site icon: If there is room on the left side of the page text, the site icon appears there along with the top level heading. This allows one to keep better track of the current reading position in long documents. 279* Site icon: If there is room on the left side of the page text, the site icon appears there along with the top level heading. This allows one to keep better track of the current reading position in long documents.
@@ -282,12 +296,14 @@ The "Style" tab of the Preferences dialog lets you customize the appearance and
282 296
283The fonts for headings and other text are selected separately. This way one can achieve a greater number of style variations. Also, headings that are in a different font are more visually distinct and thus easier for one's eyes to scan. 297The fonts for headings and other text are selected separately. This way one can achieve a greater number of style variations. Also, headings that are in a different font are more visually distinct and thus easier for one's eyes to scan.
284 298
285There are two sans-serif and two serif fonts: 299There are six fonts available:
286 300
287* "Nunito" is a friendly rounded sans-serif font. 301* "Nunito" is a friendly rounded sans-serif font.
288* "Fira Sans" is a bolder, narrower, and more angular sans-serif font. 302* "Fira Sans" is a bolder, narrower, and more angular sans-serif font.
289* "Literata" is a heavy and serious serif font. 303* "Literata" is a heavy and serious serif font.
290* "Tinos" is a lighter serif font. 304* "Tinos" is a lighter serif font.
305* "Source Sans Pro" is the Lagrange UI font.
306* "Iosevka" is the monospace font.
291 307
292Other style options: 308Other style options:
293 309
@@ -388,7 +404,7 @@ Any output that does not follow this format is considered to mean that the hook
388## 4.2 mimehooks.txt syntax 404## 4.2 mimehooks.txt syntax
389 405
390Like other Lagrange configuration lines, mimehooks.txt has a simple line-oriented syntax. Lagrange must be restarted for changes to the configuration file to take effect. 406Like other Lagrange configuration lines, mimehooks.txt has a simple line-oriented syntax. Lagrange must be restarted for changes to the configuration file to take effect.
391 407
392Each hook is specified as three lines: 408Each hook is specified as three lines:
393* A human-readable label (for reporting to the user) 409* A human-readable label (for reporting to the user)
394* MIME type/parameter regular expression 410* MIME type/parameter regular expression