[libreoffice-documentation] LibreOffice WikiHelp

2010-12-06 Thread Jan Holesovsky
Hi, I am sorry - I promised the LibO online help (WikiHelp) already the last week, but it haven't happened; it needed more work than anticipated :-( Either way, the good news is that I am currently uploading the files, and I'll make the site online as soon as it finishes, and I do few trivial

[libreoffice-documentation] Re: LibreOffice WikiHelp

2010-12-07 Thread Jan Holesovsky
Hi all, On 2010-12-06 at 17:04 +0100, Jan Holesovsky wrote: Either way, the good news is that I am currently uploading the files, and I'll make the site online as soon as it finishes, and I do few trivial checks; it should be later today (ETA 5 more hours, I am populating the database

[libreoffice-documentation] Re: [Libreoffice] LibreOffice WikiHelp

2010-12-08 Thread Jan Holesovsky
Hi Muthu, On 2010-12-08 at 19:40 +0530, Muthu Subramanian K wrote: I guess we should tie the 'help-welcome' (the page that opens when the user clicks Help-Help from menu) pages to the wiki/Main_Page or probably create a LibreOffice welcome help page (to point to the Writer, Calc, and other

[libreoffice-documentation] Re: [libreoffice-l10n] Re: Embedded parts and wikihelp/HC2

2010-12-17 Thread Jan Holesovsky
Hi Martin, On 2010-12-16 at 19:08 +0100, Martin Srebotnjak wrote: We can easily show a suggestion to download a localized version of the help on each and every page, if the language is not en_US. With your help (the l10n team), this can be even shown in the native language of the user,

[libreoffice-documentation] Re: [libreoffice-l10n] Re: Embedded parts and wikihelp/HC2

2010-12-17 Thread Jan Holesovsky
Hi Sophie, all, On 2010-12-16 at 18:07 +0300, Sophie Gautier wrote: How does that sound? If this plan is acceptable for all, I can go ahead, and start working on this :-) For me it is, and I think that every body will the happy with your proposal. Thanks a lot :-) I have just updated

[libreoffice-documentation] Better wording for 'Update links' question

2010-12-21 Thread Jan Holesovsky
Hi, https://bugs.freedesktop.org/show_bug.cgi?id=32548 The bug says: when I open a certain .odp document, I get a pop-up question asking Update all links? Yes/No Anybody who knows this functionality, can you please provide a better wording? ;-) Just post it here, I'll integrate it. Thank you

[libreoffice-documentation] Re: [Libreoffice] online registration menu element - 404

2010-12-29 Thread Jan Holesovsky
Hi Kami, On 2010-12-24 at 23:54 +0100, Kálmán „KAMI” Szalai wrote: If someone enables online registration menu element, and click on it gets a pege with 404 error. The address is: http://survey.libreoffice.org/user/index.php please put a redirector here, or we should change the link in LibO.

[libreoffice-documentation] Re: [Libreoffice] online registration menu element - 404

2010-12-29 Thread Jan Holesovsky
Hi Bernhard, On 2010-12-30 at 02:16 +0100, Bernhard Dippold wrote: But there already has been a thread on the marketing list (IIRC) asking for an improved user feedback in future - probably quite helpful for marketing and UX. If such a feature can be based on the present code, I don't

[libreoffice-documentation] Re: How does a documentation contributor work on help.libreoffice.org?

2011-08-08 Thread Jan Holesovsky
Hi David, Kohei, On 2011-08-08 at 09:30 -0400, Kohei Yoshida wrote: You should CC kendy when you need to ask him specifically. Yes, that works best - Kohei, thanks for CCing! :-) I'll be needing to work on help.libreoffice.org to contribute to the squashing of a few docs-related bugs. I

[libreoffice-documentation] MS Office - LibreOffice migration guide

2011-08-09 Thread Jan Holesovsky
Hi all, I was wondering - please, do you know of a recent MSO - LO migration guide? There seems to be an old migration guide that was written in the OpenOffice.org 2 times, but I was unable to find anything more recent. Do you know if there is something? Are the sources of the old one available

[libreoffice-documentation] Re: Ease maintenance of build-in help

2015-08-11 Thread Jan Holesovsky
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 -

[libreoffice-documentation] Re: Ease maintenance of build-in help

2015-08-11 Thread Jan Holesovsky
Hi Thorsten, Thorsten Behrens píše v Út 04. 08. 2015 v 17:06 +0200: 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. Added some details in the

Re: [libreoffice-documentation] Re: Ease maintenance of build-in help

2015-08-13 Thread Jan Holesovsky
Hi Regina, Jan Holesovsky píše v St 12. 08. 2015 v 07:44 +0200: 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

[libreoffice-documentation] Help Authoring Extension

2015-07-24 Thread Jan Holesovsky
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. More detailed user manual

