À propos du projet

Academic Pages est un modèle GitHub Pages basé sur Jekyll, conçu pour les sites web de portfolios personnels et professionnels. Les utilisateurs peuvent créer un dépôt à partir du modèle, le nommer avec leur nom d'utilisateur GitHub, configurer le site dans `_config.yml` et ajouter du contenu en Markdown ou HTML. Les fichiers téléversés placés dans le répertoire `files/` sont servis depuis le chemin correspondant du site. Le modèle inclut un dossier `markdown_generator` avec des notebooks Jupyter ou des scripts Python qui peuvent générer des pages Markdown pour les publications et présentations à partir de données TSV. Il est dérivé du thème Minimal Mistakes Jekyll et est disponible sous licence MIT. Pour le développement local, la configuration documentée utilise Ruby, Bundler et Node.js. Après l'installation des dépendances avec `bundle install`, le site peut être prévisualisé avec le serveur local de Jekyll, généralement à `localhost:4000` ; les modifications Markdown et HTML sont reconstruites automatiquement, tandis que les changements de configuration peuvent nécessiter un redémarrage. Le dépôt fournit également un Dockerfile et un flux de travail Docker Compose pour exécuter le site sans installer manuellement la chaîne d'outils locale complète, ainsi qu'une configuration VS Code Dev Container. Les conseils de maintenance couvrent les problèmes GitHub, les discussions, les demandes de tirage, le forking et les considérations de synchronisation pour les sites personnalisés. Comme il est conçu comme un modèle de démarrage plutôt qu'un service hébergé autonome, les utilisateurs gèrent leur propre contenu, configuration, dépôt GitHub et déploiement via GitHub Pages.