XHP Help online to assist translators

l10n
#1

Hi

As some of you know perhaps, I have set a web site that is able to
display the help pages (.xhp) directly on a browser (except Microsoft
browsers, saddly)

As a translator myself I found it interesting to display the page where
the string is located. It helps to understand the context of the string
to translate and to improve quality.

For example, if I am translating string 'xSbDA' located in page
'03060000.xhp' of 'libo_help/smath/01.po', I can visit the page in
English at the address

http://vm173.documentfoundation.org/text/smath/01/03060000.xhp

The Pootle server in translation mode shows all information to access
the page, but there is no automatic connection between vm173 and Pootle.

The help online has been loaded with the latest master help contents,
updated just today. What you see there may be a little in advance of the
exisiting copy in pootle. I believe this shall not be an issue for most
of you.

Another usage of this service is to browse or review help pages ad-hoc
and check for consistency, precision and linguistics of its contents.
The top right area displays info on the xhp file, so it makes it easy to
pinpoint the page to improve.

I hope some of you will find interesting to access vm173.

regards

#2

Wonderful, thanks a lot Olivier!

Cor

#3

I have set a web site that is able to

display the help pages (

I like the idea.

The help online has been loaded with the latest master help contents,
updated just today. What you see there may be a little in advance of the

How frequently will this master list be updated?

Perhaps more important, when viewing the page, can you include an
indication of when it was last updated and/or which LibO build it is for.

Asking for that, because using your example, the following is what is
displayed.
«
Show All
/text/smath/01/03060000.xhp

views; maximum size
maximum formula size
formulas; maximum size

Show All
Displays the entire formula in the maximum size possible so that all
elements are included. The formula is reduced or enlarged so that all
formula elements can be displayed in the work area. The current zoom
factor is displayed on the status bar. A selection of available zoom
options is accessible through the context menu. The context menu in the
work area also contains zoom commands. The zoom commands and icons are
only available in Math documents, not for embedded Math objects.
»

If anybody wants a screen shot, I can provide one, but the text in the
quote signs is literally everything displayed on the screen.

jonathon

#4

Hi Jonathon

I have set a web site that is able to

display the help pages (

I like the idea.

Thanks!.
It is part of
https://wiki.documentfoundation.org/Help_Content_Modernization

The help online has been loaded with the latest master help contents,
updated just today. What you see there may be a little in advance of the

How frequently will this master list be updated?

At the moment it is manual, although it is perfectly possible to set a
cron job to make it automatic in a period to be defined.

Perhaps more important, when viewing the page, can you include an
indication of when it was last updated and/or which LibO build it is for.

Easy to set the version of LibreOffice. I'll do it.

Asking for that, because using your example, the following is what is
displayed.
«
Show All
/text/smath/01/03060000.xhp

views; maximum size
maximum formula size
formulas; maximum size

Show All
Displays the entire formula in the maximum size possible so that all
elements are included. The formula is reduced or enlarged so that all
formula elements can be displayed in the work area. The current zoom
factor is displayed on the status bar. A selection of available zoom
options is accessible through the context menu. The context menu in the
work area also contains zoom commands. The zoom commands and icons are
only available in Math documents, not for embedded Math objects.
»

If anybody wants a screen shot, I can provide one, but the text in the
quote signs is literally everything displayed on the screen.

jonathon

This is exactly what is in the master as of yesterday at Change-Id:
I858331b9fc73502915cbd5fc2a8618e0837ba2a6

And by the way, under Firefox, you can hit Ctrl + u (view source) and
have a tab with the XHP source file.

To get the html rendered by the XSLT, use Firebug or hit Shift F5 to get
the console.

regards

#5

Hi Olivier, *,

meant to send this to the list, so resending :slight_smile:

[…]
As a translator myself I found it interesting to display the page where
the string is located. It helps to understand the context of the string
to translate and to improve quality.
[…]
http://vm173.documentfoundation.org/text/smath/01/03060000.xhp

The Pootle server in translation mode shows all information to access
the page, but there is no automatic connection between vm173 and Pootle.

Now there is. I failed to integrate it into webpack that pootle uses,
so if someone knows to integrate it into the default assets handling,
I'd like to hear the suggestions..

See e.g. https://translations.documentfoundation.org/de/libo_help/translate/scalc/02.po#unit=28664400

you should see a link "String in context on vm173" pointing to
http://vm173.documentfoundation.org/text/scalc/02/02130000.xhp on the
left-hand side, below to the location and context and terminology
info.

ciao
Christian

#6

Hi

As some of you know perhaps, I have set a web site that is able to
display the help pages (.xhp) directly on a browser (except Microsoft
browsers, saddly)

As a translator myself I found it interesting to display the page where
the string is located. It helps to understand the context of the string
to translate and to improve quality.

Great job, Olivier! :slight_smile:

For example, if I am translating string 'xSbDA' located in page
'03060000.xhp' of 'libo_help/smath/01.po', I can visit the page in
English at the address

http://vm173.documentfoundation.org/text/smath/01/03060000.xhp

The Pootle server in translation mode shows all information to access
the page, but there is no automatic connection between vm173 and Pootle.

The help online has been loaded with the latest master help contents,
updated just today. What you see there may be a little in advance of the
exisiting copy in pootle. I believe this shall not be an issue for most
of you.

Another usage of this service is to browse or review help pages ad-hoc
and check for consistency, precision and linguistics of its contents.
The top right area displays info on the xhp file, so it makes it easy to
pinpoint the page to improve.

I hope some of you will find interesting to access vm173.

regards

Ciao