Crear un repositorio para tu sitio
Puedes crear un repositorio o elegir un repositorio existente para el sitio.
Si quieres crear un sitio de GitHub Pages para un repositorio donde no todos los archivos del repositorio están relacionados con el sitio, podrás configurar una fuente de publicación para el sitio. Por ejemplo, puedes tener una rama dedicada y una carpeta para contener los archivos de origen del sitio, o bien usar un flujo de trabajo de GitHub Actions personalizado para compilar e implementar los archivos de origen del sitio. A fin de usar GitHub Actions como origen de publicación para GitHub Pages, un administrador de sitio debe habilitar GitHub Actions para GitHub Enterprise Server. Para más información, consulta Habilitar GitHub Actions para GitHub Enterprise Server
Si quieres crear un sitio en un repositorio existente, ve a la sección Crear tu sitio.
-
En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.
-
Usa el menú desplegable Propietario para seleccionar la cuenta que quieres que sea propietaria del repositorio.
-
Escribe un nombre para tu repositorio y una descripción opcional. Si va a crear un sitio de usuario u organización, el repositorio debe tener el nombre
<user>.github.io
o<organization>.github.io
. Si tu nombre de organización o usuario contiene mayúsculas, debes hacerlas minúsculas. Para más información, consulta What is GitHub Pages?. -
Elige la visibilidad del repositorio. Para más información, consulta Acerca de los repositorios.
-
Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame).
-
Haga clic en Create repository (Crear repositorio).
Crear tu sitio
Antes de que puedas crear tu sitio, debes tener un repositorio para el mismo en GitHub. Si no vas a crear el sitio en un repositorio existente, consulta Crear un repositorio para el sitio.
Advertencia
Los sitios de > Si el administrador del sitio ha habilitado la versión pública de Pages, los sitios de GitHub Pages estarán disponibles públicamente en Internet, incluso si el repositorio del sitio es privado o interno. Si tienes datos confidenciales en el repositorio del sitio, tal vez te interese eliminarlos antes de publicarlo. Para más información, consulta Configurar GitHub Pages para tu empresa y Acerca de los repositorios.
-
En GitHub, navega al repositorio de tu sitio.
-
Decide qué fuente de publicación quieres utilizar. Consulta Configurar una fuente de publicación para tu sitio de Páginas de GitHub.
-
Crea el archivo de entrada para el sitio. GitHub Pages buscará un archivo
index.html
,index.md
oREADME.md
como archivo de entrada para el sitio.Si el origen de publicación es una rama y una carpeta, el archivo de entrada debe estar en el nivel superior de la carpeta de origen de la rama de origen. Por ejemplo, si la fuente de publicación es la carpeta
/docs
de la ramamain
, el archivo de entrada debe estar en la carpeta/docs
de una rama denominadamain
.Si la fuente de publicación es un flujo de trabajo de GitHub Actions, el artefacto que implementes debe incluir el archivo de entrada en el nivel superior del artefacto. En lugar de agregar el archivo de entrada al repositorio, puedes decidir que el flujo de trabajo de GitHub Actions genere el archivo de entrada cuando se ejecute el flujo de trabajo.
-
Configura tu fuente de publicción. Consulta Configurar una fuente de publicación para tu sitio de Páginas de GitHub.
Visualización del sitio publicado
-
En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.
-
En la sección "Código y automatización" de la barra lateral, haz clic en Páginas.
-
Para ver el sitio publicado, en "GitHub Pages", haz clic en Visit site.
Nota:
La publicación de los cambios en el sitio puede tardar hasta 10 minutos después de que se envíen a GitHub. Si no ves los cambios del sitio de GitHub Pages reflejados en el explorador después de una hora, consulta Acerca de los errores de compilación para sitios de Páginas de GitHub.
- Si estás publicando desde una rama y tu sitio no se publicó automáticamente, asegúrate de que alguien con permisos administrativos y una dirección de correo electrónico verificada haya subido a la fuente de publicación.
- Las confirmaciones insertadas por un flujo de trabajo de GitHub Actions que usa
GITHUB_TOKEN
no desencadenan una compilación de GitHub Pages.
Generadores de sitios estáticos
GitHub Pages publica cualquier archivo estático que subas a tu repositorio. Puedes crear tus propios archivos estáticos o usar un generador de sitios estáticos para que desarrolle tu sitio. También puedes personalizar tu propio proceso de compilación de forma local o en otro servidor.
Si usas un proceso de compilación personalizado o un generador de sitios estáticos distinto de Jekyll, puedes escribir un flujo de trabajo de GitHub Actions para crear y publicar el sitio. GitHub proporciona plantillas de flujo de trabajo para varios generadores de sitios estáticos. Para más información, consulta Configurar una fuente de publicación para tu sitio de Páginas de GitHub.
Si publicas el sitio desde una rama de origen, GitHub Pages usará Jekyll para compilar tu sitio de forma predeterminada. Si quieres usar un generador de sitios estáticos distinto de Jekyll, se recomienda escribir un GitHub Actions para compilar y publicar tu sitio en su lugar. De lo contrario, desactiva el proceso de compilación de Jekyll creando un archivo vacío denominado .nojekyll
en la raíz de la fuente de publicación y, después, sigue las instrucciones del generador de sitios estáticos para crear el sitio localmente.
Nota:
GitHub Pages no soporta idiomas del lado del servidor como PHP, Ruby o Python.
Tipos MIME en GitHub Pages
Un tipo MIME es un encabezado que un servidor envía a un navegador, proporcionando información sobre la naturaleza y el formato de los archivos que solicitó el navegador. GitHub Pages soporta más de 750 tipos MIME entre las miles de extensiones de archivo. La lista de tipos MIME admitidos se genera a partir del proyecto mime-db.
Si bien no puedes especificar los tipos de MIME personalizados en una base por perfil o por repositorio, puedes agregar o modificar los tipos de MIME para usar en GitHub Pages. Para más información, vea las instrucciones de contribución de mime-db.
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 el origen de publicación del sitio del proyecto es la rama gh-pages
y crea un nuevo archivo 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 más información, consulta Agregar un tema a tu sitio de Páginas de GitHub con Jekyll.