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
The top 10 gifts for the developer in your life
Whether you’re hunting for the perfect gift for your significant other, the colleague you drew in the office gift exchange, or maybe (just maybe) even for yourself, we’ve got you covered with our top 10 gifts that any developer would love.
Congratulations to the winners of the 2024 Gaady Awards
The Gaady Awards are like the Emmy Awards for the field of digital accessibility. And, just like the Emmys, the Gaadys are a reason to celebrate! On November 21, GitHub was honored to roll out the red carpet for the accessibility community at our San Francisco headquarters.
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.