org.eclipse.linuxtools.tracing.rcp.help/build.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <project name="org.eclipse.linuxtools.tracing.rcp.help" default="build">
   3     <description>
   4             Generate Eclipse help content for the Linux Tools Trace Viewer user guide
   5     </description>
   6
   7     <!-- Set correct values -->
   8     <property name="help.doc.url.base" value="http://wiki.eclipse.org" />
   9     <property name="ug.path"  value="Linux_Tools_Project/Trace_Viewer/User_Guide" />
  10     <property name="ug.title" value="Trace Viewer User Guide" />
  11
  12     <path id="wikitext.tasks.classpath">
  13         <!-- Search in the local Eclipse installation directory for the Wikitext plugin -->
  14         <fileset dir="${eclipse.home}/plugins" erroronmissingdir="false">
  15             <include name="org.eclipse.mylyn.wikitext.*core*.jar" />
  16         </fileset>
  17
  18         <!-- For Maven builds: use the compile_classpath -->
  19         <pathelement path="${compile_classpath}" />
  20     </path>
  21
  22     <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/internal/wikitext/mediawiki/core/tasks/tasks.properties" />
  23     <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/wikitext/core/util/anttask/tasks.properties" />
  24     <!-- Different location in more recent versions of Mylyn (Luna ?) -->
  25     <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/wikitext/core/ant/tasks.properties" />
  26
  27     <target name="build" description="Generate Eclipse help content for the Linux Tools Trace Viewer User Guide">
  28         <wikitext-to-eclipse-help markupLanguage="MediaWiki"
  29                 validate="true"
  30                 failonvalidationerror="true"
  31                 overwrite="true"
  32                 multipleOutputFiles="true"
  33                 navigationimages="true"
  34                 title="${ug.title}"
  35                 formatoutput="true"
  36                 helpPrefix="doc">
  37                 <fileset dir="./doc">
  38                    <include name="User-Guide.mediawiki" />
  39                 </fileset>
  40                 <stylesheet url="book.css" />
  41             </wikitext-to-eclipse-help>
  42           <antcall target="test" />
  43     </target>
  44
  45     <target name="test" description="Verify that all of the HTML files are well-formed XML">
  46         <!--
  47         Don't bother with DTD validation: we only care if the files are well-formed.
  48         We therefore provide an empty DTD
  49         -->
  50         <xmlvalidate lenient="true">
  51             <fileset dir="doc">
  52                 <include name="**/*.html" />
  53             </fileset>
  54             <dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location=".empty.dtd" />
  55         </xmlvalidate>
  56     </target>
  57
  58
  59     <!-- If you need a proxy for the "download" target, set it here -->
  60     <!--
  61     <setproxy proxyhost="host" proxyport="port"/>
  62     -->
  63
  64     <target name="download" description="Download the current contents of the LTTng User Guide from the Eclipse wiki">
  65         <mediawiki-to-eclipse-help wikiBaseUrl="${help.doc.url.base}" title="${ug.title}" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
  66             <path name="${ug.path}" title="${ug.title}" generateToc="false" />
  67             <stylesheet url="book.css" />
  68             <pageAppendum>
  69 = Updating This Document =
  70
  71 This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit
  72 http://wiki.eclipse.org/Linux_Tools_Project/LTTng2/User_Guide.
  73             </pageAppendum>
  74         </mediawiki-to-eclipse-help>
  75     </target>
  76
  77     <target name ="clean" description="Delete all generated files">
  78       <delete failonerror="false" includeemptydirs="true">
  79         <!-- Files under doc/ (generated locally) -->
  80         <fileset dir="doc" includes="**/*.html" />
  81         <fileset dir="doc" includes="**/*.xml" />
  82
  83         <!-- Files downloaded from the Eclipse wiki -->
  84         <fileset dir="Linux_Tools_Project" />
  85         <fileset file="toc.xml" />
  86       </delete>
  87     </target>
  88
  89 </project>