Raible's Wiki: DocBook

-       Raible's Wiki




    Raible Designs

Wiki Home

News

Recent Changes

AppFuse
Homepage

  -  Korean

  -  Chinese

  -  Italian

  -  Japanese

QuickStart Guide

  - Chinese
 
  - French

  - German

  - Italian

  - Korean

  - Portuguese

  - Spanish

  - Japanese


User Guide

  - Korean

  - Chinese
 

Tutorials

  -  Chinese

  -  German

  -  Italian

  -  Korean

  -  Portuguese

  -  Spanish


FAQ

  -  Korean


Latest Downloads

Other Applications
Struts Resume

Security Example

Struts Menu



    




    

    
         
        Set your name in

        UserPreferences
            
    





       
       
       
       




    

Referenced by

StrutsResumeSupport



    




   



   
   JSPWiki v2.2.33 
   



       
           

           

           
           
           


           Hide Menu
+            DocBook
            



  
    Search Wiki:
    
    
  



         
         
            Your trail: 
         
      

      


      

      
         



      
          Difference between 
          version 9 
          and 
          version 2:
          

          
At line 1 changed 1 line.
!!__2003.10.30__ - Thank you number 2 for the Doclet King
!!__2003.10.30__ - PDF reference handbook for your java source documentation
At line 31 changed 2 lines.
      <doclet name="com.mf.doclet.docbook.DocBookDoclet"
            path="${dbdoclet.dir}/doclet/lib/dbdoclet.jar">
      <doclet name="org.dbdoclet.doclet.docbook.DocBookDoclet"
            path="${dbdoclet.dir}/jars/dbdoclet.jar">
At line 35 added 11 lines.
      <tag name="jsp.tag"               description="JSP Tag:" />
      <tag name="jsp.attribute"         description="JSP Attribute:" />
      <tag name="struts.action"         description="Mapping:" />
      <tag name="struts.action-forward" description="ActionForward:" />
      <tag name="struts.form"           description="Form Name:" />
      <tag name="struts.validator"      description="Validator:" />
      <tag name="struts.validator-args" description="Validator Args:" />
      <tag name="struts.validator-var"  description="Validator Var:" />
      <tag name="web.listener"          description="Listener:" />
      <tag name="x.generated"           description="Generated:" />
      <tag name="x.copyright"           description="Copyright:" />
At line 60 removed 1 line.

At line 73 added 11 lines.
Here's how to set {{dbdoclet.xincluder.classpath}}
{{{
  <path id="dbdoclet.xincluder.classpath">
    <fileset dir="${dbdoclet.dir}/jars">
      <include name="resolver.jar"/>
      <include name="xincluder.jar"/>
    </fileset>
    <fileset file="${catalina.home}/common/endorsed/xercesImpl.jar"/>
  </path>
}}}
----
At line 74 changed 1 line.
  <xsl:import href="file:@DBDOCLET_HOME@/tidbit/docbook/xsl/fo/docbook.xsl"/>
  <xsl:import href="file:@DBDOCLET-HOME@/docbook/xsl/fo/docbook.xsl"/>
At line 76 changed 1 line.
  <xsl:param name="insert.xref.page.number">yes</xsl:param>
  <xsl:param name="body.font.master">10</xsl:param>
  <xsl:param name="insert.xref.page.number">1</xsl:param>
At line 82 changed 2 lines.
  <xsl:param name="admon.graphics.path">@DBDOCLET_HOME@/tidbit/docbook/xsl/image
s/</xsl:param>
  <xsl:param name="admon.graphics.path">@DBDOCLET-HOME@/docbook/xsl/images/</xsl:param>
At line 109 added 2 lines.
  <xsl:param name="shade.verbatim">1</xsl:param>
  <xsl:param name="make.index.markup">1</xsl:param>
