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.

Crear un sitio de Páginas de GitHub

Puede crear un sitio de Páginas de GitHub en un repositorio nuevo o existente.

Páginas de GitHub is available in public repositories with GitHub gratis, and in public and private repositories with GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise, and Servidor de GitHub Enterprise. For more information, see "GitHub's products."

En este artículo

Crear un repositorio para tu sitio

If your site is an independent project, you can create a new repository to store your site's source code. If your site is associated with an existing project, you can add the source code for your site to a gh-pages branch or a docs folder on the master branch in that project's repository. For example, if you're creating a site to publish documentation for a project that's already on GitHub, you may want to store the source code for the site in the same repository as the project.

If you want to create a site in an existing repository, skip to the "Creating your site" section.

Warning: Páginas de GitHub sites are publicly available on the internet, even if their repositories are private. If you have sensitive data in your site's repository, you may want to remove it before publishing.

  1. In the upper-right corner of any page, use the drop-down menu, and select New repository.

    Drop-down with option to create a new repository

  2. Use the Owner drop-down menu, and select the account you want to own the repository.

    Menú desplegable Propietario

  3. Escribe un nombre para tu repositorio y una descripción opcional. If you're creating a user or organization site, your repository must be named <user>.github.io or <organization>.github.io. Para obtener más información, consulta "Acerca de Páginas de GitHub".

    Crear un campo de repositorio

  4. Choose to make the repository either public or private. Public repositories are visible to the public, while private repositories are only accessible to you, and people you share them with. Para obtener más información, consulta "Configurar la visibilidad de un repositorio".

    Botones de selección para seleccionar el estado público o privado

  5. Selecciona Inicializar este repositorio con un README.

    Inicializar este repositorio con una casilla de verificación README

  6. Haz clic en Crear repositorio.

Crear tu sitio

Before you can create your site, you must have a repository for your site on GitHub. If you're not creating your site in an existing repository, see "Creating a repository for your site."

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

  2. If you're creating a project site, decide which publishing source you want to use. If you're creating a user or organization site, you must store your site's source code on the master branch. For more information, see "About Páginas de GitHub."

  3. Si ya existe la fuente de publicación que elegiste, desplázate hasta la fuente de publicación. Si la fuente de publicación que elegiste no existe, crear la fuente de publicación.

  4. En la raíz de la fuente de publicación, crea un archivo nuevo denominado index.md que contenga el contenido que quieras mostrar en la página principal de tu sitio.

  5. If you're using a non-default publishing source for a project site, configure your publishing source. Para obtener más información, consulta "Configurar una fuente de publicación para tu sitio Páginas de GitHub".

  6. Under your repository name, click Settings.

    Repository settings button

  7. To see your published site, under "Páginas de GitHub", click your site's URL.

    URL of your published site

    Nota: Es posible que tome hasta 20 minutos la publicación de los cambios en tu sitio luego de que subes los cambios a GitHub. If your don't see your changes reflected in your browser after an hour, see "About Jekyll build errors for Páginas de GitHub sites."

Note: If your site's source files are located in the default publishing source—master for user and organization sites or gh-pages for project sites—but your site has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the default publishing source.

Pasos siguientes

Puedes agregar más páginas a tu sitio creando más archivos nuevos. Cada archivo estará disponible en tu sitio en la misma estructura de directorios que tu fuente de publicación. Por ejemplo, si la fuente de publicación para tu sitio de proyectos es la rama gh-pages, y creas un archivo nuevo denominado /about/contact-us.md en la rama gh-pages, el archivo estará disponible en https://<user>.github.io/<repository>/about/contact-us.md.

También puedes agregar un tema 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 el selector de temas".

Para personalizar aún más tu sitio, puedes usar Jekyll, un generador de sitio estático con soporte integrado para Páginas de GitHub. Para obtener más información, consulta "Acerca de las Páginas de GitHub y Jekyll".

Leer más

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos