accumulo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Billie Rinaldi <>
Subject Re: asciidoc manual
Date Wed, 01 May 2013 17:59:02 GMT
On Wed, May 1, 2013 at 10:43 AM, Josh Elser <> wrote:

> Nice! Those code snippets look awesome.

Yeah, I really like the syntax highlighting and that it comes through in
both the html and the pdf.

> I think the only things that stands out at me are that the tables are a
> little gross looking (notably 6.3 and 6.4, "Indexing" and "Entity-Attribute
> and Graph Tables"). I'll try to look around tonight, but is there something
> we could do to get column and row outlines? Does asciidoc have any notion
> of plugins that we could leverage for prettier tables?

What do you dislike about the tables?  Asciidoc tables aren't very
configurable, but there are a few things that can be changed.  Do you mean
grid lines for the table, lines between each column and row?  We can add
those, the options are "none", "rows", "cols" or "all".  I'll try adding
row lines and see if it helps.

> Thanks for looking into this!
> On 5/1/13 1:10 PM, Billie Rinaldi wrote:
>> I've been experimenting with converting the user manual to asciidoc.  On
>> balance, I think the resulting html and pdf are better than our existing
>> ones, and the maintenance will be easier.  For a preview, see
>> In particular
>> accumulo_user_manual.html<>
>> and
>> accumulo_user_manual.pdf<>
>> To generate these documents, I installed asciidoc, dblatex, and
>> source-highlight, then ran the following commands.
>> To generate html: asciidoc -a toc -d book accumulo_user_manual.txt
>> To generate xml: asciidoc -a toc -b docbook -d book
>> accumulo_user_manual.txt
>> To generate pdf: dblatex -tpdf accumulo_user_manual.xml
>> Thoughts?
>> Billie

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message