Update prod

.doc_preprocessing.js

@@ -17,6 +17,14 @@ module.exports = {
                 from: "→",
                 to: "->"
             },
+            {
+                from: "<div class=\"no-index\">",
+                to: ""
+            },
+            {
+                from: "</div>",
+                to: ""
+            },
             {
                 from: "&larr;",
                 to: "<-"

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "git.ignoreLimitWarning": true
+}

README.md

@@ -204,6 +204,148 @@ Aller dans l'interface Algolia et lancer un reindex de la doc
 4. git push (fait une PR auto et pas de conflit)
 
 
+## Building new architecture for sorted themes
+### Edit the sidebars.js file
+- replace the whole themes "Commands by themes" with
+```{
+          "type": "category",
+          "label": "Commands by theme",
+          "items": [
+            {
+              "type": "autogenerated",
+              "dirName": "language-legacy",
+            }
+          ],
+        },
+```
+### Edit the docusaurus.config.js
+1. fix the locale for npm run start
+```function getCliLocaleFromArgv() {
+  // supporte: "--locale fr" ou "--locale=fr"
+  const i = process.argv.indexOf('--locale');
+  if (i > -1 && process.argv[i + 1] && !process.argv[i + 1].startsWith('--')) {
+    return process.argv[i + 1];
+  }
+  const eq = process.argv.find((a) => a.startsWith('--locale='));
+  if (eq) return eq.split('=')[1];
+  return undefined;
+}
+```
+2. Implement the functions to get i18n, sort, and push
+```// docusaurus.config.js
+const fs = require('fs');
+const path = require('path');
+
+// 1) Collator FR (tri “dictionnaire” : accents pris en compte)
+const collators = {};
+function getCollator(locale) {
+  const loc = locale || 'en';
+  if (!collators[loc]) {
+    // Sensibilité 'accent' => 'é' > 'e' (contraire de 'base' qui les considère égaux)
+    collators[loc] = new Intl.Collator(loc, {
+      usage: 'sort',
+      sensitivity: 'accent',
+      ignorePunctuation: false,
+      numeric: true,
+    });
+    // Log de diag : vérifie la locale réellement résolue par ICU
+    const resolved = collators[loc].resolvedOptions().locale;
+    console.log(`[sidebar-sort] requested=${loc} resolved=${resolved}`);
+  }
+  return collators[loc];
+}
+
+// 2) Charge le catalogue i18n des sidebars pour la locale
+function loadSidebarTranslations(locale) {
+  if (!locale || typeof locale !== 'string') return {};
+  const base = path.join(__dirname, 'i18n', locale, 'docusaurus-plugin-content-docs');
+  const candidates = [
+    path.join(base, 'current.json'),
+    path.join(base, 'current', 'current.json'),
+    path.join(base, 'default', 'current.json'),
+    path.join(__dirname, 'i18n', locale, 'code.json'),
+  ];
+  for (const file of candidates) {
+    if (fs.existsSync(file)) {
+      try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+      } catch { /* ignore */ }
+    }
+  }
+  return {};
+}
+
+// 3) Déduit le nom de la sidebar (docs/mainSidebar/…)
+//    à partir des clés présentes dans le JSON de traduction.
+function guessSidebarNameFromTranslations(translations) {
+  for (const k of Object.keys(translations || {})) {
+    const m = /^sidebar\.([^.]+)\.category\./.exec(k);
+    if (m) return m[1];
+  }
+  return 'docs';
+}
+
+// 4) Récupère la traduction d’un label de catégorie
+function getTranslatedCategoryLabel(labelSource, sidebarName, translations) {
+  const src = String(labelSource || '').normalize('NFC').trim();
+  if (!src) return '';
+  const directKey = `sidebar.${sidebarName}.category.${src}`;
+  const direct = translations[directKey]?.message;
+  if (direct && direct.trim()) return direct;
+
+  // Tolérance : si le nom de sidebar diffère, on scanne
+  for (const [k, v] of Object.entries(translations)) {
+    const m = /^sidebar\.([^.]+)\.category\.(.+)$/.exec(k);
+    if (!m) continue;
+    const keyLabel = String(m[2] || '').normalize('NFC').trim();
+    if (keyLabel.localeCompare(src, undefined, {sensitivity: 'accent'}) === 0) {
+      const msg = v?.message;
+      if (msg && msg.trim()) return msg;
+    }
+  }
+  // Pas de traduction → fallback source
+  return src;
+}
+
+// 5) Clé de tri
+function sortKey(item, helpers) {
+  const { translations, sidebarName } = helpers;
+  if (item.type === 'category') {
+    return getTranslatedCategoryLabel(item.label, sidebarName, translations);
+  }
+  return item.label || item.title || item.id || '';
+}
+
+// 6) Tri des catégories racine.
+function sortRec(items, helpers) {
+  const collator = getCollator(helpers.locale);
+  const withChildrenSorted = items.map((it) => {
+    if (it.type === 'category' && Array.isArray(it.items)) {
+      return { ...it, items: sortRec(it.items, helpers) };
+    }
+    return it;
+  });
+  return withChildrenSorted.sort((a, b) => collator.compare(sortKey(a, helpers), sortKey(b, helpers)));
+}
+```
+
+### In docs/ AND in i18n/\<locale>\/docusaurus-plugin-content-docs/current folders
+
+1. Add a "language-legacy/" folder
+2. Add "language-legacy/\<theme\>" subfolders
+3. "language-legacy/\<theme>\/_category_.json" files
+contents of the_category_.json files:
+```{
+  "label": "Arrays",
+  "link": {"type": "doc", "id": "commands/theme/Arrays_theme"},
+  "key": "Arrays-key"
+}
+```
+4; Check missing slugs
+4. fix links:
+   - ./commands/truc.md -> ./commands/truc
+   - ../commands/truc.md -> ../commands/truc
+   - ../commands-legacy/truc.md -> ../commands/truc
 
 
 

