Edit your capsule

Connect to your capsule

To connect to pollux.casa server, you need to use an SFTP client (Ssh File Transfer Protocol). Many tools exist. Maybe the most common is Filezilla

To use your ssh key, first, you have to unlock it (on each session if your passphrase is not stored in your keyring) :

ssh-add ~/.ssh/id_rsa

Filezilla website

When your account is active, you can connect with these parameters :

Filezilla site manager

πŸ–ΌοΈ
Filezilla site manager

Need more help?

How to Use SSH Private Keys for SFTP with Filezilla

You can also connect with FTP over TLS on port 21 if you prefer (ask for a simple password before).

Files in your capsule

Now, you can see on the right panel, the content of your pollux.casa space. The folder "capsule" contains files that are served to "geminautes".

A standard files tree is automatically created, you can download them and modify content, and, of course, add new ones.

.
β”œβ”€β”€ capsule/                 Your capsule, folder corresponding to the root of "pseudo".pollux.casa
β”‚Β Β  β”œβ”€β”€ favicon.txt          Contains an emoji (one character of your choice)
β”‚Β Β  β”œβ”€β”€ gemlog/              Common folder containing your gemlog post (a file .gmi per post)
β”‚   β”‚   └──                  usually files in gemlog are name like YYYY-MM-DD_The_title.gmi
β”‚Β Β  β”œβ”€β”€ index.gmi            The main page of your capsule
β”‚Β Β  └── tinylog.gmi          Common tinylog file (*)
β”œβ”€β”€ fingerprints.txt         Contains client certificates to allow your browser to to connect to the cockpit
└── .ssh/
    └── authorized_keys      Container of your public ssh keys (you can add more, one per line)

If a folder does not contain an index.gmi file, server will generate an index page with every gmi files in this folder. If the file name starts with a timestamp in this format "YYYY-MM-DD_", you can just put a new .gmi file in your /capsule/gemlog/ folder to publish a new post. Gemninautes will be able to subscribe to your gemlog with their favorite browser.

more info about "subscription"

(*) a tinylog is a kind of microblogging network.

more info about "tinylog"

Gemini file (.gmi) format

Gemini files are easy to edit. Open your preferred text editor, choose utf-8 format.

A gemini file is managed line by line. With the three first character, browser know what kind of lin it is.

Starting by "#", "##" or "###" it's a title of level 1, 2 or 3

# Main title
## Subtitle
### Sub-subtitle

Starting by a "* " it's an element of an unordered list

* element 1
* element 2
* element 3

Starting with "> " it's a blockquote

> To be or not to be, that is the question.

Starting with "=> " it's a relative or ablosute link, followed by a description. eg:

=> /gemlog/ Link to my gemlog
=> img/photo.jpg Link to a photo in subfolder "img" of this folder
=> gemini://adele.work/ AdΓ«le's capsule
=> https://example.tld/ Link to a web site (out of gemini space)

Block between two line starting with "```" are preformated text. First ``` can be followed by a description of the text (important for accessibility). Ex:

 ```ascii-art of a elephant
      _    _
     /=\""/=\
    (=(0_0 |=)__
     \_\ _/_/   )
       /_/   _  /\
 toot // |\ || |  *
         ~ ~  ~
 ```

or some code

 ```php source of hello world
 <?php
   echo "Hello world!";
 ?>
 ```

See the result

Your capsule is automatically visible after file upload on two different addresses.

The choice to publish also on http is to make your capsule more visible. Generated html page contains a banner with a clickable link to your gemini address. It would incite internautes to try gemini !

Enjoy !

[..]

πŸš€ gemini://pollux.casa/content.gmi