Grunt config for infusion-docs
tony at raisingthefloor.org
Fri May 9 09:12:17 EDT 2014
Both the differences I was picking up on are indeed simply controlled using
On Fri, May 9, 2014 at 2:29 PM, Bates, Simon <sbates at ocadu.ca> wrote:
> 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
> *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:
> 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?
> On Thu, May 8, 2014 at 1:53 PM, Bates, Simon <sbates at ocadu.ca> wrote:
>> This morning I created a Grunt config for infusion-docs to build the docs
>> 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.
>> fluid-work mailing list - 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...
More information about the fluid-work