GitHub Help

  • GitHub.com GitHub Enterprise 2.8 GitHub Enterprise 2.7 GitHub Enterprise 2.6 GitHub Enterprise 2.5 GitHub Enterprise 2.4
  • Contact Support
  • Return to GitHub
Categories / Customizing GitHub Pages
  • Using Jekyll as a static site generator with GitHub Pages
    • About GitHub Pages and Jekyll
    • Setting up your GitHub Pages site locally with Jekyll
    • Adding a Jekyll theme to your GitHub Pages site
    • Configuring Jekyll
  • Troubleshooting GitHub Pages builds
    • Viewing Jekyll build error messages
    • Generic Jekyll build failures
    • Page build failed: Missing docs folder
    • Page build failed: Invalid submodule
    • Page build failed: Missing submodule
    • Page build failed: Markdown errors
    • Page build failed: Config file error
    • Page build failed: Unknown tag error
    • Page build failed: Tag not properly terminated
    • Page build failed: Tag not properly closed
    • Page build failed: File does not exist in includes directory
    • Page build failed: File is a symlink
    • Page build failed: Symlink does not exist within your site's repository
    • Page build failed: File is not properly UTF-8 encoded
    • Page build failed: Invalid post date
    • Page build failed: Invalid Sass or SCSS
    • Page build failed: Invalid highlighter language
    • Updating your Markdown processor to kramdown
    • Page build failed: Relative permalinks configured
    • Page build failed: Syntax error in 'for' loop
    • Files that start with an underscore are missing
    • Page build failed: Invalid YAML in data file
    • Page build failed: Date is not a valid datetime
  • Adding Jekyll plugins to a GitHub Pages site
    • Configuring Jekyll plugins
    • Sitemaps for GitHub Pages
    • Search engine optimization for GitHub Pages
    • Repository metadata on GitHub Pages
    • Atom (RSS) feeds for GitHub Pages
    • Redirects on GitHub Pages
    • Emoji on GitHub Pages
    • @Mentions on GitHub Pages
  • Using a custom domain with GitHub Pages
    • Quick start: Setting up a custom domain
    • About supported custom domains
    • Custom domain redirects for GitHub Pages sites
    • Adding or removing a custom domain for your GitHub Pages site
    • Setting up an apex domain
    • Setting up a www subdomain
    • Setting up an apex domain and www subdomain
    • Setting up a custom subdomain
    • Troubleshooting custom domains
  • Additional customizations for GitHub Pages
    • Creating a custom 404 page for your GitHub Pages site
    • Using syntax highlighting on GitHub Pages
    • Using a static site generator other than Jekyll
    • MIME types on GitHub Pages
    • Should I rename <username.github.com> repositories to <username.github.io>?
    • Using submodules with Pages
The GitHub Logo

© 2016 GitHub Inc. All rights reserved.

  • Terms of Service
  • Privacy
  • Security
  • Support