Re: [rvm-research] Migration of web site and future of the user guide

Hi,

On 04.05.2015 10:51, Andreas Sewe wrote:
> I would suggest Asciidoc [1]. It uses a Wiki-like syntax like Markdown,
> but has also a couple of more powerful features and an actual
> spec/grammar. With Asciidoctor there is also JVM-based tooling
> available, using JRuby to run the original asciidoc (which is written in
> Ruby).
Thanks for the hint. Asciidoc sounds like it could be a good option to satisfy our requirements.

> AFAIK, Github also supports Asciidoc (use .adoc instead of .md)
We're using GitHub pages with Jekyll for the website. With this kind of setup, only HTML and GitHub-flavored markdown seem to be supported. There are plugins for Jekyll to support more formats but GitHub deactivates all plugins by default by setting the safe option [1]. None of the whitelisted plugins [2] adds support for more formats.

We're going to have to generate the HTML user guide manually when updating the source files. IMHO that's not a problem because the userguide doesn't change that often.


Kind regards,

Erik Brangs


[1] https://help.github.com/articles/using-jekyll-with-pages/#configuring-jekyll
[2] https://help.github.com/articles/using-jekyll-plugins-with-github-pages/

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud 
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y