web-dev-qa-db-fra.com

Comment obtenir un site multipage à partir du générateur automatique de GitHub Pages?

J'utilise le "générateur automatique" de pages GitHub, et je vois qu'il ne génère qu'un seul index.html et d'autres ressources Web.

Comment cela fonctionne-t-il si je souhaite qu'un site Web de plusieurs pages soit généré à partir d'autres fichiers de démarque?

githubmarkdowndocumentation-generationgithub-pages
29
Luigi R. Viggiano

Vous tirez la page générée, apportez toute modification et ajout que vous aimez (y compris l'ajout de nouvelles pages et des liens entre les pages), puis validez et poussez.

La page unique générée vous aide à démarrer. Vous pouvez dupliquer sa mise en page pour générer manuellement d'autres pages d'aspect similaire.

Voir Aide .

4
JB Nizet

Vous pouvez demander à github de générer des fichiers .html à partir de fichiers .markdown en vous assurant que le haut du .markdown commence par le bloc ---- comme ceci:

---
title: This will be used as the title-tag of the page head
---

hello
=====

**You are here!**

Trouvé ici: http://xlson.com/2010/11/09/getting-started-with-github-pages.html

22
Scott Serr

Github créera automatiquement des pages pour vous, si vous incluez le fichier de démarque.

  • index.html - yourname.github.io/project-name/
  • about.md - yourname.github.io/project-name/about
  • foo.md - yourname.github.io/project-name/foo

Testé cela et fonctionnant.

Si vous voulez entrer dans les trucs vraiment amusants - vous devez entrer dans Jekyll http://jekyllrb.com/

12
CliveCleaves

Github Pages utilise le générateur de site Jekyll qui prend en charge la conversion de n'importe quel nombre de fichiers de démarque en HTML et l'application du modèle environnant via un fichier de mise en page. Voir la documentation de github sur l'utilisation de Jekyll: https://help.github.com/articles/using-jekyll-with-pages

L'astuce est que vous devez télécharger un modèle/thème jekyll et l'inclure dans votre branche gh-pages par vous-même (configuration jekyll standard), au lieu de simplement permettre à Github Pages de générer automatiquement celui-ci fichier en utilisant ses propres thèmes intégrés.

4
mltsy
  • Le générateur automatique de GitHub Pages ne génère qu'une seule page.
  • Vous pouvez ajouter le nouveau fichier directement, la page github publie toutes les données (y compris les données à l'intérieur des sous-dossiers) pour vous.
3
user2959760

Vient de faire gh-pages-generator - l'utilitaire pour générer un site avec la navigation à partir de plusieurs fichiers de démarques ayant des liens entre eux.

1
esp