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.
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 Enterprise, 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.
-
In the upper-right corner of any page, use the drop-down menu, and select New repository.
-
Use the Owner drop-down menu, and select the account you want to own the repository.
-
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.ioor<organization>.github.io. Para obtener más información, consulta "Acerca de Páginas de GitHub".
-
Choose to make the repository either public or private. Public repositories are visible to everyone using tu instancia de servidor de GitHub Enterprise, 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".
-
Selecciona Inicializar este repositorio con un README.
-
Haz clic en Crear repositorio.
Crear tu sitio
Before you can create your site, you must have a repository for your site on GitHub Enterprise. If you're not creating your site in an existing repository, see "Creating a repository for your site."
-
On GitHub Enterprise, navigate to your site's repository.
-
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
masterbranch. For more information, see "About Páginas de GitHub." -
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.
-
En la raíz de la fuente de publicación, crea un archivo nuevo denominado
index.mdque contenga el contenido que quieras mostrar en la página principal de tu sitio. -
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".
-
Under your repository name, click Settings.
-
To see your published site, under "Páginas de GitHub", click your site's URL.
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 Enterprise. 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 http(s)://<hostname>/pages/<username>/<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 Jekyll".
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".