Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Mylyn » Access trac's wiki pages via ant
Access trac's wiki pages via ant [message #599957] Thu, 05 November 2009 14:05 Go to next message
Oliver Vesper is currently offline Oliver VesperFriend
Messages: 42
Registered: July 2009
Member
Hi,

I would like to use wikitext to create an eclipse-help and a pdf from our trac's wiki pages - if possible. So far I have set up a build-script which works upon a local file basis. But as I do not have the wiki pages locally I wonder if there is an existing ant-task which can grab the wiki-pages from the trac on the fly, maybe via xml-rpc interface? Or what is the common approach to do something like what I'm intending to do?

Here is the build-script which I'm currently using to generate pdf:


<project name="build pdf documentation" default="generate-pdf">

<property name="wikitext.standalone" value="c:/dev/mylyn-wikitext-standalone-3.3.0.v20091015-0500 "/>
<property name="fop.home" value="c:/dev/fop-0.95"/>

<path id="wikitext.classpath">
<fileset dir="${wikitext.standalone}">
<include name="org.eclipse.mylyn.wikitext.*core*.jar"/>
</fileset>
</path>

<taskdef classpathref="wikitext.classpath" resource=" org/eclipse/mylyn/wikitext/core/util/anttask/tasks.propertie s " />

<target name="generate-pdf" depends="generate-xsl-fo">
<antcall target="xslfo-to-pdf" />
</target>

<target name="generate-xsl-fo" description="Generate PDF from TracWiki">
<wikitext-to-xslfo markupLanguage="TracWiki"
version="0.1"
date="2009-11-05"
title="My Document"
subTitle="Just a test documentation">

<fileset dir="${basedir}">
<include name="tracwiki/*.tracwiki"/>
</fileset>
</wikitext-to-xslfo>
</target>

<target name="xslfo-to-pdf">
<exec command="${fop.home}/fop.bat">
<arg value="-r"/>
<arg value="tracwiki/TestPage.fo"/>
<arg value="${basedir}/Documentation.pdf"/>
</exec>
</target>

</project>


And another question: how do I generate one single FO file from multiple wiki files?

Thx,
Oliver
Re: Access trac's wiki pages via ant [message #599968 is a reply to message #599957] Thu, 05 November 2009 20:54 Go to previous message
David Green is currently offline David GreenFriend
Messages: 96
Registered: July 2009
Member
Oliver Vesper wrote:
> Hi,
>
> I would like to use wikitext to create an eclipse-help and a pdf from
> our trac's wiki pages - if possible. So far I have set up a build-script
> which works upon a local file basis. But as I do not have the wiki pages
> locally I wonder if there is an existing ant-task which can grab the
> wiki-pages from the trac on the fly, maybe via xml-rpc interface? Or
> what is the common approach to do something like what I'm intending to do?
>
> ... snip ...
>
> And another question: how do I generate one single FO file from multiple
> wiki files?
>
> Thx,
> Oliver

Oliver,

You may be interested to see how we do it with MediaWiki for Mylyn's user guide. This article explains how it is done:
http://greensopinion.blogspot.com/2008/11/mylyn-converts-wik i-based-user-guide-to.html

In short, we use Ant to download the wiki markup source using an HTTP GET. I'm not sure how this is done with TracWiki.

As far as generating a single FO from multiple pages, currently Mylyn WikiText does not provide features to make this
easy. I recommend that you start tracking the following issue:

283734: Documentation Best Practices
https://bugs.eclipse.org/bugs/show_bug.cgi?id=283734

It looks like there are coordinated efforts to use Mylyn WikiText with EclipsePedia (a MediaWiki) to produce
documentation. See also these related articles:

http://eclipsesource.com/blogs/2009/07/13/crowdsourcing-docu mentation-at-eclipse/
http://www.peterfriese.de/getting-started-with-wikitext/
http://www.peterfriese.de/advanced-wikitext/

Good luck, and feel free to request enhancements to Mylyn WikiText via bugs.eclipse.org.

David
Previous Topic:[mylyn-3.0.5] cannot securely connect to my Trac repository
Next Topic:[mylyn-3.0.5] cannot securely connect to my Trac repository
Goto Forum:
  


Current Time: Sat Nov 29 06:33:15 GMT 2014

Powered by FUDForum. Page generated in 0.12513 seconds
.:: Contact :: Home ::.

Powered by: FUDforum 3.0.2.
Copyright ©2001-2010 FUDforum Bulletin Board Software