Commit Graph

81 Commits

Author SHA1 Message Date
xmo-odoo
e43df474d4
[ADD] support for meta directive (#708)
e.g.

    .. meta::
        :description: blah blah blah
        :keywords lang=en: x y z

should yield

    <meta name="description" content="blah blah blah">
    <meta name="keywords" lang="en" content="x y z">

Also cleaned up `layout.html` a tad while at it:

* we're now properly setting the default metas via the translator so
  setting them in the template is unnecessary
* there's a flag to use an html5 doctype (also has a few other
  positive side-effects with respect to the metas sphinx generates in
  the template)
2020-06-25 09:25:00 +02:00
Olivier Dony
de137b0bcf
[ADD] legal: update contracts for new maintenance
- Update Enterprise & Partnership agreement (EN, FR)
- Update legal page index: hide outdated agreements, replace
  with a link to an archive of the old PDFs.
- Add icons for missing files, to make index table layout more consistent
- Add `text-justify` on HTML versions of contracts, for consistency with
  the PDF versions.
- Fix compatibility of PDF generation with recent sphinx versions
  (\sphinxmaketitle instead of \maketitle)
- Re-add NL PDF building, still needs to be updated like all others

Backport of 5b80ed551c from 13.0
2020-06-09 02:25:12 +02:00
Antoine Vandevenne (anv)
09bab807aa [IMP] technical: add a static redirection feature for missing pages 2020-04-06 16:31:27 +02:00
Arnaud Joset
950b460794 [IMP] technical: remove future warning of Sphinx 2020-02-20 11:01:17 +01:00
Arnaud Joset
a0f6d3e925 [IMP] technical: allow building with Python 3 and Sphinx 2.4.0
This commit updates the requirements of the documentation to Python 3 and Sphinx 2.4.0 and later.
2020-02-20 11:01:03 +01:00
Xavier Morel
a60364a5e4 [FIX] rendering of tables with merged cells
Merged cells in the first columns were not rendered correctly and values from
other columns would be placed in the wrong columns.
2020-02-14 11:20:37 +01:00
Antoine Vandevenne (anv)
1081f8b7b5 [REV] Revert dbba515 to 8678876
Reason: delay changes until internal build tools are updated
2020-02-12 15:01:08 +01:00
Arnaud Joset
867887613a [IMP] technical: remove future warning of Sphinx 2020-02-12 10:41:48 +01:00
Arnaud Joset
dbba515566 [IMP] technical: allow building with Python3 and Sphinx 2.X
Before this commit, sphinx-build could not be used with Python3 and Sphinx 2.X.
2020-02-12 10:41:48 +01:00
Martin Trigaux
bcfef7cd0b [IMP] _extension: update menu list
to match the current one on odoo.com
2019-12-18 11:09:15 +01:00
Martin Trigaux
3a45ba958f [IMP] config: add canonical url
Inspired by odoo/odoo@958f9106dd (which was lost by the way)
2019-12-12 15:37:22 +01:00
Martin Trigaux
1f51fda2e8 [IMP] _extension: add languages link
To refer the pages in different languages for better indexing
2019-12-12 15:37:22 +01:00
Martin Trigaux
f7cb30b6d8 [FIX] _extension: complete monkeypatch in sphinx 1.6
The monkey patch made for sphinx 1.6 was not complete. In comparison
to the one done for previous versions (resolve_toctree), navbarify was
not called.

In the toctree, the sub-levels were turned into a link in 1.6 while
navbarify prevents this.
2019-11-05 15:02:06 +01:00
Martin Trigaux
17fc4219bd
[ADD] searchbar based on Sphinx search tool
Co-authored-by: Martin Trigaux <mat@odoo.com>
Co-authored-by: Richard Mathot <rim@odoo.com>
2019-10-17 10:25:25 +02:00
Xavier Morel
da7f9932cc [FIX] odoo: compatibility sphinx2
Cherry-pick of odoo/odoo@2b28dd89b8
2019-07-01 18:05:00 +02:00
Martin Trigaux
1b2cbd5b88 [FIX] _extension: build with sphinx 1.8
cherry-pick of odoo/odoo@ac37ca39ea
but dropping the compatibility of sphinx 1.2 to simplify
2018-09-26 16:19:01 +02:00
Xavier Morel
b379cab20b [FIX] a pair of leftover warnings 2018-08-31 14:41:25 +02:00
Xavier Morel
63a615bc67 [FIX] port db0cb1b09237b2e004c7a7eceadedde668f4ac30 from tech doc
fix Sphinx 1.6 compatibility leading to the "tiles" on the home page
not working anymore: 1.6 replaces BuildEnvironment.reolve_toctree by
TocTree().resolve(), while the method still exists it's not actually
called anymore
2018-05-31 16:04:46 +02:00
Olivier Dony
48b11b31cc [FIX] _extensions: p3 compatibility (8) 2018-05-30 15:38:34 +02:00
Olivier Dony
db5604f703 [FIX] _extensions: p3 compatibility (7) 2018-05-30 14:34:23 +02:00
Olivier Dony
478fcb7bef [FIX] _extensions: p3 compatibility (6) 2018-05-30 12:52:39 +02:00
Olivier Dony
b22590c2da [FIX] _extensions: p3 compatibility (5) 2018-05-30 12:09:58 +02:00
Olivier Dony
2e58b86fe2 [FIX] _extensions: p3 compatibility (4) 2018-05-30 11:59:47 +02:00
Olivier Dony
4143a500e1 [FIX] _extensions: p3 compatibility (3) 2018-05-30 11:37:16 +02:00
Olivier Dony
914c5ebc18 [FIX] _extensions: p3 compatibility (2) 2018-05-30 11:19:30 +02:00
Olivier Dony
ff2c6db57c [FIX] _extension: p3 compatibility 2018-05-30 11:06:24 +02:00
Olivier Dony
cda60c219b [FIX] doc template: GA: anonymize IPs 2018-05-30 09:56:31 +02:00
Denis Ledoux
b7cfc92ddf [ADD] _extensions: possibility to create a file download link 2018-03-29 10:27:01 +02:00
Olivier Dony
5b6390f874 [FIX] layout: add missing space between classes 2018-03-16 20:05:33 +01:00
Miquel Raïch
e2684993c8 [FIX] v11 urls
Outdated references

