logging-log4j-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Yuji Kumasaka <kumas...@mms.intec.co.jp>
Subject [PATCH] ant task for manual create
Date Wed, 17 Oct 2001 08:19:44 GMT

Hi, 

Now, log4j manual is depend on jade tool.

So, I try to crate ANT task for process DocBook 
for platform independ.

Does anyone review this procedure ?


-------------------------------------

1. Download ant 1.4.1

2. Download log4j 1.2 alpha2

3. Download docbook-xsl
   for XML -> HTML translation.

   http://docbook.sourceforge.net/projects/xsl/
   Note: docbook-xsl-1.45.tar.gz is OK.
         docbook-xsl-1.46-exp is not work.

4. Download DTD DocBook XML Version 4.1.2

   http://www.oasis-open.org/xml/4.1.2/


5. expand log4j_1.2_alpha

   and change directory to ./src/docbook


6. expand DTD and Stylesheets expand.
  at the following directory.

./src/docbook/
./src/docbook/docbkx412          <- DTD DocBook XML
./src/docbook/docbook-xsl-1.45   <- DocBook Stylesheets


7. change xml source

   following source are error detected at DTD parsing.

    - manual.xml
    - intro.xml
    - defaultInit.xml
    - architecture.xml



$ diff -u ../docbook.org/manual.xml manual.xml
--- ../docbook.org/manual.xml   Wed Oct 17 06:43:34 2001
+++ manual.xml  Wed Oct 17 16:39:27 2001
@@ -1,5 +1,5 @@
 <?xml version='1.0'?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" [
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "docbkx412/docbook
x.dtd" [
 <!ENTITY intro SYSTEM "intro.xml">
 <!ENTITY architecture SYSTEM "architecture.xml">
 <!ENTITY conf SYSTEM "configuration.xml">
@@ -33,15 +33,15 @@
     </abstract>
   </bookinfo>

-  &intro
-  &architecture
-  &conf
-  &defaultInit
-  &wider
-  &changes
-  &faq
-  &trouble
-  &glo
+  &intro;
+  &architecture;
+  &conf;
+  &defaultInit;
+  &wider;
+  &changes;
+  &faq;
+  &trouble;
+  &glo;

 </book>



$ diff -u ../docbook.org/intro.xml intro.xml
--- ../docbook.org/intro.xml    Wed Oct 17 06:43:26 2001
+++ intro.xml   Wed Oct 17 16:43:02 2001
@@ -68,7 +68,7 @@
     simple to understand and to use.
   </para>

-  <!-- Section ----------------------------------------------------- -->
+  <!-- Section ===================================================== -->

   <sect1>
     <title>Copyright</title>
@@ -102,7 +102,7 @@
     </para>
   </sect1>

-  <!-- Section ----------------------------------------------------- -->
+  <!-- Section ===================================================== -->
   <sect1>
     <title>Installing</title>

@@ -123,7 +123,7 @@

   </sect1>

-  <!-- Section ----------------------------------------------------- -->
+  <!-- Section ===================================================== -->

   <sect1>
     <title>First baby step</title>

$ diff -u ../docbook.org/defaultInit.xml defaultInit.xml
--- ../docbook.org/defaultInit.xml      Wed Oct 17 06:43:34 2001
+++ defaultInit.xml     Wed Oct 17 16:46:34 2001
@@ -104,7 +104,7 @@
     <para>The Java Servlet technology is the cornerstome of many
     server-side applications. For those unfamiliar with Servlets I
     highly recommend Jason Hunter's book entitled "Java Servlet
-    Programming" from O'Reilly & Associates.</para>
+    Programming" from O'Reilly &amp; Associates.</para>

     <para>Although not explicitly stated in the <ulink
        url="http://www.jcp.org/jsr/detail/53.jsp">Java Servlet 2.3 and


$ diff -u ../docbook.org/architecture.xml architecture.xml
--- ../docbook.org/architecture.xml     Wed Oct 17 06:43:33 2001
+++ architecture.xml    Wed Oct 17 16:49:24 2001
@@ -106,7 +106,7 @@

        public <emphasis role="strong">Logger</emphasis> class {

-         // Creation & retrieval methods:
+         // Creation &amp; retrieval methods:
          public static Logger getRootLogger();
          public static Logger getLogger(String name);

@@ -436,7 +436,7 @@
     selection rule.</para>
     </sect2>

-    <!-- ----------------------------------------------------------------- -->
+    <!-- ================================================================= -->

     <sect2 id="repositoryThreshold" xreflabel="Respository-wide Threshold">
       <title>Respository-wide Threshold</title>
@@ -913,7 +913,7 @@
     </procedure>
   </sect1>

-  <!-- -------------------------------- Performance -------------------------------- -->
+  <!-- ================================ Performance ================================ -->

   <sect1 id="performance">
     <title>Performance</title>




8. create build.xml

build.xml

<project name="log4j-docs" default="build-main" basedir=".">

  <!-- ===================== Initialize Property Values =================== -->

  <property name="doc.build"   value="./build"/>
  <property name="doc.name"    value="manual"/>

  <!-- ================= BUILD: XML-HTML Generation ======================= -->
  <target name="build-main">

    <!-- Top Level Directory -->
    <style basedir="."
           destdir="${doc.build}/${doc.name}"
         extension=".html"
             style="docbook-xsl-1.45/html/docbook.xsl"
          excludes="build.xml"
          includes="manual.xml">
    </style>

  </target>

</project>


9. run ant task

$ ant
Buildfile: build.xml

build-main:
    [style] Transforming into E:\jakarta-log4j-1.2alpha2\src\docbook\build\manual
    [style] Transforming into E:\jakarta-log4j-1.2alpha2\src\docbook\build\manual
    [style] Loading stylesheet E:\jakarta-log4j-1.2alpha2\src\docbook\docbook-xsl-1.45\html\docbook.xsl

BUILD SUCCESSFUL

Total time: 38 seconds


10. complete.

  manual.html create at ./src/docbook/build/manual directory.

------------------------------

Thanks,
-- 
Yuji Kumasaka <kumasaka@mms.intec.co.jp>


---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: log4j-dev-help@jakarta.apache.org


Mime
View raw message