org: Creating one-off styles

 
 12.9.11.3 Creating one-off styles
 .................................
 
 There are times when you would want one-off formatting in the exported
 document.  You can achieve this by embedding raw OpenDocument XML in the
 Org file.  The use of this feature is better illustrated with couple of
 examples.
 
   1. Embedding ODT tags as part of regular text
 
      You can inline OpenDocument syntax by enclosing it within
      ‘@@odt:...@@’ markup.  For example, to highlight a region of text
      do the following:
 
           @@odt:<text:span text:style-name="Highlight">This is a highlighted
           text</text:span>@@.  But this is a regular text.
 
      *Hint:* To see the above example in action, edit your ‘styles.xml’
      (SeeFactory styles x-orgodtstyles-xml.) and add a custom
      ‘Highlight’ style as shown below.
 
           <style:style style:name="Highlight" style:family="text">
             <style:text-properties fo:background-color="#ff0000"/>
           </style:style>
 
   2. Embedding a one-line OpenDocument XML
 
      You can add a simple OpenDocument one-liner using the ‘#+ODT:’
      directive.  For example, to force a page break do the following:
 
           #+ODT: <text:p text:style-name="PageBreak"/>
 
      *Hint:* To see the above example in action, edit your ‘styles.xml’
      (SeeFactory styles x-orgodtstyles-xml.) and add a custom
      ‘PageBreak’ style as shown below.
 
           <style:style style:name="PageBreak" style:family="paragraph"
                        style:parent-style-name="Text_20_body">
             <style:paragraph-properties fo:break-before="page"/>
           </style:style>
 
   3. Embedding a block of OpenDocument XML
 
      You can add a large block of OpenDocument XML using the
      ‘#+BEGIN_ODT’...‘#+END_ODT’ construct.
 
      For example, to create a one-off paragraph that uses bold text, do
      the following:
 
           #+BEGIN_ODT
           <text:p text:style-name="Text_20_body_20_bold">
           This paragraph is specially formatted and uses bold text.
           </text:p>
           #+END_ODT