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.
Summary: | I18N - some messages not in bundle files or from the html file for gestures collector or exception window | ||
---|---|---|---|
Product: | ide | Reporter: | Ken Frank <kfrank> |
Component: | Logger | Assignee: | Jaroslav Tulach <jtulach> |
Status: | VERIFIED FIXED | ||
Severity: | blocker | CC: | jcatchpoole, jiriprox, kaa, pkeegan |
Priority: | P2 | Keywords: | I18N |
Version: | 6.x | ||
Hardware: | Sun | ||
OS: | All | ||
Issue Type: | DEFECT | Exception Reporter: |
Description
Ken Frank
2007-02-28 21:27:50 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" ? 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 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 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? 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 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. 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 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 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. 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 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 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 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 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 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 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). 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 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. 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 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 http://testwww.netbeans.org/uigestures/index.html and others mentioned in the commit message. 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 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 Answer to #1 is yes. The other questions need to be answered by Patrick I think. > 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 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 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. |