At line 112 added 91 lines.
  <xsl:attribute-set name="book.titlepage.recto.style">
    <xsl:attribute name="color">#2f2f2f</xsl:attribute>
  </xsl:attribute-set>

  <xsl:attribute-set name="section.title.properties">
    <xsl:attribute name="font-size">
      <xsl:value-of select="$body.font.master * 1.2"/>
      <xsl:text>pt</xsl:text>
    </xsl:attribute>  
  </xsl:attribute-set>

  <xsl:attribute-set name="section.title.level1.properties">
    <xsl:attribute name="border-after-style">solid</xsl:attribute>
    <xsl:attribute name="border-after-width">.1mm</xsl:attribute>
    <xsl:attribute name="font-size">
      <xsl:value-of select="$body.font.master * 1.6"/>
      <xsl:text>pt</xsl:text>
    </xsl:attribute>  
  </xsl:attribute-set> 

  <xsl:attribute-set name="section.title.level2.properties">
    <xsl:attribute name="border-style">solid</xsl:attribute>
    <xsl:attribute name="border-width">.1mm</xsl:attribute>
    <xsl:attribute name="background-color">#cecfff</xsl:attribute>
    <xsl:attribute name="padding">0.3em</xsl:attribute>
    <xsl:attribute name="start-indent">0pc</xsl:attribute>
    <xsl:attribute name="end-indent">0pc</xsl:attribute>
    <xsl:attribute name="font-style">italic</xsl:attribute>
    <xsl:attribute name="font-weight">normal</xsl:attribute>
    <xsl:attribute name="font-size">
      <xsl:value-of select="$body.font.master * 1.4"/>
      <xsl:text>pt</xsl:text>
    </xsl:attribute>  
  </xsl:attribute-set> 

  <xsl:attribute-set name="section.title.level3.properties">
    <xsl:attribute name="border-after-style">solid</xsl:attribute>
    <xsl:attribute name="border-after-width">.1mm</xsl:attribute>
    <xsl:attribute name="font-weight">normal</xsl:attribute>
    <xsl:attribute name="font-style">italic</xsl:attribute>
    <xsl:attribute name="font-size">
      <xsl:value-of select="$body.font.master * 1.2"/>
      <xsl:text>pt</xsl:text>
    </xsl:attribute>  
  </xsl:attribute-set> 

  <xsl:attribute-set name="formal.title.properties">
    <xsl:attribute name="font-size">
      <xsl:value-of select="$body.font.master * 1.0"/>
      <xsl:text>pt</xsl:text>
    </xsl:attribute>
    <xsl:attribute name="space-after.minimum">0.0em</xsl:attribute>
    <xsl:attribute name="space-after.optimum">0.4em</xsl:attribute>
    <xsl:attribute name="space-after.maximum">0.4em</xsl:attribute>
    <!--
    <xsl:attribute name="border-style">solid</xsl:attribute>
    <xsl:attribute name="border-width">.1mm</xsl:attribute>
    -->
  </xsl:attribute-set> 

  <xsl:attribute-set name="list.block.spacing">
    <xsl:attribute name="space-before.minimum">0em</xsl:attribute>
    <xsl:attribute name="space-before.optimum">0em</xsl:attribute>
    <xsl:attribute name="space-before.maximum">0em</xsl:attribute>

    <xsl:attribute name="space-after.minimum">0.0em</xsl:attribute>
    <xsl:attribute name="space-after.optimum">0.7em</xsl:attribute>
    <xsl:attribute name="space-after.maximum">0.7em</xsl:attribute>
    <!--
    <xsl:attribute name="border-style">solid</xsl:attribute>
    <xsl:attribute name="border-width">.1mm</xsl:attribute>
    -->
  </xsl:attribute-set> 

  <xsl:attribute-set name="list.item.spacing">
    <xsl:attribute name="space-before.minimum">0.0em</xsl:attribute>
    <xsl:attribute name="space-before.optimum">0.3em</xsl:attribute>
    <xsl:attribute name="space-before.maximum">0.3em</xsl:attribute>

    <xsl:attribute name="space-after.minimum">0em</xsl:attribute>
    <xsl:attribute name="space-after.optimum">0.2em</xsl:attribute>
    <xsl:attribute name="space-after.maximum">0.2em</xsl:attribute>
    <!--
    <xsl:attribute name="border-style">solid</xsl:attribute>
    <xsl:attribute name="border-width">.1mm</xsl:attribute>
    -->
  </xsl:attribute-set> 

  <xsl:template match="processing-instruction('line-break')">
    <fo:block/>
  </xsl:template>
