[wikitext] Embedding links, etc.. [message #601058] |
Tue, 13 April 2010 23:24 |
Miles Parker Messages: 1341 Registered: July 2009 |
Senior Member |
|
|
As others have said, this is a great contribution.
As background, I'm auto-creating docs using a setup stolen from the xtext docs builder -- my setup is basically the same except that I'm suing mediawiki instead. (You can see the generated docs here.. http://eclipse.org/amp/documentation/) So that means that I actually have docbooks XSL in the mix and so this is a little OT, but I'm hoping that there are other wikitext / docbooks users here who might have ideas.
First, I would like to be able to generate all of my docs automatically, but there is one issue there. I don't think there is a way to get TOC links generated, is there? I've got some links such as API docs that aren't coming from wikitext. (I thought of having a Master toc and then linking the Wiki generated docs in to that, but can't get that working the way I'd like.) And ideas about how I might get these links auto-genrated so that I don't have to re-edit my toc each time I do an update?
Second, I wonder if anyone has built a docbook2html or wiki2html target that separates the html into separate pages for say each h1 / =blah= level heading? My docs are getting large and I don't want users to have to download dozens of images and 30 pages of text everytime they go to the docs page.
thanks for any help or hints,
Miles
|
|
|
|
Re: [wikitext] Embedding links, etc.. [message #601197 is a reply to message #601058] |
Fri, 23 April 2010 14:12 |
David Green Messages: 96 Registered: July 2009 |
Member |
|
|
Miles,
Some answers below:
On 10-04-13 4:24 PM, Miles Parker wrote:
> As others have said, this is a great contribution.
>
> As background, I'm auto-creating docs using a setup stolen from the
> xtext docs builder -- my setup is basically the same except that I'm
> suing mediawiki instead. (You can see the generated docs here..
> http://eclipse.org/amp/documentation/) So that means that I actually
> have docbooks XSL in the mix and so this is a little OT, but I'm hoping
> that there are other wikitext / docbooks users here who might have ideas.
We have quite a few users integrating with DocBook XSL. WikiText enables integration with existing toolchains so that
it's easy to use existing publishing infrastructure. Some people also like integrating with DocBook XSL for the extra
control it gives them over the output.
There have been significant advancements on MediaWiki integration, I recommend that you take a look at
http://wiki.eclipse.org/DocumentationGuidelines/CrowdSourcin gExample
You may find that following this example greatly simplifies your process.
> First, I would like to be able to generate all of my docs automatically,
> but there is one issue there. I don't think there is a way to get TOC
> links generated, is there? I've got some links such as API docs that
> aren't coming from wikitext. (I thought of having a Master toc and then
> linking the Wiki generated docs in to that, but can't get that working
> the way I'd like.) And ideas about how I might get these links
> auto-genrated so that I don't have to re-edit my toc each time I do an
> update?
I recommend that you take a look at the Mylyn help bundle
http://wiki.eclipse.org/DocumentationGuidelines/CrowdSourcin gExample#Mylyn
It shows how to maintain a master TOC with anchors and links, integrating generated TOC.
>
> Second, I wonder if anyone has built a docbook2html or wiki2html target
> that separates the html into separate pages for say each h1 / =blah=
> level heading? My docs are getting large and I don't want users to have
> to download dozens of images and 30 pages of text everytime they go to
> the docs page.
This is easy to do either with WikiText directly or by using DocBook XSL chunking.
Regards,
David
> thanks for any help or hints,
>
> Miles
|
|
|
Powered by
FUDForum. Page generated in 0.05739 seconds