MDX Forge

Bien démarrer avec MDXForge

Découvrez comment installer, configurer et déployer votre site MDXForge en quelques étapes simples.

Installation

  1. Clonez le repository : git clone https://github.com/benchambolle/mdxforge-starter.git
  2. Naviguez dans le dossier : cd mdxforge
  3. Installez les dépendances : npm install
  4. 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 site
  • src/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.