💾 Archived View for geminauts.com › help.gmi captured on 2024-12-17 at 09:34:58. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
All capsules have a domain name. As an example, we will say that your capsule's domain name is `myCapsule`. You can view your capsule at `myCapsule.geminauts.com`. If you have a custom domain and it is setup correctly, you can go to your custom domain as well. We will use `my.capsule.com` as the custom domain example.
In order to make changes to your capsule, you will need to be logged in. Being logged in is defined as using a client certificate that has been linked with your account. You can always link another certificate at
gemini://geminauts.com/account/link/
After you have a linked certificate, you just need to make sure that the certificate is being used at `myCapsule.geminauts.com` or `my.capsule.com` if you have a custom domain. To make sure it worked, go to your admin page: `myCapsule.geminauts.com/admin/`.
Currently, the only way to upload content to your capsule is through titan. Gemini's sister protocol. Not all gemini clients support this. Make sure you can upload files with titan.
Let's say you want to create your home page. This would be at `myCapsule.geminauts.com/`. You will need to send a titan request using your linked certificate. Let's say you upload the following.
# Hello World! Welcome to my capsule!
If everything worked, then you will see a response saying that the file was uploaded with a link to the file. Because geminauts caches files on the server, it can take up to a minute for the new file to appear.
One extra thing to note is that paths that end with a `/` are directories and files uploaded to them are actually uploading a file called. `index.gmi`, so with our example, it is uploading a file to `myCapsule.geminauts.com/index.gmi`. Index files must be text/gemini. If you want to upload something that is not a gemtext file, the you will need to make sure there is no trailing forward slash.
Geminauts will also show a list of items in a directory that doesn't have an `index.gmi` file. Say you have an images folder. Below is a response you would see when going to `myCapsule.geminauts.com/images/`.
# /images/ => /images/cat.jpg cat.jpg => /images/dog.jpg dog.jpg => /images/person.jpg person.jpg
There is no way to disable directories.
In order to delete a file. You simply need to send a request to the file you wish to delete with `?delete` added to the end of it. Say you wanted to delete `/images/person.jpg`. You would go to `myCapsule.geminauts.com/images/person.jpg?delete`. If you supplied your linked certificate, then a dialog will be sent back asking for confirmation that you actually want to delete the file. If you say `yes`, then the file will be deleted.
Like with uploading files, it may take up to one minute for deleted files to actually show as being gone.
You also are not allowed to delete directories. If you want to delete a directory, then you will have to delete all files within that directory.