[libreoffice-documentation] Re: Fonts, highlighting etc in user guides
I did an exhustive search of the available characters, and include some results in the discussion of options in my latest Template update. Basically, there is no right-arrow character that matches the typography of letters of the words it would go between, in the freely available fonts I'm aware of, without needing more tricks with the enclosing paragraph's style as well! In particular, mathematical and symbol fonts have a bad value for total height so it makes the lines jump apart; this can be fixed by using an exact spacing of lines. Short of drawing it ourselves in our own font, I'd say stick with the plain '' character. It's too bad the designers of body fonts don't draw the right-arrow to look like a - ligature or like the appearance in the code charts; instead it is a useless speck! But that's where we are now. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Re: Quick reference cards
I just looked at http://wiki.documentfoundation.org/File:LibreOffice_Tri-fold_Reference.odt, and it showed me content not fitting properly on pages that were 8.5 × 11 inches with 0.79 inch margins. The page size is not set to A4, but apparently tries to use the default styles of whoever opens the file. I don't know how to control that, but I would like to know. A document with a careful layout like that should have its paper and margins recorded along with the content! Auto-layout would make more sense for flowing material, but even then I think it deserves a warning, like when updating a template. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Re: Identification of documents across languages
1) The versioning system should be totally independent of Alfresco's versioning, So, every time I post an updated version of a document such that it can be freely read and used by others (e.g. update it on Alfresco), I must also manually obtain a new portable version number, put that in the file when saving it, and associate where that version can be found? No thanks. There is no need for yet another versioning system. We just require that versions exist and are weakly ordered. That already is present. We do not need the same mechanism and versioning authority to be used everywhere. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Re: Identification of documents across languages
So the translators are required to only take the published final version? I thought they would grab changes at any time and incorporate them, as they felt like it. Certainly the released version number would be in meta-data. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Still can't use Nabble to Reply
I've submitted the request half a dozen times now, subscribed to the list (again) via the Nabble screen, and everything else anyone has suggested. Who should I pester? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Use of '⌘' character
Using the used fonts extension, I found a few things, including use of Wingdings of all things! Searching for that, I found it used in Note for Mac users, which is present in every document and comes from the template. It turns out that the Command Key symbol is typed using the 'z' character and changed to Wingdings font. My understanding is that this font is including (only) on Microsoft Windows. So, the Mac users whom this is aimed at will see a 'z' instead, or perhaps something goofy as it gets substituted with some random symbol font. Is it actually visible on people's Mac's? The character '⌘' encoded as U+2318. I see that it is not present in the Liberation fonts used by the main text, but it shows up anyway in the document. I presume this is some kind of font fall-back ability. So, at least using the standard Unicode character will show up even if the needed font is absent! And what font to use? Linux Biolinum Kb has it, but in a key cap outline. That may be OK for this specific usage, though it doesn't match the other key-typing explanations. I also note it is in some of the DejaVu fonts, which appear to have been used in previous versions of the OOo documents, and Symbola, available at http://users.teilar.gr/~g1951d/ and free for any use. I think we should change this in the Template and throughout. Thoughts? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Use of Nabble and/or Mail to Thread Discussion ?
On 2/7/2011 10:43 AM, David Nelson commerce-at-traduction.biz |LibreOffice Documentation Mailing List/Allow to home| wrote: Hi, :-) On Mon, Feb 7, 2011 at 21:54, John M. Dlugoszd6474gh...@snkmail.com wrote: So that wasn't it, or something else is up. I don't know, but I send you a load of documentation and it's been bouncing, and now failed permanently: Delivery to the following recipient failed permanently: d6474gh...@snkmail.com Technical details of permanent failure: Unspecified Error (SENT_MESSAGE): Connection reset by peer Any connection? David Nelson I forwarded that to the support form of sneakemail. He raised the time-out to 5 minutes; said you might have a slow connection. If there are more problems, check with Kevin at webmast...@sneakemail.com. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] What's Next?
On 2/7/2011 2:06 PM, David Nelson commerce-at-traduction.biz |LibreOffice Documentation Mailing List/Allow to home| wrote: Hi, :-) On Tue, Feb 8, 2011 at 03:45, Rogerio Luz Coelholuz.roge...@gmail.com wrote: Hopefully forever? If you guys feel that 10 hours is not enough then I can extend it further. Although I'll be checking that there are no technical reasons why it's not a good idea to have such a policy. David Nelson Why does it need to care? If I have my cookies, why can't I go to the same URL I would go to after giving my password yet again? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Template Thoughts and Update
I updated LibO3_3_chapter_template.ott in various. I left change tracking on, so you can see what I proposed. * It already mentions that names of books and such should use the Emphasized style. Although I recall from grade school treating the names of books and the names of stories differently, I suppose for simplicity we can have just one. But, how would we hyperlink/cross reference the name of a different chapter, or worse yet, the name of a section within a different chapter? * The OTT file already notes that there are styles for Menu Paths and certain UI elements. I saw that they were not always used, and in fact did not notice such a style at first. The template admonishes against ever using Bold and Italic or other changes directly. It states that names of dialog boxes are in plain text. I changed that to refer to a new LibOUiItem style, which I defined to look exactly like the existing OooMenuPath style. Also, use the same treatment on all elements uniformly; buttons are not different from field labels, etc. As for the appearance of the menu path separators, I made a User Field for that. Apparently, as far as I can tell, I can insert text but not associated complex formatting. Is there a fancier mechanism available? So, you need to use the field to insert whatever character and spacing is used, and also apply a character format to just that part. And, the whole of the substitution needs to work with a single style. At least, once that is done, you can change the arrow character, it spacing, and its style globally and it changes everywhere. Related question: does the template changer add-in pull in User Fields? Do they normally replicate in the manner of a style change when you open the document again? * What fonts are used? What fonts can/should we use? I noticed another stray bit of formatting in the OTT file: one word was in Bitstream Vera Serif. And in the chapter I looked at initially, the contents of a table is DejaVu Serif and the table headers in DejaVu Sans. Looking closely now, that is not the definition of the styles, so it was applied directly. Is there a tool to show what fonts are being used in the document? It would help identify stray formatting. Likewise, is there a way to identify or search for any ad-hoc formatting, as opposed to text that only gets its attributes from named styles? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Use of Nabble and/or Mail to Thread Discussion ?
On 2/6/2011 11:28 PM, John M. Dlugosz d6474ghtgy-at-snkmail.com |LibreOffice Documentation Mailing List/Allow to home| wrote: I did register with Nabble. On the Nabble screen, I clicked other options and told it to subscribe me to the list. I replied to the email it sent to confirm. I notice it mentioned the nomail option. Note that I'm already subscribed to the list with the same email address used to register Nabble, but in case it proxies things or uses different options, I did that. Note that I did not get any warning from the list concerning already being subscribed, not did it change the options and stop sending mail on the original subscription. But, I still cannot Reply using Nabble. So that wasn't it, or something else is up. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Misc. Documentation Notes
* Example, covered in Chapter 1, Introducing Writer. Should the name of another chapter be in italics or something? Or even hyperlinked? Actually, it should have a character style assigned. * Similarly, in the Writer guide under Finding and replacing text, names of UI elements are variously unmarked, italic, or bolded. Which should it be, under what conditions? I consistently made sure they were bolded, or occasionally names of fields or tabs in italic. But, should buttons be bold and fields be italic? That is, the rules need to be nailed down. And, rather than just ad-hoc bolding, there should be a char style defined for that. * I also note that the '→' character used in menu paths, set in Liberation Mono and bold, does not look good at all. The arrow head is too small, and it has thinner strokes than the text it is separating. * We should share a project-specific dictionary with words like 'autocorrection' and 'autotext'. Having a dictionary, rather than just ignoring the wavies, will help ensure consistant terminology and spelling. * I see the phrase time-varying data where the hyphen is shaded as if a field. But It's not telling me what this shading means. No tool-tip or interesting information when I right click. How do I find that? * Note that choosing default formatting for a selection via the context menu does not save a Formatting change note! Somehow a whole bunch of copies of the word options were in a funny font. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Alfresco: Notice of server restarts over the next few hours
On 2/6/2011 3:18 PM, David Nelson commerce-at-traduction.biz |LibreOffice Documentation Mailing List/Allow to home| wrote: Hi, :-) Initially, they will be sent to this list. Usually, there would not be an inordinate number of them, but we'll just have to watch, and you guys will have to tell me if they're an irritation. David Nelson Just make sure there is a unique header added, or something in the Subject line, and we can sort it into a basket just for those. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Misc. Documentation Notes
On 2/6/2011 12:58 PM, Barbara Duprey Barb-at-onr.com |LibreOffice Documentation Mailing List/Allow to home| wrote: I summarized what the template itself had to say about the use of styles (see Terminology and Styles under various) -- I noted where I thought new styles looked useful. But the response I got about trying to do this level of update was basically, Let's get the documents out first, and clean up this kind of detail later. Is that still the case? I don't know if anybody else has looked at that document yet, it will need updating when we focus more on this type of issue. I'll peruse what is under various, if that's where such notes can be found. My two cents: If I'm proofing for any reason and notice such things, I'd like to be able to mark them. It doesn't mean it is necessary to be complete at this point or that such a mark has any effect in the output, but it will save having to look for them again later. So simply having a style defined would be helpful. We can decide on exactly how it should look, and make sure they are all covered, later. Until then, set a subtle effect for draft work and no difference from normal text on final output, so user's won't see it. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Problems with my first Alfresco attempt
On 2/6/2011 8:43 AM, David Nelson commerce-at-traduction.biz |LibreOffice Documentation Mailing List/Allow to home| wrote: Hi John, :-) How is your experience with Alfresco going now? David Nelson I got it sent to drafts, but it incremented the version twice. I assume that's from the aborted attempt earlier. If I'm not doing it right, let me know. I do notice that when it times out, the log-in does not take me back to the page I was on. If I use the browser history, it gives an internal scripting error on the server. But, if I use my history back to a previous log-in, then click through it again, then it does take me back to the screen I was on! Strange. If supplying the log-in again (why not just use my cookie?) doesn't take me back to where I was trying to go, it will always be considered a bug. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Use of Nabble and/or Mail to Thread Discussion ?
I'm following these discussions and doing the documentation editing on my laptop, which is not my main computer where I have my email set up. I can't Reply using Nabble, since it says I don't have permission (why?). I can send out a top-level message to start a new thread by sending it to the list address, no problem. But how can I keep the discussion thread when I don't have the original message in an email program to reply to? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Completed Review of 0203WG3-WorkingWithText.odt
I completed my pass of 0203WG3-WorkingWithText.odt, but I still cannot Update it! So please take heed that I have a lot of work on this that is in limbo, and don't edit the same file. I found a few things that need attention (not counting graphics updates), and since the document is all or nothing I'll kick it back to Drafts for someone to take a look at the indicated notes. Other changes I've made myself, which are either purely copy editing or based on the behavior I'm seeing. Everything's under Record Changes. I would think that we should all have Changes and Comments visible when working on any of this stuff, as a matter of course. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Re: Use of Nabble and/or Mail to Thread Discussio
Barbara Duprey wrote: Are you subscribed to the list, at least with -nomail? For some reason, this setup works differently than the OOo/ezmlm lists; I've seen some indications that people need the -nomail subscriptions here. I subscribed using documentation-subscr...@libeoffice.org, as the links indicated. I used the same email address there as when registering with Nabble. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Joining the Documentation Team
Howdy, everyone! I'm an experienced technical writer, having published in numerous magazines including several covers. I'm also an experienced technical editor and copy-editor for technical material. I've been a practicing C++ developer for many years, and right now I want to turn again to writing. I'd like to get involved with the LibreOffice documentation, as soon as I can. --John -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Joining the Documentation Team
On 2/4/2011 3:23 AM, David Nelson commerce-at-traduction.biz |LibreOffice Documentation Mailing List/Allow to home| wrote: Is there anything specific you'd like to work on, or would you like to be suggested some possible work waiting to be done? David Nelson I'm open to suggestions. I think I could be productive if I had some copy-editing and proofing to do, as I could nibble away at that while I'm not pounding away on my Science Fiction or other authoring work. I'm particularly talented at finding inconsistencies in technical docs, and I just love fixing punctuation and formatting nits in the Wikipedia articles I read g. I've been browsing through the archive here, and trying to understand the situation. I think the wiki should be updated with an answer so it doesn't need to be gone over every time someone comes in. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Problems with my first Alfresco attempt
I clicked on Edit Offline and got: Please correct the errors below then click OK. * Unable to check out Content Node due to system error:Transaction didn't commit: 01050007 Failed to send email to:[documentationmailinglist] The file did in fact download, and there is no OK link of button. The Custom view shows that it is still not locked, but the Details view has my name on it as 'modifier'. Please help. -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Alfresco Workflow Questions
Documents are edited, reviewed, proofed, and proofed again. So what am I supposed to do in the 'review' or 'proof' stage? Fix things myself? I think that serious content problems would get a 'comment' and sent back to drafts; likewise something that needs discussion. But typos, small formatting nits, and punctuation? Easier to fix than to explain! Do I make such changes with change-tracking turned on and let the next proofer vet it? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] Problems Updating in Alfresco
Location: /LibreOffice/LibreOffice Documentation/en/Writer/Working/Review file: '0203WG3-WorkingWithText.odt' I uploaded a new version, but got the same error sending email. I can't tell if it actually took my new version or threw it away. Assuming it was taken, y'all can see that I added comments and a few edits with change tracking turned on. I've not made it all the way through the file yet, but I'd like to know if I'm doing it OK. I mean I know the notes and edits are sound and at least worthy of discussion for someone else to accept/reject, but I mean how does this fit with the workflow idea being set up? -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://listarchives.libreoffice.org/www/documentation/ *** All posts to this list are publicly archived for eternity ***