Sébastien Gendre <[email protected]> writes: > Attached to this e-mail, you can find my patch that add, in the HTML > export backend, missing options-alist keywords and `#+OPTIONS`. I added > them when it's possible. Also, for options with a keyword, I defined the > behavior for when their keyword is set multiple times in an Org-mode > buffer.
Thanks! Note that the patch is exceeding the maximum contribution size we can accept without copyright assignment. Would you consider it? See https://orgmode.org/worg/org-contribute.html#copyright > * doc/org-manual.org (HTML preamble and postamble, Links in HTML > export, Tables in HTML export, Images in HTML export, Math formatting > in HTML export, CSS support): Only update to manual sections where the > modified options are already described *described. > In the HTML backend, some options defined in the options-alist have no > keyword or `#+OPTIONS:` defined. I changed that. For options with Double space between sentences :) > +In an org-mode buffer, you can set the preamble value with the option > +~html-preamble~. Use it preferably to set values like ~t~, ~nil~, ~auto~ or > +even a function. To set your preamble as a string, use the keyword I do not think that you can make it a function. > +~#+HTML_PREAMBLE~. You can use it multiple times to set a multi-lines > +string. *multi-line string. > +name, and date. And as for preamble, postamble value can be set in *, as for preamble, > :PROPERTIES: > :DESCRIPTION: How to modify the formatting of tables. > +:ID: d2a6f5c3-0c65-4898-9515-828aaec7ef85 > :END: Please get rid of these stray IDs. > + field. Can also bet set with buffer option > + ~html-table-align-individual-fields~. > + : #+options: html-table-align-individual-fields:t *bet -> be "buffer option" reads weird. Maybe just say "Can also be set as : #+options: ..." Same in other cases. > +=[[file:myimg.jpg]]= is in-lined, while =[[file:myimg.jpg][the image]]= > +links to the text, =the image=. You can set the variable > +~org-html-inline-images~ to ~nil~ to have no in-lines images and only *in-lined > +~#+HTML_MATHJAX_TEMPLATE~. This keyword can be set multiple time in *times > +the buffer, to set a multi-lines template. *multi-line template > :DESCRIPTION: Changing the appearance of the output. > +:ID: 242c9f6f-2d02-4d3d-82e9-60ceb8dfaf11 > :END: Stray ID. > -*** ox-html: Headline self links can be enabled from an Org-mode file > - > -Previously HTML export could add, to each headline, a link to itself. > -To enable it, you had to use the variable > -~org-html-self-link-headlines~. > - > -Now, it's also possible to enable it per Org-mode file by adding: You accidentally removed this record. > +To know which value you can use, you can found them on the manual or, if > +not, in the default variable value. What do you mean here? > +Some export options, that can be set with a keyword, now accept to > +have its keyword set multiple times in the same org-mode file. If > +it's the case, each values are concatenate and separated with a > +newline. *the values are concatenated and... > + ;; Due to a bug, :html-extension option cannot be set in buffer > (:html-extension nil nil org-html-extension) Please link to the orgmode.org/list/... discussion for reference. > ;; Redefine regular options. > - (:creator "CREATOR" nil org-html-creator-string) > + (:creator "CREATOR" nil org-html-creator-string newline) This is a global option applicable to other backends. ox-html modifies it to use different default value, but otherwise ought to keep the same behavior. If you want to change :creator in ox-html, please also do in ox.html. -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
