How to set up project pages as subpages of GitHub personal webpage?

Question

My github personal webpage is davidrpugh.github.io. I have set up a subpage for my software projects at davidrpugh.github.io/software and created stub subpages for each of my software projects. Example would be davidrpugh.io/software/pypwt.

Question: How do I set up the project webpage, which would by default live at davidrpugh.io/pypwt, so that it lives instead at davidrpugh.io/software/pypwt? I also want any updates to the project webpage to automatically render on my personal webpage as well.

I am guessing that this is a solved problem, and I am not using the correct set of search terms.

Answer 1

Concerning you project web site hosted at https://github.com/davidrpugh/penn-world-tables in gh-pages branch.

#Jekyll config
url : http://davidrpugh.github.io 
baseurl: /penn-world-tables

The complete site url will be http://davidrpugh.github.io/penn-world-tables. You will not be able to change this at all. If you try to set a permalink: software/pypwt/ on the index page it will give you http://davidrpugh.github.io/penn-world-tables/software/pypwt/

In order to get a http://davidrpugh.github.io/software/pypwt/ url you can

• host you pypwt doc on you user site, as it is done actually
• create a https://github.com/davidrpugh/software repository that will have a http://davidrpugh.github.io/software/ url
• leave the idea to have a /software/pypwt url and logically host pypwt doc in penn-world-tables repository. The http://davidrpugh.github.io/penn-world-tables/ is not so bad after all, although it breaks the correlation between navigating in software/pypwt and getting the http://davidrpugh.github.io/penn-world-tables/ url. I think that it's not a great ergonomy / accessibility problem.

Just use the same template over all you repositories, this will make user fills like it's the same site when navigating.