Just notes on installing jekyll, because I keep forgetting how.
If you try following the main tutorial on jekyll website you will most probably get on a stock Slackware 14.2 something like:
bash-4.3# gem install bundler
ERROR: Error installing bundler:
bundler requires Ruby version >= 2.3.0.
Solution: SlackBuilds offer a normal package for us: (as root)
sbopkg -i rubygem-bundler
or
sboinstall rubygem-bundler
or whatever floats your boat.
The trick to installing jekyll is not to do it as root anymore. Just as a normal user invoke bundler:
(taken from https://jekyllrb.com/tutorials/using-jekyll-with-bundler/)
mkdir jekyll-test cd jekyll-test bundle init bundle install --path vendor/bundle bundle add jekyll bundle exec jekyll new --force --skip-bundle . bundle install
If you are ready to build either serve it for a moment:
bundle exec jekyll serve
or just build it into _site:
bundle exec jekyll build
Now after preparing the site I like to link the main htdocs to it for a moment (because I can) (as root)
cd /var/www mv htdocs htdocs_org ln -s /home/anil/jekyll-test/_site htdocs
Now two more things: .gitignore and .htaccess
.gitignore is obvious – you are storing the whole current jekyll install in the same directory, so in case you start using version control – don’t ever push it to the server:
_site .sass-cache .jekyll-metadata vendor .bundle
I use apache for my site so after exporting a bit of old posts from WordPress I like to preserve links (like anyone really cares…), so:
My old wordpress used something.com/?p=60 for addressing, so after using a plugin to export raw posts, I had to redirect old calls /?=60 to /p/60.html
.htaccess
DirectoryIndex index.html
RewriteEngine On
RewriteBase /
RewriteCond %{QUERY_STRING} ^p=(.*)
RewriteRule ^$ /p/%1.html? [R=301,L]
and every post has a header like:
--- id: 60 title: Some title of a boring old post date: 2016-10-11T11:07:45+00:00 author: youknowwho layout: page-fullwidth guid: http://barelywalking.com/?p=60 permalink: /p/60.html categories: - matlab - robots ---