tetalab.org/12.larache/default.fr.md
2024-09-16 21:20:16 +11:00

114 lines
3.5 KiB
Markdown
Executable File

---
title: larache
published: true
visible: false
taxonomy:
category:
- "La rache"
tag:
- "La rache"
- "Site du Tetalab"
- "Yakafokon"
---
### [Ajouter un article à la page d'accueil](#ajouter-un-article-à-la-page-daccueil-du-site) ou une [nouvelle page au site du Tetalab](#créer-une-page-sur-le-site-du-tetalab)
#### Méthode à la rache sans poudre verte
Pour ajouter un article à la page d'accueil ou créer une page sur le site du Tetalab, il suffit d'être un arraché de [la rache](https://www.la-rache.com/).
Il est également essentiel de noter qu'**AUCUNE** pincée de [poudre verte](https://www.poudreverte.org/) ne sera nécessaire.
Par contre, une connaissance minimale du langage de description
[markdown](https://fr.wikipedia.org/wiki/Markdown#Exemples_de_la_syntaxe)
vous rendra la tâche bien plus facile.
#### Ajouter un article à la page d'accueil du site
###### C'est par où qu'on ne clique pas ?
1. Cloner le dépot git du site (Si vous avez déjà cloner le site, faites simplement un `git pull origin master`)
`git clone ssh://git@tetalab.org:2213/tetalab/tetalab.org`
2. Créer un nouveau répertoire dans le répertoire '01.blog'
`mkdir 01.blog/ma_nouvelle_news`
3. Dans ce nouveau répertoire:
a. Créer un nouveau fichier texte `item.md`
b. Éditer ce fichier et y ajouter un entête /yaml/ comme suit **avec les 3 petits tirets séparateurs avant et après l'entête**. vous pouvez prendre exemple sur les autres news:
```yaml
---
title: "Ma nouvelle news que je veux partager sur le world wide web"
date: "12:00 09-16-2024"
taxonomy:
category:
- blog
tag:
- news
- à la con
- plop
---
```
c. À la suite de l'entête, ajouter tout le blah souhaité au format *markdown*
4. *Commiter* votre méfait sans vergogne
`git add . && git commit -m "blog: Ma nouvelle news"`
5. Pousser sur le dépot
`git push origin master`
6. **That's all folks** ! Le site sera instantanément redéployé avec votre nouvelle news tout neuve.
#### Créer une page sur le site du Tetalab
###### C'est par où qu'on ne clique pas ?
1. Créer un répertoire au format `XX.aaaaa` avec `XX` un nombre entier positif sur deux octets, genre `01`, `12` ou `42` et `aaaaa` une chaîne de caractères quelconques à l'exception qu'elle ne doit contenir ni accent, ni ponctuation, ni espace, ni caractères spéciaux.
2. Éditer le fichier `default.fr.md` à l'intérieur de votre nouveau répertoire.
Ne pas hésiter à prendre exemple sur les autres répertoires pour comprendre la structure mixte *YAML* + *Markdown*. C'est pas compliqué, un enfant de 12 ans comprendra parfaitement.
```yaml
---
title: larache
published: true
visible: false
taxonomy:
category:
- "La rache"
tag:
- "La rache"
- "Site du Tetalab"
- "Yakafokon"
---
<ici le Markdown>
```
3. Dans le répertoire `/sidebar` **situé à la racine du dépôt *Git***, éditer le fichier `default.fr.md` dont le contenu représente la colonne de droite du site et y ajouter un lien vers votre nouvelle page.
Le lien doit être indiqué en *Markdown* au format `[titre du lien](chemin_du lien)` avec `chemin_du_lien` qui correspond au contenu de la balise `title` de votre page.
```
[Ajouter des pages à la rache](larache)
```
#### Public visé
- Enfants de 7 à 77 ans.
#### Prérequis
- Accès au dépôt [Git](https://git.tetalab.org/explore/repos)
- Intelligence moyenne