centora

Centora

Centora est un agrégateur en ligne de commande : il assemble plusieurs collections de slidedecks (fichiers AsciiDoc) et de thèmes CSS, provenant de dépôts locaux ou Git, et génère un site statique de présentations reveal.js prêt à publier. Il sert de brique commune à l'écosystème eTech pour construire un site de présentations à partir de sources multiples sans dupliquer la configuration.

Écrit en TypeScript (ESM, Node.js), avec une architecture hexagonale (voir le guide de contribution).

Installation

Prérequis : Node.js 22 LTS ou supérieur et npm.

Centora n'est pas encore publié sur un registre npm public à ce jour. En attendant, on l'installe en clonant ce dépôt :

git clone https://gitlab.groupeonepoint.com/etech/marketeam/centora.git
cd centora
npm install
npm run build

Une fois la publication npm effective, l'installation se fera simplement via npm install centora (ou npx centora <commande> sans installation locale).

Vous préférez ne pas installer Node.js localement, ou voulez le détail complet des prérequis et des raccourcis npm fournis ? Voir INSTALL.adoc (inclut notamment une alternative via Docker).

Première commande

Après l'installation, vérifiez que le CLI répond :

node dist/cli.js --help

Pour générer votre premier site de présentation en quelques minutes, sans connaissance préalable du projet, suivez le guide de démarrage.

Les 5 commandes

Commande	Rôle
retrieve	Copie les sources et thèmes déclarés dans playbook.yml vers un cache local
prepare	Lit chaque centora.yml et construit un manifeste agrégé
generate	Convertit les slidedecks AsciiDoc en HTML reveal.js
public	Assemble le dossier public final (HTML, thèmes, reveal.js)
build	Enchaîne les quatre étapes précédentes

Documentation complète, options et exemples : voir la référence CLI et le guide d'utilisation du CLI.

Documentation

La documentation complète (tutoriels, guides pratiques, explications, références) est publiée au format Antora dans docs/, organisée selon l'approche Diátaxis. Point d'entrée : docs/modules/ROOT/pages/index.adoc.

Contribuer

Vous voulez ajouter une commande, corriger un bug ou lancer les tests ? Le guide de contribution explique l'architecture hexagonale du projet, comment ajouter une commande CLI, lancer les tests, et les conventions de commits/branches à respecter.

Licence

Centora est distribué sous licence GPL v3.0 ou ultérieure (GPL-3.0-or-later). C'est le seul composant de l'écosystème eTech sous cette licence, en raison de sa vocation à être publié sur un registre npm public.