diff options
author | Ben Burwell <bburwell1@gmail.com> | 2014-05-01 00:45:10 -0400 |
---|---|---|
committer | Ben Burwell <bburwell1@gmail.com> | 2014-05-01 00:45:10 -0400 |
commit | 4a0a3c49b5b41174ab39dcd97769515a2770b172 (patch) | |
tree | d42879efdefeb228164ac8646cc194331e238aeb /_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown | |
parent | c7687a4f665f49bcd9d595737de845f337f8d14a (diff) |
Update post
Diffstat (limited to '_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown')
-rw-r--r-- | _posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown | 13 |
1 files changed, 2 insertions, 11 deletions
diff --git a/_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown b/_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown index 3a9ee5f..f2dbe27 100644 --- a/_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown +++ b/_posts/2014-05-01-migrating-to-github-pages-and-jekyll.markdown @@ -24,22 +24,13 @@ For those unfamiliar with [GitHub Pages](https://pages.github.com), anything tha Next came what was probably the most time-consuming part of the whole process: converting the [Jade](http://jade-lang.com) layout into pure HTML with [Liquid](http://liquidmarkup.org) markup. Luckily, this wasn’t too painful, and I came out with [two layouts](https://github.com/benburwell/benburwell.github.io/tree/master/_layouts), page structure and navigation, and the other for displaying Posts. -My next challenge was to maintain my link structure so nothing would be broken. The one exception I conceded to was my résumé, a PDF file that I had been serving from `/resume/` using Express (admittedly a pretty poor idea). After exploring the Jekyll documentation, I discovered that an easy way to separate out my content into Writing and Projects as I’ve done on my site was to use the built-in category functionality. I would simply create two category pages at [`/writing/index.html`](https://github.com/benburwell/benburwell.github.io/blob/master/writing/index.html) and [`/projects/index.html`](https://github.com/benburwell/benburwell.github.io/blob/master/projects/index.html) to render a list of posts from their respective categories, and tag each Markdown document with the appropriate category. The final step was to define my permalink structure in `_config.yml` which I did by adding the line - - permalink: /:categories/:title/ - -to the file. +My next challenge was to maintain my link structure so nothing would be broken. The one exception I conceded to was my résumé, a PDF file that I had been serving from `/resume/` using Express (admittedly a pretty poor idea). After exploring the Jekyll documentation, I discovered that an easy way to separate out my content into Writing and Projects as I’ve done on my site was to use the built-in category functionality. I would simply create two category pages at [`/writing/index.html`](https://github.com/benburwell/benburwell.github.io/blob/master/writing/index.html) and [`/projects/index.html`](https://github.com/benburwell/benburwell.github.io/blob/master/projects/index.html) to render a list of posts from their respective categories, and tag each Markdown document with the appropriate category. The final step was to define my permalink structure in `_config.yml` which I did by adding `permalink: /:categories/:title/` to the file. I next had the pleasure of renaming all of my content files to adhere to Jekyll’s naming convention (`YYYY-MM-DD-hyphen-separated-title.markdown`) and adding/modifying the front matter as necessary. ## Additional Configuration -I decided to enable the `jekyll-sitemap` plugin by adding - - gems: - - jekyll-sitemap - -to `_config.yml`. This plugin will generate [an XML sitemap](http://www.sitemaps.org) that can be used by crawlers such as those run by search engines to help determine what content needs to be indexed. +I decided to [enable the `jekyll-sitemap` plugin](https://help.github.com/articles/using-jekyll-plugins-with-github-pages) by adding `jekyll-sitemap` as a gem to `_config.yml`. This plugin will generate [an XML sitemap](http://www.sitemaps.org) that can be used by crawlers such as those run by search engines to help determine what content needs to be indexed. I moved my error page over and quickly translated the Jade to Markdown by [following the instructions provided by GitHub](https://help.github.com/articles/custom-404-pages) for creating a custom 404 page. The only remaining issue was my stylesheet problem. In my Express app, I used [Less](http://lesscss.org) for writing my stylesheets. As of this writing, Jekyll does not support compiled stylesheet languages like Less, though [there is the suggestion of future support](http://jekyllrb.com/docs/assets/) for Sass and CoffeeScript. |