Pour les aspects techniques

Oops 404

Du plus dur... <<<<

>>>> Au plus simple

Parfois il vaut mieux commencer par la fin 👇

sysAdmin

OQP-AFK

Il faut demander à un autre vieux blanc barbu bien nippé ?

Non mais sans déconner !

Va voir le vocabulaire · Attention c'est pas dans l'ordre

Non mais sans déconner !

Ouais, c'est chaud

Parfait ! Voici un pas-à-pas simple et grand public pour créer un site web en quelques clics grâce à GitHub et GitHub Pages, en utilisant ton modèle bxl2042, suivi d’un mini lexique ultra-accessible pour les termes GitHub indispensables.

🟢 Étape 1 : Créer un compte GitHub (si ce n’est pas déjà fait)

  1. Va sur https://github.com
  2. Clique sur Sign up (en haut à droite)
  3. Choisis un nom d’utilisateur (ça apparaîtra dans l’adresse de ton site)
  4. Donne une adresse e‑mail valide, choisis un mot de passe
  5. Valide ton compte par e‑mail

🟦 Étape 2 : Créer ton site avec le modèle bxl2042

  1. Ouvre https://github.com/ouaisfieu/bxl2042
  2. Clique sur le bouton vert “Use this template”
  3. Choisis “Create a new repository”
  4. Donne un nom à ton site (ex. : mon-super-site)
  5. Clique sur “Create repository from template”

Bravo 🎉 tu viens de créer une copie du site prête à être personnalisée.

🟣 Étape 3 : Activer ton site avec GitHub Pages

  1. Dans ton dépôt fraîchement créé, clique sur Settings (⚙️, tout en haut à droite)
  2. Dans la colonne de gauche, descends jusqu’à Pages (ou cherche “Pages” dans la barre)
  3. Dans “Source”, choisis Branch : main et / (root) juste en dessous
  4. Clique sur Save

💡 Ton site sera disponible à une adresse comme :

https://ton-nom-utilisateur.github.io/mon-super-site

Cela peut prendre 30 à 60 secondes pour apparaître.

🟡 Étape 4 : Modifier ton site

  1. Depuis le dépôt, clique sur un fichier .md (par exemple index.md)
  2. Clique sur le petit crayon ✏️ pour l’éditer
  3. Modifie le texte (tu peux taper comme dans un e‑mail)
  4. Descends et clique sur Commit changes pour enregistrer

Ton site est automatiquement mis à jour 💥

🧾 Lexique simplifié

Terme GitHub Traduction simple Pourquoi c’est utile
Repository (ou repo) Projet ou dossier en ligne Contient ton site, ton code, tes fichiers
Markdown (.md) Fichier texte amélioré Tu écris des titres, listes, liens très simplement
Commit Enregistrement de changement Sauvegarde d’une modification
Push Envoi vers GitHub Automatique ici : tu modifies → c’est en ligne
Branch Version parallèle Par défaut on utilise main (la principale)
Pages Hébergement de site statique C’est ce qui affiche ton site web
Template Modèle de projet prêt à l’emploi Comme bxl2042, tu copies et personnalises
Release Version “officielle” d’un projet Pas utile ici, mais si tu livres une appli ou un PDF, tu peux faire une release avec fichier à télécharger
Package Lot de fichiers prêts à installer Utilisé pour des applis ou bibliothèques, pas nécessaire pour un site vitrine

💡 En résumé

Étapes Ce que tu fais
✅ Créer un compte GitHub Tu ouvres ton espace perso
✅ Copier un modèle de site En 2 clics avec “Use this template”
✅ Activer GitHub Pages Pour mettre ton site en ligne
✅ Modifier les fichiers .md Pour personnaliser le contenu
✅ Partager le lien de ton site Et montrer ton travail au monde ! 🌍

💡 Vocabulaire simple

Terme Explication simple
Jekyll Outil qui transforme des fichiers Markdown en pages web
GitHub Pages Service gratuit d’hébergement de sites web
Theme Apparence du site (couleurs, police, mise en page)
Markdown (.md) Format de texte facile à lire et écrire
README.md Page d’accueil par défaut d’un dépôt
index.md Page d’accueil d’un site web
commit Enregistrement d’une modification
repository (repo) Le dossier de ton projet sur GitHub

🧺 Résumé ultra-simple

Étape Ce que tu fais
👤 Créer un compte GitHub Pour avoir un espace personnel
🗂 Créer un dépôt ton-pseudo.github.io GitHub le reconnaît comme un site
🎨 Choisir un thème Jekyll Pour avoir une belle apparence
✏️ Modifier les fichiers Markdown Pour écrire ton contenu
🌍 Publier automatiquement Ton site est en ligne à chaque sauvegarde

Souhaites-tu que je t’en fasse une version .md prête à publier, ou un petit kit de site Jekyll personnalisé avec un design léger et déjà configuré pour GitHub Pages ?

Oui !

Non quand même, il faut pas pousser

Voici un exemple ultra-simple de fichier _config.yml pour un site Jekyll hébergé sur GitHub Pages. Ce fichier permet de personnaliser ton site (titre, thème, lien, etc.). Tu peux le placer directement à la racine de ton dépôt.

# _config.yml — configuration de base pour Jekyll + GitHub Pages

title: Mon Super Site
description: Un site simple fait avec Jekyll et GitHub Pages
author: Ton Nom
email: ton.email@example.com
url: "https://ton-pseudo.github.io"  # Ne mets pas de slash final
baseurl: ""                          # Laisser vide pour un site perso (ton-pseudo.github.io)

theme: minima                        # Thème officiel par défaut

markdown: kramdown
permalink: pretty

# Réglages optionnels
show_excerpts: true                 # Montre un extrait des articles sur la page d'accueil
paginate: 5                         # Nombre d’articles par page si tu actives la pagination

# Répertoires à exclure
exclude:
  - Gemfile
  - Gemfile.lock
  - node_modules
  - vendor

# Plugins activés (optionnel mais utile si tu ajoutes des fonctionnalités)
plugins:
  - jekyll-feed
  - jekyll-seo-tag

👉 Ce fichier :

  • fonctionne directement avec GitHub Pages
  • utilise le thème minima (automatiquement pris en charge)
  • te donne une base solide pour blog ou site vitrine

Sinon, pour ça on fait comment ?

⬆️