Planet Jekyll

You can now build a GitHub Pages website with a Jekyll theme in just a few clicks.

1. Create a new GitHub repository or go to an existing one.
2. Open the theme chooser in the GitHub Pages section of your repository settings.
3. Select a theme.

♦

Using a Jekyll theme means that your website content lives in Markdown files, which you can edit as needed and manage using your favorite Git workflow.

As soon as you apply a Jekyll theme to your site, you can add more pages simply by committing new Markdown files.

The theme chooser replaces the old automatic page generator which didn't use Jekyll. Rest assured, existing GitHub Pages created with the automatic page generator will automatically use a matching Jekyll theme the first time you

Publishing a website or software documentation with GitHub Pages now requires far fewer steps. Commit a Markdown file and have a website in minutes.

You've been able to use relative links when authoring Markdown on GitHub.com for a while. Now, those links will continue to work when published via GitHub Pages.

If you have a Markdown file in your repository at docs/page.md, and you want to link from that file to docs/another-page.md, you can do so with the following markup:

[a relative link](another-page.md)

When you view the source file on GitHub.com, the relative link will continue to work, as it has before, but now, when you publish that file using GitHub Pages, the link will be silently translated to docs/another-page.html to match the target page's published URL.

Under the hood, we're using the open source Jekyll Relative Links plugin, which is ac

Hello! We have a bugfix release of Jekyll hot off the presses for you. Key fixes to call out:

GitHub Pages has upgraded to Jekyll 3.3.0, a release with some nice quality-of-life features.

First, Jekyll 3.3 introduces two new convenience filters, relative_url and absolute_url. They provide an easy way to ensure that your site's URLs will always appear correctly, regardless of where or how your site is viewed. To make it easier to use these two new filters, GitHub Pages now automatically sets the site.url and site.baseurl properties, if they're not already set.

This means that starting today {{ "/about/" | relative_url }} will produce /repository-name/about/ for Project Pages (and /about/ for User Pages). Additionally, {{ "/about/" | absolute_url }} will produce <

There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:

If you'd like to start using GitHub or just see what it's all about, we're kicking off a new way for you to learn the basics. Introduction to GitHub is a self-paced, online class designed to help you:

• Get started using GitHub.com in 30 minutes or less.
• Make new friends while collaborating on a fun project.
• Dive into the worlds of GitHub and open source.

Unlike many self-paced training classes where you are completely alone, this one has a thriving Gitter community where GitHub Trainers drop in several times a day to answer questions and help those who are stuck. During the course, you are encouraged to complete an activity where you will drop a pin on our map representing your current location. Check out our current pins here to see where pe

Jekyll’s Google Summer of Code Project has concluded. After three months of hard (but fun) work with my mentors @benbalter, @jldec, and @parkr, I’m proud to announce Jekyll Admin’s initial release. Jekyll admin is a Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. You can start to use it right away by following these instructions.

As promised, GitHub Pages has been upgraded to Jekyll 3.2. The move to Jekyll 3.2 brings over 100 improvements including the introduction of Gem-based themes.

You can begin using the Minima theme, starting today, by adding theme: minima to your site's config, a move which eliminates the need to manually copy templates or stylesheets into your repo. While Minima is the only theme supported today, we're working to make more themes available for use on GitHub Pages. Check out the GitHub help documentation for more information on adding a theme to your GitHub Pages site.

This should be a seamless transition for all GitHub Pages users, but if you have a particularly complex Jekyll site, we encourage you to get in touch with us. For more information on these change

You might be familiar with how GitHub Pages helps you share your work with the world or maybe you have attended a class that helped you build your first GitHub Pages site. Recent improvements to GitHub Pages have made it easier to publish your site from a variety of sources. One of these sources is your repository's /docs folder.

Quality documentation is a hallmark of any healthy software project. For open-source projects, however, maintaining a robust compendium of knowledge detailing all the ins and outs is paramount. Well-curated documentation increases your project's approachability, provides asynchronous guidance, and fosters the type of uncoordinated collaboration that propels open-source software development.

Hosting your documentation on the web c

We're making it easier to publish a website with GitHub Pages. Now you can select a source in your repository settings and GitHub Pages will look for your content there.

♦

1. Selecting master branch will publish your site from the master branch. This is useful for repositories dedicated to website content.

2. Selecting master branch /docs folder will publish from the /docs folder of your master branch. This lets you maintain documentation and code together on one branch, and open source maintainers can accept contributions for both in a single pull request.

Rest assured that existing project pages which use a gh-pages branch will keep working just like before, as will user and organi

I was recently working on a small Jekyll project and wanted to see whether it would be possible to have a very component-ized approach driven by a styleguide, despite the fact that Liquid (the template engine behind Jekyll) is not meant to do that.

I found it out it is doable (not without some struggling though) and I’d like to show you how so you can consider using a similar approach in your next Jekyll project.

♦

There is quite a bit of setup around this example, so I recommend you check the live demo then follow along with this boilerplate on GitHub.

Why a Styleguide?

When working on a site or application, it is good practice to try finding common UI patterns so they can be extracted and reused across the platform. This helps maintenance, scaling and reduce

GitHub Pages will upgrade to Jekyll 3.2 on August 23rd.

