make html produces Only English

[akram1]

I did git Odoo18 documentation branch.
after installing python packages, I did
make html
It went fine and built all html files but only English pages. Language option in html page is disabled.

make html
Compiling stylesheets...
mkdir -p _build/html/_static
python3 -m pysassc extensions/odoo_theme/static/style.scss _build/html/_static/style.css
Compilation finished.
Starting build...
sphinx-build -c . -b html -D project_root= -D canonical_version= -D versions= -D languages= -D language=en -D is_remote_build= -T -A google_analytics_key= -A plausible_script= -A plausible_domain= -j auto content _build/html
Running Sphinx v5.3.0
Found Odoo sources in /opt/odoo matching documentation version '18.0'.
WARNING: Could not find Upgrade Utils sources directory in upgrade_util.
The developer documentation will be built but autodoc directives will be skipped.
In order to fully build the 'Developer' documentation, clone the repository with git clone https://github.com/odoo/upgrade-util or create a symbolic link.
WARNING: Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English).
loading intersphinx inventory from ../invs/python.inv...
loading intersphinx inventory from ../invs/werkzeug.inv...
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 1022 source files that are out of date
updating environment: [new config] 1022 added, 0 changed, 0 removed

reading sources... [100%] legal/terms/i18n/enterprise_tex_de .. legal/terms/terms_of_sale_tex
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
/opt/documentation/content/developer/reference/external_api.rst:584: WARNING: Could not lex literal_block as "java". Highlighting skipped.
/opt/documentation/extensions/odoo_theme/translator.py:151: RemovedInSphinx60Warning: generate_targets_for_table() is deprecated
self.generate_targets_for_table(node)

copying downloadable files... [100%] applications/inventory_and_mrp/purchase/advanced/edi/P00017.xml
copying static files... done
copying extra files... done
dumping search index in English (code: en)... done
dumping object inventory... done
build succeeded, 3 warnings.

The HTML pages are in _build/html.
Build finished.

[AntoineVDV]

Hi @akram1, to build the documentation in a different language, you must pass extra arguments to make html. See here for the exhaustive list of extra arguments. For example, you can build the documentation in French only with make html CURRENT_LANG=fr.

If you want to build the documentation in additional languages and enable the language selector, run make html CURRENT_LANG=<lang> once per supported you want to display and pass the extra argument LANGUAGES=<lang1>,<lang2>,... each time. For example:

1. make html LANGUAGES=en,fr,de CURRENT_LANG=en
2. make html LANGUAGES=en,fr,de CURRENT_LANG=fr
3. make html LANGUAGES=en,fr,de CURRENT_LANG=de

[akram1]

Thank you for your reply and answer.

I think the line make html LANGUAGES=.... CURRENT_LANG=.... should be mentioned in the documentation. MakeFile does not mention that. You need to read the code to get to guess that.
I build using make html LANGUAGES=en,ar CURRENT_LANG=en. I noticed that I have to delete the builds and do it from scratch. It did build with two languages and language dropdown is active. However, if I select the second language, it comes blank page (ERR_FILE_NOT_FOUND). So ar option gives blank page. I rebuilt it with LANGUAGES=en,ar CURRENT_LANG=ar. Arabic is good but English is blank page.

I suggest the following:
1-
modify the readme file like bellow:

Instructions

1. In a terminal, navigate to the root directory of the documentation and build it make. This produces English version.
2. make help
   html to build the documentation to HTML
   fast to build the documentation to HTML with shallow menu (faster)
   clean to delete the build files
   test to run the guidelines tests
   3- You can use of these 4 options to build. make without option is defaulted to html.
3. To build multi languagal make LANGUAGES=lang1,lang2,...., CURRENT_LANG=lang1 where lang1,2.. are language en,es,ar....
4. Check directory ./locale, to see available languages. Some languages are not fully translated, so feel free to modify any translations.
5. To rebuild, you need to delete the first build
6. Additional commands are available with make help.
7. Open the file documentation/_build/html/index.html in your web browser.7. See this guide for more detailed instructions.

2-
Upgrade the Python package requirements. They are outdated packages.

[AntoineVDV]

Both your suggestions are already considered, but they are not a priority at the moment as we have many other things to focus on before we tackle that.

About your build issue, have you tried not deleting the _build directory in between two builds as I suggested, and build with en then ar in a row?