Re: [platform-ua-dev] BuildHelpIndex ant task problem in 3.2

["Curtis D'Entremont" <curtispd@xxxxxxxxxx>]

Some answers...

1) most of the html files in my doc plugin are
already xhtml 1.0. If I'm not 
interested in using search participants, do I have to change the extension
of these files from .html to something else (.xhtml, I presume)?

You have to use the correct extension (.xhtml)
in order for searching and dynamic content (filters, includes, anchors)
to work properly. The platform uses the file extension to determine the
type of file it is, and to find the appropriate lucene search participant
to index the document for searching. The HTML search participant may work
in some cases for XHTML, but I wouldn't count on it. 

2) if so, how does the xhtml conversion tool work:
- does it erase the .html files?

Yes.

- does it update links in the .html files?
suppose I have 2 files, a.html and b.html, and there's a link from a.html
to 
b.html. In the converted files, is there gonna be a link from a.xhtml to
b.xhtml?

Currently it doesn't. I've opened a bug
for this on your behalf:
https://bugs.eclipse.org/bugs/show_bug.cgi?id=135069

- can it be invoked with an ant task?

Not at the moment. The idea
is to only have to use it once, rather than maintaining .html files and
converting as part of a build process. If you're using tooling to generate
the files, I suggest you check if it's possible to tell the tool to generate
.xhtml extension instead.

Thanks,
Curtis d'Entremont
Eclipse User Assistance
IBM Toronto Lab

Phone: (905) 413-5754
E-Mail: curtispd@xxxxxxxxxx

"pierre _" <pican123@xxxxxxxxxxx>
Sent by: platform-ua-dev-bounces@xxxxxxxxxxx

05/04/2006 04:51 AM

Please respond to
"Eclipse Platform User Assistance component developers list." <platform-ua-dev@xxxxxxxxxxx>

To	platform-ua-dev@xxxxxxxxxxx
cc
Subject	Re: [platform-ua-dev] BuildHelpIndex ant task problem in 3.2

Hi Curtis,
I'm using the ant task with the antRunner application.

I looked at the #2 comment for the #133111 bug report. Would you mind 
clarifying the following things:
1) most of the html files in my doc plugin are already xhtml 1.0. If I'm
not 
interested in using search participants, do I have to change the extension
of these files from .html to something else (.xhtml, I presume)?
2) if so, how does the xhtml conversion tool work:
- does it erase the .html files?
- does it update links in the .html files?
suppose I have 2 files, a.html and b.html, and there's a link from a.html
to 
b.html. In the converted files, is there gonna be a link from a.xhtml to
b.xhtml?
- can it be invoked with an ant task?

Thanks,
Pierre

>Date: Tue, 4 Apr 2006 11:42:19 -0400
>From: "Curtis D'Entremont" <curtispd@xxxxxxxxxx>
>Subject: Re: [platform-ua-dev] BuildHelpIndex ant task problem in 3.2
>                
M6
>To: "Eclipse Platform User Assistance component developers list."
>                
<platform-ua-dev@xxxxxxxxxxx>
>Cc: platform-ua-dev@xxxxxxxxxxx, platform-ua-dev-bounces@xxxxxxxxxxx
>Message-ID:
>                
<OFA885D8B6.B855DA47-ON85257146.0054B106-85257146.0056462D@xxxxxxxxxx>
>Content-Type: text/plain; charset="us-ascii"
>
>Hi Pierre,
>
>I was able to reproduce this with the "Create Help Index"
action on a
>plug-in - see https://bugs.eclipse.org/bugs/show_bug.cgi?id=133111.
I
>intend to have this one fixed for RC1.
>It seems to work ok for the indexTool eclipse application. Were you
using
>the menu action or invoking the ant task directly?
>
>Thanks,
>Curtis d'Entremont
>Eclipse User Assistance
>IBM Toronto Lab
>
>Phone: (905) 413-5754
>E-Mail: curtispd@xxxxxxxxxx


_______________________________________________
platform-ua-dev mailing list
platform-ua-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/platform-ua-dev