This is an automated email from the ASF dual-hosted git repository. marcus pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/openoffice-org.git
commit b0bb8e55f743d8738c33ce75773a41522b0688ba Author: Marcus <[email protected]> AuthorDate: Wed May 12 21:52:16 2021 +0200 Creating new set of webpages --- assets/eo/java/java.txt | 130 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 130 insertions(+) diff --git a/assets/eo/java/java.txt b/assets/eo/java/java.txt new file mode 100644 index 0000000..289f077 --- /dev/null +++ b/assets/eo/java/java.txt @@ -0,0 +1,130 @@ +/xx/java/java.txt 0.0.0 UTF-8 2015-01-27 + + JAVA AND APACHE OPENOFFICE + ========================== + + ENGLISH LANGUAGE BASE LOCALIZATION MATERIALS + -------------------------------------------- + + The folder OpenOffice.org/xx/java/ provides the web content for + the main OpenOffice.org/java/ folder. It is the base from which + the localized versions are prepared. Different localizations + can be found through links on the web. Exception messages in the + Apache OpenOffice software also refer to the main or localized + Java information depending on the language being used in the + AOO interface. + + This text document is a place for description of how the folder + is maintained, how it is localized, and for capture of work items + in one place near the material itself. It is not intended for + linking from anywhere in the site content. + + The current upgrade and localization of the Java information and + messages in the software is proposed to happen in several stages. + +STAGING + + 1. INITIAL CONTENT PAGES FOR UPDATED EXPLANATION OF JAVA DEPENDENCY + + * A provisional index.html is completed. + * The xx/java/ content is made the /java/ content for confirmation + that both accesses work properly. (No linking from other pages + happens yet. + * Screen capture images in the content will demonstrate the current + messages and not the new ones. + * The SVN trunk/main message titles and message texts are updated to + refer to /java or xx/java as appropriate. + * Review for suitability is conducted before there is any investment + in localization. + + 2. AVAILABILITY AND LOCALIZATION + + * Any time after localization starts on the web site, the page at + /download/common/java.html can be redirected to /java/. Previous links + about the Java integration can be changed to refer to /java/. + * Localization of xx/java/ to yy/java/ can proceed. + * For a localized folder the images from xx/java/ can be taken over + first and replaced by images of yy-localized UI as needed. + * As localization happens on the web pages, the changed message titles and + message text for the product can also be changed, The "Details" link + can be changed from http://openoffice.org/java/ to + http://openoffice.org/yy/java/. + + 3. ALIGNMENT WITH NEW MESSAGES + + * When there are builds using the new titles and messages, some might + be replaced in some of the examples OR some might be added to the + example messages where it would be helpful to preserve the older forms + for those who will continue operating older versions of Apache + OpenOffice. + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + TODO + + * Confirm having images here that are meant to be part of the localizable + material and replaced with ones that match the localized software + messages and link to the localized Java information. + + * Find out whether message numbers can be included in the messages so that + the messages can be identified in testing and troubleshooting and it + doesn't matter which localization is being observed or captured in a + screen shot. + + * Find out the fewest places where the "Details http:openoffice.org/java" + addition can be placed in messages so that it shows up but not repeatedly + in how the software combines messages together into one presentation. + + * Sketch the staging in a way where it is whittled away as the stages are + carried out, and replaced by maintenance information. + + * Is a README.txt required or can it all be done in this one text file? + + * The localized pages that are on the current site are served up with the + default language being English. That apparently impedes browsers + identifying the language correctly and it does not assist in-browser + text translation services. It will also help with Internet searching. + o Add the correct content-language coding to the header of the + index.html here. + o Verify that it passes through to browsers correctly. + o Ensure that localization touches that metadata information for + the page. + o Make a bugzilla issue about this? + + * Use identification against the bugzilla issue for this work and for the + the messages in the code. Maybe two different issues. + + * Add an outline of what is to be covered in the updated index.html, with + possibly with any drill-down in linked-to pages within the folder when + needed. + + +VERSION + + 0.0.0 2015-01-27T22:35Z Create initial placeholder to start an account + and TODO items for updating of the java information folder. Add + explicit versioning so folks can easily tell they've seen the latest + without having access to the SVN and knowing how to check histories. + + *** end of java.txt *** \ No newline at end of file
