Éditer votre capsule

Vous connecter à votre capsule

Pour vous connecter à votre capsule, vous avez besoin d'utiliser un client SFTP (Ssh File Transfer Protocol). De nombreux outils existent. Peut-être que le plus commun est Filezilla

Pour utiliser votre clé ssh, tout d'abord, vous devez la déverrouiller (à chaque session si votre phrase de passe n'est pas stockée dans votre trousseau) :

ssh-add ~/.ssh/id_rsa

Site web de Filezilla

Une fois votre compte actif, vous pouvez vous connecter avec ces paramètres :

  • Protocole : SFTP
  • Hôte : pollux.casa
  • Port : 22 (par défaut)
  • Type d'authentification : interactif
  • Identifiant : votre pseudo
  • Filezilla site manager 🖼️

    Filezilla site manager

    Vous pouvez aussi vous connecter avec FTP explicite sur TLS sur le port 21 si vous préférez.

    Les fichiers dans votre capsule

    Maintenant, vous pouvez voir, sur le panneau de droite, le contenu de votre espace pollux.casa. Le dossier "capsule" contient les fichiers servis aux "geminautes".

    Une arborescence de fichiers standards est automatiquement créée, vous pouvez les télécharger et modifier leur contenu, et, bien sûr, en ajouter des nouveaux.

    .
    ├── capsule/                 Votre capsule, dossier racine de "pseudo".pollux.casa
    │   ├── favicon.txt          Contient un emoji (un caractère de votre choix)
    |   ├── gemlog/              Dossier contenant les posts de votre gemlog (un fichier .gmi par post)
    │   │   └──                  habituellement les fichiers des gemlogs sont nommés ainsi AAAA-MM-JJ_Le_titre.gmi
    │   ├── index.gmi            La page principale de votre capsule
    │   └── tinylog.gmi          Un fichier commun tinylog (*)
    ├── fingerprints.txt         Contient les certificats client pour autoriser cotre navigateur à se connecter au cockpit
    └── .ssh/
        └── authorized_keys      Contient votre clé publique ssh (vous pouvez en ajouter d'autres, une par ligne)
    

    Si un dossier ne contient pas de fichier index.gmi, le serveur génère une page index avec chaque fichier gmi de ce dossier. Si un nom de fichier commence par une date sous ce format "AAAA-MM-JJ_", vous pouvez simplement poser un nouveau fichier .gmi dans votre dossier /capsule/gemlog pour publier un nouveau post. Les Gemninautes pourront s'abonner à votre gemlog avec leur navigateur favori.

    plus d'info sur les "subscription" (en)

    (*) Tinylog une sorte de réseau de microblogging.

    plus d'info sur "tinylog" (en)

    Edition en ligne

    Pollux.casa propose aux membres d'éditer /tinylog.gmi avec un navigateur gemini. Vous devrez utiliser un certificat client (voir votre navigateur pour savoir comment en activer un) et essayer de vous connecter au "cockpit" réservé aux membres. L'application vous donnera l'empreinte à ajouter dans votre fichier fingerprints.txt. Cela associera votre certificat à votre compte.

    Pollux.casa member cockpit

    Format des fichiers gemini (.gmi)

    Les fichier gemini sont facile à éditer. Ouvrez votre éditeur de texte préféré, choisissez l'encodage utf-8.

    Un fichier gemini est analysé ligne par ligne. Avec les trois premiers caractères, un navigateur connaît le type de ligne à afficher.

    Commençant par "#", "##" ou "###" c'est un titre de niveau 1, 2 ou 3

    # Titre principal
    ## Sous-titre
    ### Sous-sous-titre
    

    Commençant par une "* " c'est un élément de liste non ordonnée

    * élément 1
    * élément 2
    * élément 3
    

    Commençant par "> " c'est une citation

    > Être ou ne pas être, telle est la question...
    

    Commençant par "=> " c'est un lien relatif ou absolu, suivi d'une description. ex :

    => /gemlog/ Lien vers mon gemlog
    => img/photo.jpg Lien vers une photo dans le sous-dossier img du dossier de ce dossier
    => gemini://adele.work/ La capsule d'Adële
    => https://example.tld/ Lien vers un site web (hors de l'espace gemini)
    

    Les blocs entre deux lignes commençant par "```" sont des textes préformattés. Le premier ``` peut être suivi d'une description du bloc (important pour l'accessibilité). Ex :

     ```ascii-art d'un éléphant
          _    _
         /=\""/=\
        (=(0_0 |=)__
         \_\ _/_/   )
           /_/   _  /\
     pouet// |\ || |  *
             ~ ~  ~
     ```
    

    ou du code source :

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

    Voir le résultat

    Votre capsule est automatiquement visible après le transfert des fichiers sur 3 adresses différentes :

  • adresse gemini : gemini://pseudo.pollux.casa/
  • adresse https : https://pseudo.pollux.casa/
  • adresse http : http://pseudo.pollux.casa/
  • Le choix de publier aussi en http/https est de rendre votre capsule plus visible. La page html générée contient un bandeau avec un lien clicable vers votre adresse gemini. Cela devrait inciter les internautes à essayer gemini !

    Amusez vous !

    [..]

    ^