From a288eb43ed772f7aff5500ca5fc9ba545ab341c4 Mon Sep 17 00:00:00 2001 From: Jaakko Keränen Date: Tue, 8 Sep 2020 14:34:42 +0300 Subject: Updated "about:help" with more content --- res/about/help.gmi | 51 +++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 45 insertions(+), 6 deletions(-) (limited to 'res') diff --git a/res/about/help.gmi b/res/about/help.gmi index 9e617015..c8750140 100644 --- a/res/about/help.gmi +++ b/res/about/help.gmi @@ -4,17 +4,37 @@ |___ /~~\ \__> | \ /~~\ | \| \__> |___ ``` -# Introduction +# Help ## What is Lagrange Lagrange is a GUI client for browsing Geminispace. It offers modern conveniences familiar from web browsers, such as smooth scrolling, inline image viewing, multiple tabs, visual themes, Unicode fonts, bookmarks, history, and page outlines. -Lagrange relies on a minimal set of dependencies. It is written in C and uses SDL for window management and hardware-accelerated graphics. OpenSSL is used for secure communications. +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. => https://www.libsdl.org SDL: Simple DirectMedia Layer => https://www.openssl.org OpenSSL: Cryptography and SSL/TLS Toolkit +### Features + +* UI inspired by Safari on macOS +* Light and dark UI themes +* Multiple tabs +* Sidebar for page outline, managing bookmarks and identities, and viewing history +* Smart suggestions when typing the URL — search bookmarks, history, identities +* Scaling factor for the UI (for arbitrary monitor DPI) +* Beautiful typography using Unicode fonts +* Autogenerated page style and Unicode icon for each Gemini domain +* Open image links inline on the same page +* Instant back/forward navigation +* Smooth scrolling +* Scaling page content (50%...200%) +* Select and copy text with the mouse +* Find text on the page +* Identity management — create and use TLS client certificates +* Persistent app state — tabs and history are restored on next run +* Opening links via keyboard shortcuts + ## What is Gemini Gemini is a simple protocol for serving content over the internet. It specifies a Markdown inspired format allowing basic plain text document markup. Compared to HTTP and HTML, Gemini is vastly simpler and easier to work with. @@ -28,28 +48,47 @@ Modern web browsers are complex beasts. In fact, they are so complex that one ca => https://win95.ajf.me Windows 95 on DOSBox (using Emscripten) -If one seeks to just read text and view images, this is absurd overkill. While having a universal platform that runs on everything and everywhere is clearly a valuable notion, it comes with a hefty price tag. The software stack towers ever higher, and similarly hardware needs to be ever more powerful and complicated to run it well. But everything happening over the internet doesn't have to be on this behemoth. +If one seeks to just read text and view images, this is absurd overkill. Having a universal platform that runs everywhere and on everything is clearly a valuable notion, but it comes with a hefty price tag. The software stack towers ever higher, and hardware needs to be ever more powerful and complicated to run it well. However, everything happening over the internet doesn't have to rely on this behemoth. One way to browse Gemini content is via web browser extensions or proxies that translate the content for the web. This may be a sufficient and easy solution for you. However, native clients such as Lagrange also benefit from the simpleness of the protocol and the content. The experience can be optimized, and the software runs well even on simple hardware like the Raspberry Pi. # User interface +The user interface has been designed to have a feel similar to Safari on macOS. + +## URL entry and quick search + +The URL input field is in its typical location in the navigation bar. It can be accessed quickly by pressing ${CTRL+}L. + +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. Search of cached pages is limited to the (small-ish) set of pages that Lagrange keeps in memory for back navigation. + +## Sidebar + ## Navigation +### Opening links using the keyboard + When navigating via keyboard, hold down ${ALT} to see link shortcut keys. Try doing so now and see how the link icon below is replaced with a number. => gemini://gemini.circumlunar.space/ Project Gemini 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. -### SEomting - -## Bookmarking +## Bookmarks ## Managing and using identities TLS client certificates used to identify you. +# Runtime files + +* bookmarks.txt +* idents.binary and idents/ +* prefs.cfg +* state.binary +* trusted.txt +* visited.txt + # Platform-specific instructions # Compiling from source -- cgit v1.2.3