Inicio Explorar Axuda
Iniciar sesión
bn
/
se
2
0
Fork 0
Ficheiros Incidencias 0 Pull Requests 0 Wiki
Árbore: 0b6fc7fd2b
Ramas Etiquetas
se
/
SE
/
stuff
/
dita-ot-2.3.3
/
doc
/
user-guide
/
pdf2-creating-change-bars.html

pdf2-creating-change-bars.html 7.1 KB
Histórico Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2016"><meta name="DC.rights.owner" content="(C) Copyright 2016"><meta name="DC.Type" content="concept"><meta name="description" content="If you use Antenna House Formatter or RenderX XEP, you can generate revision bars in your PDF output by using the changebar attribute of the DITAVAL revprop element."><meta name="DC.Relation" scheme="URI" content="../user-guide/dita2pdf.html"><meta name="DC.Format" content="XHTML"><meta name="DC.Identifier" content="concept_gsc_vcf_vs"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Generating revision bars</title></head><body id="concept_gsc_vcf_vs"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 2.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../getting-started/index.html">Getting Started</a></li><li><a href="../user-guide/index.html">User Guide</a><ul><li><a href="../user-guide/transforming-dita-content.html">Publishing DITA content</a></li><li><a href="../user-guide/AvailableTransforms.html">Output formats</a><ul><li><a href="../user-guide/dita2docbook.html">DITA to DocBook</a></li><li><a href="../user-guide/dita2eclipsecontent.html">DITA to Eclipse Content</a></li><li><a href="../user-guide/dita2eclipsehelp.html">DITA to Eclipse help</a></li><li><a href="../user-guide/dita2html5.html">DITA to HTML5</a></li><li><a href="../user-guide/dita2htmlhelp.html">DITA to HTML Help (CHM)</a></li><li><a href="../user-guide/dita2javahelp.html">DITA to Java Help</a></li><li><a href="../user-guide/dita2odt.html">DITA to ODT</a></li><li><a href="../user-guide/dita2pdf.html">DITA to PDF (PDF2)</a><ul><li class="active"><a href="../user-guide/pdf2-creating-change-bars.html">Generating revision bars</a></li></ul></li><li><a href="../user-guide/dita2wordrtf.html">DITA to RTF</a></li><li><a href="../user-guide/dita2tocjs.html">DITA to TocJS</a></li><li><a href="../user-guide/dita2troff.html">DITA to troff</a></li><li><a href="../user-guide/dita2xhtml.html">DITA to XHTML</a></li></ul></li><li><a href="../user-guide/DITA_spec-support.html">DITA specification support</a></li><li><a href="../user-guide/DITA-globalization.html">Globalizing DITA content</a></li><li><a href="../user-guide/troubleshooting-overview.html">Troubleshooting</a></li></ul></li><li><a href="../parameters/index.html">Parameter Reference</a></li><li><a href="../dev_ref/index.html">Developer Reference</a></li><li><a href="../user-guide/dita-and-dita-ot-resources.html">DITA Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Generating revision bars</h1>
    8. 

  8.   
    9. 

  9.   <div class="body conbody"><p class="shortdesc">If you use Antenna House Formatter or RenderX XEP, you can generate revision bars in your PDF output by
    10. 

  10.     using the <code class="keyword markupname xmlatt">@changebar</code> attribute of the DITAVAL <code class="keyword markupname xmlelement">&lt;revprop&gt;</code> element. </p>
    11. 

  11.     <div class="note note note_note"><span class="note__title notetitle">Note:</span> FOP 1.1 does not support the XSL <code class="ph codeph">fo:change-bar</code> formatting object.</div>
    12. 

  12.     <div class="p">The DITA specification for <code class="keyword markupname xmlatt">@changebar</code> simply says:<blockquote class="lq">
    13. 

  13.         <dl class="dl">
    14. 

  14.           
    15. 

  15.             <dt class="dt dlterm"><code class="keyword markupname xmlatt">@changebar</code></dt>
    16. 

  16.             <dd class="dd">When flag has been set, specify a changebar color, style, or character, according to the changebar
    17. 

  17.               support of the target output format. If flag has not been set, this attribute is ignored.</dd>
    18. 

  18.           
    19. 

  19.         </dl>
    20. 

  20.       </blockquote></div>
    21. 

  21.     <p class="p">The syntax for <code class="keyword markupname xmlatt">@changebar</code> is a sequence of name and value pairs that are delimited by semicolons,
    22. 

  22.       for example:</p>
    23. 

  23.     <pre class="pre codeblock"><code>&lt;revprop action="flag" val="rev01"
    24. 

  24.  <strong class="ph b">changebar="color:black;style:solid;width:0.5pt"</strong>
    25. 

  25. /&gt;</code></pre>
    26. 

  26.     <p class="p">To produce a revision bar, you must specify a value for <span class="keyword parmname">style</span> and should specify a value for
    27. 

  27.         <span class="keyword parmname">width</span> so you get a visible rule.</p>
    28. 

  28.     <p class="p">Each name and value pair corresponds to an attribute of the <a class="xref" href="http://www.w3.org/TR/xsl/#fo_change-bar-begin" target="_blank">XSL-FO fo:change-bar-begin element</a>. The
    29. 

  29.       following attributes and values are available:</p>
    30. 

  30.     <dl class="dl parml">
    31. 

  31.       
    32. 

  32.         <dt class="dt pt dlterm">style</dt>
    33. 

  33.         <dd class="dd pd">The style to use for the line, as for other XSL-FO rules (<a class="xref" href="http://www.w3.org/TR/xsl/#change-bar-style" target="_blank">@change-bar-style</a>). The
    34. 

  34.           value <span class="keyword option">solid</span> produces a solid rule; the default value is <span class="keyword option">none</span>.</dd>
    35. 

  35.       
    36. 

  36.       
    37. 

  37.         <dt class="dt pt dlterm">color</dt>
    38. 

  38.         <dd class="dd pd">Any color value recognized by XSL-FO, including the usual color names or a hex color value. The default
    39. 

  39.           value is <span class="keyword option">black</span>.</dd>
    40. 

  40.       
    41. 

  41.       
    42. 

  42.         <dt class="dt pt dlterm">offset</dt>
    43. 

  43.         <dd class="dd pd">The space to offset the revision bar from the edge of the text column. You can use points (pt) or
    44. 

  44.           millimeters (mm).</dd>
    45. 

  45.       
    46. 

  46.       
    47. 

  47.         <dt class="dt pt dlterm">placement</dt>
    48. 

  48.         <dd class="dd pd">The side of the text column on which to place the revision bar. The allowed values are
    49. 

  49.             <span class="keyword option">start</span> (left side for left-to-right languages) and <span class="keyword option">end</span> (right side for
    50. 

  50.           left-to-right languages). The default value is <span class="keyword option">start</span>.</dd>
    51. 

  51.       
    52. 

  52.       
    53. 

  53.         <dt class="dt pt dlterm">width</dt>
    54. 

  54.         <dd class="dd pd">The width of the rule as a measurement value. Typical values are <span class="keyword option">1pt</span> and
    55. 

  55.             <span class="keyword option">0.5pt</span>, which renders a hairline rule.</dd>
    56. 

  56.       
    57. 

  57.     </dl>
    58. 

  58.     
    59. 

  59.     <p class="p">XSL-FO 1.1 does not provide for revision bars that are not rules, so there is no way to get text revision
    60. 

  60.       indicators instead of rules, for example, using a number in place of a rule. Antenna House Formatter provides a
    61. 

  61.       proprietary extension to enable this, but the DITA-OT PDF transformation does not take advantage of it.</p>
    62. 

  62.   </div>
    63. 

  63. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../user-guide/dita2pdf.html" title="The pdf (or pdf2) transformation generates PDF output.">DITA to PDF (PDF2)</a></div></div></nav></article></main></body></html>
    64.