[documentation-dev] docs.sun.com repository moved to Oracle Technology Network (OTN)
Hi, the former Sun page docs.sun.com, where you could read and download all Sun books, has been transfered to the Oracle Technology Network pages. And there you can read and download even more books, tutorials, and more, all for free. See http://blogs.sun.com/oootnt/entry/new_home_for_sun_documentation for some more information. Uwe -- Uwe Fischer | Technical Writer Oracle Office GBU ORACLE Deutschland B.V. Co. KG | Nagelsweg 55 | 20097 Hamburg ORACLE Deutschland B.V. Co. KG Hauptverwaltung: Riesstr. 25, D-80992 München Registergericht: Amtsgericht München, HRA 95603 Komplementärin: ORACLE Deutschland Verwaltung B.V. Rijnzathe 6, 3454PV De Meern, Niederlande Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697 Geschäftsführer: Jürgen Kunz, Marcel van de Molen, Alexander van der Ven - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Web based Help
Hello, authors. For the first time, a web based Wiki Help was started for OpenOffice.org / LibreOffice software. In the OpenOffice.org Help Tips and Tricks blog at http://blogs.sun.com/oootnt/entry/web_based_help I wrote down some ideas that crossed my mind. What do you think? Uwe -- Uwe Fischer | Technical Writer Oracle Office GBU ORACLE Deutschland B.V. Co. KG | Nagelsweg 55 | 20097 Hamburg ORACLE Deutschland B.V. Co. KG Hauptverwaltung: Riesstr. 25, D-80992 München Registergericht: Amtsgericht München, HRA 95603 Komplementärin: ORACLE Deutschland Verwaltung B.V. Rijnzathe 6, 3454PV De Meern, Niederlande Handelsregister der Handelskammer Midden-Niederlande, Nr. 30143697 Geschäftsführer: Jürgen Kunz, Marcel van de Molen, Alexander van der Ven - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Book Review project, anyone?
Hi, scanning through very old issues, I found http://qa.openoffice.org/issues/show_bug.cgi?id=24022 about a Book Review project. A first page was created at http://documentation.openoffice.org/book_reviews/books.html Now, with the Wiki, it might be a good idea to revive this project? Every user can add own reviews, and other users can comment on these. Uwe -- u...@openoffice.org - Technical Writer Sun Microsystems, Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Fwd: OO helpfile
Hi all, please feel free to submit issues regarding the installed Help using Issuezilla: http://qa.openoffice.org/ooQAReloaded/ooQA-ReportBugs.html If you don't speak Issuezillanean you can e-mail your issue to me. As an exception you may post the issue on this mailing list. Unfortunately, we must limit our efforts to improve the installed Help in a way to keep word count low. Therefore it is so important to have good and extensive guides on the web, for example, on the Wiki. We try to include links in the installed Help that lead to good instructions on the Wiki. Everyone can write and edit documents on the Wiki, the results are available instantly and can be translated by OOo volunteers as they please. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Open Offic Writer Guide in Spanish
On 02/05/10 09:38, Clayton wrote: On 02/02/2010 03:21 AM, Pub Coord wrote: Here is a first draft of chapter 1. I have the first 9 done and more to come. Would the “community” be interested? Hi Bill. The community would love to have the documents localized into all languages :-) The Documentation project does its best to manage the documentation in English, and the NL teams handle the translations into the various languages. Since not so many of us in the core Documentation project read Spanish, it might be helpful to co-ordinate with the Spanish NL project to see what translations they also have in process. Are you in contact with the Spanish NL project? C. which can be found here: http://es.openoffice.org/ Uwe -- u...@openoffice.org - Technical Writer http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [HC2] Graphic truncated and incorrect in French
On 27.01.2010 16:40, Sophie wrote: Hi Uwe, I have two issues in the help file you find under Recognizing;colons and row labels. - The graphic is truncated whatever the language. - The French graphic is wrong because it displays 'Ligne 1' instead of 'Ligne un'. Do I open 2 issues and do you need me to provide a correct localized graphic? Hi Sophie, I suppose the graphic looks truncated even in the English version, because it was never meant to show all of the UI elements. It is necessary to show the column headers A to D and the row headers 1 to 6. The exact names of the headings inside the area don't matter as long as they correspond to the same heading names in the text. If you think there is an issue in the French localization, feel free to submit one issue to module l10n. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [HC2] Graphic truncated and incorrect in French
Hi Sophie, please submit an issue for the wrong French version of the graphic to l10n, to the default owner of the module. If that doesn't work, submit it to coni or ihi. The truncated image did show up in English source, too, so I'll submit an issue for this. Image is shown correct the first time you browse to that page, but cut off at half of column A later on. Might be something like issue 90395. thank you for finding reporting this. Uwe On 27.01.2010 17:15, Sophie wrote: Hi Uwe, Uwe Fischer wrote: On 27.01.2010 16:40, Sophie wrote: Hi Uwe, I have two issues in the help file you find under Recognizing;colons and row labels. - The graphic is truncated whatever the language. - The French graphic is wrong because it displays 'Ligne 1' instead of 'Ligne un'. Do I open 2 issues and do you need me to provide a correct localized graphic? Hi Sophie, I suppose the graphic looks truncated even in the English version, because it was never meant to show all of the UI elements. It is necessary to show the column headers A to D and the row headers 1 to 6. Currently only half of the column A is displayed, making the graphic helpless. The exact names of the headings inside the area don't matter as long as they correspond to the same heading names in the text. Yes, but as long as we are speaking about words and not numbers, I think the English example is more accurate. If you think there is an issue in the French localization, feel free to submit one issue to module l10n. I'm responsible for FR l10n, do you know who takes care of this? Thanks in advance Kind regards Sophie - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Wrong formating of numbered list in Extension update help file
On 12/03/09 19:39, Sophie wrote: Hi Uwe, In the file /text/shared/01/extensionupdate.xhp, the numbered list is not well formated, and this make the help quite difficult to understand, see: If updates are available, the updates can either be installed automatically, or you must respond with some action: 1.The Extension Update dialog may contain entries which are not selectable and hence no automatic update can be performed. 1.Dependencies are not fulfilled (the update needs some more or newer files to be installed). 2.Insufficient user rights (the Extension Manager was started from the menu, but shared extensions can only be modified when OpenOffice.org does not run, and only by a user with appropriate rights). See Extension Manager for details. 3.A manual update is necessary. 2.When you click the Install button the Download and Installation dialog is displayed. 3.All extensions which can be directly downloaded are downloaded now. The progress is shown in the Download and Installation dialog. If an extension cannot be downloaded, a message is displayed. The operation continues for the remaining extensions. Have you already noticed it or do I feel an issue? Kind regards Sophie Hi Sophie, thank you for reporting this bug. I've fixed the broken numbering in CWS hcshared25, due for OOo 3.3. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Transluding more content to or from the Policy Page?
Clayton wrote: I've been looking through the Wiki Policy page, and I think large sections of it are generic enough to become general Wiki Help pages. The best way (in my opinion) to be sure we're not loosing content or duplicating our efforts is to transclude the content... which way is better though? From the Help page into the Policy? or Policy into the Help? how can an author see that some text is also readable on another page (a.k.a. transcluded)? Does the WYSYWYG editor show this information? How easy is it to accidentally break the link or to edit the source text in a way that the target text becomes invalid? Then leave the original source where it is most important, or where the most page hits are expected. My thoughts the generic content could be moved to the appropriate Help:Pagename and then transluded back into the Wiki Editing Policy Page (like I've done with the Help:Translating page). This allows us to maintain the generic Help pages, and also the fine tuned Doc Proj specific guidelines without duplication. The start point for the Wiki Help pages is here: http://wiki.services.openoffice.org/wiki/Help:Contents This is the page you land on if you click Help on the left nav bar/box. Good idea? Or other ideas? C. Uwe - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Re: [l10n-dev] Re: [documentation-dev] Issues with formatting in HC2/swriter/guide.po
Hi, Sophie wrote: ... I was not speaking of spaces but about the emph/ that appears in this string for example : Chooseemph/ item type=\menuitem\Edit - AutoText/item. I know that you change emph to item, and this cannot be rolledback, but this emph/ appears at several places in the strings with no logic for me. I just wanted to point it, but if you're aware, it's ok. that are empty XML tags which can be ignored. I hope the syntax checker ignores them, too. The source for 3.2 is fixed since some days now, and we will delete those empty tags later for 3.3. Uwe - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Re: [l10n-dev] IMPORTANT: Helpcontent changes in m57
On 09/07/09 15:28, Rafaella Braconi wrote: Hi Andre' On 09/07/09 15:22, Andre Schnabel wrote: Hi, Original-Nachricht Von: Rafaella Braconi rafaella.brac...@sun.com We need to know if we should roll back the changes listed above that were introduced with m57 (this does not apply to the relevant content changes, just the changes listed above). I agree with Frank that it is important to get your feedback and your GO before we roll back the changes/issues listed above. I have no probelm with rolling back those changes introduced in m57. As we are working on pootle, we are just doing the translations for m54. as these are partially done, please no not rollback changes from m54. for the moment, the Pootle content reflects m54. However, once the CWSs with the new feature and contents are integrated and we have a new milestone, we will have to update Pootle with the latest milestone the CWS hcshared22 introduced most of the unwelcome and not intended changes to m57. However, the next and final OOo 3.2 Help CWS hcshared23 will follow in less than a week from now. And we can change things back there in the sources, if this is what the stakeholders in the community want. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Re: DocBook?
Hi, On 09/04/09 15:55, Clayton wrote: ... If we argue that we can use Writer as a DocBook editor (it is technically possible to export DocBook from Writer), then why bother with DocBook? Do the docs right in ODT. No matter which way we go (Wiki, DocBook, or something else), we will have issues. If we use a CMS of some sort and Writer (TeamDrive and Alfresco, to name two, have OOo plugins so you can access the files direct from OOo), we loose a lot of the simple accessibility that we have in the Wiki. If we use the Wiki, we have difficulty exporting to other formats. The Wiki is definitely not a perfect medium for documenting, but... it does the job reasonably OK in most cases. In a perfect world, I'd like to be able to use OOoWriter to author and edit the docs, save them to webserver (just via save), and be able to automatically/immediately have them rendered into Webpages (as in the way the Wiki works). There is not yet a OOo based Wiki :-) It'd be the best of both worlds. C. this can be solved by software, so it is not a problem. May be today, but not tomorrow. See the ODF @ WWW project proposed by Kay Ramme some time ago, and watch the screencast at http://odf-at-www.openoffice.org/ And I would be very happy if the Help source files would be available for editing by every interested user. Still a long and winding road to edit and compile the set of Help files. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: Re: [users] Write: How to manage Sections?]
On 08/27/09 10:37, Gary Schnabl wrote: I'll add a pair of Microsoft Word: Sections -- OOo: Page Styles to the Help at index Microsoft Office;feature comparisons. Did not know Word so good that I recognized that this may be a problem for some users. Uwe This might help: the English version (1033) of MS Word 2007 Help How-to (http://office.microsoft.com/client/helphome.aspx?NS=WINWORDVERSION=12LCID=1033SYSLCID=1033UILCID=1033) That is the online version of Word 2007 Help--the most current. I stick my nose into it quite a bit... I report some errors every so often. Gary Thank you, Gary, for the link. When I tried to open the Microsoft help pages on the web in the last few years, I always got a message that I'm not using Windows and therefore are not eligible to see the MS Help. So Section break is the magic word known to the Word users. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: Re: [users] Write: How to manage Sections?]
Well, a section can contain a section can contain a section ... This is the reason for the hierarchical display in Edit - Sections dialog. And the order of the section names in that dialog seems to be alphabetically. So what was the problem? That page layout and page style problem doesn't relate to sections. Page styles are explained in the same Wiki doc at http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Writer_Guide/Applying_page_styles Uwe Clayton wrote: Forwarding this here.. the user has soem interesting comments about the Section documentation.. maybe a chance to improve what we have? C. -- Clayton Cornell ccorn...@openoffice.org OpenOffice.org Documentation Project co-lead StarOffice - Sun Microsystems, Inc. - Hamburg, Germany Subject: Re: [users] Write: How to manage Sections? From: Alex Zachopoulos alexzachopoulos.oool...@gmail.com Date: Wed, 26 Aug 2009 16:38:16 +0300 To: us...@openoffice.org To: us...@openoffice.org Hi Clayton! Thx for the post. Actually I have; after posting here the OP, then I d/l and read the section you refer to. I'm afraid I still have a few fundamental questions: it doesn't explain what the difference is between sections which appear at the 'same level' and those which appear indented as if 'belonging' to a previous section. Also, how the sequence in the list of sections relates to their actual position in the document flow. Lastly, I need to have a different page style applied to pages 3-19 of my document. If the text already entered belongs to various sections (as it does currently), OOo doesn't allow me to apply a different page style to a few pages: the moment I change it somewhere, it changes throughout the document. So, all in all I still am lost as regards sections. And I am not even sure if I can't get it, or if Sections in OOo are still somewhat primitive, or at least peculiar in their concept. -A On Wed, Aug 26, 2009 at 2:44 PM, Clayton ccorn...@openoffice.org wrote: Alex Zachopoulos wrote: I have this Write file which I am putting together, and I would like to keep it organized with Sections, so that I can apply different settings to each section, such as page borders, headers footers etc. As I type along, I have at various points selected InsertSection... and setup new sections this way. I have also done the same, after having selected some text. Right now, if I go to FormatSections... I see the various sections, but some of them appear before others when I would have expected them to appear below (they come _after_ the others ones in the real text flow), plus some of them appear in the list of sections on the left as if they are dependent on others, like a sub-tree hierarchy. I am trying to figure out how I can manage my sections so I actually understand what I'm doing, but I find the documentation in the Help section sadly lacking. Any tips? Thanks, people. PS I am on Mac OS X 10.5.7, using NeoOffice. But it's basically the same as OpenOffice. Only very few differences. Have you checked out the User guide here: http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Writer_Guide/Sections_for_page_layout C. -- - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Missing help information about [HH]:MM:SS] time format
Hi, Sophie wrote: Hi Uwe, Jean-François Philip, one of our QA tester (in copy of this mail) has reported a missing information in the HC2 file concerning the time format [HH]:MM:SS that allow you to display hours beyond 24 hours. He is proposing the following text, that I've tried to translate from French : - To display hours beyond 24, use the [HH]:MM:SS format. For example the following formula =12:34:56+14:00:00 displays the time in the form of 26:34:56. This format is available for cell format, under the Number Tab page, Time Category, 876613:37:46 format. -- This text could follow [par_id315609] in the /text/shared/01/05020301.xhp file. Do you want me to fill an issue for this? if you want ... Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [OLH] Indents and spacing tab in Numbering/bullet dialog
On 08/12/09 20:01, Sophie wrote: Hi Uwe, all, I'm currently working on the OLH files for 3.2. In the shared/01.po files there is : #: 06050100.xhp#par_id3156042.help.text msgctxt 06050100.xhp#par_id3156042.help.text msgid link href=\text/shared/01/05030100.xhp\ name=\Indents Spacing tab (Numbering/Bullets dialog)\Indents Spacing tab (Bullets and Numbering dialog)/link and some other strings speaking about this Indents and Spacing tab in the Bullets and Numbering. But I can't find this tab on 3.x versions. Could you confirm this and do you want me to fill a bug? Hi, if you want, please submit an issue. If you don't, I'll do it later. There is no Indents Spacing tab page anymore in the Bullets and Numbering dialog. At least, the files shared/01/06050100.xhp and shared/01/06050200.xhp need to be changed. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
[documentation-dev] Help and Project Renaissance
Hi, you certainly already know there is an ongoing project Renaissance [1] to improve the user interface of OpenOffice.org. Several design proposals have been submitted by community members. At least one proposal by Miroslav Mazel [2] also mentions the Help. Here are some paragraphs from Miroslav's text regarding the OOo Help: start Help Help should be completely revamped to be and feel friendlier and lose its reputation of being intimidating/frustrating. * Images, videos, tutorials, and common-language descriptions should all be added, sometimes in place of unclear directions. * Help feels like a part of the suite * Search needs to be vastly improved, along the lines proposed in the [User Experience/Command search command search proposal]. What's this? should work for EVERY command in the interface, and there should be an infobar with a nice big button to end this mode. * The Help home screen should be simple: A search box, a few large categorical links (similarly to System Preferences/Control Panel in Mac OS and Windows, although fewer and larger), and a link to online resources. It should feel very much like the new Options tab. * Tutorials especially should utilize videos, simple, step-by-step directions, loads of screenshots, and/or even a Do this for me button, which would walk the user through the task. * Let's tout the Help improvements (once we're sure it's really good) with the release of the Renaissance OO.o (or even earlier; this could be implemented independently), since it seems a lot of people now simply disregard Help. end What do you think? How can we improve the UI of Help? How can we improve the functionality (helpfulness) of Help? How can we improve the contents of Help? [1] http://wiki.services.openoffice.org/wiki/Renaissance [2] http://wiki.services.openoffice.org/wiki/Proposal_by_Miroslav_Mazel Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Delete layer in Draw
Hi, On 05/20/09 09:51, Per Eriksson wrote: Hello, Does anyone have a comment to this page in HC2? The Swedish community has noticed that there is an article in help for Draw stating the following: Delete layer Deletes the active layer. To access this command... Choose Edit - Layer - Delete This command is only available in %PRODUCTNAME Draw layer mode. My first questions is, is the information correct? this is an old page in Help that will be changed soon. http://qa.openoffice.org/issues/show_bug.cgi?id=102085 Thanks for the information. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Questions about Web Page Query filter in Calc
Hi, On 04/04/09 09:11, Jean Hollis Weber wrote: I'm writing a section for the Calc Guide about linking from a spreadsheet to external data. I found a page in the help titled Inserting External Data in Table (WebQuery) which explains what to do The WebQuery works the other way round: data from another document (that may be a web page containing html tables) gets pasted into your current Calc spreadsheet. but seems to assume some background knowledge that I don't have (and I suspect many of the readers of the Calc Guide won't have) -- or perhaps it's just a matter of using terms in ways that are not familiar to me. So I hope someone here can help me understand better, so I can write this up for the user guide. I searched the forum and the wiki, and didn't find anything useful to me. Haven't gone to the [users] list yet; thought I'm check with this group first. I thought it is easy if you follow the Help from top down - but obviously I must rework that Help page. For example, here's part of a sentence from the help: If you have loaded an HTML document with the Web Page Query filter as the source document... Er... how do I load a doc with the WPQ filter? Do I simply choose that as a file type in the Open dialog? Or does something else need to be done? this filter is mentioned some paragraphs above in the same Help page. It is used automatically if you enter an http URL in the External Data dialog box. If you want to reference a file of your file system, you click the ... button and select that filter in the File Open dialog. The file that you select or the web page must contain some tables. ... you will find the tables in the Navigator, named continuously from HTML_table1 onwards, and also two range names that have been created: HTML_all – designates the entire document HTML_tables – designates all HTML tables in the document I guess I need to somehow pick a table of data and avoid tables used for layout... or does it matter? The webQuery inserts the data from the external table cells into your Calc doc. The link is live and dynamic. An example, with illustrations or HTML samples, might help me get the concept. I suspect it's quite easy and obvious once one understands it! sure, would be nice to have some illustrations. May be on a Wiki page? Thanks for any help you can give me. --Jean - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Questions about Web Page Query filter in Calc
On 04/06/09 11:45, Jean Hollis Weber wrote: ... I have just written a web page, with illustrations. http://www.taming-openoffice-org.com/newsite/?page_id=633 Would be good if you check it to see if I made any mistakes. (It's also now part of a draft chapter of the Calc Guide and will appear on the OOo wiki when I get a chance to upload it. It's probably a lot more detailed than relevant for the help, but a few sentences could probably be reused in the help.) --Jean Jean, your External Data help at http://www.taming-openoffice-org.com/newsite/?page_id=633 looks perfect! Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Re: some notes about helpcontent
Ain Vagula wrote: and more: a lot of strings came with last updates like: Tools - Autocorrect Options There is no menu entry Autocorrect Options, right were Tools - Autocorrect - Options (the tab) yes there is :-) it came in with the community submitted patch of CWS menuchanges integrated to DEV300m39 Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Do you use sound or video in Impress?
Hi Ariel, On 01/22/09 01:17, Ariel Constenla-Haile wrote: Setting this up can be very simple, or an odyssey (no middle term). First time I tried on other system it was very easy, now on Fedora 10 the file coulnd't even be installed due to an issue in the installer, so I had to edit the binary in vim and modify a line. Ariel, can you please post the very easy way of setting up the JMF to the Wiki? May be as a How-to or as a FAQ at http://wiki.services.openoffice.org/wiki/Documentation/FAQ/General started http://wiki.services.openoffice.org/wiki/Java/Java_Media_Framework it can then be moved where you like it. thank you very much! That new Wiki page looks really good. I will add some links that lead to that page, where appropriate. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Do you use sound or video in Impress?
Hi, Ariel Constenla-Haile wrote: Hello Jean, On Tuesday 20 January 2009 22:33, Jean Hollis Weber wrote: Uwe Fischer wrote: in theory, all movie and sound files that your default browser can play should also be playable in Draw and Impress. I think you mean default media player, not default browser? this menu uses the Mozilla plug-ins, acording to http://www.openoffice.org/servlets/BrowseList?list=devby=threadfrom=2159761 it seems it needs to be fixed, and testing it on a DEV300_m39, on Linux, no plug- in works for me. in theory, most Mozilla plugins (aka Firefox add-ons) should be automatically recognized by OOo to play media files. As Mathias wrote, this is a nice way to re-use the good work that was already done by others in the FOSS world. Some plugins may not work because they expect a real browser environment to run, or because they ask for other dependencies than OOo. I have another question. In the Help, a note in the Media Player topic says: --- On UNIX systems, the Media Player requires the Java Media Framework API (JMF). Download and install the JMF files, and add the path to the installed jmf.jar to the class path in Tools - Options - OpenOffice.org - Java. --- Minor issue: Is UNIX the best term to use here? I assume it includes Linux, but I'm not sure that all the newbie Linux users (of which I am one) equate UNIX with Linux. yes, I changed that to read Linux or Solaris and included a link to the JMF page at java.sun.com. Real question: is there somewhere with good, clear, easy-to-follow (for us Linux newbies) instructions on where to get and how to install JMF, specifically on Ubuntu? (I'm not suggesting that info should be in the Help, but I want to know for my own use.) I had a look through Synaptic but didn't find anything I recognised as being JMF or JMF-related. you have to download the JMF Performance Pack for Linux from Sun: http://java.sun.com/javase/technologies/desktop/media/jmf/2.1.1/download.html Setting this up can be very simple, or an odyssey (no middle term). First time I tried on other system it was very easy, now on Fedora 10 the file coulnd't even be installed due to an issue in the installer, so I had to edit the binary in vim and modify a line. Ariel, can you please post the very easy way of setting up the JMF to the Wiki? May be as a How-to or as a FAQ at http://wiki.services.openoffice.org/wiki/Documentation/FAQ/General I won't recomment to post the hacking tips though, because this might be dangerous foe normal users. And the supported formats are very little, even if you download the mp3 plug- in (http://java.sun.com/javase/technologies/desktop/media/jmf/mp3/download.html). I download and compile the Fobs4JMF, which is a JMF wrapper for ffmpeg (that means, you can play almost *anything*), see http://fobs.sourceforge.net . Any way, I'd suggest you give it a try (otherwise you have no other option to use that fork, that comes with native gstreamer support - something I strongly discourage! IMHO for a few features you get lots of issues). I download the file. Extract it in my home dir. I don't follow the instructions for the mp3 plug-in, but unzip it and copy it in the JMF (JMF-2.1.1e/lib). Then as su I move the JMF-2.1.1e to /opt, create a simlink /opt/JMF so I can update easyly (well, update is just a word here, as this is very unmantained by Sun). Then I solve every class path and library search path problem by creating/editing /etc/profile.d/java.sh (in Fedora and Ubuntu I had to create it), that looks like this: export JAVA_HOME=/opt/jdk export JMFHOME=/opt/JMF export CLASSPATH=$JMFHOME/lib/jmf.jar:$JMFHOME/lib/mp3plugin.jar: $JMFHOME/lib/fobs4jmf.jar:$CLASSPATH export LD_LIBRARY_PATH=$JMFHOME/lib:$LD_LIBRARY_PATH export PATH=$JAVA_HOME/bin:$JMFHOME/bin:$PATH Add the $JMFHOME/lib/jmf.jar to OOo classpath (menu Tools - Options - Java), and reboot. Then as su, run the JMStudio and add the mp3 plug-in. Building Fobs4JMF, the JMF wrapper for ffmpeg, requires some knowledge on building (and programming: I had to correct some errors in five files to compile). They have a deb pkg for Ubuntu but it's old. Regards Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum/ http://blogs.sun.com/oootnt http://www.sun.com/staroffice - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Images size modified in HC2 m39
Hi Sophie, On 01/20/09 09:45, sophie wrote: In HC2 for DEV300_m39, there is a strange notation for graphics size, I'm not sure it is correct or without consequences or if you want me to file an issue : #: 0004.xhp#par_id3156315.help.text msgid image id=\img_id3156322\ src=\res/commandimagelist/sc_togglegridvertical.png\ width=\0.2228in\ height=\0.2228in\alt id=\alt_id3156322\{ENTER ALTERNATE DESCRIPTION HERE}/alt/image msgstr image id=\img_id3156322\ src=\res/commandimagelist/sc_togglegridvertical.png\ width=\0.222inch\ height=\0.222inch\alt id=\alt_id3156322\Icône/alt/image the 0.222inch has been changed in the source to 0.2228in. don't care for the width and height attributes inside the tags. They are ignored by the Help Viewer, and I hope no one out there did develop a utility program that relies on these information. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Do you use sound or video in Impress?
Hi, On 01/18/09 22:16, Jean Hollis Weber wrote: Can anyone assist me in writing a specific section of the OOo3 Impress Guide? ... For example, I'm totally unclear on the difference between Insert Movie and Sound versus Insert Object Sound (or Insert Object Video). I can get the first to work (on WinXP), but not the second (an object icon appears on the slide, but doesn't do anything). afaik, the Insert-Object-Sound/Video commands are mainly still there out of historical reasons. Normally, Insert-MovieSound should be used. If there is info in the Help, I've been unable to find it, and some of what I have found doesn't seem to correspond with what I see in WinXP. please send me some pointers to the incorrect Help pages. I've been searching the OOo forum and the Web, but it's slow going and I suspect I don't know the right search terms. Pointers to specific topics, threads, or pages, or some help from an experienced user, would greatly speed this up. Not just regarding those menu items, but generally what should be covered in the Impress user guide regarding sound and video in presentations. in theory, all movie and sound files that your default browser can play should also be playable in Draw and Impress. Unfortunately, it is not easy to guarantee this for a multi-platform program. So there are some issues: http://qa.openoffice.org/issues/buglist.cgi?issue_type=DEFECTcomponent=Drawingcomponent=Presentationissue_status=UNCONFIRMEDissue_status=NEWissue_status=STARTEDissue_status=REOPENEDissue_status=RESOLVEDtarget_milestone=OOo+3.1target_milestone=OOo+3.2target_milestone=OOo+3.xemail1=emailtype1=exactemailassigned_to1=1email2=emailtype2=exactemailreporter2=1issueidtype=includeissue_id=changedin=votes=chfieldfrom=chfieldto=chfieldvalue=short_desc=short_desc_type=allwordslong_desc=long_desc_type=allwordsissue_file_loc=issue_file_loc_type=fulltextstatus_whiteboard=status_whiteboard_type=fulltextkeywords=keywords_type=anytokensfield0-0-0=nooptype0-0-0=noopvalue0-0-0=cmdtype=doitorder=Reuse+same+sort+as+last+timeSubmit+query=Submit+query Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Do you use sound or video in Impress?
On 01/19/09 12:45, Jean Hollis Weber wrote: Uwe Fischer wrote: Jean Hollis Weber wrote: If there is info in the Help, I've been unable to find it, and some of what I have found doesn't seem to correspond with what I see in WinXP. please send me some pointers to the incorrect Help pages. On the page titled Movie and Sound in the Impress Help is this: - To play a movie or sound file in an Impress presentation 1.Open the slide that contains the movie or sound file. 2.Click the object icon for the movie or sound file on the slide. 3.Click Play on the Media Playback toolbar. - Is the help talking about previewing the movie or sound? IIRC, the preview works that way. But when showing a presentation, if I have used Insert Movie and Sound, it starts playing immediately when the slide is opened. No need to click, and the Media Playback toolbar is not there. If I used Insert Object Sound/Video, then there is an Object icon on the slide, but clicking on it does nothing. Thank you, Jean, for this information. I copied this mail to my To-Do list. Will upgrade Help as soon as I know which is the expected behaviour and which is a current issue. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Intent to create Basic/Other_Instructions page
Hi T. J., On 01/19/09 13:32, T. J. Frazier wrote: Uwe Fischer wrote: On 01/19/09 11:44, T. J. Frazier wrote: Clayton wrote: BTW: I thought the Alphabetic List of Functions, Statements, and Operators would be generated automatically. Do you really have to fix that by hand? Which list is that? The Book TOC? (I've kind of lost my place in this thread) It is possible to use the Dynamic Page List (DPL) extension to generate a list of pages in a category. We use this on the FAQ pages. It depends on the pages being in the right Categories for them to show in the list. I have a feeling this is not what you were asking about though. C. (This was in reply to Uwe's question about the OLH.) The list is in Help Basic Contents Macros, etc. Command Reference Alphabetic etc. It's one of my most-used resources; seeing it incomplete gives me a chill. BTW: the wiki syntax highlighter doesn't recognize Type as a keyword, although OO.o Basic highlights it fine. I must admit I never use the Contents tab of the Help Viewer, so I did not search there. AFAIK, that list of functions was generated automatically once, many years ago. I never touched it. It is incomplete, for sure, but then the whole Contents tab page was meant initially to be incomplete, giving only the most often needed headings. Uwe Oh, dear, /oh, dear,/ *oh, dear!* I don't know if it would help with the maintenance (or if it's even possible), but could you consider moving that list to a page, instead of the TOC itself? That way, (1) I could bookmark it, and (2) you could link to it from the landing page (probably the new third link, just below the Runtime Function link). (When I'm exploring, I use my time and ingenuity on the Index and Find tabs, and follow a lot of See also links, and generally learn something interesting, if not always immediately useful. But, when I'm programming, those tabs are too full of clutter; the Alpha list is exactly what I want, while my time and ingenuity are reserved for the nascent program. And that's probably 2/3 of the time.) I was tempted to delete that list of reference info from the Basic Help TOC. But if you are using it all the time, I will not delete that list, of course. Additionally, I try to get a current list from the developers and post it to the OOo Wiki. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Intent to create Basic/Other_Instructions page
Hi, On 01/19/09 16:27, Clayton wrote: The functionality JHW and I are using (Export to MediaWiki) seems to be built into V3.0. I haven't installed the extension, nor does it show in the Extension Manager. The File format list box on the Export dialog shows MediaWiki (*.txt) as the option we are using. I think they are one and the same.. just that the code is rolled into 3.0.0.. but I could be wrong. The Sun Wiki Publisher at http://extensions.services.openoffice.org/project/wikipublisher is an extension that simplifies the Wiki export. It uses the built in Wiki export filter. The Wiki export filter only creates a txt file on your harddrive, while the Sun Wiki Publisher can send the same file to any one of your Wikis, using your respective Wiki account data, among other comfort functions. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Intent to create Basic/Other_Instructions page
Hi, * explanation about how to declare new types is AFAIK missing (I couldn't even find it in the office Help): Type aMenuItem aCommand as String aText as String End Type Sub Main Dim maItem as New aMenuItem With maItem .aCommand = .uno:Copy .aText = ~Copy End With MsgBox Command: maItem.aCommand Chr(13) _ Text: maItem.aText End Sub The only mention I could find of Type in the OLH was under the *CreateObject Function[Runtime]*, which can be found in the index, but not in the TOC alpha list of runtime stuff (there's another one for Uwe). Thanks for bringing this to my attention: the command is brand-new to me. The Type ... End Type is new to me, too. I couldn't find any reference to this declaration in the BASIC Guide, and not in the whole api.openoffice.org documentation. Possibly the example at CreateObject is a typo? Did you check if the example works as expected? Can you replace Type by Dim and vice versa? Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Why so few active volunteers?
On 01/08/09 22:26, Jean Hollis Weber wrote: Even though hundreds of people are members of OOoAuthors and/or the OOo Documentation Project, very few actually contribute to writing, reviewing, or editing of user-documentation content (whether for books or on the wiki). A few years ago OOoAuthors at least had many more active members. Is it still needed to sign a license agreement and send it somewhere before you can publish any works as a new author? I read this is needed for code, see the paragraph near the end of page http://www.openoffice.org/dev_docs/guidelines.html - but I don't know about documentation authors. This might drive away many possible authors, just because there are so many other projects in the world that might need support and don't throw in some legalese stuff. Uwe -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] [Fwd: Re: [l10n-dev] work-in-progress?]
Hi, all those meta text strings {ENTER ALTERNATE DESCRIPTION HERE} should be Icon instead. Translate them as you did with all the other Icon meta text. We are currently investigating how this could happen. Uwe On 12/22/08 15:17, sophie gautier wrote: Hi Clayton, Uwe, Could we have an update on this issue, do we have to translate the string or not ? Thanks in advance Kind regards Sophie Subject: Re: [l10n-dev] work-in-progress? From: Pavel Janík pa...@janik.cz Date: Mon, 15 Dec 2008 13:28:04 +0100 To: d...@l10n.openoffice.org To: d...@l10n.openoffice.org CC: Frank Peters f...@sun.com, u...@openoffice.org Hi, On 15.12.2008, at 13:24, Olivier Hallot wrote: image id=img_id3152980 src=res/commandimagelist/sc_framedialog.png width=0.566cm height=0.566cmalt id=alt_id3152980{ENTER ALTERNATE DESCRIPTION HERE}/alt/image I was just about to write the same question. The string was Icon before and I used Emacs amcro to translate all of them by one keyboard shortcut. The question is what to do with them now. Frank, Uwe? - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org -- u...@openoffice.org - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
Re: [documentation-dev] Trying out some ideas for reworking the main Documentation Wiki page
On 12/08/08 15:49, ccornell - OpenOffice.org wrote: Thank you and Frank for this :) I didn't noticed the More... link at first sight, I think the first reaction is to click on the more prominent link, so I for myself, prefer the first proposal you made with less to read at the first look. However I really like the hidden text blocks. I'll try to make a proposal tomorrow. I've tinkered a little with the layout Frank came up with and put it here: http://wiki.services.openoffice.org/wiki/Talk:Documentation/testpage (larger fonts, shorter descriptions etc.) Maybe this will help with making it clear there is a 'More...' link. Converting it to the original idea is not really possible with the extension. There are limitations to how the information can be displayed, and linked. Once we find a way of presenting the info for the Doc project in a way that makes sense, we can start to look at how we can categorize and group the information we have. For now, the links/topics/resources are more an indication than final group/topic proposals. - Can we (should we) use different icons for different topic types (using the OOo Galaxy icon style/set)? - Who are the people looking for info? The audience? - What are the high level tasks that we can use for grouping topics? - What books and content do we actually have? Hi, this really looks great. However, I would like to rearrange the links a little bit: - remove the artificial split up between Topics and Resources. Users who want help and information don't care if they get help from a topic or a resource information source. - clearly divide the information sources between User Help and Developer/Admin Help. The links to developer/admin information only distract normal users from finding help. - Add a highly visible link to How to improve the help. This is a Wiki at all, and we want the user to participate and share. - No normal user should need to scroll down to find the most often wanted help information. No user should be urged to read one and a half column of links and text until he/she finds the FAQ or the How Tos. - The link to Forums currently doesn't work. An additional link to the mailing lists main page should be added. - The link names and the descriptions should contain the terms that user are used to search when they want help. For example, user who search the manuals don't find any manuals now. They are named different - but how? Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Help Local and Internet
Hi, On 11/18/08 11:06, Cor Nouws wrote: Hi Frank, Frank Peters wrote (18-11-2008 10:11) At the OOoCon I was in a small group with some ideas about it. The project is on hold, there were some ideas but we came against some obstacles, both technical and legal that needed to be resolved. If I find some time, I'll write it up and post it to the alias, maybe you have some ideas how to overcome the obstacles. Might be, if I know them .. So, basically, it is desirable to connect application help and help content living online but we haven't found a solution yet. The ideas we were talking about: - choice for user to install local Help or not (just because people like to work offline as well); - when local Help is available: offer extra online as choice (if available); - when no local Help is available: of course offer online the main technical challenges to get the OOo Help online may be these: current Help is context-sensitive in multiple ways: it knows the application or module (as Writer, Calc, etc) in which you are, it knows the OS platform, and it knows the current menu command or icon or dialog box for which you want help. We need a way to pass this information to the online files. current Help files use a lot of inline switching to display different contents with respect to the user's OS, the current module, and the OOo versus StarOffice software. We must decide how to map these differences to the web based files. current Help files are extensively tagged with additional information, most important are the paragraph_id numbers: all contents are to be exported and re-imported to some translation tools. to assure easy community collaboration, the online Help should be available on the OOo Wiki. But we have no automatic processes yet how to export and import contents to the Wiki and back to the installed files, conserving all the tags. And there is no decision what happens when a translated version gets updated - currently the translation of Help contents is a one way from English to other languages. Just to name a few difficulties. Any ideas are welcome. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] New Member!
On 11/12/08 17:15, Shampa Bhattacharyya wrote: Hello All, Just joined OOo documentation team! Being technical writer for the past three years I never had an opportunity to work on open-source documentation. Though new to OOo I am eager to learn and extend my help in any of the documentation project. Please free to drop a line and I would be happy to help you. hi Shampa, welcome to the documentation project! As you may already know, we try to use the OOo Wiki http://wiki.services.openoffice.org/wiki/Documentation as much as possible for our documentation. This way every user can add to the docs or edit existing docs. Just register your name to the Wiki to get write permissions automatically. At the main page you will see a link Look here to see a list of pages that could need your help!. If you like to do some proofreading of real books in PDF format, or to write any missing chapters, you can click the DRAFT User Guides for OpenOffice.org 3.x link. Always come back to this list for questions or some chat about documentation issues. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] PING Clayton (or anyone): Question about Contributor's 101 page
On 10/28/08 09:27, ccornell - OpenOffice.org wrote: On 10/28/08 02:10 AM, Jean Hollis Weber wrote: On this page http://documentation.openoffice.org/contributing.html at the bottom is this statement: Once you have received Developer status, you will need to get CVS access. This page has links to FAQs on the subject. The instructions need to be consolidated and rewritten. ... http://www.openoffice.org/docs/ddSSHGuide.html (the one Alex linked) is the only doc I know about that explains SSH and CVS access. C. with all code developers having switched from the old CVS to the not so old SVN Subversion system, it might be appropriate for the documentation developers to also switch to SVN. http://wiki.services.openoffice.org/wiki/OOo_and_Subversion Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Some menu changes planned for OOo 3.1
Hi, On 10/20/08 17:31, amaloney wrote: Uwe Fischer wrote: some authors of OOo documentation may have read or missed the following discussion in the [EMAIL PROTECTED] list. Max, who is a very respected code contributor (we all must thank him for the fine new notes in Writer) wants to change the names and positions of some odd menu entries: Would it be possible forOOo 3.1 to have two menu systems and provide a switch in Preferences for one or the other of them? (Please don't laugh. I'm not a programmer.) certainly it would be possible to have numerous switchable menu systems. Certainly not for 3.1, because the feature freeze for 3.1 is in about four weeks. http://wiki.services.openoffice.org/wiki/OOoRelease31 But imagine the nightmare to describe OOo in documentation, or to support OOo users, if you can never be sure which menu system the user has enabled. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Some menu changes planned for OOo 3.1
point-of-view. Best regards, Gabriel Gurley Author, A Conceptual Guide to OpenOffice.org 3 Quoting Uwe Fischer [EMAIL PROTECTED]: Hi, some authors of OOo documentation may have read or missed the following discussion in the [EMAIL PROTECTED] list. Max, who is a very respected code contributor (we all must thank him for the fine new notes in Writer) wants to change the names and positions of some odd menu entries: http://ux.openoffice.org/servlets/ReadMsg?list=discussmsgNo=2360 or read http://wiki.services.openoffice.org/wiki/MinorMenuAdjustments for the facts without discussion. This is certainly a welcome change, but it may have quite an impact on existing or new documentation. What do you - as the authors of OOo 3.x documentation - think about the changes? Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Winning doc - where to find?
On 10/09/08 12:12, Uwe Fischer wrote: Hi, there was a Community Innovation Program contest, and several winners from the Documentation category were announced. Congratulations to all winners! But now I'm trying to find the winning documents somewhere. Even Google did not help much :-( Where can I find and read the winning document: Dmitri Popov, “Sun Report Builder User Guide.” found some info here: http://www.linux.com/feature/149916 Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Documentation of native language specialities
On 09/28/08 00:43, Jean Hollis Weber wrote: Uwe Fischer wrote: do you think we have enough documentation about using OOo in different languages, writing systems, locales? ... Jonathon Blake wrote a document titled OOo in a Multi-Lingual Environment, but I don't know where the latest iteration is located, or indeed if Jonathon has updated it. An older version, for OOo1.x (.sxw files) is on the OOoAuthors website. http://oooauthors.org/en/members/tutorials/multilingualooo/folder_contents A note from Jonathon on the [users] list, dated 19 Aug 2008, says it is the most recent publicly released version... written for... OOo 1.1.4. thank you, Jean, for your reply. I could download the OOo_MLE.sxw document by Jonathon Blake. That's a full 503 pages compendium with really a lot of information for OOo 1.1.4. Great effort to put all those bits together. It's possibe that a lot of that information is outdated now, after three and a half years from the last edits. When updating the info, it would be wise to do that on the OOo Wiki, so that later updates and additional information can be added easily. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Pssible bug in OLH
Hi Cor, On 09/26/08 08:51, Cor Nouws wrote: In Writer choose Tools|Options|OOoWriter|Compatability. Now choose any of the options and click Help. The info explains the setting from StarOffice 6/7 with OpenOffice.org 3.0. The problem is OpenOffice.org 3.0 : the options have changed in comparison with OOo version 2.x. Known issue? (StarOffice 6/7 can be a mistake in our Dutch localization. That is not my concern ATM.) I don't know of any changes of the compatibility options from OOo 2.x to 3.0. May be you wanted to write the options have NOT changed in comparison with OOo version 2.x. In the help source file, StarOffice 6.0/7 is a fixed string, meaning that old .sxw format. For the other newer versions, we use the variables that are filled in by the user's Help Viewer on runtime: In text documents created by %PRODUCTNAME %PRODUCTVERSION, the new tab stop handling is used by default. In documents created by %PRODUCTNAME prior to version %PRODUCTVERSION, the previously used tab stop handling is applied. That was correct for some time. The compatibility options were introduced to versions of StarOffice 8 and OpenOffice.org 2.0. The prior versions have been StarOffice prior to version 8 and OpenOffice.org prior to version 2.0. So in that time the variables gave the correct strings for the help text. You are right to comment that it is no longer correct for OpenOffice 3.0 or StarOffice 9, because now the %PRODUCTNAME prior to version %PRODUCTVERSION can be read as including StarOffice 8 and OOo 2.x. Thank you for pointing this out. So the right string would be something like this: In text documents created by your current version of Writer, the new tab stop handling is used by default. In text documents created by Writer versions prior to StarOffice 8 or OpenOffice.org 2.0, the old tab stop handling is applied. I'll change the text source asap. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Documentation of native language specialities
Hi, do you think we have enough documentation about using OOo in different languages, writing systems, locales? The application help just covers the very basics. Look for the index word CTL in the installed help, for example, or search for Asian keyword. This certainly is not sufficient information if someone wants to know how to write in different writing systems. Let's say you want to provide a booklet with a list of similar proverbs in English, Chinese, and Hebrew. How? Where to start? When I search the OOo Wiki or the manuals, I cannot find much help, too. Together we can change this. That is, if we agree we need that information. What do you think? Some random thoughts in the OOo Tips 'n' Tricks blog: http://blogs.sun.com/oootnt/entry/speaking_in_tongues_writing_in Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://documentation.openoffice.org/ http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt http://user.services.openoffice.org/en/forum - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Have you installed OOo3 on Windows?
Hi, Jean Hollis Weber wrote: I've noticed that when I install OOo3 on WindowsXP, the installer does not show the file associations page. Is this a change from OOo2.x, or is it something to do with my setup? (I'm not doing a clean install of OOo3, because I'm keeping OOo2.4.1 on the machine as well; I also have MSOffice2000 on that machine.) currently there are only Beta versions of OOo3 available. The Beta builds from Hamburg do not install with any system integration. This should enable Beta testers to install and remove the Beta without any side effects on existing programs. see http://blogs.sun.com/GullFOSS/entry/system_integration_for_ooo_3 Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Have you installed OOo3 on Windows?
Hi, Uwe Fischer wrote: Hi Jean, Jean Weber wrote: Thanks, Uwe. Does this mean the file associations page will be in the installer when the program is released? I just want to know what to put in the user guides! :-) I remember a recent discussion somewhere - sorry, cannot find it right now. Must ask some people. I'll come back soon with an official statement. now I've found a link to the specification: http://specs.openoffice.org/installation/filetyperegistration/foreign_file_type_registration.odt This seems to be not linked from the specs.openoffice.org page, so I couldn't find it. So there will be no File Type Association page any more. Sys admins and other experts can add parameters to the Setup.exe program if they need so. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] No extended tip for View Notes
Hi, Jean-Baptiste Faure wrote: There is no extended tip for the menu View Notes in Writer. this new command will be documented in the next release of OOo. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Sample 2-column layout for onscreen PDFs
Hi, Jean Hollis Weber wrote: I've done a quick-and-dirty sample of a 2-column layout for producing PDFs instended for onscreen reading. Text font size increased to 13. No indentation from column margin. Other tweaks would improve it. ... Would appreciate some feedback, especially from those of you who mainly read PDFs onscreen rather than printing them. Later today I will put the test PDF on one of my machines with a smaller screen size and see how it looks to me. --Jean it is a wonderful idea to publish PDF files for onscreen viewing in a landscape format. I like that format onscreen. It can be discussed whether one column or two columns are better. My feedback: Please get rid of the break in the page numbering for all documents that will be read onscreen. It is frustrating to see that a page has the number 15 printed in the footer while the Acrobat reader displays that you are on page 18. You never know which is the right page number that you must enter in the Go To Page Number field of the reader software. Onscreen documents should always follow plain page numbers from 1 to the end to avoid ambiguities. Onscreen there is no need to start page numbering with anything other than number 1 for the title page. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Are there any volunteers to work on How To documentation issues?
Hi, many issues exist for subcomponent How To, owner [EMAIL PROTECTED], most in the state new, submitted in 2004. http://www.openoffice.org/issues/buglist.cgi?issue_type=TASKcomponent=documentationissue_status=UNCONFIRMEDissue_status=NEWissue_status=STARTEDissue_status=REOPENED I would rather like to close them all. Or are there authors to work on those How Tos? The main site to publish the How Tos would certainly be the Wiki: http://wiki.services.openoffice.org/wiki/Documentation/How_Tos Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Re: [authors] [Fwd: Translation of German PDF Export Guide into English wanted]
Hi, thank you, Martin, for volunteering. Tell me how I can help you, if needed, I will be happy to do so. The text that is attached to the issue 73884 obviously is already in the OOo Wiki at http://wiki.services.openoffice.org/wiki/Documentation/DE/How_Tos/Export_in_das_PDF_Dateiformat So the English translation can be performed without format conversion troubles. You may add [[en:the name of the English page]] to the German Wiki page and add [[de:Name der deutschen Seite]] to the English page. This should automatically show a Language box like that one on the Main Page. (Currently, Language box links to any German pages are disabled, but links to other languages should work) Uwe Jean Hollis Weber wrote: Hooray for Martin! I was hoping you would volunteer. :-) --Jean Martin Fox wrote (on the Authors list): Dear Jean / Uwe have you been overwhelmed with volunteers yet? If not, I could have a go at it. regards from a beautiful spring morning in the central Alps of Switzerland Martin On Tue, 06 May 2008 08:47:51 +1000 Jean Hollis Weber [EMAIL PROTECTED] wrote: Forwarding in case someone here (who is not on the docs list) might be able to help. --Jean Original Message Subject: [documentation-dev] Translation of German PDF Export Guide into English wanted Date: Mon, 05 May 2008 13:54:20 +0200 From: Uwe Fischer [EMAIL PROTECTED] To: dev@documentation.openoffice.org Hi, in issue http://www.openoffice.org/issues/show_bug.cgi?id=73884 andreasma submitted a guide in German language about exporting to PDF. This is well worth to be translated into English and then published on the Wiki, for example. Any volunteers? Uwe - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Wrong link in the how-to Adding more language
Hi, sophie wrote: Hi all, The link [1] that is indicated in the section 4 of the how-to Adding more language [2] is not the good one, this one is listing the available dictionnaries. Thhis should be this link [3], but all the language packs are not available and there is no place (I think) where they are listed else than in QATrack. Another solution, may be, could be to link to the NLC project, where the corresponding language packs are made available through the download page of the project. Kind regards Sophie [1]http://oootranslation.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ [2]http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Adding_More_Languages [3]http://oootranslation.services.openoffice.org/pub/OpenOffice.org/localized/ I copied this information to the Discussion page of [2] Feel free to edit the main article as you think it is appropriate - that's why it is on a Wiki. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] spaces and punctuation
Hi, Ain Vagula wrote: I have one suggestion for OLH. Please keep starting and ending spaces and ending punctuation outside of tag content. Example: Bad: Click emphOK /emphto do something. Good: Click emphOK/emph to do something. thank you for your suggestion of cleaning up tags. I can find one occurrence of OK./emph and three OK /emph in the current source files. These aren't easily visible in the development environment using StarOffice 7 plus *.xhp filters, so it is good that you pointed at this. They are changed now in CWS hcshared18. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] External link in HC2 - specs
Hi, sophie wrote: Hi Frank, Sorry for the delay, Frank Peters wrote: Hi Sophie, In the second handoff of l10n, swriter contains a link to the specs [1]. Sorry to come again with that, but there is no licence on the specs, so are we allowed to translate the relevant content in the wiki or what would the better way for you to localize this spec? I'm also aware that specs are sometime modified, but I don't know how we can track these changes too. I checked and these links are all in comments comment.../comment and don't need localization. Have we never before come across the comment tag in helpcontent or was this always translated? I'm sorry, but I don't see this comment .../comment tags in my .po file : #: 04090002.xhp#par_id5189062.help.text msgid For example, when you are in a chapter 1, subchapter 2, subpart 5, this may be numbered as 1.2.5. When you insert here a reference to text in the previous subpart \1.2.4\ and you apply the \Number\ format, then the reference will be shown as \4\. If in this example the numbering is set to show more sublevels, the same reference will be shown as \2.4\ or \1.2.4\, depending on the setting. If you use the \Number (full context)\ format, you will always see \1.2.4\, no matter how the numbered paragraph is formatted. You can see illustrated explanations (and information on migration from and to previous software versions) in the link href=\http://specs.openoffice.org/writer/numbering/ May be they have not been exported? I've never came across those links before, won't they appear in the localized help? Thanks. I'm interested in being able to translate the content of the specs because of the migration explanations it contains. Kind regards Sophie I decided to insert this link to the specification document because it contains a good explanation of the more esoteric inner workings of this new feature. This explanation for sure is helpful to those users who really need to understand all of it. But this explanation is far too much information for the normal user who just wants to use the feature as it is. In former times we would have written all that info into the Help. Now we need to care for word count, both because it is expensive to translate and because too many words are distracting for users that are looking for a short and easy 1-2-3 help. So if some volunteer wants to translate the info from the spec, why not copy the info to the OOo Wiki first and then translate on the OOo Wiki? I can change the link in the Help then to point to the Wiki. And there are hundreds of other specs at specs.openoffice.org with more valuable information (well, some of them). Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] OpenOffice.org Help - Getting support
Hi, Martin Hollmichel wrote: Hi, I just noticed that in Getting Support in the OpenOffice.org Help there is just a link to www.openoffice.org instead of support.openoffice.org. I'm afraid we are loosing many users on the way from www.openoffice.org to support.openoffice.org and get their support they're asking for. Is this something we can fix ? changed the link as suggested, in CWS hcshared17. We could also try to improve the www.openoffice.org web page - the Support link is not really visible, but hides inside an ornamental color bar with some text. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] External links in HC2 files
Hi, Frank Peters wrote: Hi Sophie, Working on the HC2 l10n of 3.0, there is some blog links (to OOo TNT if I remember well :) inside to give more help on special features. Those blogs entries are great of course, no question here, but very difficult for us to localized, where the wiki page links gives no problem. For a quality matter, could it be possible to find a solution that allow us to have only localizable links inside HC2 files ? Or are allowed to translate the blog content to put it on the wiki (what is the licence) and wouldn't that break the file if the links are different ? ... Uwe, maybe we should do that with some of the tips anyway (moving them to the wiki as FAQs or Howtos)? Currently I only see 5 occurences of links to the OOo blog: 2 in /text/swriter/guide/spellcheck_dialog.xhp 2 in /text/shared/optionen/01010400.xhp 1 in /text/shared/guide/language_select.xhp For the 5 occurrences above, should Uwe move them to the wiki and change the links (we have one more chance to change that before OOo3 deadline). what would be the correct place to copy the blog entries to? For example, the blog entry http://blogs.sun.com/oootnt/entry/adding_more_languages_to_ooo obviously belongs to http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/FormattingText But there are already some FAQ entries which cover the blog topic in parts or that are closely related. Just copying the blog entry would not look good. And the whole page is to be divided into separate pages anyhow. And I don't like the idea that the entry I'm linking to from the application help will be changed by someone who doesn't know it is referenced from a certain application help page, may be adding some special developer info to a page that is aimed at the beginner user, or deleting some paragraphs because they can be found at another place, and so on. And translators would not want to translate such a whole long page like http://wiki.services.openoffice.org/wiki/Documentation/FAQ/Writer/FormattingText just because a link exists to one subtopic. So I would like to have separate pages for all the FAQ topics first. Then I can easily copy blog pages to the Wiki and mark them as this is linked from the application help - please do not change it too much. And I would like to have the time to read through all the FAQ pages and insert links to them from the application help where applicable. But then, we plan to publish the application help pages as Wiki pages anyhow, so where is the benefit? May be this: the application help *must* get translated, no matter if on the Wiki or not, while the other Wiki pages *can* be translated. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Book Review page needs some caring hands
Hi all, scanning through old and open documentation issues, I found this one: http://www.openoffice.org/issues/show_bug.cgi?id=24022 Obviously this is a project to be cared for, so that the current page http://documentation.openoffice.org/book_reviews/books.html can get populated and then linked from the OOo main page some day. What do you think? Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] wiki organisation , docs and native language
Hi, sophie wrote: Hi Alex, all, Alex Thurgood wrote: Frank Peters a écrit : Hi Frank, - Switching languages in the wiki should be an easy thing provided we agree on one common schema: o the localized pages sit in a defined hierarchy so URLs to switch languages are easily generated automatically o the localized pages need to have the same names. With the new MW version (which we currently test and hopefully implement soon) it will be possible to still use localized *titles* to show up. Just the URL is the same (except for the language identifier). That's about all we need. If we implement a language bar as template a user would be able to o switch to another language with one click o instantly see if a localization is available or not, and if not, start localizing right away o add languages easily by just adding them to the template I personally agree with this approach. It makes for something very systematic, simple and user friendly. If I want to see something in EN, FR, DE, or ES or JP or ZH all I'd have to do is switch those letters in the URL to get the corresponding (or not yet translated) document. I agree also with you and Franck, and I think the wiki is a good tools for our documentation purpose. I'll see to draft something and send it out to NLC for discussion after I returned (I guess I promised that several times before, bear with me...) Well there's a discussion ongoing in the French NLC doc project, because as you can imagine, following a schema that you have outlined here would require us to change a lot. Unfortunately, there appears to be no general consensus as yet. Yes, and we have to get to a concensus quite quick now, because more and more link are pointing to the wiki in the OLH. One of the fears is that a French lambda user, who couldn't care less about docs in other languages, would find themselves faced with lots of links leading nowhere, or to a document in English only, and thus would lose interest in the doc site as a valuable source of information. While I don't share this fear, I can understand it. I imagine that it could be very frustrating indeed. The issue is also that, if you're looking for help pressing F1 in the product, it's because you need it right now for the task you're doing. It's different than going to the documentation site because you want to learn about a fonctionnality or a task. You'll be less frustrated if you find only English help in the last case. Another point made was that such a schema would automatically make all our docs redundant overnight, since we would be forced to rewrite everything to conform to a given baseline documentation, no doubt written in English. I tend to disagree here too. I think that the whole point of setting up a system like the wiki for the doc project is to allow for creativity from the various language groups to become visible in a single place, thereby furthering exchanges with other groups and stimulating people to translate the work of others. It recognizes that each language culture has its specificities, including the way in which computer software is used. For example, in Europe, we have different constraints for billing and invoicing (European Directives) than those used in the US (and no doubt elsewhere). This means that any documentation about say, the report generator, or Base module, that expounds on a billing system, would have to be adapted to suit each country's or region's own requirements. The French NLC doc project has created some general user documentation, of course, but some of it also reflects the way French people think in general, or are taught to think in school (cartesian thinking). This tends to display itself more in the way the documentation is written, than in actual content. I remember one of my former French bosses telling me that he couldn't understand how my thought processes worked because I wasn't cartesian enough, yet I came to much the same conclusions in my writings as he did :-) It also makes for a bit of a nightmare when you have to translate things from French to English, and I've been doing this now for nearly 20 years !!! Thanks for pointing that again Alex :) I don't think that we should rewrite everything just because it exists in English and we have quite the same in French. I think that this is up to the NLC documentation teams to evaluate what is relevant to translate, to rewrite or to adapt. The difficulty is to stay in harmony with the main documentation site and the links... Plus the new users forum will provide also documentation, all that have to be organized and linked in the best way for our users (and I remember Gianluca Turconi saying too much of a thing kill the thing ;). So we also have to take to not too much overload our users with material, if it's possible. Anway, enough of my prattling, I'm sure Sophie can fill you in with more details should you require them. Thanks for your prattling Alex,
Re: [documentation-dev] Help Style Guide proposal for Calc functions
Hi, Regina Henschel wrote: Martina Waller schrieb: My first approach was to look into the inconsistencies of the current help style. colon is mentioned in the other places because currently we have several cases where the Syntax and Example headings as well as the arguments are followed by a colon. That should change for reasons of consistency. Martina, then just change it :-) I have looked at the changes and found no quotes, except if they are literal =DATE(00;1;31) yields 1/31/00 if the cell format setting is MM/DD/YY That's such a point which shows the difficulties (and where my MM/DD/YY was bad). If you use quotes in normal texts everyone will understand it. But when mixed with syntax descriptions they are dangerous. For example in cell format codes you can also use quotes to include a text in the format, like € 0.00 I put it here on a new line to separate it from the text. The style guide must include a rule how to cite settings and other formal things, without using quotes. Are accessibility tools able to evaluate tags in the produced HTML code? In that case I suggest to use one of the HTML elements. HTML tag q or samp or code might be suitable. Such element can be bind to a style via css, which gives the element another text color or text style or font or background color or what you like to distinguish it from text. With such tags you can use different styles for normal and for high contrast. we should be able to write with style. Whenever we need a direct quotation within the text, we should apply a style (in Writer) or a tag (in XML) to that text. Workarounds like the following should be banned from the help: Enter ABC (without the quotes) ... Instead, the string to enter should be tagged in a way that survives all subsequent transformations. Readers must be able to see that the ABC has a special meaning, no matter if they read it in the help viewer, in a PDF, or using any translation tool. The currently used authoring environments fully support these tags. I'm not so sure about the currently used translation tools. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://user.services.openoffice.org/en/forum http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Authoring Help With OpenOffice.org
Hi Ariel, Ariel Constenla-Haile wrote: Frank Peters escribió: Hi Ariel, as you may all know, OpenOffice.org's Help system is going to be extended to support extension's help: http://wiki.services.openoffice.org/wiki/Extensible_Help http://wiki.services.openoffice.org/wiki/Extensible_Help_Project_Plan http://specs.openoffice.org/appwide/help/ExtensibleHelp.odt ... * as the doc. is from Feb 3, 2006, is it still true this sentence in chap. 4 Authoring Help With OpenOffice.org : You need OpenOffice.org 1.1.x to use the help authoring environment. The authoring environment also is not yet compatible with OpenOffice.org 2.0? Is it now compatible with OOo 2.3.*? No. The reason for that being that we developed and used that environment only internally at Sun and I had a hard time migrating that to 2.x since profound changes in macro handling and file format (ODF instead of SXW). So basically, for now we're stuck with this version. this is only needed when you want to do a lot of editing for existing help files. If you just need to edit or write a few paragraphs you can use any text editor. Preferrably an editor with some XML syntax highlighting and structural display. Ok, so I also downloaded OOo_1.1.5_LinuxIntel_install.tar.gz ... I guess it will look like from the stone age. I will give it a try - anyway I'm not afraid of writing XML ;-) the OOo 1 software with filter and macros is intended to hide the ugly XML from the authors of help text. As much as possible. For an occasional writer of an extension help it would be too much of an effort to setup that environment. Copy an existing xhp file to get the structure, then change the contents and save with another name. Use CVS to submit. That's much faster. The extensible help feature is brand new. Would you be willing to collaborate with us so we can see how the existing environment suits your needs or where it needs adjustment? I would be happy to provide you with any assistance that you need to get help files written for your extension. You count with the help I could give, just let me know how I can help. For testing how it works, I thought about extending OOo Base on-line help; see: http://dba.openoffice.org/servlets/ReadMsg?list=devmsgNo=3084 the current implementation of the extensible help does not allow to replace or delete existing help pages. You can only add new pages. I was starting to read/studying how to do this, I thought this is not yet implemented (it's meant for 2.4, I think). Is it ready to use in a developer build? It is CWS ab38 http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fab38 , not yet integrated, but should be soon. Uwe -- [EMAIL PROTECTED] - Technical Writer [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://wiki.services.openoffice.org/wiki/Documentation http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Finding related terms in the Help Viewer
Hi, when you go to the Find tab page of the OOo help viewer and search for captions, you get a list of pages where that word can be found. Additionally you also get pages where that word is not visible, but it exists only as an index word as in captions; see 'call outs' There are some more examples. For example, a user may try to find information about those frames around paragraphs, but the user does not know that we use the term borders for the lines around a paragraph. So we inserted the frames index word also on the help page about borders around paragraphs, although the word frame does not occur on that page. What do you think how can we make the invisible search words visible? Should we make them visible? They are inappropriate words to describe the contents of the current help page, they are only there to lead the user who does not know the right term to the correct help page. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Question
Hi Mark, welcome to the documentation list! Mark David Anthony Sr. wrote: I'm working on a documentation team for a software development company, and its a new position for me. We're using openoffice and knowledgetree. I have the need to do a concordancer-like search (like Adobe Reader does) across multiple directories for openoffice docs. I can do this for PDF's with Adobe reader, and with several other tools I have. But I don't have any tools that will do this for openoffice. The concordancer type results I'm referring to is where it doesn't just show you what documents contain a word or phrase, but brings back a list of every occurrence within every doc as a live link to that occurence in that doc. It also shows the immediate context of the term. You can run a search in Adobe Reader 7 or 8 to see what I mean. I don't know about such a software. It would be nice to have that. In lieu of that, my next question would be if anyone knows of a way to transform a directory tree full of odt docs into pdfs without having to open and print each individual file. There should be several solutions. One I found on Google is: https://www.ideals.uiuc.edu/wiki/bin/view/IDEALS/OpenOfficeConvert Hope you don't mind my posting this question in this forum, but it seemed to me that since I wanted some help from tech writers about openoffice, there wouldn't be a better place to do it. regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] some strings in OLH
Ain Vagula wrote: - in shared/01/06040100.xhp: Text will be replaced after you type a trailing white space (space, tab, or return). In the following table, the A and B represent text consisting of letters A to z or digits 0 to 9. ... I will replace those A to Z with ascending / descending Thank you for finding these strings Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] printed and/or online documentation?
Hi, Frank Peters wrote: Uwe Fischer wrote: The Sun Getting Started Guide does not fit in to OOo documentation. It was written months before the first release of OOo 2, thus it is very outdated. And it will be updated only when and if Sun marketing demands this. The included installation steps are for StarOffice only, they cannot be used for OOo. Does that mean that the Sun GSG contains *only* StarOffice-specific content? What if the Sun doc team helps working on the OOo GSG content and just keeps a smalldocument covering strictly SO specific content, like installation? The StarOffice 8 Getting Started Guide by Sun consists of an installation part and some short chapters to introduce the main modules. The installation part does not apply to OOo because it explains only the Sun proprietary setup program or script. The other parts are outdated. On the other hand, the OOo community has three types of documentation for new users: - a Setup Guide (about 51 pages, available in many languages, linked from here: http://documentation.openoffice.org/setup_guide2/index.html ) - a Getting Started Guide (about 260 pages, linked from here: http://documentation.openoffice.org/manuals/index.html ) The OOo Setup Guide is much better than the Sun Guide because complete instructions are given on the UNIX native install file formats. Sun decided not to do this for StarOffice to keep instructions simple. Some links in the guides look old (refering to version 2.0.2 for example) but they still work. There are no obvious cross-links from the Setup Guide page to the Getting Started page and back, so a user who has found the one page on the OOo Web site may not be aware of the other. To adopt the OOo Setup Guide to be usable for StarOffice would require to change all file and folder names. The resulting document would have almost the same size as the OOo document (there is no Mac version for StarOffice). (while exploring the documentation.openoffice.org site, I stumbled upon an installation.html page which looked good, but I cannot find it now. The Web site is so slow that it is a real pain to browse around there.) Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] analysis of competitor documentation
Hi, Ain Vagula wrote: Frank Peters wrote: There is an issue for the broken full text search engine. Development is aware of that and currently working on a reimplementation. http://qa.openoffice.org/issues/show_bug.cgi?id=45826 and http://www.openoffice.org/issues/show_bug.cgi?id=38553 and http://www.openoffice.org/issues/show_bug.cgi?id=61820 yes, they are aware since 2004, but not much progress :-( Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/online_help/index.html http://wiki.services.openoffice.org/wiki/Category:OnlineHelp http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Is there a case online help versus documentation?
Hi, it appears that a few people here (well, at least the co-lead of the doc project) think that the OpenOffice.org help that is installed with the program is not a part of the OpenOffice.org documentation project. I'm totally puzzled what makes people think this way. The so called online help that is installed with the program consists of several thousand files with several hundred thousand words of (we hope) helpful information for the user. The online help is part of the OOo code and is built the same time a new OOo program version is built. Everything in the online help creation and building process is as open and documented as the remaining program code is. Yes, it is more difficult to contribute to the online help directly than it is to just send an email comment, but that is something we (Sun and community members together) can fix. The authors of online help have always given links to all the necessary information (see my signature) and constantly help each and everyone who wants to be part of the documentation project. I only hope that this proposed dumping of our efforts is a big misunderstanding on my side. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Yet another fork
Hi, Jean-Francois Nifenecker wrote: Uwe Fischer a écrit : In my opinion, there is only one prominent place to add a link to *all* the existing places that offer templates and samples and macros and more - that is the OOo user interface itself. For example, the Templates and Documents dialog must show a link to a central Web page, which may be a Wiki page, so that everyone can easily add their own place to download templates there. Remember that, because of internal security policy, all users can't connect to the Internet from their PC at work. Therefore a visible link on the web pages is a requirement. The user could then go to the internet-enabled PC and download the files she'd install on her own workstation. you mean that some firewalls do not allow OOo to connect to the Internet and to download some files from there? OOo should be allowed to connect to the Internet, because it now has the new Check for updates feature, soon it will have the same feature for installed and new to be installed extensions, and more connectivity may come in the future. On the other hand, if a sys admin doesn't want to give Internet access to OOo, all that is lost is the ability to find some additional info and files in a comfortable way. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ http://documentation.openoffice.org/online_help/index.html http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Re: [online_help] guide for new chart wizard
Hi, Sophie Gautier wrote: Sorry, I didn't follow the entire thread, but here is a documentation that Tony Galmiche, the Chart project and me has written about the functionalities. http://graphics.openoffice.org/files/documents/12/3278/List_of_whished_enhancements_for_Charts.odt Issues are noted in front of each functionalities that are developped. May be it could help for the new help files ? thank you for the link to this document. For the Help files, we just started to add a new Help to the new Chart. We, that is Regina of the german OOo community, and me. The documentation issue is 60360, and we can discuss the issue on the [EMAIL PROTECTED] list. Kind regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ http://documentation.openoffice.org/online_help/index.html http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Yet another fork
Hi, Sophie Gautier wrote: Hi Ger, G. Roderick Singleton wrote: On Wed, 2006-11-29 at 21:00 +0100, Sophie Gautier wrote: Hi Ger, G. Roderick Singleton wrote: On Wed, 2006-11-29 at 08:21 -0500, G. Roderick Singleton wrote: Please see http://wiki.services.openoffice.org/wiki/Feature_-_Templates interesting concept but no content. ... I've read it more carefully and until the end, this time. I must say that it's a pity to see how our work (documentation project and NLC projects) is not respected :( The Wiki page authors named some OOo projects to be nearly dead or not worldwide known - and then they suggested yet another Web location for templates. In my opinion, there is only one prominent place to add a link to *all* the existing places that offer templates and samples and macros and more - that is the OOo user interface itself. For example, the Templates and Documents dialog must show a link to a central Web page, which may be a Wiki page, so that everyone can easily add their own place to download templates there. Clicking the link in the OOo dialog will start one of the following actions: 1. open the default Web browser with the above mentioned main Wiki page. 2. open another OOo dialog which gets its data from the Web. It shows all templates, for example, that have been approved by the community in some way, and then a click on a template will download, and install, and open it. Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ http://documentation.openoffice.org/online_help/index.html http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] What are the chances that anyone still uses the 1.x codebase?
Hi Scott, Scott Carr wrote: The instructions for that is still on the Templates area, and I am wondering if it would be safe to move or remove them from the page so there isn't any confusion with users. if this is about http://documentation.openoffice.org/Samples_Templates/ then that page needs some editing for sure. For example, the following sentence: The Samples and Templates area is broken up into two locations. These areas represent the directory stucture where the files should be placed. is no longer valid for OOo 2, and some of the directory names in the table are invalid, too. %OpenOffice.org%/user/template/ for OOo 2.0 is not a subfolder of the location you originally installed the OpenOffice.org suite, but it is a subfolder of C:\Documents and Settings\user_name\Application Data\OOo_folder_name or the respective ~/.OOo_name folder on UNIX systems. Only for %OpenOffice.org%/share/template/en-US this is still the correct folder. The two headings Templates and 2.x Templates look OK, because with an unpatched version 1 you can only use the version 1 templates, while with a patched version 1 or with version 2, you can use all templates. Regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ http://documentation.openoffice.org/online_help/index.html http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[documentation-dev] Getting into contact with Online Help authoring community
Hi, you are very welcome to find information about the OOo Online Help and to contact the Online Help authors: - Mailing list [EMAIL PROTECTED] for discussions about contributing to the Online Help - Blog http://blogs.sun.com/oootnt for browsing tips and tricks, just in case you have some spare time - Web page http://documentation.openoffice.org/online_help/index.html as a reference page for informations - Wiki http://wiki.services.openoffice.org/wiki/Category:OnlineHelp as easy to use online method to exchange information and to talk about the Online Help (if you do not prefer the mailing list) - Mailing list dev@documentation.openoffice.org as before, for topics that cover more documentation aspects than the Online Help alone. Regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ http://documentation.openoffice.org/online_help/index.html http://blogs.sun.com/oootnt - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Recruiting for on-line help
Hi Alex, see my answers inline Alex Thurgood wrote: Yep, good idea. I take it the db would be hosted by Collabnet ? Collabnet is a good choice. There may be other places, too. c) There is a database running on the server. The community maintains the database. When for example a Language Project has some new documents, the respective links will be added to the database. There might be a Wiki to simplify adding and editing the hyperlinks together with meta information about visible text, language, version, operating system. A script will update the database based on the Wiki information. This would be one way of making it IMHO easier for people to contribute, plus have the added advantage of a document presentation structure that could be inherent in the wiki front-end, so that at least the help entered via the wiki would have more or less the same 'get up'. in my first idea about the database and Wiki it looks like this: the database has records like help page ID, OS, language, version, link to document the Wiki is only to enable everyone to add a new document to this database, even without SQL and database access permissions. Just enter the data to a Wiki, which is a skill most people already know, and then a script will transfer the Wiki data to the database (may be after a moderator has checked that the document is really an OOo Help document of any value - but if it is not, then normal Wiki community social control will remove an invalid link soon) Database records: help page ID can be the unique path and name of the guide file from the installed OOo Help. Example sharedguidekeyboard for a link that will be visible in the See also... section of the file shared/guide/keyboard.xhp. OS the operating system info seems to be valid for some help documents, as for example the UNIX printer and fax and font guides which are of no use to a Windows user. language is the language of the linked document. link to document is the full http address of the document. In some cases this would not link to a document but to a Web page that the submitter wants to be shown first, for example with a copyright statement or an advertisement/promotional page. We should be open to such a redirection, but of course this can be discussed. Well, the French n-l doc project list has been pretty active already, and there are quite a few docs that could be entered into the system. However, I do wonder about selecting based on OS. Most of the problems encountered are OS-agnostic. The only real differences occur with things like installation, printing, fonts, and the like. As Sophie has pointed out, we try where possible, to make our docs platform independent or at least include relevant sections for each similar family of OS. It would be a shame to have to split them all up again. the proposed system should be flexible enough so that no one must split up or change any document that already exists. And it is open to any reasonable amount of additional documents that other users supply. I take it that there will be some kind of flag system when you enter the doc database that will enable you to set the search parameters you are talking about ? Is this what you meant by metadata ? the meta data comes into account when you do not use a link as stated above, but when you just have a collection of Help documents all inside one local folder. In this case we need any index data to quickly determine to which OOo Help page a certain document belongs. As the user-supplied additional Help documents in that local folder can be of any valid type (OpenDocument, PDF, HTML for example), it may take too much time to read the meta data from inside the documents' info. We would need one index file and a method to fill the data into this index file. Or we must define a filename mapping of the data, so a document with the name shared.guide.keyboard.all.US_en.odt in that folder can be identified easy to be linked to the sharedguidekeyboard Help page, to be valid for all operating systems, to be in US english language, and to be of OpenDocument file type. Alex Kind regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Recruiting for on-line help
G. Roderick Singleton wrote: Members of the project should be aware that Uwe Fischer [EMAIL PROTECTED] is recruiting on other lists such as dev@openoffice.org, OOoAuthors and [EMAIL PROTECTED] Please track down these messages if you want to get involved. Thank you, ger Looks like I have a bad habit of not posting on my favourite mailing list. I must apologize. Here is my mail again: Recently we asked for ideas on the OOo mailing lists how we can improve the installed Help of StarOffice and OpenOffice.org. One good idea was to add more links that point to external documents written by the community. Currently, at the end of many Help pages you find Additional information or See also ... sections. These links stay within the installed Help system, or they link to portal pages like documentation.openoffice.org which will work without page not found errors for quite a time. Given the ever changing availability of external documents with regards to version, operating system, and language, as well as their Web locations, a database approach seems to be appropriate. Now we want your feedback about the following proposal a) the Help Viewer already knows about the operating system, version, and language of the installed Help. Additionally, the user will be able to select additional languages to read external documents that are only available in those languages. And the user will be able to disable the Web search for additional documents, and to redirect the search to a folder on the local file system. One idea is to offer a drop-down list box with the main languages. The current Help language already has a check mark by default, and the user can select more languages. Enable external Web Help: (none) v english german french ...etc... Choose (none) to disable Web Help from the Internet. An additional check box locally installed documents can be enabled to display links to documents that are stored in a given folder on the hard drive. Every user can store own documents here, which must contain some meta information to be shown at the right location of the Help. b) The current Help page gets some additional entries in the More Information... or See also... section. These new entries are visible only if Web Help is enabled and if such help is available. If the Web Help is enabled and if the current shown Help page contains a link to the new Web Help feature, then the Help Viewer connects to the server over the Internet. The Help Viewer sends the following information: - the current Help page - the current version of the Office software - the current operating system - the selected languages for external Web Help The server evaluates this information. If any Web Help document is available for the current page (topic), version, operating system, and language, the respective link or links are returned. These links will be shown in the See also... section. The user can click the link to load the external document. If no suitable document is found, the server returns the following text: For this Help page we have no external document at this time. You may consider changing your langauge selection at Tools - Options - ...etc... Visit documentation.openoffice.org if you want to write an external Web Help document for the current topic. The server evaluates the Help pages and languages for which Web Help was asked. These data will be published periodically. The information helps to improve internal and external Help offerings. c) There is a database running on the server. The community maintains the database. When for example a Language Project has some new documents, the respective links will be added to the database. There might be a Wiki to simplify adding and editing the hyperlinks together with meta information about visible text, language, version, operating system. A script will update the database based on the Wiki information. This is what I propose. Now please let us discuss this concept. Give feedback if you want it in such a way and if you think it can be done. Then we need to find some community members who really do all the work. What do you think? Regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Recruiting for on-line help
Hi Sophie, Sophie Gautier wrote: Hi all, I'm answering between your lines : me too If any Web Help document is available for the current page (topic), version, operating system, and language, the respective link or links are returned. These links will be shown in the See also... section. The user can click the link to load the external document. Should we decide of a common file format ? my initial thought is that the system will open the linked document. So it doesn't matter if it is OpenDocument or PDF or HTML or some exotic ancient format like doc. On the other hand it would be good to open the external document within the Help Viewer. In this case it should be in HTML 3.2 format, because this is what we currently see there. But this approach may need additional changes to the Help Viewer, while just sending out the link should work right now. If no suitable document is found, the server returns the following text: For this Help page we have no external document at this time. You may consider changing your langauge selection at Tools - Options - ...etc... Visit documentation.openoffice.org if you want to write an external Web Help document for the current topic. Will this message be localized ? sure yes, great idea too. Will it be mentioned somewhere that this documentation is contributed the n-l projects ? I think this could attract more people to contribute to our documentation projects. yes, there should be a special heading preceding all external links. It can tell the user that the following links are external, will open a browser or PDF viewer, and that the community has written them and that the user can contribute, too. I'm recruiting people in the FR community in order to help (but you know it's vacation time...) Shall we use the script (allfiles.tree) that Frank Peters has done to help us debugging the localized OLH files as all the page files are referenced with it ? don't run too fast ;-) It's just a proposal at this time. Regards Uwe -- Uwe Fischer Senior Technical Writer Tel: x66756 Sun Microsystems, Inc. Tel: (++49 40) 236 46 756 Nagelsweg 55mailto:[EMAIL PROTECTED] D-20097 Hamburg http://www.sun.com/staroffice A: Because it fouls the order in which people normally read text. Q: Why is top-posting such a bad thing? A: Top-posting. Q: What is the most annoying thing on usenet and in e-mail? - - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] Documentation suggestion: Adding command lines to menus, toolbars, keystrokes
Hi, please find my comments inline marbux wrote: The OOo 2.x Writer Tools Customize dialog goes no further than WordPerfect and Microsoft Word have gone. There is room for improvement. All three apps make it fairly easy to assign product commands to menus, toolbars, keystrokes, and events (MTKI). But all three stop there and provide no easy and transparent means to assign command lines, e.g., launching a browser and opening a particular web page, launching a PDF user guide, running another external app, opening a specified OpenDocument file, etc. In each case, so nearly as I can tell, the user is left to write a script that performs the desired action, then assigning it to a MTKI. Moreover, context-sensitive Help for the Customize dialog offers no more guidance than to note that a macro must be written to perform actions other than invoking the displayed product commands. I admit that there is no guide giving precise steps for these tasks in the online help. However, almost no one ever asked for such steps in the last 10 years, so writing such a guide has no high priority. Given the current resources of online help writers, there is no real chance of improving this. The OOo community can help here, providing guides that give directions on how to perform the necessary steps in the right order. (I'm quite sure there already are such guides, may be on http://documentation.openoffice.org or on the http://www.oooauthors.org/ Web site.) When writing such a guide, keep in mind that OOo is being used at least on Windows, Linux, and Solaris platforms, and that starting external applications by a script is different on each platform. On Linux, it may be different even for distributions and X Window managers. So it is not an easy task to write steps that are valid for all users. You need some research which needs much time. You may submit an enhancement issue for the documentation / online help in IssueZilla. That is a show stopper for most users because of: [i] their lack of scripting skills; and [ii] their flight reaction when they see intimidating words suggesting they need to write a macro or script. So it would be better in the long run to submit an enhancement issue to improve the UI. The problem can be partially addressed by enhancing the Customize context-sensitive Help screen either: [i] to provide step-by-step directions for creating a simple macro to launch command lines with or without arguments; or [ii] to link to a new Help page that addresses that issue. Second best would be to build such information into the User Guide. Either or both are tasks that could be accomplished within the short term horizon. So another enhancement issue for the User Guide, which is maintained by the OOo community, would be appropriate. (If the information is not already there, which I don't know right now) Your feedback is welcome. True Regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] How to add an extended tip to a new UI element?
Hi, Gregor Hartmann wrote On 03/15/06 08:32,: Hi, Am 14.03.06, 16:10:21, schrieb Uwe Fischer [EMAIL PROTECTED] zum Thema Re: [documentation-dev] How to add an extended tip to a new UI element?: Hi, Ivo Hinkelmann wrote On 03/14/06 14:45,: Hi Uwe and Andras, I think there is a small misunderstanding. Andreas has a patch to modify helpcontent2 source file while Uwe is speaking about the StarOffice Product Patch mechanism. No, I did not. What I wanted to express is that it is not sufficient to supply a patch file for a *.xhp file to see the changed content in the help. Instead, the help must be compiled as part of the overall office OK but why is it not sufficient to supply this patch in a bug so it can be applied and committed to CVS. It is already a change to the xhp file so there is really no other process needed or am I wrong. And remember not everybody has CVS commit rights. to change something in OOo including the online help, for normal users it is the recommended way to submit an Issuezilla issue and attach the files. (Power users may just go ahead and change the sources on one of their CWSses.) I already gave that advice. But this would only work if the submitter wants the changes to be generally available. As I understand the first mail from Andras, he might want to supply the change only for a more restricted or private audience. But that may be only my misunderstanding. So if the new feature should be available to all users of OOo and StarOffice, it would be best to submit the feature using Issuezilla. If the feature gets integrated to the software, we at the Documentation team will supply the online help - and we would be happy to get the necessary information from the developer in an issue, too. This way Sun will take care (and pay) for the translations into all major languages, too. build. Frank gave most of the info you need to know (unfortunately not all the info) in his HelpAuthoring.pdf manual on documentation.openoffice.org - see http://documentation.openoffice.org/online_help/HelpAuthoring.pdf this link unfortunately is broken. It is also used several times on http://documentation.openoffice.org/online_help/index.html I submitted http://qa.openoffice.org/issues/show_bug.cgi?id=63197 Grüße Uwe
Re: [documentation-dev] How to add an extended tip to a new UI element?
Hi, Ivo Hinkelmann wrote On 03/14/06 14:45,: Hi Uwe and Andras, I think there is a small misunderstanding. Andreas has a patch to modify helpcontent2 source file while Uwe is speaking about the StarOffice Product Patch mechanism. No, I did not. What I wanted to express is that it is not sufficient to supply a patch file for a *.xhp file to see the changed content in the help. Instead, the help must be compiled as part of the overall office build. Frank gave most of the info you need to know (unfortunately not all the info) in his HelpAuthoring.pdf manual on documentation.openoffice.org - see http://documentation.openoffice.org/online_help/HelpAuthoring.pdf The hid.lst lists in the helpcontent2 module needs to be updated. The current hid.lst is created during the build in the instset_native module. There is ( must be? ) some sort of magic scripting that Frank Peters use to update the various hid.lst list in the helpcontent2 project from that fresh created hid.lst . This is the part from HelpAuthoring.pdf that is currently missing. Regards Uwe - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] How to add an extended tip to a new UI element?
Hi Andras, Andras Timar wrote On 03/04/06 23:18,: Hi Uwe, Thanks for your answer. Uwe Fischer írta: as far as I know, the online help currently cannot be patched in this way. Online Help is built from the xhp source files as part of the general OOo build process. Several index files are created by the tools to get a working online help. You can find some information on http://documentation.openoffice.org/online_help/index.html I patched the source (helpcontent2/source/text/scalc/01/12030200.xhp) and rebuilt the helpcontent2 module. Please find my patch in my original post. I would like to solve this at the source level of course. I did the following: The patch in issue #26565 added a new checkbox to the Sort - Options dialog tab (RID_SCPAGE_SORT_OPTIONS). This new checkbox was the Enable natural sort option (BTN_NATURALSORT). Therefore I added a paragraph to helpcontent2/source/text/scalc/01/12030200.xhp with an ahelp hid=SC:CHECKBOX:RID_SCPAGE_SORT_OPTIONS:BTN_NATURALSORT tag in order to have an extended tip for this new checkbox. However, this extended tip did not appear. The extended tip of ahelp hid=HID_SCPAGE_SORT_OPTIONSSets additional sorting options./ahelp appeared instead. I launched OOo with HELP_DEBUG environment variable set. For the Enable natural sort checkbox I got this debug string scalc - 956449812 - 58874. The number 58884 is HID_SCPAGE_SORT_OPTIONS according to help_hid.lst. The number 956449812 is not in help_hid.lst of course, because this must be BTN_NATURALSORT which is new. Other checkboxes in this dialog page did not have double IDs, they had only one. I would like to know why. Do I have to add the BTN_NATURALSORT somewhere else, too? I have my builds at http://ftp.fsf.hu/OpenOffice.org_hu/devel/OOB680_m5/ I will file this issue of course but the natural sort patch is targeted to OOo 3.0 and we have plenty of time before it. I would like to solve this problem sooner. currently we are working on a solution to enable developers to supply patches to the online help. This is not quite easy, but it should be fixed within PP4 timeline (in autumn this year). You may contact Ivo.Hinkelmann @ sun.com for discussion of this topic. Kind regards Uwe -- Uwe Fischer Senior Technical Writer Tel: x66756 Sun Microsystems, Inc. Tel: (++49 40) 236 46 756 Sachsenfeld 4 mailto:[EMAIL PROTECTED] D-20097 Hamburg http://www.sun.com/staroffice - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] online help fixes
Hi Ain, Ain Vagula wrote: What are reasons, that OLH fixes are integrated so rarely? I'm going to write about this very urgent problem for community translators into CC agenda, but at first I want to hear what you have to say. I'm sorry to hear that community translators are not happy with the current priority handling of fixed Online Help issues. The SO documentation department is not happy with the current situation, too. We already have discussed this situation here and found some ways to solve the problems. The main two solutions are these: - From now on, we will only work on small and short-lived Help CWS (child work spaces), which should insure a more timely integration. Mean time between help CWS integrations will be less than 4 weeks now. - We have found an agreement with QA (quality assurance) that from now on we will test and verify many issues within our team, so that QA need not spend so much of their precious time. This should speed up Help integration in the near future. Kind regards Uwe -- [EMAIL PROTECTED] - Technical Writer StarOffice - Sun Microsystems, Inc. - Hamburg, Germany http://www.sun.com/staroffice http://documentation.openoffice.org/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [documentation-dev] OOo Base Help files
Regina Henschel wrote: The help files are all translated. But often the translation was so bad, that we started a review of the help pages (until now more than 80 issues, see issue 51810 for reference). But I found in the module Base, that the errors are not in the translation but in the English text. I found about 20 pages which refer to the old UI of 1.1.5. So I decided to wait till the English help pages are adapted. If you start with the base Welcome-page by switching the option in the combobox to Base, then you will get a few adapted pages, but when you start from the content tab, you will get very often pages, that refer to the old UI. Hi Regina, the translated online help pages are always several weeks or even months behind the current english source files. The reason is that the files get translated to all languages by external vendors, and we do not send them new files every day, but collect the files for batch processing. So, sometimes the translations are outdated and not correct for the new, changed UI, which does not mean that the translations are bad as such. We just have to wait for them to catch up. Unfortunately, the time deadlines for UI freeze, translation handover, and releases sometimes do not match perfectly with the time needed to do the translation work. The english source texts that still refer to the old UI are there because we had no time to do a major overhaul of the Base help. So we just added the new path to the new UI guides. These are the pages you see when you start from the Base Welcome page. We did not delete the old files because they contain a lot of links and Help-IDs, and we had no time to redistribute the Help-ID texts (for the bubble help) and to crosscheck everything. Sorry for that. But the old files have been translated years ago anyhow, so there should be no unnecessary work for translators due to this decision. Kind regards Uwe -- Uwe Fischer Senior Technical Writer Tel: x66756 Sun Microsystems, Inc. Tel: (++49 40) 236 46 756 Sachsenfeld 4 mailto:[EMAIL PROTECTED] D-20097 Hamburg http://www.sun.com/staroffice - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]