Skip to main content

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 los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server.

Nota: Los propietarios de la organización pueden restringir la publicación de sitios de Páginas de GitHub desde los repositorios que le pertenezcan a dicha organización. Para obtener más información, consulta la sección "Administrar la publicación de sitios de Páginas de GitHub".

Crear un repositorio para tu sitio

Puedes ya sea crear un repositorio o elegir alguno existente para tu sitio.

Si quieres crear un sitio de Páginas de GitHub para un repositorio en donde no todos los archivos de este se relacionen con el sitio, podrás configurar una fuente de publicación para dicho sitio. Por ejemplo, puedes tener una rama y carpeta dedicados para albergar los archivos fuente de tu sitio.

Si quieres crear un sitio en un repositorio existente, salta hasta la sección "Crear tu sitio".

  1. En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona Repositorio Nuevo. Menú desplegable con opción para crear un repositorio nuevo
  2. Utiliza el menú desplegable de Propietario y selecciona la cuenta que quieres sea propietaria del repositorio. Menú desplegable Propietario
  3. 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. Si tu nombre de organización o usuario contiene mayúsculas, debes hacerlas minúsculas. Para obtener más información, consulta la sección "Acerca de Páginas de GitHub". Crear un campo de repositorio
  4. Elige la visibilidad del repositorio. Para obtener más información, consulta la sección "Acerca de los repositorios". Botones radiales para seleccionar la visibilidad del repositorio
  5. Selecciona Inicializar este repositiro con un README. Inicializar este repositorio con una casilla de verificación README
  6. Haz clic en Crear repositorio. Botón para crear un repositorio

Crear tu sitio

Antes de que puedas crear tu sitio, debes tener un repositorio para el mismo en GitHub Enterprise Server. Si no estás creando tu sitio en un repositorio existente, consulta la sección "Crear un repositorio para tu sitio".

Advertencia: Si tu administrador de sitio habilitó las páginas públicas, los sitios de Páginas de GitHub estarán disponibles públicamente en la itnernet, incluso si el repositorio del sitio es privado o interno. Si tienes datos sensibles en el repositorio de tu sitio, es posible que quieras eliminar los datos antes de publicar. Para obtener más información, consulta las secciones "Configurar las Páginas de GitHub para tu empresa" y "Acerca de los repositorios".

  1. En GitHub Enterprise Server, navega al repositorio de tu sitio.

  2. Decide qué fuente de publicación quieres utilizar. Para obtener más información, consulta la sección "Configurar una fuente de publicación para tu sitio de GitHub Pages".

  3. Crea el archivo de entrada para tu sitio. Páginas de GitHub buscará un archivo index.html, index.md o README.md como el archivo de entrada para tu sitio.

    El archivo de entrada debe estar en el nivel superior de la fuente de publicación que elijas. Por ejemplo, si tu fuente de publicación es la carpeta /docs en la rama main, tu archivo de entrada debe estar ubicado en la carpeta /docs en una rama llamada main.

  4. Configura tu fuente de publicción. Para obtener más información, consulta "Configurar una fuente de publicación para tu sitio Páginas de GitHub".

  5. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  6. En la barra lateral izquierda, da clic en Páginas. Pestaña de página en la barra lateral izquierda

  7. Para ver tu sitio publicado, debajo de "Páginas de GitHub", da clic en la URL del mismo. URL de tu sitio publicado

    Nota: Es posible que tome hasta 10 minutos la publicación de los cambios en tu sitio luego de que subes los cambios a GitHub Enterprise Server. Si no puedes ver reflejados los cambios de tu sitio de Páginas de GitHub en tu buscador después de una hora, consulta la sección "Acerca de los errores de compilación de Jekyll para los sitios de Páginas de GitHub".

Nota: Si tu sitio no se publicó automáticamente, asegúrate de que alguien con permisos administrativos y una dirección de correo electrónico verificada lo haya subido a la fuente de publicación.

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.html.

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 la sección "Acerca de Páginas de GitHub y de Jekyll".

Leer más