[libreoffice-documentation] HelpAuthoring-3.1.4.oxt released

2015-11-11 Thread Jan Holesovsky
Hi, I've released a new version of the HelpAuthoring extension. It is available here: http://dev-www.libreoffice.org/helpauthoring/ Please upgrade to this version, it is recommended for real use - please help us creating the help pages! It needs LibreOffice 4.4 or later. The following has

Re: [libreoffice-documentation] Introduction

2015-11-12 Thread Jan Holesovsky
Hi Ava, Ava Jarvis píše v Ne 08. 11. 2015 v 22:21 -0800: > My software engineering background gives me the capability of additionally > taking on tasks for writing documentation geared towards developers. In > addition I have the writing and mentoring skills to write end-user > documentation,

Re: [libreoffice-documentation] Are id attributes needed on paragraphs and headings in .xhp help files?

2015-10-20 Thread Jan Holesovsky
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

[libreoffice-documentation] HelpAuthoring-3.1.1.oxt released

2015-09-07 Thread Jan Holesovsky
Hi, I've released a new version of the HelpAuthoring extension. It is available here: http://dev-www.libreoffice.org/helpauthoring/ Please upgrade to this version, it has the following fixes: * Keeps the leading '/' in (thanks to Regina) * Has better organized menu (thanks to Jay) * Forces

Re: [libreoffice-documentation] Help file tag questions

2015-09-11 Thread Jan Holesovsky
Hi Jay, Yousuf 'Jay' Philips píše v Pá 11. 09. 2015 v 02:49 +0400: > > The list of all attributes and tags that are stripped from the content > > when packing the help is here: > > > > xmlhelp/util/compact.xsl > > Couldn't find this file. Sorry, it's in the 'core' repo:

[libreoffice-documentation] HelpAuthoring-3.1.2.oxt released

2015-09-17 Thread Jan Holesovsky
Hi, I've released a new version of the HelpAuthoring extension. It is available here: http://dev-www.libreoffice.org/helpauthoring/ Please upgrade to this version, it is recommended for real use - please help us creating the help pages! It needs LibreOffice 4.4 or later. Jay is the hero of

[libreoffice-documentation] HelpAuthoring-3.1.3.oxt released

2015-10-05 Thread Jan Holesovsky
Hi, I've released a new version of the HelpAuthoring extension. It is available here: http://dev-www.libreoffice.org/helpauthoring/ Please upgrade to this version, it is recommended for real use - please help us creating the help pages! It needs LibreOffice 4.4 or later. The following has

Re: [libreoffice-documentation] Use of "allow to" in documentation

2015-12-03 Thread Jan Holesovsky
Hi Peter, Peter Toye píše v St 02. 12. 2015 v 16:13 +: > OK, when I have time I'll fix the wiki, That's the easy bit. Cool, thanks! :-) > For the help files, I already have a Git system on my PC (used with > Visual Studio Express), but don't know Gerrit at all. I'll read > through the

Re: [libreoffice-documentation] Use of "allow to" in documentation

2015-12-02 Thread Jan Holesovsky
Hi Peter, ptoye píše v Po 30. 11. 2015 v 04:28 -0700: > There's an example below taken from > https://wiki.documentfoundation.org/HelpContent#Make_Images_Appear which > shows the problem: three of these paras use "allows to", three don't, but I > think they all have the same meaning! This is

Re: [libreoffice-documentation] Help-files: Large-scale 'cosmetic' changes

2015-12-18 Thread Jan Holesovsky
Hi Tom, Tom Davies píše v St 16. 12. 2015 v 19:15 +: > It is about the Help Files. The Documentation Team may be able to > make some much-needed changes to the help-files. However, it is to > solve a problem that only exists in English. For all other languages > it is, beyond doubt,

[libreoffice-documentation] Re: [libreoffice-l10n] Possible help files rename?

2015-11-25 Thread Jan Holesovsky
Hi Martin, Martin Srebotnjak píše v Út 24. 11. 2015 v 21:57 +0100: > I am not sure we are talking about the same thing or that I understand > this correctly. > > They change the names of the help files (i.e. calc/01.po is now > calcsfirsthelpfilewithhelpaboutfunctions.po). For the migration >

Re: [libreoffice-documentation] Re: [libreoffice-l10n] Possible help files rename?

2015-11-25 Thread Jan Holesovsky
Hi Sophie, Sophie píše v St 25. 11. 2015 v 11:52 +0100: > Why do we want to change if the main_transform.xsl file is working now > correctly and allow an easy search? I agree that the file name remains > not easy to understand, but if a tool solve that, where is the issue > then? From my point

[libreoffice-documentation] Possible help files rename?

2015-11-24 Thread Jan Holesovsky
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

