pagina pages page examples domain blog github markdown documentation-generation github-pages

pages - pagina github



¿Cómo obtengo un sitio de varias páginas del generador automático de GitHub Pages? (6)

Acaba de hacer gh-pages-generator : la utilidad para generar sitios con la navegación desde múltiples archivos de rebajas que tienen enlaces entre sí.

Estoy usando el ''Generador automático'' de las páginas de GitHub, y veo que solo genera un único index.html y otros recursos web.

¿Cómo funciona si quiero tener un sitio web de varias páginas generado a partir de otros archivos de rebajas?


Github Pages utiliza el http://jekyllrb.com/ que admite la conversión de cualquier número de archivos de rebajas a HTML para usted y la aplicación de la plantilla a través de un archivo de diseño. Consulte la documentación de github sobre el uso de Jekyll: https://help.github.com/articles/using-jekyll-with-pages

El truco es que tienes que descargar una plantilla / tema jekyll e incluirla en tu rama de gh-pages por tu cuenta (configuración jekyll estándar), en lugar de permitir que Github Pages genere automáticamente un archivo usando su propio contenido incorporado. temas


Github creará páginas automáticamente para ti, si incluyes el archivo de rebajas.

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

Probado esto y trabajando.

Si quieres meterte en cosas realmente divertidas, debes ingresar a Jekyll http://jekyllrb.com/


Puede hacer que github genere archivos .html a partir de archivos .markdown asegurándose de que la parte superior de .markdown comience con el ---- bloque como este:

--- title: This will be used as the title-tag of the page head --- hello ===== **You are here!**

Encontré esto aquí: http://xlson.com/2010/11/09/getting-started-with-github-pages.html


Tire de la página generada, realice cualquier modificación y adición que desee (incluida la adición de nuevas páginas y enlaces entre las páginas), luego haga clic y presione.

La página única generada le ayuda a comenzar. Puede duplicar su diseño para generar otras páginas de aspecto similar a mano.

Ver Help .


  • El generador automático de GitHub Pages solo genera una página.
  • Puede agregar el nuevo archivo directamente , la página github publica todos los datos (incluidos los datos dentro de las subcarpetas) para usted.