tetalab.org/default.fr.md at ceba8680a425c49dd61d27fc3505a0f5e5528196

mco-system ceba8680a4 doc: ajout d'un article à la page d'accueil

2024-09-16 21:20:16 +11:00

title

published

visible

taxonomy

larache

true

false

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.

Il est également essentiel de noter qu'AUCUNE pincée de poudre verte ne sera nécessaire.

Par contre, une connaissance minimale du langage de description markdown vous rendra la tâche bien plus facile.

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
Créer un nouveau répertoire dans le répertoire '01.blog'

mkdir 01.blog/ma_nouvelle_news
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:
```
---
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
Commiter votre méfait sans vergogne

git add . && git commit -m "blog: Ma nouvelle news"
Pousser sur le dépot

git push origin master
That's all folks ! Le site sera instantanément redéployé avec votre nouvelle news tout neuve.

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.
É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.
```
---
title: larache
published: true
visible: false
taxonomy:
  category:
    - "La rache"
  tag:
    - "La rache"
    - "Site du Tetalab"
    - "Yakafokon"
---
<ici le Markdown>
```
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)
```