crowdin.yml

@@ -5,6 +5,7 @@ files:
       - /docs/commands-legacy/*.*
       - /docs/*-legacy/*.*
       - /docs/WritePro/*-legacy/*.*
+      - /docs/language-legacy/**/*.*
     translation: /i18n/%two_letters_code%/docusaurus-plugin-content-docs/current/**/%original_file_name%
   - source: /i18n/en/docusaurus-plugin-content-docs/*.json
     ignore:
@@ -17,6 +18,7 @@ files:
       - /versioned_docs/**/WritePro/*-legacy/*.*
       - /versioned_docs/version-18/
       - /versioned_docs/**/*-legacy/*.*
+      - /versioned_docs/**/language-legacy/**/*.*
     translation: /i18n/%two_letters_code%/docusaurus-plugin-content-docs/**/%original_file_name%
   - source: /i18n/en/docusaurus-theme-classic/*.json
     translation: /i18n/%two_letters_code%/docusaurus-theme-classic/%original_file_name%

docs/API/BlobClass.md

@@ -27,12 +27,14 @@ The Blob class lets you create and manipulate [blob objects](../Concepts/dt_blob
 
 
 <!-- REF #4D.Blob.new().Params -->
+<div class="no-index">
 
 | Parameter | Type            |     | Description  |
 | --------- | --------------- | :-: | ------------ |
 | blobScal      | Blob | ->  | Blob to copy |
 | blobObj      | 4D.Blob | ->  | Blob to copy |
 | Result    | 4D.Blob         | <-  | New 4D.Blob  |
+</div>
 <!-- END REF -->
 
 #### Description
@@ -62,11 +64,14 @@ The `.size` property <!-- REF #Blob.size.Summary -->returns the size of a `4D.Bl
 
 
 <!-- REF #Blob.slice().Params -->
+<div class="no-index">
+
 | Parameter | Type ||Description |
 | --------- | ------- | :-: | --- |
 | start| Real    | ->  | index of the first byte to include in the new `4D.Blob`.               |
 | end| Real    | ->  | index of the first byte that will not be included in the new `4D.Blob` |
 | Result| 4D.Blob | <-  | New `4D.Blob`|
+</div>
 <!-- END REF -->
 
 #### Description

docs/API/ClassClass.md

@@ -153,10 +153,13 @@ This property is **read-only**.
 
 
 <!-- REF #ClassClass.new().Params -->
+<div class="no-index">
+
 |Parameter|Type||Description|
 |---------|--- |:---:|------|
 |param|any|->|Parameter(s) to pass to the constructor function|
 |Result|4D.Object|<-|New object of the class|
+</div>
 <!-- END REF -->