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 se encuentra disponible en repositorios públicos con GitHub gratis y en repositorios privados y públicos con GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise y Servidor de GitHub Enterprise. Para obtener más información, consulta "Productos de GitHub."

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.

Advertencia: Los sitios Páginas de GitHub son de acceso público en Internet, aun cuando sus repositorios sean privados. Si tienes información confidencial en el repositorio de tu página, es posible que desees eliminarla antes de publicar.

  1. En la esquina superior derecha de cualquier página, haz clic en y, luego, haz clic en Nuevo repositorio.

    Menú desplegable con la opción para crear un nuevo repositorio

  2. Usa el menú desplegable Propietario y selecciona la cuenta que deseas que sea la propietaria del repositorio.

    Menú desplegable Propietario

  3. Type a name for your repository and an optional description. If you're creating a user or organization site, your repository must be named <user>.github.io or <organization>.github.io. For more information, see "About Páginas de GitHub."

    Create repository field

  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. For more information, see "Setting repository visibility."

    Radio buttons to select private or public status

  5. Select Initialize this repository with a README.

    Initialize this repository with a README checkbox

  6. Click Create repository.

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. For more information, see "Configuring a publishing source for your Páginas de GitHub site."

  6. En el nombre de tu repositorio, haz clic en Parámetros.

    Botón Parámetros del repositorio

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

    URL of your published site

Note: It can take up to 20 minutes for changes to your site to publish after you push the changes to 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