Commit Graph

106 Commits

Author SHA1 Message Date
e36e33937f tdf#142531: fix help css for Simplified Chinese display on Linux
The font "system-ui" may cause trouble in some system, although it may look good in several systems.
See e.g. https://infinnie.github.io/blog/2017/systemui.html.

This change removes the "system-ui" font from the list, still put "Segoe UI" before any others, but moves "sans-serif" forward so that it falls back to the UI font in most linux distros.

Tested on Win10 and this does not impact the display for English or Chinese, but really improves a lot on Linux (Fedora 32 for me).

Change-Id: I1cba731cb846d1dc8c708b12510167c48de539e5
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/116487
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2021-05-31 18:18:39 +02:00
226a545d33 tdf#142417: Improve convertfilters.py and add API Names column
This commit involves two parts:
1. Improved the convertfilters.py helper script to make sure
 the generated convertfilters.xhp file is complete, accurate
 and containing no duplicated entries, and also add codes
 to also generate API Names column, as discussed in tdf#142417.
 Importantly, the code is modified to generate fixed IDs,
 rather than the previously random IDs or sequential IDs which
 may make the PO translation strings to show fuzzy when the
 file is re-generated.
2. This helper script is run and the convertfilters.xhp is
 updated.
3. The default css is modified to better display the page.
 There is no need to set overflow=auto for the DisplayArea,
 otherwise the scrollbar goes to the bottom of that area which
 is not visible. Also added a css class to display smaller
 fonts for the table.

Change-Id: I8a5c73c9d6a0c0b44fc7db6cb67b140bfeb8b4be
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/116405
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2021-05-31 16:45:00 +02:00
e694812962 CSS: Initial teeny-tiny changes towards tdf#139926
Since I keep procrastinating on the Online Help redesign,
let’s do it incrementally.

Change-Id: I2e7ebc1d3d9df8f6b7425dcae50464d463d7f0c3
2021-03-22 15:46:49 -06:00
4c9cd88154 Use z-index: 100 for TopLeftHeader
The tooltip functionality was making things messy with the sticky header

Change-Id: I8a77b11c950c54f00bde0c040a2945f503f993b5
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/104749
Tested-by: Jenkins
Reviewed-by: Ilmari Lauhakangas <ilmari.lauhakangas@libreoffice.org>
2020-10-24 11:58:50 +02:00
eefef8231b Keep logo text colour white even when visited
Change-Id: I5cad9cdaf606b2b809c8e8a39a0dbf82ce15f919
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/103548
Tested-by: Jenkins
Tested-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
2020-09-28 13:51:02 +02:00
1e21cf1fa7 CSS: Separate this rule out of the block
Change-Id: I1c7ea2603fcbb8a6668cde831848246bb4d1c3a4
2020-09-10 09:48:08 -05:00
0b73d5eb91 Online help CSS: improve link colors so Olivier doesn’t hate me
Change-Id: Ia03fdfe89ac578891458b19657486d398d4bc1b4
2020-09-10 09:13:24 -05:00
4847445f1d tdf#133640 Replace problematic colors to make links discernible
… and add back their default underlines, but dimmed.
I still think this looks busy, but I shall get used to it.
It’s more a11y-friendly this way.

Also, the old, green footer line is gone, since it doesn’t really
fit in since commit 4d6b5e5f74c50cc440a46fada8fa89ad2f946749.

Change-Id: Ie9feb3cc232ec249dbe323c2ec4b761c12e91ad6
2020-06-24 17:26:16 -05:00
47b0c69b0a Update CSS box colors to match new Colibre
Change-Id: I5ed9fdcad79fc34032e6c8d1536aaaf12d32e177
2020-06-23 08:59:52 -05:00
24901fb947 Improve web help header
Header with symbol, logo and navigation dropdowns now uses
grid layout when screen width is desktop.

Change-Id: I00612ebe04110b3608d9534c0ebdb23d5b788c54
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/95668
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-06-07 15:41:42 +02:00
c6409aa8d0 Fix [aria-hidden] topix in CSS
Change-Id: Ifbc5d8d7a3ffc92965a78062c5943b5e94081bf0
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/95434
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-06-03 15:00:52 +02:00
7b5fe18bbc Update prism.js to latest version
Update prism.js and companion css to latest version
Fixes the Currency and Type keyword highlight
Fixes line numbering interference with a11y-toggle.js

