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 :

  • Protocol : SFTP
  • Host : pollux.casa
  • Port : 22 (default)
  • User : your pseudo
  • Authentication : interactive (would ask for your password or ssh key password on connect)
  • Filezilla site manager πŸ–ΌοΈ

    Filezilla site manager

    You can also connect with FTP over TLS on port 21 if you prefer.

    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"

    Online edition

    Pollux.casa proposes to members to edit /tinylog.gmi with a gemini browser. You will need to use a client certificate (see your browser to know how to enable one) and try to connect to the member "cockpit". The application will give you the fingerprint to add in your fingerprints.txt file. It will associate your certificate to your account.

    Pollux.casa member cockpit

    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.

  • a gemini address : gemini://pseudo.pollux.casa/
  • an https address : https://pseudo.pollux.casa/
  • an http address : http://pseudo.pollux.casa/
  • 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 !

    [..]

    ^