A while back I watched a neat presentation from Justin Searls called The Social Coding Contract. He has lots of good things to say, but there was one comment that really hit home: my Jekyll blog was easy to setup 6 months ago, but now it’s impossible to maintain. Heh. Most of my trouble could have been avoided with more careful management of dependencies, but alas I am not a Ruby person and I did not realize that
bundle update would completely sink my publishing abilities for 4 months. When I update Perl modules,
cpan runs their tests on my machine and refuses to install unless they pass.
bundle just installs them!
I think I ran into every possible problem, which was actually a good learning experience. Like uncle said, that’s what I get for using Windows! Some of the problems were my being a noob, and others were problems with various ruby modules. Honestly I don’t think that anyone with this many problems should even be using the platform, but gosh darnit I wanted it to work. And while I was at it, I updated to Octopress 3.0, which I believe will be much more manageable (I can freeze the gem version, instead of having to track Git commits). Here’s to the next person struggling with Octopress or Jekyll on Windows:
jekyll serveexits silently
gem 'listen', '2.7.8'in your Gemfile. I tried 2.7.6 first, but ran into other problems.
Build Warning: Layout 'nil' requested in atom.xml does not exist
nil, meaning don’t use any template in the _layouts folder.
LookupError: unknown encoding: cp65001
set PYTHONIOENCODING=utf-8before running
python -m pip install pygments; if that doesn’t work (it broke for me on a Japanese computer), set the code page to ascii via
Error: undefined method '' for nil:NilClassin pygments_code.rb
set MENTOS_TIMEOUT=100so it won’t time out. Then delete
.pygments-cache, which will have saved that nil result.
celluloid/calls.rb:48:in 'check': wrong number of arguments (2 for 1) (ArgumentError)
gem 'celluloid', '0.16.0'in your Gemfile to fix.
octopress deploy, you get
error : src refspec master doesn't match any
octopress deploydoes not first run a build; you must do
octopress new draft Title, etc. gives
cannot load such file: octopress/draft.
bundle exec octopress new draft Title
After smoothing out all of the real errors, the (currently) permanent workarounds I need are 1) to set
MENTOS_TIMEOUT to a large number and 2) to run commands with
Hope this helps!