Building the documentation


(Ivan Brusic) #1

I have been accumulating a few documentation inconsistencies over the past
several months and I wanted to finally fix them and contribute them back.
Last time I made any changes was in the old markdown repository. I am
referring to the documentation under the main project (
https://github.com/elasticsearch/elasticsearch/tree/master/docs) not the
new documentation repo (https://github.com/elasticsearch/docs).

How is the site asciidoc built? Since Github uses asciidoctor, I have tried
using it, but I cannot come up with a way to create the same directory
structure using the default stylesheets/templates, so there is obviously
more to building the documents that what is included in git. Or am I
missing something? My sole command line flag is ''-d book".

Cheers,

Ivan

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQAY6VPkPobCKzZf3wgOFZa%3D_UdVtotP%2Bd8kidiOLaKYsQ%40mail.gmail.com.
For more options, visit https://groups.google.com/groups/opt_out.


(Ivan Brusic) #2

It seems I have misunderstood the intent of the new documentation repo and
it is indeed what I am looking for. I assumed it was the WIP elasticsearch
book. Asciidoc is fairly simple, not sure why this level of complexity is
needed.

Cheers,

Ivan

On Sat, Jan 11, 2014 at 12:01 PM, Ivan Brusic ivan@brusic.com wrote:

I have been accumulating a few documentation inconsistencies over the past
several months and I wanted to finally fix them and contribute them back.
Last time I made any changes was in the old markdown repository. I am
referring to the documentation under the main project (
https://github.com/elasticsearch/elasticsearch/tree/master/docs) not the
new documentation repo (https://github.com/elasticsearch/docs).

How is the site asciidoc built? Since Github uses asciidoctor, I have
tried using it, but I cannot come up with a way to create the same
directory structure using the default stylesheets/templates, so there is
obviously more to building the documents that what is included in git. Or
am I missing something? My sole command line flag is ''-d book".

Cheers,

Ivan

--
You received this message because you are subscribed to the Google Groups "elasticsearch" group.
To unsubscribe from this group and stop receiving emails from it, send an email to elasticsearch+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQBUuUinm%2BkwmNEwsMYViV_KfPp1hR23prVyKN5O4chGhA%40mail.gmail.com.
For more options, visit https://groups.google.com/groups/opt_out.


(system) #3