This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 96859 - I18N - some messages not in bundle files or from the html file for gestures collector or exception window
Summary: I18N - some messages not in bundle files or from the html file for gestures c...
Status: VERIFIED FIXED
Alias: None
Product: ide
Classification: Unclassified
Component: Logger (show other bugs)
Version: 6.x
Hardware: Sun All
: P2 blocker (vote)
Assignee: Jaroslav Tulach
URL:
Keywords: I18N
Depends on:
Blocks:
 
Reported: 2007-02-28 21:27 UTC by Ken Frank
Modified: 2008-07-31 03:52 UTC (History)
4 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Ken Frank 2007-02-28 21:27:50 UTC
Some msgs or labels not in bundle file or using the localized html file

1. not using the pseudo localized html file:

Cannot Connect to UI Gestures Collector
Your computer seems to be disconnected from the network. Cannot connect to the
server that could handle your submition request.

2. not in bundles

a. Welcome to UI Gestures Collector window
This is the entry page to the world of statistics. The UI Gestures Collector is
a portal that allows you to find new tips on how to use NetBeans, discover what
developers using the same technologies do the most, and also submit feedback to
the NetBeans development team.
.....

b. View Data, Submit Data, Cancel on this same window
 

Please check all messages/labels of other gestures functionality to make
sure in bundle files. In the bundle files of uigestures jar, I don't 
see many messages in those files, so I don't think I'm using all of the
functionality of it.
Comment 1 Ken Frank 2007-03-01 02:40:01 UTC
in options, look and feel, toolbars

UIGestures is not from a bundle file so cant be localized -
can it be like others as 2 words "UI Gestures" ?
Comment 2 Jaroslav Tulach 2007-03-19 09:08:10 UTC
Re.#1 : Using bundle keys to point to the static pages, so they can be localized

/cvs/logger/uihandler/src/org/netbeans/modules/uihandler/Bundle.properties,v  <--  
Bundle.properties
new revision: 1.25; previous revision: 1.24
done
Checking in Installer.java;
/cvs/logger/uihandler/src/org/netbeans/modules/uihandler/Installer.java,v  <--  Installer.java
new revision: 1.55; previous revision: 1.54
done

Re #2a: That text is on netbeans.org website - pointed to by WELCOME_URL
RE #2b: Names of the buttons are extracted from the same page - e.g. WELCOME_URL
Comment 3 Ken Frank 2007-04-16 21:38:02 UTC
am reopening since I don't see View Data or Submit data in the bundle file of
uihandler jar.

Also, about the text from a web page on netbeans.org - what is the spec
as for localization of it - this assumes there is a localized page with a known
url for each localized version -- but how is this to be setup, how is the text
to be gotten to translators (since not in product, its not in product l10n kit)

-- this is not task of the translation team.

Can't this text be in the product itself and thus in the bundle files ?


PLUS - new missing msg - let me know if needs separate issue -

on exception window (not gestures window) the message
View and Report problem

is not from the bundle file 
Comment 4 Jaroslav Tulach 2007-04-17 15:44:53 UTC
Basically I would need the L10N team to create their version of 
logger/www/welcome/*.html pages and upload them somewhere (potentially 
logger/www/welcome/ or subdirectory).

Then, while localizing the the logger/uihandler/**/Bundle.properties provide 
the right URL for keys like WELCOME_URL and ERROR_URL that would point to the 
above localized pages.

However please note that at the end (after clicking submit data) the user's 
browser will be opened on a non-localized page 
http://anna.nbextras.org/analytics/ - I hope this is acceptable.

So Ken, that is the plan. Now tell, me what I should do to make the 
translation happen? Create logger/l10n.list, write other docs, ask p-team?
Comment 5 Ken Frank 2007-04-17 16:34:08 UTC
comments on the info below:

