From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christian Moe Subject: Re: [PATCH][ANN] org-html/org-odt Date: Tue, 12 Apr 2011 16:47:50 +0200 Message-ID: <4DA46616.2080206@christianmoe.com> References: <811v21sjy9.fsf@gmail.com> <4D87C26A.2070700@christianmoe.com> <81zknveumx.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]:52536) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q9eoW-0008WL-Bw for emacs-orgmode@gnu.org; Tue, 12 Apr 2011 10:43:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q9eoU-0005xl-Rg for emacs-orgmode@gnu.org; Tue, 12 Apr 2011 10:43:32 -0400 Received: from mars.hitrost.net ([91.185.211.18]:43990) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q9eoU-0005s9-8X for emacs-orgmode@gnu.org; Tue, 12 Apr 2011 10:43:30 -0400 In-Reply-To: <81zknveumx.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: Jambunathan K Cc: emacs-orgmode@gnu.org Hi, Great! I'll test again, but I need to come up for air from other work first, so it will take a few days before you hear anything. As you saw, most of my earlier concerns about captions/cross-references went away when I realized updating fields solved them. Thanks for the additional explanation. The 40-page report went mostly fine except for the problem I reported earlier, that many paragraphs were split for no apparent reason. I'll check that again, too, and report back. Yours, Christian On 4/12/11 10:33 AM, Jambunathan K wrote: > > Christian > > I have fixed most of the issues that you had reported earlier. > > I have added two new features: > > 1. Attaching Custom Styles to the document > - See http://permalink.gmane.org/gmane.emacs.orgmode/40026 > > 2. TOC and Outline numbering are done natively. i.e., > Tools->Update->Update All would update TOC index automagically. (This > wasn't the case with earlier exporter) > >> * Blocks >> >> There's no syntax highlighting in exported src blocks (ODT and HTML >> both). Not a priority? > > Currently syntax highlighting is done using htmlize. This package is not > part of Emacs proper and has to be installed separately. Since my setup > instructions doesn't include htmlize as part of load path, HTML source > blocks are uncolored. > > As for ODT, fonitification support is missing. I can probably take it up > once my sources gets in to Orgmode proper. > > As a side-note, I wonder htmlize was preferred over htmlfontify for > fontification of source blocks. The latter package is part of Emacs > proper. One advantage of using htmlfontify is that fontification can > work out of the box. > > >> The OrgVerse style can, luckily, be changed to something more >> poetic... > > May be if you can share your config for OrgVerse I can include it in the > default styles file. > >> * Verbatim LaTeX >> >> I can't report on the LaTeX math display (never got dvipng to install >> on my system). >> >> What I /can/ report is that with the =LaTeX:verbatim option=, which >> you probably haven't tested, LaTeX equation environments are not >> exported (everything after the =\begin{equation}= line is missing or >> not visible). This is copy-pasted from test.odt: >> >> #+begin_example >> 6.5.1 LaTeX Fragment1 >> >> There is a equation down below. >> \begin{equation} >> >> 6.5.2 LaTeX Fragment2 >> >> \begin{equation} >> If $a^2=b$ and \( b=2 \), then the solution must be either $$ >> a=+\sqrt{2} $$ or \[ a=-\sqrt{2} \]. >> #+end_example > > I have fixed issues with LaTeX: verbatim. > >> >> Everything shows up in HTML, but linebreaks before the >> =\end{equation}= line are lost. > > In the master branch, the html exporter doesn't seem to be terminating > each line of \begin{equation} ... \end{equation} with
. I see your > POV that including of line breaks will make the output pretty. For now I > have retained the existing behaviour of HTML exporter. > >> >> * Links >> >> The link to =Dedicated Target1= under 8.2.3 does not work when clicked >> (in odt -- it works in html). Hovering does show a popup, >> =.OrgXref.Dedicated-Target1=. All other links work as expected. > > I have fixed this. > >> >> * Captions, labels, references >> >> - *Captions/labels/references* do not yet integrate well with >> OpenOffice. > >> - The illustration in sec 6.2.2 is captioned "Illustration fig:1024 >> Unicorn Logo", echoing the label. One would probably prefer >> something *auto-numbered* like "Illustration 1: Unicorn Logo". > >> - (Even better if there were possible to choose other types names, >> like Chart, Figure, etc.). > > References in Orgmode file are currently coded like this > "\ref{fig:1024}". Note that this is of the form "category:value" where > category could be one (or any) of Chart, Figure etc and value is the > sequential value. > > In the example above (which if from my test.org file) you will see that > Fig appears in caption and all Fig stuff is sequentially numbered once > the Document is updated with Tools->Update->Update All. > > Note: For sake of completeness one can declare "Fig" as sequential > variable in content.xml as is done for "Illustrations". > > --8<---------------cut here---------------start------------->8--- > > --8<---------------cut here---------------end--------------->8--- > > This is done as part of `org-odt-begin-office-body'. > > >> - The reference to the same illustration is a hyperlink containing >> part of the label text ("1024"). A *cross-reference field* would >> be preferable to a hyperlink, and "Illustration 1" or similar >> better than "1024". > >> - The table caption in sec 9.2, on the other hand, works the way I >> would want illustration captions to work: What appears in the >> caption is not the label text ("table:10"), but the auto-numbered >> "Table 1 An Example Table". > >> - (It would be nice to have a colon or other *separator* between >> label and caption text: "Table 1: An Example Table".) > > The caption now has a Colon separator. > >> - However, the reference to that table appears as a hyperlink saying >> "10", and the hyperlink does not appear to work. A cross-reference >> link to "Table 1" would be better. > >> On opening, caption and reference labels include verbatim the >> reference key used in the Org source, which was my main concern last >> time. >> >> But now I realize that this is not an issue after all! =Tools> Update >>> Update all= takes care of automatic renumbering of all >> labels/references. This should probably be mentioned in the >> documentation. > > Tools->Update->Update All (OpenOffice.org) will make sure that all > references to Tables and Images are 'correct'. Yes, this needs to be > mentioned in the manual. > >> Exporting one of my own documents, I also found that: > >> - A space is inserted before *footnote markers*; it shouldn't be. You >> can't see this in the text document, where there is space before all >> footnote references anyway. > >> - Paragraphs were frequently split up, mid-sentence, by unwanted >> paragraph breaks. This bug is a bit of a mystery. The extra >> paragraph breaks appear where there is a newline in the text. But I >> can't discern any pattern as to why breaks are inserted at these >> newlines and not others. Nothing similar happens in HTML export. > > Doest his problem still exists with the new odt exporter. Can you send > me a sample .org file and the generated .odt file. > >> Tomorrow, I'll throw a 40-page report at it and see what happens. >> :) > > What happened? > >> >> Yours, >> Christian >> >> >> >> >> On 3/20/11 7:32 PM, Jambunathan K wrote: >>> >>> This is a formal request to integrate my org-html.el& org-odt.el >>> changes in to the master branch. >>> >>> This patch introduces 3 major features: >>> 1. A generic exporter >>> 2. All new html backend re-implemented as a plugin to (1). >>> 3. A odt backend as a plugin to (1). >>> >>> The patch is based on git commit 3d802. >>> >>> I am attaching a sample test.org and test.html file generated by the >>> above set of changes. >>> >>> Http URL for the repo is: >>> - http://repo.or.cz/w/org-mode/org-jambu.git/shortlog/refs/heads/staging >>> (`staging' branch of `org-jambu.git') >>> >>> Let me know if you have any questions. >>> >>> ps: Considering the amount of effort I have already invested in these >>> patches it is almost impossible for me to break down this monolithic >>> patch in to series of smaller patches. I would be willing to accommodate >>> all other requests. >>> >>> >>> >>> >>> >>> >>> Jambunathan K. >>> > >