Change-Id: Ibbb5c95790e1366f0a1dbc497d8741e69a0a3957
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/95173
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-05-31 16:11:47 +02:00
3dbc5d6b39 tdf#126813 Fix scrolling of targeted references
Change-Id: Ic7ce644cc0a5053905e980952ad31767fa87125c
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/94885
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-05-26 20:39:33 +02:00
695cea8d8e Remove unused CSS class
Change-Id: I9db4df3062c411570a77686ec2b4fe3124f71539
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/94879
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-05-26 19:45:07 +02:00
ede87672c1 CSS: Change selection color
It doesn’t play nice anymore since 4d6b5e5f74c50cc440a46fada8fa89ad2f946749

Change-Id: Ib897702ad32915164e277e092103c295bba41366
2020-05-15 04:06:37 -05:00
52eb45cd79 Help CSS: allow title in header to be wider
Added a column and let the title section to grow into it.
Also removed the hardcoded size from the Xapian search input.

Change-Id: Id391264a17556a35d54b705621deb9bdecc16af2
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/93278
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-05-01 20:21:01 +02:00
4d6b5e5f74 Apply module brand color to Help page
Change page header and headings to module colors
Module colors from branding wiki page
https://wiki.documentfoundation.org/Marketing/Branding#Colors

Based on ideas of Beatriz Fonseca (@beatorizu)
betrizaf@gmail.com

Change-Id: Ia855872185a9c5ff6bcf3c351cc78e57e5a7901c
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/93100
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-04-29 14:29:05 +02:00
996909e807 Helponline: Make that image shadow look not tacky
Change-Id: I7e0b370ad883e787a8c7b7970d8d96653e577f8e
2020-03-12 13:09:19 -06:00
d0bf3b122d Refactor XSLTs and CSS (2)
class -> id

Change-Id: I62c1af5a0203bb66fdd291dbf55633cbb3731353
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/89207
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-02-22 13:12:58 +01:00
f48d72b4a8 Refactor XSLTs and CSS
more meanigful names

Change-Id: Ib786d2814adaed336f495992711eb89f99d85d39
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/89206
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-02-22 13:12:28 +01:00
197930c8b9 Remove very old unused CSS
Change-Id: I8af3443fb8db832ac2fc9a88dfb6fd779d3475ed
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/89163
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-02-21 12:40:58 +01:00
35281f4c91 tdf#127566: don't change divcopyable border width in onclick handler
Instead, define border width in respective CSS, to make it consistent
in both clicked and non-clicked states, and avoid "jumping" on click.

Change-Id: Ic8ab8d0fd586059e21de6aa866fef95226774acf
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/87718
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2020-01-30 11:21:57 +01:00
fdc5abfc53 Give some space around images
Change-Id: Ic7251bfa74c9ee1ac8b55edf8f6bed9791d42903
Reviewed-on: https://gerrit.libreoffice.org/81442
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-10-24 13:22:03 +02:00
0dc045bd9c Add Option View help page screenshot
+ tweak CSS for images

Change-Id: Iaa304a0ccecb6cdea2421de4ffaed52d71a0c76b
Reviewed-on: https://gerrit.libreoffice.org/81287
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-10-22 16:28:15 +02:00
242a6bbefc More work on Xapian result page
Added module dropdown fix
TODO: Language

Change-Id: I47012d6280694d87fb5d19e25c6052b8a7ed89c7
Reviewed-on: https://gerrit.libreoffice.org/80771
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-10-14 21:13:15 +02:00
404ff19a22 Fix top row of page grid
Change-Id: I9ae465ac9d00df5561157e0872217a1e8a09e159
Reviewed-on: https://gerrit.libreoffice.org/80678
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-10-11 20:06:25 +02:00
2e077c0f9f Fix xapian search bar in Help online (WIP)
Change-Id: Ibe178ff79a27b8a21fcbaf2465c66da0786a28fd
WIP: need adjusts for mobile.
Reviewed-on: https://gerrit.libreoffice.org/80605
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-10-11 13:01:44 +02:00
aa45ded698 redmine#2555 replace Help online Google search
This is the helpcontent2/ part of the patch.

Add xapian-omega search to online Help.

The patch replaces Google custom search with xapian-omega search.

A new build key is introduced.

--with-omindex=server : Localizes and adds the xapian result page
template, adds the xapian form to each Help page.

--with-omindex=noxap : do not localize the result template and
do not add a form in the Help page.

--with-omindex= will force Online Help build.

Default is noxap

NOTES:
- xapian-omega databases are built in the server.
- searches returns results only on localized Help pages, avoiding same
resulis in many languages.

TODO:
- Tweak the xapian-omega result page CSS and markup.

