EN·QUOI ? j'ai une cheatsheet de jargon de développeur informatique mais ça ne suffit pas, quand ils parlent entre eux je ne pige rien. Il y a de l'argot de geek en plus du jargon ??
Bonne question ! Oui, il y a deux couches qui se superposent quand “les devs parlent” :
Voici un guide pratique pour comprendre et parler “geek” sans (trop) forcer.
Passer cette parenthèse ?
monospace
: prod
, API
, null
, main
, git push
./s
(sarcasme), “nit:” (micro-remarque), “PTAL” (please take a look).Astuce : dans une revue de code, commencer une remarque non bloquante par “nit:” (petit détail).
feature/…
et j’ouvre une PR, PTAL.”prod
: rollback + hotfix, postmortem demain.”nginx
se prononce engine‑x.”Décodage :
“WIP, PR ouverte. Tests rouges (flaky). PTAL, nit welcome. LGTM → squash & merge, canary en fin de journée.” Traduction : travail en cours, demande de revue ouverte, quelques tests instables échouent, merci de regarder, remarques mineures bienvenues, si c’est ok on fusionne en compactant l’historique et on déploie progressivement ce soir.
Production d’une phrase : “FYI, j’ai mis la nouvelle page blog derrière un feature flag. Si c’est ok pour toi, je l’active à 10 % demain, et on élargit si pas de heisenbug.”
Si tu veux, je peux te générer une fiche recto A4 (ou un petit jeu d’Anki) avec 50 termes clés + exemples en français. Dis‑moi si tu préfères dev général, web, ou ops, et je te le prépare.
Et si tu entends une phrase précise qui te perd, copie‑la ici : je te ferai la traduction mot‑à‑mot + la version “à répondre comme un·e pro”.
Allez, on bosse vraiment ?
Parfait — voici un guide de prise en main “grand public” (clair, concret, pas infantilisant) pour publier ta propre bibliothèque de contenus avec ouaisfi·eu · Magasin de fichiers.
Un site statique (une page badges.html
qui lit un manifest.json
) pour présenter tous tes fichiers (PDF, images, vidéos, audio, ZIP, notes Markdown, démos/scripts…) avec :
Tu remplis un fichier JSON → la page s’occupe du reste. Objectif : publier vite, sans serveur, sans CMS, reproductible.
Tu as besoin au minimum de :
badges.html
(la page),manifest.json
(ta liste d’items),css/fx.css
(effets facultatifs — recommandé de le charger, même si tu ne l’utilises pas tout de suite).Astuce : utilise le pack que nous avons préparé. Si tu ne l’as plus sous la main, je te le renvoie.
Ne double‑clique pas sur
badges.html
(contextefile://
→fetch
est bloqué).
Avec Python 3 :
python -m http.server 8080
Ouvre ensuite : http://localhost:8080/badges.html
(ou npx serve .
avec Node, ou l’extension Live Server de VS Code)
Tu dois voir l’interface, la barre de recherche, et — si ton manifest.json
contient des items — des cartes déjà visibles.
/ton-site/
├─ badges.html # page principale
├─ manifest.json # ta bibliothèque
├─ /thumbs/ # vignettes 16:9 (~640×360)
├─ /pdfs/ # pdf
├─ /images/ # images
├─ /videos/ # vidéos
├─ /audio/ # audio
├─ /zips/ # archives .zip
├─ /md/ # notes/Docs Markdown
├─ /scripts/ # démos ou apps html/js à "Exécuter"
└─ /css/fx.css # effets facultatifs
Tu peux renommer, mais garde la cohérence des chemins dans le JSON.
manifest.json
Le manifest contient un tableau d’items. Édite‑le à la main (c’est simple), ou génère une base puis tu complètes.
{
"items": [
{
"id": "rapport-2024",
"title": "Rapport 2024",
"url": "./pdfs/rapport-2024.pdf",
"type": "pdf",
"tags": ["doc","rapport"],
"created": "2025-07-30"
}
]
}
type
peut être déduit par l’extension (.png
,.mp4
,.zip
,.md
, …). Tu peux l’indiquer explicitement si tu préfères.
{
"items": [
{
"id": "rapport-2024",
"title": "Rapport 2024",
"description": "Bilan annuel en PDF.",
"thumb": "./thumbs/rapport-2024.jpg",
"url": "./pdfs/rapport-2024.pdf",
"type": "pdf",
"tags": ["doc","rapport"],
"created": "2025-07-30",
"badges": ["pdf", "star"]
}
]
}
Vignettes : 16:9, \~640×360, 50–100 Ko (JPEG/WebP). Si
thumb
est absent, une icône remplace.
info
→ page qui explique (article, doc, fiche).
↳ bouton “Plus d’info”
url
→ le fichier principal (ce qu’on veut voir/télécharger).
↳ Aperçu (si prévisualisable) / Télécharger (si fichier) / Ouvrir (si page)
run
→ démo/app à exécuter (souvent une page .html
).
↳ “Exécuter ▶” (si HTML) ou “Voir la ressource” (sinon)
Anti‑doublon : si info === url
, le bouton Ouvrir est masqué (on garde “Plus d’info”).
info
.url
.run
.Tu choisis lesquels afficher, rien n’est automatique.
Exemples utiles : ["pdf"]
, ["md","edu"]
, ["video","star"]
, ["zip","free"]
.
Tu peux aussi créer un badge custom :
"badges": [{ "variant": "custom", "label": "Promo", "emoji": "💸", "color": "#ffcf33" }]
Pour surligner une description ponctuellement, sans HTML :
"descFx": ["highlight-lilac"]
Autres : neon-mint
, neon-lilac
(+ flicker
), gradient-mint
, glitch
(+ glitch-anim
), crt
, etc.
Assure‑toi que fx.css
est chargé dans badges.html
:
<link rel="stylesheet" href="./css/fx.css">
git push
.https://ton-user.github.io/ton-repo/
.Chemins : sur un projet GitHub Pages, préfère des chemins relatifs (./pdfs/fichier.pdf
) plutôt que /pdfs/fichier.pdf
(absolu), sauf si ton site est à la racine du domaine.
Dépose le dossier ou connecte le repo → build statique. Ça marche tel quel.
id
(= slug), title
descriptif, tags
utiles (2–5 max).“Impossible de charger manifest.json”
→ Tu as ouvert la page en file://
. Lance un petit serveur local (voir §3B).
Les chemins cassent sur GitHub Pages
→ Utilise des chemins relatifs (./pdfs/...
) si ton site est dans un sous-dossier.
→ Ou définis <base href="/ton-repo/">
dans <head>
(option avancée).
Télécharger ouvre un nouvel onglet → Fichier cross‑origin (autre domaine) ou URL pointe vers une page. → Sers le fichier au même domaine si tu veux forcer “Télécharger”.
Rien dans la grille
→ Ton manifest.json
est vide ou invalide. Ouvre scripts/validate.html
, colle ton JSON, corrige les erreurs.
thumb
, badges
, descFx
).scripts/editor.html
(formulaire → JSON).info === url
.http://
, pas file://
.{
"id": "rapport-2024",
"title": "Rapport 2024",
"description": "Bilan annuel.",
"thumb": "./thumbs/rapport-2024.jpg",
"url": "./pdfs/rapport-2024.pdf",
"type": "pdf",
"tags": ["doc","rapport"],
"created": "2025-07-30",
"badges": ["pdf"]
}
{
"id": "snake-demo",
"title": "Snake (JS) — démo jouable",
"description": "Petit jeu HTML/JS ; sources en ZIP.",
"thumb": "./thumbs/snake.jpg",
"info": "https://exemple.tld/projets/snake",
"run": "./scripts/snake.html",
"url": "./zips/snake-src.zip",
"type": "script",
"tags": ["script","demo","jeu"],
"created": "2025-04-05",
"badges": ["script","star"]
}
{
"id": "guide-outils-libres",
"title": "Guide — Outils libres",
"description": "Panorama des outils essentiels.",
"thumb": "./thumbs/guide-outils.jpg",
"url": "./md/guide-outils.md",
"type": "md",
"tags": ["md","guide","libre"],
"created": "2025-03-14",
"badges": ["md","edu"],
"descFx": ["highlight-lilac"]
}
/md/
(et l’item associé à coller dans ton manifest.json
) ?Je te fournis le fichier /md/prise-en-main.md
+ l’item :
{
"id": "prise-en-main",
"title": "Prise en main du magasin (guide rapide)",
"description": "Installer, structurer, écrire son manifest et publier — sans CMS.",
"thumb": "./thumbs/guide-biblio.svg",
"url": "./md/prise-en-main.md",
"type": "md",
"tags": ["doc","guide","start"],
"created": "2025-07-30",
"badges": ["md","tip"]
}