diff options
author | n-peugnet <n.peugnet@free.fr> | 2022-04-08 21:12:28 +0200 |
---|---|---|
committer | n-peugnet <n.peugnet@free.fr> | 2022-04-08 21:12:28 +0200 |
commit | 633475e59383a44aedd9e134d46cb0b2d18d0691 (patch) | |
tree | ed368d6ca374962b9a0f5551226265c5740b7725 /services | |
parent | 81ed74fff4e8c5938a612d01c176031878328cab (diff) | |
download | club1-docs-633475e59383a44aedd9e134d46cb0b2d18d0691.tar.gz club1-docs-633475e59383a44aedd9e134d46cb0b2d18d0691.zip |
docs: scatterd updates + enable back external links
Diffstat (limited to 'services')
-rw-r--r-- | services/email.md | 7 | ||||
-rw-r--r-- | services/ftp.md | 2 | ||||
-rw-r--r-- | services/git.md | 6 | ||||
-rw-r--r-- | services/mysql.md | 13 | ||||
-rw-r--r-- | services/rss.md | 4 | ||||
-rw-r--r-- | services/ssh.md | 10 | ||||
-rw-r--r-- | services/web.md | 14 |
7 files changed, 31 insertions, 25 deletions
diff --git a/services/email.md b/services/email.md index 2da4e2c..ea6236f 100644 --- a/services/email.md +++ b/services/email.md @@ -5,7 +5,8 @@ Chaque membre dispose d'une adresse email personnelle. Elle est composée de l'**identifiant**, suivi de `@club1.fr`. Par exemple, l'adresse de l'utilisateur `michel` est `michel@club1.fr`. -Un {term}`client web` est disponible à l'adresse <https://mail.club1.fr>. +Un {term}`client Web` fourni par [Roundcube](https://fr.wikipedia.org/wiki/Roundcube) +est disponible à l'adresse <https://mail.club1.fr>. Informations de connexion ------------------------- @@ -17,7 +18,7 @@ La connexion d'un client email à une adresse CLUB1 nécessite de configurer plu | champ | valeur | | ---------------- | --------------------- | | hôte | `mail.club1.fr` | -| port | `465` | +| port | `465` (par défaut) | | chiffrement | `SSL/TSL` (Implicite) | ### Serveur de réception (IMAP) @@ -25,5 +26,5 @@ La connexion d'un client email à une adresse CLUB1 nécessite de configurer plu | champ | valeur | | ---------------- | --------------------- | | hôte | `mail.club1.fr` | -| port | `993` | +| port | `993` (par défaut) | | chiffrement | `SSL/TSL` (Implicite) | diff --git a/services/ftp.md b/services/ftp.md index bac6fa9..1f2dc60 100644 --- a/services/ftp.md +++ b/services/ftp.md @@ -1,7 +1,7 @@ Transfert de fichiers FTPS ========================== -Bien que [ssh](ssh) puisse aussi être utilisé dans ce but, FTPS (_File Transfer +Bien que [SSH](ssh.md) puisse aussi être utilisé dans ce but, FTPS (_File Transfer Protocol Secure_) peut être utile lors du tranfert d'un grand nombre de fichiers depuis et vers le serveur CLUB1. diff --git a/services/git.md b/services/git.md index ead5453..69a4e02 100644 --- a/services/git.md +++ b/services/git.md @@ -13,7 +13,7 @@ Cette adresse permet 2 choses : 1. Cloner le dépôt Git avec `git clone` grâce au [git-http-backend](https://git-scm.com/docs/git-http-backend). 2. Consulter rapidement le dépôt et le sources dans un navigateur grâce à - l'interface web [cgit](https://git.zx2c4.com/cgit/about/). + l'interface {term}`Web` fournie par [cgit](https://git.zx2c4.com/cgit/about/). Tutoriel d'utilisation ---------------------- @@ -27,7 +27,7 @@ voulez donner au dépôt) : Dès lors, le dépôt est publié en _lecture seule_ à l'adresse `https://git.club1.fr/<login>/<repo>`, mais celui-ci est vide pour le -moment. La branche affichée par défaut dans l'interface web est `master`. +moment. La branche affichée par défaut dans l'interface {term}`Web` est `master`. Il est possible de la changer en modifiant le fichier `HEAD` du dépôt. Par exemple pour la remplacer par la branche `main` : @@ -52,10 +52,12 @@ au dépôt : git clone <login>@club1.fr:git/<repo> +```{note} Un avertissement alertera sur le fait que le dépôt ainsi cloné est vide, ce qui est normal : warning: You appear to have cloned an empty repository. +``` Il est désormais possible d'utiliser ce dépôt comme tout autre dépôt {term}`Git`, par exemple : diff --git a/services/mysql.md b/services/mysql.md index 14d19dd..03f444b 100644 --- a/services/mysql.md +++ b/services/mysql.md @@ -2,13 +2,14 @@ Bases de données MySQL ====================== Un accès à MariaDb pourra être ajouté, à partir duquel il est possible de -créer des **bases de données MySQL personnelles**. Une instance de phpMyAdmin -est disponnible à l'adresse suivante : <https://club1.fr/phpmyadmin> +créer des **bases de données MySQL personnelles**. Une interface {term}`Web` +de gestion fournie par [phpMyAdmin](https://fr.wikipedia.org/wiki/PhpMyAdmin) +est disponible à l'adresse suivante : <https://club1.fr/phpmyadmin> Informations de connexion ------------------------- -| champ | valeur | -| ---------------- | ----------- | -| hôte | `localhost` | -| port | `3306` | +| champ | valeur | +| ---------------- | ------------------- | +| hôte | `localhost` | +| port | `3306` (par défaut) | diff --git a/services/rss.md b/services/rss.md index 14ad2fc..38d58ac 100644 --- a/services/rss.md +++ b/services/rss.md @@ -3,7 +3,7 @@ Agrégateur de flux RSS Un agrégateur de flux RSS est fourni par [Tiny Tiny RSS](https://fr.wikipedia.org/wiki/Tiny_Tiny_RSS) (abbrégé TTRSS). -Il est accessible à travers le {term}`client web` intégré se trouvant à l'adresse +Il est accessible à travers le {term}`client Web` intégré se trouvant à l'adresse <https://rss.club1.fr>, mais il est également possible d'y connecter un client natif. @@ -11,7 +11,7 @@ Se connecter avec un client natif --------------------------------- Avant de pouvoir connecter un client natif, il faut activer l'{term}`API` dans -les paramètres du {term}`client web`. Cliquer sur le menu (icone avec les trois +les paramètres du {term}`client Web`. Cliquer sur le menu (icone avec les trois barres en haut à droite) → `Configuration...` → Onglet `Configuration` → Section `Général` → Cocher la case `Activer l'API`. diff --git a/services/ssh.md b/services/ssh.md index 7a80ef7..bb3004a 100644 --- a/services/ssh.md +++ b/services/ssh.md @@ -31,8 +31,10 @@ suivante : echo club1.fr ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBFQJRiEKM9iywtuvjLD7Wvp6F7VqM6ocuc0Q05LGKU6 >> ~/.ssh/known_hosts +```{tip} Si pour une quelconque raison la comparaison manuelle est préférée, l'empreinte de l'exemple ci-dessus est effectivement celle de club1.fr. +``` Créer une paire de clés de chiffrement -------------------------------------- @@ -50,7 +52,7 @@ le serveur, afin de pouvoir l'utiliser comme méthode d'authentification Informations de connexion ------------------------- -| champ | valeur | -| ---------------- | ---------- | -| hôte | `club1.fr` | -| port | `22` | +| champ | valeur | +| ---------------- | ----------------- | +| hôte | `club1.fr` | +| port | `22` (par défaut) | diff --git a/services/web.md b/services/web.md index 137c200..bf021df 100644 --- a/services/web.md +++ b/services/web.md @@ -1,17 +1,17 @@ -Sites Web -========= +Hébergement de sites Web +======================== -Il existe deux grands types de sites web : les sites _statiques_, +Il existe deux grands types de sites {term}`Web` : les sites _statiques_, constitués de fichiers dont le contenu ne change pas tant qu'ils n'ont pas été modifiés et les sites _dynamiques_, dont les fichiers sont exécutés et peuvent ainsi produire des résultats différents. -Sites web _statiques_ +Sites Web _statiques_ --------------------- L'**espace personnel** dispose d'un dossier spécial `static/` à sa racine. Tous les fichiers et dossiers rangés dedans seront automatiquement publiés -sur le web à l'adresse `https://static.club1.fr`, par exemple : +sur le {term}`Web` à l'adresse `https://static.club1.fr`, par exemple : [`https://static.club1.fr/nicolas/test.html`](https://static.club1.fr/nicolas/test.html) → `/home/nicolas/static/test.html` @@ -29,10 +29,10 @@ ligne suivante. Options -Indexes ``` -Sites web _dynamiques_ +Sites Web _dynamiques_ ---------------------- Il est possible d'ajouter à la demande des **sous-domaines** de `club1.fr` pointant vers **l'un des dossiers** présent dans votre **espace personnel** -pour ainsi créer un site web. Les noms des sous-domaines seront à définir +pour ainsi créer un site {term}`Web`. Les noms des sous-domaines seront à définir ensemble en fonction de leur disponibilité et leur viabilité. |