Closes #252
2017-12-13 13:31:12 +01:00
xmo-odoo
95b64ca2de Fix custom translator setup
Programmatically setting html_translator_class is apparently broken in
Sphinx 1.5 (which sorta makes sense, it's a bit of a hack, I'm not sure
why we even did that instead of going through the configuration object).
2017-04-25 16:18:26 +02:00
Martin Trigaux
c71b603614 [FIX] doc: v10ification 2016-12-21 10:13:29 +01:00
Yannick Tivisse
9bfc3e7eb6 [FIX] demo_link: retrieve correctly the result from read()
The signature has changed and we get a list instead of a dictionary now.
2016-10-14 13:59:34 +02:00
Stefano Rigano
a0dd875333 [IMP] doc: define a layout for 'category index' pages
These pages are not directly accessible through other doc’s pages but
there are still indexed by google.

eg.https://www.odoo.com/documentation/9.0/tutorials.html
2016-08-11 16:29:15 +02:00
Olivier Dony
c42a9dafb9 [ADD] layout.html: legal page link in footer
Added to match updated footer in www.odoo.com
2016-05-26 00:05:47 +02:00
stefanorigano
d193f7c0ac [FIX] .doc-aside headings' colour
Heading colour should be ‘white’ when it’s into a  .doc-aside container
only.
2016-05-18 10:48:19 +02:00
stefanorigano
a2dafdf796 [IMP] documentation-user: update compiled CSS 2016-05-12 14:06:25 +02:00
stefanorigano
43164704c9 [IMP] documentation-user: restructuring submenu
— Layout

* Create html templates to print breadcrumb's and submenu's lists.
* Remove ‘o_main_back’ ( no longer needed)
* Minimum mobile support for submenu. Note: The default website submenu
should be refactored in order to support mobile by default

— Style

* Create a less mixin to handle all doc’s dropdowns
* Add a specific style for breadcrumb when it’s placed inside the
submenu.
2016-05-12 14:06:25 +02:00
stefanorigano
27388c89a6 [FIX] side-menu overflow. 2016-04-27 11:45:06 +02:00
Martin Trigaux
0669db650a [FIX] layout: wrong URL to external pages 2016-04-27 10:02:34 +02:00
stefanorigano
9a478fa07a [FIX] documentation-user: mobile menu button
It was invisible because the doc’s website use material icons rather
then the ‘fa’ ones. Replaced the icon with the material one and styled
the “pressed” state.
2016-04-26 15:02:30 +02:00
stefanorigano
de70a65819 [FIX] documentation-user: minor layout fixes
* Adjust ‘.card.top’ padding for index pages
* Offset-top main content for mobile
2016-04-26 15:01:33 +02:00
Martin Trigaux
8c68490dbb [FIX] css: no lessc in build script? 2016-04-26 13:30:50 +02:00
Martin Trigaux
c07231580c [FIX] css: remove css file
use less file instead
2016-04-26 13:23:13 +02:00
Martin Trigaux
dde58d87db [FIX] css: language menu style 2016-04-26 12:07:46 +02:00
stefanorigano
28f197ca71 [IMP] all: new design to match the one on odoo.com
* upgrade to bootstrap 3.3.6

* new Header, port website LESS
  - Add the new header
  - Modify sub-header in order to handle “back” button and version
    switcher
  - Port website’s Less:
    * Use same variables’ names
    * Review fonts and colours in order to fit the new style

* add new footer

* Review and optimise JS code in order properly handle the new header,
  footer and card.top animations

* replace  banner images
2016-04-26 11:23:38 +02:00
Martin Trigaux
4993bf959c [FIX] embedded video in https for vimeo 2015-12-03 15:49:40 +01:00
Martin Trigaux
c717f6314d [FIX] embedded video in https 2015-12-03 15:47:18 +01:00
Xavier Morel
e2204cdd72 [FIX] 1.2 compatibility
app.add_node doesn't work right for custom translators in 1.2, since
mementos are using ``h:div`` reimplement that in the
BootstrapTranslator.

Alternative would be to monkeypatch app.add_node for Sphinx 1.2, but
let's not do that...
2015-11-20 11:37:57 +01:00
Xavier Morel
fbea64a257 [FIX] git and sphinx ignore, remove committed pyc files 2015-11-20 11:36:44 +01:00