cgpt - Démo ultime Hugo + Relearn

7) Vidéo YouTube (natif Hugo)

6) Lien interne robuste (natif Hugo)

Voir la page d’accueil : /earl/
(Utilise ref/relref pour pointer des pages du site.)


1. Badges

Performance Documentation Open-Source TipStable
InfoBrouillon
ImportantCritique

TipFonctionnel InfoRelearn ImportantTesté

Ultra rapide Idéal documentation Sans base de données

Ultra rapide Idéal documentation Sans base de données


4) Badges et Boutons

Texte avec un badge dans la phrase.

Découvrir Hugo Doc Relearn

8) Badges & Boutons (Relearn)

Texte avec un badge.
Aller sur gohugo.io

Bouton

Documentation Hugo

2. Boutons

Documentation Hugo Documentation Relearn

Un bouton simple qui pointe vers le site de Hugo :

Site Hugo

Un bouton avec icône à droite et style d’avertissement :

Doc Relearn Documentation Hugo Relearn Docs

3. Summary Box / Admonitions (Alerte, Info, Warning, Tip…)

Les notice servent à faire des encadrés de différents types (info, tip, warning, etc.).

Astuce Relearn

Tu peux utiliser les notices pour mettre en avant un avertissement, une info importante ou une astuce pédagogique.

Attention

Ce thème n’a pas de shortcode hint.
Si tu l’utilises, tu auras l’erreur : template for shortcode "hint" not found.

Info

Ceci est une boîte info. Très pratique pour attirer l’attention.

Attention

Une alerte mise en évidence pour un point critique.

Astuce

Une astuce utile dans la documentation.

Info

Ceci est un encadré de type info.

Astuce

Les notices sont parfaites pour structurer une doc.

Attention

Shortcodes non existants → erreur : hint, alert, callout, admonition.

1) Notice (boîte d’info)

Astuce

Utilise notice (et non alert). Ici on passe uniquement des paramètres nommés (style, title, icon).

Attention

Tu peux changer le style et l’icône via Font Awesome (version gratuite).

1) Bloc d’info Relearn (remplace alert)

Astuce

Ceci marche dans Relearn. alert n’existe pas ; le bon shortcode est notice.


4. Expand (contenu déroulant)

Clique pour déplier cette section

Ce bloc est caché par défaut.

Tu peux y mettre du texte, des listes, et même d’autres shortcodes (avec un minimum de bon sens pour éviter les trucs trop imbriqués).

Déployer pour voir plus

Ce contenu apparaît seulement après ouverture.
Parfait pour des notes, des références ou des explications longues.

Clique ici pour dérouler

Du contenu masqué, compatible avec Markdown.

  • listes
  • paragraphes
  • texte long

3) Section repliable (expand)

Cliquer pour dérouler
Ce contenu est repliable. Utile pour des FAQ, des détails techniques, etc.

3) Section repliable (Relearn)

Cliquer pour dérouler
Ce contenu est repliable. Pratique pour des notes ou des réponses.

5. Tabs (onglets)

Les onglets permettent de condenser plusieurs variantes du même contenu.

Même idée, plusieurs modes
Ce bloc montre un **texte simple** dans un onglet.
```bash hugo new site mon-site cd mon-site git init
Les onglets sont parfaits pour proposer plusieurs niveaux de lecture : débutant avancé expert

Hugo est un générateur de site statique extrêmement rapide.

Relearn est un thème orienté documentation, très complet.

Le duo Hugo + Relearn est l’un des plus efficaces en documentation statique.

Modes de présentation
Ceci est un texte bref présenté dans un onglet.
```bash hugo new site mon-projet git init ```
Les onglets permettent d’offrir plusieurs niveaux de lecture.

2) Onglets (tabs + tab)

Exemples de code
hugo version
hugo serve

Un onglet peut aussi contenir du Markdown.

2) Onglets (shortcode Relearn)

Exemples de code
hugo version
hugo serve

6. Figures (images avec légende)

Exemple d’image avec légende

Exemple d’image

Un bel exemple

Un bel exemple

5) Image avec légende (natif Hugo)

Logo Hugo via shortcode figure

Logo Hugo via shortcode figure


7. Callouts de Code

Voici un exemple de code highlighté par Hugo (Chroma) :

package main
import "fmt"

func main() {
    fmt.Println("Hello Hugo!")
}
1
2
3
4
function hello() {
    console.log("Hello Relearn !");
}
hello();

4) Code avec coloration (natif Hugo)

1package main
2import "fmt"
3func main(){ fmt.Println("Hello Hugo") }

8. Mermaid (diagrammes)

flowchart TD
  A[Page Hugo] --> B{Traitement Relearn}
  B --> C[Shortcodes]
  B --> D[Navigation]
  B --> E[Rendu final]
graph TD
    A[Hugo] --> B[Relearn]
    B --> C[Shortcodes]
    C --> D[Documentations avancées]

6) Mermaid (diagrammes)

flowchart TD
  A[Départ] --> B{Relearn ?}
  B -->|Oui| C[Shortcodes]
  B -->|Non| D[Built-ins Hugo]
timeline 
  title History of Social Media Platform
  2002 : LinkedIn
  2004 : Facebook
       : Google
  2005 : Youtube
  2006 : Twitter

9) Mermaid (Relearn)

flowchart TD
  A[Départ] --> B{Relearn ?}
  B -->|Oui| C[Shortcodes]
  B -->|Non| D[Built-ins Hugo]

📊 Diagramme Mermaid

graph LR  
   A[Code local] --> B{Compile Hugo}  
   B --> C[Répertoire Public]  
   C --> D[Hébergement]  
   D --> E[Visiteurs]

9. Math (KaTeX)

$$ E = mc^2 $$

$$ \int_0^{+\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $$

7) Maths (MathJax)

E = mc^2

10) Maths (Relearn)

E = mc^2

10. Détails repliables natifs HTML

Clique ici pour ouvrir

Ceci est une balise HTML native parfaitement compatible avec Relearn.

Section déroulante (expand)

Checklist pour être opérationnel rapidement
- Installer Hugo Extended - Cloner ou initialiser un dépôt Git - Ajouter le thème Relearn - Créer les premiers chapitres - Vérifier avec `hugo serve` - Déployer

10,5. Icônes

  • Succès :
  • Info :
  • Attention :

5) Icône

Icône seule (Font Awesome, version gratuite) :


11. Cards (cartes cliquables)

11,2. Cards groupées (cards)

Carte cliquable


12. Hints (encadrés pédagogiques)

MON cul


X. Arborescences : tree

  • Documentation
    • Installation
      • hugo.md
      • relearn.md
    • Déploiement
      • github-pages.md
      • vercel.md

Y. Children (pages enfant)

Si rien n’apparaît : la page n’a pas d’enfants, mais ça ne génère aucune erreur.

8) Children (liste les sous-pages)

Affiche les enfants de la page courante (donc crée des sous-pages pour voir un résultat). Sans enfants, le rendu est vide (mais aucune erreur).


13. Listes, tableaux et mise en page Hugo

Liste :

  • rapide
  • modulaire
  • sans base de données

Tableau :

Fonction Hugo Relearn
Build Ultra rapide Instantané
Style Minimal Très riche
Doc orientée Non Oui

14. Embed fichiers / ressources (page bundle)

Vous pouvez inclure images, PDF, vidéos directement dans une page bundle :

content/
  article/
    index.md
    schema.png
    document.pdf

Exemple :

test test