Bien démarrer avec MDXForge
Découvrez comment installer, configurer et déployer votre site MDXForge en quelques étapes simples.
Installation
- Clonez le repository :
git clone https://github.com/benchambolle/mdxforge-starter.git
- Naviguez dans le dossier :
cd mdxforge
- Installez les dépendances :
npm install
- Lancez le serveur de développement :
npm run dev
Configuration
Personnalisez votre site en modifiant les fichiers de configuration :
src/config/siteconfig.ts
: Informations générales du sitesrc/config/header-footer.ts
: Liens de navigation et réseaux sociaux
Personnalisation
Logo : Placez votre logo dans le dossier public/
et mettez à jour le chemin dans siteconfig.ts
.
Avatar de l'auteur : Ajoutez votre avatar dans public/
et mettez à jour le chemin dans la section author
de siteconfig.ts
.
Couleurs et polices : Modifiez les variables dans siteconfig.ts
pour personnaliser l'apparence de votre site.
Création de contenu
Ajoutez vos articles de blog dans le dossier src/content/blog/
en utilisant le format MDX.
Exemple de frontmatter pour un article :
---
title: 'Comment contribuer à MDXForge'
description: "Guide pour contribuer au projet open-source MDXForge et participer à son développement."
pubDate: 2024-10-14
heroImage: '/MDXForge-og.jpg'
tags: ['MDXForge', 'Open Source', 'Contribution', 'Développement']
---
# Contenu de l'article en Markdown
Déploiement
Une fois votre site prêt, vous pouvez le déployer sur diverses plateformes comme Netlify, Vercel, ou GitHub Pages.
Pour construire votre site pour la production :
npm run build
Consultez la documentation Astro sur le déploiement pour plus d'informations.