Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Mylyn » Access trac's wiki pages via ant
icon5.gif  Access trac's wiki pages via ant [message #495608] Thu, 05 November 2009 14:05 Go to next message
Oliver Vesper is currently offline 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.properties" />
	
	<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 #495736 is a reply to message #495608] Thu, 05 November 2009 20:54 Go to previous messageGo to next message
David Green is currently offline David Green
Messages: 135
Registered: July 2009
Senior 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
Re: Access trac's wiki pages via ant [message #651335 is a reply to message #495608] Sat, 29 January 2011 12:08 Go to previous message
Roy  is currently offline Roy
Messages: 1
Registered: January 2011
Junior Member
Probably a software glitch
Previous Topic:Manage button accessibility in Repository Setting Page
Next Topic:How to create a new category for the particular repository type?
Goto Forum:
  


Current Time: Wed Oct 22 23:17:54 GMT 2014

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

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