Change-Id: I3dc2b79c4111f61fd5fea01b1f8c95bfacab1e8f
Reviewed-on: https://gerrit.libreoffice.org/79366
Tested-by: Jenkins
Reviewed-by: Guilhem Moulin <guilhem@libreoffice.org>
Tested-by: Guilhem Moulin <guilhem@libreoffice.org>
2019-10-01 15:00:44 +02:00
085cd2e40a Hide our nav checkbox inputs only visually
Some screenreaders do not read elements with opacity: 0

Change-Id: Ifc4c97a58c87e7d6b9533e15dc0db60aa70bfb97
Reviewed-on: https://gerrit.libreoffice.org/72519
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-05-18 16:53:19 +02:00
301ae74e8b Improve accessibility for modules and lang menus
Ever since the contents of the modules and lang menus started
being populated upon click, the flow for screenreader users has
been potentially confusing.

This patch introduces a11y-toggle into the mix:
https://github.com/edenspiekermann/a11y-toggle
Checkboxes were changed into buttons. This hopefully makes it
clear we want the user to click them.

The contents tree still uses the checkbox hack, because its items
are populated upon page load.

Change-Id: I3482bea0c8669f96794498fc37d9d18fe3f829d5
Reviewed-on: https://gerrit.libreoffice.org/72467
Tested-by: Jenkins
Tested-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-05-18 13:34:26 +02:00
3c494b6e6d tdf#122548 copy bascode and pycode to clipboard
This will allow easy testing of coding examples.

Change-Id: I30fc53642b1579744591f2de0c84a615d1755352
Reviewed-on: https://gerrit.libreoffice.org/71385
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-04-26 20:46:16 +02:00
ca2a6bf2c3 tdf#124245 Polyfills and fixes for IE11
The polyfills can be removed after we drop IE11 support.

Other IE11 fixes:

Change from document.URL to window.location.pathname
because otherwise we get local Windows paths with backward
slashes.

Use clear: left; for google-donation element so it doesn't
float on top of other elements.

Don't use defer to load fuzzysort.js and prism.js.

Change-Id: I6c0143eab555c8b1fbdbde8e749a24baed2f69c8
Reviewed-on: https://gerrit.libreoffice.org/69549
Tested-by: Jenkins
Reviewed-by: himajin100000 <himajin100000@gmail.com>
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-03-27 09:42:01 +01:00
34aca15b8c Header and donation CSS tweaks
Change-Id: I20e5610c08db700e12baffa9b62dcf8dfd0c4328
Reviewed-on: https://gerrit.libreoffice.org/69278
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Tested-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Tested-by: Jenkins
2019-03-15 00:34:21 +01:00
54e3236790 Show module & lang navigation on mobile
Module & languages menus were not shown on screen widths < 960.

Changed module & languages menu background to span the whole
width, when on mobile.

An arrow function was used in help2.js, which means it was broken
on IE.

Moved all src .js files to head and used defer for all.

Moved inline Piwik & system info JS into help2.js and added a
test for onlineness targeting the first meta element in the body.

Change-Id: Ic1a928b53ce9029f9f655117977cd511b7e3246d
Reviewed-on: https://gerrit.libreoffice.org/69005
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-03-10 19:22:22 +01:00
eb2972e06b Donation button and sticky header for Help
Task: https://redmine.documentfoundation.org/issues/2815

Header was made sticky on non-mobile by using position: sticky.
This was the only way to make it work with the grid without
carving magic numbers into stone. IE11 ignores it, but so what?

Donation text was made shorter.

The Google search and the donation button were wrapped in a
container to make it easy to haul them all over the place.

Lots of tweaks were made to the grid areas and the styles of
the bottom elements to make everything fit nicely in the new
markup order. The result was tested on IE11 to make sure it
degrades gracefully.

The Displayarea element had a fixed width (my old mistake),
which made the min-width: 960px layout look very uncool.

Change-Id: I131a1e82290bc3381c938acb4dc9dbc408fb2ba7
Reviewed-on: https://gerrit.libreoffice.org/68890
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
Tested-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-03-08 11:48:40 +01:00
4f35fbbb29 Revert "Improve donation link in Help online"
This reverts commit bd26e706b30dccecdeba24ba8b697ddf2fc7a615.

Change-Id: Id45b4ef2bacae444be070a03fbc0e10a4992f85c
Reviewed-on: https://gerrit.libreoffice.org/68699
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
Tested-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
2019-03-04 15:46:21 +01:00
bd26e706b3 Improve donation link in Help online
redmine#2815

Addressed responsiveness: for screen width < 960px the
button goes to the bottom of the screen and the header is
not fixed anymore.

Artists are invited to improve button rendering.

