É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 :

Filezilla site manager

🖼️
Filezilla site manager

Besoin de plus d'aide ?

How to Use SSH Private Keys for SFTP with Filezilla

Vous pouvez aussi vous connecter avec FTP explicite sur TLS sur le port 21 si vous préférez (demandez tout d'abord un mot de passe simple).

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)

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 :

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 !

[..]

🟊 gemini://pollux.casa/content.fr.gmi