Eclipse Community Forums: Mylyn » Access trac's wiki pages via ant

Help

Home

Home » Eclipse Projects » Mylyn » Access trac's wiki pages via ant

Show: Today's Messages :: Show Polls :: Message Navigator

Access trac's wiki pages via ant [message #599957]

Thu, 05 November 2009 14:05

Oliver Vesper

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

Report message to a moderator

Re: Access trac's wiki pages via ant [message #599968 is a reply to message #599957]

Thu, 05 November 2009 20:54

David Green

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

Report message to a moderator

Previous Topic:	[mylyn-3.0.5] cannot securely connect to my Trac repository
Next Topic:	re: API

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

]

Current Time: Sat Apr 20 06:55:04 GMT 2024

.:: Contact :: Home ::.

Breadcrumbs

Sign up to our Newsletter