Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Agregar contenido a tu sitio de Páginas de GitHub con Jekyll

Puedes agregar una página nueva o publicar tu sitio Jekyll a tu sitio en las Páginas de GitHub.

Páginas de GitHub se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server.

Las personas con permisos de escritura para un repositorio pueden agregar contenido a un sitio de Páginas de GitHub con Jekyll.

Acerca del contenido en sitios Jekyll

Antes de poder agregar contenido a un sitio Jekyll en las Páginas de GitHub, debes crear un sitio Jekyll. Para obtener más información, consulta "Crear un sitio de Páginas de GitHub con Jekyll".

Los principales tipos de contenido para sitios Jekyll son páginas y publicaciones. Una página es para el contenido independiente que no está asociado con una fecha específica, como una página "Acerca de". El sitio Jekyll predeterminado contiene un archivo denominado about.md, que se representa como una página en tu sitio en TU-SITE-URL/about. Puedes editar los contenidos de ese archivo para personalizar tu página "Acerca de" y usar la página "Acerca de" como plantilla para crear páginas nuevas. Para obtener más información, consulta "Páginas" en la documentación de Jekyll.

Una publicación es una entrada de blog. El sitio Jekyll predeterminado contiene un directorio denominado _posts que contiene un archivo de publicación predeterminada. Puedes editar los contenidos de esa publicación y usar la publicación predeterminada como plantilla para crear publicaciones nuevas. Para obtener más información, consulta "Publicaciones" en la documentación de Jekyll.

Tu tema incluye diseños predeterminados, inclusiones y hojas de estilos que se aplicarán automáticamente a las páginas y publicaciones nuevas de tu sitio; sin embargo, puedes reemplazar cualquiera de estas formas predeterminadas. Para obtener más información, consulta la sección "Acerca de Páginas de GitHub y de Jekyll".

Para configurar variables y metadatos, tales como el título y diseño, de una página o publicación en tu sitio, puedes agregar YAML front matter a la parte superior de cualquier archivo Markdown o HTML. Para obtener más información, consulta la sección "Front Matter" en la documentación de Jekyll.

Los cambios en tu sitio se publican automáticamente cuando se fusionan con la fuente de publicación de tu sitio. Si quieres pre-visualizar tus cambios primero, puedes hacer los cambios localmente en vez de en GitHub Enterprise Server. Después, prueba tu sitio localmente. Para obtener más información, consulta "Verificar tu sitio de Páginas de GitHub localmente con Jekyll".

Agregar una página nueva a tu sitio

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio.

  2. Navega a la fuente de publicación para tu sitio. Para obtener más información acerca de las fuentes de publicación, consulta "Acerca de las Páginas de GitHub".

  3. En la raíz de tu fuente de publicación, crea un archivo nuevo para tu página denominado PAGE-NAME.md, reemplazando PAGE-NAME por un nombre de archivo significativo para la página.

  4. Agrega el siguiente texto preliminar de YAML a la parte superior del archivo, reemplazando PAGE TITLE por el título de la página y URL-PATH por la ruta que quieras para la URL de la página. Por ejemplo, si la URL base de tu sitio es https://octocat.github.io y tu URL-PATH es /about/contact/, tu página se encontrará en https://octocat.github.io/about/contact.

    layout: page
    title: "PAGE TITLE"
    permalink: /URL-PATH/
  5. Debajo del texto preliminar, agrega contenido para tu página.

  6. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, consulta "Crear una confirmación con co-autores múltiples". Mensaje de confirmación de tu cambio

  7. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, consulta "Crear una solicitud de extracción nueva". Confirmar opciones de rama

  8. Haz clic en Proponer cambio en el archivo. Botón para proponer cambio de archivo

  9. Crear una solicitud de cambios para tus cambios propuestos.

  10. En la lista de "Solicitudes de cambios", haz clic en la solicitud de cambios que te gustaría fusionar.

  11. Haz clic en Fusionar solicitud de cambios. Para obtener más información, consulta "Fusionar una solicitud de extracción".

  12. Si se te solicita, escribe un mensaje de confirmación o acepta el mensaje predeterminado. Campo para mensaje de confirmación

  13. Haz clic en Confirmar fusión.

  14. Opcionalmente, borra la rama. Para obtener más información, consulta "Crear y eliminar ramas dentro de tu repositorio".

Agregar una publicación nueva a tu sitio

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio.

  2. Navega a la fuente de publicación para tu sitio. Para obtener más información acerca de las fuentes de publicación, consulta "Acerca de las Páginas de GitHub".

  3. Desplázate hasta el directorio _posts.

  4. Crea un archivo nuevo denominado YYYY-MM-DD-NAME-OF-POST.md, reemplazando YYY-MM-DD por la fecha de tu publicación y NAME-OF-POST por el nombre de tu publicación.

  5. Agrega el siguiente texto preliminar de YAML en la parte superior del archivo, reemplazando POST TITLE por el título de la publicación, YYYYY-MM-DD hh:mm:ss -0000 por la fecha y hora de la publicación, y CATEGORY-1 y CATEGORY-2 por tantas categorías como las que quieras para tu publicación.

    layout: post
    title: "POST TITLE"
    date: YYYY-MM-DD hh:mm:ss -0000
    categories: CATEGORY-1 CATEGORY-2
  6. Debajo del texto preliminar, agrega contenido para tu publicación.

  7. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, consulta "Crear una confirmación con co-autores múltiples". Mensaje de confirmación de tu cambio

  8. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, consulta "Crear una solicitud de extracción nueva". Confirmar opciones de rama

  9. Haz clic en Proponer cambio en el archivo. Botón para proponer cambio de archivo

  10. Crear una solicitud de cambios para tus cambios propuestos.

  11. En la lista de "Solicitudes de cambios", haz clic en la solicitud de cambios que te gustaría fusionar.

  12. Haz clic en Fusionar solicitud de cambios. Para obtener más información, consulta "Fusionar una solicitud de extracción".

  13. Si se te solicita, escribe un mensaje de confirmación o acepta el mensaje predeterminado. Campo para mensaje de confirmación

  14. Haz clic en Confirmar fusión.

  15. Opcionalmente, borra la rama. Para obtener más información, consulta "Crear y eliminar ramas dentro de tu repositorio".

¡Ahora tu publicación debería estar disponible en tu sitio! Si la URL base de tu sitio es https://octocat.github.io, entonces tu publicación nueva se ubicará en https://octocat.github.io/YYYY/MM/DD/TITLE.html.

Pasos siguientes

Puedes agregar un tema de Jekyll a tu sitio de Páginas de GitHub para personalizar la apariencia de tu sitio. Para obtener más información, consulta "Agregar un tema a tu sitio de Páginas de GitHub con Jekyll".