org-odt.el 103 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782
  1. ;;; org-odt.el --- OpenDocument Text exporter for Org-mode
  2. ;; Copyright (C) 2010-2012 Free Software Foundation, Inc.
  3. ;; Author: Jambunathan K <kjambunathan at gmail dot com>
  4. ;; Keywords: outlines, hypermedia, calendar, wp
  5. ;; Homepage: http://orgmode.org
  6. ;; This file is part of GNU Emacs.
  7. ;; GNU Emacs is free software: you can redistribute it and/or modify
  8. ;; it under the terms of the GNU General Public License as published by
  9. ;; the Free Software Foundation, either version 3 of the License, or
  10. ;; (at your option) any later version.
  11. ;; GNU Emacs is distributed in the hope that it will be useful,
  12. ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. ;; GNU General Public License for more details.
  15. ;; You should have received a copy of the GNU General Public License
  16. ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
  17. ;;; Commentary:
  18. ;;; Code:
  19. (eval-when-compile
  20. (require 'cl))
  21. (require 'org-lparse)
  22. (defgroup org-export-odt nil
  23. "Options specific for ODT export of Org-mode files."
  24. :tag "Org Export ODT"
  25. :group 'org-export
  26. :version "24.1")
  27. (defvar org-lparse-dyn-first-heading-pos) ; let bound during org-do-lparse
  28. (defun org-odt-insert-toc ()
  29. (goto-char (point-min))
  30. (cond
  31. ((re-search-forward
  32. "\\(<text:p [^>]*>\\)?\\s-*\\[TABLE-OF-CONTENTS\\]\\s-*\\(</text:p>\\)?"
  33. nil t)
  34. (replace-match ""))
  35. (t
  36. (goto-char org-lparse-dyn-first-heading-pos)))
  37. (insert (org-odt-format-toc)))
  38. (defun org-odt-end-export ()
  39. (org-odt-insert-toc)
  40. (org-odt-fixup-label-references)
  41. ;; remove empty paragraphs
  42. (goto-char (point-min))
  43. (while (re-search-forward
  44. "<text:p\\( text:style-name=\"Text_20_body\"\\)?>[ \r\n\t]*</text:p>"
  45. nil t)
  46. (replace-match ""))
  47. (goto-char (point-min))
  48. ;; Convert whitespace place holders
  49. (goto-char (point-min))
  50. (let (beg end n)
  51. (while (setq beg (next-single-property-change (point) 'org-whitespace))
  52. (setq n (get-text-property beg 'org-whitespace)
  53. end (next-single-property-change beg 'org-whitespace))
  54. (goto-char beg)
  55. (delete-region beg end)
  56. (insert (format "<span style=\"visibility:hidden;\">%s</span>"
  57. (make-string n ?x)))))
  58. ;; Remove empty lines at the beginning of the file.
  59. (goto-char (point-min))
  60. (when (looking-at "\\s-+\n") (replace-match ""))
  61. ;; Remove display properties
  62. (remove-text-properties (point-min) (point-max) '(display t)))
  63. (defvar org-odt-suppress-xref nil)
  64. (defconst org-export-odt-special-string-regexps
  65. '(("\\\\-" . "&#x00ad;\\1") ; shy
  66. ("---\\([^-]\\)" . "&#x2014;\\1") ; mdash
  67. ("--\\([^-]\\)" . "&#x2013;\\1") ; ndash
  68. ("\\.\\.\\." . "&#x2026;")) ; hellip
  69. "Regular expressions for special string conversion.")
  70. (defconst org-odt-lib-dir (file-name-directory load-file-name)
  71. "Location of ODT exporter.
  72. Use this to infer values of `org-odt-styles-dir' and
  73. `org-export-odt-schema-dir'.")
  74. (defvar org-odt-data-dir nil
  75. "Data directory for ODT exporter.
  76. Use this to infer values of `org-odt-styles-dir' and
  77. `org-export-odt-schema-dir'.")
  78. (defconst org-odt-schema-dir-list
  79. (list
  80. (and org-odt-data-dir
  81. (expand-file-name "./schema/" org-odt-data-dir)) ; bail out
  82. (eval-when-compile
  83. (and (boundp 'org-odt-data-dir) org-odt-data-dir ; see make install
  84. (expand-file-name "./schema/" org-odt-data-dir)))
  85. (expand-file-name "../contrib/odt/etc/schema/" org-odt-lib-dir) ; git
  86. )
  87. "List of directories to search for OpenDocument schema files.
  88. Use this list to set the default value of
  89. `org-export-odt-schema-dir'. The entries in this list are
  90. populated heuristically based on the values of `org-odt-lib-dir'
  91. and `org-odt-data-dir'.")
  92. (defcustom org-export-odt-schema-dir
  93. (let* ((schema-dir
  94. (catch 'schema-dir
  95. (message "Debug (org-odt): Searching for OpenDocument schema files...")
  96. (mapc
  97. (lambda (schema-dir)
  98. (when schema-dir
  99. (message "Debug (org-odt): Trying %s..." schema-dir)
  100. (when (and (file-readable-p
  101. (expand-file-name "od-manifest-schema-v1.2-cs01.rnc"
  102. schema-dir))
  103. (file-readable-p
  104. (expand-file-name "od-schema-v1.2-cs01.rnc"
  105. schema-dir))
  106. (file-readable-p
  107. (expand-file-name "schemas.xml" schema-dir)))
  108. (message "Debug (org-odt): Using schema files under %s"
  109. schema-dir)
  110. (throw 'schema-dir schema-dir))))
  111. org-odt-schema-dir-list)
  112. (message "Debug (org-odt): No OpenDocument schema files installed")
  113. nil)))
  114. schema-dir)
  115. "Directory that contains OpenDocument schema files.
  116. This directory contains:
  117. 1. rnc files for OpenDocument schema
  118. 2. a \"schemas.xml\" file that specifies locating rules needed
  119. for auto validation of OpenDocument XML files.
  120. Use the customize interface to set this variable. This ensures
  121. that `rng-schema-locating-files' is updated and auto-validation
  122. of OpenDocument XML takes place based on the value
  123. `rng-nxml-auto-validate-flag'.
  124. The default value of this variable varies depending on the
  125. version of org in use and is initialized from
  126. `org-odt-schema-dir-list'. The OASIS schema files are available
  127. only in the org's private git repository. It is *not* bundled
  128. with GNU ELPA tar or standard Emacs distribution."
  129. :type '(choice
  130. (const :tag "Not set" nil)
  131. (directory :tag "Schema directory"))
  132. :group 'org-export-odt
  133. :version "24.1"
  134. :set
  135. (lambda (var value)
  136. "Set `org-export-odt-schema-dir'.
  137. Also add it to `rng-schema-locating-files'."
  138. (let ((schema-dir value))
  139. (set var
  140. (if (and
  141. (file-readable-p
  142. (expand-file-name "od-manifest-schema-v1.2-cs01.rnc" schema-dir))
  143. (file-readable-p
  144. (expand-file-name "od-schema-v1.2-cs01.rnc" schema-dir))
  145. (file-readable-p
  146. (expand-file-name "schemas.xml" schema-dir)))
  147. schema-dir
  148. (when value
  149. (message "Error (org-odt): %s has no OpenDocument schema files"
  150. value))
  151. nil)))
  152. (when org-export-odt-schema-dir
  153. (eval-after-load 'rng-loc
  154. '(add-to-list 'rng-schema-locating-files
  155. (expand-file-name "schemas.xml"
  156. org-export-odt-schema-dir))))))
  157. (defconst org-odt-styles-dir-list
  158. (list
  159. (and org-odt-data-dir
  160. (expand-file-name "./styles/" org-odt-data-dir)) ; bail out
  161. (eval-when-compile
  162. (and (boundp 'org-odt-data-dir) org-odt-data-dir ; see make install
  163. (expand-file-name "./styles/" org-odt-data-dir)))
  164. (expand-file-name "../etc/styles/" org-odt-lib-dir) ; git
  165. (expand-file-name "./etc/styles/" org-odt-lib-dir) ; elpa
  166. (expand-file-name "./org/" data-directory) ; system
  167. )
  168. "List of directories to search for OpenDocument styles files.
  169. See `org-odt-styles-dir'. The entries in this list are populated
  170. heuristically based on the values of `org-odt-lib-dir' and
  171. `org-odt-data-dir'.")
  172. (defconst org-odt-styles-dir
  173. (let* ((styles-dir
  174. (catch 'styles-dir
  175. (message "Debug (org-odt): Searching for OpenDocument styles files...")
  176. (mapc (lambda (styles-dir)
  177. (when styles-dir
  178. (message "Debug (org-odt): Trying %s..." styles-dir)
  179. (when (and (file-readable-p
  180. (expand-file-name
  181. "OrgOdtContentTemplate.xml" styles-dir))
  182. (file-readable-p
  183. (expand-file-name
  184. "OrgOdtStyles.xml" styles-dir)))
  185. (message "Debug (org-odt): Using styles under %s"
  186. styles-dir)
  187. (throw 'styles-dir styles-dir))))
  188. org-odt-styles-dir-list)
  189. nil)))
  190. (unless styles-dir
  191. (error "Error (org-odt): Cannot find factory styles files. Aborting."))
  192. styles-dir)
  193. "Directory that holds auxiliary XML files used by the ODT exporter.
  194. This directory contains the following XML files -
  195. \"OrgOdtStyles.xml\" and \"OrgOdtContentTemplate.xml\". These
  196. XML files are used as the default values of
  197. `org-export-odt-styles-file' and
  198. `org-export-odt-content-template-file'.
  199. The default value of this variable varies depending on the
  200. version of org in use and is initialized from
  201. `org-odt-styles-dir-list'. Note that the user could be using org
  202. from one of: org's own private git repository, GNU ELPA tar or
  203. standard Emacs.")
  204. (defvar org-odt-file-extensions
  205. '(("odt" . "OpenDocument Text")
  206. ("ott" . "OpenDocument Text Template")
  207. ("odm" . "OpenDocument Master Document")
  208. ("ods" . "OpenDocument Spreadsheet")
  209. ("ots" . "OpenDocument Spreadsheet Template")
  210. ("odg" . "OpenDocument Drawing (Graphics)")
  211. ("otg" . "OpenDocument Drawing Template")
  212. ("odp" . "OpenDocument Presentation")
  213. ("otp" . "OpenDocument Presentation Template")
  214. ("odi" . "OpenDocument Image")
  215. ("odf" . "OpenDocument Formula")
  216. ("odc" . "OpenDocument Chart")))
  217. (mapc
  218. (lambda (desc)
  219. ;; Let Org open all OpenDocument files using system-registered app
  220. (add-to-list 'org-file-apps
  221. (cons (concat "\\." (car desc) "\\'") 'system))
  222. ;; Let Emacs open all OpenDocument files in archive mode
  223. (add-to-list 'auto-mode-alist
  224. (cons (concat "\\." (car desc) "\\'") 'archive-mode)))
  225. org-odt-file-extensions)
  226. ;; register the odt exporter with the pre-processor
  227. (add-to-list 'org-export-backends 'odt)
  228. ;; register the odt exporter with org-lparse library
  229. (org-lparse-register-backend 'odt)
  230. (defun org-odt-unload-function ()
  231. (org-lparse-unregister-backend 'odt)
  232. (remove-hook 'org-export-preprocess-after-blockquote-hook
  233. 'org-export-odt-preprocess-latex-fragments)
  234. nil)
  235. (defcustom org-export-odt-content-template-file nil
  236. "Template file for \"content.xml\".
  237. The exporter embeds the exported content just before
  238. \"</office:text>\" element.
  239. If unspecified, the file named \"OrgOdtContentTemplate.xml\"
  240. under `org-odt-styles-dir' is used."
  241. :type 'file
  242. :group 'org-export-odt
  243. :version "24.1")
  244. (defcustom org-export-odt-styles-file nil
  245. "Default styles file for use with ODT export.
  246. Valid values are one of:
  247. 1. nil
  248. 2. path to a styles.xml file
  249. 3. path to a *.odt or a *.ott file
  250. 4. list of the form (ODT-OR-OTT-FILE (FILE-MEMBER-1 FILE-MEMBER-2
  251. ...))
  252. In case of option 1, an in-built styles.xml is used. See
  253. `org-odt-styles-dir' for more information.
  254. In case of option 3, the specified file is unzipped and the
  255. styles.xml embedded therein is used.
  256. In case of option 4, the specified ODT-OR-OTT-FILE is unzipped
  257. and FILE-MEMBER-1, FILE-MEMBER-2 etc are copied in to the
  258. generated odt file. Use relative path for specifying the
  259. FILE-MEMBERS. styles.xml must be specified as one of the
  260. FILE-MEMBERS.
  261. Use options 1, 2 or 3 only if styles.xml alone suffices for
  262. achieving the desired formatting. Use option 4, if the styles.xml
  263. references additional files like header and footer images for
  264. achieving the desired formatting.
  265. Use \"#+ODT_STYLES_FILE: ...\" directive to set this variable on
  266. a per-file basis. For example,
  267. #+ODT_STYLES_FILE: \"/path/to/styles.xml\" or
  268. #+ODT_STYLES_FILE: (\"/path/to/file.ott\" (\"styles.xml\" \"image/hdr.png\"))."
  269. :group 'org-export-odt
  270. :version "24.1"
  271. :type
  272. '(choice
  273. (const :tag "Factory settings" nil)
  274. (file :must-match t :tag "styles.xml")
  275. (file :must-match t :tag "ODT or OTT file")
  276. (list :tag "ODT or OTT file + Members"
  277. (file :must-match t :tag "ODF Text or Text Template file")
  278. (cons :tag "Members"
  279. (file :tag " Member" "styles.xml")
  280. (repeat (file :tag "Member"))))))
  281. (eval-after-load 'org-exp
  282. '(add-to-list 'org-export-inbuffer-options-extra
  283. '("ODT_STYLES_FILE" :odt-styles-file)))
  284. (defconst org-export-odt-tmpdir-prefix "%s-")
  285. (defconst org-export-odt-bookmark-prefix "OrgXref.")
  286. (defvar org-export-odt-embed-images t
  287. "Should the images be copied in to the odt file or just linked?")
  288. (defvar org-export-odt-inline-images 'maybe)
  289. (defcustom org-export-odt-inline-image-extensions
  290. '("png" "jpeg" "jpg" "gif")
  291. "Extensions of image files that can be inlined into HTML."
  292. :type '(repeat (string :tag "Extension"))
  293. :group 'org-export-odt
  294. :version "24.1")
  295. (defcustom org-export-odt-pixels-per-inch display-pixels-per-inch
  296. "Scaling factor for converting images pixels to inches.
  297. Use this for sizing of embedded images. See Info node `(org)
  298. Images in ODT export' for more information."
  299. :type 'float
  300. :group 'org-export-odt
  301. :version "24.1")
  302. (defcustom org-export-odt-create-custom-styles-for-srcblocks t
  303. "Whether custom styles for colorized source blocks be automatically created.
  304. When this option is turned on, the exporter creates custom styles
  305. for source blocks based on the advice of `htmlfontify'. Creation
  306. of custom styles happen as part of `org-odt-hfy-face-to-css'.
  307. When this option is turned off exporter does not create such
  308. styles.
  309. Use the latter option if you do not want the custom styles to be
  310. based on your current display settings. It is necessary that the
  311. styles.xml already contains needed styles for colorizing to work.
  312. This variable is effective only if
  313. `org-export-odt-fontify-srcblocks' is turned on."
  314. :group 'org-export-odt
  315. :version "24.1"
  316. :type 'boolean)
  317. (defvar org-export-odt-default-org-styles-alist
  318. '((paragraph . ((default . "Text_20_body")
  319. (fixedwidth . "OrgFixedWidthBlock")
  320. (verse . "OrgVerse")
  321. (quote . "Quotations")
  322. (blockquote . "Quotations")
  323. (center . "OrgCenter")
  324. (left . "OrgLeft")
  325. (right . "OrgRight")
  326. (title . "OrgTitle")
  327. (subtitle . "OrgSubtitle")
  328. (footnote . "Footnote")
  329. (src . "OrgSrcBlock")
  330. (illustration . "Illustration")
  331. (table . "Table")
  332. (definition-term . "Text_20_body_20_bold")
  333. (horizontal-line . "Horizontal_20_Line")))
  334. (character . ((bold . "Bold")
  335. (emphasis . "Emphasis")
  336. (code . "OrgCode")
  337. (verbatim . "OrgCode")
  338. (strike . "Strikethrough")
  339. (underline . "Underline")
  340. (subscript . "OrgSubscript")
  341. (superscript . "OrgSuperscript")))
  342. (list . ((ordered . "OrgNumberedList")
  343. (unordered . "OrgBulletedList")
  344. (description . "OrgDescriptionList"))))
  345. "Default styles for various entities.")
  346. (defvar org-export-odt-org-styles-alist org-export-odt-default-org-styles-alist)
  347. (defun org-odt-get-style-name-for-entity (category &optional entity)
  348. (let ((entity (or entity 'default)))
  349. (or
  350. (cdr (assoc entity (cdr (assoc category
  351. org-export-odt-org-styles-alist))))
  352. (cdr (assoc entity (cdr (assoc category
  353. org-export-odt-default-org-styles-alist))))
  354. (error "Cannot determine style name for entity %s of type %s"
  355. entity category))))
  356. (defcustom org-export-odt-preferred-output-format nil
  357. "Automatically post-process to this format after exporting to \"odt\".
  358. Interactive commands `org-export-as-odt' and
  359. `org-export-as-odt-and-open' export first to \"odt\" format and
  360. then use `org-export-odt-convert-process' to convert the
  361. resulting document to this format. During customization of this
  362. variable, the list of valid values are populated based on
  363. `org-export-odt-convert-capabilities'."
  364. :group 'org-export-odt
  365. :version "24.1"
  366. :type '(choice :convert-widget
  367. (lambda (w)
  368. (apply 'widget-convert (widget-type w)
  369. (eval (car (widget-get w :args)))))
  370. `((const :tag "None" nil)
  371. ,@(mapcar (lambda (c)
  372. `(const :tag ,c ,c))
  373. (org-lparse-reachable-formats "odt")))))
  374. ;;;###autoload
  375. (defun org-export-as-odt-and-open (arg)
  376. "Export the outline as ODT and immediately open it with a browser.
  377. If there is an active region, export only the region.
  378. The prefix ARG specifies how many levels of the outline should become
  379. headlines. The default is 3. Lower levels will become bulleted lists."
  380. (interactive "P")
  381. (org-lparse-and-open
  382. (or org-export-odt-preferred-output-format "odt") "odt" arg))
  383. ;;;###autoload
  384. (defun org-export-as-odt-batch ()
  385. "Call the function `org-lparse-batch'.
  386. This function can be used in batch processing as:
  387. emacs --batch
  388. --load=$HOME/lib/emacs/org.el
  389. --eval \"(setq org-export-headline-levels 2)\"
  390. --visit=MyFile --funcall org-export-as-odt-batch"
  391. (org-lparse-batch "odt"))
  392. ;;; org-export-as-odt
  393. ;;;###autoload
  394. (defun org-export-as-odt (arg &optional hidden ext-plist
  395. to-buffer body-only pub-dir)
  396. "Export the outline as a OpenDocumentText file.
  397. If there is an active region, export only the region. The prefix
  398. ARG specifies how many levels of the outline should become
  399. headlines. The default is 3. Lower levels will become bulleted
  400. lists. HIDDEN is obsolete and does nothing.
  401. EXT-PLIST is a property list with external parameters overriding
  402. org-mode's default settings, but still inferior to file-local
  403. settings. When TO-BUFFER is non-nil, create a buffer with that
  404. name and export to that buffer. If TO-BUFFER is the symbol
  405. `string', don't leave any buffer behind but just return the
  406. resulting XML as a string. When BODY-ONLY is set, don't produce
  407. the file header and footer, simply return the content of
  408. <body>...</body>, without even the body tags themselves. When
  409. PUB-DIR is set, use this as the publishing directory."
  410. (interactive "P")
  411. (org-lparse (or org-export-odt-preferred-output-format "odt")
  412. "odt" arg hidden ext-plist to-buffer body-only pub-dir))
  413. (defvar org-odt-entity-control-callbacks-alist
  414. `((EXPORT
  415. . (org-odt-begin-export org-odt-end-export))
  416. (DOCUMENT-CONTENT
  417. . (org-odt-begin-document-content org-odt-end-document-content))
  418. (DOCUMENT-BODY
  419. . (org-odt-begin-document-body org-odt-end-document-body))
  420. (TOC
  421. . (org-odt-begin-toc org-odt-end-toc))
  422. (ENVIRONMENT
  423. . (org-odt-begin-environment org-odt-end-environment))
  424. (FOOTNOTE-DEFINITION
  425. . (org-odt-begin-footnote-definition org-odt-end-footnote-definition))
  426. (TABLE
  427. . (org-odt-begin-table org-odt-end-table))
  428. (TABLE-ROWGROUP
  429. . (org-odt-begin-table-rowgroup org-odt-end-table-rowgroup))
  430. (LIST
  431. . (org-odt-begin-list org-odt-end-list))
  432. (LIST-ITEM
  433. . (org-odt-begin-list-item org-odt-end-list-item))
  434. (OUTLINE
  435. . (org-odt-begin-outline org-odt-end-outline))
  436. (OUTLINE-TEXT
  437. . (org-odt-begin-outline-text org-odt-end-outline-text))
  438. (PARAGRAPH
  439. . (org-odt-begin-paragraph org-odt-end-paragraph)))
  440. "")
  441. (defvar org-odt-entity-format-callbacks-alist
  442. `((EXTRA-TARGETS . org-lparse-format-extra-targets)
  443. (ORG-TAGS . org-lparse-format-org-tags)
  444. (SECTION-NUMBER . org-lparse-format-section-number)
  445. (HEADLINE . org-odt-format-headline)
  446. (TOC-ENTRY . org-odt-format-toc-entry)
  447. (TOC-ITEM . org-odt-format-toc-item)
  448. (TAGS . org-odt-format-tags)
  449. (SPACES . org-odt-format-spaces)
  450. (TABS . org-odt-format-tabs)
  451. (LINE-BREAK . org-odt-format-line-break)
  452. (FONTIFY . org-odt-format-fontify)
  453. (TODO . org-lparse-format-todo)
  454. (LINK . org-odt-format-link)
  455. (INLINE-IMAGE . org-odt-format-inline-image)
  456. (ORG-LINK . org-odt-format-org-link)
  457. (HEADING . org-odt-format-heading)
  458. (ANCHOR . org-odt-format-anchor)
  459. (TABLE . org-lparse-format-table)
  460. (TABLE-ROW . org-odt-format-table-row)
  461. (TABLE-CELL . org-odt-format-table-cell)
  462. (FOOTNOTES-SECTION . ignore)
  463. (FOOTNOTE-REFERENCE . org-odt-format-footnote-reference)
  464. (HORIZONTAL-LINE . org-odt-format-horizontal-line)
  465. (COMMENT . org-odt-format-comment)
  466. (LINE . org-odt-format-line)
  467. (ORG-ENTITY . org-odt-format-org-entity))
  468. "")
  469. ;;;_. callbacks
  470. ;;;_. control callbacks
  471. ;;;_ , document body
  472. (defun org-odt-begin-office-body ()
  473. ;; automatic styles
  474. (insert-file-contents
  475. (or org-export-odt-content-template-file
  476. (expand-file-name "OrgOdtContentTemplate.xml"
  477. org-odt-styles-dir)))
  478. (goto-char (point-min))
  479. (re-search-forward "</office:text>" nil nil)
  480. (delete-region (match-beginning 0) (point-max)))
  481. ;; Following variable is let bound when `org-do-lparse' is in
  482. ;; progress. See org-html.el.
  483. (defvar org-lparse-toc)
  484. (defun org-odt-format-toc ()
  485. (if (not org-lparse-toc) "" (concat "\n" org-lparse-toc "\n")))
  486. (defun org-odt-format-preamble (opt-plist)
  487. (let* ((title (plist-get opt-plist :title))
  488. (author (plist-get opt-plist :author))
  489. (date (plist-get opt-plist :date))
  490. (iso-date (org-odt-format-date date))
  491. (date (org-odt-format-date date "%d %b %Y"))
  492. (email (plist-get opt-plist :email))
  493. ;; switch on or off above vars based on user settings
  494. (author (and (plist-get opt-plist :author-info) (or author email)))
  495. (email (and (plist-get opt-plist :email-info) email))
  496. (date (and (plist-get opt-plist :time-stamp-file) date)))
  497. (concat
  498. ;; title
  499. (when title
  500. (concat
  501. (org-odt-format-stylized-paragraph
  502. 'title (org-odt-format-tags
  503. '("<text:title>" . "</text:title>") title))
  504. ;; separator
  505. "<text:p text:style-name=\"OrgTitle\"/>"))
  506. (cond
  507. ((and author (not email))
  508. ;; author only
  509. (concat
  510. (org-odt-format-stylized-paragraph
  511. 'subtitle
  512. (org-odt-format-tags
  513. '("<text:initial-creator>" . "</text:initial-creator>")
  514. author))
  515. ;; separator
  516. "<text:p text:style-name=\"OrgSubtitle\"/>"))
  517. ((and author email)
  518. ;; author and email
  519. (concat
  520. (org-odt-format-stylized-paragraph
  521. 'subtitle
  522. (org-odt-format-link
  523. (org-odt-format-tags
  524. '("<text:initial-creator>" . "</text:initial-creator>")
  525. author) (concat "mailto:" email)))
  526. ;; separator
  527. "<text:p text:style-name=\"OrgSubtitle\"/>")))
  528. ;; date
  529. (when date
  530. (concat
  531. (org-odt-format-stylized-paragraph
  532. 'subtitle
  533. (org-odt-format-tags
  534. '("<text:date style:data-style-name=\"%s\" text:date-value=\"%s\">"
  535. . "</text:date>") date "N75" iso-date))
  536. ;; separator
  537. "<text:p text:style-name=\"OrgSubtitle\"/>")))))
  538. (defun org-odt-begin-document-body (opt-plist)
  539. (org-odt-begin-office-body)
  540. (insert (org-odt-format-preamble opt-plist))
  541. (setq org-lparse-dyn-first-heading-pos (point)))
  542. (defvar org-lparse-body-only) ; let bound during org-do-lparse
  543. (defvar org-lparse-to-buffer) ; let bound during org-do-lparse
  544. (defun org-odt-end-document-body (opt-plist)
  545. (unless org-lparse-body-only
  546. (org-lparse-insert-tag "</office:text>")
  547. (org-lparse-insert-tag "</office:body>")))
  548. (defun org-odt-begin-document-content (opt-plist)
  549. (ignore))
  550. (defun org-odt-end-document-content ()
  551. (org-lparse-insert-tag "</office:document-content>"))
  552. (defun org-odt-begin-outline (level1 snumber title tags
  553. target extra-targets class)
  554. (org-lparse-insert
  555. 'HEADING (org-lparse-format
  556. 'HEADLINE title extra-targets tags snumber level1)
  557. level1 target))
  558. (defun org-odt-end-outline ()
  559. (ignore))
  560. (defun org-odt-begin-outline-text (level1 snumber class)
  561. (ignore))
  562. (defun org-odt-end-outline-text ()
  563. (ignore))
  564. (defun org-odt-begin-section (style &optional name)
  565. (let ((default-name (car (org-odt-add-automatic-style "Section"))))
  566. (org-lparse-insert-tag
  567. "<text:section text:style-name=\"%s\" text:name=\"%s\">"
  568. style (or name default-name))))
  569. (defun org-odt-end-section ()
  570. (org-lparse-insert-tag "</text:section>"))
  571. (defun org-odt-begin-paragraph (&optional style)
  572. (org-lparse-insert-tag
  573. "<text:p%s>" (org-odt-get-extra-attrs-for-paragraph-style style)))
  574. (defun org-odt-end-paragraph ()
  575. (org-lparse-insert-tag "</text:p>"))
  576. (defun org-odt-get-extra-attrs-for-paragraph-style (style)
  577. (let (style-name)
  578. (setq style-name
  579. (cond
  580. ((stringp style) style)
  581. ((symbolp style) (org-odt-get-style-name-for-entity
  582. 'paragraph style))))
  583. (unless style-name
  584. (error "Don't know how to handle paragraph style %s" style))
  585. (format " text:style-name=\"%s\"" style-name)))
  586. (defun org-odt-format-stylized-paragraph (style text)
  587. (org-odt-format-tags
  588. '("<text:p%s>" . "</text:p>") text
  589. (org-odt-get-extra-attrs-for-paragraph-style style)))
  590. (defvar org-lparse-opt-plist) ; bound during org-do-lparse
  591. (defun org-odt-format-author (&optional author)
  592. (when (setq author (or author (plist-get org-lparse-opt-plist :author)))
  593. (org-odt-format-tags '("<dc:creator>" . "</dc:creator>") author)))
  594. (defun org-odt-format-date (&optional org-ts fmt)
  595. (save-match-data
  596. (let* ((time
  597. (and (stringp org-ts)
  598. (string-match org-ts-regexp0 org-ts)
  599. (apply 'encode-time
  600. (org-fix-decoded-time
  601. (org-parse-time-string (match-string 0 org-ts) t)))))
  602. date)
  603. (cond
  604. (fmt (format-time-string fmt time))
  605. (t (setq date (format-time-string "%Y-%m-%dT%H:%M:%S%z" time))
  606. (format "%s:%s" (substring date 0 -2) (substring date -2)))))))
  607. (defun org-odt-begin-annotation (&optional author date)
  608. (org-lparse-insert-tag "<office:annotation>")
  609. (when (setq author (org-odt-format-author author))
  610. (insert author))
  611. (insert (org-odt-format-tags
  612. '("<dc:date>" . "</dc:date>")
  613. (org-odt-format-date
  614. (or date (plist-get org-lparse-opt-plist :date)))))
  615. (org-lparse-begin-paragraph))
  616. (defun org-odt-end-annotation ()
  617. (org-lparse-insert-tag "</office:annotation>"))
  618. (defun org-odt-begin-environment (style env-options-plist)
  619. (case style
  620. (annotation
  621. (org-lparse-stash-save-paragraph-state)
  622. (org-odt-begin-annotation (plist-get env-options-plist 'author)
  623. (plist-get env-options-plist 'date)))
  624. ((blockquote verse center quote)
  625. (org-lparse-begin-paragraph style)
  626. (list))
  627. ((fixedwidth native)
  628. (org-lparse-end-paragraph)
  629. (list))
  630. (t (error "Unknown environment %s" style))))
  631. (defun org-odt-end-environment (style env-options-plist)
  632. (case style
  633. (annotation
  634. (org-lparse-end-paragraph)
  635. (org-odt-end-annotation)
  636. (org-lparse-stash-pop-paragraph-state))
  637. ((blockquote verse center quote)
  638. (org-lparse-end-paragraph)
  639. (list))
  640. ((fixedwidth native)
  641. (org-lparse-begin-paragraph)
  642. (list))
  643. (t (error "Unknown environment %s" style))))
  644. (defvar org-lparse-list-stack) ; dynamically bound in org-do-lparse
  645. (defvar org-odt-list-stack-stashed)
  646. (defun org-odt-begin-list (ltype)
  647. (setq ltype (or (org-lparse-html-list-type-to-canonical-list-type ltype)
  648. ltype))
  649. (let* ((style-name (org-odt-get-style-name-for-entity 'list ltype))
  650. (extra (concat (if (or org-lparse-list-table-p
  651. (and (= 1 (length org-lparse-list-stack))
  652. (null org-odt-list-stack-stashed)))
  653. " text:continue-numbering=\"false\""
  654. " text:continue-numbering=\"true\"")
  655. (when style-name
  656. (format " text:style-name=\"%s\"" style-name)))))
  657. (case ltype
  658. ((ordered unordered description)
  659. (org-lparse-end-paragraph)
  660. (org-lparse-insert-tag "<text:list%s>" extra))
  661. (t (error "Unknown list type: %s" ltype)))))
  662. (defun org-odt-end-list (ltype)
  663. (setq ltype (or (org-lparse-html-list-type-to-canonical-list-type ltype)
  664. ltype))
  665. (if ltype
  666. (org-lparse-insert-tag "</text:list>")
  667. (error "Unknown list type: %s" ltype)))
  668. (defun org-odt-begin-list-item (ltype &optional arg headline)
  669. (setq ltype (or (org-lparse-html-list-type-to-canonical-list-type ltype)
  670. ltype))
  671. (case ltype
  672. (ordered
  673. (assert (not headline) t)
  674. (let* ((counter arg) (extra ""))
  675. (org-lparse-insert-tag (if (= (length org-lparse-list-stack)
  676. (length org-odt-list-stack-stashed))
  677. "<text:list-header>" "<text:list-item>"))
  678. (org-lparse-begin-paragraph)))
  679. (unordered
  680. (let* ((id arg) (extra ""))
  681. (org-lparse-insert-tag (if (= (length org-lparse-list-stack)
  682. (length org-odt-list-stack-stashed))
  683. "<text:list-header>" "<text:list-item>"))
  684. (org-lparse-begin-paragraph)
  685. (insert (if headline (org-odt-format-target headline id)
  686. (org-odt-format-bookmark "" id)))))
  687. (description
  688. (assert (not headline) t)
  689. (let ((term (or arg "(no term)")))
  690. (insert
  691. (org-odt-format-tags
  692. '("<text:list-item>" . "</text:list-item>")
  693. (org-odt-format-stylized-paragraph 'definition-term term)))
  694. (org-lparse-begin-list-item 'unordered)
  695. (org-lparse-begin-list 'description)
  696. (org-lparse-begin-list-item 'unordered)))
  697. (t (error "Unknown list type"))))
  698. (defun org-odt-end-list-item (ltype)
  699. (setq ltype (or (org-lparse-html-list-type-to-canonical-list-type ltype)
  700. ltype))
  701. (case ltype
  702. ((ordered unordered)
  703. (org-lparse-insert-tag (if (= (length org-lparse-list-stack)
  704. (length org-odt-list-stack-stashed))
  705. (prog1 "</text:list-header>"
  706. (setq org-odt-list-stack-stashed nil))
  707. "</text:list-item>")))
  708. (description
  709. (org-lparse-end-list-item-1)
  710. (org-lparse-end-list 'description)
  711. (org-lparse-end-list-item-1))
  712. (t (error "Unknown list type"))))
  713. (defun org-odt-discontinue-list ()
  714. (let ((stashed-stack org-lparse-list-stack))
  715. (loop for list-type in stashed-stack
  716. do (org-lparse-end-list-item-1 list-type)
  717. (org-lparse-end-list list-type))
  718. (setq org-odt-list-stack-stashed stashed-stack)))
  719. (defun org-odt-continue-list ()
  720. (setq org-odt-list-stack-stashed (nreverse org-odt-list-stack-stashed))
  721. (loop for list-type in org-odt-list-stack-stashed
  722. do (org-lparse-begin-list list-type)
  723. (org-lparse-begin-list-item list-type)))
  724. ;; Following variables are let bound when table emission is in
  725. ;; progress. See org-lparse.el.
  726. (defvar org-lparse-table-begin-marker)
  727. (defvar org-lparse-table-ncols)
  728. (defvar org-lparse-table-rowgrp-open)
  729. (defvar org-lparse-table-rownum)
  730. (defvar org-lparse-table-cur-rowgrp-is-hdr)
  731. (defvar org-lparse-table-is-styled)
  732. (defvar org-lparse-table-rowgrp-info)
  733. (defvar org-lparse-table-colalign-vector)
  734. (defvar org-odt-table-style nil
  735. "Table style specified by \"#+ATTR_ODT: <style-name>\" line.
  736. This is set during `org-odt-begin-table'.")
  737. (defvar org-odt-table-style-spec nil
  738. "Entry for `org-odt-table-style' in `org-export-odt-table-styles'.")
  739. (defcustom org-export-odt-table-styles
  740. '(("OrgEquation" "OrgEquation"
  741. ((use-first-column-styles . t)
  742. (use-last-column-styles . t))))
  743. "Specify how Table Styles should be derived from a Table Template.
  744. This is a list where each element is of the
  745. form (TABLE-STYLE-NAME TABLE-TEMPLATE-NAME TABLE-CELL-OPTIONS).
  746. TABLE-STYLE-NAME is the style associated with the table through
  747. `org-odt-table-style'.
  748. TABLE-TEMPLATE-NAME is a set of - upto 9 - automatic
  749. TABLE-CELL-STYLE-NAMEs and PARAGRAPH-STYLE-NAMEs (as defined
  750. below) that is included in
  751. `org-export-odt-content-template-file'.
  752. TABLE-CELL-STYLE-NAME := TABLE-TEMPLATE-NAME + TABLE-CELL-TYPE +
  753. \"TableCell\"
  754. PARAGRAPH-STYLE-NAME := TABLE-TEMPLATE-NAME + TABLE-CELL-TYPE +
  755. \"TableParagraph\"
  756. TABLE-CELL-TYPE := \"FirstRow\" | \"LastColumn\" |
  757. \"FirstRow\" | \"LastRow\" |
  758. \"EvenRow\" | \"OddRow\" |
  759. \"EvenColumn\" | \"OddColumn\" | \"\"
  760. where \"+\" above denotes string concatenation.
  761. TABLE-CELL-OPTIONS is an alist where each element is of the
  762. form (TABLE-CELL-STYLE-SELECTOR . ON-OR-OFF).
  763. TABLE-CELL-STYLE-SELECTOR := `use-first-row-styles' |
  764. `use-last-row-styles' |
  765. `use-first-column-styles' |
  766. `use-last-column-styles' |
  767. `use-banding-rows-styles' |
  768. `use-banding-columns-styles' |
  769. `use-first-row-styles'
  770. ON-OR-OFF := `t' | `nil'
  771. For example, with the following configuration
  772. \(setq org-export-odt-table-styles
  773. '\(\(\"TableWithHeaderRowsAndColumns\" \"Custom\"
  774. \(\(use-first-row-styles . t\)
  775. \(use-first-column-styles . t\)\)\)
  776. \(\"TableWithHeaderColumns\" \"Custom\"
  777. \(\(use-first-column-styles . t\)\)\)\)\)
  778. 1. A table associated with \"TableWithHeaderRowsAndColumns\"
  779. style will use the following table-cell styles -
  780. \"CustomFirstRowTableCell\", \"CustomFirstColumnTableCell\",
  781. \"CustomTableCell\" and the following paragraph styles
  782. \"CustomFirstRowTableParagraph\",
  783. \"CustomFirstColumnTableParagraph\", \"CustomTableParagraph\"
  784. as appropriate.
  785. 2. A table associated with \"TableWithHeaderColumns\" style will
  786. use the following table-cell styles -
  787. \"CustomFirstColumnTableCell\", \"CustomTableCell\" and the
  788. following paragraph styles
  789. \"CustomFirstColumnTableParagraph\", \"CustomTableParagraph\"
  790. as appropriate..
  791. Note that TABLE-TEMPLATE-NAME corresponds to the
  792. \"<table:table-template>\" elements contained within
  793. \"<office:styles>\". The entries (TABLE-STYLE-NAME
  794. TABLE-TEMPLATE-NAME TABLE-CELL-OPTIONS) correspond to
  795. \"table:template-name\" and \"table:use-first-row-styles\" etc
  796. attributes of \"<table:table>\" element. Refer ODF-1.2
  797. specification for more information. Also consult the
  798. implementation filed under `org-odt-get-table-cell-styles'.
  799. The TABLE-STYLE-NAME \"OrgEquation\" is used internally for
  800. formatting of numbered display equations. Do not delete this
  801. style from the list."
  802. :group 'org-export-odt
  803. :version "24.1"
  804. :type '(choice
  805. (const :tag "None" nil)
  806. (repeat :tag "Table Styles"
  807. (list :tag "Table Style Specification"
  808. (string :tag "Table Style Name")
  809. (string :tag "Table Template Name")
  810. (alist :options (use-first-row-styles
  811. use-last-row-styles
  812. use-first-column-styles
  813. use-last-column-styles
  814. use-banding-rows-styles
  815. use-banding-columns-styles)
  816. :key-type symbol
  817. :value-type (const :tag "True" t))))))
  818. (defvar org-odt-table-style-format
  819. "
  820. <style:style style:name=\"%s\" style:family=\"table\">
  821. <style:table-properties style:rel-width=\"%d%%\" fo:margin-top=\"0cm\" fo:margin-bottom=\"0.20cm\" table:align=\"center\"/>
  822. </style:style>
  823. "
  824. "Template for auto-generated Table styles.")
  825. (defvar org-odt-automatic-styles '()
  826. "Registry of automatic styles for various OBJECT-TYPEs.
  827. The variable has the following form:
  828. \(\(OBJECT-TYPE-A
  829. \(\(OBJECT-NAME-A.1 OBJECT-PROPS-A.1\)
  830. \(OBJECT-NAME-A.2 OBJECT-PROPS-A.2\) ...\)\)
  831. \(OBJECT-TYPE-B
  832. \(\(OBJECT-NAME-B.1 OBJECT-PROPS-B.1\)
  833. \(OBJECT-NAME-B.2 OBJECT-PROPS-B.2\) ...\)\)
  834. ...\).
  835. OBJECT-TYPEs could be \"Section\", \"Table\", \"Figure\" etc.
  836. OBJECT-PROPS is (typically) a plist created by passing
  837. \"#+ATTR_ODT: \" option to `org-lparse-get-block-params'.
  838. Use `org-odt-add-automatic-style' to add update this variable.'")
  839. (defvar org-odt-object-counters nil
  840. "Running counters for various OBJECT-TYPEs.
  841. Use this to generate automatic names and style-names. See
  842. `org-odt-add-automatic-style'.")
  843. (defun org-odt-write-automatic-styles ()
  844. "Write automatic styles to \"content.xml\"."
  845. (with-current-buffer
  846. (find-file-noselect (expand-file-name "content.xml") t)
  847. ;; position the cursor
  848. (goto-char (point-min))
  849. (re-search-forward " </office:automatic-styles>" nil t)
  850. (goto-char (match-beginning 0))
  851. ;; write automatic table styles
  852. (loop for (style-name props) in
  853. (plist-get org-odt-automatic-styles 'Table) do
  854. (when (setq props (or (plist-get props :rel-width) 96))
  855. (insert (format org-odt-table-style-format style-name props))))))
  856. (defun org-odt-add-automatic-style (object-type &optional object-props)
  857. "Create an automatic style of type OBJECT-TYPE with param OBJECT-PROPS.
  858. OBJECT-PROPS is (typically) a plist created by passing
  859. \"#+ATTR_ODT: \" option of the object in question to
  860. `org-lparse-get-block-params'.
  861. Use `org-odt-object-counters' to generate an automatic
  862. OBJECT-NAME and STYLE-NAME. If OBJECT-PROPS is non-nil, add a
  863. new entry in `org-odt-automatic-styles'. Return (OBJECT-NAME
  864. . STYLE-NAME)."
  865. (assert (stringp object-type))
  866. (let* ((object (intern object-type))
  867. (seqvar object)
  868. (seqno (1+ (or (plist-get org-odt-object-counters seqvar) 0)))
  869. (object-name (format "%s%d" object-type seqno)) style-name)
  870. (setq org-odt-object-counters
  871. (plist-put org-odt-object-counters seqvar seqno))
  872. (when object-props
  873. (setq style-name (format "Org%s" object-name))
  874. (setq org-odt-automatic-styles
  875. (plist-put org-odt-automatic-styles object
  876. (append (list (list style-name object-props))
  877. (plist-get org-odt-automatic-styles object)))))
  878. (cons object-name style-name)))
  879. (defvar org-odt-table-indentedp nil)
  880. (defun org-odt-begin-table (caption label attributes)
  881. (setq org-odt-table-indentedp (not (null org-lparse-list-stack)))
  882. (when org-odt-table-indentedp
  883. ;; Within the Org file, the table is appearing within a list item.
  884. ;; OpenDocument doesn't allow table to appear within list items.
  885. ;; Temporarily terminate the list, emit the table and then
  886. ;; re-continue the list.
  887. (org-odt-discontinue-list)
  888. ;; Put the Table in an indented section.
  889. (let ((level (length org-odt-list-stack-stashed)))
  890. (org-odt-begin-section (format "OrgIndentedSection-Level-%d" level))))
  891. (setq attributes (org-lparse-get-block-params attributes))
  892. (setq org-odt-table-style (plist-get attributes :style))
  893. (setq org-odt-table-style-spec
  894. (assoc org-odt-table-style org-export-odt-table-styles))
  895. (when (or label caption)
  896. (insert
  897. (org-odt-format-stylized-paragraph
  898. 'table (org-odt-format-entity-caption label caption "__Table__"))))
  899. (let ((name-and-style (org-odt-add-automatic-style "Table" attributes)))
  900. (org-lparse-insert-tag
  901. "<table:table table:name=\"%s\" table:style-name=\"%s\">"
  902. (car name-and-style) (or (nth 1 org-odt-table-style-spec)
  903. (cdr name-and-style) "OrgTable")))
  904. (setq org-lparse-table-begin-marker (point)))
  905. (defvar org-lparse-table-colalign-info)
  906. (defun org-odt-end-table ()
  907. (goto-char org-lparse-table-begin-marker)
  908. (loop for level from 0 below org-lparse-table-ncols
  909. do (let* ((col-cookie (and org-lparse-table-is-styled
  910. (cdr (assoc (1+ level)
  911. org-lparse-table-colalign-info))))
  912. (extra-columns (or (nth 1 col-cookie) 0)))
  913. (dotimes (i (1+ extra-columns))
  914. (insert
  915. (org-odt-format-tags
  916. "<table:table-column table:style-name=\"%sColumn\"/>"
  917. "" (or (nth 1 org-odt-table-style-spec) "OrgTable"))))
  918. (insert "\n")))
  919. ;; fill style attributes for table cells
  920. (when org-lparse-table-is-styled
  921. (while (re-search-forward "@@\\(table-cell:p\\|table-cell:style-name\\)@@\\([0-9]+\\)@@\\([0-9]+\\)@@" nil t)
  922. (let* ((spec (match-string 1))
  923. (r (string-to-number (match-string 2)))
  924. (c (string-to-number (match-string 3)))
  925. (cell-styles (org-odt-get-table-cell-styles
  926. r c org-odt-table-style-spec))
  927. (table-cell-style (car cell-styles))
  928. (table-cell-paragraph-style (cdr cell-styles)))
  929. (cond
  930. ((equal spec "table-cell:p")
  931. (replace-match table-cell-paragraph-style t t))
  932. ((equal spec "table-cell:style-name")
  933. (replace-match table-cell-style t t))))))
  934. (goto-char (point-max))
  935. (org-lparse-insert-tag "</table:table>")
  936. (when org-odt-table-indentedp
  937. (org-odt-end-section)
  938. (org-odt-continue-list)))
  939. (defun org-odt-begin-table-rowgroup (&optional is-header-row)
  940. (when org-lparse-table-rowgrp-open
  941. (org-lparse-end 'TABLE-ROWGROUP))
  942. (org-lparse-insert-tag (if is-header-row
  943. "<table:table-header-rows>"
  944. "<table:table-rows>"))
  945. (setq org-lparse-table-rowgrp-open t)
  946. (setq org-lparse-table-cur-rowgrp-is-hdr is-header-row))
  947. (defun org-odt-end-table-rowgroup ()
  948. (when org-lparse-table-rowgrp-open
  949. (setq org-lparse-table-rowgrp-open nil)
  950. (org-lparse-insert-tag
  951. (if org-lparse-table-cur-rowgrp-is-hdr
  952. "</table:table-header-rows>" "</table:table-rows>"))))
  953. (defun org-odt-format-table-row (row)
  954. (org-odt-format-tags
  955. '("<table:table-row>" . "</table:table-row>") row))
  956. (defun org-odt-get-table-cell-styles (r c &optional style-spec)
  957. "Retrieve styles applicable to a table cell.
  958. R and C are (zero-based) row and column numbers of the table
  959. cell. STYLE-SPEC is an entry in `org-export-odt-table-styles'
  960. applicable to the current table. It is `nil' if the table is not
  961. associated with any style attributes.
  962. Return a cons of (TABLE-CELL-STYLE-NAME . PARAGRAPH-STYLE-NAME).
  963. When STYLE-SPEC is nil, style the table cell the conventional way
  964. - choose cell borders based on row and column groupings and
  965. choose paragraph alignment based on `org-col-cookies' text
  966. property. See also
  967. `org-odt-get-paragraph-style-cookie-for-table-cell'.
  968. When STYLE-SPEC is non-nil, ignore the above cookie and return
  969. styles congruent with the ODF-1.2 specification."
  970. (cond
  971. (style-spec
  972. ;; LibreOffice - particularly the Writer - honors neither table
  973. ;; templates nor custom table-cell styles. Inorder to retain
  974. ;; inter-operability with LibreOffice, only automatic styles are
  975. ;; used for styling of table-cells. The current implementation is
  976. ;; congruent with ODF-1.2 specification and hence is
  977. ;; future-compatible.
  978. ;; Additional Note: LibreOffice's AutoFormat facility for tables -
  979. ;; which recognizes as many as 16 different cell types - is much
  980. ;; richer. Unfortunately it is NOT amenable to easy configuration
  981. ;; by hand.
  982. (let* ((template-name (nth 1 style-spec))
  983. (cell-style-selectors (nth 2 style-spec))
  984. (cell-type
  985. (cond
  986. ((and (cdr (assoc 'use-first-column-styles cell-style-selectors))
  987. (= c 0)) "FirstColumn")
  988. ((and (cdr (assoc 'use-last-column-styles cell-style-selectors))
  989. (= c (1- org-lparse-table-ncols))) "LastColumn")
  990. ((and (cdr (assoc 'use-first-row-styles cell-style-selectors))
  991. (= r 0)) "FirstRow")
  992. ((and (cdr (assoc 'use-last-row-styles cell-style-selectors))
  993. (= r org-lparse-table-rownum))
  994. "LastRow")
  995. ((and (cdr (assoc 'use-banding-rows-styles cell-style-selectors))
  996. (= (% r 2) 1)) "EvenRow")
  997. ((and (cdr (assoc 'use-banding-rows-styles cell-style-selectors))
  998. (= (% r 2) 0)) "OddRow")
  999. ((and (cdr (assoc 'use-banding-columns-styles cell-style-selectors))
  1000. (= (% c 2) 1)) "EvenColumn")
  1001. ((and (cdr (assoc 'use-banding-columns-styles cell-style-selectors))
  1002. (= (% c 2) 0)) "OddColumn")
  1003. (t ""))))
  1004. (cons
  1005. (concat template-name cell-type "TableCell")
  1006. (concat template-name cell-type "TableParagraph"))))
  1007. (t
  1008. (cons
  1009. (concat
  1010. "OrgTblCell"
  1011. (cond
  1012. ((= r 0) "T")
  1013. ((eq (cdr (assoc r org-lparse-table-rowgrp-info)) :start) "T")
  1014. (t ""))
  1015. (when (= r org-lparse-table-rownum) "B")
  1016. (cond
  1017. ((= c 0) "")
  1018. ((or (memq (nth c org-table-colgroup-info) '(:start :startend))
  1019. (memq (nth (1- c) org-table-colgroup-info) '(:end :startend))) "L")
  1020. (t "")))
  1021. (capitalize (aref org-lparse-table-colalign-vector c))))))
  1022. (defun org-odt-get-paragraph-style-cookie-for-table-cell (r c)
  1023. (concat
  1024. (and (not org-odt-table-style-spec)
  1025. (cond
  1026. (org-lparse-table-cur-rowgrp-is-hdr "OrgTableHeading")
  1027. ((and (= c 0) (org-lparse-get 'TABLE-FIRST-COLUMN-AS-LABELS))
  1028. "OrgTableHeading")
  1029. (t "OrgTableContents")))
  1030. (and org-lparse-table-is-styled
  1031. (format "@@table-cell:p@@%03d@@%03d@@" r c))))
  1032. (defun org-odt-get-style-name-cookie-for-table-cell (r c)
  1033. (when org-lparse-table-is-styled
  1034. (format "@@table-cell:style-name@@%03d@@%03d@@" r c)))
  1035. (defun org-odt-format-table-cell (data r c horiz-span)
  1036. (concat
  1037. (let* ((paragraph-style-cookie
  1038. (org-odt-get-paragraph-style-cookie-for-table-cell r c))
  1039. (style-name-cookie
  1040. (org-odt-get-style-name-cookie-for-table-cell r c))
  1041. (extra (and style-name-cookie
  1042. (format " table:style-name=\"%s\"" style-name-cookie)))
  1043. (extra (concat extra
  1044. (and (> horiz-span 0)
  1045. (format " table:number-columns-spanned=\"%d\""
  1046. (1+ horiz-span))))))
  1047. (org-odt-format-tags
  1048. '("<table:table-cell%s>" . "</table:table-cell>")
  1049. (if org-lparse-list-table-p data
  1050. (org-odt-format-stylized-paragraph paragraph-style-cookie data)) extra))
  1051. (let (s)
  1052. (dotimes (i horiz-span)
  1053. (setq s (concat s "\n<table:covered-table-cell/>"))) s)
  1054. "\n"))
  1055. (defun org-odt-begin-footnote-definition (n)
  1056. (org-lparse-begin-paragraph 'footnote))
  1057. (defun org-odt-end-footnote-definition (n)
  1058. (org-lparse-end-paragraph))
  1059. (defun org-odt-begin-toc (lang-specific-heading max-level)
  1060. ;; Strings in `org-export-language-setup' can contain named html
  1061. ;; entities. Replace those with utf-8 equivalents.
  1062. (let ((i 0) entity rpl)
  1063. (while (string-match "&\\([^#].*?\\);" lang-specific-heading i)
  1064. (setq entity (match-string 1 lang-specific-heading))
  1065. (if (not (setq rpl (org-entity-get-representation entity 'utf8)))
  1066. (setq i (match-end 0))
  1067. (setq i (+ (match-beginning 0) (length rpl)))
  1068. (setq lang-specific-heading
  1069. (replace-match rpl t t lang-specific-heading)))))
  1070. (insert
  1071. (format "
  1072. <text:table-of-content text:style-name=\"Sect2\" text:protected=\"true\" text:name=\"Table of Contents1\">
  1073. <text:table-of-content-source text:outline-level=\"%d\">
  1074. <text:index-title-template text:style-name=\"Contents_20_Heading\">%s</text:index-title-template>
  1075. " max-level lang-specific-heading))
  1076. (loop for level from 1 upto 10
  1077. do (insert (format
  1078. "
  1079. <text:table-of-content-entry-template text:outline-level=\"%d\" text:style-name=\"Contents_20_%d\">
  1080. <text:index-entry-link-start text:style-name=\"Internet_20_link\"/>
  1081. <text:index-entry-chapter/>
  1082. <text:index-entry-text/>
  1083. <text:index-entry-link-end/>
  1084. </text:table-of-content-entry-template>
  1085. " level level)))
  1086. (insert
  1087. (format "
  1088. </text:table-of-content-source>
  1089. <text:index-body>
  1090. <text:index-title text:style-name=\"Sect1\" text:name=\"Table of Contents1_Head\">
  1091. <text:p text:style-name=\"Contents_20_Heading\">%s</text:p>
  1092. </text:index-title>
  1093. " lang-specific-heading)))
  1094. (defun org-odt-end-toc ()
  1095. (insert "
  1096. </text:index-body>
  1097. </text:table-of-content>
  1098. "))
  1099. (defun org-odt-format-toc-entry (snumber todo headline tags href)
  1100. (setq headline (concat
  1101. (and org-export-with-section-numbers
  1102. (concat snumber ". "))
  1103. headline
  1104. (and tags
  1105. (concat
  1106. (org-lparse-format 'SPACES 3)
  1107. (org-lparse-format 'FONTIFY tags "tag")))))
  1108. (when todo
  1109. (setq headline (org-lparse-format 'FONTIFY headline "todo")))
  1110. (let ((org-odt-suppress-xref t))
  1111. (org-odt-format-link headline (concat "#" href))))
  1112. (defun org-odt-format-toc-item (toc-entry level org-last-level)
  1113. (let ((style (format "Contents_20_%d"
  1114. (+ level (or (org-lparse-get 'TOPLEVEL-HLEVEL) 1) -1))))
  1115. (insert "\n" (org-odt-format-stylized-paragraph style toc-entry) "\n")))
  1116. ;; Following variable is let bound during 'ORG-LINK callback. See
  1117. ;; org-html.el
  1118. (defvar org-lparse-link-description-is-image nil)
  1119. (defun org-odt-format-link (desc href &optional attr)
  1120. (cond
  1121. ((and (= (string-to-char href) ?#) (not org-odt-suppress-xref))
  1122. (setq href (substring href 1))
  1123. (let ((xref-format "text"))
  1124. (when (numberp desc)
  1125. (setq desc (format "%d" desc) xref-format "number"))
  1126. (when (listp desc)
  1127. (setq desc (mapconcat 'identity desc ".") xref-format "chapter"))
  1128. (setq href (concat org-export-odt-bookmark-prefix href))
  1129. (org-odt-format-tags
  1130. '("<text:bookmark-ref text:reference-format=\"%s\" text:ref-name=\"%s\">" .
  1131. "</text:bookmark-ref>")
  1132. desc xref-format href)))
  1133. (org-lparse-link-description-is-image
  1134. (org-odt-format-tags
  1135. '("<draw:a xlink:type=\"simple\" xlink:href=\"%s\" %s>" . "</draw:a>")
  1136. desc href (or attr "")))
  1137. (t
  1138. (org-odt-format-tags
  1139. '("<text:a xlink:type=\"simple\" xlink:href=\"%s\" %s>" . "</text:a>")
  1140. desc href (or attr "")))))
  1141. (defun org-odt-format-spaces (n)
  1142. (cond
  1143. ((= n 1) " ")
  1144. ((> n 1) (concat
  1145. " " (org-odt-format-tags "<text:s text:c=\"%d\"/>" "" (1- n))))
  1146. (t "")))
  1147. (defun org-odt-format-tabs (&optional n)
  1148. (let ((tab "<text:tab/>")
  1149. (n (or n 1)))
  1150. (insert tab)))
  1151. (defun org-odt-format-line-break ()
  1152. (org-odt-format-tags "<text:line-break/>" ""))
  1153. (defun org-odt-format-horizontal-line ()
  1154. (org-odt-format-stylized-paragraph 'horizontal-line ""))
  1155. (defun org-odt-encode-plain-text (line &optional no-whitespace-filling)
  1156. (setq line (org-xml-encode-plain-text line))
  1157. (if no-whitespace-filling line
  1158. (org-odt-fill-tabs-and-spaces line)))
  1159. (defun org-odt-format-line (line)
  1160. (case org-lparse-dyn-current-environment
  1161. (fixedwidth (concat
  1162. (org-odt-format-stylized-paragraph
  1163. 'fixedwidth (org-odt-encode-plain-text line)) "\n"))
  1164. (t (concat line "\n"))))
  1165. (defun org-odt-format-comment (fmt &rest args)
  1166. (let ((comment (apply 'format fmt args)))
  1167. (format "\n<!-- %s -->\n" comment)))
  1168. (defun org-odt-format-org-entity (wd)
  1169. (org-entity-get-representation wd 'utf8))
  1170. (defun org-odt-fill-tabs-and-spaces (line)
  1171. (replace-regexp-in-string
  1172. "\\([\t]\\|\\([ ]+\\)\\)" (lambda (s)
  1173. (cond
  1174. ((string= s "\t") (org-odt-format-tabs))
  1175. (t (org-odt-format-spaces (length s))))) line))
  1176. (defcustom org-export-odt-fontify-srcblocks t
  1177. "Specify whether or not source blocks need to be fontified.
  1178. Turn this option on if you want to colorize the source code
  1179. blocks in the exported file. For colorization to work, you need
  1180. to make available an enhanced version of `htmlfontify' library."
  1181. :type 'boolean
  1182. :group 'org-export-odt
  1183. :version "24.1")
  1184. (defun org-odt-format-source-line-with-line-number-and-label
  1185. (line rpllbl num fontifier par-style)
  1186. (let ((keep-label (not (numberp rpllbl)))
  1187. (ref (org-find-text-property-in-string 'org-coderef line)))
  1188. (setq line (concat line (and keep-label ref (format "(%s)" ref))))
  1189. (setq line (funcall fontifier line))
  1190. (when ref
  1191. (setq line (org-odt-format-target line (concat "coderef-" ref))))
  1192. (setq line (org-odt-format-stylized-paragraph par-style line))
  1193. (if (not num) line
  1194. (org-odt-format-tags '("<text:list-item>" . "</text:list-item>") line))))
  1195. (defun org-odt-format-source-code-or-example-plain
  1196. (lines lang caption textareap cols rows num cont rpllbl fmt)
  1197. "Format source or example blocks much like fixedwidth blocks.
  1198. Use this when `org-export-odt-fontify-srcblocks' option is turned
  1199. off."
  1200. (let* ((lines (org-split-string lines "[\r\n]"))
  1201. (line-count (length lines))
  1202. (i 0))
  1203. (mapconcat
  1204. (lambda (line)
  1205. (incf i)
  1206. (org-odt-format-source-line-with-line-number-and-label
  1207. line rpllbl num 'org-odt-encode-plain-text
  1208. (if (= i line-count) "OrgFixedWidthBlockLastLine"
  1209. "OrgFixedWidthBlock")))
  1210. lines "\n")))
  1211. (defvar org-src-block-paragraph-format
  1212. "<style:style style:name=\"OrgSrcBlock\" style:family=\"paragraph\" style:parent-style-name=\"Preformatted_20_Text\">
  1213. <style:paragraph-properties fo:background-color=\"%s\" fo:padding=\"0.049cm\" fo:border=\"0.51pt solid #000000\" style:shadow=\"none\">
  1214. <style:background-image/>
  1215. </style:paragraph-properties>
  1216. <style:text-properties fo:color=\"%s\"/>
  1217. </style:style>"
  1218. "Custom paragraph style for colorized source and example blocks.
  1219. This style is much the same as that of \"OrgFixedWidthBlock\"
  1220. except that the foreground and background colors are set
  1221. according to the default face identified by the `htmlfontify'.")
  1222. (defvar hfy-optimisations)
  1223. (declare-function hfy-face-to-style "htmlfontify" (fn))
  1224. (declare-function hfy-face-or-def-to-name "htmlfontify" (fn))
  1225. (defun org-odt-hfy-face-to-css (fn)
  1226. "Create custom style for face FN.
  1227. When FN is the default face, use it's foreground and background
  1228. properties to create \"OrgSrcBlock\" paragraph style. Otherwise
  1229. use it's color attribute to create a character style whose name
  1230. is obtained from FN. Currently all attributes of FN other than
  1231. color are ignored.
  1232. The style name for a face FN is derived using the following
  1233. operations on the face name in that order - de-dash, CamelCase
  1234. and prefix with \"OrgSrc\". For example,
  1235. `font-lock-function-name-face' is associated with
  1236. \"OrgSrcFontLockFunctionNameFace\"."
  1237. (let* ((css-list (hfy-face-to-style fn))
  1238. (style-name ((lambda (fn)
  1239. (concat "OrgSrc"
  1240. (mapconcat
  1241. 'capitalize (split-string
  1242. (hfy-face-or-def-to-name fn) "-")
  1243. ""))) fn))
  1244. (color-val (cdr (assoc "color" css-list)))
  1245. (background-color-val (cdr (assoc "background" css-list)))
  1246. (style (and org-export-odt-create-custom-styles-for-srcblocks
  1247. (cond
  1248. ((eq fn 'default)
  1249. (format org-src-block-paragraph-format
  1250. background-color-val color-val))
  1251. (t
  1252. (format
  1253. "
  1254. <style:style style:name=\"%s\" style:family=\"text\">
  1255. <style:text-properties fo:color=\"%s\"/>
  1256. </style:style>" style-name color-val))))))
  1257. (cons style-name style)))
  1258. (defun org-odt-insert-custom-styles-for-srcblocks (styles)
  1259. "Save STYLES used for colorizing of source blocks.
  1260. Update styles.xml with styles that were collected as part of
  1261. `org-odt-hfy-face-to-css' callbacks."
  1262. (when styles
  1263. (with-current-buffer
  1264. (find-file-noselect (expand-file-name "styles.xml") t)
  1265. (goto-char (point-min))
  1266. (when (re-search-forward "</office:styles>" nil t)
  1267. (goto-char (match-beginning 0))
  1268. (insert "\n<!-- Org Htmlfontify Styles -->\n" styles "\n")))))
  1269. (defun org-odt-format-source-code-or-example-colored
  1270. (lines lang caption textareap cols rows num cont rpllbl fmt)
  1271. "Format source or example blocks using `htmlfontify-string'.
  1272. Use this routine when `org-export-odt-fontify-srcblocks' option
  1273. is turned on."
  1274. (let* ((lang-m (and lang (or (cdr (assoc lang org-src-lang-modes)) lang)))
  1275. (mode (and lang-m (intern (concat (if (symbolp lang-m)
  1276. (symbol-name lang-m)
  1277. lang-m) "-mode"))))
  1278. (org-inhibit-startup t)
  1279. (org-startup-folded nil)
  1280. (lines (with-temp-buffer
  1281. (insert lines)
  1282. (if (functionp mode) (funcall mode) (fundamental-mode))
  1283. (font-lock-fontify-buffer)
  1284. (buffer-string)))
  1285. (hfy-html-quote-regex "\\([<\"&> ]\\)")
  1286. (hfy-html-quote-map '(("\"" "&quot;")
  1287. ("<" "&lt;")
  1288. ("&" "&amp;")
  1289. (">" "&gt;")
  1290. (" " "<text:s/>")
  1291. (" " "<text:tab/>")))
  1292. (hfy-face-to-css 'org-odt-hfy-face-to-css)
  1293. (hfy-optimisations-1 (copy-seq hfy-optimisations))
  1294. (hfy-optimisations (add-to-list 'hfy-optimisations-1
  1295. 'body-text-only))
  1296. (hfy-begin-span-handler
  1297. (lambda (style text-block text-id text-begins-block-p)
  1298. (insert (format "<text:span text:style-name=\"%s\">" style))))
  1299. (hfy-end-span-handler (lambda nil (insert "</text:span>"))))
  1300. (when (fboundp 'htmlfontify-string)
  1301. (let* ((lines (org-split-string lines "[\r\n]"))
  1302. (line-count (length lines))
  1303. (i 0))
  1304. (mapconcat
  1305. (lambda (line)
  1306. (incf i)
  1307. (org-odt-format-source-line-with-line-number-and-label
  1308. line rpllbl num 'htmlfontify-string
  1309. (if (= i line-count) "OrgSrcBlockLastLine" "OrgSrcBlock")))
  1310. lines "\n")))))
  1311. (defun org-odt-format-source-code-or-example (lines lang caption textareap
  1312. cols rows num cont
  1313. rpllbl fmt)
  1314. "Format source or example blocks for export.
  1315. Use `org-odt-format-source-code-or-example-plain' or
  1316. `org-odt-format-source-code-or-example-colored' depending on the
  1317. value of `org-export-odt-fontify-srcblocks."
  1318. (setq lines (org-export-number-lines
  1319. lines 0 0 num cont rpllbl fmt 'preprocess)
  1320. lines (funcall
  1321. (or (and org-export-odt-fontify-srcblocks
  1322. (or (featurep 'htmlfontify)
  1323. ;; htmlfontify.el was introduced in Emacs 23.2
  1324. ;; So load it with some caution
  1325. (require 'htmlfontify nil t))
  1326. (fboundp 'htmlfontify-string)
  1327. 'org-odt-format-source-code-or-example-colored)
  1328. 'org-odt-format-source-code-or-example-plain)
  1329. lines lang caption textareap cols rows num cont rpllbl fmt))
  1330. (if (not num) lines
  1331. (let ((extra (format " text:continue-numbering=\"%s\""
  1332. (if cont "true" "false"))))
  1333. (org-odt-format-tags
  1334. '("<text:list text:style-name=\"OrgSrcBlockNumberedLine\"%s>"
  1335. . "</text:list>") lines extra))))
  1336. (defun org-odt-remap-stylenames (style-name)
  1337. (or
  1338. (cdr (assoc style-name '(("timestamp-wrapper" . "OrgTimestampWrapper")
  1339. ("timestamp" . "OrgTimestamp")
  1340. ("timestamp-kwd" . "OrgTimestampKeyword")
  1341. ("tag" . "OrgTag")
  1342. ("todo" . "OrgTodo")
  1343. ("done" . "OrgDone")
  1344. ("target" . "OrgTarget"))))
  1345. style-name))
  1346. (defun org-odt-format-fontify (text style &optional id)
  1347. (let* ((style-name
  1348. (cond
  1349. ((stringp style)
  1350. (org-odt-remap-stylenames style))
  1351. ((symbolp style)
  1352. (org-odt-get-style-name-for-entity 'character style))
  1353. ((listp style)
  1354. (assert (< 1 (length style)))
  1355. (let ((parent-style (pop style)))
  1356. (mapconcat (lambda (s)
  1357. ;; (assert (stringp s) t)
  1358. (org-odt-remap-stylenames s)) style "")
  1359. (org-odt-remap-stylenames parent-style)))
  1360. (t (error "Don't how to handle style %s" style)))))
  1361. (org-odt-format-tags
  1362. '("<text:span text:style-name=\"%s\">" . "</text:span>")
  1363. text style-name)))
  1364. (defun org-odt-relocate-relative-path (path dir)
  1365. (if (file-name-absolute-p path) path
  1366. (file-relative-name (expand-file-name path dir)
  1367. (expand-file-name "eyecandy" dir))))
  1368. (defun org-odt-format-inline-image (thefile)
  1369. (let* ((thelink (if (file-name-absolute-p thefile) thefile
  1370. (org-xml-format-href
  1371. (org-odt-relocate-relative-path
  1372. thefile org-current-export-file))))
  1373. (href
  1374. (org-odt-format-tags
  1375. "<draw:image xlink:href=\"%s\" xlink:type=\"simple\" xlink:show=\"embed\" xlink:actuate=\"onLoad\"/>" ""
  1376. (if org-export-odt-embed-images
  1377. (org-odt-copy-image-file thefile) thelink))))
  1378. (org-export-odt-format-image thefile href)))
  1379. (defun org-export-odt-format-formula (src href)
  1380. (save-match-data
  1381. (let* ((caption (org-find-text-property-in-string 'org-caption src))
  1382. (caption (and caption (org-xml-format-desc caption)))
  1383. (label (org-find-text-property-in-string 'org-label src))
  1384. (latex-frag (org-find-text-property-in-string 'org-latex-src src))
  1385. (embed-as (or (and latex-frag
  1386. (org-find-text-property-in-string
  1387. 'org-latex-src-embed-type src))
  1388. (if (or caption label) 'paragraph 'character)))
  1389. width height)
  1390. (when latex-frag
  1391. (setq href (org-propertize href :title "LaTeX Fragment"
  1392. :description latex-frag)))
  1393. (cond
  1394. ((eq embed-as 'character)
  1395. (org-odt-format-entity "InlineFormula" href width height))
  1396. (t
  1397. (org-lparse-end-paragraph)
  1398. (org-lparse-insert-list-table
  1399. `((,(org-odt-format-entity
  1400. (if caption "CaptionedDisplayFormula" "DisplayFormula")
  1401. href width height :caption caption :label nil)
  1402. ,(if (not label) ""
  1403. (org-odt-format-entity-caption label nil "__MathFormula__"))))
  1404. nil nil nil ":style \"OrgEquation\"" nil '((1 "c" 8) (2 "c" 1)))
  1405. (throw 'nextline nil))))))
  1406. (defvar org-odt-embedded-formulas-count 0)
  1407. (defun org-odt-copy-formula-file (path)
  1408. "Returns the internal name of the file"
  1409. (let* ((src-file (expand-file-name
  1410. path (file-name-directory org-current-export-file)))
  1411. (target-dir (format "Formula-%04d/"
  1412. (incf org-odt-embedded-formulas-count)))
  1413. (target-file (concat target-dir "content.xml")))
  1414. (when (not org-lparse-to-buffer)
  1415. (message "Embedding %s as %s ..."
  1416. (substring-no-properties path) target-file)
  1417. (make-directory target-dir)
  1418. (org-odt-create-manifest-file-entry
  1419. "application/vnd.oasis.opendocument.formula" target-dir "1.2")
  1420. (case (org-odt-is-formula-link-p src-file)
  1421. (mathml
  1422. (copy-file src-file target-file 'overwrite))
  1423. (odf
  1424. (org-odt-zip-extract-one src-file "content.xml" target-dir))
  1425. (t
  1426. (error "%s is not a formula file" src-file)))
  1427. (org-odt-create-manifest-file-entry "text/xml" target-file))
  1428. target-file))
  1429. (defun org-odt-format-inline-formula (thefile)
  1430. (let* ((thelink (if (file-name-absolute-p thefile) thefile
  1431. (org-xml-format-href
  1432. (org-odt-relocate-relative-path
  1433. thefile org-current-export-file))))
  1434. (href
  1435. (org-odt-format-tags
  1436. "<draw:object xlink:href=\"%s\" xlink:type=\"simple\" xlink:show=\"embed\" xlink:actuate=\"onLoad\"/>" ""
  1437. (file-name-directory (org-odt-copy-formula-file thefile)))))
  1438. (org-export-odt-format-formula thefile href)))
  1439. (defun org-odt-is-formula-link-p (file)
  1440. (let ((case-fold-search nil))
  1441. (cond
  1442. ((string-match "\\.\\(mathml\\|mml\\)\\'" file)
  1443. 'mathml)
  1444. ((string-match "\\.odf\\'" file)
  1445. 'odf))))
  1446. (defun org-odt-format-org-link (opt-plist type-1 path fragment desc attr
  1447. descp)
  1448. "Make a OpenDocument link.
  1449. OPT-PLIST is an options list.
  1450. TYPE-1 is the device-type of the link (THIS://foo.html).
  1451. PATH is the path of the link (http://THIS#location).
  1452. FRAGMENT is the fragment part of the link, if any (foo.html#THIS).
  1453. DESC is the link description, if any.
  1454. ATTR is a string of other attributes of the a element."
  1455. (declare (special org-lparse-par-open))
  1456. (save-match-data
  1457. (let* ((may-inline-p
  1458. (and (member type-1 '("http" "https" "file"))
  1459. (org-lparse-should-inline-p path descp)
  1460. (not fragment)))
  1461. (type (if (equal type-1 "id") "file" type-1))
  1462. (filename path)
  1463. (thefile path)
  1464. sec-frag sec-nos)
  1465. (cond
  1466. ;; check for inlined images
  1467. ((and (member type '("file"))
  1468. (not fragment)
  1469. (org-file-image-p
  1470. filename org-export-odt-inline-image-extensions)
  1471. (or (eq t org-export-odt-inline-images)
  1472. (and org-export-odt-inline-images (not descp))))
  1473. (org-odt-format-inline-image thefile))
  1474. ;; check for embedded formulas
  1475. ((and (member type '("file"))
  1476. (not fragment)
  1477. (org-odt-is-formula-link-p filename)
  1478. (or (not descp)))
  1479. (org-odt-format-inline-formula thefile))
  1480. ;; code references
  1481. ((string= type "coderef")
  1482. (let* ((ref fragment)
  1483. (lineno-or-ref (cdr (assoc ref org-export-code-refs)))
  1484. (desc (and descp desc))
  1485. (org-odt-suppress-xref nil)
  1486. (href (org-xml-format-href (concat "#coderef-" ref))))
  1487. (cond
  1488. ((and (numberp lineno-or-ref) (not desc))
  1489. (org-odt-format-link lineno-or-ref href))
  1490. ((and (numberp lineno-or-ref) desc
  1491. (string-match (regexp-quote (concat "(" ref ")")) desc))
  1492. (format (replace-match "%s" t t desc)
  1493. (org-odt-format-link lineno-or-ref href)))
  1494. (t
  1495. (setq desc (format
  1496. (if (and desc (string-match
  1497. (regexp-quote (concat "(" ref ")"))
  1498. desc))
  1499. (replace-match "%s" t t desc)
  1500. (or desc "%s"))
  1501. lineno-or-ref))
  1502. (org-odt-format-link (org-xml-format-desc desc) href)))))
  1503. ;; links to headlines
  1504. ((and (string= type "")
  1505. (or (not thefile) (string= thefile ""))
  1506. (plist-get org-lparse-opt-plist :section-numbers)
  1507. (setq sec-frag fragment)
  1508. (org-find-text-property-in-string 'org-no-description fragment)
  1509. (or (string-match "\\`sec\\(\\(-[0-9]+\\)+\\)" sec-frag)
  1510. (and (setq sec-frag
  1511. (loop for alias in org-export-target-aliases do
  1512. (when (member fragment (cdr alias))
  1513. (return (car alias)))))
  1514. (string-match "\\`sec\\(\\(-[0-9]+\\)+\\)" sec-frag)))
  1515. (setq sec-nos (org-split-string (match-string 1 sec-frag) "-"))
  1516. (<= (length sec-nos) (plist-get org-lparse-opt-plist
  1517. :headline-levels)))
  1518. (let ((org-odt-suppress-xref nil))
  1519. (org-odt-format-link sec-nos (concat "#" sec-frag) attr)))
  1520. (t
  1521. (when (string= type "file")
  1522. (setq thefile
  1523. (cond
  1524. ((file-name-absolute-p path)
  1525. (concat "file://" (expand-file-name path)))
  1526. (t (org-odt-relocate-relative-path
  1527. thefile org-current-export-file)))))
  1528. (when (and (member type '("" "http" "https" "file")) fragment)
  1529. (setq thefile (concat thefile "#" fragment)))
  1530. (setq thefile (org-xml-format-href thefile))
  1531. (when (not (member type '("" "file")))
  1532. (setq thefile (concat type ":" thefile)))
  1533. (let ((org-odt-suppress-xref nil))
  1534. (org-odt-format-link
  1535. (org-xml-format-desc desc) thefile attr)))))))
  1536. (defun org-odt-format-heading (text level &optional id)
  1537. (let* ((text (if id (org-odt-format-target text id) text)))
  1538. (org-odt-format-tags
  1539. '("<text:h text:style-name=\"Heading_20_%s\" text:outline-level=\"%s\">" .
  1540. "</text:h>") text level level)))
  1541. (defun org-odt-format-headline (title extra-targets tags
  1542. &optional snumber level)
  1543. (concat
  1544. (org-lparse-format 'EXTRA-TARGETS extra-targets)
  1545. ;; No need to generate section numbers. They are auto-generated by
  1546. ;; the application
  1547. ;; (concat (org-lparse-format 'SECTION-NUMBER snumber level) " ")
  1548. title
  1549. (and tags (concat (org-lparse-format 'SPACES 3)
  1550. (org-lparse-format 'ORG-TAGS tags)))))
  1551. (defun org-odt-format-anchor (text name &optional class)
  1552. (org-odt-format-target text name))
  1553. (defun org-odt-format-bookmark (text id)
  1554. (if id
  1555. (org-odt-format-tags "<text:bookmark text:name=\"%s\"/>" text id)
  1556. text))
  1557. (defun org-odt-format-target (text id)
  1558. (let ((name (concat org-export-odt-bookmark-prefix id)))
  1559. (concat
  1560. (and id (org-odt-format-tags
  1561. "<text:bookmark-start text:name=\"%s\"/>" "" name))
  1562. (org-odt-format-bookmark text id)
  1563. (and id (org-odt-format-tags
  1564. "<text:bookmark-end text:name=\"%s\"/>" "" name)))))
  1565. (defun org-odt-format-footnote (n def)
  1566. (let ((id (concat "fn" n))
  1567. (note-class "footnote")
  1568. (par-style "Footnote"))
  1569. (org-odt-format-tags
  1570. '("<text:note text:id=\"%s\" text:note-class=\"%s\">" .
  1571. "</text:note>")
  1572. (concat
  1573. (org-odt-format-tags
  1574. '("<text:note-citation>" . "</text:note-citation>")
  1575. n)
  1576. (org-odt-format-tags
  1577. '("<text:note-body>" . "</text:note-body>")
  1578. def))
  1579. id note-class)))
  1580. (defun org-odt-format-footnote-reference (n def refcnt)
  1581. (if (= refcnt 1)
  1582. (org-odt-format-footnote n def)
  1583. (org-odt-format-footnote-ref n)))
  1584. (defun org-odt-format-footnote-ref (n)
  1585. (let ((note-class "footnote")
  1586. (ref-format "text")
  1587. (ref-name (concat "fn" n)))
  1588. (org-odt-format-tags
  1589. '("<text:span text:style-name=\"%s\">" . "</text:span>")
  1590. (org-odt-format-tags
  1591. '("<text:note-ref text:note-class=\"%s\" text:reference-format=\"%s\" text:ref-name=\"%s\">" . "</text:note-ref>")
  1592. n note-class ref-format ref-name)
  1593. "OrgSuperscript")))
  1594. (defun org-odt-get-image-name (file-name)
  1595. (require 'sha1)
  1596. (file-relative-name
  1597. (expand-file-name
  1598. (concat (sha1 file-name) "." (file-name-extension file-name)) "Pictures")))
  1599. (defun org-export-odt-format-image (src href)
  1600. "Create image tag with source and attributes."
  1601. (save-match-data
  1602. (let* ((caption (org-find-text-property-in-string 'org-caption src))
  1603. (caption (and caption (org-xml-format-desc caption)))
  1604. (attr (org-find-text-property-in-string 'org-attributes src))
  1605. (label (org-find-text-property-in-string 'org-label src))
  1606. (latex-frag (org-find-text-property-in-string
  1607. 'org-latex-src src))
  1608. (category (and latex-frag "__DvipngImage__"))
  1609. (attr-plist (org-lparse-get-block-params attr))
  1610. (user-frame-anchor
  1611. (car (assoc-string (plist-get attr-plist :anchor)
  1612. '(("as-char") ("paragraph") ("page")) t)))
  1613. (user-frame-style
  1614. (and user-frame-anchor (plist-get attr-plist :style)))
  1615. (user-frame-attrs
  1616. (and user-frame-anchor (plist-get attr-plist :attributes)))
  1617. (user-frame-params
  1618. (list user-frame-style user-frame-attrs user-frame-anchor))
  1619. (embed-as (cond
  1620. (latex-frag
  1621. (symbol-name
  1622. (case (org-find-text-property-in-string
  1623. 'org-latex-src-embed-type src)
  1624. (paragraph 'paragraph)
  1625. (t 'as-char))))
  1626. (user-frame-anchor)
  1627. (t "paragraph")))
  1628. (size (org-odt-image-size-from-file
  1629. src (plist-get attr-plist :width)
  1630. (plist-get attr-plist :height)
  1631. (plist-get attr-plist :scale) nil embed-as))
  1632. (width (car size)) (height (cdr size)))
  1633. (when latex-frag
  1634. (setq href (org-propertize href :title "LaTeX Fragment"
  1635. :description latex-frag)))
  1636. (let ((frame-style-handle (concat (and (or caption label) "Captioned")
  1637. embed-as "Image")))
  1638. (org-odt-format-entity
  1639. frame-style-handle href width height
  1640. :caption caption :label label :category category
  1641. :user-frame-params user-frame-params)))))
  1642. (defun org-odt-format-object-description (title description)
  1643. (concat (and title (org-odt-format-tags
  1644. '("<svg:title>" . "</svg:title>")
  1645. (org-odt-encode-plain-text title t)))
  1646. (and description (org-odt-format-tags
  1647. '("<svg:desc>" . "</svg:desc>")
  1648. (org-odt-encode-plain-text description t)))))
  1649. (defun org-odt-format-frame (text width height style &optional
  1650. extra anchor-type)
  1651. (let ((frame-attrs
  1652. (concat
  1653. (if width (format " svg:width=\"%0.2fcm\"" width) "")
  1654. (if height (format " svg:height=\"%0.2fcm\"" height) "")
  1655. extra
  1656. (format " text:anchor-type=\"%s\"" (or anchor-type "paragraph")))))
  1657. (org-odt-format-tags
  1658. '("<draw:frame draw:style-name=\"%s\"%s>" . "</draw:frame>")
  1659. (concat text (org-odt-format-object-description
  1660. (get-text-property 0 :title text)
  1661. (get-text-property 0 :description text)))
  1662. style frame-attrs)))
  1663. (defun org-odt-format-textbox (text width height style &optional
  1664. extra anchor-type)
  1665. (org-odt-format-frame
  1666. (org-odt-format-tags
  1667. '("<draw:text-box %s>" . "</draw:text-box>")
  1668. text (concat (format " fo:min-height=\"%0.2fcm\"" (or height .2))
  1669. (unless width
  1670. (format " fo:min-width=\"%0.2fcm\"" (or width .2)))))
  1671. width nil style extra anchor-type))
  1672. (defun org-odt-format-inlinetask (heading content
  1673. &optional todo priority tags)
  1674. (org-odt-format-stylized-paragraph
  1675. nil (org-odt-format-textbox
  1676. (concat (org-odt-format-stylized-paragraph
  1677. "OrgInlineTaskHeading"
  1678. (org-lparse-format
  1679. 'HEADLINE (concat (org-lparse-format-todo todo) " " heading)
  1680. nil tags))
  1681. content) nil nil "OrgInlineTaskFrame" " style:rel-width=\"100%\"")))
  1682. (defvar org-odt-entity-frame-styles
  1683. '(("As-CharImage" "__Figure__" ("OrgInlineImage" nil "as-char"))
  1684. ("ParagraphImage" "__Figure__" ("OrgDisplayImage" nil "paragraph"))
  1685. ("PageImage" "__Figure__" ("OrgPageImage" nil "page"))
  1686. ("CaptionedAs-CharImage" "__Figure__"
  1687. ("OrgCaptionedImage"
  1688. " style:rel-width=\"100%\" style:rel-height=\"scale\"" "paragraph")
  1689. ("OrgInlineImage" nil "as-char"))
  1690. ("CaptionedParagraphImage" "__Figure__"
  1691. ("OrgCaptionedImage"
  1692. " style:rel-width=\"100%\" style:rel-height=\"scale\"" "paragraph")
  1693. ("OrgImageCaptionFrame" nil "paragraph"))
  1694. ("CaptionedPageImage" "__Figure__"
  1695. ("OrgCaptionedImage"
  1696. " style:rel-width=\"100%\" style:rel-height=\"scale\"" "paragraph")
  1697. ("OrgPageImageCaptionFrame" nil "page"))
  1698. ("InlineFormula" "__MathFormula__" ("OrgInlineFormula" nil "as-char"))
  1699. ("DisplayFormula" "__MathFormula__" ("OrgDisplayFormula" nil "as-char"))
  1700. ("CaptionedDisplayFormula" "__MathFormula__"
  1701. ("OrgCaptionedFormula" nil "paragraph")
  1702. ("OrgFormulaCaptionFrame" nil "as-char"))))
  1703. (defun org-odt-merge-frame-params(default-frame-params user-frame-params)
  1704. (if (not user-frame-params) default-frame-params
  1705. (assert (= (length default-frame-params) 3))
  1706. (assert (= (length user-frame-params) 3))
  1707. (loop for user-frame-param in user-frame-params
  1708. for default-frame-param in default-frame-params
  1709. collect (or user-frame-param default-frame-param))))
  1710. (defun* org-odt-format-entity (entity href width height
  1711. &key caption label category
  1712. user-frame-params)
  1713. (let* ((entity-style (assoc-string entity org-odt-entity-frame-styles t))
  1714. default-frame-params frame-params)
  1715. (cond
  1716. ((not (or caption label))
  1717. (setq default-frame-params (nth 2 entity-style))
  1718. (setq frame-params (org-odt-merge-frame-params
  1719. default-frame-params user-frame-params))
  1720. (apply 'org-odt-format-frame href width height frame-params))
  1721. (t
  1722. (setq default-frame-params (nth 3 entity-style))
  1723. (setq frame-params (org-odt-merge-frame-params
  1724. default-frame-params user-frame-params))
  1725. (apply 'org-odt-format-textbox
  1726. (org-odt-format-stylized-paragraph
  1727. 'illustration
  1728. (concat
  1729. (apply 'org-odt-format-frame href width height
  1730. (nth 2 entity-style))
  1731. (org-odt-format-entity-caption
  1732. label caption (or category (nth 1 entity-style)))))
  1733. width height frame-params)))))
  1734. (defvar org-odt-embedded-images-count 0)
  1735. (defun org-odt-copy-image-file (path)
  1736. "Returns the internal name of the file"
  1737. (let* ((image-type (file-name-extension path))
  1738. (media-type (format "image/%s" image-type))
  1739. (src-file (expand-file-name
  1740. path (file-name-directory org-current-export-file)))
  1741. (target-dir "Images/")
  1742. (target-file
  1743. (format "%s%04d.%s" target-dir
  1744. (incf org-odt-embedded-images-count) image-type)))
  1745. (when (not org-lparse-to-buffer)
  1746. (message "Embedding %s as %s ..."
  1747. (substring-no-properties path) target-file)
  1748. (when (= 1 org-odt-embedded-images-count)
  1749. (make-directory target-dir)
  1750. (org-odt-create-manifest-file-entry "" target-dir))
  1751. (copy-file src-file target-file 'overwrite)
  1752. (org-odt-create-manifest-file-entry media-type target-file))
  1753. target-file))
  1754. (defvar org-export-odt-image-size-probe-method
  1755. (append (and (executable-find "identify") '(imagemagick)) ; See Bug#10675
  1756. '(emacs fixed))
  1757. "Ordered list of methods for determining image sizes.")
  1758. (defvar org-export-odt-default-image-sizes-alist
  1759. '(("as-char" . (5 . 0.4))
  1760. ("paragraph" . (5 . 5)))
  1761. "Hardcoded image dimensions one for each of the anchor
  1762. methods.")
  1763. ;; A4 page size is 21.0 by 29.7 cms
  1764. ;; The default page settings has 2cm margin on each of the sides. So
  1765. ;; the effective text area is 17.0 by 25.7 cm
  1766. (defvar org-export-odt-max-image-size '(17.0 . 20.0)
  1767. "Limiting dimensions for an embedded image.")
  1768. (defun org-odt-do-image-size (probe-method file &optional dpi anchor-type)
  1769. (setq dpi (or dpi org-export-odt-pixels-per-inch))
  1770. (setq anchor-type (or anchor-type "paragraph"))
  1771. (flet ((size-in-cms (size-in-pixels)
  1772. (flet ((pixels-to-cms (pixels)
  1773. (let* ((cms-per-inch 2.54)
  1774. (inches (/ pixels dpi)))
  1775. (* cms-per-inch inches))))
  1776. (and size-in-pixels
  1777. (cons (pixels-to-cms (car size-in-pixels))
  1778. (pixels-to-cms (cdr size-in-pixels)))))))
  1779. (case probe-method
  1780. (emacs
  1781. (size-in-cms (ignore-errors ; Emacs could be in batch mode
  1782. (clear-image-cache)
  1783. (image-size (create-image file) 'pixels))))
  1784. (imagemagick
  1785. (size-in-cms
  1786. (let ((dim (shell-command-to-string
  1787. (format "identify -format \"%%w:%%h\" \"%s\"" file))))
  1788. (when (string-match "\\([0-9]+\\):\\([0-9]+\\)" dim)
  1789. (cons (string-to-number (match-string 1 dim))
  1790. (string-to-number (match-string 2 dim)))))))
  1791. (t
  1792. (cdr (assoc-string anchor-type
  1793. org-export-odt-default-image-sizes-alist))))))
  1794. (defun org-odt-image-size-from-file (file &optional user-width
  1795. user-height scale dpi embed-as)
  1796. (unless (file-name-absolute-p file)
  1797. (setq file (expand-file-name
  1798. file (file-name-directory org-current-export-file))))
  1799. (let* (size width height)
  1800. (unless (and user-height user-width)
  1801. (loop for probe-method in org-export-odt-image-size-probe-method
  1802. until size
  1803. do (setq size (org-odt-do-image-size
  1804. probe-method file dpi embed-as)))
  1805. (or size (error "Cannot determine Image size. Aborting ..."))
  1806. (setq width (car size) height (cdr size)))
  1807. (cond
  1808. (scale
  1809. (setq width (* width scale) height (* height scale)))
  1810. ((and user-height user-width)
  1811. (setq width user-width height user-height))
  1812. (user-height
  1813. (setq width (* user-height (/ width height)) height user-height))
  1814. (user-width
  1815. (setq height (* user-width (/ height width)) width user-width))
  1816. (t (ignore)))
  1817. ;; ensure that an embedded image fits comfortably within a page
  1818. (let ((max-width (car org-export-odt-max-image-size))
  1819. (max-height (cdr org-export-odt-max-image-size)))
  1820. (when (or (> width max-width) (> height max-height))
  1821. (let* ((scale1 (/ max-width width))
  1822. (scale2 (/ max-height height))
  1823. (scale (min scale1 scale2)))
  1824. (setq width (* scale width) height (* scale height)))))
  1825. (cons width height)))
  1826. (defvar org-odt-entity-labels-alist nil
  1827. "Associate Labels with the Labeled entities.
  1828. Each element of the alist is of the form (LABEL-NAME
  1829. CATEGORY-NAME SEQNO LABEL-STYLE-NAME). LABEL-NAME is same as
  1830. that specified by \"#+LABEL: ...\" line. CATEGORY-NAME is the
  1831. type of the entity that LABEL-NAME is attached to. CATEGORY-NAME
  1832. can be one of \"Table\", \"Figure\" or \"Equation\". SEQNO is
  1833. the unique number assigned to the referenced entity on a
  1834. per-CATEGORY basis. It is generated sequentially and is 1-based.
  1835. LABEL-STYLE-NAME is a key `org-odt-label-styles'.
  1836. See `org-odt-add-label-definition' and
  1837. `org-odt-fixup-label-references'.")
  1838. (defvar org-odt-entity-counts-plist nil
  1839. "Plist of running counters of SEQNOs for each of the CATEGORY-NAMEs.
  1840. See `org-odt-entity-labels-alist' for known CATEGORY-NAMEs.")
  1841. (defvar org-odt-label-styles
  1842. '(("text" "(%n)" "text" "(%n)")
  1843. ("category-and-value" "%e %n%c" "category-and-value" "%e %n")
  1844. ("value" "%e %n%c" "value" "%n"))
  1845. "Specify how labels are applied and referenced.
  1846. This is an alist where each element is of the
  1847. form (LABEL-STYLE-NAME LABEL-ATTACH-FMT LABEL-REF-MODE
  1848. LABEL-REF-FMT).
  1849. LABEL-ATTACH-FMT controls how labels and captions are attached to
  1850. an entity. It may contain following specifiers - %e, %n and %c.
  1851. %e is replaced with the CATEGORY-NAME. %n is replaced with
  1852. \"<text:sequence ...> SEQNO </text:sequence>\". %c is replaced
  1853. with CAPTION. See `org-odt-format-label-definition'.
  1854. LABEL-REF-MODE and LABEL-REF-FMT controls how label references
  1855. are generated. The following XML is generated for a label
  1856. reference - \"<text:sequence-ref
  1857. text:reference-format=\"LABEL-REF-MODE\" ...> LABEL-REF-FMT
  1858. </text:sequence-ref>\". LABEL-REF-FMT may contain following
  1859. specifiers - %e and %n. %e is replaced with the CATEGORY-NAME.
  1860. %n is replaced with SEQNO. See
  1861. `org-odt-format-label-reference'.")
  1862. (defvar org-odt-category-map-alist
  1863. '(("__Table__" "Table" "value")
  1864. ("__Figure__" "Figure" "value")
  1865. ("__MathFormula__" "Equation" "text")
  1866. ("__DvipngImage__" "Equation" "value")
  1867. ;; ("__Table__" "Table" "category-and-value")
  1868. ;; ("__Figure__" "Figure" "category-and-value")
  1869. ;; ("__DvipngImage__" "Equation" "category-and-value")
  1870. )
  1871. "Map a CATEGORY-HANDLE to CATEGORY-NAME and LABEL-STYLE.
  1872. This is an alist where each element is of the form
  1873. \\(CATEGORY-HANDLE CATEGORY-NAME LABEL-STYLE\\). CATEGORY_HANDLE
  1874. could either be one of the internal handles (as seen above) or be
  1875. derived from the \"#+LABEL:<label-name>\" specification. See
  1876. `org-export-odt-get-category-from-label'. CATEGORY-NAME and
  1877. LABEL-STYLE are used for generating ODT labels. See
  1878. `org-odt-label-styles'.")
  1879. (defvar org-export-odt-user-categories
  1880. '("Illustration" "Table" "Text" "Drawing" "Equation" "Figure"))
  1881. (defvar org-export-odt-get-category-from-label nil
  1882. "Should category of label be inferred from label itself.
  1883. When this option is non-nil, a label is parsed in to two
  1884. component parts delimited by a \":\" (colon) as shown here -
  1885. #+LABEL:[CATEGORY-HANDLE:]EXTRA. The CATEGORY-HANDLE is mapped
  1886. to a CATEGORY-NAME and LABEL-STYLE using
  1887. `org-odt-category-map-alist'. (If no such map is provided and
  1888. CATEGORY-NAME is set to CATEGORY-HANDLE and LABEL-STYLE is set to
  1889. \"category-and-value\"). If CATEGORY-NAME so obtained is listed
  1890. under `org-export-odt-user-categories' then the user specified
  1891. styles are used. Otherwise styles as determined by the internal
  1892. CATEGORY-HANDLE is used. See
  1893. `org-odt-get-label-category-and-style' for details.")
  1894. (defun org-odt-get-label-category-and-style (label default-category)
  1895. "See `org-export-odt-get-category-from-label'."
  1896. (let ((default-category-map
  1897. (assoc default-category org-odt-category-map-alist))
  1898. user-category user-category-map category)
  1899. (cond
  1900. ((not org-export-odt-get-category-from-label)
  1901. default-category-map)
  1902. ((not (setq user-category
  1903. (save-match-data
  1904. (and (string-match "\\`\\(.*\\):.+" label)
  1905. (match-string 1 label)))))
  1906. default-category-map)
  1907. (t
  1908. (setq user-category-map
  1909. (or (assoc user-category org-odt-category-map-alist)
  1910. (list nil user-category "category-and-value"))
  1911. category (nth 1 user-category-map))
  1912. (if (member category org-export-odt-user-categories)
  1913. user-category-map
  1914. default-category-map)))))
  1915. (defun org-odt-add-label-definition (label default-category)
  1916. "Create an entry in `org-odt-entity-labels-alist' and return it."
  1917. (setq label (substring-no-properties label))
  1918. (let* ((label-props (org-odt-get-label-category-and-style
  1919. label default-category))
  1920. (category (nth 1 label-props))
  1921. (counter category)
  1922. (label-style (nth 2 label-props))
  1923. (sequence-var (intern (mapconcat
  1924. 'downcase
  1925. (org-split-string counter) "-")))
  1926. (seqno (1+ (or (plist-get org-odt-entity-counts-plist sequence-var)
  1927. 0)))
  1928. (label-props (list label category seqno label-style)))
  1929. (setq org-odt-entity-counts-plist
  1930. (plist-put org-odt-entity-counts-plist sequence-var seqno))
  1931. (push label-props org-odt-entity-labels-alist)
  1932. label-props))
  1933. (defun org-odt-format-label-definition (caption label category seqno label-style)
  1934. (assert label)
  1935. (format-spec
  1936. (cadr (assoc-string label-style org-odt-label-styles t))
  1937. `((?e . ,category)
  1938. (?n . ,(org-odt-format-tags
  1939. '("<text:sequence text:ref-name=\"%s\" text:name=\"%s\" text:formula=\"ooow:%s+1\" style:num-format=\"1\">" . "</text:sequence>")
  1940. (format "%d" seqno) label category category))
  1941. (?c . ,(or (and caption (concat ": " caption)) "")))))
  1942. (defun org-odt-format-label-reference (label category seqno label-style)
  1943. (assert label)
  1944. (save-match-data
  1945. (let* ((fmt (cddr (assoc-string label-style org-odt-label-styles t)))
  1946. (fmt1 (car fmt))
  1947. (fmt2 (cadr fmt)))
  1948. (org-odt-format-tags
  1949. '("<text:sequence-ref text:reference-format=\"%s\" text:ref-name=\"%s\">"
  1950. . "</text:sequence-ref>")
  1951. (format-spec fmt2 `((?e . ,category)
  1952. (?n . ,(format "%d" seqno)))) fmt1 label))))
  1953. (defun org-odt-fixup-label-references ()
  1954. (goto-char (point-min))
  1955. (while (re-search-forward
  1956. "<text:sequence-ref text:ref-name=\"\\([^\"]+\\)\">[ \t\n]*</text:sequence-ref>"
  1957. nil t)
  1958. (let* ((label (match-string 1))
  1959. (label-def (assoc label org-odt-entity-labels-alist))
  1960. (rpl (and label-def
  1961. (apply 'org-odt-format-label-reference label-def))))
  1962. (if rpl (replace-match rpl t t)
  1963. (org-lparse-warn
  1964. (format "Unable to resolve reference to label \"%s\"" label))))))
  1965. (defun org-odt-format-entity-caption (label caption category)
  1966. (or (and label
  1967. (apply 'org-odt-format-label-definition
  1968. caption (org-odt-add-label-definition label category)))
  1969. caption ""))
  1970. (defun org-odt-format-tags (tag text &rest args)
  1971. (let ((prefix (when org-lparse-encode-pending "@"))
  1972. (suffix (when org-lparse-encode-pending "@")))
  1973. (apply 'org-lparse-format-tags tag text prefix suffix args)))
  1974. (defvar org-odt-manifest-file-entries nil)
  1975. (defun org-odt-init-outfile (filename)
  1976. (unless (executable-find "zip")
  1977. ;; Not at all OSes ship with zip by default
  1978. (error "Executable \"zip\" needed for creating OpenDocument files"))
  1979. (let* ((outdir (make-temp-file
  1980. (format org-export-odt-tmpdir-prefix org-lparse-backend) t))
  1981. (content-file (expand-file-name "content.xml" outdir)))
  1982. ;; init conten.xml
  1983. (with-current-buffer (find-file-noselect content-file t))
  1984. ;; reset variables
  1985. (setq org-odt-manifest-file-entries nil
  1986. org-odt-embedded-images-count 0
  1987. org-odt-embedded-formulas-count 0
  1988. org-odt-entity-labels-alist nil
  1989. org-odt-list-stack-stashed nil
  1990. org-odt-automatic-styles nil
  1991. org-odt-object-counters nil
  1992. org-odt-entity-counts-plist nil)
  1993. content-file))
  1994. (defcustom org-export-odt-prettify-xml nil
  1995. "Specify whether or not the xml output should be prettified.
  1996. When this option is turned on, `indent-region' is run on all
  1997. component xml buffers before they are saved. Turn this off for
  1998. regular use. Turn this on if you need to examine the xml
  1999. visually."
  2000. :group 'org-export-odt
  2001. :version "24.1"
  2002. :type 'boolean)
  2003. (defvar hfy-user-sheet-assoc) ; bound during org-do-lparse
  2004. (defun org-odt-save-as-outfile (target opt-plist)
  2005. ;; write automatic styles
  2006. (org-odt-write-automatic-styles)
  2007. ;; write meta file
  2008. (org-odt-update-meta-file opt-plist)
  2009. ;; write styles file
  2010. (when (equal org-lparse-backend 'odt)
  2011. (org-odt-update-styles-file opt-plist))
  2012. ;; create mimetype file
  2013. (let ((mimetype (org-odt-write-mimetype-file org-lparse-backend)))
  2014. (org-odt-create-manifest-file-entry mimetype "/" "1.2"))
  2015. ;; create a manifest entry for content.xml
  2016. (org-odt-create-manifest-file-entry "text/xml" "content.xml")
  2017. ;; write out the manifest entries before zipping
  2018. (org-odt-write-manifest-file)
  2019. (let ((xml-files '("mimetype" "META-INF/manifest.xml" "content.xml"
  2020. "meta.xml"))
  2021. (zipdir default-directory))
  2022. (when (equal org-lparse-backend 'odt)
  2023. (push "styles.xml" xml-files))
  2024. (message "Switching to directory %s" (expand-file-name zipdir))
  2025. ;; save all xml files
  2026. (mapc (lambda (file)
  2027. (with-current-buffer
  2028. (find-file-noselect (expand-file-name file) t)
  2029. ;; prettify output if needed
  2030. (when org-export-odt-prettify-xml
  2031. (indent-region (point-min) (point-max)))
  2032. (save-buffer 0)))
  2033. xml-files)
  2034. (let* ((target-name (file-name-nondirectory target))
  2035. (target-dir (file-name-directory target))
  2036. (cmds `(("zip" "-mX0" ,target-name "mimetype")
  2037. ("zip" "-rmTq" ,target-name "."))))
  2038. (when (file-exists-p target)
  2039. ;; FIXME: If the file is locked this throws a cryptic error
  2040. (delete-file target))
  2041. (let ((coding-system-for-write 'no-conversion) exitcode err-string)
  2042. (message "Creating odt file...")
  2043. (mapc
  2044. (lambda (cmd)
  2045. (message "Running %s" (mapconcat 'identity cmd " "))
  2046. (setq err-string
  2047. (with-output-to-string
  2048. (setq exitcode
  2049. (apply 'call-process (car cmd)
  2050. nil standard-output nil (cdr cmd)))))
  2051. (or (zerop exitcode)
  2052. (ignore (message "%s" err-string))
  2053. (error "Unable to create odt file (%S)" exitcode)))
  2054. cmds))
  2055. ;; move the file from outdir to target-dir
  2056. (rename-file target-name target-dir)
  2057. ;; kill all xml buffers
  2058. (mapc (lambda (file)
  2059. (kill-buffer
  2060. (find-file-noselect (expand-file-name file zipdir) t)))
  2061. xml-files)
  2062. (delete-directory zipdir)))
  2063. (message "Created %s" target)
  2064. (set-buffer (find-file-noselect target t)))
  2065. (defconst org-odt-manifest-file-entry-tag
  2066. "
  2067. <manifest:file-entry manifest:media-type=\"%s\" manifest:full-path=\"%s\"%s/>")
  2068. (defun org-odt-create-manifest-file-entry (&rest args)
  2069. (push args org-odt-manifest-file-entries))
  2070. (defun org-odt-write-manifest-file ()
  2071. (make-directory "META-INF")
  2072. (let ((manifest-file (expand-file-name "META-INF/manifest.xml")))
  2073. (with-current-buffer
  2074. (find-file-noselect manifest-file t)
  2075. (insert
  2076. "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
  2077. <manifest:manifest xmlns:manifest=\"urn:oasis:names:tc:opendocument:xmlns:manifest:1.0\" manifest:version=\"1.2\">\n")
  2078. (mapc
  2079. (lambda (file-entry)
  2080. (let* ((version (nth 2 file-entry))
  2081. (extra (if version
  2082. (format " manifest:version=\"%s\"" version)
  2083. "")))
  2084. (insert
  2085. (format org-odt-manifest-file-entry-tag
  2086. (nth 0 file-entry) (nth 1 file-entry) extra))))
  2087. org-odt-manifest-file-entries)
  2088. (insert "\n</manifest:manifest>"))))
  2089. (defun org-odt-update-meta-file (opt-plist)
  2090. (let ((date (org-odt-format-date (plist-get opt-plist :date)))
  2091. (author (or (plist-get opt-plist :author) ""))
  2092. (email (plist-get opt-plist :email))
  2093. (keywords (plist-get opt-plist :keywords))
  2094. (description (plist-get opt-plist :description))
  2095. (title (plist-get opt-plist :title)))
  2096. (write-region
  2097. (concat
  2098. "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
  2099. <office:document-meta
  2100. xmlns:office=\"urn:oasis:names:tc:opendocument:xmlns:office:1.0\"
  2101. xmlns:xlink=\"http://www.w3.org/1999/xlink\"
  2102. xmlns:dc=\"http://purl.org/dc/elements/1.1/\"
  2103. xmlns:meta=\"urn:oasis:names:tc:opendocument:xmlns:meta:1.0\"
  2104. xmlns:ooo=\"http://openoffice.org/2004/office\"
  2105. office:version=\"1.2\">
  2106. <office:meta>" "\n"
  2107. (org-odt-format-author)
  2108. (org-odt-format-tags
  2109. '("\n<meta:initial-creator>" . "</meta:initial-creator>") author)
  2110. (org-odt-format-tags '("\n<dc:date>" . "</dc:date>") date)
  2111. (org-odt-format-tags
  2112. '("\n<meta:creation-date>" . "</meta:creation-date>") date)
  2113. (org-odt-format-tags '("\n<meta:generator>" . "</meta:generator>")
  2114. (when org-export-creator-info
  2115. (format "Org-%s/Emacs-%s"
  2116. org-version emacs-version)))
  2117. (org-odt-format-tags '("\n<meta:keyword>" . "</meta:keyword>") keywords)
  2118. (org-odt-format-tags '("\n<dc:subject>" . "</dc:subject>") description)
  2119. (org-odt-format-tags '("\n<dc:title>" . "</dc:title>") title)
  2120. "\n"
  2121. " </office:meta>" "</office:document-meta>")
  2122. nil (expand-file-name "meta.xml")))
  2123. ;; create a manifest entry for meta.xml
  2124. (org-odt-create-manifest-file-entry "text/xml" "meta.xml"))
  2125. (defun org-odt-update-styles-file (opt-plist)
  2126. ;; write styles file
  2127. (let ((styles-file (plist-get opt-plist :odt-styles-file)))
  2128. (org-odt-copy-styles-file (and styles-file
  2129. (read (org-trim styles-file)))))
  2130. ;; Update styles.xml - take care of outline numbering
  2131. (with-current-buffer
  2132. (find-file-noselect (expand-file-name "styles.xml") t)
  2133. ;; Don't make automatic backup of styles.xml file. This setting
  2134. ;; prevents the backed-up styles.xml file from being zipped in to
  2135. ;; odt file. This is more of a hackish fix. Better alternative
  2136. ;; would be to fix the zip command so that the output odt file
  2137. ;; includes only the needed files and excludes any auto-generated
  2138. ;; extra files like backups and auto-saves etc etc. Note that
  2139. ;; currently the zip command zips up the entire temp directory so
  2140. ;; that any auto-generated files created under the hood ends up in
  2141. ;; the resulting odt file.
  2142. (set (make-local-variable 'backup-inhibited) t)
  2143. ;; Import local setting of `org-export-with-section-numbers'
  2144. (org-lparse-bind-local-variables opt-plist)
  2145. (org-odt-configure-outline-numbering
  2146. (if org-export-with-section-numbers org-export-headline-levels 0)))
  2147. ;; Write custom styles for source blocks
  2148. (org-odt-insert-custom-styles-for-srcblocks
  2149. (mapconcat
  2150. (lambda (style)
  2151. (format " %s\n" (cddr style)))
  2152. hfy-user-sheet-assoc "")))
  2153. (defun org-odt-write-mimetype-file (format)
  2154. ;; create mimetype file
  2155. (let ((mimetype
  2156. (case format
  2157. (odt "application/vnd.oasis.opendocument.text")
  2158. (odf "application/vnd.oasis.opendocument.formula")
  2159. (t (error "Unknown OpenDocument backend %S" org-lparse-backend)))))
  2160. (write-region mimetype nil (expand-file-name "mimetype"))
  2161. mimetype))
  2162. (defun org-odt-finalize-outfile ()
  2163. (org-odt-delete-empty-paragraphs))
  2164. (defun org-odt-delete-empty-paragraphs ()
  2165. (goto-char (point-min))
  2166. (let ((open "<text:p[^>]*>")
  2167. (close "</text:p>"))
  2168. (while (re-search-forward (format "%s[ \r\n\t]*%s" open close) nil t)
  2169. (replace-match ""))))
  2170. (defcustom org-export-odt-convert-processes
  2171. '(("LibreOffice"
  2172. "soffice --headless --convert-to %f%x --outdir %d %i")
  2173. ("unoconv"
  2174. "unoconv -f %f -o %d %i"))
  2175. "Specify a list of document converters and their usage.
  2176. The converters in this list are offered as choices while
  2177. customizing `org-export-odt-convert-process'.
  2178. This variable is a list where each element is of the
  2179. form (CONVERTER-NAME CONVERTER-CMD). CONVERTER-NAME is the name
  2180. of the converter. CONVERTER-CMD is the shell command for the
  2181. converter and can contain format specifiers. These format
  2182. specifiers are interpreted as below:
  2183. %i input file name in full
  2184. %I input file name as a URL
  2185. %f format of the output file
  2186. %o output file name in full
  2187. %O output file name as a URL
  2188. %d output dir in full
  2189. %D output dir as a URL.
  2190. %x extra options as set in `org-export-odt-convert-capabilities'."
  2191. :group 'org-export-odt
  2192. :version "24.1"
  2193. :type
  2194. '(choice
  2195. (const :tag "None" nil)
  2196. (alist :tag "Converters"
  2197. :key-type (string :tag "Converter Name")
  2198. :value-type (group (string :tag "Command line")))))
  2199. (defcustom org-export-odt-convert-process "LibreOffice"
  2200. "Use this converter to convert from \"odt\" format to other formats.
  2201. During customization, the list of converter names are populated
  2202. from `org-export-odt-convert-processes'."
  2203. :group 'org-export-odt
  2204. :version "24.1"
  2205. :type '(choice :convert-widget
  2206. (lambda (w)
  2207. (apply 'widget-convert (widget-type w)
  2208. (eval (car (widget-get w :args)))))
  2209. `((const :tag "None" nil)
  2210. ,@(mapcar (lambda (c)
  2211. `(const :tag ,(car c) ,(car c)))
  2212. org-export-odt-convert-processes))))
  2213. (defcustom org-export-odt-convert-capabilities
  2214. '(("Text"
  2215. ("odt" "ott" "doc" "rtf" "docx")
  2216. (("pdf" "pdf") ("odt" "odt") ("rtf" "rtf") ("ott" "ott")
  2217. ("doc" "doc" ":\"MS Word 97\"") ("docx" "docx") ("html" "html")))
  2218. ("Web"
  2219. ("html")
  2220. (("pdf" "pdf") ("odt" "odt") ("html" "html")))
  2221. ("Spreadsheet"
  2222. ("ods" "ots" "xls" "csv" "xlsx")
  2223. (("pdf" "pdf") ("ots" "ots") ("html" "html") ("csv" "csv") ("ods" "ods")
  2224. ("xls" "xls") ("xlsx" "xlsx")))
  2225. ("Presentation"
  2226. ("odp" "otp" "ppt" "pptx")
  2227. (("pdf" "pdf") ("swf" "swf") ("odp" "odp") ("otp" "otp") ("ppt" "ppt")
  2228. ("pptx" "pptx") ("odg" "odg"))))
  2229. "Specify input and output formats of `org-export-odt-convert-process'.
  2230. More correctly, specify the set of input and output formats that
  2231. the user is actually interested in.
  2232. This variable is an alist where each element is of the
  2233. form (DOCUMENT-CLASS INPUT-FMT-LIST OUTPUT-FMT-ALIST).
  2234. INPUT-FMT-LIST is a list of INPUT-FMTs. OUTPUT-FMT-ALIST is an
  2235. alist where each element is of the form (OUTPUT-FMT
  2236. OUTPUT-FILE-EXTENSION EXTRA-OPTIONS).
  2237. The variable is interpreted as follows:
  2238. `org-export-odt-convert-process' can take any document that is in
  2239. INPUT-FMT-LIST and produce any document that is in the
  2240. OUTPUT-FMT-LIST. A document converted to OUTPUT-FMT will have
  2241. OUTPUT-FILE-EXTENSION as the file name extension. OUTPUT-FMT
  2242. serves dual purposes:
  2243. - It is used for populating completion candidates during
  2244. `org-export-odt-convert' commands.
  2245. - It is used as the value of \"%f\" specifier in
  2246. `org-export-odt-convert-process'.
  2247. EXTRA-OPTIONS is used as the value of \"%x\" specifier in
  2248. `org-export-odt-convert-process'.
  2249. DOCUMENT-CLASS is used to group a set of file formats in
  2250. INPUT-FMT-LIST in to a single class.
  2251. Note that this variable inherently captures how LibreOffice based
  2252. converters work. LibreOffice maps documents of various formats
  2253. to classes like Text, Web, Spreadsheet, Presentation etc and
  2254. allow document of a given class (irrespective of it's source
  2255. format) to be converted to any of the export formats associated
  2256. with that class.
  2257. See default setting of this variable for an typical
  2258. configuration."
  2259. :group 'org-export-odt
  2260. :version "24.1"
  2261. :type
  2262. '(choice
  2263. (const :tag "None" nil)
  2264. (alist :tag "Capabilities"
  2265. :key-type (string :tag "Document Class")
  2266. :value-type
  2267. (group (repeat :tag "Input formats" (string :tag "Input format"))
  2268. (alist :tag "Output formats"
  2269. :key-type (string :tag "Output format")
  2270. :value-type
  2271. (group (string :tag "Output file extension")
  2272. (choice
  2273. (const :tag "None" nil)
  2274. (string :tag "Extra options"))))))))
  2275. (declare-function org-create-math-formula "org"
  2276. (latex-frag &optional mathml-file))
  2277. ;;;###autoload
  2278. (defun org-export-odt-convert (&optional in-file out-fmt prefix-arg)
  2279. "Convert IN-FILE to format OUT-FMT using a command line converter.
  2280. IN-FILE is the file to be converted. If unspecified, it defaults
  2281. to variable `buffer-file-name'. OUT-FMT is the desired output
  2282. format. Use `org-export-odt-convert-process' as the converter.
  2283. If PREFIX-ARG is non-nil then the newly converted file is opened
  2284. using `org-open-file'."
  2285. (interactive
  2286. (append (org-lparse-convert-read-params) current-prefix-arg))
  2287. (org-lparse-do-convert in-file out-fmt prefix-arg))
  2288. (defun org-odt-get (what &optional opt-plist)
  2289. (case what
  2290. (BACKEND 'odt)
  2291. (EXPORT-DIR (org-export-directory :html opt-plist))
  2292. (FILE-NAME-EXTENSION "odt")
  2293. (EXPORT-BUFFER-NAME "*Org ODT Export*")
  2294. (ENTITY-CONTROL org-odt-entity-control-callbacks-alist)
  2295. (ENTITY-FORMAT org-odt-entity-format-callbacks-alist)
  2296. (INIT-METHOD 'org-odt-init-outfile)
  2297. (FINAL-METHOD 'org-odt-finalize-outfile)
  2298. (SAVE-METHOD 'org-odt-save-as-outfile)
  2299. (CONVERT-METHOD
  2300. (and org-export-odt-convert-process
  2301. (cadr (assoc-string org-export-odt-convert-process
  2302. org-export-odt-convert-processes t))))
  2303. (CONVERT-CAPABILITIES
  2304. (and org-export-odt-convert-process
  2305. (cadr (assoc-string org-export-odt-convert-process
  2306. org-export-odt-convert-processes t))
  2307. org-export-odt-convert-capabilities))
  2308. (TOPLEVEL-HLEVEL 1)
  2309. (SPECIAL-STRING-REGEXPS org-export-odt-special-string-regexps)
  2310. (INLINE-IMAGES 'maybe)
  2311. (INLINE-IMAGE-EXTENSIONS '("png" "jpeg" "jpg" "gif" "svg"))
  2312. (PLAIN-TEXT-MAP '(("&" . "&amp;") ("<" . "&lt;") (">" . "&gt;")))
  2313. (TABLE-FIRST-COLUMN-AS-LABELS nil)
  2314. (FOOTNOTE-SEPARATOR (org-lparse-format 'FONTIFY "," 'superscript))
  2315. (CODING-SYSTEM-FOR-WRITE 'utf-8)
  2316. (CODING-SYSTEM-FOR-SAVE 'utf-8)
  2317. (t (error "Unknown property: %s" what))))
  2318. (defvar org-lparse-latex-fragment-fallback) ; set by org-do-lparse
  2319. (defun org-export-odt-do-preprocess-latex-fragments ()
  2320. "Convert LaTeX fragments to images."
  2321. (let* ((latex-frag-opt (plist-get org-lparse-opt-plist :LaTeX-fragments))
  2322. (latex-frag-opt ; massage the options
  2323. (or (and (member latex-frag-opt '(mathjax t))
  2324. (not (and (fboundp 'org-format-latex-mathml-available-p)
  2325. (org-format-latex-mathml-available-p)))
  2326. (prog1 org-lparse-latex-fragment-fallback
  2327. (org-lparse-warn
  2328. (concat
  2329. "LaTeX to MathML converter not available. "
  2330. (format "Using %S instead."
  2331. org-lparse-latex-fragment-fallback)))))
  2332. latex-frag-opt))
  2333. cache-dir display-msg)
  2334. (cond
  2335. ((eq latex-frag-opt 'dvipng)
  2336. (setq cache-dir "ltxpng/")
  2337. (setq display-msg "Creating LaTeX image %s"))
  2338. ((member latex-frag-opt '(mathjax t))
  2339. (setq latex-frag-opt 'mathml)
  2340. (setq cache-dir "ltxmathml/")
  2341. (setq display-msg "Creating MathML formula %s")))
  2342. (when (and org-current-export-file)
  2343. (org-format-latex
  2344. (concat cache-dir (file-name-sans-extension
  2345. (file-name-nondirectory org-current-export-file)))
  2346. org-current-export-dir nil display-msg
  2347. nil nil latex-frag-opt))))
  2348. (defadvice org-format-latex-as-mathml
  2349. (after org-odt-protect-latex-fragment activate)
  2350. "Encode LaTeX fragment as XML.
  2351. Do this when translation to MathML fails."
  2352. (when (or (not (> (length ad-return-value) 0))
  2353. (get-text-property 0 'org-protected ad-return-value))
  2354. (setq ad-return-value
  2355. (org-propertize (org-odt-encode-plain-text (ad-get-arg 0))
  2356. 'org-protected t))))
  2357. (defun org-export-odt-preprocess-latex-fragments ()
  2358. (when (equal org-export-current-backend 'odt)
  2359. (org-export-odt-do-preprocess-latex-fragments)))
  2360. (defun org-export-odt-preprocess-label-references ()
  2361. (goto-char (point-min))
  2362. (let (label label-components category value pretty-label)
  2363. (while (re-search-forward "\\\\ref{\\([^{}\n]+\\)}" nil t)
  2364. (org-if-unprotected-at (match-beginning 1)
  2365. (replace-match
  2366. (let ((org-lparse-encode-pending t)
  2367. (label (match-string 1)))
  2368. ;; markup generated below is mostly an eye-candy. At
  2369. ;; pre-processing stage, there is no information on which
  2370. ;; entity a label reference points to. The actual markup
  2371. ;; is generated as part of `org-odt-fixup-label-references'
  2372. ;; which gets called at the fag end of export. By this
  2373. ;; time we would have seen and collected all the label
  2374. ;; definitions in `org-odt-entity-labels-alist'.
  2375. (org-odt-format-tags
  2376. '("<text:sequence-ref text:ref-name=\"%s\">" .
  2377. "</text:sequence-ref>")
  2378. "" (org-add-props label '(org-protected t)))) t t)))))
  2379. ;; process latex fragments as part of
  2380. ;; `org-export-preprocess-after-blockquote-hook'. Note that this hook
  2381. ;; is the one that is closest and well before the call to
  2382. ;; `org-export-attach-captions-and-attributes' in
  2383. ;; `org-export-preprocess-string'. The above arrangement permits
  2384. ;; captions, labels and attributes to be attached to png images
  2385. ;; generated out of latex equations.
  2386. (add-hook 'org-export-preprocess-after-blockquote-hook
  2387. 'org-export-odt-preprocess-latex-fragments)
  2388. (defun org-export-odt-preprocess (parameters)
  2389. (org-export-odt-preprocess-label-references))
  2390. (declare-function archive-zip-extract "arc-mode.el" (archive name))
  2391. (defun org-odt-zip-extract-one (archive member &optional target)
  2392. (require 'arc-mode)
  2393. (let* ((target (or target default-directory))
  2394. (archive (expand-file-name archive))
  2395. (archive-zip-extract
  2396. (list "unzip" "-qq" "-o" "-d" target))
  2397. exit-code command-output)
  2398. (setq command-output
  2399. (with-temp-buffer
  2400. (setq exit-code (archive-zip-extract archive member))
  2401. (buffer-string)))
  2402. (unless (zerop exit-code)
  2403. (message command-output)
  2404. (error "Extraction failed"))))
  2405. (defun org-odt-zip-extract (archive members &optional target)
  2406. (when (atom members) (setq members (list members)))
  2407. (mapc (lambda (member)
  2408. (org-odt-zip-extract-one archive member target))
  2409. members))
  2410. (defun org-odt-copy-styles-file (&optional styles-file)
  2411. ;; Non-availability of styles.xml is not a critical error. For now
  2412. ;; throw an error purely for aesthetic reasons.
  2413. (setq styles-file (or styles-file
  2414. org-export-odt-styles-file
  2415. (expand-file-name "OrgOdtStyles.xml"
  2416. org-odt-styles-dir)
  2417. (error "org-odt: Missing styles file?")))
  2418. (cond
  2419. ((listp styles-file)
  2420. (let ((archive (nth 0 styles-file))
  2421. (members (nth 1 styles-file)))
  2422. (org-odt-zip-extract archive members)
  2423. (mapc
  2424. (lambda (member)
  2425. (when (org-file-image-p member)
  2426. (let* ((image-type (file-name-extension member))
  2427. (media-type (format "image/%s" image-type)))
  2428. (org-odt-create-manifest-file-entry media-type member))))
  2429. members)))
  2430. ((and (stringp styles-file) (file-exists-p styles-file))
  2431. (let ((styles-file-type (file-name-extension styles-file)))
  2432. (cond
  2433. ((string= styles-file-type "xml")
  2434. (copy-file styles-file "styles.xml" t))
  2435. ((member styles-file-type '("odt" "ott"))
  2436. (org-odt-zip-extract styles-file "styles.xml")))))
  2437. (t
  2438. (error (format "Invalid specification of styles.xml file: %S"
  2439. org-export-odt-styles-file))))
  2440. ;; create a manifest entry for styles.xml
  2441. (org-odt-create-manifest-file-entry "text/xml" "styles.xml"))
  2442. (defun org-odt-configure-outline-numbering (level)
  2443. "Outline numbering is retained only upto LEVEL.
  2444. To disable outline numbering pass a LEVEL of 0."
  2445. (goto-char (point-min))
  2446. (let ((regex
  2447. "<text:outline-level-style\\([^>]*\\)text:level=\"\\([^\"]*\\)\"\\([^>]*\\)>")
  2448. (replacement
  2449. "<text:outline-level-style\\1text:level=\"\\2\" style:num-format=\"\">"))
  2450. (while (re-search-forward regex nil t)
  2451. (when (> (string-to-number (match-string 2)) level)
  2452. (replace-match replacement t nil))))
  2453. (save-buffer 0))
  2454. ;;;###autoload
  2455. (defun org-export-as-odf (latex-frag &optional odf-file)
  2456. "Export LATEX-FRAG as OpenDocument formula file ODF-FILE.
  2457. Use `org-create-math-formula' to convert LATEX-FRAG first to
  2458. MathML. When invoked as an interactive command, use
  2459. `org-latex-regexps' to infer LATEX-FRAG from currently active
  2460. region. If no LaTeX fragments are found, prompt for it. Push
  2461. MathML source to kill ring, if `org-export-copy-to-kill-ring' is
  2462. non-nil."
  2463. (interactive
  2464. `(,(let (frag)
  2465. (setq frag (and (setq frag (and (region-active-p)
  2466. (buffer-substring (region-beginning)
  2467. (region-end))))
  2468. (loop for e in org-latex-regexps
  2469. thereis (when (string-match (nth 1 e) frag)
  2470. (match-string (nth 2 e) frag)))))
  2471. (read-string "LaTeX Fragment: " frag nil frag))
  2472. ,(let ((odf-filename (expand-file-name
  2473. (concat
  2474. (file-name-sans-extension
  2475. (or (file-name-nondirectory buffer-file-name)))
  2476. "." "odf")
  2477. (file-name-directory buffer-file-name))))
  2478. (read-file-name "ODF filename: " nil odf-filename nil
  2479. (file-name-nondirectory odf-filename)))))
  2480. (let* ((org-lparse-backend 'odf)
  2481. org-lparse-opt-plist
  2482. (filename (or odf-file
  2483. (expand-file-name
  2484. (concat
  2485. (file-name-sans-extension
  2486. (or (file-name-nondirectory buffer-file-name)))
  2487. "." "odf")
  2488. (file-name-directory buffer-file-name))))
  2489. (buffer (find-file-noselect (org-odt-init-outfile filename)))
  2490. (coding-system-for-write 'utf-8)
  2491. (save-buffer-coding-system 'utf-8))
  2492. (set-buffer buffer)
  2493. (set-buffer-file-coding-system coding-system-for-write)
  2494. (let ((mathml (org-create-math-formula latex-frag)))
  2495. (unless mathml (error "No Math formula created"))
  2496. (insert mathml)
  2497. (or (org-export-push-to-kill-ring
  2498. (upcase (symbol-name org-lparse-backend)))
  2499. (message "Exporting... done")))
  2500. (org-odt-save-as-outfile filename nil)))
  2501. ;;;###autoload
  2502. (defun org-export-as-odf-and-open ()
  2503. "Export LaTeX fragment as OpenDocument formula and immediately open it.
  2504. Use `org-export-as-odf' to read LaTeX fragment and OpenDocument
  2505. formula file."
  2506. (interactive)
  2507. (org-lparse-and-open
  2508. nil nil nil (call-interactively 'org-export-as-odf)))
  2509. (provide 'org-odt)
  2510. ;;; org-odt.el ends here