larache

Ajouter un article à la page d'accueil ou une nouvelle page au 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.

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.

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à cloné 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'. Si il s'agit d'un évènement récurrent, il est bien vu d'inclure la date (au format iso8601) dans le nom du répertoire.

    mkdir 01.blog/ma_nouvelle_news

ou

`mkdir 01.blog/apero_20241219`

  1. 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

  2. Commiter votre méfait sans vergogne

    git add . && git commit -m "blog: Ma nouvelle news"

  3. Pousser sur le dépot

    git push origin master

  4. 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.

    ---
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é

Prérequis