From mboxrd@z Thu Jan 1 00:00:00 1970 From: Baoqiu Cui Subject: Re: [PATCH] Re: Custom docbook stylesheets. Date: Fri, 14 May 2010 21:01:07 -0700 Message-ID: References: <9C2D1FA8-9C92-4B8A-8349-A5B767658FC7@gmail.com> <013716F6-30B8-4755-B276-DF8CED591928@gmail.com> <6FA9FAF1-AF5A-4FBF-B831-65567956B38D@gmail.com> <4A4601B5-415C-4320-824D-D790D7154F32@gmail.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from [140.186.70.92] (port=58602 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OD8Z1-0005UE-71 for emacs-orgmode@gnu.org; Sat, 15 May 2010 00:01:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OD8Yz-0001XJ-Ko for emacs-orgmode@gnu.org; Sat, 15 May 2010 00:01:22 -0400 Received: from lo.gmane.org ([80.91.229.12]:38678) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OD8Yz-0001XE-6F for emacs-orgmode@gnu.org; Sat, 15 May 2010 00:01:21 -0400 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1OD8Yy-0001pU-C7 for emacs-orgmode@gnu.org; Sat, 15 May 2010 06:01:20 +0200 Received: from 174.141.219.209.transedge.com ([209.219.141.174]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 15 May 2010 06:01:20 +0200 Received: from cbaoqiu by 174.141.219.209.transedge.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 15 May 2010 06:01:20 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org --=-=-= Hi Carsten, Carsten Dominik writes: > Dear Baoqiu, > > thanks for the patch, I applied it. Can you please also make a patch > for the documentation - I think #+XSLT must be mentioned in the export > chapter.... > > And an entry for the Changes.org file would indeed be nice, can you > write that as well? Thanks for applying the previous patch. Attached below please find the 2nd patch that mainly covers the documentation changes, which include 1. Some changes in org.texi to cover `#+XSLT'. 2. An entry in Changes.org about the incompatible change. 3. A small change in org-exp.el to include `#+XSLT' in org-get-current-options(). Hope I did not miss anything important. Free feel to change the wording or add anything that you'd like to add. --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=org-docbook-format-spec-docs.diff diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index b7352b3..eab265b 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -14,6 +14,47 @@ :CUSTOM_ID: v6.36 :END: +** Incompatible Changes + +*** Customizable variable changes for DocBook exporter + +To make it more flexible for users to provide DocBook exporter +related commands, we start to use format-spec to format the +commands in this release. If you use DocBook exporter and use it +to export Org files to PDF and/or FO format, the settings of the +following two customizable variables need to be changed: + +1. =org-export-docbook-xslt-proc-command= +2. =org-export-docbook-xsl-fo-proc-command= + +Instead of using =%s= in the format control string for all +arguments, now we use /three/ different format spec characters: + +1. =%i=: input file argument +2. =%o=: output file argument +3. =%s=: XSLT stylesheet argument + +For example, if you set =org-export-docbook-xslt-proc-command= to + +: java com.icl.saxon.StyleSheet -o %s %s /path/to/docbook.xsl + +in the past, now you need to change it to + +: java com.icl.saxon.StyleSheet -o %o %i %s + +and set a new customizable variable called +=org-export-docbook-xslt-stylesheet= to =/path/to/docbook.xsl=. + +Please check the documentation of these two variables for more +details and other examples. + +Along with the introduction of variable +=org-export-docbook-xslt-stylesheet=, we also added a new +in-buffer setting called =#+XSLT:=. You can use this setting to +specify the XSLT stylesheet that you want to use on a per-file +basis. This setting overrides +=org-export-docbook-xslt-stylesheet=. + ** Details *** Inline display of linked images diff --git a/doc/org.texi b/doc/org.texi index d2b7904..7b6afd7 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -9020,6 +9020,7 @@ Insert template with export options, see example below. #+LATEX_HEADER: extra line(s) for the LaTeX header, like \usepackage@{xyz@} #+EXPORT_SELECT_TAGS: Tags that select a tree for export #+EXPORT_EXCLUDE_TAGS: Tags that exclude a tree from export +#+XSLT: the XSLT stylesheet used by DocBook exporter to generate FO file @end example @noindent @@ -9860,7 +9861,7 @@ For more information, see the documentation on Worg. @section DocBook export @cindex DocBook export @cindex PDF export -@cindex Cui, Baoqui +@cindex Cui, Baoqiu Org contains a DocBook exporter written by Baoqiu Cui. Once an Org file is exported to DocBook format, it can be further processed to produce other @@ -9907,6 +9908,15 @@ need to have XSLT processor and XSL-FO processor software installed on your system. Check variables @code{org-export-docbook-xslt-proc-command} and @code{org-export-docbook-xsl-fo-proc-command}. +@vindex org-export-docbook-xslt-stylesheet +The stylesheet argument (`%s') in variable +@code{org-export-docbook-xslt-proc-command} is in general replaced by the +value of variable @code{org-export-docbook-xslt-stylesheet}, which is +expected to be set by the user. You can also tell DocBook exporter which +stylesheet to use on a per-file basis by adding an in-buffer setting +`#+XSLT:' to the Org file. The setting of `#+XSLT:' overrides +@code{org-export-docbook-xslt-stylesheet}. + @kindex C-c C-e v D @item C-c C-e v D Export only the visible part of the document. @@ -11001,8 +11011,8 @@ keys. The corresponding variable is @code{org-tag-alist}. @item #+TBLFM: This line contains the formulas for the table directly above the line. @item #+TITLE:, #+AUTHOR:, #+EMAIL:, #+LANGUAGE:, #+TEXT:, #+DATE:, -@itemx #+OPTIONS:, #+BIND: -@itemx #+DESCRIPTION:, #+KEYWORDS: +@itemx #+OPTIONS:, #+BIND:, #+XSLT:, +@itemx #+DESCRIPTION:, #+KEYWORDS:, @itemx #+LATEX_HEADER:, #+STYLE:, #+LINK_UP:, #+LINK_HOME:, @itemx #+EXPORT_SELECT_TAGS:, #+EXPORT_EXCLUDE_TAGS: These lines provide settings for exporting files. For more details see diff --git a/lisp/org-exp.el b/lisp/org-exp.el index 068f9c5..a4f9ac3 100644 --- a/lisp/org-exp.el +++ b/lisp/org-exp.el @@ -2574,6 +2574,7 @@ Does include HTML export options as well as TODO and CATEGORY stuff." #+EXPORT_EXCLUDE_TAGS: %s #+LINK_UP: %s #+LINK_HOME: %s +#+XSLT: #+CATEGORY: %s #+SEQ_TODO: %s #+TYP_TODO: %s --=-=-= Thanks, -- Baoqiu --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-orgmode mailing list Please use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode --=-=-=--