É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) :
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
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)
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 !
[..]