Skip to main content

Crear una página 404 personalizada para tu sitio de Páginas de GitHub

Puedes mostrar una página personalizada de error 404 cuando se intente acceder a páginas que no existen en tu sitio.

¿Quién puede utilizar esta característica?

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server. Para más información, consulta "Planes de GitHub".

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

  2. Navega a la fuente de publicación para tu sitio. Para obtener más información, vea «Configurar una fuente de publicación para tu sitio de Páginas de GitHub».

  3. Sobre la lista de archivos, selecciona el menú desplegable Agregar archivo y, a continuación, haz clic en Crear nuevo archivo.

    Como alternativa, puedes hacer clic en en la vista de árbol de archivos a la izquierda.

    Captura de pantalla de la página principal de un repositorio. Encima de la lista de archivos, un botón con la etiqueta "Agregar archivo", aparece resaltado en naranja oscuro. En la vista de árbol de archivos del repositorio, un botón con el icono de signo más, también aparece resaltado en naranja oscuro.

  4. En el campo del nombre de archivo, escriba 404.html o 404.md.

  5. Si ha asignado el nombre 404.md al archivo, agregue el siguiente texto preliminar de YAML al comienzo del archivo:

    ---
    permalink: /404.html
    ---
    
  6. Debajo del texto preliminar de YAML, si aparece, agrega el contenido que quieras mostrar en tu página 404.

  7. Haz clic en Confirmar cambios... .

  8. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, vea «Crear una confirmación con distintos autores».

  9. Si tienes más de una dirección de correo electrónico asociada a la cuenta en GitHub.com, haz clic en el menú desplegable de la dirección de correo electrónico y selecciona la que se usará como dirección de correo electrónico del creador de Git. Únicamente las direcciones de correo electrónico verificadas aparecen en el menú desplegable. Si ha habilitado la privacidad de la dirección de correo electrónico, una dirección de correo electrónico no responder del creador de la confirmación será la predeterminada. Para obtener más información sobre el formulario exacto que puede tomar la dirección de correo electrónico sin respuesta, consulte "Configurar tu dirección de correo electrónico de confirmación".

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un menú desplegable con opciones para elegir la dirección de correo electrónico del creador de la confirmación. octocat@github.com aparece como que se seleccionó.

  10. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, vea «Crear una solicitud de incorporación de cambios».

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un botón de radio para confirmar directamente en la rama principal o para crear una nueva rama. Aparece seleccionada la opción de rama nueva.

  11. Haz clic en Confirmar cambios o Proponer cambios.

Información adicional