Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

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

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?

like image 939
Luigi R. Viggiano Avatar asked Dec 24 '12 18:12

Luigi R. Viggiano


People also ask

Does GitHub Pages support multiple pages?

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.

Does GitHub Pages auto Deploy?

Deploying to GitHub Pages is automatic. Once it's set up, deploying happens whenever you push your local changes to your remote, GitHub-hosted repository. Head to GitHub Pages' setup instructions and follow the steps exactly to get your main GitHub Pages page setup.


2 Answers

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

like image 107
Scott Serr Avatar answered Sep 22 '22 14:09

Scott Serr


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/

like image 28
CliveCleaves Avatar answered Sep 22 '22 14:09

CliveCleaves