Add documentation about writing an html activity
Make html build optional

On fedora jekyll is not packaged.
Fix a few missing escapes