<div dir="ltr">Hi Simon,<div><br></div><div>Have you any thoughts on Stylus (the default CSS pre-processor that comes with Docpad)? Justin and I have been having off-and-on discussions about moving forward with choosing a pre-processor for Infusion work, so any notes you may have would be helpful.</div>
<div><br></div><div>Will markdown be sufficient for our documentation needs, or will we expect to mix in HTML as well? i.e. If you want to apply special styles or formatting (i.e. you want to have an image floated left and text to the right) you will have to revert to doing HTML.</div>
<div><br></div><div><br></div><div><br></div><div>Here's an interesting tip on using Docpad (not related to the Infusion docs) - you can chain extensions on a file to execute processing multiple times - i.e. <a href="http://IoCSS.html.eco.eco.md">IoCSS.html.eco.eco.md</a></div>
<div><br></div><div>This is particularly handy in cases where an eco template has a query that returns an eco template fragment which then needs to be converted to HTML. If a single .eco extension, we will only see the eco fragment in the HTML, but with a second eco extension, that eco fragment gets converted into HTML.</div>
<div><br></div><div>There may be a more proper way of doing this, but it was the only way I discovered to process eco templates that were 2 levels deep.</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">
On Mon, May 26, 2014 at 4:10 PM, Bates, Simon <span dir="ltr"><<a href="mailto:sbates@ocadu.ca" target="_blank">sbates@ocadu.ca</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi all,<br>
<br>
We have been working on converting the Fluid Infusion documentation to Markdown and moving it to GitHub:<br>
<br>
<a href="https://github.com/fluid-project/infusion-docs" target="_blank">https://github.com/fluid-project/infusion-docs</a><br>
<br>
While our initial target for the documentation has been the GitHub source browser, our long term plan is to move to a static site generator so that we have control over the presentation of the documentation.<br>
<br>
Last week I spent a bit of time exploring GitHub pages as an alternative to viewing the rendered Markdown in the GitHub browser. My investigation left me feeling like GitHub pages was not a great option. Using GitHub pages would give us a GitHub manged instance of the Jekyll site generator but no templates or styling -- we would have to implement those ourselves. This got me thinking -- if we would have to put in the work to template and style ourselves to get benefit from GitHub's Jekyll, how much work would it be to go ahead and implement a solution that is closer to our long term plan?<br>

<br>
So, I decided to have a go at moving the documentation that we have converted so far to DocPad, a JavaScript static site generator built on Node.js. I am using Foundation for the layout and Highlight.js for syntax highlighting (minimal styling has been done beyond the defaults). The result is in GitHub and I have included instructions in the README.md on how to run DocPad locally so that you can try it out:<br>

<br>
<a href="https://github.com/simonbates/infusion-docs-docpad" target="_blank">https://github.com/simonbates/infusion-docs-docpad</a><br>
<br>
I would like to propose that we go ahead and move to DocPad and I would like to get input on what others think of this option?<br>
<br>
Here are some observations and thoughts:<br>
<br>
* the documentation is in src/documents (DocPad default but configurable)<br>
* unprocessed files (CSS, JS, images) are in src/files (DocPad default but configurable)<br>
* I am imagining that we would set up a nightly build to run DocPad and upload the generated HTML to a web server (either one we manage, or it could be GitHub pages)<br>
* before we make the pages public, we would need to do some templating and styling work<br>
* DocPad uses file name extensions to specify what processing should be done on each file and this results in the documents having names such as <a href="http://IoCSS.html.md" target="_blank">IoCSS.html.md</a> (meaning convert from Markdown to HTML); this could be a little clunky and it is possible to rely on some defaults handling and name the documents without the ".html", such as IoCSS.md<br>

* when serving the pages from GitHub, we link to the Markdown file, such as IoCSS.md; switching to DocPad would require us to change our link targets to the generated HTML file names, such as IoCSS.html (I am investigating this now to see if there is any special link handling that might be useful here)<br>

<br>
Please have a look at the DocPad version of the docs and let me know what your thoughts are.<br>
<br>
Thanks,<br>
Simon<br>
_______________________________________________________<br>
fluid-work mailing list - <a href="mailto:fluid-work@fluidproject.org">fluid-work@fluidproject.org</a><br>
To unsubscribe, change settings or access archives,<br>
see <a href="http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work" target="_blank">http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><p style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><b style="font-size:12.499999046325684px"><span style="font-size:10pt;font-family:Tahoma,sans-serif">JONATHAN HUNG</span></b></p>
<div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:10pt;font-family:Tahoma,sans-serif">INCLUSIVE DESIGNER, IDRC<u></u><u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)">
<p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif"><span style="font-size:10pt;font-family:Tahoma,sans-serif"><u></u> <u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)">
<p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif"><b><span style="font-size:10pt;font-family:Tahoma,sans-serif">T:</span></b><span style="font-size:10pt;font-family:Tahoma,sans-serif"> <a value="+14169776000" style="color:rgb(17,85,204)">416 977 6000 x3951</a><u></u><u></u></span></p>
</div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">F:</span></b><span style="font-size:10pt;font-family:Tahoma,sans-serif"> <a value="+14169779844" style="color:rgb(17,85,204)">416 977 9844</a><u></u><u></u></span></p>
</div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">E:</span></b><span style="font-size:10pt;font-family:Tahoma,sans-serif"> <a href="mailto:jhung@ocadu.ca" style="color:blue" target="_blank">jhung@ocadu.ca</a><u></u><u></u></span></p>
</div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:10pt;font-family:Tahoma,sans-serif"><u></u> <u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">OCAD UNIVERSITY</span></b><span style="font-size:10pt;font-family:Tahoma,sans-serif"><u></u><u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)">
<p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif"><span style="font-size:10pt;font-family:Tahoma,sans-serif">Inclusive Design Research Centre<u></u><u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)">
<p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif"><span style="font-size:10pt;font-family:Tahoma,sans-serif">205 Richmond Street W, Toronto, ON, M5V 1V3<u></u><u></u></span></p>
</div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:10pt;font-family:Tahoma,sans-serif"><u></u> <u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)"><p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:10pt;font-family:Tahoma,sans-serif"><a href="http://www.ocadu.ca/" style="color:blue" target="_blank">www.ocadu.ca</a><u></u><u></u></span></p></div><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.499999046325684px;background-color:rgb(255,255,255)">
<p style="margin:0cm 0cm 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif"><span style="font-size:10pt;font-family:Tahoma,sans-serif"><a href="http://www.idrc.ocad.ca/" style="color:blue" target="_blank">www.idrc.ocad.ca</a></span></p>
</div>
</div>