From a4ecf798d4fd6e56705aff1b029dd6fddd65262b Mon Sep 17 00:00:00 2001 From: David Dorchies <david.dorchies@inrae.fr> Date: Fri, 19 Jul 2024 14:10:30 +0000 Subject: [PATCH] docs(css): justify text content --- docs/{mathjax-scrollbar.css => mkdocs-custom.css} | 5 +++++ scripts/mkdocs-postprocess.js | 14 +++++++------- 2 files changed, 12 insertions(+), 7 deletions(-) rename docs/{mathjax-scrollbar.css => mkdocs-custom.css} (71%) diff --git a/docs/mathjax-scrollbar.css b/docs/mkdocs-custom.css similarity index 71% rename from docs/mathjax-scrollbar.css rename to docs/mkdocs-custom.css index 1609cabff..8cb69aacb 100644 --- a/docs/mathjax-scrollbar.css +++ b/docs/mkdocs-custom.css @@ -7,3 +7,8 @@ mjx-math { overflow-y: clip; } + +/* Justified text in documentation content */ +.md-content { + text-align: justify; +} diff --git a/scripts/mkdocs-postprocess.js b/scripts/mkdocs-postprocess.js index 11b259033..759834c66 100644 --- a/scripts/mkdocs-postprocess.js +++ b/scripts/mkdocs-postprocess.js @@ -20,7 +20,7 @@ fs.ensureDirSync(destPath_JS_MJ + "/fonts/HTML-CSS/TeX/", { recursive: true }); fs.copySync("node_modules/mathjax/es5/tex-mml-chtml.js", destPath_JS_MJ + "/tex-mml-chtml.js"); fs.copySync("node_modules/mathjax/es5/output/chtml/fonts", destPath_JS_MJ + "/output/chtml/fonts"); fs.copySync("docs/mathjax.config.js", destPath_JS + "/mathjax.config.js"); -fs.copySync("docs/mathjax-scrollbar.css", destPath_CSS + "/mathjax-scrollbar.css"); +fs.copySync("docs/mkdocs-custom.css", destPath_CSS + "/mkdocs-custom.css"); fs.copySync("docs/matomo-tracking.js", destPath_JS + "/matomo-tracking.js"); fs.copySync("node_modules/mermaid/dist/mermaid.min.js", destPath_JS + "/mermaid.min.js"); fs.copySync("node_modules/mermaid/dist/mermaid.min.js.map", destPath_JS + "/mermaid.min.js.map"); @@ -30,15 +30,15 @@ Ici, on veut que les ressources copiées ci dessus soit accessibles. mkdocs-xx.yml : extra_css: - - ../stylesheets/mathjax-scrollbar.css + - ../stylesheets/mkdocs-custom.css Fichiers HTML générés : -Par ex src/assets/docs/fr/calculators/maths/solver.html contient <link rel="stylesheet" href="../../stylesheets/mathjax-scrollbar.css"> +Par ex src/assets/docs/fr/calculators/maths/solver.html contient <link rel="stylesheet" href="../../stylesheets/mkdocs-custom.css"> ce qui fait référence à stylesheets dans src/assets/docs/fr alors qu'on veut référencer stylesheets dans src/assets/docs/ (le chemin généré dépend de l'emplacement du fichier le contenant). -Le problème, c'est que si on modifie extra_css avec ../../stylesheets/mathjax-scrollbar.css, cela génère la même chose -(href="../../stylesheets/mathjax-scrollbar.css") vraisemblablement à cause de site_dir (=docs/fr) qui limite les "remontées" +Le problème, c'est que si on modifie extra_css avec ../../stylesheets/mkdocs-custom.css, cela génère la même chose +(href="../../stylesheets/mkdocs-custom.css") vraisemblablement à cause de site_dir (=docs/fr) qui limite les "remontées" de niveau de répertoire. La solution est donc de modifier les fichiers HTML générés pour ajouter ../ dans href="...". @@ -75,8 +75,8 @@ function replaceHtml(base_dir, s1, s2) { execBashCmd(cmd); } -replaceHtml("src/assets/docs/fr/", "../../stylesheets/mathjax-scrollbar.css", "../../../stylesheets/mathjax-scrollbar.css"); -replaceHtml("src/assets/docs/en/", "../../stylesheets/mathjax-scrollbar.css", "../../../stylesheets/mathjax-scrollbar.css"); +replaceHtml("src/assets/docs/fr/", "../../stylesheets/mkdocs-custom.css", "../../../stylesheets/mkdocs-custom.css"); +replaceHtml("src/assets/docs/en/", "../../stylesheets/mkdocs-custom.css", "../../../stylesheets/mkdocs-custom.css"); replaceHtml("src/assets/docs/fr/", "../../javascripts/mathjax.config.js", "../../../javascripts/mathjax.config.js"); replaceHtml("src/assets/docs/en/", "../../javascripts/mathjax.config.js", "../../../javascripts/mathjax.config.js"); -- GitLab