Skip to main content

Esta versión de GitHub Enterprise se discontinuará el 2023-01-18. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico 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 GitHub Pages.

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server.

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

Acerca del contenido en sitios Jekyll

Antes de poder agregar contenido a un sitio Jekyll en las GitHub Pages, debes crear un sitio Jekyll. Para obtener más información, consulte "Crear un sitio de GitHub Pages 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 de Jekyll predeterminado contiene un archivo denominado about.md, que se representa como una página del sitio en YOUR-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, consulte "Páginas" en la documentación de Jekyll.

Una publicación es una entrada de blog. El sitio de Jekyll predeterminado contiene un directorio denominado _posts que contiene un archivo de publicación predeterminado. 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, consulte "Posts" 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, consulte "Acerca de GitHub Pages y 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 "Texto preliminar" en la documentación de Jekyll.

Changes en tu sitio se publican automáticamente cuando se fusionan con la fuente de publicación de tu sitio. Si quieres previsualizar 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, vea "Probar tu sitio de GitHub Pages localmente con Jekyll".

Agregar una página nueva a tu sitio

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio. 1. Navega a la fuente de publicación para tu sitio. Para más información, consulta "Configuración de una fuente de publicación para el sitio de GitHub Pages."
  2. En la raíz del origen de publicación, cree un nuevo archivo para la página denominado PAGE-NAME.md reemplazando PAGE-NAME por un nombre de archivo significativo para la página.
  3. Agregue la siguiente parte delantera 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 de acceso que desee para la dirección URL de la página. Por ejemplo, si la dirección URL base del sitio es https://octocat.github.io y URL-PATH es /about/contact/, la página se ubicará en https://octocat.github.io/about/contact.
    layout: page
    title: "PAGE TITLE"
    permalink: /URL-PATH/
  4. Debajo del texto preliminar, agrega contenido para tu página.
  5. 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 más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio 1. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. 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 más información, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama 1. Haga clic en Propose file change (Proponer cambio de archivo). Botón para proponer cambio de archivo 1. Crear una solicitud de cambios para tus cambios propuestos.
  6. En la lista de "Solicitudes de cambios", haz clic en la solicitud de cambios que te gustaría fusionar. 1. Haga clic en Mer pull request (Combinar solicitud de incorporación de cambios). Para más información, vea "Combinación de una solicitud de incorporación de cambios". 1. Si se te solicita, escribe un mensaje de confirmación o acepta el mensaje predeterminado. Campo para mensaje de confirmación 1. Haga clic en Confirm merge (Confirmar combinación). 1. Opcionalmente, elimine la rama. Para más información, vea "Creación y eliminación de ramas dentro del repositorio".

Agregar una publicación nueva a tu sitio

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio. 1. Navega a la fuente de publicación para tu sitio. Para más información, consulta "Configuración de una fuente de publicación para el sitio de GitHub Pages."
  2. Vaya al directorio _posts.
  3. Cree un nuevo archivo denominado YYYY-MM-DD-NAME-OF-POST.md, reemplazando YYYY-MM-DD por la fecha de publicación y NAME-OF-POST por el nombre de la publicación.
  4. Agregue la siguiente parte delantera de YAML a la parte superior del archivo, reemplazando POST TITLE por el título de la publicación, YYYY-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 desee.
    layout: post
    title: "POST TITLE"
    date: YYYY-MM-DD hh:mm:ss -0000
    categories: CATEGORY-1 CATEGORY-2
  5. Debajo del texto preliminar, agrega contenido para tu publicación.
  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 más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio 1. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. 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 más información, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama 1. Haga clic en Propose file change (Proponer cambio de archivo). Botón para proponer cambio de archivo 1. Crear una solicitud de cambios para tus cambios propuestos.
  7. En la lista de "Solicitudes de cambios", haz clic en la solicitud de cambios que te gustaría fusionar. 1. Haga clic en Mer pull request (Combinar solicitud de incorporación de cambios). Para más información, vea "Combinación de una solicitud de incorporación de cambios". 1. Si se te solicita, escribe un mensaje de confirmación o acepta el mensaje predeterminado. Campo para mensaje de confirmación 1. Haga clic en Confirm merge (Confirmar combinación). 1. Opcionalmente, elimine la rama. Para más información, vea "Creación y eliminación de ramas dentro del repositorio".

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

Pasos siguientes

Puedes agregar un tema de Jekyll a tu sitio de GitHub Pages para personalizar la apariencia de tu sitio. Para obtener más información, consulte "Agregar un tema al sitio de GitHub Pages mediante Jekyll".