1. your comment:
Basically I would need the L10N team to create their version of 
logger/www/welcome/*.html pages and upload them somewhere (potentially 
logger/www/welcome/ or subdirectory).

answer:

there is now a web docs l10n kit, and there is one assigned person on our team,
like a writer, who sets this up and communicates with one person on l10n team
about details.

so this would need to be initiated and setup by your team in working with the
web docs team, but in advance perhaps of usual finalization of web docs pages,
since the url changed by l10n in the product needs to be accurate by end of
translations time for product, which might be before web docs complete.

there is a separate l10n.list for the web docs. Patrick Keegan can tell you more.

Also, it can help if a comment on the WELCOME_URL and other url
key/value to tell that it needs to use the decided upon web docs location
and then the name of the localized file.

your comment:
However please note that at the end (after clicking submit data) the user's 
browser will be opened on a non-localized page 
http://anna.nbextras.org/analytics/ - I hope this is acceptable.

answer - it might be - but when I go to that page now I get an error
so I can't see what is on the page so cant comment on it.

ken.frank@sun.com
Comment 6 Jaroslav Tulach 2007-04-17 17:49:49 UTC
Patrick, I need your team help. With the introduction of UI Gestures Collector 
I've partially entered the world of webdocs. Part of the product is influenced 
by logger/www/welcome/*.html pages - their text, their input buttons, etc.

Ken believes this needs to be localized - e.g. included in the l10n.list of 
your team. Can you help me with that?

Also I stated that we do not want content of 
http://anna.nbextras.org/analytics to be localized. I hope I was right, it 
would be too much work for little benefit, imho.
Comment 7 Patrick Keegan 2007-04-17 18:26:38 UTC
I think you would just put the l10n.list file in the top folder of the logger
module and then include the given files the way you normally do in an l10n.list.
The only thing that makes this unique (like what we do with web docs) is that
www files are also included. But otherwise nothing is tricky here, AFAIK
Comment 8 Ken Frank 2007-04-17 18:32:56 UTC
regular l10n.list (in logger cvs module) is for product files only

but these docs are webdocs, so I think they need to be in the web docs
l10n kit. (and noted on the wiki page)

We should not have a special case here that the web doc file is in product
l10n kit since it means the web doc one would need to be putback in a separate
location and we want to avoid that kind of potential confusion.

ken.frank@sun.com
Comment 9 Patrick Keegan 2007-04-18 15:01:37 UTC
There is no single l10n.list for web docs, per se. The l10n.lists are still by
module and (by far) the majority of the web docs are in the testwww module. But
there are some exceptions. Probably the closest one to this case is profiler,
which has an l10n.list that covers both in-product and out-of-product docs.
Comment 10 Ken Frank 2007-04-18 16:15:30 UTC
We need to have web docs in the web docs kit, and product docs in the
product doc kit; and for the web docs for this situation, the docs single point
of contact with l10n would explain about the file being discussed in this
bug on the dedicated wiki page just as they note other web docs files

If there are separate l10n.lists for different web docs, it means that
the correct one would be used that has the web docs that is used by this
and related modules.

ken.frank@sun.com
Comment 11 Patrick Keegan 2007-04-18 16:33:06 UTC
Two things:
*the mechanism for l10n kits at the moment is by CVS module. If there are web
docs and in-product docs in the same CVS module and L10n needs separate kits for
each, then the kit process needs an enhancement. Ken, do you want to file that RFE?
*Naturally, the docs L10n point of contact can track the the logger/www pages to
be translated on our wiki
Comment 12 Ken Frank 2007-04-18 16:56:34 UTC
Patrick,

I can file the RFE but am wondering if this really is a tteam kind of situation
since it might apply to multiple teams and thus need multiple filings ?

And its a higher level kind of decision that would need to be made.

I realize now that testwww does not have all web docs - would one
goal of this be to have policy that all web docs need to live in the testwww ?

Or does that complicate things for testwww and the people who work on that ?

Can you give me some examples of some modules that have some web docs
in their own cvs and the names of those files, so I can see if they are in the
product l10n kit or not ?

If some such files are in product l10n kits, I don't know how they would
ever get to be posted on the web -- since translations of product kits are put
back and then the ml product is built based on this -- and it all goes into the
product.  

Thanks for your advice on this.

ken.frank@sun.com
Comment 13 Jaroslav Tulach 2007-05-16 22:28:25 UTC
I do not want to change processes, I want to fix this problem.

What I can do is to move the page which is currently on 
http://logger.netbeans.org to http://www.netbeans.org 
Parts of that website are being localized, so it is just a matter of adding 
two new pages to this localisation effort.

Unless I hear objections from you in next few days, I will move the pages to:
http://www.netbeans.org/uigestures/index.html
http://www.netbeans.org/uigestures/error.html
http://www.netbeans.org/uigestures/done.html

Comment 14 Jaroslav Tulach 2007-05-16 22:28:26 UTC
I do not want to change processes, I want to fix this problem.

What I can do is to move the page which is currently on 
http://logger.netbeans.org to http://www.netbeans.org 
Parts of that website are being localized, so it is just a matter of adding 
two new pages to this localisation effort.

Unless I hear objections from you in next few days, I will move the pages to:
http://www.netbeans.org/uigestures/index.html
http://www.netbeans.org/uigestures/error.html
http://www.netbeans.org/uigestures/done.html

Comment 15 Ken Frank 2007-05-17 01:22:40 UTC
This thread is long; lets summarize the solutions so far - let me know if this
is correct:

1. bundle file has WELCOME_URL and ERROR_URL, that need to be changed
to the tbd location at netbeans.org where the translated pages will live; these
translated
pages will have the messages and labels that are now missing as described in
this bug.


2. the files to be localized will be in the web docs l10n kit ?
this is not clear yet.

if they won't be in the kit, how will they be obtained by translation teams
since they
get things to translate in the kits ?  And they put things back based on the
location
of the files in the kit so that any post building process knows that.


3. when l10n puts back these files to the web docs area, as part of using the
web docs kit,
is there any building steps needed to be done by RE ?

4. how can this be tested by me now ?

for example, providing dev the pseudo translated html files (after you point me
to or send me
en ones), and then I'll return; you put at some location, and I modify the
bundle file
urls to that location and I run gestures to see if the msgs come from those files
and if the mbyte shows ok (I will put the correct meta charset tag in the html
files)

this way we are emulating the process that will later happen, and this is a
special case
of non product html files having messages and labels that are used in the
product functionality.




ken.frank@sun.com
Comment 16 Patrick Keegan 2007-05-17 17:08:09 UTC
to Jarda, I think it would be great to move these to www. Have you confirmed
with Jack that this is OK?

to Ken,

2. If the files are in testwww/www (as Jarda proposes), they can be in the
l10n.kit for testwww. I would just have to add them. I can do this after the
l10n team picks up the final kits for 5.5.1 (better to not do so before final
5.5.1 handoff since testwww is not branched).
Comment 17 Ken Frank 2007-06-10 19:55:39 UTC
Patrick,

now that 551 is done, could the web docs files for gestures mentioned below be
put in
testwww; then I can get those files and send back some pseudo localized ones with
proper suffix,  so that they could be posted somewhere and then I can test to see if
by changing the bundle file entries to the url of the localized ones, if it shows ok
in nb.

Its important to have the pseudo localized files somewhere on a nb.org kind of
machine
so can make sure for the display of multibyte that it shows ok since this is a
not common
case of info from netbeans site show inside the ide itself.

ken.frank@sun.com
Comment 18 Jaroslav Tulach 2007-07-26 10:39:52 UTC
Ok, per agreement with web team the location of the files to localize will be:

testwww/uigestures/

and there will be files like

index.html
error.html
done.html

which will later be localized to 

index_ja.html
error_ja.html
done_ja.html

I'll commit this soon.
Comment 19 Jaroslav Tulach 2007-08-01 10:13:56 UTC
Pages are there, please include them in the web I18N kit.

cvs ci -m "#96859: Creating the UI Gesture pages on the www.netbeans.org"

cvs commit: Examining .
cvs commit: Examining uigestures
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/done.html,v
done
Checking in uigestures/done.html;
/shared/data/ccvs/repository/testwww/www/uigestures/done.html,v  <--  done.html
initial revision: 1.1
done
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/error.html,v
done
Checking in uigestures/error.html;
/shared/data/ccvs/repository/testwww/www/uigestures/error.html,v  <--  error.html
initial revision: 1.1
done
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/index.css,v
done
Checking in uigestures/index.css;
/shared/data/ccvs/repository/testwww/www/uigestures/index.css,v  <--  index.css
initial revision: 1.1
done
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/index.html,v
done
Checking in uigestures/index.html;
/shared/data/ccvs/repository/testwww/www/uigestures/index.html,v  <--  index.html
initial revision: 1.1
done
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/info.html,v
done
Checking in uigestures/info.html;
/shared/data/ccvs/repository/testwww/www/uigestures/info.html,v  <--  info.html
initial revision: 1.1
done
RCS file: /shared/data/ccvs/repository/testwww/www/uigestures/post.html,v
done
Checking in uigestures/post.html;
/shared/data/ccvs/repository/testwww/www/uigestures/post.html,v  <--  post.html
initial revision: 1.1
Comment 20 Ken Frank 2007-08-31 17:17:55 UTC
Do/should the Submit, Cancel and View buttons on report exeptions window come from bundle
file or was that from an html file in testwww or somewhere else in a product jar ?
if from html file, which one ?

I don't see those labels in uihandler bundle files themselves except for Cancel
but even that one is not coming from bundle file when running in other locale
using pseudo localized msgs.

ken.frank@sun.com
Comment 21 Jaroslav Tulach 2007-08-31 17:37:00 UTC
http://testwww.netbeans.org/uigestures/index.html
and others mentioned in the commit message.
Comment 22 Ken Frank 2007-09-30 03:37:16 UTC
the submit, cancel, view data window buttons are defined in the html files that will be in testww
webdocs kit.

to complete this issue I think if we can confirm the following:
1. the locations of the translated web pages will be as noted below ?

http://www.netbeans.org/uigestures/index_<locale>.html
http://www.netbeans.org/uigestures/error_<locale>.html
etc

2. how/who will put the translated html files that have been put back to testwww into their
locations in #1 above ?  it should be some automated kind of process or script, not for translation team.


3.please confirm that these html docs are now in the web docs kit 


ken.frank@sun.com
Comment 23 Ken Frank 2007-10-11 04:36:24 UTC
please comment on the previous questions below so this can be verified and closed
since translation starts very soon; here are those questions:

to complete this issue I think if we can confirm the following:
1. the locations of the translated web pages will be as noted below ?

http://www.netbeans.org/uigestures/index_<locale>.html
http://www.netbeans.org/uigestures/error_<locale>.html
etc

2. how/who will put the translated html files that have been put back to testwww into their
locations in #1 above ?  it should be some automated kind of process or script, not for translation team.


3.please confirm that these html docs are now in the web docs kit 
Comment 24 Jaroslav Tulach 2007-10-11 08:39:20 UTC
Answer to #1 is yes. The other questions need to be answered by Patrick I think.
Comment 25 Patrick Keegan 2007-10-11 14:52:43 UTC
> 2. how/who will put the translated html files that have been put back to testwww into their
locations in #1 above ?  

is part of the basic web site publishing script and happens every hour or two automatically. (Similarly, if I check a
doc into testwww/www/kb/60/foo.html, it appears on the web site as www.netbeans.org/kb/60/foo.html a few hours later)

> 3.please confirm that these html docs are now in the web docs kit 

I've just added the following two entries to the l10n.list
testwww/www/uigestures/index.html
testwww/www/uigestures/error.html
Comment 26 Ken Frank 2007-10-11 16:40:40 UTC
one more question as to whats in the web docs kit
besides index and error.html are also done, info and post.html
- those are to be translated also ?

ken.frank@sun.com
Comment 27 Ken Frank 2008-07-31 03:52:40 UTC
will verify from own experience and also that a localized release that uses
this functionality has already happened and have not heard of any problems.