From 9d69f2e8b67aaa246b4d4bc8e541d67d0342ca9e Mon Sep 17 00:00:00 2001 From: vincent Date: Wed, 31 Aug 2022 23:39:19 +0200 Subject: =?UTF-8?q?D=C3=A9but=20r=C3=A9organisation=20et=20explication=20s?= =?UTF-8?q?ite=20statique?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 "content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" (limited to 'content/prise_en_main/web/créer-du-contenu/avec-un-générateur.md') diff --git "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" new file mode 100644 index 0000000..e904b98 --- /dev/null +++ "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" @@ -0,0 +1,7 @@ +--- +title: Avec un générateur +description: Créer du contenu avec un générateur +sort_by: weight +date: 2022-09-01 +weight: 2 +--- \ No newline at end of file -- cgit v1.2.3 From 54027bc89f2d84e4656a22fc78102c7b89874f29 Mon Sep 17 00:00:00 2001 From: vincent Date: Sun, 2 Oct 2022 19:37:50 +0200 Subject: =?UTF-8?q?Explication=20=C3=A9criture=20de=20page=20=C3=A0=20la?= =?UTF-8?q?=20main?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../avec-un-g\303\251n\303\251rateur.md" | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'content/prise_en_main/web/créer-du-contenu/avec-un-générateur.md') diff --git "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" index e904b98..1fa39a0 100644 --- "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" +++ "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" @@ -1,7 +1,7 @@ ---- -title: Avec un générateur -description: Créer du contenu avec un générateur -sort_by: weight -date: 2022-09-01 -weight: 2 ---- \ No newline at end of file ++++ +title = "Avec un générateur" +description = "Créer du contenu avec un générateur" +sort_by = "weight" +date = 2022-09-01 +weight = 2 ++++ \ No newline at end of file -- cgit v1.2.3 From 43c5d05edf9264765f470ad4171a5e217bb65ea3 Mon Sep 17 00:00:00 2001 From: vincent Date: Fri, 21 Oct 2022 21:47:24 +0200 Subject: =?UTF-8?q?D=C3=A9but=20de=20cr=C3=A9ation=20du=20contenu=20avec?= =?UTF-8?q?=20un=20g=C3=A9n=C3=A9rateur?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'content/prise_en_main/web/créer-du-contenu/avec-un-générateur.md') diff --git "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" index 1fa39a0..9e198c3 100644 --- "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" +++ "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" @@ -4,4 +4,6 @@ description = "Créer du contenu avec un générateur" sort_by = "weight" date = 2022-09-01 weight = 2 -+++ \ No newline at end of file ++++ + +Si vous souhaitez par exemple écrire un blog, vous allez probablement avoir une page par post. À la longue, on peut sans problème arriver à des dizaines de pages... Si on les écrit à la main, il va falloir copier/coller une bonne partie du code HTML, mais pas tout. Pour éviter ce travail rébarbatif, \ No newline at end of file -- cgit v1.2.3 From 954bab8d02e5bc3ab08c6c312a5c275cf8aa52c0 Mon Sep 17 00:00:00 2001 From: vincent Date: Thu, 1 Dec 2022 00:21:47 +0100 Subject: =?UTF-8?q?=C3=89crire=20du=20contenu=20avec=20un=20g=C3=A9n=C3=A9?= =?UTF-8?q?rateur=20de=20sites=20statiques?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../avec-un-g\303\251n\303\251rateur.md" | 41 +++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) (limited to 'content/prise_en_main/web/créer-du-contenu/avec-un-générateur.md') diff --git "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" index 9e198c3..7bf57e0 100644 --- "a/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" +++ "b/content/prise_en_main/web/cr\303\251er-du-contenu/avec-un-g\303\251n\303\251rateur.md" @@ -6,4 +6,43 @@ date = 2022-09-01 weight = 2 +++ -Si vous souhaitez par exemple écrire un blog, vous allez probablement avoir une page par post. À la longue, on peut sans problème arriver à des dizaines de pages... Si on les écrit à la main, il va falloir copier/coller une bonne partie du code HTML, mais pas tout. Pour éviter ce travail rébarbatif, \ No newline at end of file +Si vous souhaitez par exemple écrire un blog, vous allez probablement avoir une page par post. À la longue, on peut sans problème arriver à des dizaines de pages... Si on les écrit à la main, il va falloir copier/coller une bonne partie du code HTML, mais pas tout. Pour éviter ce travail rébarbatif, il existe ce qu'on appelle des générateurs de sites statiques. Ils vous permettent d'écrire dans une syntaxe très simple (Markdown) vos contenus, sans vous soucier du HTML ou du CSS, car ils emballeront eux-mêmes vos écrits dans des modèles prévus à cet effet. [Le guide que vous êtes en train de lire en ce moment même utilise un tel outil !](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr) + +### 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. + +### 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 : +``` +# Ceci est le titre principal +## Ceci est un sous-titre +Ceci est du texte tout à fait normal. *Cette partie-ci du texte sera en italique*. **Cette partie-là sera en gras**. + +## Ceci est encore un sous-titre +### Ceci est un sous-sous-titre +Voici du texte pour introduire la liste à puce qui va suivre : +* première élément de la liste +* second élément de la liste +* troisième élément de la liste +``` +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. + +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 ++++ + +# Titre +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/) ! -- cgit v1.2.3