Today I was surprised to find that my tag system on this website doesn’t work. My htmlproof continuously gave me errors such as these:

- ./_site/2014/08/09/composer-stuck/index.html
  *  internally linking to /blog/tag/composer/, which does not exist (line 175)
  *  internally linking to /blog/tag/php/, which does not exist (line 177)
- ./_site/2014/08/14/phpstorm-and-symfony2/index.html
  *  internally linking to /blog/tag/phpstorm/, which does not exist (line 175)
  *  internally linking to /blog/tag/symfony2/, which does not exist (line 177)

Later on I managed to find out that Jekyll was updated to version 3.0 and that Github started to use that same version as well. The bad thing was that they disabled feature I was using relative_permalinks. I was trying out various things and was at wits end but the solution was easier then expected.

Since my tags are stored in my repository as /blog/tags/some_tag.md the only thing I had to do was remove the permalink: some_tag from the tag itself and relative_permalinks:true from my _config.yml. Later on all tags starting perfectly as they were before.

If you’re using the same tagging system as I am or you’re using permalinks in some other parts of your Jekyll website consider removing them because they don’t work on 3.0.

Read More