Re: [libreoffice-documentation] How to spell "CustomShape"
Hi Rafael, Rafael Lima schrieb am 02.06.2022 um 19:56: Hi Regina, In ODF 1.3 part 3, section 10.6 the term "Custom Shapes" is used to describe the element . So I believe you could use "Custom Shape(s)" to write this guide. It would be suitable from the standpoint of developers. So you mean a sentence like the following would be OK? Many Custom Shapes have handles to alter the geometry. Would it be clear that the part "Custom Shapes" should not be translated? Using "custom shape" with lower case would surely be translated to "forme personnalisée" (fr) or "benutzerdefinierte Form" (de), for example. Or do you have an idea how to write something similar to "Fontwork-shape" or "Isosceles Triangle"-shape? Or so ? Many "Custom Shape"-shapes have handles to alter the geometry. Or using a style to make clear that "custom shape" is a technical term? Italic for example? 'Small capitals' seem to be not available in the Wiki. Kind regards, Regina Regards, Rafael Lima On Thu, Jun 2, 2022 at 11:52 AM Regina Henschel wrote: Hi all, I'm going to write a Wiki page about CustomShapes addressed to developers. Text therein will be for example: 1 What is “CustomShape”? “CustomShape” is a technical term and does not mean “made by the user”. But “CustomShape” is the umbrella term for those shapes, which have an enhanced geometry. These shapes are written as element in the file markup in ODF format. Many of these shapes have handles and shape specific glue points. For all of these shapes and only for them the tool “Toggle Extrusion” is active in the UI. Looking at it allows to quickly distinguish a CustomShape from other kind of shapes. We have already page https://wiki.documentfoundation.org/Development/Remarks_on_Fontwork_and_TextWarp There the spelling "custom-shapes" is used. The Draw guide has "custom shape" in chapter "Text callout". In the style dialog in the UI we have on tab 'text' the wording "Custom Shape Text". I am looking for a spelling that makes clear, that it is a technical term for a kind of shapes and that "custom" in this context has nothing to do with "user". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] How to spell "CustomShape"
Hi all, I'm going to write a Wiki page about CustomShapes addressed to developers. Text therein will be for example: 1 What is “CustomShape”? “CustomShape” is a technical term and does not mean “made by the user”. But “CustomShape” is the umbrella term for those shapes, which have an enhanced geometry. These shapes are written as element in the file markup in ODF format. Many of these shapes have handles and shape specific glue points. For all of these shapes and only for them the tool “Toggle Extrusion” is active in the UI. Looking at it allows to quickly distinguish a CustomShape from other kind of shapes. We have already page https://wiki.documentfoundation.org/Development/Remarks_on_Fontwork_and_TextWarp There the spelling "custom-shapes" is used. The Draw guide has "custom shape" in chapter "Text callout". In the style dialog in the UI we have on tab 'text' the wording "Custom Shape Text". I am looking for a spelling that makes clear, that it is a technical term for a kind of shapes and that "custom" in this context has nothing to do with "user". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] motion paths
Hi Daryl, Daryl Spitfire schrieb am 24.05.2022 um 19:16: [..] I can create (or specify) the path (such as freeform, curve, star, etc.) but when I either click "Play" (at the bottom of the animations pane) or just run the slide show, it part-way works in that I can set something to happen by "on click" but no matter what I try I only ever get the start and the very end of the path. I NEVER see the object traveling along the path. What value has the field "Duration" when you edit the animation? I have seen in other software where I can set a portion of the path (if the path goes from 0% to 100% I can set the "start" at 12% and the "end" at 75%, or whatever). That is not possible in LibreOffice. The shape always starts at the start of the path, even if the shape position is far away from the path. So you should always start the path in the center of the shape. I also do not see anything (it's grayed out) in the direction box. I guess I'm just missing something. The path has triangles in its ends, which show the motion direction. What am I missing? Which version of LibreOffice do you use, which operating system? Kind regards, Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] I would like to know more
Hi Linda, Linda Soper schrieb am 10.05.2022 um 12:58: Dear Sir or Madam, I would like to know more about this and have only just got the software. Thank you for using LibreOffice. I think, in your case the "Getting Started Guide" is useful for you. You find it on https://documentation.libreoffice.org/en/english-documentation/ Besides that, we have channels for user support, from the items listed in the drop-down 'GET HELP' on https://www.libreoffice.org in particular 'Community Assistance' and 'Mailing lists'. And you should use the help from inside running LibreOffice. It will open the local help if installed or otherwise the online help in your default browser. This mailing list is the discussion area for those, who are working on the documentation. Kind regards, Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Documentation forum
Hi Ilmari, https://meta.discourse.org/ works for me. My Seamonkey version is 2.53.12. Kind regards, Regina Ilmari Lauhakangas schrieb am 09.05.2022 um 21:04: On 9.5.2022 20.57, Regina Henschel wrote: Olivier Hallot schrieb am 09.05.2022 um 17:07: Hi Team Our infra team has set up a test site for a documentation forum, based on the documentation mailing list. The documentation mailing list history has been imported to it. Please have a look at https://communitytest.documentfoundation.org/c/documentation/195 And let us know if you have comments and suggestions on the new forum. My default browser is "Seamonkey" and using that browser I see nothing. The link opens in a blank page. I do not want to change my default browser, because I like the integration of mail, browser and chatZilla client. So I would need a notification about the forum posts per mail. If I then want to answer or post myself, I could use Chrome. But I do not want to make Chrome my default browser. Latest SeaMonkey is based on Firefox 91.9, so relatively recent. I looked into it and apparently there was a regression in Discourse: https://meta.discourse.org/t/discourse-not-loading-on-legacy-browsers/221412 As TDF is running the latest release of Discourse, 2.8.3, it seems that the fixes have not yet hit a stable version. However, Regina and other SeaMonkey users could test how https://meta.discourse.org/ works. It certainly works for me with SeaMonkey 2.53.12 It is not the intention of Discourse devs to cruelly block visitors using non-bleeding-edge browsers. Quote from a dev in the topic: "Keep in mind, our biggest focus is on not breaking old browsers. A blank page is simply not acceptable, not even on ancient browsers. A readonly view is acceptable. The tricky thing that happened here is that we have some browsers that are in a twilight state, not exactly supported and not exactly not supported, sadly they got a white page treatment. We are thinking of better approaches going forward to avoid regularly hitting these issues as our minimal browser version number creeps up." Ilmari -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Documentation forum
Hi Olivier, Olivier Hallot schrieb am 09.05.2022 um 17:07: Hi Team Our infra team has set up a test site for a documentation forum, based on the documentation mailing list. The documentation mailing list history has been imported to it. Please have a look at https://communitytest.documentfoundation.org/c/documentation/195 And let us know if you have comments and suggestions on the new forum. My default browser is "Seamonkey" and using that browser I see nothing. The link opens in a blank page. I do not want to change my default browser, because I like the integration of mail, browser and chatZilla client. So I would need a notification about the forum posts per mail. If I then want to answer or post myself, I could use Chrome. But I do not want to make Chrome my default browser. Kind regards, Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide 7.3
Hi Peter, Peter Schofield schrieb am 10.04.2022 um 12:01: Version 01 of the following chapters for the Draw Guide 7.3 are in the Work In Progress folder on NextCloud ready for their review and comment. I have added some comments to DG7307 3D Objects. Kind regards, Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Slide Show in Impress
Hi Peter, Peter Schofield schrieb am 01.03.2022 um 09:57: Hello Regina The right-click on a presentation file and select Show is only available in Windows. I have checked macOS and Ubuntu and right-click > Show is not available. Autostart is required if the option Loop and repeat after… is selected in Slide Show Settings. This allows a slide show to be run independently as a display, for example in a shop or at an exhibition as an advertising tool. In that case, starting LibreOffice via command line would be the way to go. That can be combined with a cron job. https://ask.libreoffice.org/t/running-and-stopping-impress-via-cron/29156 Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Slide Show in Impress
Hi Peter, Peter Schofield schrieb am 28.02.2022 um 10:20: After comments from Kees, I am testing the running of a presentation in LO Impress and there maybe an omission in the slide show settings. There is no autostart of a presentation, or automatic advancing of slides in a presentation. You have to press the spacebar, right our left arrow keys, or mouse click to start the presentation or move to the next slide. Autostart = Start in presentation mode ? On Windows, right click the file and choose item 'Show' instead of 'Open' from context menu. Automatic advancing slides is not in the slide settings, but it is a setting of the slide transition. There you find section 'Advance Slide' with options 'On mouse click' and 'After ... sec'. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Book "Custom Shape Tutorial"
Hi documentation team, I have written a book "Custom Shape Tutorial". You find the current state of the book in https://wiki.documentfoundation.org/User:Regina/Custom_Shape_Tutorial Are you interested in taking the book into your care? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Glue Points
Hi Peter, Peter Schofield schrieb am 29.08.2021 um 11:44: I am trying to workout how glue points work in Impress and Draw. Some explanation is required as the LO help on this subject is not very helpful (pardon the pun). Glue Point Relative - maintains the relative position of a selected glue point when you resize an object. What does this mean? What is the relative position? Glue Point Horizontal left - when the object is resized, the current glue point remains fixed to the left edge of the object. What does this mean? Also applies to Glue Point Horizontal Center, Glue Point Horizontal Right, Glue Point Vertical Top, Glue Point Vertical Center, and Glue Point Vertical Bottom. I have tried several times to work this out, but not having much success. Draw a square shape of edge length 4cm, for example. Click 'Glue Points' icon. That should open the toolbar 'Glue Points'; if not, open it from View > Toolbars. Make sure icon 'Insert Glue Point' is on (that is a toggle icon). Select the shape and click 1cm right and 1 cm down from the left/top corner to insert a glue point. The default setting is that icon 'Glue Point Relative' (the % icon) is on. Drag the right edge of the square so that the shape becomes 12cm wide. Notice that the glue point is no longer at position (1cm|1cm) in the rectangle, but it is at position (3cm|1cm). The position of the glue point is not fixes 1cm from the left, but it is at 25% of the shape size from the left. The position is relative to the shape size. Make the above steps again. But before you drag the edge of the square we change this 'relative to shape size'. Make sure icon 'Insert Glue Point' is off (otherwise the next click would add a new glue point). Click the previously created glue point. Then click on the 'Glue Point Relative' icon to turn it off. When it is off, the icons right from it become active. Click on 'Glue Point Horizontal Left' icon. Now again drag the right edge of the shape so that the shape becomes 12cm width. Notice that the glue point does not change its position. It is still 1cm right of the left edge of the shape. Now drag the left edge of the shape to reduce its width to 8cm. Now the glue point has moved so that it is still 1cm right from the left edge of the shape. That means, that the glue point position is relative to the shape, but its position inside the shape has an absolute value. Help please. I hope it is clearer now. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Math Greek Symbols Question
Hi Mitch, the behavior is determined by the property GreekCharStyle in the Expert Configuration. Possible values are 0, 1 or 2. Meaning: 0Both lower and upper greek characters are non-italic. To get italic use the variants with i. Example %omega, %OMEAGA non-italic, %iomega, %iOMEGA italic 1All greek characters are italic. 2Lower greek characters are italic. Upper greek characters are non-italic. The variants with i are always italic. The style can be forced in all cases by using the attribute nitalic or italic, respectively. The change of the value of GreekCharStyle becomes active only after restart of LibreOffice. The default value is 2. I personally prefer value 0. For testing you can copy the following lines. %omega %OMEGA %iomega %iOMEGA newline nitalic %omega nitalic %OMEGA nitalic %iomega nitalic %iOMEGA newline italic %omega italic %OMEGA italic %iomega italic %iOMEGA Kind regards Regina Mitchell Camfield schrieb am 27.08.2021 um 16:46: Hi all, I am reviewing the math user guide and ran into something. When trying to insert *italic lowercase* Greek symbols into the formula editor, the resulting symbol is always italic. For example, if I write %ichi or %chi using markup in the formula editor, the resulting symbols will look exactly the same. I found that this is true if I am using the Mac or Windows version of LO. Does this happen to anyone else? For additional context, I am inserting these symbols into Writer. Thanks for your help! All the best, Mitch *Mitchell Camfield, MEd* Instructional Designer University of Cincinnati, College of Nursing Cincinnati, OH 45221-0038 -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] text about creating a parabola as custom-shape
Hi all, you can get the document now from https://wiki.documentfoundation.org/Tutorials#Using_ODF_Custom_Shapes_to_Draw_Parabolas If you find errors in the document, please tell me. I will correct them and upload a new version of the document. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] More questions on Lists
Hi Olivier, Olivier Hallot schrieb am 20.08.2021 um 16:06: Hi Team, Regina I can describe the problem from the point of view of the file format. For questions about the internal handling of lists, Michel Stahl is certainly the more appropriate contact. Is it correct to state the following: 1) A list is set of paragraphs, labeled with the same ListID. The concept of "numbered paragraph" from ODF 1.1 is deprecated since ODF 1.2. and will be removed in ODF 1.4. I think it was never supported in OpenOffice.org or LibreOffice. Now a list is always a structure. It is a element in file format. It has child elements and . A is essentially the same as a only that it is not numbered. A can contain paragraphs (including headings) and elements. This sub-list is then the next list level. The first paragraph in a gets the number/bullet/image. Formally it is possible to directly start a list item with a sub-list, but LibreOffice confuses the numbering then. So in LibreOffice a list item must start with a paragraph. The UI generates good structures only in Writer. Lists in Impress are bad structured and the UI is no help there. 2) All paragraphs with same ListID belongs to the same list, independent of the paragraph style. Neither list item nor paragraph have a list ID at all, but only the list itself. The fact, that a paragraph belongs to a list is given only by the structure in the file format. A list does not need to have a list ID. Such list ID is not used in Impress, for example. 3) A paragraph with no ListID (ListID="") does not belongs to a list. see 2), paragraph never have list IDs. 4) The List style defines an unique ListID in the document, in the form of ListID="listNNN" where NNN... is a random but unique number in the document. A list style itself does not define a list ID. But if you assign a list style, then LibreOffice generates a list ID for the list if necessary. A list ID is a standard xml:id attribute, which implies its uniqueness. From point of file format it need not start with the text "list", but it may be other another text. A list ID is necessary, if you have a document structure paragraphs list A paragraphs list B paragraphs list A, continued Then you need to set the value of attribute text:continue-list in the second part of list A to the list ID of the first part. But it seems LibreOffice sets a list ID for all outermost lists in Writer. For a structure paragraphs list A paragraphs list A, continued LibreOffice does not use the text:continue-list but the weaker attribute text:continue-numbering, which refers to the previous list. 5) removing the numbering or bullet from the paragraph does not remove the paragraph from the list. If you use backspace to remove the numbering/bullet/image, then LibreOffice turns the item into a element. The handling is not ODF-conform, but does not produce validator errors. The description in ODF is "It contains one or more paragraphs that are displayed before a list." But they are not displayed before the list but within the other list items in LibreOffice. Nevertheless you are right, the paragraph still belongs to the list. (In LibreOffice 7.2 the listID can be inpected wither in the Styles Inspector and the UNO object inspector) The Styles Inspector is wrong, that is lists 'List Id' and 'List Label String' in the category 'Character Direct Formatting'. Both are not a character formatting. The 'List Id' is not even a 'Style' but an attribute of the list. You have for example. Whereas the 'List Label String' is defined in a element, which is referenced by the text:style-name attribute of the list. Whereby the resulting string is not contained in the file but generated by the application. The API is more correct. About 'listId' it states "specifies the id of the list to which the paragraph belongs". About 'ListLabelString' it states "allows reading the generated numbering list label." Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] text about creating a parabola as custom-shape
Hi all, I have created some custom-shapes, which show a parabola. The shapes are integrated in a text document, where I explain, what I have done to create them. I would like to make the shapes and the text available for all. For that purpose I'm looking for (A) someone to proofread the text. (B) advise for a place in the Wiki for linking to the document, which I then would upload. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] libreoffice writer for persian language
کاربرخوب لینوکس schrieb am 18.08.2021 um 05:02: Salam I want to write handbook for libreoffice Writer Hi, you could translate our English guide. But more useful would be a guide for using RTL (right-to-left writing) in LibreOffice. Such information is missing. Such guide would be useful not only in Persian but in English too. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Question about the Fontwork toolbar documentation
Hi Rafael, Rafael Lima schrieb am 12.05.2021 um 16:29: [..] So my question is: Is there a reason for this feature to have been removed from the default Menubar in Impress and Draw? As far as I remember it was removed from the Format menu in OOo2, when the Fontwork Gallery has been introduced. This feature is especially useful in presentations and drawings, so I don't see why to not have this feature in Impress/Draw and add a note to the help page about it. It is especially useful to label connectors. I also noticed that the Draw Guide (version 6.4) and the Writer Guide (7.1) focus mainly on the Fontwork gallery and do not describe the features in the aforementioned help page. For a Writer Guide it is not really needed, but the Draw Guide should describe it. I would appreciate it if anyone could provide some background on why these decisions were made, so I can update the help pages. I don't know, why this was done, and I see no good reason to make is so hard for the user to use it. I think the feature should be available in a menu in Draw/Impress. https://bugs.documentfoundation.org/show_bug.cgi?id=94535 Only the name "Fontwork" is not suitable for the UI, because it is totally different from the "Fontwork Gallery". It would be better to use a name known from other applications, like "Text along path" or "Text on a path". "Other applications" are e.g. Inkscape, Gimp, Illustrator, CorelDraw. The feature is not available in MS Office. Perhaps Sun has therefore hidden it? And the feature is only usable in "extended" file format. But that is no reason to hide it. We have a lot of features, which are only usable in "extended" file format. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Heads up! Change in object anchoring for release 7.1
Hi, Ilmari Lauhakangas schrieb am 28.02.2021 um 13:35: On 28.2.2021 13.21, Olivier Hallot wrote: Currently, some contributors and users are resisting this change and calling for a revert. https://bugs.documentfoundation.org/show_bug.cgi?id=140702 Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Heads up! Change in object anchoring for release 7.1
Hi Olivier, Olivier Hallot schrieb am 28.02.2021 um 12:21: Hi Team LibreOffice Writer 7.1 dropped the To Page anchoring option when inserting an object in the document. Existing To Page anchored object > are preserved but not an option anymore for new objects. That is not quite right. It has been not "dropped", but only hidden from "Anchor"-menu. You can still get the anchor type "To page" from the "Type" tab in the properties dialog (images and frames) or the "Position and Size" tab in the "Position and Size"-dialog (shapes). And if you want to have it the same way in the context menu as in previous versions, you can customize the context menu. You need to make a submenu "Anchor" in e.g. the context menu of "Image", then select the new submenu in field "Target" and then add all the anchor types to it. It was hidden, because you really need to know the impacts of "anchor to page", when you use it. But people try to use it to prevent images loosing position, but it is not designed for that purpose and the wrong anchor type for that. An interesting source for object anchoring and positioning by Mike Kaganski may be used in our guides on anchoring: https://ask.libreoffice.org/en/question/199971/multiple-captioned-images/#post-id-199989 And in this context, another important change: you can now specify as a default which anchor type is used when inserting an image. Tools > Options > Writer > Formatting Aids, section "Image". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Starmath code documentation
Hi Dante, Dante Doménech schrieb am 27.02.2021 um 13:07: Hello. I was wondering if there's any wiki website for the code documentation. In particular I'm interested on starmath documentation. If there's one could you point me there? For such, you should start at https://wiki.documentfoundation.org/Development There you can explore "Source Code Documentation", which leads me to https://docs.libreoffice.org/starmath.html (I think, the content there comes originally from Eric Bachard) and look at "Writing Source Code Documentation" how to add the information to the code. If not, where should I create it? In case you will go with the Wiki, you should start at https://wiki.documentfoundation.org/Development with Section "Misc." (scroll down). It has the single Modules. There you would need to add "Math". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide 7.1
Hi Peter, I have uploaded versions with some comments. Kind regards Regina Peter Schofield schrieb am 13.02.2021 um 09:37: Version 01 of the following chapters for the Draw Guide 7.1 are now in the Work In Progress folder on NextCloud ready for review and comment. Preface Chapter 1 Introducing Draw Chapter 2 Drawing Basic Shapes Any volunteers to become a reviewer? Regards Peter Schofield psaut...@gmail.com -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Making a 3D star
Hi all, in a Christmas blog post https://de.blog.documentfoundation.org/2020/12/15/weihnachten-2020-spass-mit-sternen/ (German) I have shortly described, how to make a 3D star. I have now described this in more detail and in English. Find the article at https://wiki.documentfoundation.org/Documentation/HowTo/Draw/Make_a_3D_Star If you find spelling errors or unsuitable wording, simple correct them. It is a Wiki. If you have questions and you think something needs to be better explained, use the Discussion page and drop me a mail. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Working with the Markup of an ODF File
Hi all, Olivier Hallot schrieb am 04.01.2021 um 02:20: Hi Regina Em 03/01/2021 12:05, Regina Henschel escreveu: I'm going to write a Wiki article "Working with the Markup of an ODF File". Do you have a suggestion, where to put it? Documentation/ODFMarkup Later we add an entry in the Documentation entry page of the wiki (and Development too), do proper categorization for quick search and enable translation. I have created https://wiki.documentfoundation.org/Documentation/ODF_Markup now. As always, improvements are welcome. Also, in case you need further information in regard to that topic, please ask. I will add them (in case I know the answer). Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Working with the Markup of an ODF File
Hi all, I'm going to write a Wiki article "Working with the Markup of an ODF File". Do you have a suggestion, where to put it? The introduction is: There exist very different reasons why someone wants to use the markup of an ODF file, for example: You want to learn, how the markup looks like. You want to be sure the file doesn’t contain any hidden confidential information. You want to compare the markup of other producers with the markup generated by LibreOffice. You want to investigate, whether a bug comes from a file format error. You want to manually repair an error in the markup. You want to manually do things, for which LibreOffice has no good UI. You want to directly generate ODF files without using LibreOffice. You want to apply an XSLT to the document without using LibreOffice. The following article is a collection of tips, tricks and hints to help you in such tasks. Currently sections are: Working with ‘Flat XML ODF’-File Working with zip-Format Pretty Printing Special editors Avoid Noisy Markup in Writer Valid ODF Files Other Tools for ODF Files Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Correction to IG7009-SlideShows-01-PS.odt
Hi authors, In part "Options" in section "Slide Show options" is the text Mouse pointer as pen – enables you to write or draw on slides during the presentation. Anything you write with the pen is not saved when you exit the slide show. The color of the pen cannot be changed. That is not correct. If you enable 'pointer as pen' in the Options before running the slideshow, then drawings which you make in running slide show, are persistent and will be on the slides, when you exit slide show. If you enable 'pointer as pen' in running slideshow from the context menu, the drawings are not persistent. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] A new guide for blind users, the mac and the screenreader voiceover and LibreOffice Writer
Hi Keith, have you already put the guide somewhere? On the German mailing list is currently an intensive discussion about using LibreOffice by blind people. That discussion has result in several bug reports already, and there was a community call on that topic. Your guide would be valuable for the German community too. Kind regards Regina Keith Reedy schrieb am 29-Sep-20 um 21:05: Hello, I have recently written a short guide for those who are blind and wishing to use LibreOffice Writer with the mac and screenreader voiceover. I believe this guide could be helpful too many. Please tell me how I may have this guide added to your information. Thank you. Keith Reedy We are Braille Bible printers, http://biblesfortheblind.org Keith Reedy keithre...@fastmail.net -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Need help with Draw Module of LibreOffice 7.0
Hi Bernard, Poole, Bernard J schrieb am 22-Sep-20 um 13:21: Greetings, Everyone, This is the first time I've written to the documentation team. I hope you can help me. I'm working on Lesson 3 of the LO 7.0 version of my "Essentials" tutorials for teachers (http://www.pitt.edu/~poole/libreoffice7frame.htm). Attached is a Word doc The mailing list does not allow attachments. in which I have dumped captures from screens where I'm trying to round the corners of a rectangle in the LO 7.0 Draw module. As I hope you can see, I'm following the help offered by the 7.0 Help System and LO 7 does not appear to allow me to use the rounding corners option (the option is inaccessible--greyed out). Can any of you help me with this? You need to use a suitable rectangle. A) There exists a "Rectangle, Rounded", which is compatible with MS Office. You get it from the sublist "Basic Shapes" of the Drawing toolbar, or from menu Shape > Insert > Basic Shapes, or from "Shapes" pane of the sidebar. It has a handle which you can drag or you use the "Control field" to set the handle numerically in the "Slant & Corner Radius" tab of the "Position & Size" dialog. B) There exists a toolbar "Legacy Rectangles", to be opened via View > Toolbars. For that rectangle you set the corner radius in the upper part in field "Corner Point" in the "Slant & Corner Radius" tab of the "Position & Size" dialog. Or you enable Point Edit mode (icon in the standard toobar) and drag the handle. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Exporting Guides to XHTML or EPUB formats
Hi Olivier, Olivier Hallot schrieb am 11-Sep-20 um 03:05: Hi Doc'ters I made some tests to check the export to XHTML (and EPUB) format of our Guide chapters. Actually I created a new file based on Jean's latest template and made some adjustments I want to share with you. Here are some partial conclusions... [..] Svante has made some changes to the xsl files for the ODF TC. These files are used for XHMTL export. You find the files in https://github.com/oasis-tcs/odf-tc/tree/master/src/test/resources/odf1.3/tools/odf2html/export/xhtml Perhaps you can test, whether the export becomes better, if using these files instead of the original ones. You find the original ones in your installation in share/xslt/export/xhtml. Bug report related to one of the problems is https://bugs.documentfoundation.org/show_bug.cgi?id=136606 Besides that, we have about 160 open bug reports with XHTML or EPUB topic. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Text about tab "Position" in numbering style dialog
Hi Olivier, you find the file InfoTextListsLOHelp.odt there. You mayn use it as you like, for example taking parts of its for use in other places. Kind regards Regina Olivier Hallot schrieb am 05-Sep-20 um 22:34: Hi Regina You can put the file in the LibreOffice cloud, under "LibreOffice Documentation/English/Contributor Resources/" Thanks for writing on this topic. Olivier Em 05/09/2020 13:49, Regina Henschel escreveu: Hi all, I've created a text about the tab "Position" in the numbering style dialog. It includes the "old" kind of lists, which you will see e.g in the chapter numbering of the ODF 1.2 specification. Any interest? If yes, where can I put it. It is a .odt text document. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Re: Using MULTIPLE.OPERATIONS as a normal Calc function
Hi Steve, I have made some input to https://wiki.documentfoundation.org/Documentation/Calc_Functions/MULTIPLE.OPERATIONS Please look, whether that is of the kind you ask for. There a likely further examples needed. Kind regards Regina Steve (GMail) schrieb am 02-Sep-20 um 14:33: Hi Regina, Some months ago, we had some email correspondence about including a description of the use of MULTIPLE.OPERATIONS as a normal function in the Calc Functions wiki (https://wiki.documentfoundation.org/Documentation/Calc_Functions). At the time you sent me a link to a German wiki page that included such details (http://www.ooowiki.de/MehrfachOperation.html) but unfortunately I don’t speak German. I think that you indicated that you might be able to fill the page for MULTIPLE.OPERATIONS. You are probably aware that Ronnie Gandhi has started work updating the Calc Functions wiki under the Google Season of Documents 2020 program. At some point he will turn his attention to the currently empty page for MULTIPLE.OPERATIONS (https://wiki.documentfoundation.org/Documentation/Calc_Functions/MULTIPLE.OPERATIONS). I wondered whether you had any time available to draft the material necessary for that page? If so, it might save Ronnie, Olivier, and I some research time and that would be much appreciated. If you want to edit the wiki page directly then that is great. Alternatively, if it’s easier to produce something in a Writer file, that would be great too. Many thanks in advance. Regards, Steve Fanning -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Text about tab "Position" in numbering style dialog
Hi all, I've created a text about the tab "Position" in the numbering style dialog. It includes the "old" kind of lists, which you will see e.g in the chapter numbering of the ODF 1.2 specification. Any interest? If yes, where can I put it. It is a .odt text document. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Impress Guide version 7.0
Hi Peter, Peter Schofield schrieb am 14-Aug-20 um 12:27: Second draft of Chapter 2 Slide Masters, Styles and Templates for the Impress Guide 7.0 is now in the Drafts folder ready for review and comment. I have uploaded a commented file. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Chapter 11 Draw Guide Version 6.4
Hi Peter, Peter Schofield schrieb am 16-May-20 um 12:32: Chapter 11 Advanced Draw Techniques of the Draw Guide Version 6.4 is now in the Drafts folder for its first review and comment. I have uploaded my review. In addition I have added two files. One contains my changes to section "Dimensioning options" and the other one the drawings from which I have created the illustrations. That was my last review for the next time. I have plenty of other work in the next month. Nevertheless, you can of course ask me if anything is unclear. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Arc
Hi Phil phil valenzuela schrieb am 20-May-20 um 03:39: How can I create an arc with your drawing software? Thank you. phil"Una vez un amigo, siempre un amigo" The 'arc' is in the set 'Basic shapes' in the drawing toolbar. 1. click on the icon 2. click, hold down mouse button and drag. You will see the ellipse which determines the arc. 3. release mouse button. Now you see a radius line. That is the line to the start point of the arc. Move the mouse so that the line is at the desired start point. Click with the mouse, no mouse button down. 4. Move the mouse. Now you see the arc. Move the mouse to the desired end point. 5. Click to finish the drawing. In case you need to change start or endpoint later, select the arc and then click the icon "Points". Now the start and the end points have handles to drag them. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide Version 6.4 Chapter 9
Hi Peter, Peter Schofield schrieb am 08-May-20 um 15:54: First draft of Chapter 9 Adding and Formatting Text Draw Guide Version 6.4 is now in the Drafts folder ready for review and comment. I have upload the file with my comments. In general, you should consider to skip all things, which are already explained in Getting Started or Writer guild. There are so many things about text, which are specific to Draw, that you otherwise will end up with a huge chapter. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide version 6.4 Chapter 08
Hi Peter, Peter Schofield schrieb am 02-May-20 um 16:08: Draft copy of Chapter 8 Connections, Flowcharts, and Organization Charts of the Draw Guide version 6.4 has been uploaded to the Drafts folder ready for review and comment. with my comments back to draft folder. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide - 3D Effects
Hi Peter, Peter Schofield schrieb am 01-May-20 um 11:37: I have just completed a draft version of Chapter 7 3D Objects. I have uploaded my review to the draft folder. Besides my changes and comments there: I would like a different structure. Currently you are switching between 3D scenes and the 3D mode created with the tool Toggle Extrusion several times. It would be easier to understand and write if you made two completely separate sections, one for "3D mode created with the Toggle Extrusion tool" and one for "3D scene". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide - 3D Effects
Hi Peter, Peter Schofield schrieb am 01-May-20 um 11:37: I have just completed a draft version of Chapter 7 3D Objects. Whilst creating this chapter I can across a problem with 3D Effects and I have submitted a bug report on compatibility issues between macOS Catalina and LibreOffice Version 6.4. Number of the bug report? However, I believe that someone should have a serious look at 3D Effects to improve it. +1 But "someone" is the problem. Because Microsoft Office does not have this feature and so this area is not needed for converting documents, you will hardly find a sponsor. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide — 3D Effects
Hi Martin, Martin Srebotnjak schrieb am 19-Apr-20 um 11:15: Thanks, Peter, for noting that. It seems that we need a wiki page with all the thing that are not funcional in macOS. I think, a wiki page is not the right place. Keep it in Bugzilla. We have currently 310 open bugs with Mac OS [1]. You could create a [META] bug and add all reports, for which it is verified, that the report is indeed a bug and that only Mac OS is affected. [1] https://bugs.documentfoundation.org/buglist.cgi?bug_status=UNCONFIRMED_status=NEW_status=ASSIGNED_status=REOPENED_id=1120543_sys=Mac%20OS%20X%20%28All%29=LibreOffice_format=advanced Since most programmers of LO write/say what Regina wrote here, it would maybe help if TDF could buy one mac and have it available to LO programmers and testers via remote desktop to text/locate/fix such issues. It should be no problem for TDF to provide suitable hardware on loan to a developer. The real problem is to find a LibreOffice developer with interest and knowledge in Mac OS to work on the bugs besides his daily job. I have no idea, whether something like remote desktop would work, but infra team should know. For testers exists the similar problem: Do we have testers, who would regularly test on Mac OS? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide — 3D Effects
Hi Peter Peter Schofield schrieb am 18-Apr-20 um 12:57: Hello Regina A few days ago I made a comment that I could not get 3D Effects dialog to open in Draw. I have now discovered the problem. In LO Draw version 6.4, 3D Effects dialog does not open. This only happens in macOS. Windows 10 version works OK. In LO Draw version 6.3, 3D Effects dialog opens without problem and the tools work in macOS. I have submitted a bug. I have seen the bug report. But I work on Windows and cannot do anything about the bug. You can use version 6.3. There were no changes on the dialog from 6.3 to 6.4. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide — 3D scenes and shapes — definition
Hi Peter, Peter Schofield schrieb am 17-Apr-20 um 15:24: Sorry Regina This info does not make sense to me. I am not a programmer, nor have I ever been involved in creating software. I am at the other end — a user. I need a definition that I can understand and use to create an explanation for a user. Sorry, I will try it again. You can think of a scene as a little three-dimensional world. This world can contain the object types: cube, sphere, extrusion-object, rotation-object. LibreOffice makes a kind of "photo" from this "world" and inserts it into the draw page. The object types cube, sphere, extrusion-object, rotation-object do not exist outside a scene. Open the sub-toolbar "3D-Objects" from the drawing toolbar and draw a cube. Now look at the status-bar. You see the text "3D scene selected". Now press F3. You should see the text "3D cube selected" in the status-bar. A scene acts similar to a group. Therefore it has the same short-cuts as a group. With key F3 you enter the scene. You are now inside the little three-dimensional world. With Ctrl+F3 you leave the scene. If you want to experiment with a more complex scene, you can use the logo of LibreOffice 6. You can get the Draw file containing the original object from https://wiki.documentfoundation.org/File:LibO6.0-Cubes.odg Perhaps it is easier, if you play around with such objects, and if get something unexpected for you, then ask about that situation. One problem with 3D-objects is surely, that similar shapes do neither exist in PowerPoint nor as SVG-image. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide — 3D scenes and shapes — definition
Hi Peter, Peter Schofield schrieb am 17-Apr-20 um 10:55: Could someone please give me the definitions for 3D scenes and 3D shapes that LO Draw can produce. Doing a Google search is not helping me. a first step would be to look, what kind of shapes exist in the ODF standard. http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html There you find section "10.5 3D Shapes". The outmost 3D-object is always a scene, an element . Such scene can contain: cube (element ) sphere (element ) object, which is generated from a 2D path by rotation (element ) object, which is generated from a 2D path by extrusion (element ) inner scene (element ) An inner scene works the same as grouping does for 2D-objects. But there is no UI to generate such inner scene in LibreOffice and I have not tested yet, whether it would work, when LibreOffice gets a document using such inner scene. At least some code I have read consider it. The outer 3D scene provides the connection to the page. It defines the position and size of the resulting object in the page. The 3D-world is projected to a 2D plane. What you get on the 2D plane is then scaled to fit into the size, specified at the 3D scene. Such projection can be done as parallel projection or as central perspective. Those are "true" 3D-objects. In addition and not to be confused with "true" 3D-objects, there exists the "custom shape" (element ), section 10.6. Most of the shapes in the UI of LibreOffice belong to this kind of shape and the Fontwork shapes belong to this kind of shape too. A custom-shape has an extrusion mode. In this mode, the shape is shown as 3D extrusion object. But it is only a mode and you can toggle 2D and 3D mode. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide Chapter 6
Hi Peter, Peter Schofield schrieb am 10-Apr-20 um 14:19: Version 6.4 of Chapter 6 Draw Guide is now in the Drafts folder ready for review and comment. I have put comments in the file and put the result into the Feedback-folder. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Raster Graphics or Bitmap Images
Hi Peter, Peter Schofield schrieb am 06-Apr-20 um 16:17: To help me update Chapter 6 in the Draw Guide to version 6.4, which term is preferred Raster Graphics or Bitmap Images? Raster graphics are bitmap images. Bitmap images is the more widely known file format and uses the extension BMP. Does LO stay in the past or move forwards to modern times? "Raster graphic" is the opposite to "Vector graphic" and covers more then "Bitmap", which is usually only used for BMP. "Raster graphic" covers png and jpg too, for example. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] LibreOffice writer- Crash
Hi, Pulkit Krishna schrieb am 03-Apr-20 um 06:10: Hello Everybody, I am also facing this issue since a long time. I think I have even reported a bug for version 6.4.0 but I am not sure. Using the list of font size has no problem but using Increase and decrease font button makes libreoffice crash. Pulkit Krishna Does it crash with each font, or only with special fonts? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide - Control 1 and 2
Regina Henschel schrieb am 20-Mar-20 um 13:38: These fields are a first attempt to make it possible to numerically set the position of control points of custom shapes. "the position of control points" should be "the position of handles". "control points" is a term for Bézier-curves. Perhaps the field labels in the dialog should be changed. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide - Control 1 and 2
Hi Peter, Peter Schofield schrieb am 20-Mar-20 um 12:54: Can someone explain to me Control Point 1 and Control Point 2. These are found in the Position and Size dialog Slant & Corner Radius page. I need to know the purpose so that I can explain these functions in the Draw Guide. The LO Help does not explain. These fields are a first attempt to make it possible to numerically set the position of control points of custom shapes. The entered values are relative to the top-left corner of the shape. Still unsolved: * The fields only work for x-y-handles, not for radial handles. * There exist shapes with more than two handles. * It does not work with shapes in imported pptx-documents. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Impress Text Toolbar
Hi Dave, is "Asian" and "Complex Text Layout" enabled? That is in Tools > Options > Language Settings > Languages. Kind regards Regina Dave Barton schrieb am 17-Mar-20 um 14:45: I am currently reviewing a chapter for the Impress User Guide 6.4. Part of this chapter refers to the "Text Toolbar" which is not visible by default. Once the toolbar is made visible it should be possible to make 3 additional toolbar buttons visible: * Vertical Text * Fit Vertical Text to Frame * Vertical Callouts Under LO Version: 6.4.1.2 (x64 & x86) Windows and Linux (x64) these 3 additional buttons cannot be made visible and the functions they provide cannot be accessed via this toolbar. The issue does NOT appear in: LO portable 6.4.1.2 or 6.3.5.2 (x86 only) Linux Mint provided Version 6.0.7.3 I have checked Bugzilla and unless I have overlooked it this issue does not appear to have been reported yet. Could someone here please check if this is a real issue or just a glitch in the configuration of my machines? TIA Dave -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Problem - Legacy Circles and Ovals toolbar in Draw
Hi Peter, that is bug https://bugs.documentfoundation.org/show_bug.cgi?id=123841 Workaround: Open branch "Default" in Styles pane in the sidebar. Modify the style "Object without fill" so that it has Area "None". In case you need it often, you should make the change in a document template. Kind regards Regina Peter Schofield schrieb am 15-Mar-20 um 11:14: Can anyone give me a solution to the following problem I have come across. In the Legacy Circles and Ovals toolbar in Draw there are icons that allow you to draw unfilled objects in a drawing. I have tested drawing these unfilled objects as I am writing the Draw Guide 6.4 and objects drawn always appear filled. After further testing, I think somebody should look at these tools on this toolbar as they are definitely NOT behaving as the name suggests. Regards Peter Schofield psaut...@gmail.com -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Saving formulas in MathML
Hi Stephen, Stephen Fanning schrieb am 02-Mar-20 um 13:05: In Math you can save a formula either in .odf or .mml formats. Can anybody say at which Math build the .mml option changed from MathML 1.01 to MathML 2.0? https://bugs.documentfoundation.org/show_bug.cgi?id=87118 Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Draw Guide Version 6.4
Hi Peter, Peter Schofield schrieb am 28-Feb-20 um 09:40: I have downloaded all the chapters from the Draw Guide so that I can start updating them to Version 6.4. No forecast yet of when I shall complete as I have not yet reviewed the chapters or looked at Version 6.4 of Draw. If you think, something does not work as expected, please contact me. I am currently working on the German version of the "Draw Guide" and I am familiar with Draw. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Edit Contour in Graphics
Hallo Peter, Peter Schofield schrieb am 22-Feb-20 um 09:58: Hello Can someone explain why the word “contour” is used in Sidebar Properties in Writer when you select a graphic? I have attached a screenshot from Properties of what I mean. That part does not exist in LO 7. This Enable Contour and Edit Contour are the wrong terms to use. The term to use is Crop or Cropping because Edit Contour is exactly the same as Cropping for a graphic. Edit Contour means to change the shape of a graphic object. Also Crop is available from a drop down menu when you select a graphic. A more usual term would be "clipping path". In CSS is it named "clip-path" and "Clipping Path" command in Adobe InDesign, for example. "Crop" should not be used, because cropping and contour-path produce different attributes/elements in file. Cropping produces the attribute fo:clip in a graphic style. It is always a rectangle. In standard definition it can be applied to arbitrary shapes, but in LibreOffice it is only implemented for images. "Edit Contour" produces an element or . That is only allowed as child of , which here means, it is only possible for images. Because the property itself is named "contour" ("wrap-contour" in file) and "Clip" does not exists in the UI, I think, it is correct to name it "Edit Contour". Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] LO Draw and ODG format
Hi Peter, Peter Schofield schrieb am 18-Feb-20 um 13:01: I am updating the user guide for Draw to version 6.4 and have come a problem. LO Writer is not accepting the ODG format as a file. I have tried dropping into a document as well as doing a copy and paste, but nothing happens. I also tried importing as an image and I get the message that the ODG drawing is not recognised as an image. My only solution at the moment is to export from Draw in PNG format after saving in ODG format. Exporting directly from Draw without saving in ODG format produces an empty file. Anybody know a solution. I am using LO version 6.4.0.3 The goal is not clear to me. If you intend to import a complete ODG file (why?), then it would be only possible as OLE. If you want to insert single drawings, often simple copy will work. Another method would be to drag the drawing into a (new) Gallery theme in Draw and insert it from the Gallery in Writer. If your drawing in Draw contains several shapes, you might get better results by grouping them. In case you get distance problems at the edges, include a white rectangle behind the drawing. Why do you think, using PNG in the guide is not so good? BTW, I'm currently reviewing the German guide for Draw. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] ODF v1.2 vs ODF v1.2 extended
Hi Drew, Drew Jensen schrieb am 22-Jan-20 um 00:22: Howdy, Can anyone point me in the direction of any details on what is different between the two file formats ODF v1.2 and ODF v1.2 extended, for example what features are lost by going to the strict version of the standard rather then the LO specific extended version? You can compare the standard ODF 1.2 schema with the schema used by LibreOffice extended. https://opengrok.libreoffice.org/xref/core/schema/odf1.2/OpenDocument-v1.2-os-schema.rng or for upcoming ODF 1.3 https://docs.oasis-open.org/office/OpenDocument/v1.3/cs01/schemas/OpenDocument-schema-v1.3.rng and https://opengrok.libreoffice.org/xref/core/schema/libreoffice/OpenDocument-schema-v1.3%2Blibreoffice.rng Look for the namespaces, which are not included in the rng-file of the standard. And then find all elements and attributes, which use these namespaces. Some of the extensions will be include in ODF 1.3. And similar compare https://docs.oasis-open.org/office/OpenDocument/v1.3/cs01/schemas/OpenDocument-manifest-schema-v1.3.rng and https://opengrok.libreoffice.org/xref/core/schema/libreoffice/OpenDocument-manifest-schema-v1.3%2Blibreoffice.rng A list of extensions, but unfortunately not guaranteed to be complete, is in https://wiki.documentfoundation.org/Development/ODF_Implementer_Notes/List_of_LibreOffice_ODF_Extensions Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Saving as OOXML strict vs transitional
Hi Drew, Drew Jensen schrieb am 22-Jan-20 um 00:06: Howdy, I searched the Writer Guide and the ask forum with no luck on this question. In LibreOffice I would like save (export) files to the OOXML format. I would like to if possible create OOXML strict files vs transitional files. Now in the Save As dialog there are a number of different choices for .docx (as one example) file type. Two of these is "Word 2007-265 (.docx)" / "Word 2007-365 (.docm) and I'm going out on a limb and guessing these generate 'transitional' files. The other choice is "Office Open XML Text (.docx)" and I'm going to guess this is 'strict'. Can anyone tell if that is correct? No, it is not 'strict'. To be "strict" it would need an attribute conformance="strict". If that is missing it is "transitional". The attribute should be in subfile word/document.xml in node w:document. Same for presentations. There it should be in subfile ppt/presentation.xml in node p.presentation. For presentations exists roundtrip bug https://bugs.documentfoundation.org/show_bug.cgi?id=119087. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Calc Keyboard Shortcuts
Hi Stephen, LibreOffice has a setting in Tools > Options > Calc > Compatibility to switch between "Default" and "OpenOffic.org legacy" key binding. The shortcut for cycling through to absolute/relative type of a cell reference is F4 in "Default" and "Shift+F4" in "OpenOffice.org legacy", for example. So you need to examine, whether a shortcut is wrong in both modes or is only valid in one mode. In latter case the table should point to the corresponding shortcut in the other key binding. Kind regards Regina Stephen Fanning schrieb am 10-Jan-20 um 10:35: All, As I mentioned in a previous email, I have done some work to collate a list of known Calc keyboard shortcuts, detailing the discrepancies between the software and the Help files. This is in the form of a reasonably large Writer file containing tables, which can be found in NextCloud (.../Calc Guide/Related materials/Calc Keyboard Shortcuts (windows only) v2.odt). As the file's title suggests, I have only considered the Windows shortcuts so far, ignoring Linux and macOS. This work seems to indicate signficant mis-matches between what the system provides and what is documented in the Help files. I am happy to do the work necessary to identify the changes necessary to align the relevant Help files and Calc Guide chapter with the implemented shortcuts (in Windows, Linux and macOS). Does anybody have any relevant thoughts before I embark on this task? Regards, Steve Fanning -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Tooltips
Hi Stephen, Stephen Fanning schrieb am 09-Jan-20 um 15:04: Please could anybody give me simple example in Calc or Writer showing the impact of selecting / deselecting the *Tools > Options > LibreOffice > General > Help > Extended tips* option? I have yet to find a control which gives a different tooltip dependent on this setting. In a similar way, could anybody give me an example which shows the impact of selecting *Help > What’s This?* Thanks in anticipation! Although the main feature is broken as Drew already said, it is still useful. If you have set the environment variable HELP_DEBUG=1, then the tooltip has an additional line with the associated uno.-command or source file, if "Extended tips" is enabled. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Understanding Calc keyboard shortcuts
Hi Stephen, Stephen Fanning schrieb am 20-Dec-19 um 18:45: Olivier, I came away after yesterday's team meeting thinking that I understood, but I was wrong! There appear to be a significant number of shortcuts described in the Help files that should not exist according to the list of Calc shortcuts to be found in Tools > Customize > Keyboard. I have included a list of such shortcuts at the bottom of this message. Is there a technical reason why these shortcuts are described in the Help but are not listed in the Tools > Customize > Keyboard dialog? Am I missing something? The list in Tools > Customize > Keyboard contains mainly those commands, for which a corresponding .uno:foo exists. But some shortcuts have an effect without uno-command. When you look at the meanings, you will see it, e.g. Alt+Enter -->Fills the marked cell range with the content of the input line. F6 -->Brings LibreOffice into accessibility-mode "without mouse". Shift+Ctrl+Enter -->Turns the formula in the input line into an array formula. An additional problem are shortcuts, which do not work generally, but depend on keyboard, e.g Strg + ÷ --> Marks the range of a matrix formula, but works only with ÷ from the number pad. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Wiki-based description of Calc functions
Hi Steve, when the frame is finished, I can start filling the page for "MULTIPLE.OPERATIONS". Please notice me. Kind regards Regina Stephen Fanning schrieb am 14-Dec-19 um 15:01: Hi Regina, Apologies, my previous response was not sent off the list intentionally - I hit the reply button and forget to change the email address! I have already changed the standards heading for ABS as you suggested and will ignore compliance with ODF v1.3 for the moment. I will insert a category "Functions not contained in the Wizard" as a heading at the bottom of the page listing the function categories. I will also insert MULTIPLE.OPERATIONS in the alphabetical page of functions. I don't speak many words of German but will try to make sense of the linked page at some point. Thanks again. Regards, Steve On Sat, 14 Dec 2019 at 13:00, Regina Henschel wrote: Hi Steve, why not discuss it on the list? Stephen Fanning schrieb am 14-Dec-19 um 12:41: Hi Regina, Many thanks for those helpful comments, many of which are clear and agreed. However a few things remain unclear in my mind, as follows: 1. With regards to addressing compliance with ODF 1.3, is that standard approved yet? If not, shouldn’t we wait until it is? It is not approved yet, but will come hopefully in 2020. It is currently in public review. I have added it for to explain, why I think, "1.2" should not be in the section heading. 2. I have based the set of functions to be covered, and their categories, on those presented in the Function Wizard at v6.2.0.2. I worry therefore that removing the Add-ins category, or sub-dividing the Mathematical category, or changing the categorization in other ways, could cause unnecessary confusion for users. That is a valid reason, so keep it. 3. Multiple.Operations is not covered by the Functions Wizard and so does not currently appear in the wiki’s list of functions. It is well described in the Help files and the 6.2 Calc Guide. If we also include it in this part of the wiki, which category would it be in? The help describes use of Data > Multiple Operations. The help has no description about using it as ordinary function. I have written an example many years ago, for a -no longer active- German Wiki. http://www.ooowiki.de/MehrfachOperation.html As the categories will be parallel to the categories in the function list in the UI, I would add a category "Functions not contained in the function list". 4. I had envisaged that any constraints on the arguments would appear in the section entitled Arguments and any constraints on the result would appear in the Returns section. With that understanding (to be covered in a “guidelines” and “tips” page for authors) is an additional section entitled Constraints really necessary? No, that would be sufficient. Kind regards Regina Regards, Steve On Fri, 13 Dec 2019 at 23:03, Regina Henschel mailto:rb.hensc...@t-online.de>> wrote: Hi Steve, Stephen Fanning schrieb am 13-Dec-19 um 21:11: > All, > > At the last Documentation Team meeting, I agreed to initiate a wiki-based > description of the 500+ Calc functions. The idea is that such an area could > capture more technical information about a function than is possible in the > Help system. In addition we can provide representative use cases for some > functions. > > I have put some initial ideas together in the pages starting at > https://wiki.documentfoundation.org/Documentation/Calc_Functions. Obviously > this is only partially complete and I still have a lot of work to do > populating the structure and the information about the functions. However I > would like to get some initial feedback from the team on what I’ve done > before taking the idea further (in case we agree on changes of direction). > So far I’ve only populated the details of one function, ABS. > > Please could any interested parties have a look at what I’ve done and > provide any feedback or comments? Maybe we can discuss the way ahead at the > next team meeting? I would not make an own category "add-in functions". In former times, it was possible to not install them, and their internal handling is different. But from a user point of view and from file format there is nothing special about these functions. Please add MULTIPLE.OPERATIONS. It has a special UI and is not listed in the function list. But it can be used as any other function and has nothing special in the standard. And the Wiki would be a good place to explain how to use it without the wizard. It might be useful to make subcategories to the mathematical func
Re: [libreoffice-documentation] Wiki-based description of Calc functions
Hi Steve, Stephen Fanning schrieb am 13-Dec-19 um 21:11: All, At the last Documentation Team meeting, I agreed to initiate a wiki-based description of the 500+ Calc functions. The idea is that such an area could capture more technical information about a function than is possible in the Help system. In addition we can provide representative use cases for some functions. I have put some initial ideas together in the pages starting at https://wiki.documentfoundation.org/Documentation/Calc_Functions. Obviously this is only partially complete and I still have a lot of work to do populating the structure and the information about the functions. However I would like to get some initial feedback from the team on what I’ve done before taking the idea further (in case we agree on changes of direction). So far I’ve only populated the details of one function, ABS. Please could any interested parties have a look at what I’ve done and provide any feedback or comments? Maybe we can discuss the way ahead at the next team meeting? I would not make an own category "add-in functions". In former times, it was possible to not install them, and their internal handling is different. But from a user point of view and from file format there is nothing special about these functions. Please add MULTIPLE.OPERATIONS. It has a special UI and is not listed in the function list. But it can be used as any other function and has nothing special in the standard. And the Wiki would be a good place to explain how to use it without the wizard. It might be useful to make subcategories to the mathematical functions. You might need an additional "guideline and tips" page for authors. And about the "ABS" example: General: It would be good to have a template page for the functions, which has already all the sections. You have set the technical term "Number" in bold. I would do the same in the Syntax. It might be necessary to use a letter for the parameter, in case the function is explained by some formula or the function has several parameter of the same data type. Some functions have constraints. Such section is missing. I would name the section not "ODF v1.2 compliance" but "ODF Standard". It needs a line for ODF 1.2, and a line for ODF 1.3. The reference needs the part number in addition. For example ABS is in Section 6.16.2, part 2, ODF 1.2 Section 6.16.2, part 4, ODF 1.3 Special for ABS: The first example should read =ABS(-56.7) returns 56.7 The result is not negative. Related functions are SIGNfor the sign of a real number IMABS for the absolute value of a complex number Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Suggestion
Hi Ilmari, Ilmari Lauhakangas schrieb am 27-Nov-19 um 16:59: Regina Henschel kirjoitti 27.11.2019 klo 12.51: Hi, Ilmari Lauhakangas schrieb am 27-Nov-19 um 10:29: Maybe the Help content for functions could be used as a reference template with some automation to combine it with math background etc. to finally produce a separate handbook? Just thinking of how to avoid repetition of work and human errors. Ilmari Stephen Fanning kirjoitti 27.11.2019 klo 11.17: I agree that it would be good to create a separate handbook to describe Calc's functions and I will spend time creating a first draft of this during the coming months. The mathematical definition of most of the functions is in the standard. It would be far too error-prone and far too time-consuming to write these definitions ourself. The help pages could get links to the HTML version of the standard or a reference with part and section number. We need a mathematical description of those functions, which are our own function, e.g. EASTERSUNDAY. Those functions should get each an own help page with the mathematical definition or a page in the WIKI. Some of our own functions are designed for to be compatible with Excel and have differences to similar functions in the standard. For those functions it is important to describe these differences. In general, the fact, whether a function follows the standard or is compatible to Excel or is totally our own function, should be noted. So in your view, the function reference could be removed from Calc guide book The list (in appendix B) is not needed in a book. There exist already two lists in the UI and the list in the book has not really more information. In case you want to keep the list, it should be extended with the information, whether this function is compatible to Excel and whether it is standard or own function. That information is needed for interoperability and currently no where available. and forget the idea to create a separate handbook? Yes. The huge number of functions makes it almost impossible to present and maintain the information in a book. Having the information in the Help or in the Wiki, the work can be distributed to several people. It is not necessary that all pages are finished at the same time. And you can more easily add additional material, e.g. use cases, example sheets, links. Working on the Wiki would be more open, and allows discussions about presenting the content and about its correctness. Only a good structure and guidelines for the authors are needed. Otherwise it will become an unappealing mess. I prefer the Wiki because even people who only want to do something occasionally can easily contribute. And authors can edit those pages, for which they have a background. Someone who works on financial functions might know nothing about functions with complex numbers, for example. Translating of such Wiki pages is easier and can be more up-to-date than translating a book. The large number of pages speaks against the help. With mathematical definition and application examples, you can quickly reach three pages per function. This results in a volume of about 1500 pages. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Suggestion
Hi, Ilmari Lauhakangas schrieb am 27-Nov-19 um 10:29: Maybe the Help content for functions could be used as a reference template with some automation to combine it with math background etc. to finally produce a separate handbook? Just thinking of how to avoid repetition of work and human errors. Ilmari Stephen Fanning kirjoitti 27.11.2019 klo 11.17: I agree that it would be good to create a separate handbook to describe Calc's functions and I will spend time creating a first draft of this during the coming months. The mathematical definition of most of the functions is in the standard. It would be far too error-prone and far too time-consuming to write these definitions ourself. The help pages could get links to the HTML version of the standard or a reference with part and section number. We need a mathematical description of those functions, which are our own function, e.g. EASTERSUNDAY. Those functions should get each an own help page with the mathematical definition or a page in the WIKI. Some of our own functions are designed for to be compatible with Excel and have differences to similar functions in the standard. For those functions it is important to describe these differences. In general, the fact, whether a function follows the standard or is compatible to Excel or is totally our own function, should be noted. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] FYI Text in shapes
Hi all, I'm working my way into the import/export filters for the OOXML format. I am especially interested in text in custom shapes. First I have got an overview of the current situation. I have collected the parts on a Wiki page. https://wiki.documentfoundation.org/Documentation/Text_in_Custom_Shapes The page contains some sections that might be interesting for the documentation team. For questions or remarks you can use the mailing list or write me directly or use the comment page in the Wiki. It would also be nice if those who look at the site would also correct mistakes they find. Unfortunately, my English is only mediocre. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Explanation of writer spacing and margins?
Hi Luke, Luke (gmail) schrieb am 22-Aug-19 um 16:34: I haven't contributed anything at all yet. But I just wondered if this information might be a useful starting point for someone to document what the page margins and spacing things meant? I couldn't find good information on it, and certainly no simple diagram, so it took a fair bit of work to get just this far. Anyway, see if you think the attached doc is of any value. I have collected some information about margin, border, padding... in regard how they appear in file format. The document is attached to https://lists.oasis-open.org/archives/office/201803/msg00020.html. The discussion is not finished in the ODF TC, because we have decided to first work on version ODF 1.3. Nevertheless it might help you to sort out all these areas on a page. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Review of Draw Guide part DG6302
Hi all, I have reviewed DG6302, the version DG6302-DrawingBasicShapes_VG_KK_RH_20190821.odt is in the feedback folder now and the previous version is in Archive. I have added a lot of comments. And I have added a text box with a larger comment, because the margin was to small for it. This text box needs be deleted in the next feedback version, because it hides the text under the box. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Workflow after I have inserted comments?
Hi Olivier, thank you. Olivier Hallot schrieb am 14-Aug-19 um 21:43: Hi Regina Please asve your file as DG6301-IntroducingDraw_VG_KK_RH_20190814.odt and place it in the Feebback folder and move as "DG6301-IntroducingDraw_VG_KK_20190812.odt to the Archive folder. Done. Kind regards Regina Thank you and kind regards Olivier Em 14/08/2019 14:45, Regina Henschel escreveu: Hi, I have downloaded "DG6301-IntroducingDraw_VG_KK_20190812.odt" and added a lot of comments, but have edit nothing. What is the next step I have to do? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Workflow after I have inserted comments?
Hi, I have downloaded "DG6301-IntroducingDraw_VG_KK_20190812.odt" and added a lot of comments, but have edit nothing. What is the next step I have to do? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] Document "implementation-defined" behavior for LibreOffice
Hi all, I have started page https://wiki.documentfoundation.org/Development/ODF_Implementer_Notes/List_of_LibreOffice_ODF_implementation-defined_items The ODF standard contains parts, which are "implentation-defined". That means, Implementation-defined is used in this standard for values or processing that may differ between ODF implementations, but is required to be specified by the implementor for each particular ODF-implementation. see https://wiki.documentfoundation.org/Development/ODF_Implementer_Notes/List_of_LibreOffice_ODF_implementation-defined_items#cite_ref-1 And this 2.3.2 OpenDocument Extended Producer An OpenDocument extended producer is a program that creates at least one conforming OpenDocument extended document, and that meets the following additional requirements: A)It shall be accompanied by a document that defines all implementation-defined values used by the OpenDocument extended producer. B)It should be accompanied by a document that defines all foreign elements and attributes used by the OpenDocument extended producer. The foreign elements and attributes are documented in https://wiki.documentfoundation.org/Development/ODF_Implementer_Notes/List_of_LibreOffice_OpenFormula_Extensions A list of implementation-defined values was missing. Therefore I have started this page. But currently this page has no content. It lists only all parts where the standard specifies, that something is "implementation-defined". So help is appreciated, to fill it with content. For implementation-defined items in functions I have linked to the help. But I have not verified, whether the help has indeed the needed information. I have not used a table, because a table is hard to read in edit mode. I have added the section numbers of ODF 1.2. When ODF 1.3 is out, new section numbers need to be added then. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] How can I access drafts of documents?
Hi all, I want to read the drafts of the Draw Guide. How can I access them? I have tried: Login with https://auth.documentfoundation.org Goto https://nextcloud.documentfoundation.org/ And then? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Calc Multiple Operations tool
Hi steve, Steve Fanning schrieb am 21-Jul-19 um 22:08: Hi Regina, Thank you for your prompt response. I have not managed to get the multiple operations export to Excel to work logically (even with the formula in the top-left cell). Does a problem report exist somewhere to investigate whether the software is behaving as intended? (I'm afraid that being new to the Documentation Team, I'm not currently familiar with the location of outstanding problem reports or enhancement requests). The bugtracker is https://bugs.documentfoundation.org/ I have made a search with "Multiple Operations", but non of the results was about export to Excel. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Calc Multiple Operations tool
Hi Steve, Steve Fanning schrieb am 21-Jul-19 um 13:00: All, I am putting the finishing touches to the updated version of Chapter 9 of the 6.2 Calc Guide and have found an existing sentence which I don't understand. The LibreOffice 4.1 Calc Guide contains a note as follows: "If you export a spreadsheet containing multiple operations to Microsoft Excel, the location of the cells containing the formula must be fully defined relative to the data range." Is anybody able to clarify exactly what this means? Have you tried an export to Excel? The import from a two-dimensional DataTable generates the correct MULTIPLE.OPERATIONS entries, but resave by LO does not produce files, which are shown correctly in Excel. The export to xlsx generates the function "MULTIPLE.OPERATIONS". But that function is unknown to Excel. The needed formula element with the attribute t="dataTable" is missing at all. The export to xls generates a file, which shows the correct entry {TABLE(...)}, if I open it in Excel, but the second reference is wrong and the template area is broken. But perhaps, I do something wrong. The DataTable tool in Excel expects the template formula in the top-left of an two-dimensional target table-area. So that is at least necessary in LibreOffice too, if you want an export. I was not able to generate a one-dimensional target table with one variable in Excel and so could not test roundtrip for them. So before wondering about some wording, you should test, whether the export works at all. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] How to repair broken image link in Wiki
Regina Henschel schrieb am 24-May-19 um 22:50: Hi all, the file https://wiki.documentfoundation.org/Development/Improve_handles_of_DrawingML_shapes has a broken link with text "Screenshot with references to the formula guide names" in section "Example “blockArc” and I do not find how to repair it. It should use https://wiki.documentfoundation.org/File:Annotated_screenshot_of_a_blockArc_shape_.png I have found a solution. If you insert the reference manually, then you have to write the underscore characters. If the link is inserted by the insert mechanism, the reference has no underscore characters. Curious. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
[libreoffice-documentation] How to repair broken image link in Wiki
Hi all, the file https://wiki.documentfoundation.org/Development/Improve_handles_of_DrawingML_shapes has a broken link with text "Screenshot with references to the formula guide names" in section "Example “blockArc” and I do not find how to repair it. It should use https://wiki.documentfoundation.org/File:Annotated_screenshot_of_a_blockArc_shape_.png Can anyone help me? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
Re: [libreoffice-documentation] Introducing Myself to LibreOffice Mailing List
Hi Tommy, in case you have no favorite part, what about writing about a new feature? E.g. write a little HowTo in the Wiki, so that it can be linked from the ReleaseNotes? https://wiki.documentfoundation.org/ReleaseNotes/6.1#Signature_Lines Or explain how to use "Remote Files" (menu File > Open Remote...) with an example of a concrete remote service? Or if you are looking for a larger topic, introduce the user to LibreOffice Online. You do not know anything about it? Then examine the existing texts. A good opportunity to notice, where they have shortcomings. But I'm not a regular member of the documentation team. So perhaps others have better ideas. Kind regards Regina Tommy Yang schrieb am 18.04.2018 um 20:34: Hello everyone, My name is Tommy. I just registered for the LibreOffice mailing list. I applied for the mailing list to learn and contribute to gain some technical writing experience with the hopes of breaking into the technical writing field. I was advised by current technical writers that this would be a good way to gain experience and learn about styling guides, project process flow, and the collaboration process as a whole. I do not have any prior experience with documentation or technical writing, but I would love to learn and contribute in any way I can. With regards to my educational and professional background, I graduated university in 2016 with a BSc in philosophy. Currently, I am employed as a customer/technical support specialist and have been in this position for several months now. Prior to this, I have always working in customer service and other customer facing roles. Regards, Tommy -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Introducing Myself to LibreOffice Mailing List
Hi Tommy, welcome in the LibreOffice community. Nice to hear, that you will help us in documentation. Do you have a favorite part of LibreOffice? Kind regards Regina Tommy Yang schrieb am 18.04.2018 um 20:34: Hello everyone, My name is Tommy. I just registered for the LibreOffice mailing list. I applied for the mailing list to learn and contribute to gain some technical writing experience with the hopes of breaking into the technical writing field. I was advised by current technical writers that this would be a good way to gain experience and learn about styling guides, project process flow, and the collaboration process as a whole. I do not have any prior experience with documentation or technical writing, but I would love to learn and contribute in any way I can. With regards to my educational and professional background, I graduated university in 2016 with a BSc in philosophy. Currently, I am employed as a customer/technical support specialist and have been in this position for several months now. Prior to this, I have always working in customer service and other customer facing roles. Regards, Tommy -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Missing example code syntax highlighting wrong indentation after help page updates
Hi Johnny, kla...@partyheld.de schrieb: Hello all, I've updated two BASIC help pages (Rnd and Randomize) and now noticed (on master) that the code examples on those pages lack syntax highlighting, and all examples have wrong indentation throughout BASIC help. Further details in https://bugs.documentfoundation.org/show_bug.cgi?id=99809#c4 Does anybody know what the problem could be? Does anything else need to be updated? Thanks in advance, Christian Lohmaier has updated the xsl filter to preserve the bascode-tags (2016-04-12). Do you have already got the current filters? Compare your versions with the versions in https://cgit.freedesktop.org/libreoffice/contrib/dev-tools/tree/helpauthoring/filter. It might be, that the current version is not yet included in the extension. But you can manually exchange the files if needed. If the bascode tags got lost, please open the help file in a text editor and add them. The extension has yet no UI to newly add the tags. The transformation for syntax-highlighting is then done while compiling. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Cant find the "Inserting a Horizontal Line"
Hi Yousuf, Yousuf 'Jay' Philips schrieb: Hi Regina, On 03/06/2016 02:23 AM, Regina Henschel wrote: Hi Yousuf, So can we recover this file? I don't know. The commit which removed it is https://cgit.freedesktop.org/libreoffice/help/commit/?id=0142ad19adb30534ba07908356f9139f0257c808 Kind regards Regina Thanks. I've sent in a revert patch. https://gerrit.libreoffice.org/22944 Then you need a follow-up patch, which removes the texts which belong to the no longer available graphical lines. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Cant find the "Inserting a Horizontal Line"
Hi Yousuf, Yousuf 'Jay' Philips schrieb: Hi Regina, On 03/04/2016 02:43 PM, Regina Henschel wrote: Hi Yousuf, It was /text/swriter/guide/insert_line.xhp Kind regards Regina So can we recover this file? I don't know. The commit which removed it is https://cgit.freedesktop.org/libreoffice/help/commit/?id=0142ad19adb30534ba07908356f9139f0257c808 Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Cant find the "Inserting a Horizontal Line"
Hi Yousuf, Yousuf 'Jay' Philips schrieb: Hi All, I cant find this help page in the repo though its there in the online help. Any help would be appreciated as i think the file may have been deleted when part of the functionality was removed in 4.0. https://help.libreoffice.org/Writer/Inserting_a_Horizontal_Line Yousuf It was /text/swriter/guide/insert_line.xhp Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Help-files: Large-scale 'cosmetic' changes
Hi Peter, try this www.jeanweber.com/books/ITHH_Ebook.pdf Kind regards Regina ptoye schrieb: Jean, I tried again and got this again: Not Found The requested URL /newsite/wp-content/uploads/ITHH_Ebook.pdf was not found on this server. Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request. I don't think it's my browser (Firefox) as the message seems to come from your server. Best regards, Peter mailto:l...@ptoye.com www.ptoye.com - Thursday, December 31, 2015, 3:44:22 PM, you wrote: Jean Weber wrote Free copy of PDF available here: http://www.jeanweber.com/newsite/wp-content/uploads/ITHH_Ebook.pdf Dear Jean, I get an error 404 from this link. Peter Peter If you reply to this email, your message will be added to the discussion below: http://nabble.documentfoundation.org/Help-files-Large-scale-cosmetic-changes-tp4169547p4170498.html To unsubscribe from Help-files: Large-scale 'cosmetic' changes, click here. NAML - Peter -- View this message in context: http://nabble.documentfoundation.org/Help-files-Large-scale-cosmetic-changes-tp4169547p4170510.html Sent from the Documentation mailing list archive at Nabble.com. -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Re: Possible help files rename?
Hi Jan, Jan Holesovsky schrieb: Hi Regina, all, Regina Henschel píše v St 18. 11. 2015 v 21:32 +0100: most of the file names are build of numbers and it is hard to identify the relevant file. That's indeed true :-) I wonder - would a large scale rename to something more readable (like eg. filename constructed from the tag) be more appreciated by people editing help? If you need the file name of the help page you are currently viewing, then a little change in the main_transform.xsl is needed to show the actually path. If you need the help page but only know UI strings or the uno command, then a search is needed anyway, because of embedding. You need no "grep", if you work on Windows, but OpenGrok will be sufficient for searching now and then. And for a local copy of the help files, modern editors have a tool for searching in files. I think, renaming is not needed and the effort is far too big. We can consider to document in the Wiki, how to change the main_transform.xsl file to show the file path. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Can I help?
Hi Peter, ptoye schrieb: Thanks Regina - I got it and installed it. I've now amended the relevant help page. Do I upload the whole page here, or just the bits I changed? Or send it somewhere else? This list strips attachments, therefore you cannot attach it here. LibreOffice uses its Bugzilla to track bugs, enhancements and feature requests. For how to use Bugzilla see https://wiki.documentfoundation.org/QA/BugReport#Submitting_a_bug If you do not have a Bugzilla account yet, you need to create one. https://bugs.documentfoundation.org/createaccount.cgi With using Bugzilla and an account there, your changes get the correct license automatically. "Product" is of cause LibreOffice. For changes in the help pages use the component "Documentation". I think it is better to attach the whole file. That way others can generate a diff file, which is needed in the further work flow. Look, whether a bug exists, that already describe the problem. If yes, then attach the changed file there. If no bug exists, create a new report. When creating a new report the form will have a button "Add an attachment". Use that to attach the changed file. Do not forget to describe, why the current version of the help page is wrong. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Help Writer's Guidelines
Hi Peter, ptoye schrieb: I agree. I am trying to improve a page at the moment, and it is not easy to see at one place what the original author meant. This may be a translation problem, and I realise that it is difficult if the translator is not an educated native speaker of the target language (in this case, UK English). The help pages are all in US-English. UK-English is a translation. Translation are not made in files directly, but translation are done via Pootle. https://translations.documentfoundation.org Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Can I help?
Hi Peter, I notice just, that the attachment was stripped. May I sent you the file directly? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Can I help?
Hi Peter, ptoye schrieb: Sorry, Regina, I was referring to the link about Building on Windows. I found the help files, but rather oddly the Base help files don't seem to be there, and it's one of those that I need to edit! There's a folder for almost every other LO application except Base. I'm looking in the libreoffice-5.1.0.0.alpha1\helpcontent2\source\text folder, which I assume is correct. That is correct, but most of the file names are build of numbers and it is hard to identify the relevant file. You can use a portion of the help page text and use a tool to search in files. Or you use the file I have attached. It will help you to identify which file is currently shown in the help viewer. How to use it: Close LibreOffice and go to the installation folder of your LibreOffice. There should be a folder "help". Open it. You should see a file 'main_transform.xsl'. Rename this file for example to 'main_tranform.xsl.orig', so that you can easily revert the change. Then put the attached file there. When you now start LibreOffice and open the help, you should see a header with the file name, for example: FOR DEBUGGING ONLY File name: /text/shared/main0108.xhp Of cause, for you it will not be 'shared/main0108.xhp' but it will be the file name, which belongs to the page, you are currently viewing in the help. That way it should be easy for you, to identify the path to the file, which holds the text content of the help page you are currently looking at. [The change I have made belongs to a couple of changes, which was used some years ago in OpenOffice to ease the work of translators. https://issues.apache.org/ooo/show_bug.cgi?id=56321] Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Can I help?
Hi Peter, ptoye schrieb: Thanks Regina, but this is exactly the sort of issue that I mentioned in my last post. If I have to download ( and learn how to use) Cygwin and Git before I can even get started, it's an instant turn-off! To use the extension you only need the original help files. Download http://dev-builds.libreoffice.org/pre-releases/src/libreoffice-help-5.1.0.0.alpha1.tar.xz unpack it and you can start working on the help. I give you the link to the "pre-release", because that is more up to date than the help files from the common download page. But the link you sent me seems to be for people who want to work on LO itself - I just want to edit a section in a help page, which is a bit different. Although I used to be a pretty good programmer, I don't have the time or inclination to get stuck into modifying LO, much as I'd like to. I thought it was clear which of those files are the help files, obviously not. I have now added the direct link above. You need neither the other source packages nor Cygwin to work on a help file. If all that is not comfortable for you, than open the help page you want to edit, set the cursor top-left, use Ctrl-A to mark the whole content, use Ctrl-C to copy it to clipboard, open a new Writer document and paste it. Save the document. Then proceed with change tracking as Lera has described. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Re: Can I help?
Hi Peter, ptoye schrieb: Ah - I see. I've installed the help authoring extension, and there's a new menu item. But now the Documentation/Help wiki article tells me that I have to set up a document root, which is in my clone of the help git repository - which of course I don't have. And as I don't know git I can't get much further! I'm closing down now for the night - so I won't be able to answer until tomorrow. You can download the current (master, upcoming version LO 5.1) help files from http://dev-builds.libreoffice.org/pre-releases/src/ 7-Zip can unpack it. It first makes a tar folder and therein a tar file, which you then have to unpack. You will get a folder "helpcontent2". When you do not have prepared the Cygwin-environment and do not clone via git, then you need to make a backup of the file you want to work on prior to your work. If you do not know how to make a unified diff file yourself, then you attach both the original and the changed file to the issue in Bugzilla. That way a committer can generate a diff-file and upload it to Gerrit for review. For starting this a suitable way, but in the long term you need to make a Cygwin-environment. Find a description on https://wiki.documentfoundation.org/Development/BuildingOnWindows [I have used that way, not the "lode" approach, mentioned there.] Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] license of new help files
Hi Jay, yes I have thought too to make it a child of the meta-element. Question is, whether we want to change all existing files and make the element mandantory, or we let existing files unchanged and make the element optional. Besides that, follow-up changes in the helpauthoring tool needs to be discussed, in case we agree to introduce such element. I'm waiting for a comment from Kendy, before actually start working (or not) on it. Kind regards Regina Yousuf 'Jay' Philips schrieb: Hi Regina, As the tag used to have child tag, maybe we can include a tag there which the help authoring tool write with new files and then the MPL license can be written to the header when that tag is seen. Column Row Headers /text/scalc/01/0307.xhp MPL Yousuf 'Jay' Philips On 10/26/2015 03:20 PM, Lera wrote: Hi Regina, В письме от 26 октября 2015 10:19:18 пользователь Regina Henschel написал: some contributors are not happy with ALv2 automatically included in the license for new help files, and it would by nice having a pure Mozilla license for new files. If we provide that, it will become necessary to keep the license, when the file is edited later on. Currently the license is an xml-comment (). That has the shortcoming that any xsl-transformation will loose it. Especially the helpauthoring tools looses any license information, when opening an .xhp file, and writes a default license including ALv2 when saving the file. To keep the license, I suggest to introduce a new element "license" in the doctype. Having such element, the helpauthoring tool can write the Mozilla license into the element "license" for new files. If the tool detects an element "license" when opening a file, it can keep it. If the tool does not detect such element, then it can generate an element "license" and write the current mixed license as its content. Does a tool exists, that automatically checks, that all files have got a license? Then it might be, that it would have to be adapted. If such element should become required, a script is needed to move the license text from kind xml-comment to element content. Would that produce a request for translation? What do you think about it? Can not we just do not touch the comments? Or do we need to be sure to lock them in the tag? Best regards, Lera -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Test xhp files
Hi Jay, Yousuf 'Jay' Philips schrieb: Hi All, Is there an easy way to test how an xhp file will be rendered, as i'd like to test them out before submitting them as a patch to gerrit, which will result in less bugs being introduced. you can use the macro attached to https://bugs.documentfoundation.org/show_bug.cgi?id=95064. Look into the code, it has a lot of comments. But you can use it only once, it will not update. I have not idea how to unlock the file while LibreOffice is running. If you want to preview the file a second time, you need to close and reopen LibreOffice. I have not found an easy way yet. The problem is, that you need LibreOffice's HTML-viewer, because the xhp files contain propriety protocols vnd.sun.star.xhp and vnd.sun.star.zip and new (which I have not tested with my macro) vnd.libreoffice.image. If you have build LibreOffice including helpcontent2, you only need to rebuild it to see your changes. That is currently the safest way. To catch slips of the pen, you can first open it in the browser, which detects things like a missing closing tag, or validate it against the xmlhelp.dtd. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] license of new help files
Hi Lera, read answer below. Lera schrieb: Hi Regina, В письме от 26 октября 2015 10:19:18 пользователь Regina Henschel написал: some contributors are not happy with ALv2 automatically included in the license for new help files, and it would by nice having a pure Mozilla license for new files. If we provide that, it will become necessary to keep the license, when the file is edited later on. Currently the license is an xml-comment (). That has the shortcoming that any xsl-transformation will loose it. Especially the helpauthoring tools looses any license information, when opening an .xhp file, and writes a default license including ALv2 when saving the file. To keep the license, I suggest to introduce a new element "license" in the doctype. Having such element, the helpauthoring tool can write the Mozilla license into the element "license" for new files. If the tool detects an element "license" when opening a file, it can keep it. If the tool does not detect such element, then it can generate an element "license" and write the current mixed license as its content. Does a tool exists, that automatically checks, that all files have got a license? Then it might be, that it would have to be adapted. If such element should become required, a script is needed to move the license text from kind xml-comment to element content. Would that produce a request for translation? What do you think about it? Can not we just do not touch the comments? It is not possible to keep parts while applying a xsl-transformation. The parser simply skips those parts, so after the transformation you do not even know, that such a part has exist. Or do we need to be sure to lock them in the tag? First I thought would be sufficient. But it is not good in a theoretical view, because one should specify elements for a single, well defined purpose. From a practical view, one would need additional effort to distinguish a license from other annotation. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] license of new help files
Hi all, some contributors are not happy with ALv2 automatically included in the license for new help files, and it would by nice having a pure Mozilla license for new files. If we provide that, it will become necessary to keep the license, when the file is edited later on. Currently the license is an xml-comment (). That has the shortcoming that any xsl-transformation will loose it. Especially the helpauthoring tools looses any license information, when opening an .xhp file, and writes a default license including ALv2 when saving the file. To keep the license, I suggest to introduce a new element "license" in the doctype. Having such element, the helpauthoring tool can write the Mozilla license into the element "license" for new files. If the tool detects an element "license" when opening a file, it can keep it. If the tool does not detect such element, then it can generate an element "license" and write the current mixed license as its content. Does a tool exists, that automatically checks, that all files have got a license? Then it might be, that it would have to be adapted. If such element should become required, a script is needed to move the license text from kind xml-comment to element content. Would that produce a request for translation? What do you think about it? Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Are id attributes needed on paragraphs and headings in .xhp help files?
Hi Jan, Jan Holesovsky schrieb: Hi Regina, Regina Henschel píše v St 07. 10. 2015 v 15:33 +0200: the doctype definition xmlhelp.dtd makes the id attribute of type REQUIRED in all cases. It is needed surely for sections and variables, because they are embedded elsewhere and need to be referenced. But is the id attribute needed for headings and paragraphs too? There exists already some files having paragraphs without an id attribute, and the files in the delivered .jar archives have stripped the attribute too. But I do not know whether processes exists, that need it. What about translation, or transformation to the Wikihelp, or the help compiler itself, or while generating the .jar files? If the id attribute is not needed, then the authoring tools can do without generating id values. Sorry for the late answer. From what I know, the paragraph ID's are not necessary for wikihelp, and I doubt they are necessary for the help compiler. Let me add the l10n team to see if they are necessary for the translations... Are they? I have looked in the .po files now. Each entry has the structure like this example #: anchor_object.xhp msgctxt "" "anchor_object.xhp\n" "par_id3151235\n" <-- here is always the id "52\n" "help.text" msgid "Anchors the selected item to a character." msgstr "Verankert das ausgewählte Element an einem Zeichen." So the id gets an individual line there. But I have not found further information about the structure. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Inconsistency in libo50_help/shared.po - about Bezier-points
Hi Sveinn, The problem is not the term "round point". It is used as broader term for "smooth point" and "symmetric point". So that would be OK for me. But the description itself is not correct. The icon ".uno:BezierConvert" toggles that path segment, that follows a selected point, between Bezier curve and simple line. The start of the whole sequence of segments, and with that the direction of the line, is indicated by a slightly larger handle. If several points are selected, they are treated independently. The last point of a line as no following segment and therefore the tool is not applicable to that point. If you convert a simple line to a Bezier curve the end points of this line segments get control points. They are placed on the line. As this segment has been a simple line, the end points had been neither "smooth point" nor "symmetric point". They are turned to kind "corner point" to keep the direction of the neighbor segments. If you convert a Bezier curve segment to a simple line, you cannot keep the kind "smooth point" or "symmetric point" for the endpoints of this segment. The control points which are associated with that segment are removed. That makes the endpoints to a corner point, if the neighbor segment is a Bezier curve segment, and to a simple point, if the neighbor segment is a simple line. If you write a bug report, set it to category "Documentation". Kind regards Regina Sveinn í Felli schrieb: Hi, sorry for cross-posting; Just stumbled upon a severe inconsistency in libo50_help/shared.po; Bézier-points in a smoothed line (called smooth transition in LibO) are sometimes referred to as "round points" [#. jEEYP and #. zrzrx] and sometimes as "smooth points" [#. rs4eN]. In Inkscape those are "smooth nodes" (not sure if node/point will confuse users, just keep it consistent). IMHO we should use "smooth points" in all those messages, and preferably we should change "Smooth transition" [#. wfmrx] and "Symmetric transition" [#. 7TELH] to "Smooth curve" and Symmetric curve" - or even just plain simply "Smooth point" and Symmetric point" The UI-part of the messages in question resides in libo50_ui/officecfg/registry/data/org/openoffice/Office/UI.po Anyone have an opinion? Should I file a bug? Tagged how? Best regards, Sveinn í Felli Messages in libo50_help/shared.po; #. jEEYP #: main0227.xhp msgctxt "" "main0227.xhp\n" "par_id3148420\n" "63\n" "help.text" msgid "" "Converts a curve into a straight line or " "converts a straight line into a curve. If you select a single point, " "the curve before the point will be converted. If two points are selected, the " "curve between both points will be converted. If you select more than two " "points, each time you click this icon, a different portion of the curve will " "be converted. If necessary, round points are converted into corner points and " "corner points are converted into round points." msgstr "" #. zrzrx #: main0227.xhp msgctxt "" "main0227.xhp\n" "par_id3150304\n" "64\n" "help.text" msgid "" "If a certain section of the curve is straight, the end points of the line " "have a maximum of one control point each. They cannot be modified to round " "points unless the straight line is converted back to a curve." msgstr "" -- #. wfmrx #: main0227.xhp msgctxt "" "main0227.xhp\n" "hd_id3166436\n" "27\n" "help.text" msgid "Smooth Transition" msgstr "" #. 7TELH #: main0227.xhp msgctxt "" "main0227.xhp\n" "hd_id3159622\n" "30\n" "help.text" msgid "Symmetric Transition" msgstr "" #. rs4eN #: main0227.xhp msgctxt "" "main0227.xhp\n" "par_id3155510\n" "29\n" "help.text" msgid "" "Converts a corner point or symmetrical point " "into a smooth point. Both control points of the corner point are " "aligned in parallel, and can only be moved simultaneously. The control points " "may differentiate in length, allowing you to vary the degree of curvature." msgstr "" -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Are id attributes needed on paragraphs and headings in .xhp help files?
Hi all, the doctype definition xmlhelp.dtd makes the id attribute of type REQUIRED in all cases. It is needed surely for sections and variables, because they are embedded elsewhere and need to be referenced. But is the id attribute needed for headings and paragraphs too? There exists already some files having paragraphs without an id attribute, and the files in the delivered .jar archives have stripped the attribute too. But I do not know whether processes exists, that need it. What about translation, or transformation to the Wikihelp, or the help compiler itself, or while generating the .jar files? If the id attribute is not needed, then the authoring tools can do without generating id values. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] contribute to LibreOffice help
Hi Joel, Joel Madero schrieb: [..] Is there a wiki somewhere with "tasks that need done" for documentation? I think it would be great to have one and tasks like this could be added - tracking the areas that need attention is the first step to addressing the problems. A meta issue for errors in the documentation itself: tdf#80430 An issue about problems with the helpauthoring extension: tdf#93580 I have started a dashboard for myself, feel free to add things there. https://wiki.documentfoundation.org/User:Regina/HelpAuthoringDashboard. I have suggested helpauthoring as topic for the hackfest in Hamburg. https://wiki.documentfoundation.org/Hackfest/Hamburg2015#Topics Producing an overview and structure, and consolidating the informations might be a task for that weekend. Perhaps others are interested. Problems with a special Wiki page can be discussed on its "Discussion" page. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] contribute to LibreOffice help
Hi Lera, Lera schrieb: Hi Sophie, you can find explanation to download the extension here: https://wiki.documentfoundation.org/Documentation/Help and some information to use it here: https://wiki.documentfoundation.org/HelpContent I have begun to see into the explanation https://wiki.documentfoundation.org/HelpContent and have faced some difficulties. Yes, it needs some improvements. This explanation is not full. I was able to understand where xmlhelptemplate.ott file is located in fact. But I had no idea where I am supposed to find maintransform.xml and allfiles.tree files. I'm not sure, but I think that there exists no current version of the file allfiles.tree, but only the old one, generated for OpenOffice.org. You find this old one attached to https://bz.apache.org/ooo/show_bug.cgi?id=56321. That file was surely generated be a script in times of Sun, but I don't know where it is and whether it still exists at all. The file gives you access to the help files in the local help viewer with the same structure as the files are arranged in the source. It adds a new section in the Contents tab of the built-in help. In the same old bug report, you find the files maintransform.xml and default.css. Here the same, I don't know whether a current version for LibreOffice has ever been produced. Nevertheless they can be applied on the built-in help. I know that these files are not required. But as far as I understand, it should make the work with help files easier. Could you explain this issue to me, please? These files help to locate the exact place in the source, when you see an error in the built-in help. They were used by translators to help Sun developers to fix the errors. But here in LibreOffice you need a local copy of the help files anyway to generate a patch for Gerrit. So these helpers are indeed not necessary. Nevertheless I have used them from time to time to make embedding and sections visible, before the extension was available. Read more about it in https://wiki.openoffice.org/wiki/Pootle_User_Guide/Technical_Helpers#Make_Your_Installation_Verbose, which also explains how to set the environment variable. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Re: Ease maintenance of build-in help
Hi Jan, Jan Holesovsky schrieb: Hi Regina, Regina Henschel píše v Ne 02. 08. 2015 v 19:06 +0200: I have started a new thread so that the problem is not hidden inside other threads or in private mails. First, is there consensus, that the current build-in help will be retained? Thank you for your thoughts on this topic - and sorry for my late reply. I'm late too. That happens for persons, who can only contribute in their spare time. In the ideal world, I'd like the help be handled like this: * wikihelp is the authoritative source, with appropriate approval system etc. [easy for casual contributors to fix stuff in the help, but safe easy to keep the standards] * existing translations converted so that there is no additional work for the translators when converting to wikihelp (once) A workflow is needed for new content and for new languages. When the built-in help is automatically generated, the translated Wikihelp needs to follow a strong structure. * built-in help is generated from the wikihelp + translatios, and shown in the browser (JavaScript used for the indexing search), instead of the home-grown help system The part extended tips is missing in this scenario. Currently we have the following pieces of the puzzle: * ability to convert .xhp's - wiki format * ability to convert wiki format - html The indexing IIRC is not retained at the moment, and also the JavaScript indexing is not implemented; so the switch is impossible in the current state. I am unable to work on this, but would be extremely happy to mentor anybody who would be willing to help. The Contents part (that what is generated from the *.tree files) is missing too. In addition the current Wikihelp misses reducing the UI, and the global search of the Wiki is no replacement for the search features of the built-in help. For the wikihelp itself, it might be possible to use the Mozilla's Kitsune (the engine behind support.mozilla.org): https://github.com/mozilla/kitsune but that needs checking - whether it is better for our purposes than the 'normal' mediawiki or not. I don't know about it; no comment. If not, then the following ideas are useless and starting would be waste of time. In such case, please stop me immediately. As you can see - the ideal world vision is long-term :-) So let's not allow perfect be enemy of the good, and improve the current workflow in the meantime. OK, let's start. I've put this as topic on https://wiki.documentfoundation.org/Hackfest/Hamburg2015 already. Will anyone be there and like to work on the problem with me? I collect here some ideas from some threads and mails: A Authors of help texts are allowed to start in ODF to discuss and finalize the content and appearance of the intended help texts. There should be a place in the repository to store such files. This way authors did not need deep knowledge of the technical structure of helpcontent2. The person who integrates the help texts into the build-in help need not be the content author. That's perfectly possible. Let's just use Flat ODF (.fodt) as the fileformat, and store the file next to the appropriate .xhp in the help repository. It would be still good to use the helpauthoring.oxt when generating the odt too, to use the appropriate fields, and to use the same template as the start. I have a person in mind, who know nothing about the structure of the help. But your are right, that using the helpauthoring template would be helpful, and that is possible even for a person with no knowledge about xhp and help structure. B Improve the extension HelpAuthoring and fix its bugs. The extension might be principally not suitable to generate the final version of a help file, but it is useful as start, because it sets a lot of the needed XML-elements and attributes automatically. The result might still needs additions and corrections, but that is less work, than writing all from scratch. Even if someone do not know all details about the help, he can start and deliver a file, which other then can improve and integrate. Definitely. The xslt filter that is responsible for converting fodt - xhp is actually trivial, I'm happy to fix bugs there when you send me the original .(f)odt, resulting .xhp (generated by the 'broken' helpauthoring.oxt), and the fixed .xhp (that is modified how it is supposed to look like). Some problems are not in the transformation but in the Basic code. I prefer to use Bugzilla and so make work visible. Shall I put you in CC in Bugzilla for such issues? C Provide a development section about the build-in help to the Wiki. It should not only contain a tutorial about help authoring but in addition a description how the current help works at all from a developer view, and how it is actually structured. I attempted that here: https://wiki.documentfoundation.org/Documentation/Help I'd like this page to become a kind of do this and that, and you'll have
[libreoffice-documentation] Re: Ease maintenance of build-in help
Hi Thorsten, Thorsten Behrens schrieb: Regina Henschel wrote: I have started a new thread so that the problem is not hidden inside other threads or in private mails. Thanks a lot! First, is there consensus, that the current build-in help will be retained? I think - the plan to go all-in for wiki-based help is on hold, until someone (Kendy?) has cycles to push it further. Would perhaps be good to extend https://wiki.documentfoundation.org/Development/Wikihelp with some status/plans/more details on what is missing where. Mmh. Ideally that would mean, that the ideas below are obsolete. But it seems to me, that the help is in a bad state currently: The Wikihelp is not yet authoritative and cannot be edited and has not all needed features, and the built-in help is difficult to maintain and is not adapted to get content from the Wikihelp and still needs to provide those features, that the Wikihelp lacks, especially the extended tips. I have added some comments to the linked page. A Authors of help texts are allowed to start in ODF to discuss and finalize the content and appearance of the intended help texts. There should be a place in the repository to store such files. This way authors did not need deep knowledge of the technical structure of helpcontent2. The person who integrates the help texts into the build-in help need not be the content author. Makes sense. For storing those WIP versions in the repo, I'm not sure that gives us much. Perhaps collaboration via owncloud or wiki works better there? Yes, it would have to be discussed, where such documents to store. The central point is, to allow a format, that is well known; so that authors need not learn any other authoring tool. B Improve the extension HelpAuthoring and fix its bugs. The extension might be principally not suitable to generate the final version of a help file, but it is useful as start, because it sets a lot of the needed XML-elements and attributes automatically. The result might still needs additions and corrections, but that is less work, than writing all from scratch. Even if someone do not know all details about the help, he can start and deliver a file, which other then can improve and integrate. Having a list of EasyHacks / Bugs somewhere would be a great start. And a possible topic for one of the upcoming hackfests. [..} Sounds like another obvious Easy/HardHack idea for a Hackfest? ;) Yes I agree, Help Authoring is a good topic for a Hackfest. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
[libreoffice-documentation] Ease maintenance of build-in help
Hi all, I have started a new thread so that the problem is not hidden inside other threads or in private mails. First, is there consensus, that the current build-in help will be retained? If not, then the following ideas are useless and starting would be waste of time. In such case, please stop me immediately. I collect here some ideas from some threads and mails: A Authors of help texts are allowed to start in ODF to discuss and finalize the content and appearance of the intended help texts. There should be a place in the repository to store such files. This way authors did not need deep knowledge of the technical structure of helpcontent2. The person who integrates the help texts into the build-in help need not be the content author. B Improve the extension HelpAuthoring and fix its bugs. The extension might be principally not suitable to generate the final version of a help file, but it is useful as start, because it sets a lot of the needed XML-elements and attributes automatically. The result might still needs additions and corrections, but that is less work, than writing all from scratch. Even if someone do not know all details about the help, he can start and deliver a file, which other then can improve and integrate. C Provide a development section about the build-in help to the Wiki. It should not only contain a tutorial about help authoring but in addition a description how the current help works at all from a developer view, and how it is actually structured. We can start with the document OOo2HelpAuthoring.pdf. The content has to be revised and adapted and extended. For example the .mk files are different than described in that document and the document describes the possibilities of the help format, but not all details of the actual realization. Having it in the Wiki keeps such knowledge available, when a help expert leaves the community. It can be adapted to future developments. Experts of different areas can better work together to collect help knowledge in one place, for example experts for Help to Wiki and experts for translating help. D It would ease work, when there would be a tool, that shows a .xhp file the same way as it it shown in the help viewer, so that it is not needed to build helpcontent2 every time when you test some changes in your way to the final version. And authors who use HelpAuthoring need not be able to build LibreOffice. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted
Re: [libreoffice-documentation] Help Authoring Extension
Hi Jan, Jan Holesovsky schrieb: Hi, I've spent some time today fixing the HelpAuthoring extension, and together with the Regina's fix (thank you, Regina!), I think it got to a usable state :-) https://wiki.documentfoundation.org/Documentation/Help describes where to get it, and the basic usage. There are some problems. You get the message The File ... is outside of your Document Root although that is not the case. Because the program faulty thinks this, it generates full absolute paths where they should be relative. From step by step execution I see, that the underlying reason is, that the program uses the property DisplayDirectory of the file picker and uses this value in writing paths in the configuration file helpauthoring.cfg and uses this values later on for some comparisons and for the test, whether it is a subdirectory. The problems are not in HelpAuthoring but it is bug https://bugs.documentfoundation.org/show_bug.cgi?id=70843 and for AOO https://bz.apache.org/ooo/show_bug.cgi?id=123544 or https://bz.apache.org/ooo/show_bug.cgi?id=110141. SetTitle of the file picker does not work too. But that has no consequences for HelpAuthoring. Kind regards Regina -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette List archive: http://listarchives.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted