Entender Jekyll y la twig gh-páginas al usar GitHub Pages

Estoy usando Jekyll con GitHub Pages (específicamente, una página de proyecto). Creé 2 twigs:

  1. master
  2. gh-pages

La documentation explica que el contenido del website se almacena en la twig gh-pages y que Jekyll representará el contenido. La salida estará disponible en una URL como username.github.io/project-name.

Si ejecuto jekyll new mysite en mi twig master local, eso crea _config.yml, _posts, _sites, etc. en esa twig. En este punto, si jekyll serve , puedo ver un sitio básico en localhost: 4000 (que es genial).

Mi pregunta:

Teniendo en count que lo que tengo actualmente en mi twig master actualmente parece estar funcionando, ¿cuál es el propósito de la twig gh-pages ? ¿Qué debería estar exactamente en a) twig master yb) twig gh-pages ?

Gracias por adelantado.

Lectura de la documentation de las páginas de Github :

Si desea insert su código y hacer que Github genere su sitio:

Solo necesitará versionar su código y NO las páginas generadas. Entonces, solo se necesita una twig.

  1. Para una página de Github de usuario / organización ( github.com/username/username.github.io ), publique su código en master .
  2. Para una página de proyecto ( github.com/username/projectRepository ), publique su código en gh-pages . Aquí no necesita una twig master .

Si necesita generar su sitio localmente y solo enviar las páginas generadas en Github:

Necesitarás versionar tu código y las páginas generadas. Por lo tanto, se necesitarán dos twigs.

  1. Repositorio de User/organisation : el código base va en la twig de code (o como se llame) y las páginas generadas se envían en master .
  2. Repositorio de Project : el código base va en la twig master (o como se llame), y las páginas generadas van en gh-pages .

Como se describe en github gh-páginas:

Roll vainilla, o generar un sitio para su proyecto para comenzar rápidamente.

gh-pages son simplemente una twig específica de github que te permite usarla como tu website.

Significa que si tienes index.html en esta página, podrás verlo en tu browser directamente.

este formatting de enlace: username.github.io/project_name

Más información se puede encontrar aquí: https://pages.github.com/