Re: [libreoffice-documentation] New writer

2016-02-26 Thread Jan Holesovsky
Hi Andrew, Olivier Hallot píše v Čt 25. 02. 2016 v 12:39 -0300: > Welcome Andrew > > Skilled writers are a jewel we care. > > Please follow the advise of the landing page of ODFAuthors.org to get > your account: > > "Please write to webmas...@odfauthors.org and request an account. (We > had to

Re: [libreoffice-documentation] 2016 budget proposals

2016-02-26 Thread Jan Holesovsky
Hi Sophie, Sophie píše v Pá 26. 02. 2016 v 13:51 +0100: > > Olivier is currently working on a webservice that is able to show the > > help online [and hopefully in a better quality than the current > > wikihelp]. > > Thanks to Olivier for this great work, I tested it yesterday and it's >

[libreoffice-documentation] XHP cleanup

2016-12-16 Thread Jan Holesovsky
Hi, I was interested to hear yesterday that there were discussions about abandoning XHP as the file format for the help files, and use plain HTML instead. I am (so far) convinced that the actual format is not the real problem here, and that with a bit of a cleanup, XHP will be as convenient as a

[libreoffice-documentation] Getting rid of 'oldref' in the help files

2016-12-16 Thread Jan Holesovsky
Hi Cloph, all, I've recently proposed some help cleanups on the documentation@ ML, and this is the first one of them. I'm cross-posting to l10n@ and documentation@ - this change is supposed to be transparent for L10n and Documentation teams, but they should know :-) The idea is to get rid of

Re: [libreoffice-documentation] XHP cleanup

2016-12-16 Thread Jan Holesovsky
Hi Olivier, Olivier Hallot píše v Pá 16. 12. 2016 v 08:52 -0200: > > I am (so far) convinced that the actual format is not the real problem > > here, and that with a bit of a cleanup, XHP will be as convenient as a > > format as HTML would be - but with the advantage that: > > The format is not

[libreoffice-documentation] Re: Getting rid of 'oldref' in the help files

2016-12-16 Thread Jan Holesovsky
Hi Jan, Jan Iversen píše v Pá 16. 12. 2016 v 16:27 +0100: > > this change is supposed to be transparent for L10n and > > Documentation teams, but they should know :-) > > It does not seem transparent for the few languages that do not use pootle (sl > and sr) please do not forget those. Thanks

Re: [libreoffice-documentation] Re: Getting rid of 'oldref' in the help files

2016-12-16 Thread Jan Holesovsky
Hi, khagaroth píše v Pá 16. 12. 2016 v 17:51 +0100: > > I hope you meant HTML 5, because XHTML is a dead end (and good riddance). > > html does not have markup for some of the semantics that we have (and need) > > in the help files (like or to name few) > > > > Both and are part of HTML 5

Re: [libreoffice-documentation] XHP cleanup

2016-12-16 Thread Jan Holesovsky
Hi Bubli, Katarina Behrens píše v Pá 16. 12. 2016 v 18:20 +0100: > > Going further, we can later change 'paragraph' to 'p', introduce 'h2' as > > a shortcut for too, if we with so; > > but for the moment, I think there are XHP features that are worth > > keeping, because as a format, it gives

Re: [libreoffice-documentation] Re: Getting rid of 'oldref' in the help files

2016-12-19 Thread Jan Holesovsky
Hi Olivier, Olivier Hallot píše v So 17. 12. 2016 v 14:54 -0200: > One thing I'd like to add for evaluation of using XML for the help > contents in browsers is that, in my experience: > > * XSLT (XML style sheets), XPath and XQuery are another technologies > to master. > > * An error in a

[libreoffice-documentation] Default value ("en-US") for the "xml-lang" attribute in XHP files

2016-12-21 Thread Jan Holesovsky
Hi, This is one more from the 'cleaning up XHP files' series... At the moment, the "xml-lang" attribute in the markup in the XHP files is mandatory. But I see no reason for that, it is always just "en-US", the different locales make sense only for extensions, so I have created this patch:

Re: [libreoffice-documentation] Re: Default value ("en-US") for the "xml-lang" attribute in XHP files

2016-12-22 Thread Jan Holesovsky
Hi Tom, Tom Davies píše v Čt 22. 12. 2016 v 10:12 +: > Perhaps a header section, like html rather than document-headers? Is > that even possible in xml? Good point, in principle this would be possible; will keep this in mind. Though, this is not the most important thing at the moment,

[libreoffice-documentation] Getting rid of 'l10n' attribute in the help files

2016-12-19 Thread Jan Holesovsky
Hi, As discussed in the other mails, 'l10n' is another attribute I'd like to remove from the help files. It is unused in the code, and the documentation says: "Contains the localization status of the old help files and is only used for migration purposes." - which has happened years and years