Skip to content

Instantly share code, notes, and snippets.

@skopp
Last active December 22, 2015 02:09
Embed
What would you like to do?

Jekyll "winsafe"

TODO:

  • Have a smoke.
  • Outline - ref #1
  • Comb through given resources
  • Recompile "Outline"/Knowledge Base (KB)
  • Each contributor to prepare draft of his/her methods/knowhow/tips
  • Discuss, compare notes, go clubbing together afterwards.
  • ?
  • ...?

Outline

===

While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.

Installation

Madhur Ahuja has written up instructions to get Jekyll running on Windows and it seems to work for most.

Encoding

If you use UTF-8 encoding, make sure that no BOM header characters exist in your files or very, very bad things will happen to Jekyll. This is especially relevant if you're running Jekyll on Windows. Additionally, you might need to change the code page of the console window to UTF-8 in case you get a "Liquid Exception: Incompatible character encoding" error during the site generation process. It can be done with the following command.

{% highlight bash %}
$ chcp 65001
{% endhighlight %}
@skopp
Copy link
Author

skopp commented Sep 2, 2013

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment