Commit Graph

106 Commits

Author SHA1 Message Date
Sam Lieber (sali)
d71c19b7be [FIX] extensions: icon_role fa icons
closes odoo/documentation#9375

X-original-commit: 89f61f900e
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
2024-05-16 19:16:29 +00:00
Sam Lieber (sali)
8bec283166 [ADD] extensions: icon_role font awesome
closes odoo/documentation#9053

X-original-commit: 1039a0b195
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
2024-04-29 16:46:01 +00:00
Sam Lieber (sali)
7fe59a5ec9 [FIX] odoo_theme: add bottom margin to inner lists
closes odoo/documentation#7722

X-original-commit: 1200df1ec8
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
2024-02-13 18:53:07 +00:00
Mathieu (mano)
d287d0807a [IMP] odoo_theme: toctrees-l1,l2 design improvement
Issue 1:
========
The toctrees in the documentation are visually inconsistent because of
the content. Sometimes we have titles that are also links and visually
collides with the rest of the toc making it hard to read. This applies
to toctree-l1 and toctree-l2.

Fix 1:
========
When we have a link and title toctree-l2 in a list containing other
nested toc, we apply another styling displaying it with the same color
as a title, but with an icon and hover behavior indicating that it is a
link. (This commit also changes the direction of the i-link icon to make
it standard).

Issue 2:
========
When we have only have toctree-l1 links without nested toc the toctree
is uselessly taking a lot of space.

Fix: 2
========

In these scenario we add a class to the toctree wrapper to replace the
toctree-l1 style with a toctree-l2.

task-3138525
task-3138563

part of

task-3059178

closes odoo/documentation#6502

X-original-commit: c62bf21987
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-11-21 11:59:59 +00:00
Antoine (anso)
7ea55ea650 [FIX] odoo_theme: fix logo colors
Before this commit, the Odoo logos used in the documentation were
using the old purple color.

This commit updates all these old logos with the latest version that
can be found on the Odoo brand-asset page

https://www.odoo.com/page/brand-assets

task-3328677

closes odoo/documentation#5598

X-original-commit: 4bec9a6e09
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-08-24 14:55:44 +02:00
Antoine Vandevenne (anv)
9db7381ea4 [FIX] odoo_theme/switchers: fallback to the original target URL
Attempting to switch from one version to another when navigating
<old_version>/applications/hr/employees.html led to the user being
redirected to /applications/documentation/<new_version>/hr/employees.html
because `hr` was interpreted as a version string, and thus the generated
target URLs of the version switcher were all wrong.

This commit ensures the redirection now falls back onto the original
target URL when all the generated ones point to a 404.

closes odoo/documentation#5055

X-original-commit: c81a91db9c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-07 16:59:08 +02:00
Elisabeth Dickinson
b00b9b3f2e [IMP] odoo_theme: fix menu links
When searching for a word, if that word happens to be in the menu, the
`display-flex` on the `a` would remove the space around the word because
a `span class=highlight` gets added around it.
Fixed by changing `display-flex` on the `a` to display-block (but
keeping it for `.o_toc_entry_wrapper`)

closes odoo/documentation#4180

X-original-commit: c758071861
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-14 19:47:07 +02:00
Elisabeth Dickinson
6c4845eae4 [IMP] odoo_theme: design improvements
Revamp of the side menu;
Round all borders for consistency with the buttons;
Improve .sig-* and .o_code elements;
Improve sphinx-tabs hover effect;

task-3046383

closes odoo/documentation#4111

X-original-commit: 3056c7b62d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-12 10:29:12 +02:00
Elisabeth Dickinson
5c86b82cfb [IMP] odoo_theme: general cleanup
A general reorganization of the code was needed for more clarity.
The different markup styles have been grouped together under a common
"chapter", comments have been rewritten and example pages have been
added for context.

Some levels have been removed Where there were too many for no reason.
By removing one level of styles (e.g.: `#wrap`) we avoid needing to
force overrides or adding `!important` to our code.
⌙ e.g.: before commit 9ef86cd93d8c6fc0fd96b437f629237e7a562c6e,
`.o_spoilers .accordion-body >:first-child` was being involuntarily
overridden.

task-3046383

X-original-commit: 620e3c33ef
Part-of: odoo/documentation#4111
2023-04-12 10:29:12 +02:00
Antoine Vandevenne (anv)
c60dd02bb5 [IMP] odoo_theme: tweak the HTML structure of TOC entries
task-3046383

X-original-commit: 877d1de3c2
Part-of: odoo/documentation#4111
2023-04-12 10:29:12 +02:00
Mathieu (mano)
620387b9e8 [IMP] toctrees: redesign and new card component
The goal of this commit is to propose a first step towards a new
`.. card::` directive for the toctrees. This is a first design
proposition for this new card component in raw html for the fallback
page `howtos.rst`

The long term objective is to redesign the toctrees by implementing card
components, clearer toctree list design and custom html pages.

Related to task-3059229

closes odoo/documentation#3406

X-original-commit: 53035435f9
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-26 18:14:09 +01:00
stefanorigano (SRI)
2ca32b40bc [IMP] scss: update, improve preexisting content
Add a new content focused on SCSS and user-interface.

- SCSS coding guidelines: regroup information already available (eg [1])
  or based on "oral tradition".
  The aim is not to establish new rules, ~99% of the current codebase
  is already compliant.

- SCSS inheritance: explain how SCSS assets management works in odoo.
  For example, people still find confusing that overrides are defined
  *before* the variable to customize.

- SCSS optimization tips: suggestions to lean SCSS code. Based on SCSS
  optimization task's know-how [2].

- CSS variables: explain how this feature is commonly used in odoo to
  adapt layout & design without raw CSS overrides.

- UI Icons: Add link to fontAwesome4 library . Replace the picture of
  odoo icons with the actual font (90kb image VS 15Kb font)

[1] https://github.com/odoo/odoo/wiki/SCSS-coding-guidelines
[2] https://www.odoo.com/web#id=2704984&menu_id=4720&cids=1&model=project.task&view_type=form

task-3090800

closes odoo/documentation#3093

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-12 18:19:27 +01:00
Elisabeth Dickinson
8b7df4edc8 [IMP] odoo_theme: Fix alerts and accordions colors
closes odoo/documentation#3319

X-original-commit: 8aebb79237
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-12 08:48:45 +01:00
Elisabeth Dickinson
b5a464a8d9 [IMP] odoo-theme: Revert $dark color variable to initial $gray-900
This was changed to get a good text/background contrast on the
alert-dark (Exercise).
By doing so, the .text-dark class generated by BS from the $dark
theme-color was gray instead of the intended near-black color.

By changing the variable, the contrast issue with the alert was back,
to solve this we directly override the alert's background color instead.

X-original-commit: 32c9e59ae6
Part-of: odoo/documentation#3319
2023-01-12 08:48:44 +01:00
Antoine Vandevenne (anv)
800857d67e [FIX] odoo_theme: re-enable redirect fallback logic
closes odoo/documentation#3300

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-06 10:30:02 +01:00
Elisabeth Dickinson
33a6cca3bf [IMP][CSS] Replace text-decoration on link with BS override 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
9392d28758 [IMP][CSS] Reorder styles according to styles guidelines 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
b0decaa8c4 [IMP] fix typo 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
3c344bcb77 [IMP] icon fixes 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
87ab86bac4 [IMP][CSS] Fix unresponsive font-size on alert text
By removing $font-size-sm on the alerts, the text is bigger. The title
text and its icon have been increased as well.
2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
0831592eba [IMP][CSS] Remove browser prefixes and unnecessary mixins 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
b503fdc6f4 [IMP][CSS] Fix literals in alerts containing tabs 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
f3573dbfae [IMP][CSS] Fix data indentation 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
1f95fc014b [IMP][CSS] Fix alignment on modal btn-close 2023-01-05 09:48:42 +01:00
Elisabeth Dickinson
41f0464dce [IMP] Indentation fix 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
0f5110785f [REM] Removal of changelog
The idea was not developed and it has since been decided not to do it.
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
b108feec5d [IMP][CSS] Use BS font-weight variables and fix
Instead of redefining font-weights, we override the BS variables and add
one extra font-weight in the newly-introduced extended utilities file.
After this change all the variables needed replacing and some tweaking
was needed to get the same or closely similar result as before this
change.

By doing so the font-weight classes in the typography file were obsolete
and hence removed.
Some other font-weight issues which were already there have been fixed
in this commit too.
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
9b7ec0fa11 [IMP][CSS] Fix color variable issue 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
d01888d0be [IMP][CSS] Revamp of the .o_spoiler element to use same code as alerts 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
1638484a82 [IMP][CSS]Change order of imported scss files
The aim of this cleanup is to use as many bootstrap classes, functions
and utilities as possible to reduce the amount of extra code.
Instead of redefining variables, BS variables are overridden in the
bootstrap_overridden file.