At line 161 changed 2 lines.
Another yummy feature is [class diagrams|http://www.dbdoclet.org/projects/dbdoclet/en/uml.html] in PNG (or other) format. That's why you need the [graphviz package from AT&T|http://www.research.att.com/sw/tools/graphviz/]. A sample class diagram follows:
\\[StrutsResume|ClassDiagram.png]
Another yummy feature is [class diagrams|http://www.dbdoclet.org/projects/dbdoclet/en/uml.html] (which show inheritence path and all implemented interfaces) in PNG (or other) format. That's why you need the [graphviz package from AT&T|http://www.research.att.com/sw/tools/graphviz/]. A sample class diagram follows:
\\[StrutsResume/ClassDiagram.png]
At line 164 changed 1 line.
I am currently trying to modify the sources for dbdoclet to add the capability of handling custom tags. Right now xdocle-related custom tags just disappear into thin air. I have a working prototype but will wait to hear from the upstream author before making it available.
I am currently trying to modify the sources for dbdoclet to add the capability of handling custom tags. Right now xdoclet-related custom tags just disappear into thin air. I have a working prototype but will wait to hear from the upstream author before making it available.
At line 280 added 2 lines.
;:''This has been implemented in the latest dbdoclet version.''

At line 287 added 7 lines.

;:''This looks great, although I don't have time to implement it right now.  I am looking for an easy way to generate UML diagrams from my existing class structure though.  Know of any tools?  ~ [MattRaible]''

For reverse-engineering of your existing .java files [ESS-Model|http://essmodel.sourceforge.net/] seems to work great for me. You give it your source tree and you get UML diagrams as the output. Sorry, Windows binaries only. Source is available in Delphi 6, if anyone cares.

Here's a sample:
\\[p_xmi_209.png]


          

      

      

      
      Back to DocBook,
       or to the Page History.
       

      

      

      

      

      

      

      

      Show Menu
-DocBook
+    Search Wiki:
 At line 1 changed 1 line.
-!!__2003.10.30__ - Thank you number 2 for the Doclet King
+!!__2003.10.30__ - PDF reference handbook for your java source documentation
 At line 31 changed 2 lines.
-      <doclet name="com.mf.doclet.docbook.DocBookDoclet"
-            path="${dbdoclet.dir}/doclet/lib/dbdoclet.jar">
+      <doclet name="org.dbdoclet.doclet.docbook.DocBookDoclet"
+            path="${dbdoclet.dir}/jars/dbdoclet.jar">
 At line 35 added 11 lines.
+      <tag name="jsp.tag"               description="JSP Tag:" />
+      <tag name="jsp.attribute"         description="JSP Attribute:" />
+      <tag name="struts.action"         description="Mapping:" />
+      <tag name="struts.action-forward" description="ActionForward:" />
+      <tag name="struts.form"           description="Form Name:" />
+      <tag name="struts.validator"      description="Validator:" />
+      <tag name="struts.validator-args" description="Validator Args:" />
+      <tag name="struts.validator-var"  description="Validator Var:" />
+      <tag name="web.listener"          description="Listener:" />
+      <tag name="x.generated"           description="Generated:" />
+      <tag name="x.copyright"           description="Copyright:" />
 At line 60 removed 1 line.
 At line 73 added 11 lines.
+Here's how to set {{dbdoclet.xincluder.classpath}}
+{{{
+  <path id="dbdoclet.xincluder.classpath">
+    <fileset dir="${dbdoclet.dir}/jars">
+      <include name="resolver.jar"/>
+      <include name="xincluder.jar"/>
+    </fileset>
+    <fileset file="${catalina.home}/common/endorsed/xercesImpl.jar"/>
+  </path>
+}}}
+----
 At line 74 changed 1 line.
-  <xsl:import href="file:@DBDOCLET_HOME@/tidbit/docbook/xsl/fo/docbook.xsl"/>
+  <xsl:import href="file:@DBDOCLET-HOME@/docbook/xsl/fo/docbook.xsl"/>
 At line 76 changed 1 line.
-  <xsl:param name="insert.xref.page.number">yes</xsl:param>
+  <xsl:param name="body.font.master">10</xsl:param>
+  <xsl:param name="insert.xref.page.number">1</xsl:param>
 At line 82 changed 2 lines.
-  <xsl:param name="admon.graphics.path">@DBDOCLET_HOME@/tidbit/docbook/xsl/image
-s/</xsl:param>
+  <xsl:param name="admon.graphics.path">@DBDOCLET-HOME@/docbook/xsl/images/</xsl:param>
 At line 109 added 2 lines.
+  <xsl:param name="shade.verbatim">1</xsl:param>
+  <xsl:param name="make.index.markup">1</xsl:param>
 At line 112 added 91 lines.
+  <xsl:attribute-set name="book.titlepage.recto.style">
+    <xsl:attribute name="color">#2f2f2f</xsl:attribute>
+  </xsl:attribute-set>
+  <xsl:attribute-set name="section.title.properties">
+    <xsl:attribute name="font-size">
+      <xsl:value-of select="$body.font.master * 1.2"/>
+      <xsl:text>pt</xsl:text>
+    </xsl:attribute>
+  </xsl:attribute-set>
+  <xsl:attribute-set name="section.title.level1.properties">
+    <xsl:attribute name="border-after-style">solid</xsl:attribute>
+    <xsl:attribute name="border-after-width">.1mm</xsl:attribute>
+    <xsl:attribute name="font-size">
+      <xsl:value-of select="$body.font.master * 1.6"/>
+      <xsl:text>pt</xsl:text>
+    </xsl:attribute>
+  </xsl:attribute-set>
+  <xsl:attribute-set name="section.title.level2.properties">
+    <xsl:attribute name="border-style">solid</xsl:attribute>
+    <xsl:attribute name="border-width">.1mm</xsl:attribute>
+    <xsl:attribute name="background-color">#cecfff</xsl:attribute>
+    <xsl:attribute name="padding">0.3em</xsl:attribute>
+    <xsl:attribute name="start-indent">0pc</xsl:attribute>
+    <xsl:attribute name="end-indent">0pc</xsl:attribute>
+    <xsl:attribute name="font-style">italic</xsl:attribute>
+    <xsl:attribute name="font-weight">normal</xsl:attribute>
+    <xsl:attribute name="font-size">
+      <xsl:value-of select="$body.font.master * 1.4"/>
+      <xsl:text>pt</xsl:text>
+    </xsl:attribute>
+  </xsl:attribute-set>
+  <xsl:attribute-set name="section.title.level3.properties">
+    <xsl:attribute name="border-after-style">solid</xsl:attribute>
+    <xsl:attribute name="border-after-width">.1mm</xsl:attribute>
+    <xsl:attribute name="font-weight">normal</xsl:attribute>
+    <xsl:attribute name="font-style">italic</xsl:attribute>
+    <xsl:attribute name="font-size">
+      <xsl:value-of select="$body.font.master * 1.2"/>
+      <xsl:text>pt</xsl:text>
+    </xsl:attribute>
+  </xsl:attribute-set>
+  <xsl:attribute-set name="formal.title.properties">
+    <xsl:attribute name="font-size">
+      <xsl:value-of select="$body.font.master * 1.0"/>
+      <xsl:text>pt</xsl:text>
+    </xsl:attribute>
+    <xsl:attribute name="space-after.minimum">0.0em</xsl:attribute>
+    <xsl:attribute name="space-after.optimum">0.4em</xsl:attribute>
+    <xsl:attribute name="space-after.maximum">0.4em</xsl:attribute>
+    <!--
+    <xsl:attribute name="border-style">solid</xsl:attribute>
+    <xsl:attribute name="border-width">.1mm</xsl:attribute>
+    -->
+  </xsl:attribute-set>
+  <xsl:attribute-set name="list.block.spacing">
+    <xsl:attribute name="space-before.minimum">0em</xsl:attribute>
+    <xsl:attribute name="space-before.optimum">0em</xsl:attribute>
+    <xsl:attribute name="space-before.maximum">0em</xsl:attribute>
+    <xsl:attribute name="space-after.minimum">0.0em</xsl:attribute>
+    <xsl:attribute name="space-after.optimum">0.7em</xsl:attribute>
+    <xsl:attribute name="space-after.maximum">0.7em</xsl:attribute>
+    <!--
+    <xsl:attribute name="border-style">solid</xsl:attribute>
+    <xsl:attribute name="border-width">.1mm</xsl:attribute>
+    -->
+  </xsl:attribute-set>
+  <xsl:attribute-set name="list.item.spacing">
+    <xsl:attribute name="space-before.minimum">0.0em</xsl:attribute>
+    <xsl:attribute name="space-before.optimum">0.3em</xsl:attribute>
+    <xsl:attribute name="space-before.maximum">0.3em</xsl:attribute>
+    <xsl:attribute name="space-after.minimum">0em</xsl:attribute>
+    <xsl:attribute name="space-after.optimum">0.2em</xsl:attribute>
+    <xsl:attribute name="space-after.maximum">0.2em</xsl:attribute>
+    <!--
+    <xsl:attribute name="border-style">solid</xsl:attribute>
+    <xsl:attribute name="border-width">.1mm</xsl:attribute>
+    -->
+  </xsl:attribute-set>
+  <xsl:template match="processing-instruction('line-break')">
+    <fo:block/>
+  </xsl:template>
 At line 161 changed 2 lines.
-Another yummy feature is [class diagrams|http://www.dbdoclet.org/projects/dbdoclet/en/uml.html] in PNG (or other) format. That's why you need the [graphviz package from AT&T|http://www.research.att.com/sw/tools/graphviz/]. A sample class diagram follows:
-\\[StrutsResume|ClassDiagram.png]
+Another yummy feature is [class diagrams|http://www.dbdoclet.org/projects/dbdoclet/en/uml.html] (which show inheritence path and all implemented interfaces) in PNG (or other) format. That's why you need the [graphviz package from AT&T|http://www.research.att.com/sw/tools/graphviz/]. A sample class diagram follows:
+\\[StrutsResume/ClassDiagram.png]
 At line 164 changed 1 line.
-I am currently trying to modify the sources for dbdoclet to add the capability of handling custom tags. Right now xdocle-related custom tags just disappear into thin air. I have a working prototype but will wait to hear from the upstream author before making it available.
+I am currently trying to modify the sources for dbdoclet to add the capability of handling custom tags. Right now xdoclet-related custom tags just disappear into thin air. I have a working prototype but will wait to hear from the upstream author before making it available.
 At line 280 added 2 lines.
+;:''This has been implemented in the latest dbdoclet version.''
 At line 287 added 7 lines.
+;:''This looks great, although I don't have time to implement it right now.  I am looking for an easy way to generate UML diagrams from my existing class structure though.  Know of any tools?  ~ [MattRaible]''
+For reverse-engineering of your existing .java files [ESS-Model|http://essmodel.sourceforge.net/] seems to work great for me. You give it your source tree and you get UML diagrams as the output. Sorry, Windows binaries only. Source is available in Delphi 6, if anyone cares.
+Here's a sample:
+\\[p_xmi_209.png]