💾 Archived View for maiaforum.net › faq.gmi captured on 2024-05-12 at 15:07:53. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2024-05-10)
-=-=-=-=-=-=-
To make full use this forum, you need three things:
provides the first two and the means of creating the third, and I recommend using it with this forum.
These instructions apply to the Lagrange browser.
Look to the top of your browser window; to the right of the arrow keys (<- and ->) is a third button colored white and black. Click it, and a sidebar window will open. On the sidebar, click the icon of a person, then the "+ New..." button at the bottom of the sidebar. A new window will open; change "Not Used" to "Current Domain: maiaforum.net". Enter a value for "valid until..." (if you wish it to never expire, set it 100 years in the future), enter a common name (this is only a means for YOU to identify the certificate, not us), and leave the "Temporary" field be.
After that, all that's left to do is to register!
Titan is a sister protocol to Gemini which allows uploading data from clients to a server. It is needed to create posts and register on this forum, among a few other things.
Using the Lagrange browser -- which I'd recommend generally, but especially to the less technically inclined -- you may send a Titan request to a page simply by pressing the buttons control-U. Thence, into the window which will pop up, you may supply the "body" of your text into the large window, and a "token" in the small window below."
Alternatively, right-click anywhere to open a menu. Click "Tools," then "Upload with Titan..." to enter the Titan upload menu.
Navigate to a subforum where you have permission to post a thread. For new users, that will be only the "Introductions" subforum. Then click the link "Create Thread" and follow the instructions there.
Navigate to a thread where you have permission to post, then send a Titan upload request to the page. You may title your post by including it as a token.
Below each post displayed in a thread, as long as you are logged in, there should be a link that says: "[Link to post]." Click that, then, if you have the ability to edit that post (e.g. you were the one who created it), a Titan upload to that page will replace the content of that post with your new content.
If your certificate was set to be used on this domain, there is nothing for you to do -- once your application is accepted, you will be "logged in" automatically (i.e. every time you make a request to a page on this forum).
Otherwise, make sure you're sending your certificate with each request you make. On Lagrange, open your certificate menu, right-click the certificate you use with this forum, and click "Use on this page."
Titan is required to create posts because Gemini itself does not provide a method for uploading much data to servers. Section 3.2.1 of the Gemini specification allows for "a line of textual user input" to be requested from clients, but this input is sent back to the server as part of the URL, which is subject to URLs' 1,024-byte limitation in length. Since the URL includes the protocol specification and hostname of the server, and because UTF characters comprise multiple bytes, the maximum possible length of user input becomes even shorter. I would like longer posts able to be created, and a protocol like Titan is the only way to achieve this in a sane manner.
I am aware that most Gemini clients do not include support for Titan, and some users may not wish to use a forum incompatible with their favorite client, or have other reasons to prefer forum usable with "pure" Gemini. Unfortunately this hard limitation on URL length severely limits users' ability to post content.
If using Titan concerns you, I'd ask you to consider how simple of a protocol it is to implement. A simple standalone client can be written in under an hour; with a little more effort, it should be relatively easy to patch a simple existing Gemini client to include support.
Thanks for reading!
-eriounious.