Documentation

So I was playing with https://helponline.libreoffice.org/6.2/ and if we add to this div:

div class="header-extrawurst"

this CSS:

position: fixed; width: 100%; top: 0;

Then it stays at the top of the screen, even when we scroll down! So that's a good start for thinking about adding the donate link up there. But the top bar then overlaps the content a bit, but we can add this CSS to the body tag:

padding-top: 60px;


The donation link is in the XSLT transformation at

<div class="donation">
                    <p><a href="https://www.libreoffice.org/donate/?pk_campaign=help" target ="_blank">
                        <xsl:value-of select="$ui_donate"/>
                    </a></p>
                </div>

where <xsl:value-of> contains the translatable string.

So I think we can only change the class "donation" in the css file and upload to the Help pages. The only drawback I need to clear is the responsiveness of the page, something Ilmari cares a lot.

If you need to play, use /6.3/ in the URL as it is the new master.

I can do it but later today.

Thanks for looking at this and providing the hints.

Olivier

I suggest to shorten the link’s text, move it to the green header, and then make that header sticky during scrolling (it’s something I planned to do anyway — please take over)

Patch submitted

https://gerrit.libreoffice.org/#/c/68644/1

Seems there is some discussion at Gerrit going on. I lack the technical insight, but if our approach of updating the help page is wrong, happy to adjust the task, of course. Can someone share more information with me?

I will rework the patch. It will require adding a grid container element, so body will no longer have that role. Then I will make the header appear before the grid container.

Went with a more thoughtful route. Kept body as grid container. I think things are pretty nice now. I'm not a huge fan of sticky headers, but at least ours is not very tall. On IE11 it will not be sticky, so feel free to sue me!

Patch: https://gerrit.libreoffice.org/#/c/68890/

Thanks for your work! Is there a way to test the design and have a look? ;-)

Looks good to me!
Is there any blocker for putting that live? There was some discussion at
Gerrit - from my POV things look ok?

Florian Effenberger wrote:

Looks good to me!
Is there any blocker for putting that live? There was some discussion at
Gerrit - from my POV things look ok?

There was a change in the donation string which breaks the "String Freeze" policy and will trigger a retranslation. If OK to retranslate, the patch in master should be cherry-picked to LO 6.2 Help or even LO 6.1, at the risk of further work to make it fit.

Bringing to staff meeting.

Any update on this one?

It is done and released.

https://help.libreoffice.org/6.2/en-US/text/shared/05/new_help.html