Markdown pages

[peterdesmet]

In a follow up of #118, I have created a Markdown version of the standards page.

Remarks:

• Translation of: https://github.com/okfn/data.okfn.org/blob/master/views/standards/index.html
• The page contains 6 relational links: depending on where the page lives, they might need to be updated.
• I kept the div for the side menu .well, but depending on how the html page is generated (what engine is used for this?) this might need some updating
• I placed this file in the /doc directory. Probably a new directory should be created for all Markdown content of the site.
• This branch can be used to create markdown versions of all pages of the website (e.g. before being merged), but I'll needs some input on how best to move forward.

[rufuspollock]

@peterdesmet have you tested this locally - ie. run node run.js and looked at the site?

[peterdesmet]

I haven't. I guess I should follow the instructions in the README to get this running locally?

[rufuspollock]

@peterdesmet yes - don't worry if this is too much hassle but it would be super useful :-)

[peterdesmet]

Well, that wasn't too hard to do. Here's the result:

As mentioned above, there are a couple of issues:

• We would need a single directory (e.g. pages) for all markdown pages that make up the website. standards.md could be placed in the root of that directory, while the documentation can stay together in pages/doc. The config to create the site would have to be updated.

• When can then also use another html template for standards. Currently the doc template is used, which is narrower and has no side menu.

• If we want to keep the side menu, we would have to find a solution to include this. It's fairly easy to hardcode this in the standards template, but it would be much better if that content was also in the markdown page. My current attempt (wrapping my markdown in <div class="well">) however doesn't parse the markdown:

  

[rufuspollock]

Good work but I wonder if we just leave this as a template for the moment as it seems painful to get perfectly right - unlike the docs we won't edit it so much.

BTW: would really love your assistance improving http://data.okfn.org/doc/publish-geodata

[peterdesmet]

Improving geospatial data documentation: do you mean continuing this discussion?

[rufuspollock]

Yes - just left a comment there.

[rufuspollock]

OK, i'm closing this PR for the time being.