GitHub Pages
GitHub Pages allow you to publish web content to a github.com subdomain named after your username. With Pages, publishing web content becomes as easy as pushing to your GitHub repository.…
GitHub Pages allow you to publish web content to a github.com subdomain named after your username. With Pages, publishing web content becomes as easy as pushing to your GitHub repository.
If you create a repository named you.github.com
, where you
is your username, and push content to it, we’ll automatically publish that to http://you.github.com. No FTP, no scp, no rsync, nothing. Just a simple git push
and you’re done. You can put anything here you like. Use it as a customizable home for your Git repos. Create a blog and spread your ideas. Whatever you want!
If you create a gh-pages
branch on any regular repository and push content there, we will automatically publish that to http://you.github.com/your-repo. This allows you to create instant documentation sites that are as easy to collaborate on as your code. Since you’ll want a blank slate for your Pages branch, you can use a little Git trick to create a new branch that has no parents. Just follow the instructions at pages.github.com and you’ll be up and running in a few seconds.
In addition to all this, we thought it would be nice to give you an easy way to assemble more complex sites. That’s why we pipe every Pages-bound repo/branch through Jekyll, my very own blog-aware static site generator that was purpose built specifically for this task. With Jekyll, you have access to layouts, includes, filters, syntax highlighting, Textile and Markdown, and intelligent handling of blog entries. All you have to do is follow the Jekyll conventions and we’ll handle the transformation. For an example of a Jekyll site that works on Pages, check out my tpw blog repo.
Now that you know how it works, let’s take a walk through some of the pages that have popped up since we started tweeting about the feature.
The GitHub Crew
- pjhyett is a man of big ideas, but few words
- defunkt created a meme (fork and add your own image!)
- mojombo (me)
- schacon teaches you Git
- tekkub is porting his existing homepage
Our Very Creative Customers
- kneath had the first Page I remember seeing
- hans keeps it simple
- ryan-allen likes it clean
- shepjeng is enigmatic
- 3n takes JavaScript to the limit
- lachlanhardy is creating JavaScript snippets
- atmos seamlessly pulls in his GitHub repos with jQuery
- quamen likes to draw
- pointcom has proposed a staring contest
- alx is already using Jekyll
- voodootikigod also knows about Jekyll
- newtonapple stays with Webby (generated locally)
- eoghanmccabe understands fully
Project Pages
We hope you have fun with Pages, I know we’ll have a blast looking at what you all come up with!
Written by
Related posts
Students: Start building your skills with the GitHub Foundations certification
The GitHub Foundations Certification exam fee is now waived for all students verified through GitHub Education.
Announcing GitHub Secure Open Source Fund: Help secure the open source ecosystem for everyone
Applications for the new GitHub Secure Open Source Fund are now open! Applications will be reviewed on a rolling basis until they close on January 7 at 11:59 pm PT. Programming and funding will begin in early 2025.
Software is a team sport: Building the future of software development together
Microsoft and GitHub are committed to empowering developers around the world to innovate, collaborate, and create solutions that’ll shape the next generation of technology.