Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Mylyn » WikiText Confluce to HTML
WikiText Confluce to HTML [message #557190] Sun, 05 September 2010 22:38 Go to next message
David Carver is currently offline David CarverFriend
Messages: 174
Registered: July 2009
Senior Member
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 #557525 is a reply to message #557190] Wed, 08 September 2010 00:10 Go to previous messageGo to next message
David Green is currently offline David GreenFriend
Messages: 135
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 Go to previous messageGo to next message
David Carver is currently offline David CarverFriend
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 Go to previous messageGo to next message
David Green is currently offline David GreenFriend
Messages: 135
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 #558293 is a reply to message #558260] Fri, 10 September 2010 20:38 Go to previous messageGo to next message
David Carver is currently offline David CarverFriend
Messages: 174
Registered: July 2009
Senior Member
Expect something by the end of the year if not sooner. Need to wait until some red tape clears.
Re: WikiText Confluce to HTML [message #558298 is a reply to message #558293] Fri, 10 September 2010 21:03 Go to previous message
David Green is currently offline David GreenFriend
Messages: 135
Registered: July 2009
Senior Member
On 9/10/2010 1:38 PM, Dave Carver wrote:
> Expect something by the end of the year if not sooner. Need to wait
> until some red tape clears.
>

we're holding our breath... ;)
Re: WikiText Confluce to HTML [message #602114 is a reply to message #557525] Thu, 09 September 2010 21:34 Go to previous message
David Carver is currently offline David CarverFriend
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 Go to previous message
David Green is currently offline David GreenFriend
Messages: 135
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 #602158 is a reply to message #558260] Fri, 10 September 2010 20:38 Go to previous message
David Carver is currently offline David CarverFriend
Messages: 174
Registered: July 2009
Senior Member
Expect something by the end of the year if not sooner. Need to wait until some red tape clears.
Re: WikiText Confluce to HTML [message #602166 is a reply to message #602158] Fri, 10 September 2010 21:03 Go to previous message
David Green is currently offline David GreenFriend
Messages: 135
Registered: July 2009
Senior Member
On 9/10/2010 1:38 PM, Dave Carver wrote:
> Expect something by the end of the year if not sooner. Need to wait
> until some red tape clears.
>

we're holding our breath... ;)
Previous Topic:mediawiki to help - links questions
Next Topic:eclipse kees crashing when closing mylyn editors
Goto Forum:
  


Current Time: Sat Nov 22 16:44:12 GMT 2014

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

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