Nanoc inflexibility

[connor]

If any of the captions include a ' (single quote), the rendered HTML/styling of that section gets mangled. I see in line 32 of Rules, it's using the RegEx that determines the match, which subsequently calls the method that renders the HTML (with <div class="example">...</div>).

For now, I've been modifying the captions to not use any quotes, so the page still looks correct.

I actually fixed this in pull request #56, but like Addy said, we may be ditching Nanoc.

<3

[connor]

Verifying that this is the cause of the problem. Re-writing the regex to be more flexible.

[addyosmani]

I'm going to try pulling in @ajpiano for this one. We've had some other issues come through regarding Nanoc (either the process being broken or improvable in some manner) and I think we need to make a call on whether we accept PRs against it.

Argument for is that it would help content contributors out in the short term, argument against is that it's quite different to what we're doing in the Wordpress branch.

Personally, I would say let's roll with the Nanoc changes for now. They might (probably) won't make it to the final version of the site, but I'd like to reduce barriers to people sending through PRs and testing that this content renders somewhat sanely.

[ajpiano]

Gonna roll with nanoc changes as it's not being ditched, just its role in the site has changed. Now it's just really an authoring tool and a pre-processor for wordpress. Just merged #56 so I'm gonna close this.