dreqML as asciidoc

[martinjuckes]

Initial attempt: generate asciidoc from libre office document using pandoc. Results in a valid file (minus included figure), but does not render well in github.

[martinjuckes]

Tables made legible by removing multi-column first line.

[martinjuckes]

Use of square brackets is evidently a problem .. pandoc has not escaped these, and they wreck the asciidoc parsing done within github.

[martinjuckes]

Also a problem with underscore in URL. Solution found here: https://github.com/asciidoctor/asciidoctor/issues/625

For []: the backslash does not appear to work consistently, may need to use [ and ].

[martinjuckes]

travis CI set up, with a devel branch created and execution of build.sh triggered by commit to master branch. build.sh runs jekyll and copies html files from _site back into the main repo.

See: http://eshepelyuk.github.io/2014/10/28/automate-github-pages-travisci.html and https://github.com/asciidoctor/jekyll-asciidoc

[martinjuckes]

Not updating now because it claims local copy is up to date .. despite changes committed in devel. Not clear what is happening.

[martinjuckes]

Appear to have a problem with managing versions of HTML .... the build.sh put html in with the asciidoc files, and will not create new html files because of the presence of the ones it created before ...

[martinjuckes]

Last point appears to have been resolved by placing asciidoc files in a separate folder, and using the build.sh script to move the resulting html into the target folder.

[martinjuckes]

dreq.css is not in an appropriate location at present.

[martinjuckes]

Tried to fix css, but need another build .... appears to have used old layout file to generate html.

[martinjuckes]

https://stackoverflow.com/questions/21998728/how-to-specify-a-git-commit-message-template-for-a-repository-in-a-file-at-a-rel explains how to set up a template for commit messages in a working copy ... but doesn't appear to work at github.com