aboutsummaryrefslogtreecommitdiff
path: root/content/prise_en_main
diff options
context:
space:
mode:
authorQuentin Dufour <quentin@deuxfleurs.fr>2023-03-02 13:11:08 +0100
committerQuentin Dufour <quentin@deuxfleurs.fr>2023-03-02 13:11:08 +0100
commit0c1783e6c69a130b500e6c9452f800562b7e5fd2 (patch)
treecd72b13b9fbb0f7060d115d2f7149d4037234837 /content/prise_en_main
parent636dc8925a6a4e423fd1daa0e34a58e8182a45d0 (diff)
downloadguide.deuxfleurs.fr-0c1783e6c69a130b500e6c9452f800562b7e5fd2.tar.gz
guide.deuxfleurs.fr-0c1783e6c69a130b500e6c9452f800562b7e5fd2.zip
fix links
Diffstat (limited to 'content/prise_en_main')
-rw-r--r--content/prise_en_main/avec-un-générateur.md16
-rw-r--r--content/prise_en_main/aws-cli.md2
-rw-r--r--content/prise_en_main/creer-du-contenu.md2
-rw-r--r--content/prise_en_main/initialiser-votre-accès.md2
-rw-r--r--content/prise_en_main/mettre-place-DNS.md2
-rw-r--r--content/prise_en_main/publier-le-contenu.md8
-rw-r--r--content/prise_en_main/web.md13
-rw-r--r--content/prise_en_main/à-la-main.md2
8 files changed, 24 insertions, 23 deletions
diff --git a/content/prise_en_main/avec-un-générateur.md b/content/prise_en_main/avec-un-générateur.md
index 24a5efd..f71c4ff 100644
--- a/content/prise_en_main/avec-un-générateur.md
+++ b/content/prise_en_main/avec-un-générateur.md
@@ -13,7 +13,7 @@ Si vous souhaitez par exemple écrire un blog, vous allez probablement avoir une
### Choisir un générateur et un thème
Il existe de nombreux générateurs de sites statiques. On peut citer [Hugo](https://gohugo.io/), [Jekyll](https://jekyllrb.com/), [Zola](https://www.getzola.org/), et bien d'autres... En général, ils se ressemblent beaucoup. À titre indicatif, pour ce guide, nous utilisons Zola. Nous baserons nos exemples sur lui. Si votre système d'exploitation est Linux, cherchez dans votre gestionnaire de paquet si vous trouvez l'un d'entre eux. Zola est ainsi facilement installable sur Arch, Ubuntu, et Fedora.
-Une fois un générateur de site statique installé, rendez-vous sur le site officiel de celui-ci pour choisir un thème. Chez Zola, il faut aller [ici](https://www.getzola.org/themes/). Si vous cliquez sur l'un d'entre eux, vous aurez des instructions sur comment l'installer. Il s'agit souvent de télécharger le thème dans le dossier correspondant à votre site, et de modifier le fichier `config.toml`, nécessaire pour Zola, afin de sélectionner le thème.
+Une fois un générateur de site statique installé, rendez-vous sur le site officiel de celui-ci pour choisir un thème. Chez Zola, il faut aller [sur leur galerie](https://www.getzola.org/themes/). Si vous cliquez sur l'un d'entre eux, vous aurez des instructions sur comment l'installer. Il s'agit souvent de télécharger le thème dans le dossier correspondant à votre site, et de modifier le fichier `config.toml`, nécessaire pour Zola, afin de sélectionner le thème.
### Décrire le contenu
Pour écrire le contenu de vos pages, ou de vos billets de blog par exemple, il vous faudra utiliser la syntaxe Markdown. Rassurez-vous, elle a été pensée pour être très simple et peut-être apprise en quelques minutes. Voici un exemple :
@@ -31,15 +31,15 @@ Voici du texte pour introduire la liste à puce qui va suivre :
```
Quand on écrit du texte sans mettre quoi que ce soit autour ou avant, cela deviendra du texte tout à fait normal. On peut mettre un ou plusieurs dièses au début de la ligne pour en faire un titre. On peut mettre du texte en italique ou en gras avec des astérisques. Un astérisque en début de ligne provoque une liste à puces. Bref, cette syntaxe n'est pas compliquée, et vous pouvez facilement trouver plein de tutoriels en ligne pour la connaître. [Framasoft, par exemple, propose un bon guide](https://docs.framasoft.org/fr/grav/markdown.html).
-Une fois votre fichier écrit, enregistrez-le avec l'extension `.md`, par exemple sous le nom `recette-tartre-au-citron.md`. L'idée est qu'à chaque page de votre site correspond un fichier `.md`, et ceux-ci seront regroupés dans un dossier. Vous trouverez [ici](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/src/branch/main/content) les fichiers Markdown écrits pour faire ce guide.
+Une fois votre fichier écrit, enregistrez-le avec l'extension `.md`, par exemple sous le nom `recette-tartre-au-citron.md`. L'idée est qu'à chaque page de votre site correspond un fichier `.md`, et ceux-ci seront regroupés dans un dossier. Vous trouverez [dans notre forge](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/src/branch/main/content) les fichiers Markdown écrits pour faire ce guide.
Cependant, il reste juste une petite chose à faire lorsque vous avez fini votre texte : écrire l'en-tête au dessus du markdown, qui donnera au générateur des informations importantes sur ce contenu. On encadre cet en-têtre avec trois signes plus. Voici un exemple basé sur cette page :
```
-+++
-title = "Avec un générateur"
-description = "Créer du contenu avec un générateur"
-date = 2022-09-01
-+++
+---
+title: "Avec un générateur"
+description: "Créer du contenu avec un générateur"
+date: 2022-09-01
+---
# Titre
Texte de la page...
@@ -47,4 +47,4 @@ Texte de la page...
Comme vous l'avez peut-être compris, il s'agit de donner le titre de cette page, sa description, et sa date d'écriture. D'autres informations peuvent être rajoutées, cela dépend du générateur et du thème sélectionnés.
### Générer les pages
-Vous avez donc des fichiers `.md` renfermant vos contenus, et un thème qui vous plaît. Avec un terminal, positionnez-vous dans le dossier racine de votre site projet. Si vous utilisez Zola, celui-ci devrait contenir un fichier `config.toml`, vous pouvez alors faire `zola build`. Cela va générer l'intégralité de votre site dans le dossier `public/`. Vous constaterez donc qu'il sera rempli de fichiers `.html` et `.css`, [vous êtes alors prêt(e) à passer à la publication](../../publier-le-contenu/) !
+Vous avez donc des fichiers `.md` renfermant vos contenus, et un thème qui vous plaît. Avec un terminal, positionnez-vous dans le dossier racine de votre site projet. Si vous utilisez Zola, celui-ci devrait contenir un fichier `config.toml`, vous pouvez alors faire `zola build`. Cela va générer l'intégralité de votre site dans le dossier `public/`. Vous constaterez donc qu'il sera rempli de fichiers `.html` et `.css`, [vous êtes alors prêt(e) à passer à la publication](@/prise_en_main/publier-le-contenu.md) !
diff --git a/content/prise_en_main/aws-cli.md b/content/prise_en_main/aws-cli.md
index c801b5a..63a4c89 100644
--- a/content/prise_en_main/aws-cli.md
+++ b/content/prise_en_main/aws-cli.md
@@ -7,7 +7,7 @@ extra:
parent: "prise_en_main/publier-le-contenu.md"
---
-Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)».
+Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)».
### Paramétrer votre accès localement
Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir :
diff --git a/content/prise_en_main/creer-du-contenu.md b/content/prise_en_main/creer-du-contenu.md
index 149d74c..49b1841 100644
--- a/content/prise_en_main/creer-du-contenu.md
+++ b/content/prise_en_main/creer-du-contenu.md
@@ -10,4 +10,4 @@ extra:
Votre site est désormais complètement configuré. Avant de publier du contenu, il faut écrire celui-ci !
-Vous pouvez, au choix, [l'écrire à la main](./a-la-main/), ou vous [faire assister par un générateur](./avec-un-generateur/).
+Vous pouvez, au choix, [l'écrire à la main](@/prise_en_main/à-la-main.md), ou vous [faire assister par un générateur](@/prise_en_main/avec-un-générateur.md).
diff --git a/content/prise_en_main/initialiser-votre-accès.md b/content/prise_en_main/initialiser-votre-accès.md
index 5782306..819e0e4 100644
--- a/content/prise_en_main/initialiser-votre-accès.md
+++ b/content/prise_en_main/initialiser-votre-accès.md
@@ -31,4 +31,4 @@ Si `exemple-un.fr` n'est pas à gauche dans la même colonne que `exemple-deux.e
exemple-un.fr 4bdce6:exemple-un.fr 56a0f10929f0d63d0177415a22a0b636cf1efe92845f2b00e04b91298656e78e
exemple-deux.eu 941956ebfffa8fd564ad6b40e4bb5ac2f2b93bdbba1d1bf88fe6daff2cf4df6c
```
-C'est réglé. [Vous pouvez désormais vous occuper du DNS](../mettre-place-dns/).
+C'est réglé. [Vous pouvez désormais vous occuper du DNS](@/prise_en_main/mettre-place-DNS.md).
diff --git a/content/prise_en_main/mettre-place-DNS.md b/content/prise_en_main/mettre-place-DNS.md
index 5e396a2..b125d4c 100644
--- a/content/prise_en_main/mettre-place-DNS.md
+++ b/content/prise_en_main/mettre-place-DNS.md
@@ -35,4 +35,4 @@ Choisissez alors «ALIAS» comme type, et `garage.deuxfleurs.fr` comme nom d'hô
![dns5.png](/img/dns5.png)
-Maintenant que votre configuration DNS est réglée, vous pouvez [préparer votre contenu](../créer-du-contenu/) !
+Maintenant que votre configuration DNS est réglée, vous pouvez [préparer votre contenu](@/prise_en_main/creer-du-contenu.md) !
diff --git a/content/prise_en_main/publier-le-contenu.md b/content/prise_en_main/publier-le-contenu.md
index 48d1416..b58c2e7 100644
--- a/content/prise_en_main/publier-le-contenu.md
+++ b/content/prise_en_main/publier-le-contenu.md
@@ -8,12 +8,12 @@ extra:
parent: "prise_en_main/web.md"
---
-Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)».
+Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)».
Vous avez le choix entre trois méthodes :
-* [Faire ça en ligne de commande avec `aws-cli`](aws-cli/). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci.
-* [Faire ça avec l'utilitaire graphique `rclone`](rclone/). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et MacOS.
-* [Faire ça avec l'utilitaire graphique `winscp`](winscp/). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows.
+* [Faire ça en ligne de commande avec `aws-cli`](@/prise_en_main/aws-cli.md). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci.
+* [Faire ça avec l'utilitaire graphique `rclone`](@/prise_en_main/rclone.md). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et MacOS.
+* [Faire ça avec l'utilitaire graphique `winscp`](@/prise_en_main/winscp.md). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows.
### Bravo !
Une fois l'un de ces trois guides suivi, vous aurez désormais votre propre site web accessible publiquement en ligne !
diff --git a/content/prise_en_main/web.md b/content/prise_en_main/web.md
index ecac65c..ca8fc2b 100644
--- a/content/prise_en_main/web.md
+++ b/content/prise_en_main/web.md
@@ -9,18 +9,19 @@ extra:
Vous en avez marre de faire toute votre communication associative via Facebook ? Vous voulez créer votre propre site pour raconter vos dernières vacances ou publier vos poèmes ? Bref, publier en indépendance ? Deuxfleurs peut vous aider en vous fournissant l'hébergement. Suivez le guide !
-1. [Statique ? Comment ça ?](./statique-comment-ca/)
-2. [Initialiser votre accès](./initialiser-votre-acces/)
-3. [Mettre en place le DNS](./mettre-place-dns/)
-4. [Créer du contenu](./créer-du-contenu/)
-5. [Publier le contenu](./publier-le-contenu/)
+1. [Statique ? Comment ça ?](@/prise_en_main/statique-comment-ça.md)
+2. [Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)
+3. [Mettre en place le DNS](@/prise_en_main/mettre-place-DNS.md)
+4. [Créer du contenu](@/prise_en_main/creer-du-contenu.md)
+5. [Publier le contenu](@/prise_en_main/publier-le-contenu.md)
# Ils nous font confiance pour leur site web
+ - [declic-lelivre.com](https://declic-lelivre.com) - *Exploitation des données privées, surveillance généralisée, addiction au smartphone, disparition de pans entiers de l'économie... Les critiques du monde du numérique ne cessent de s'amplifier ; difficile d'ignorer les conséquences de l'utilisation d'Amazon, Facebook, Google, Instagram ou Netflix. Et s'il existait un autre Internet, respectueux de nos libertés ?*
+ - [giraud.eu](https://giraud.eu) - *Site d'un ingénieur en informatique*
- [anneprudhomoz.fr](https://anneprudhomoz.fr) - *De la terre, du fer, de l'eau, beaucoup de feu, un peu d'huile, encore du béton et du plâtre ! ... sans oublier le crayon à papier et les carnets.*
- [colineaubert.com](https://colineaubert.com) - *D'un côté graphiste, illustratrice et conceptrice d'outils pédagogiques, je mets en images et en mots différents sujets scientifiques et culturels.*
- [estherbouquet.com](https://estherbouquet.com) - *Esther Bouquet questions how narratives—both historical and literary—are being built by creating tangible experiences ranging from the size of the sheet of paper to the volume of a space; somewhere between writing, archiving, drawing, designing, and programming.*
- [quentin.dufour.io](https://quentin.dufour.io) - *Portfolio et blog d'un ingénieur en informatique*
- [erwan.dufour.io](https://erwan.dufour.io) - *Portfolio et blog d'un passionné d'électronique*
- [rfid.deuxfleurs.fr](https://rfid.deuxfleurs.fr) - *Rencontres Francophones de l'Infonuagique Décentralisé*
- - [giraud.eu](https://giraud.eu) - *Site d'un ingénieur en informatique*
diff --git a/content/prise_en_main/à-la-main.md b/content/prise_en_main/à-la-main.md
index ee1eb45..bc4c3ad 100644
--- a/content/prise_en_main/à-la-main.md
+++ b/content/prise_en_main/à-la-main.md
@@ -38,4 +38,4 @@ body
```
Encore une fois, plein de ressources sont disponibles en ligne, et Mozilla propose encore une fois [une bonne base](https://developer.mozilla.org/fr/docs/Web/CSS).
-Une fois que vous avez tous vos fichiers `.html` et `.css` réunis, [vous pouvez passer à la publication](../../publier-le-contenu/) !
+Une fois que vous avez tous vos fichiers `.html` et `.css` réunis, [vous pouvez passer à la publication](@/prise_en_main/publier-le-contenu.md) !