How do I get a multipage site from GitHub Pages' automatic generator?

Question

I am using the 'Automatic Generator' of GitHub Pages, and I see it only generates a single index.html and other web resources.

How it works if I want to have a multi-page website generated from other markdown files?

Solution 1

You pull the generated page, make any modification and addition you like (including adding new pages and links between the pages), then commit and push.

The generated single page helps you to make you start. You can duplicate its layout to generate other similar-looking pages by hand.

See Help.

Solution 2

You can get github to generate .html files from .markdown files by ensuring the top of the .markdown starts with the ---- block like this:

---
title: This will be used as the title-tag of the page head
---

hello
=====

**You are here!**

Found this here: http://xlson.com/2010/11/09/getting-started-with-github-pages.html

Solution 3

Github will automatically create pages for you, if you include the markdown file.

• index.html - yourname.github.io/project-name/
• about.md - yourname.github.io/project-name/about
• foo.md - yourname.github.io/project-name/foo

Tested this and working.

If you want to get into the really fun stuff - you need to get into Jekyll http://jekyllrb.com/

Solution 4

Github Pages uses the Jekyll site generator which suports converting any number of markdown files to HTML for you, and applying the surrounding template via a layout file. See github's documentation on using Jekyll: https://help.github.com/articles/using-jekyll-with-pages

The trick is that you have to download a jekyll template/theme and include it in your gh-pages branch on your own (standard jekyll configuration), instead of just allowing Github Pages to auto-generate the one file using its own built-in themes.

Solution 5

• GitHub Pages' automatic generator only generates one page.
• You can add the new file directly, github page publishes all data (including data inside the subfolders) for you.

View more solutions