In order to be able to reuse these overridden variables within our own
custom variable file — and after consultation with SRI — it was
determined that the variables.scss file should come after the bootstrap
files in the order of importation, unlike the order of odoo website's
scss files.

Changes to variables in bootstrap_overridden have been made to adapt to
the new structure.
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
3d73e4c5b4 [IMP][CSS] Use CSS variables to style different alert types
CSS variables avoid having to repeat code for each alert type.
Also remove the need to add "tip" to the theme-colors (no need for "tip"
styled buttons, badges etc, especially as tips use the primary color) by
styling `.alert-tip` with customized copy of BS alert mechanism.

In order to be able to modify the icons with a CSS variable,
the `content` attribute has been removed from the `o-inline-icon` mixin.
Code where this mixin is called in other places has been adapted.
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
4f0713af54 [IMP][CSS] Place overrides in bootstrap_overridden file 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
637ea4b337 [IMP][CSS] Clean up the file according to conventions
Includes reordering styles, renaming variables ($o-*),
re-indenting lines, removing commented code
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
8ab91d242b [IMP][CSS] Set gray background to it's original darker color 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
4d3442cca4 [IMP][CSS] Improve literals styling (o_code, .sig-*) 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
179e5c6ccd [IMP][CSS] Update _sphinx_basic.css after update of Sphinx
Note: Some code is commented instead of being deleted.
This allows us to keep track of what should be commented out in future
versions of Sphinx' basic CSS.
2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
1806ace2ef [IMP][CSS] Remove repetitive or unnused CSS 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
bceba8c55d [IMP][CSS] Improve margins on headings and sections 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
e36bd9b924 [IMP][CSS] Replace margin and padding values with variables 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
8febda41af [IMP][CSS] Revamp modal to use all BS classes and variables 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
3146d394c4 [IMP][CSS] Rescale heading fonts 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
559d542a0d [IMP][CSS] Cleanup font variables 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
ff2b57a127 [IMP][CSS] Cleanup admonitions (alerts) 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
6e36a01099 [IMP][CSS] Cleanup color variables 2023-01-05 09:48:41 +01:00
Elisabeth Dickinson
e342ffb989 [IMP][CSS] update literals styles (.o_code, .sig-*) 2023-01-05 09:48:41 +01:00
Antoine Vandevenne (anv)
b16202dcde [FIX] odoo_theme: handle non-TOC pages when expanding top menu entries
Trying to "expand" those pages lead to a crash that prevented the menu
to be shown at all.

Incidentally, this commit also handles menus built with `make fast`.

closes odoo/documentation#3263

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-03 19:07:05 +01:00
Antoine Vandevenne (anv)
da19dab578 [IMP] odoo_theme: scroll the active menu entry into view
In large and deeply nested TOCs like finance/accounting/fiscal_localizations/localizations/...
the user had to constantly scroll the menu to the menu entry they just
clicked because the expanded menu would not fit entirely on the page.
With this commit, the active menu entry is scrolled into view each time
the page is reloaded.

The previous behavior was also the reason for expanding the top menu
entries on only the homepage. Thanks to the scroll, they now always
expand.

Part-of: odoo/documentation#3263
2023-01-03 19:07:05 +01:00
Antoine Vandevenne (anv)
b1efc8aad2 [FIX] odoo_theme: update the aria attributes when scrolling the page TOC
The 'aria-expanded' attribute was not correctly updated on the `i` tag
when the user scrolled through the page TOC. This caused a minor issue
where an arrow (`i`) that was collapsed manually with a click would no
longer automatically expand afterward.

task-3106339

closes odoo/documentation#3238

X-original-commit: f068065d39
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-27 13:10:41 +01:00
Antoine Vandevenne (anv)
899479c18d [IMP] odoo_theme: expand top level menu items on the homepage
When the user browses the homepage, it might be hard to figure out
where they want to go next. Expanding the top-level menu items could
help them with that.

task-3106339

X-original-commit: 5526f1ea07
Part-of: odoo/documentation#3238
2022-12-27 13:10:41 +01:00
Morgane (morm)
a52a9eef2d [IMP] documentation: legal page design
Prior to this commit, the terms and conditions were displayed in a table
with all the languages and it was not practical for the futur, with many
more languages.

task-3073198

closes odoo/documentation#3136

X-original-commit: d7b69d802a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-07 18:44:34 +01:00