summaryrefslogtreecommitdiff
path: root/res/about
diff options
context:
space:
mode:
Diffstat (limited to 'res/about')
-rw-r--r--res/about/help.gmi29
1 files changed, 24 insertions, 5 deletions
diff --git a/res/about/help.gmi b/res/about/help.gmi
index 158204d7..ca5e164f 100644
--- a/res/about/help.gmi
+++ b/res/about/help.gmi
@@ -12,6 +12,7 @@ Lagrange is a GUI client for browsing Geminispace. It offers modern conveniences
12 12
13Like Gemini, Lagrange has been designed with minimalism in mind. It depends on a small number of essential libraries. It is written in C and uses SDL for hardware-accelerated graphics. OpenSSL is used for secure communications. 13Like Gemini, Lagrange has been designed with minimalism in mind. It depends on a small number of essential libraries. It is written in C and uses SDL for hardware-accelerated graphics. OpenSSL is used for secure communications.
14 14
15=> about:lagrange About Lagrange
15=> https://www.libsdl.org SDL: Simple DirectMedia Layer 16=> https://www.libsdl.org SDL: Simple DirectMedia Layer
16=> https://www.openssl.org OpenSSL: Cryptography and SSL/TLS Toolkit 17=> https://www.openssl.org OpenSSL: Cryptography and SSL/TLS Toolkit
17 18
@@ -59,15 +60,17 @@ Lagrange's user interface is modeled after web browsers:
59* There is a sidebar for managing bookmarks and TLS identities, and viewing history and the page outline. The sidebar is hidden by default. 60* There is a sidebar for managing bookmarks and TLS identities, and viewing history and the page outline. The sidebar is hidden by default.
60* There is a search bar that appears at the bottom when searching text on the page. 61* There is a search bar that appears at the bottom when searching text on the page.
61 62
63Tip: Try pressing ${CTRL+}4 now to see the page outline.
64
62## URL entry and quick search 65## URL entry and quick search
63 66
64The URL input field is in its typical location in the navigation bar. It can be accessed quickly by pressing ${CTRL+}L. 67The URL input field is in its typical location in the navigation bar. It can be accessed quickly by pressing ${CTRL+}L.
65 68
66As you enter text, Lagrange starts looking for matches in bookmarks, history, content of cached pages, and identities. Search terms are case insensitive, and if many words are entered, they are all required to appear in the specified order in any matched content. 69As you enter text, Lagrange starts looking for matches in bookmarks, history, content of cached pages, and identities. Search results appear below the URL input field in a popup. Press Tab or ↓ to switch input focus to the results.
67 70
68Press Tab or ↓ to switch input focus to the search results. 71Search within cached pages is limited to the (small) set of pages that Lagrange keeps in memory for back navigation. Search terms are case insensitive, and if many words are entered, they are all required to appear in the specified order in any matched content.
69 72
70Search within cached pages is limited to the (small) set of pages that Lagrange keeps in memory for back navigation. Note that while the navigation stack is saved to a file when Lagrange is shut down and restored on the next launch, it is also tab-specific — a tab's navigation cache is lost when the tab is closed. 73Note 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.
71 74
72## Tabs 75## Tabs
73 76
@@ -88,6 +91,8 @@ ${CTRL+}1 through ${CTRL+}4 switch between the sidebar tabs, or hide the sidebar
88 91
89## Navigation 92## Navigation
90 93
94When navigating to a new page, the old page is cached in memory. If you navigate back, the cached copy of the page is restored. Think of it as rewinding time — you return to a past time as if nothing had happened. The same applies to forward navigation; cached pages are loaded if available. This allows back and forward navigation to happen instantly, without any network requests.
95
91### Link icons 96### Link icons
92 97
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: 98The 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:
@@ -105,9 +110,23 @@ When navigating via keyboard, hold down ${ALT} to see link shortcut keys. Try do
105 110
106Each visible link on the page gets an alphanumeric shortcut. For example, the first link can be opened by pressing ${ALT+}1. The tenth link is ${ALT+}A. Additionally hold down ${CTRL} to open the link in a new tab. 111Each visible link on the page gets an alphanumeric shortcut. For example, the first link can be opened by pressing ${ALT+}1. The tenth link is ${ALT+}A. Additionally hold down ${CTRL} to open the link in a new tab.
107 112
113## Downloads
114
115Press ${CTRL+}S to save the contents of the current page to the Downloads folder. This works on all pages regardless of whether Lagrange can display the contents or not.
116
117The location where downloaded files are saved can be set in Preferences.
118
119The 🔃 button on the right side of the URL input field is the Reload/Stop button — it reloads the current page or stops an ongoing download. During large downloads, an additional progress indicator appears next to the Stop button.
120
108## Bookmarks 121## Bookmarks
109 122
110... 123Press ${CTRL+}D to bookmark the currently open URL.
124
125In 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.
126
127### Special tags
128
129* Set a "homepage" tag on a bookmark to make it one of the pages that will be opened when pressing the 🏠 button.
111 130
112## Identities (TLS client certificates) 131## Identities (TLS client certificates)
113 132
@@ -134,7 +153,7 @@ Likewise, .gmi/.gemini file extensions are registered as file formats that Lagra
134 153
135## Drop and drop 154## Drop and drop
136 155
137You can drag and drop .gmi files on the Lagrange window to open them in the current tab. Dropping multiple files opens them in separate tabs. This is the recommended way to view local files, because there is no "Open File" menu item. You may also type "file://" URLs in the URL field. 156You can drag and drop .gmi files on the Lagrange window to open them in the current tab. Dropping multiple files opens them in separate tabs. This is the recommended way to view local files, because there is no "Open File" menu item. You may also type "file://" URLs in the URL field.
138 157
139## Runtime files 158## Runtime files
140 159