diff options
Diffstat (limited to 'res/about')
-rw-r--r-- | res/about/help.gmi | 29 |
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 | ||
13 | Like 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. | 13 | Like 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 | ||
63 | Tip: 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 | ||
64 | The URL input field is in its typical location in the navigation bar. It can be accessed quickly by pressing ${CTRL+}L. | 67 | The URL input field is in its typical location in the navigation bar. It can be accessed quickly by pressing ${CTRL+}L. |
65 | 68 | ||
66 | As 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. | 69 | As 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 | ||
68 | Press Tab or ↓ to switch input focus to the search results. | 71 | Search 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 | ||
70 | Search 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. | 73 | Note 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 | ||
94 | When 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 | ||
93 | The 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: | 98 | The 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 | ||
106 | Each 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. | 111 | Each 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 | |||
115 | Press ${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 | |||
117 | The location where downloaded files are saved can be set in Preferences. | ||
118 | |||
119 | The 🔃 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 | ... | 123 | Press ${CTRL+}D to bookmark the currently open URL. |
124 | |||
125 | In 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 | ||
137 | You 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. | 156 | You 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 | ||