On Wed, May 1, 2013 at 10:43 AM, Josh Elser <[email protected]> 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 >> >> http://people.apache.org/~**billie/asciidoc_user_manual<http://people.apache.org/~billie/asciidoc_user_manual> >> >> In particular >> http://people.apache.org/~**billie/asciidoc_user_manual/** >> accumulo_user_manual.html<http://people.apache.org/~billie/asciidoc_user_manual/accumulo_user_manual.html> >> and >> http://people.apache.org/~**billie/asciidoc_user_manual/** >> accumulo_user_manual.pdf<http://people.apache.org/~billie/asciidoc_user_manual/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 >> >> >
