← Back to branch summary

~ubuntu-branches/ubuntu/trusty/eclipse-linuxtools/trusty

« back to all changes in this revision

Viewing changes to libhover/org.eclipse.linuxtools.cdt.libhover.library.docs/build-helper.xml

  • Committer: Package Import Robot
  • Author(s): Jakub Adam
  • Date: 2012-06-29 12:07:30 UTC
  • Revision ID: package-import@ubuntu.com-20120629120730-bfri1xys1i71dpn6
Tags: upstream-1.0.0
Import upstream version 1.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
libhover/org.eclipse.linuxtools.cdt.libhover.library.docs/build-helper.xml
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<project name="org.eclipse.linuxtools.cdt.libhover.library-docs" default="all">
 
3
        <description>
 
4
            Generate Eclipse help content for the Linux Tools Libhover Developers guide
 
5
    </description>
 
6
 
 
7
        <property name="help.doc.url.base" value="http://wiki.eclipse.org" />
 
8
 
 
9
        <path id="tasks.classpath" path="bin" />
 
10
        <path id="wikitext.tasks.classpath">
 
11
                <!-- Replace dir with the dir you have wikitext installed into.-->
 
12
                <fileset dir="/notnfs/jjohnstn/helios/eclipse/plugins">
 
13
                        <include name="org.eclipse.mylyn.wikitext.*core*.jar" />
 
14
                </fileset>
 
15
        </path>
 
16
 
 
17
        <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/internal/wikitext/mediawiki/core/tasks/tasks.properties" />
 
18
        <taskdef classpathref="wikitext.tasks.classpath" resource="org/eclipse/mylyn/wikitext/core/util/anttask/tasks.properties" />
 
19
 
 
20
        <target name="all" description="Generate Eclipse help content for the Linux Tools changelog user guide">
 
21
                <mediawiki-to-eclipse-help wikiBaseUrl="${help.doc.url.base}" title="Libhover Developer's Guide" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
 
22
 
 
23
                        <path name="Linux_Tools_Project/Libhover/Developers_Guide" title="Libhover Developer's Guide" generateToc="false" />
 
24
                        <stylesheet url="book.css" />
 
25
                        <pageAppendum>
 
26
        = Updating This Document =
 
27
 
 
28
        This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit 
 
29
        http://wiki.eclipse.org/Linux_Tools_Project/Libhover/Developers_Guide .
 
30
                                                 </pageAppendum>
 
31
                </mediawiki-to-eclipse-help>
 
32
                <antcall target="test" />
 
33
        </target>
 
34
 
 
35
        <target name="test" description="verify that all of the HTML files are well-formed XML">
 
36
                <echo level="info">
 
37
Validating help content XML and HTML files: The Eclipse help system expects well-formed XML
 
38
                        
 
39
If validation fails it is because either:
 
40
                        
 
41
* the userguide source code is poorly formed, or
 
42
* the WikiText MediaWiki parser has a bug
 
43
                        
 
44
Problems with userguide source are usually caused by improper use of HTML markup in the MediaWiki source,
 
45
or inadvertently starting a line with a space character (in MediaWiki this starts a preformatted block)
 
46
                </echo>
 
47
 
 
48
                <!-- 
 
49
                Don't bother with DTD validation: we only care if the files are well-formed.
 
50
                We therefore provide an empty DTD 
 
51
                -->
 
52
                <mkdir dir="tmp"/>
 
53
                <echo file="tmp/__empty.dtd" message="" />
 
54
                <xmlvalidate lenient="true">
 
55
                        <fileset dir="Linux_Tools_Project">
 
56
                                <include name="**/*.html" />
 
57
                        </fileset>
 
58
                        <dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location="${basedir}/tmp/__empty.dtd" />
 
59
                </xmlvalidate>
 
60
                <delete dir="tmp" />
 
61
        </target>
 
62
</project>