Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.
Versión del artículo: Enterprise Server 2.18

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 is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

En este artículo

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 "Acerca de las Páginas de GitHub y Jekyll".

To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "Front Matter" in the Jekyll documentation.

Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on GitHub Enterprise. Then, test your site locally. 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. On GitHub Enterprise, navigate to your site's repository.

  2. Navigate to the publishing source for your site. 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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

    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. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

    Confirmar opciones de rama

  8. Haz clic en Proponer cambio en el archivo.

    Propose file change button

Agregar una publicación nueva a tu sitio

  1. On GitHub Enterprise, navigate to your site's repository.

  2. Navigate to the publishing source for your site. 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: page
    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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

    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. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

    Confirmar opciones de rama

  9. Haz clic en Proponer cambio en el archivo.

    Propose file change button

Pasos siguientes

You can add a Jekyll theme to your Páginas de GitHub site to customize the look and feel of your site. Para obtener más información, consulta "Agregar un tema a tu sitio de Páginas de GitHub con Jekyll".

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos