Installation et votre premier site
Installez M-Press et générez un site de documentation en quelques commandes.
M-Press nécessite uniquement mpress l’exécutable au moment de l’exécution.
Compiler depuis les sources
Avant la publication des binaires de version empaquetés, installez depuis le module Go :
go install github.com/leaanthony/mpress/cmd/mpress@latest
Vous pouvez aussi construire un checkout du dépôt :
git clone https://github.com/leaanthony/mpress.git
cd mpress
go build -o mpress ./cmd/mpress
Créer un site
mpress init my-docs
cd my-docs
mpress dev
Ouvrez http://localhost:3000. Le starter contient :
- my-docs
- mpress.yamlConfiguration du site
- content
- index.mdPage d'accueil
- staticImages et autres fichiers statiques
Éditez content/index.md et enregistrez-le. Le serveur de développement reconstruit le site
et rafraîchit les onglets de navigateur connectés.
Générer pour la publication
mpress build --strict
mpress check
--strict rejette les routes en double, les composants non pris en charge et d’autres
diagnostics. mpress check vérifie les liens locaux, les fragments, les images, les scripts,
et les feuilles de style dans le HTML généré.
Le répertoire de sortie par défaut est site/. Il peut être servi directement :
python3 -m http.server --directory site 8000
Utiliser M-Press dans un checkout Go existant
M-Press utilise lui-même cette approche. Placez mpress.yaml à la racine du dépôt,
définissez build.contentDir sur votre répertoire de documentation, puis exécutez :
go run ./cmd/mpress build --strict
go run ./cmd/mpress check