On 2/3/2011 12:34 AM, jerry wrote:
I have a manual in pdf form that I would like to attach to our
project's trac based wiki.
I was thinking of using one of the various pdf to html converters
there and turning the manual into a group of about 300 pages.
I would like to take those 300 pages and add them into our trac wiki
in such a way that we can:
1) link to those pages with Trac links
2) have the pages indexed by the trac search engine
3) easily remove and replace those pages when a new version of the
manual comes out
Less importantly it would be nice to
4) link back from the pages into Trac using Trac links
5) optionally present those pages with our standard trac theme
Is there any way to accomplish this, 1-3 especially?
I think you could get all of 1-5) by writing a little shell script that
take the list of your 300 pages and create for each a wiki page with
some standard content, then use trac-admin to import those.
However, for "transcluding" your HTML plages in those wiki pages, it
seems there's currently no good solution. I was going to suggest the
[[Include()]] macro (on trac-hacks.org), but while it might work, it's
probably a bit too limited: ideally you would need to be able to
retrieve and filter the HTML content to keep the "safe" elements only
(though probably not an issue in your case) and more importantly to only
pick the part of the content you're interested in (the content of the
<body> or maybe even some <div id="content"> or similar).
An alternative would be to implement your own request handler and use a
dedicated template to do this rendering. But the advantage of the wiki
approach is that the readers could edit the page for adding comments,
suggest changes, etc.
Now that I'm saying this, I wonder if we couldn't use this approach
ourselves on the t.e.o Trac wiki for exposing our Sphinx generated API
documentation ;-)
Stay tuned...
-- Christian
--
You received this message because you are subscribed to the Google Groups "Trac
Users" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/trac-users?hl=en.
