Return-Path: X-Original-To: apmail-accumulo-dev-archive@www.apache.org Delivered-To: apmail-accumulo-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 906E1F591 for ; Wed, 1 May 2013 17:59:28 +0000 (UTC) Received: (qmail 49780 invoked by uid 500); 1 May 2013 17:59:28 -0000 Delivered-To: apmail-accumulo-dev-archive@accumulo.apache.org Received: (qmail 49752 invoked by uid 500); 1 May 2013 17:59:28 -0000 Mailing-List: contact dev-help@accumulo.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@accumulo.apache.org Delivered-To: mailing list dev@accumulo.apache.org Received: (qmail 49744 invoked by uid 99); 1 May 2013 17:59:28 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 May 2013 17:59:28 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of billie.rinaldi@gmail.com designates 209.85.214.172 as permitted sender) Received: from [209.85.214.172] (HELO mail-ob0-f172.google.com) (209.85.214.172) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 May 2013 17:59:23 +0000 Received: by mail-ob0-f172.google.com with SMTP id v19so1492596obq.31 for ; Wed, 01 May 2013 10:59:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:content-type; bh=Gg9ySc+O1tp32T/Etof/x7gUs9LsBJL57thVFB8miE4=; b=mRLbNloof4l/9+Nhd9xwvs8iWUmoTN3v29kjkn0RFGU94Mu3JldED5RYl51bzMUQvz N0EHLWBNpeJJmhJCM3Ta7wcOmHfu/BUmhxLFznsmqOTrVJHJrduFkjvFAvn2nlWWKVuQ Kc5fpHMFfkxN+2/lN9Z3q+3nYv5tzwtoGbR9pUwtNFsBeA9z9/0mrzpYxAq4d2GaJEe0 lo1sUjFbpMV+C6mGufAeKtP6yXss3K+KkCKxNf1EzaKhDLfEf1Xx2oO2d1ki9Mdz4bRO E/QPwh3DDwpiYP7GRGV/AU1oti5vX0w/3FRMKoHUyuE65Y/JXEucI6pWJK3ZIOrKmXcu mfrA== MIME-Version: 1.0 X-Received: by 10.60.83.70 with SMTP id o6mr882878oey.81.1367431142556; Wed, 01 May 2013 10:59:02 -0700 (PDT) Received: by 10.76.162.230 with HTTP; Wed, 1 May 2013 10:59:02 -0700 (PDT) In-Reply-To: <51815440.7000105@gmail.com> References: <51815440.7000105@gmail.com> Date: Wed, 1 May 2013 10:59:02 -0700 Message-ID: Subject: Re: asciidoc manual From: Billie Rinaldi To: dev@accumulo.apache.org Content-Type: multipart/alternative; boundary=089e01176ceb81d15f04dbabdf05 X-Virus-Checked: Checked by ClamAV on apache.org --089e01176ceb81d15f04dbabdf05 Content-Type: text/plain; charset=ISO-8859-1 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 >> >> http://people.apache.org/~**billie/asciidoc_user_manual >> >> In particular >> 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 >> >> 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 >> >> > --089e01176ceb81d15f04dbabdf05--