Home » Eclipse Projects » Mylyn » WikiText Confluce to HTML
|
Re: WikiText Confluce to HTML [message #557525 is a reply to message #557190] |
Wed, 08 September 2010 00:10 |
David Green Messages: 136 Registered: July 2009 |
Senior Member |
|
|
David,
Are you using HtmlDocumentBuilder directly (via API) or the built-in Ant
tasks provided by WikiText? The Ant tasks should take care of
cross-file links automatically providing that the documentation source
is a single file of wiki markup.
Generating HTML from multiple wiki markup source files is handled
gracefully for MediaWiki sources
( http://greensopinion.blogspot.com/2010/03/crowdsourcing-docu mentation-made-easy.html)
however this level of integration has not yet been completed for
Confluence sources.
Regards,
David
On 9/5/2010 3:38 PM, Dave Carver wrote:
> While using the HTMLBuilder class, and the confluence wiki
> markuplanguage class, if the markup refers to other pages, like:
>
> h1. Some Header
>
> Introduces the features that SOA Plugin provides for working with the
> SOA framework in eBox. * [Page1] * [Page2] * [Page3]
> The HTML that is generated, contains the links to the pages but does not
> put, ".html" on the end of the links, so a link may show as:
>
> <a href="Page1">Page1</a>
>
> Instead of:
>
> <a href="Page1.html">Page1</a>
>
> Is there a way to configure the builders or markuplanguage generation so
> that the links are generated with .html on the end? Or do I need to
> write my own custom builder?
>
>
|
|
|
Re: WikiText Confluce to HTML [message #558042 is a reply to message #557525] |
Thu, 09 September 2010 21:34 |
David Carver Messages: 174 Registered: July 2009 |
Senior Member |
|
|
I'm using the HTMLBodcumentBuilder directly via API. I found I had to do an extension of ConfluenceMarkupLanguage and override the functionality of emitHref protected method, but that feels like such a hack.
I've got most of the functionality working the way I expect the handling of generating internal links so they get an .HTML extension, with out doing my hack method.
David Green wrote on Tue, 07 September 2010 20:10 | David,
Are you using HtmlDocumentBuilder directly (via API) or the built-in Ant
tasks provided by WikiText? The Ant tasks should take care of
cross-file links automatically providing that the documentation source
is a single file of wiki markup.
Generating HTML from multiple wiki markup source files is handled
gracefully for MediaWiki sources
( http://greensopinion.blogspot.com/2010/03/crowdsourcing-docu mentation-made-easy.html)
however this level of integration has not yet been completed for
Confluence sources.
Regards,
David
On 9/5/2010 3:38 PM, Dave Carver wrote:
> While using the HTMLBuilder class, and the confluence wiki
> markuplanguage class, if the markup refers to other pages, like:
>
> h1. Some Header
>
> Introduces the features that SOA Plugin provides for working with the
> SOA framework in eBox. * [Page1] * [Page2] * [Page3]
> The HTML that is generated, contains the links to the pages but does not
> put, ".html" on the end of the links, so a link may show as:
>
> <a href="Page1">Page1</a>
>
> Instead of:
>
> <a href="Page1.html">Page1</a>
>
> Is there a way to configure the builders or markuplanguage generation so
> that the links are generated with .html on the end? Or do I need to
> write my own custom builder?
>
>
|
|
|
|
Re: WikiText Confluce to HTML [message #558260 is a reply to message #558042] |
Fri, 10 September 2010 16:57 |
David Green Messages: 136 Registered: July 2009 |
Senior Member |
|
|
Dave,
Comments below:
On 9/9/2010 2:34 PM, Dave Carver wrote:
> I'm using the HTMLBodcumentBuilder directly via API. I found I had to
> do an extension of ConfluenceMarkupLanguage and override the
> functionality of emitHref protected method, but that feels like such a
> hack.
Agreed. This is handled more gracefully with
org.eclipse.mylyn.internal.wikitext.mediawiki.core.PageMappi ng, however
that doesn't help you if you're using Confluence markup (it's
MediaWiki-specific). Feel free to file a patch to improve page
cross-reference handling.
> I've got most of the functionality working the way I expect the handling
> of generating internal links so they get an .HTML extension, with out
> doing my hack method.
Great. Let us know how it works out for you, and if your solution is
applicable to others post it here.
Regards,
David
>
> David Green wrote on Tue, 07 September 2010 20:10
>> David,
>>
>> Are you using HtmlDocumentBuilder directly (via API) or the built-in
>> Ant tasks provided by WikiText? The Ant tasks should take care of
>> cross-file links automatically providing that the documentation source
>> is a single file of wiki markup.
>>
>> Generating HTML from multiple wiki markup source files is handled
>> gracefully for MediaWiki sources (
>> http://greensopinion.blogspot.com/2010/03/crowdsourcing-docu
>> mentation-made-easy.html) however this level of integration has not
>> yet been completed for Confluence sources.
>>
>> Regards,
>>
>> David
>>
>> On 9/5/2010 3:38 PM, Dave Carver wrote:
>> > While using the HTMLBuilder class, and the confluence wiki
>> > markuplanguage class, if the markup refers to other pages, like:
>> >
>> > h1. Some Header
>> >
>> > Introduces the features that SOA Plugin provides for working with the
>> > SOA framework in eBox. * [Page1] * [Page2] * [Page3]
>> > The HTML that is generated, contains the links to the pages but does
>> not
>> > put, ".html" on the end of the links, so a link may show as:
>> >
>> > <a href="Page1">Page1</a>
>> >
>> > Instead of:
>> >
>> > <a href="Page1.html">Page1</a>
>> >
>> > Is there a way to configure the builders or markuplanguage
>> generation so
>> > that the links are generated with .html on the end? Or do I need to
>> > write my own custom builder?
>> >
>> >
>
>
|
|
| | |
Re: WikiText Confluce to HTML [message #602114 is a reply to message #557525] |
Thu, 09 September 2010 21:34 |
David Carver Messages: 174 Registered: July 2009 |
Senior Member |
|
|
I'm using the HTMLBodcumentBuilder directly via API. I found I had to do an extension of ConfluenceMarkupLanguage and override the functionality of emitHref protected method, but that feels like such a hack.
I've got most of the functionality working the way I expect the handling of generating internal links so they get an .HTML extension, with out doing my hack method.
David Green wrote on Tue, 07 September 2010 20:10
> David,
>
> Are you using HtmlDocumentBuilder directly (via API) or the built-in Ant
> tasks provided by WikiText? The Ant tasks should take care of
> cross-file links automatically providing that the documentation source
> is a single file of wiki markup.
>
> Generating HTML from multiple wiki markup source files is handled
> gracefully for MediaWiki sources
> ( http://greensopinion.blogspot.com/2010/03/crowdsourcing-docu mentation-made-easy.html)
> however this level of integration has not yet been completed for
> Confluence sources.
>
> Regards,
>
> David
>
> On 9/5/2010 3:38 PM, Dave Carver wrote:
> > While using the HTMLBuilder class, and the confluence wiki
> > markuplanguage class, if the markup refers to other pages, like:
> >
> > h1. Some Header
> >
> > Introduces the features that SOA Plugin provides for working with the
> > SOA framework in eBox. * [Page1] * [Page2] * [Page3]
> > The HTML that is generated, contains the links to the pages but does not
> > put, ".html" on the end of the links, so a link may show as:
> >
> > <a href="Page1">Page1</a>
> >
> > Instead of:
> >
> > <a href="Page1.html">Page1</a>
> >
> > Is there a way to configure the builders or markuplanguage generation so
> > that the links are generated with .html on the end? Or do I need to
> > write my own custom builder?
> >
> >
|
|
|
Re: WikiText Confluce to HTML [message #602143 is a reply to message #602114] |
Fri, 10 September 2010 16:57 |
David Green Messages: 136 Registered: July 2009 |
Senior Member |
|
|
Dave,
Comments below:
On 9/9/2010 2:34 PM, Dave Carver wrote:
> I'm using the HTMLBodcumentBuilder directly via API. I found I had to
> do an extension of ConfluenceMarkupLanguage and override the
> functionality of emitHref protected method, but that feels like such a
> hack.
Agreed. This is handled more gracefully with
org.eclipse.mylyn.internal.wikitext.mediawiki.core.PageMappi ng, however
that doesn't help you if you're using Confluence markup (it's
MediaWiki-specific). Feel free to file a patch to improve page
cross-reference handling.
> I've got most of the functionality working the way I expect the handling
> of generating internal links so they get an .HTML extension, with out
> doing my hack method.
Great. Let us know how it works out for you, and if your solution is
applicable to others post it here.
Regards,
David
>
> David Green wrote on Tue, 07 September 2010 20:10
>> David,
>>
>> Are you using HtmlDocumentBuilder directly (via API) or the built-in
>> Ant tasks provided by WikiText? The Ant tasks should take care of
>> cross-file links automatically providing that the documentation source
>> is a single file of wiki markup.
>>
>> Generating HTML from multiple wiki markup source files is handled
>> gracefully for MediaWiki sources (
>> http://greensopinion.blogspot.com/2010/03/crowdsourcing-docu
>> mentation-made-easy.html) however this level of integration has not
>> yet been completed for Confluence sources.
>>
>> Regards,
>>
>> David
>>
>> On 9/5/2010 3:38 PM, Dave Carver wrote:
>> > While using the HTMLBuilder class, and the confluence wiki
>> > markuplanguage class, if the markup refers to other pages, like:
>> >
>> > h1. Some Header
>> >
>> > Introduces the features that SOA Plugin provides for working with the
>> > SOA framework in eBox. * [Page1] * [Page2] * [Page3]
>> > The HTML that is generated, contains the links to the pages but does
>> not
>> > put, ".html" on the end of the links, so a link may show as:
>> >
>> > <a href="Page1">Page1</a>
>> >
>> > Instead of:
>> >
>> > <a href="Page1.html">Page1</a>
>> >
>> > Is there a way to configure the builders or markuplanguage
>> generation so
>> > that the links are generated with .html on the end? Or do I need to
>> > write my own custom builder?
>> >
>> >
>
>
|
|
| | |
Goto Forum:
Current Time: Fri Apr 19 20:06:59 GMT 2024
Powered by FUDForum. Page generated in 0.03887 seconds
|