--- layout: post title: "Jekyll Fails to Find Closing Tags in Markup" date: 2014-02-04 tags: - Jekyll - Jekyll v1.4.3 --- As I was adding RSS feed to this blog, I ran into some trouble. Although the my efforts were successful on both master and development branches, my success was limited to my local machine. When I tried to push my changes to GitHub, I received the following build error:

The file `_posts/2013-09-07-Jekyll-can-be-tricky-business.markdown` contains markdown errors

Not only couldn't I reproduce this error locally, but the post in question was published successfully without issue or changes to it since it was published! Since I couldn't reproduce this error locally, I could not get a stack trace. Even rolling back my changes didn't get rid of this error, so after reading [GitHub's support documentation][github-jekyll] with no help, I contacted GitHub support to request a stack trace.

 ___________________________________________________________________________
| Maruku tells you:
+---------------------------------------------------------------------------
| Malformed HTML starting at "<ol>"
| ---------------------------------------------------------------------------
| <ol>EOF
| |---------------------------------------------------------------------------
| +--- Byte 0
| Shown bytes [0 to 4] of 4:
| ><ol>
|
| At line 7
|       text     |I've worked with Wordpress and Joomla in the past, but Github pages do not support those and their [documentation][github-pages] pointed me to [Jekyll][jekyll].|
|      empty     ||
|       text     |Setting up my Jekyll blog was not a simple task for a few reasons:|
|   raw_html --> |<ol>|
|       code     |      <li>Jekyll requires Ruby. Ruby doesn't play nice with Windows, which is the only brand of operating system that I use daily.</li>|
|       code     |      <li>If you want syntax highlighting for code snippets, you will need to install [Pygments][pygments-link]. However, in my case, Pygments kept breaking Jekyll. |
|       code     |      After a couple weekends of searching, I still had no solution and chose to just discard it.</li>|
 ___________________________________________________________________________
| Maruku tells you:
+---------------------------------------------------------------------------
| Maruku cannot parse this block of HTML/XML:
| |<ol>
| #<REXML::ParseException: Missing end tag for 'ol' (got "html")
| Line: 4
| Position: 163
| ...
| Missing end tag for 'ol' (got "html")
| Line: 4
| Position: 163
| Last 80 unconsumed characters:
|
| Line: 4
| Position: 163
\___________________________________________________________________________

As I looked at my source code, I clearly had an end tag for my <ol> list. Even with the stack trace, I still couldn't duplicate the error on my personal machine, preventing me from viewing the results of my experiments. One of my attempts to fix my GitHub repo's build error was to delete the entire repo and try again, a relatively extreme action. This idea was bad because it lost my commit history which would have proved that this error appeared seemingly out of nowhere--so now I am just a crazy person. What gave me this idea came from a past issue that remains unexplained. When writing one of my earlier posts, Jekyll couldn't build my site due to a markdown error I could not find even with the stack trace, file name, and line number. Running out of ideas, I created another Jekyll site and replaced the contents with those from my site and everything built and displayed without issue. Since GitHub only allows one [user page][github-pages] per account (I assumed I'd run into other hiccups if I tried project pages, but I should've done that before deleting a repo), I deleted my repo and made it again, but the build error remained. Eventually, I tried building my site from work. I already had Jekyll installed but never really used it, because we don't use it at work, and I'm supposed to be... working. I needed a mental break from a project, so I cloned my broken site and built it -or tried to- because I had finally duplicated repo server's build error! The version of Windows 7 and Ruby are the same as my personal machine but my work machine is running Jekyll v1.2.1, while I have v1.4.2 at home and GitHub as v1.4.3. Finally being able to duplicate the build error, I came to learn that Jekyll could no longer identify a closing tag a for list or list item if it is not on the same line as its opening tag. So instead of writing an HTML list like a normal person:

<ol>
   <li>List item 1</li>
   <li>List item 2</li>
</ol>

You have to write an HTML list like a goober:

<ol><li>List item 1</li><li>List item 2</li></ol>

If you look at my [source code][source-code] for this blog post, you'll see I couldn't even do {% highlight HTML %} ... {% endhighlight %} as advertised in [Jekyll's post documentation][jekyll-doc] because the end result will be HTML div, pre, and code tags that do not begin and end on the same line. This odd behavior does not appear to apply to <p>, <blockquotes>, or Jekyll v1.4.2 (an older version I had to install for [other issues][jekyll-bug] I intend to share later.) [github-jekyll]: https://help.github.com/articles/pages-don-t-build-unable-to-run-jekyll#viewing-build-error-messages [github-pages]: https://help.github.com/articles/user-organization-and-project-pages [source-code]: https://raw.github.com/campbeja/campbeja.github.io/dev/_posts/2014-02-04-Jekyll-Fails-to-Find-Closing-Tags-in-Markup.markdown [jekyll-doc]: http://jekyllrb.com/docs/posts/ [jekyll-bug]: http://stackoverflow.com/questions/21137096/jekyll-error-running-jekyll-serve#