Crear un repositorio para tu sitio
Si tu sitio es un proyecto independiente, puedes crear un repositorio nuevo para almacenar el código fuente del mismo. 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.
Si quieres crear un sitio en un repositorio existente, salta hasta la sección "Crear tu sitio".
Advertencia:Si tu administrador de sitio ha habilitado las Páginas Públicas, los sitios Páginas de GitHub serán accesibles al público en general en internet, aún si sus repositorios son privados. Si tienes datos sensibles en el repositorio de tu sitio, tal vez quieras eliminarlos antes de publicarlo. Para obtener más información, consulta la sección "Configurar Páginas de GitHub en tu aplicativo" y "Acerca de la visibilidad de un repositorio".
- En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona Repositorio Nuevo.
- Utiliza el menú desplegable de Propietario y selecciona la cuenta que quieres sea propietaria del repositorio.
- Escribe un nombre para tu repositorio y una descripción opcional. Si estás creando un sitio de usuario u organización, tu repositorio se debe nombrar
<user>.github.io
o<organization>.github.io
. Para obtener más información, consulta "Acerca de Páginas de GitHub". - Choose a repository visibility. Para obtener más información, consulta la sección "Acerca de la visibilidad del repositorio".
- Selecciona Inicializar este repositorio con un README.
- Click Create repository.
Crear tu sitio
Antes de que puedas crear tu sitio, debes tener un repositorio para el mismo en GitHub Enterprise. Si no estás creando tu sitio en un repositorio existente, consulta la sección "Crear un repositorio para tu sitio".
-
En GitHub Enterprise, navega al repositorio de tu sitio.
-
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." -
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.md
que contenga el contenido que quieras mostrar en la página principal de tu sitio. -
Configure your publishing source. Para obtener más información, consulta "Configurar una fuente de publicación para tu sitio Páginas de GitHub".
-
Debajo de tu nombre de repositorio, da clic en Configuración.
-
Para ver tu sitio publicado, debajo de "Páginas de GitHub", da clic en la URL del mismo.
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. Si no ves los cambios reflejados en tu buscador después de una hora, consulta la sección "Acerca de los errores de compilación de Jekyll para sitios de Páginas de GitHub".
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 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".