Grunt config for infusion-docs

[Bates, Simon]

Hi Tony,

At this point, I've not done a lot of comparison between the HTML from marked and that generated from GitHub.

It terms of visual appearance, there are likely to be a number of differences. Including the styling of the headings and of code blocks, as you mention. The marked output is just the HTML rendering and is without any CSS styles. To match the visual appearance from GitHub, you would need to create, or possible re-use, a CSS stylesheet that provided the GitHub appearance.

Simon

________________________________
From: Tony Atkins [tony at raisingthefloor.org]
Sent: Friday, May 09, 2014 8:16 AM
To: Bates, Simon
Cc: Fluid Work ‎[fluid-work at fluidproject.org]‎
Subject: Re: Grunt config for infusion-docs

Hi, Simon:

How closely were you able to get marked to follow the conventions of github-flavored-markup?  I ask because I am writing API documentation using GFM and am super happy with the display on GitHub, but not what I'm able to get using marked.

The markup:  https://github.com/the-t-in-rtf/common-terms-registry/blob/master/express/api/ctr.md

The "marked" output is only running locally at the moment, so I've attached it.  The code blocks and lack of horizontal rules are the most obvious differences.  Any ideas?

Cheers,


Tony



On Thu, May 8, 2014 at 1:53 PM, Bates, Simon <sbates at ocadu.ca<mailto:sbates at ocadu.ca>> wrote:
This morning I created a Grunt config for infusion-docs to build the docs locally:

https://github.com/simonbates/infusion-docs/tree/FLUID-5365

It uses grunt-markdown which in turn uses marked.

The config processes all *.md files in the top level and writes HTML files to an html/ directory.

There will be an issue with local links -- we are currently targeting reading on GitHub and as such our link destinations are the *.md files. With this build config, those links won't work. Let's continue with using the *.md links for now while we figure out our deployment strategy.

Simon
_______________________________________________________
fluid-work mailing list - fluid-work at fluidproject.org<mailto:fluid-work at fluidproject.org>
To unsubscribe, change settings or access archives,
see http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.idrc.ocad.ca/pipermail/fluid-work/attachments/20140509/d21b3e32/attachment.htm>