When I created About Me page I found issue with rendering: for some reason styles and some javascripts were missing on the page.
Investigation showed that content in meta tag description contained unquoted quotes, thus resulting in broken HTML.
After searching within octopress sources I found the issue:
Rendering of description tag, excerpt from _includes/head.html:
{% capture description %}
{% if page.description %}
{{ page.description }}
{% else %}
{{ content | raw_content }}
{% endif %}
{% endcapture %}
<meta name="description" content="{{ description | strip_html | condense_spaces | truncate:150 }}">
After capturing, description is being processed with filters, defined in plugins/octopress_filters.rb. In this case, the following filter are applied:
So, as you can see, if description contains quotes, then it will be rendered as is, without any escaping and quotes will break resulting page.
In order to fix this I decided to add new filter, which will just remove quotes.
So, let’s add new function, strip_quotes in plugins/octopress_filters.rb:
strip_quotes function:
# Strips quotes
def strip_quotes(input)
input.gsub(/[\'\""]/, '')
end
And then we need to update rendering of description tag - add newly created filter:
<meta name="description" content="{{ description | strip_html | condense_spaces | strip_quotes | truncate:150 }}">
After this fix description is being rendered properly.
P.S. In order to render properly {{ and }} in the octopress it is required to put content you want to render within raw and endraw tags. See StackOverflow questions for details.