Re:[libreoffice-documentation] Embedding images of toolbar button icons within text paragraphs
Agree. When I translateed Getting Started Guide 6.0 from English to Simplified Chinese in 2019, I have to find the source files of those small icons, which is very troublesome. At 2020-06-25 15:22:17, "Steve (GMail)" wrote: >All, > >First, many apologies if this topic has been discussed before in this >mailing list. I have a suspicion that it may have been, but I could not >locate the thread. > >The Calc Guide contains many cases where a small image is included in a >text paragraph, showing the icon that appears on a toolbar button >mentioned in the paragraph. My view is that these images are undesirable >for the following reasons: >I assume that they are included to help the user to identify the >relevant icon on his screen. However, given that the user is able to >customize his / her copy of LO by selecting from one of many icon sets >(via the Tools > Options > LibreOffice > View dialog), I think that in >many cases the images may hinder a user rather than help. We are in >danger of confusing and delaying him / her by showing an image of an >icon that is not displayed on his / her screen.Because these images are >inevitably taller than the normal line of text, they often cause extra >white space to appear within text paragraphs which I think is ugly and >does not improve readability. >I am not convinced that such images embedded in paragraphs provide the >reader with any useful information or context and would prefer not to >use them. Instead I would make sure that every reference to a toolbar >item names the button correctly and consistently. By correctly, I mean >that we use exactly the name that appears in the button’s tooltip when >using the English(US) version of Calc (omitting any mention of shortcut >key sequences). > >Would anybody object if these images were to be removed when we produce >the 7.0 Calc Guide? > >Regards, > >Steve >-- >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
Re: [libreoffice-documentation] Meeting Minutes - Doc team meeting of 5/21/2020
Hi! shameless plug: the extension is now available here https://extensions.libreoffice.org/en/extensions/show/875 HTH. Best, -- Jean-Francois Nifenecker, Bordeaux -- 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] Impress Guide Chapter 1
Hi Peter I’ve completed the review. All seemed good when testing. Just a few missed and extra keystrokes to report. Both chapter 1 and preface now booked back in and spreadsheet updated. Best wishes Claire -- Best wishes Claire Wood -- 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] Helping with the 7.0 Calc Guide
Hi Gordon, I hope that you are okay. During the coming days, I intend making some tidy-ups to the Calc Guide’s .ODT files, in preparation for the 7.0 update. This is probably a one-person job. However, while I am doing these edits. there are a few related matters that somebody could address. As you have expressed an interest in continuing to help with the Calc Guide, maybe you would like to address some or all of these? Somebody could create a 7.0 structure in the Calc Guide area of NextCloud. This will require the same folders as the 6.4 structure. It will also need a tracking spreadsheet like that used for 6.4, but with the various dates etc. deleted, ready to start afresh.Somebody could investigate the LO extension called “Code Highlighter” (https://extensions.libreoffice.org/en/extensions/show/code-highlighter) to see whether we can use it to improve the appearance of the macro code segments that appear in Chapters 12 and 13 of the Calc Guide. This extension was discussed and recommended in a recent Documentation Team meeting, but I have not had time to see what impacts it will have on our chapters.Reading the 7.0 Release Notes, you may have noticed that Calc 7.0 has two new functions, RAND.NV() and RANDBETWEEN.NV(). Although we do not need to discuss the gory detail of these two in the Calc Guide (covered in Help and, eventually, on the Calc Functions wiki), their very existence leads to asking “what is a volatile function?”. Therefore, I think we need to draft a new (short) section to be put into Chapter 7 (Using Formulas and Functions) of the Calc Guide to discuss the concept of a volatile function in Calc. (The word “volatile” does not appear in the 6.4 version). Somebody could have a go at drafting such a section in a standalone ODT file, to be entitled “Volatile functions”? Sources of background information include:•The Release Notes for 7.0 (https://wiki.documentfoundation.org/ReleaseNotes/7.0#New_spreadsheet_functions) and maybe the discussions that took place in progressing the associated bug (127831). •ODF version 1.2 (http://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part2.html) – see Section 3.5 “When recalculation occurs”. •The source code contains a function entitled “IsOpCodeVolatile” which determines whether a function called by a user is volatile or not. From this code I have gleaned that the volatile Calc functions are: RAND, RANDBETWEEN, NOW, TODAY, FORMULA, INFO, INDIRECT, and OFFSET. •The descriptions of the two new functions that have been included in the Help system at https://help.libreoffice.org/7.1/en-US/text/shared/05/new_help.html. Let me know if you need any more information or help. Regards, Steve -- 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] Embedding images of toolbar button icons within text paragraphs
I totally agree with removing inline toolbar button images for those reasons and others, and I have been removing them from the Writer Guide. Saves a lot of work for the book’s maintainer, too. Jean On Thu, 25 Jun 2020 at 18:22 Steve (GMail) wrote: > All, > > First, many apologies if this topic has been discussed before in this > mailing list. I have a suspicion that it may have been, but I could not > locate the thread. > > The Calc Guide contains many cases where a small image is included in a > text paragraph, showing the icon that appears on a toolbar button > mentioned in the paragraph. My view is that these images are undesirable > for the following reasons: > I assume that they are included to help the user to identify the > relevant icon on his screen. However, given that the user is able to > customize his / her copy of LO by selecting from one of many icon sets > (via the Tools > Options > LibreOffice > View dialog), I think that in > many cases the images may hinder a user rather than help. We are in > danger of confusing and delaying him / her by showing an image of an > icon that is not displayed on his / her screen.Because these images are > inevitably taller than the normal line of text, they often cause extra > white space to appear within text paragraphs which I think is ugly and > does not improve readability. > I am not convinced that such images embedded in paragraphs provide the > reader with any useful information or context and would prefer not to > use them. Instead I would make sure that every reference to a toolbar > item names the button correctly and consistently. By correctly, I mean > that we use exactly the name that appears in the button’s tooltip when > using the English(US) version of Calc (omitting any mention of shortcut > key sequences). > > Would anybody object if these images were to be removed when we produce > the 7.0 Calc Guide? > > Regards, > > Steve > -- > 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
Re: [libreoffice-documentation] Embedding images of toolbar button icons within text paragraphs
Hello Steve I have to agree with you. Icons are pointless because they can be changed by user. The name in text has to match tool being used. I am not using icons in Impress and Draw guides. Regards Peter Sent from my iPhone > On 25 Jun 2020, at 10:22, Steve (GMail) wrote: > > All, > > First, many apologies if this topic has been discussed before in this mailing > list. I have a suspicion that it may have been, but I could not locate the > thread. > > The Calc Guide contains many cases where a small image is included in a text > paragraph, showing the icon that appears on a toolbar button mentioned in the > paragraph. My view is that these images are undesirable for the following > reasons: > I assume that they are included to help the user to identify the relevant > icon on his screen. However, given that the user is able to customize his / > her copy of LO by selecting from one of many icon sets (via the Tools > > Options > LibreOffice > View dialog), I think that in many cases the images > may hinder a user rather than help. We are in danger of confusing and > delaying him / her by showing an image of an icon that is not displayed on > his / her screen.Because these images are inevitably taller than the normal > line of text, they often cause extra white space to appear within text > paragraphs which I think is ugly and does not improve readability. > I am not convinced that such images embedded in paragraphs provide the reader > with any useful information or context and would prefer not to use them. > Instead I would make sure that every reference to a toolbar item names the > button correctly and consistently. By correctly, I mean that we use exactly > the name that appears in the button’s tooltip when using the English(US) > version of Calc (omitting any mention of shortcut key sequences). > > Would anybody object if these images were to be removed when we produce the > 7.0 Calc Guide? > > Regards, > > Steve > -- > 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] Embedding images of toolbar button icons within text paragraphs
All, First, many apologies if this topic has been discussed before in this mailing list. I have a suspicion that it may have been, but I could not locate the thread. The Calc Guide contains many cases where a small image is included in a text paragraph, showing the icon that appears on a toolbar button mentioned in the paragraph. My view is that these images are undesirable for the following reasons: I assume that they are included to help the user to identify the relevant icon on his screen. However, given that the user is able to customize his / her copy of LO by selecting from one of many icon sets (via the Tools > Options > LibreOffice > View dialog), I think that in many cases the images may hinder a user rather than help. We are in danger of confusing and delaying him / her by showing an image of an icon that is not displayed on his / her screen.Because these images are inevitably taller than the normal line of text, they often cause extra white space to appear within text paragraphs which I think is ugly and does not improve readability. I am not convinced that such images embedded in paragraphs provide the reader with any useful information or context and would prefer not to use them. Instead I would make sure that every reference to a toolbar item names the button correctly and consistently. By correctly, I mean that we use exactly the name that appears in the button’s tooltip when using the English(US) version of Calc (omitting any mention of shortcut key sequences). Would anybody object if these images were to be removed when we produce the 7.0 Calc Guide? Regards, Steve -- 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[2]: [libreoffice-documentation] LOv7 template
Please could whoever collates the final version of the LO7 template note the following about the section entitled Using LibreOffice on macOS? F5 is the macOS keyboard shortcut to access the Navigator, not Shift+⌘+F5. In the 6.4 Calc Guide I therefore replaced that row of the table with “Ctrl+Q | ⌘+Q | Exit / quit LibreOffice”. Not a particularly enlightening example I know but hopefully valid. In the final row of the table, I feel that Sidebar warrants an initial capital letter. Maybe Effect entry could read “Open the Sidebar’s Styles deck”? Regards, Steve -- Original Message -- From: "Steve (GMail)" To: "Documentation Team" Sent: 24/06/2020 19:51:40 Subject: Re: [libreoffice-documentation] LOv7 template All, As there are enough people contributing to this discussion, I do not wish to raise any further suggestions. However, I do want to say that I fully agree with Jean's points 1) to 8) below. Whatever the outcome of this discussion, I hope that we can all agree to use one template consistently, without applying our own preferred customizations. Regards, Steve -- Original Message -- From: "Jean Weber" To: "LibreOffice Documentation" Sent: 24/06/2020 11:03:50 Subject: [libreoffice-documentation] LOv7 template Changes needed or recommended: 1) Remove the colon (:) after Note on the copyright page. 2) I don't think the line "This book is adapted and updated from [Guide Name] OpenOffice.org 3.3" is needed any more. I have been removing that line from the Writer Guide and some other books. 3) I would change the "To this edition" and "To previous editions" headings to something that is not going to show up in the TOC. 4) Why is the Published [date] line in italics? I would make it normal Roman font. 5) Remove "a" from "Using LibreOffice on a macOS" heading on page 5. 6) Having the section "Using LibreOffice on macOS" on p5 makes it look like that should be on the first page of every chapter, but it should instead be on the Copyright page. 7) Serif font is more difficult to read on screen than sans-serif, so I would return the body text and other styles to Liberation Sans. 8) I have now seen the heading colours for the different books and (as discussed in a different thread) I think we should not use different colours. Also, if different colours were to be used, I think the underline (border) colour should match the font colour. 9) I made some changes to the explanations in the template while I was working on the Contributors' Guide. I recommend they be incorporated here, or at least given serious consideration. I thought I had uploaded my draft LOv7 template several weeks ago, but I can't find it, so I've now done so. Here is the link: https://nextcloud.documentfoundation.org/s/yLJCPaqqoTSzGz3 Jean -- 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