The upgrade to Jekyll 3.2 comes with over 100 improvements including the introduction of themes, meaning that soon, you'll be able to create a beautiful site in minutes by simply adding theme: my-awesome-theme to your site's config, without needing to copy styles or templates into your site's repository.

This should be a seamless transition for all GitHub Pages users, but if you have a particularly complex Jekyll site, we recommend building your site locally with the latest version of Jekyll 3.2.x prior to August 23rd to ensure your site continues to build as expected.

For more information, see the Jekyll changelog and if you have any questions, we encourage you to get in touch with us.

Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release should squash that :bug:. Sorry about that!

Happy Day! Jekyll v3.2.0 is out, and packed full of goodies.

♦

For this edition of Patchwork, we're teaming up with our friends at Code for Philly for an evening of food, hacking, and meeting some new faces. You do not need to be a Code for Philly member to participate; the event is open to all beginners to Git and GitHub, or mentors who would like to help others learn. We'll have stickers and a little something extra for mentors, so we hope to see you there.

♦

A host of GitHubbers, as well as local community mentors, will be on hand to walk you through your choice of learning modules:

• Introduction to Git
• Introduction to GitHub
• Creating a Site with GitHub Pages

No coding experience needed

Patchwork is a self-directed, hands-on workshop for learning Git and GitHub. The atmosp

♦

We're bringing Patchwork to Seattle on July 21. If you're in town for Open Source and Feelings, or if you're local, we hope you can join us for a relaxing evening of GitHubbing. We're teaming up with our friends at MAKERS Coworking, and the event is open to beginners to Git and GitHub, or mentors who would like to help others learn. We'll have stickers and a little something extra for mentors, so we hope to see you there.

♦

A host of GitHubbers, as well as local community mentors, will be on hand to walk you through your choice of learning modules:

• Introduction to Git
• Introduction to GitHub
• Creating a Site with GitHub Pages

No coding experience needed

Patchwork is a self-directed, hands-on workshop for learning G

We're coming back to Amsterdam to help celebrate PRIDE with our friends in the LGBTQ community. Join us as we team up with Q42 to host a Patchwork event on August 5. The event is open to beginners to Git and GitHub, or mentors who would like to help others learn. We'll have stickers and a little something extra for mentors, so we hope to see you there.

Also, if you register by July 15, you'll get one of our Pridetocat or Transtocat t-shirts absolutely free. ♦

♦

A host of GitHubbers, as well as local community mentors, will be on hand to walk you through your choice of learning modules:

• Introduction to Git
• Introduction to GitHub
• Creating a Site with GitHub Pages

No coding experience needed

Patchwork is a self-directe

Millions of people rely on GitHub Pages to host their websites and millions more visit these websites every day. To better protect traffic to GitHub Pages sites, as well as to encourage the broader adoption of HTTPS across the internet, GitHub Pages now officially1 supports HTTPS for all <username>.github.io sites. HTTPS provides a layer of encryption that prevents others from snooping on or tampering with traffic to your Pages site.

You can now visit *.github.io sites using HTTPS and configure HTTPS enforcement for your site. With HTTPS enforcement enabled, any HTTP requests to your github.io site will be transparently redirected to HTTPS.

♦

Starting next Wednesday (June 15, 2016, 12pm PDT), HTTPS enforcement will b

This year, Jekyll applied to be a part of Google Summer of Code. Students were able to propose any project related to Jekyll. With a gracious sponsorship from GitHub and the participation of myself, @benbalter and @jldec, Jekyll was able to accept two students for the 2016 season, @mertkahyaoglu and @rush-skills.

Join us in Amsterdam as we team up with our friends at Le Wagon to host a Patchwork event on June 23. The event is open to beginners to Git and GitHub, or mentors who would like to help others learn. We'll have stickers and a little something extra for mentors, so we hope to see you there.

@lieke22, @lindsay, and @richardstraat, as well as local community mentors, will be on hand to walk you through your choice of learning modules:

• Introduction to Git
• Introduction to GitHub
• Creating a Site with GitHub Pages

No coding experience needed

Patchwork is a self-directed, hands-on workshop for learning Git and GitHub. The atmosphere is casual and informal; it is not an event full of presented tutorials and copious note-taking. You will be

I have long been a fan of Jekyll. It has some flaws and is not always the best tool for the job, however, it can be a great tool for some situations. I have lost count of how many websites I have built with it.

Recently, I made yet another site with Jekyll, this time for Simplified JavaScript Jargon and I found myself facing a not so atypical issue — inlining styles in the <head>.

The Need

You may have heard of critical CSS. The idea behind the concept is to provide critical styles (the ones responsible for the look of the top and main content areas of the page) as soon as possible to the browser so that there is no delay before accessing the content.

There is a common rule that says it is good to send what is needed to render the top of the page

We've teamed up with our pals at Grumpy Gits to host a Patchwork event in Singapore on June 25. The event is open to beginners to Git and GitHub, or mentors who would like to help others learn. We'll have stickers and something a little extra for mentors, so we hope to see you there.

A host of GitHubbers, as well as local community mentors, will be on hand to walk you through your choice of learning modules:

• Introduction to Git
• Introduction to GitHub
• Creating a Site with GitHub Pages

No coding experience needed

Patchwork is a self-directed, hands-on workshop for learning Git and GitHub. The atmosphere is casual and informal; it is not an event full of presented tutorials and copious note-taking. You will be able to go at your own p