From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christian Moe Subject: Re: [ANN][RFC] org-odt.texi/org-odt.pdf preview (was Re: Org-odt table format) Date: Thu, 27 Oct 2011 11:09:24 +0200 Message-ID: <4EA91FC4.8000008@christianmoe.com> References: <8162jbabcv.fsf@gmail.com> <81y5w78w95.fsf_-_@gmail.com> Reply-To: mail@christianmoe.com Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([140.186.70.92]:60894) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJLun-0002p2-QX for emacs-orgmode@gnu.org; Thu, 27 Oct 2011 05:06:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RJLum-0000zm-M6 for emacs-orgmode@gnu.org; Thu, 27 Oct 2011 05:06:21 -0400 Received: from b1.hitrost.net ([91.185.211.67]:29501) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJLum-0000vB-5Q for emacs-orgmode@gnu.org; Thu, 27 Oct 2011 05:06:20 -0400 Received: from lk.92.63.17.213.dc.cable.static.lj-kabel.net ([92.63.17.213] helo=Celebrian-2.local) by b1.hitrost.net with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.76) (envelope-from ) id 1RJLuD-0023Zx-QZ for emacs-orgmode@gnu.org; Thu, 27 Oct 2011 11:05:45 +0200 In-Reply-To: <81y5w78w95.fsf_-_@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: "emacs-orgmode@gnu.org" Hi, Jambunathan, This is great. I'd be happy to proofread. What's the best way to return the proofs to you? A diff of the .texi? A couple of questions and suggestions. First, about the syntax rather than about the manual: - Image attributes: Are the parentheses needed in the ATTR_ODT line? (This is not about the manual, but about the syntax.) It would be simpler and generally more consistent with user expectations from other ATTR lines, I think, if it worked like this: #+ATTR_ODT: :width 10 :height 10 About the manual: - Literal examples: - Add a hint, where does one get an enhanced htmlfontify.el? - References and captions (not covered): It would be worth mentioning in the Tables and Images sections that these will work, but that you may need to use Tools>Update>Fields in LibreOffice to get them displayed right. - There are some long technical sections that are great if you want to get under the hood, but may be a bit intimidating, and that come before the short first-aid stuff. You might want to consider: - Starting "Applying Custom Styles" with a simple howto setting out the user-friendly steps: export an ODT (with num:t and any other settings needed to get all the styles), tweak its looks in LibreOffice (preserving heading numbering as an option), save the result and point to it with ODT_STYLES_FILE. (As it is, the manual gives a strong impression that the user will have to mess with XML files to get custom styles.) - Possibly moving "Exporting and Converting to Other Formats" to the end of the manual. - Possibly separating out the explanation of custom table styles as a separate section and moving it to the end of the manual. (BTW, custom table styles sounds great, I'm looking forward to trying this out.) Yours, Christian On 10/26/11 8:04 PM, Jambunathan K wrote: > > The org-odt.texi and org-odt.pdf are in the parent of this mail. It is > also accessible as attachment at > http://article.gmane.org/gmane.emacs.orgmode/48468 > > Proof readers invited. >