Button max width is 300px, the en-US text and the translated
text should fit in 2 lines of 300px each. Text is centered.

Change-Id: I51860be2ad998e85f247118e44b21af3e2efa060
Reviewed-on: https://gerrit.libreoffice.org/68644
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2019-03-04 15:41:52 +01:00
ec242a0c85 More CSS tweaks…
• Ever-so-slightly brightened link color
• Made most tables centered; I think they look much better
• Removed some pointless spacing
• Made all dropdown options consistently align to the left
• Finally found out why pagination had extra 40px to its left
  and it’s a shame the normalizer doesn’t account for it
• Correctly made disabled pagination links unsensitive
• Gave styling to the search bar for consistent appearance
  in Gecko- and Blink-based browsers

Change-Id: Idcb488160aa97ec0c4adb5202aed7f194dfac7c9
2019-02-21 06:48:09 -06:00
00c5a41895 Minor color and padding tweaks; some styling for TOC
Just to fix the most egregious issues in content paragraphs.
Some day I will actually have the energy to systematize
everything into a cohesive set of spacing and padding values.

Change-Id: I6d5d36e96d9c9a133d61b233413ebd17d8189d33
2019-02-07 18:03:45 -06:00
622324ec76 tdf#121571 Solve cognitive dissonance with note icons and colors
More often than not, the alarmist colors given to note boxes didn’t
match their content.

Change-Id: I88d7a8e2d07ffba661c218887fd54638506d21c8
2019-01-28 16:25:10 -06:00
a8ab16150b Drop this pitiful, bothersome, gimmicky animation
Change-Id: If533f8565e38e02d503cc1ab59f65e2445f1369b
2019-01-28 15:31:15 -06:00
e6095165ac Review code in help page and mute l10n when OK
+ Added "smathcode" role to render smath code paragraphs
+ let smath code samples be copied to clipboard.

Change-Id: I580c162d0c77f51d0de817ca143a845abf56eca9
Reviewed-on: https://gerrit.libreoffice.org/65621
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2018-12-26 22:15:20 +01:00
635750a0cd tdf#115663 Syntax highlight in BASIC code examples
Use prism.js to highlight BASIC code in help pages
See README.prism.js.txt for details

added normalize-whitespaces plugin to remove extra 1st line
cleaned some useless css class

Change-Id: I6dde4d217a29f485199ced462b896ee1b500fba0
Reviewed-on: https://gerrit.libreoffice.org/64252
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2018-11-29 21:41:54 +01:00
49baef5df5 tdf#121797 XHP extensions (Help part)
WIP. This is the Help part.

Extend the XML parser to include new incantations of the <paragraph>
tag, namely
<h1> to <h6>
<note>, <tip> and <warning>

Extension to the <item> tag:
<menuitem>, <input>, <literal>, <widget> and <keycode>

* removed test files

Change-Id: I2a473ee8772606f5e84bb02e651bccc6749598f4
Reviewed-on: https://gerrit.libreoffice.org/63954
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2018-11-28 10:53:51 +01:00
ad162dec44 tdf#119415 Widen search box and style placeholder
Change-Id: I0f60cfea338e695e778d16a208153597ec6d19ca
2018-11-22 11:54:01 -06:00
9fb9990b35 tdf#119415 change from fuse.js to fuzzysort.js
Tied the index listing to the current module.
Fuzzysort.js is MIT licensed.

Change-Id: I5d95cc1870a1856089217846ed0af572abc882d7
Reviewed-on: https://gerrit.libreoffice.org/63203
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2018-11-09 21:14:57 +01:00
94177b1022 Helponline: H2 too similar to H3
A teeny-tiny upward nudge.

Change-Id: I9491c5a849316907f0770ab29752cbc385cef107
2018-09-15 08:55:12 -05:00
0d03a98c88 Show how beautiful are our icons
On hovering icons, enlarge them.

Next step: change icons to SVG (tdf#117551)

Change-Id: Ib43e3b54ed27352a8ca785c57dce9314adc00e4d
Reviewed-on: https://gerrit.libreoffice.org/60053
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2018-09-06 17:05:28 +02:00
c48b19bcf9 Better placement of background color definitions & a new shadow
Change-Id: I8ad99f278cd1e4d96ae873627f2dfa2a5b827761
2018-08-23 12:26:28 -05:00
df4a017dbf Add some space between warning/note/tip boxes
Change-Id: I37b9bf85cbe2b3e101c5ba4c71391692b2a65425
Reviewed-on: https://gerrit.libreoffice.org/59473
Tested-by: Jenkins
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
2018-08-23 05:35:20 +02:00