* docbook export-special @ 2009-05-26 14:01 Rustom Mody 2009-05-26 23:49 ` Baoqiu Cui 2009-05-27 6:29 ` Rustom Mody 0 siblings, 2 replies; 9+ messages in thread From: Rustom Mody @ 2009-05-26 14:01 UTC (permalink / raw) To: emacs-orgmode Thanks Carsten for 6.27. Ive been playing around with docbook export and further processing and was looking for something like export-special. Now its come but not (yet) for the docbook exporter. Any likelihood of it being supported there? I would try to hack on the code myself but dont know enough docbook. What's the equivalent in docbook to html's div? ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: docbook export-special 2009-05-26 14:01 docbook export-special Rustom Mody @ 2009-05-26 23:49 ` Baoqiu Cui 2009-05-27 6:29 ` Rustom Mody 1 sibling, 0 replies; 9+ messages in thread From: Baoqiu Cui @ 2009-05-26 23:49 UTC (permalink / raw) To: emacs-orgmode Hi Rustom, Rustom Mody <rustompmody@gmail.com> writes: > Thanks Carsten for 6.27. > > Ive been playing around with docbook export and further processing and > was looking for something like export-special. > Now its come but not (yet) for the docbook exporter. What do you mean by export-special? Do you mean exporting blocks that look like the following lines? #+begin_xyz ... #+end_xyz (where "xyz" can be some DocBook element). Baoqiu > Any likelihood of it being supported there? > I would try to hack on the code myself but dont know enough docbook. > What's the equivalent in docbook to html's div? > > > _______________________________________________ > Emacs-orgmode mailing list > Remember: use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode > ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: docbook export-special 2009-05-26 14:01 docbook export-special Rustom Mody 2009-05-26 23:49 ` Baoqiu Cui @ 2009-05-27 6:29 ` Rustom Mody 2009-05-27 18:46 ` Baoqiu Cui 2009-05-28 7:47 ` Rustom Mody 1 sibling, 2 replies; 9+ messages in thread From: Rustom Mody @ 2009-05-27 6:29 UTC (permalink / raw) To: emacs-orgmode Baoqiu wrote: > What do you mean by export-special? Well the latest org comes with a contributed org-special-blocks.el [sorry I misnamed it] > Do you mean exporting blocks that look like the following lines? > #+begin_xyz > ... > #+end_xyz Yes I guess that would be what I want. ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: docbook export-special 2009-05-27 6:29 ` Rustom Mody @ 2009-05-27 18:46 ` Baoqiu Cui 2009-05-28 7:47 ` Rustom Mody 1 sibling, 0 replies; 9+ messages in thread From: Baoqiu Cui @ 2009-05-27 18:46 UTC (permalink / raw) To: emacs-orgmode Rustom Mody <rustompmody@gmail.com> writes: > Baoqiu wrote: >> What do you mean by export-special? > > Well the latest org comes with a contributed org-special-blocks.el > [sorry I misnamed it] > >> Do you mean exporting blocks that look like the following lines? > >> #+begin_xyz >> ... >> #+end_xyz > > Yes I guess that would be what I want. Thanks for the confirmation, Rustom. Carsten and I had several email exchanges on this topic last month, and we decided to not support such special blocks in DocBook exporter (see the following email). Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what you want? Thanks, Baoqiu > From: Carsten Dominik <carsten.dominik@gmail.com> > To: Baoqiu Cui <cbaoqiu@yahoo.com> > Cc: Carsten Dominik <dominik@science.uva.nl> > Subject: Re: [Orgmode] Re: markup in environments in latex export > Date: Wed, 29 Apr 2009 21:24:27 +0200 > > Hi Baoqiu, > > thank you very much for your input. I largely agree with > your assessment. > > - Carsten > > On Apr 27, 2009, at 7:37 PM, Baoqiu Cui wrote: > > > Hi Carsten, > > > > I thought about this during the weekend, and it seemed to me that it > > is > > better to let DocBook exporter ignore such arbitrary ``#+begin_xyz > > ... #+end_xyz'' blocks. There are several reasons: > > > > 1. LaTeX and DocBook use very different tag/element names. Even if > > we > > can find equivalent elements in DocBook for ``xyz'', supporting > > such LaTeX specific markups can confuse users. > > > > 2. For many ``xyz''s that are supported in LaTeX, we may not be able > > to find equivalent elements in DocBook. There is not similar > > thing > > in DocBook to do what <div class="xyz"> ... </div> does in HTML, > > AFAIK. > > > > 3. Supporting these blocks may open a big door for making exported > > DocBook XML files invalid. > > > > Personally I don't think it is even a good idea to support this LaTeX > > feature in Org mode. This feature may benefit a small number of > > Org+LaTeX users, in some uncommon use cases, but in general it hurts > > Org-mode's simplicity and cleanness. > > > > If I were Chris, I would not mind using real LaTeX syntax in > > > > \begin{xyz} > > ... > > \end{xyz} > > > > Thanks, > > Baoqiu ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: docbook export-special 2009-05-27 6:29 ` Rustom Mody 2009-05-27 18:46 ` Baoqiu Cui @ 2009-05-28 7:47 ` Rustom Mody 2009-05-28 9:00 ` Carsten Dominik 1 sibling, 1 reply; 9+ messages in thread From: Rustom Mody @ 2009-05-28 7:47 UTC (permalink / raw) To: emacs-orgmode Hello Baoqiu, Rustom Mody <rustompmody <at> gmail.com> writes: > Baoqiu wrote: >> What do you mean by export-special? > > Well the latest org comes with a contributed org-special-blocks.el > [sorry I misnamed it] > >> Do you mean exporting blocks that look like the following lines? > >> #+begin_xyz >> ... >> #+end_xyz > > Yes I guess that would be what I want. > Thanks for the confirmation, Rustom. Carsten and I had several email > exchanges on this topic last month, and we decided to not support such > special blocks in DocBook exporter (see the following email). > Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what > you want? > Thanks, > Baoqiu Well something would be better than nothing :-) My own view: latex and html are very different from docbook. 1. latex and html are specific presentation formats as against docbook which is a general content format 2. Conversely no one wants to use docbook for itself but rather as a stepping stone to something else -- typically pdf/html but in principle any arbitrary 'end'-format. This means that docbook-exporter allowing for potential docbook errors is a smaller problem than making impossible something which a. can be/is already available in org b. is supported in the 'end'-format c. but is unavailable in the interim (docbook) One such thing which may not be meaningful in latex and html but is a lack in docbook is property exports. Maybe if you or Carsten feel this should not go into org then org-special-blocks is the place for it? ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Re: docbook export-special 2009-05-28 7:47 ` Rustom Mody @ 2009-05-28 9:00 ` Carsten Dominik 2009-05-28 12:16 ` Rustom Mody 0 siblings, 1 reply; 9+ messages in thread From: Carsten Dominik @ 2009-05-28 9:00 UTC (permalink / raw) To: Rustom Mody; +Cc: emacs-orgmode On May 28, 2009, at 9:47 AM, Rustom Mody wrote: > Hello Baoqiu, > > Rustom Mody <rustompmody <at> gmail.com> writes: > >> Baoqiu wrote: >>> What do you mean by export-special? >> >> Well the latest org comes with a contributed org-special-blocks.el >> [sorry I misnamed it] >> >>> Do you mean exporting blocks that look like the following lines? >> >>> #+begin_xyz >>> ... >>> #+end_xyz >> >> Yes I guess that would be what I want. > >> Thanks for the confirmation, Rustom. Carsten and I had several email >> exchanges on this topic last month, and we decided to not support >> such >> special blocks in DocBook exporter (see the following email). > >> Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what >> you want? > >> Thanks, >> Baoqiu > > Well something would be better than nothing :-) > > My own view: latex and html are very different from docbook. > 1. latex and html are specific presentation formats as against docbook > which is a general content format > 2. Conversely no one wants to use docbook for itself but rather as a > stepping stone to something else -- typically pdf/html but in > principle any arbitrary 'end'-format. This means that > docbook-exporter allowing for potential docbook errors is a smaller > problem than making impossible something which > a. can be/is already available in org > b. is supported in the 'end'-format > c. but is unavailable in the interim (docbook) > > One such thing which may not be meaningful in latex and html but is a > lack in docbook is property exports. This, I think, was the reason why we could not see a good way to do this in docbook. - Carsten > > Maybe if you or Carsten feel this should not go into org then > org-special-blocks is the place for it? I think you need to come up with a concrete implementation proposal. - Carsten > > > _______________________________________________ > Emacs-orgmode mailing list > Remember: use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Re: docbook export-special 2009-05-28 9:00 ` Carsten Dominik @ 2009-05-28 12:16 ` Rustom Mody 2009-05-28 16:49 ` Baoqiu Cui 2009-06-03 12:28 ` Rustom Mody 0 siblings, 2 replies; 9+ messages in thread From: Rustom Mody @ 2009-05-28 12:16 UTC (permalink / raw) To: emacs-orgmode On Thu, May 28, 2009 at 2:30 PM, Carsten Dominik <carsten.dominik@gmail.com> wrote: > > On May 28, 2009, at 9:47 AM, Rustom Mody wrote: > >> Hello Baoqiu, >> >> Rustom Mody <rustompmody <at> gmail.com> writes: >> >>> Baoqiu wrote: >>> Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what >>> you want? Hell! I could swear that I tried this yesterday and the content disappeared! Today its appearing in the xml output so thats probably enough. I worked out the current mappings as i find them: 1 BEGIN_QUOTE -> <blockquote> 2 BEGIN_EXAMPLE -> <programlisting> 3 BEGIN_SRC lang -> <programlisting> 4 BEGIN_VERSE -> <literallayout> 5 BEGIN_CENTER -> something complicated It would ne nice if something like this is there at least in the org-docbook.el sources -- The manual is long enough and need not be lengthened with the requirements of fringe users like Yours truly :-) ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: docbook export-special 2009-05-28 12:16 ` Rustom Mody @ 2009-05-28 16:49 ` Baoqiu Cui 2009-06-03 12:28 ` Rustom Mody 1 sibling, 0 replies; 9+ messages in thread From: Baoqiu Cui @ 2009-05-28 16:49 UTC (permalink / raw) To: emacs-orgmode Rustom Mody <rustompmody@gmail.com> writes: > On Thu, May 28, 2009 at 2:30 PM, Carsten Dominik > <carsten.dominik@gmail.com> wrote: >> >> On May 28, 2009, at 9:47 AM, Rustom Mody wrote: >> >>> Hello Baoqiu, >>> >>> Rustom Mody <rustompmody <at> gmail.com> writes: >>> >>>> Baoqiu wrote: >>>> Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what >>>> you want? > > Hell! I could swear that I tried this yesterday and the content disappeared! > Today its appearing in the xml output so thats probably enough. I am very glad to know that this works for you. > I worked out the current mappings as i find them: > 1 BEGIN_QUOTE -> <blockquote> > 2 BEGIN_EXAMPLE -> <programlisting> > 3 BEGIN_SRC lang -> <programlisting> > 4 BEGIN_VERSE -> <literallayout> > 5 BEGIN_CENTER -> something complicated Yes, the above mappings are what I use now in the exporter. BEGIN_CENTER is handled using <informaltable>. Have you tried something like the following? #+DOCBOOK: <para><emphasis>One line</emphasis> written in DocBook</para> #+BEGIN_DOCBOOK <warning> <para>You should know what you are doing when quoting DocBook XML code in your Org file. Invalid DocBook XML file may be generated by DocBook exporter if you are not careful!</para> </warning> #+END_DOCBOOK Because we already have #+BEGIN_DOCBOOK ... #+END_DOCBOOK, there is no point to support many other blocks like #+begin_warning ... #+end_warning (for the above example) etc., which can really pollute Org-mode files. > It would ne nice if something like this is there at least in the > org-docbook.el sources -- The manual is long enough and need not be > lengthened with the requirements of fringe users like > Yours truly :-) I can add a little more comments in org-docbook.el, but ideally we should add important things to the manual if they are missing. What particular information do you want to see in the manual? Baoqiu ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Re: docbook export-special 2009-05-28 12:16 ` Rustom Mody 2009-05-28 16:49 ` Baoqiu Cui @ 2009-06-03 12:28 ` Rustom Mody 1 sibling, 0 replies; 9+ messages in thread From: Rustom Mody @ 2009-06-03 12:28 UTC (permalink / raw) To: emacs-orgmode Baoqiu wrote: > I can add a little more comments in org-docbook.el, but ideally we > should add important things to the manual if they are missing. What > particular information do you want to see in the manual? Hi Baoqiu. One of the things that would help me is an explanation about links -- ie what the docbook exporter does to various types of links -- this-file and other-file, http:// file:// and more arcane protocol selectors, links specifically into a org head-line and links that search their target etc etc But as I said I think the org docs are long enough and I dont want to ask for increases to its length for the benefit of fringe users like myself. Just a few lines in the code would be neat. Of course if there is a commonality of this code with the html-exporter it could as well go into the manual as it may be of use to many more people Rustom ^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2009-06-03 12:29 UTC | newest] Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2009-05-26 14:01 docbook export-special Rustom Mody 2009-05-26 23:49 ` Baoqiu Cui 2009-05-27 6:29 ` Rustom Mody 2009-05-27 18:46 ` Baoqiu Cui 2009-05-28 7:47 ` Rustom Mody 2009-05-28 9:00 ` Carsten Dominik 2009-05-28 12:16 ` Rustom Mody 2009-05-28 16:49 ` Baoqiu Cui 2009-06-03 12:28 ` Rustom Mody
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs/org-mode.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).