Merge branch 'pr/452'

Author: arnaud4d

.github/workflows/deploy.yml

@@ -20,12 +20,14 @@ jobs:
     - name: Download artifact
       uses: actions/download-artifact@v4
       with:
-        name: build
+        pattern: build-locale-*
+        merge-multiple: true
+        path: ./build
     - name: Publish
       uses: peaceiris/actions-gh-pages@v4
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./
+        publish_dir: ./build
 
   publish-release:
     needs: [workflow-static]

.github/workflows/workflow-build.yml

@@ -5,8 +5,15 @@ on:
 
 jobs:
   build:
+    strategy:
+      matrix:
+        language: ["en", "fr", "es", "ja", "pt"]
     runs-on: ubuntu-latest
     steps:
+      - name: Set directory
+        env:
+          LANGUAGE: ${{ matrix.language }}
+        run: echo "DEST_FOLDER=./build/$LANGUAGE" >> $GITHUB_ENV
       - name: Get disk space
         run: |
           df -h /
@@ -30,18 +37,25 @@ jobs:
         with:
           node-version: '22.x'
       - name: Build
+        env:
+          LANGUAGE_TO_BUILD: ${{ matrix.language }}
         run: |
           if [ -e package-lock.json ]; then
           npm ci
           else
           npm i
           fi
-          npm run build
+          if [ "$LANGUAGE_TO_BUILD" = 'en' ]; then
+            npm run build -- --locale $LANGUAGE_TO_BUILD
+          else
+            npm run build -- --locale $LANGUAGE_TO_BUILD --out-dir ./build/$LANGUAGE_TO_BUILD
+          fi
       - name: Google verification
+        if: matrix.language == 'en'
         run: |
           cd build
           echo "google-site-verification: google1a6263055b2bea44.html" >> google1a6263055b2bea44.html
       - uses: actions/upload-artifact@v4
         with:
           path: ./build
-          name: build
+          name: build-locale-${{ matrix.language }}

.github/workflows/workflow-syntax-check.yml

@@ -27,4 +27,16 @@ jobs:
           CLICOLOR_FORCE: 1
           COLORTERM: truecolor
         run: |
-          syntax_checker --paths "docs/**/*.md"
+          syntax_checker --paths "docs/**/*.md"
+      - name: Clone syntax-checker
+        run: git clone https://github.com/doc4d/syntax-checker.git
+              
+      - name: Install dependencies
+        run: |
+          cd syntax-checker
+          npm install
+          npm run build
+              
+      - name: Run syntax-checker
+        run: |
+          node syntax-checker/out/check.js ./docs

docs/API/CollectionClass.md

@@ -1383,10 +1383,10 @@ It can set the following parameter(s):
 var $col ; $result : Collection
 $col:=New collection(1; 2; 3; 4)
 
-$result:=$col.map(Formula(New collection($1.value*2))
+$result:=$col.map(Formula(New collection($1.value*2)))
  // [[2],[4],[6],[8]]
 
-$result:=$col.flatMap(Formula(New collection($1.value*2))
+$result:=$col.flatMap(Formula(New collection($1.value*2)))
 // [2,4,6,8]
 ```
 

docs/API/FileHandleClass.md

@@ -318,7 +318,7 @@ $s:=$fh.readText()
 <!--REF #FileHandleClass.readBlob().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|*bytes*|Real|->|Number of bytes to be read|
+|bytes|Real|->|Number of bytes to be read|
 |Result|[4D.Blob](BlobClass)|<-|Bytes read from the file|
 <!-- END REF -->
 
@@ -400,7 +400,7 @@ This function assumes that the [`.offset`](#offset) property is a number of char
 <!--REF #FileHandleClass.readText().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|*stopChar*|Text|->|Character(s) at which to stop reading|
+|stopChar|Text|->|Character(s) at which to stop reading|
 |Result|Text|<-|Text from the file|
 <!-- END REF -->
 
@@ -479,7 +479,7 @@ If the *size* value is less than the current document size, the document content
 <!--REF #FileHandleClass.writeBlob().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|*blob*|[4D.Blob](BlobClass)|->|Blob to write in the file|
+|blob|[4D.Blob](BlobClass)|->|Blob to write in the file|
 <!-- END REF -->
 
 
@@ -514,7 +514,7 @@ When this function is executed, the current position ([.offset](#offset)) is upd
 <!--REF #FileHandleClass.writeLine().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|*lineOfText*|Text|->|Text to write|
+|lineOfText|Text|->|Text to write|
 <!-- END REF -->
 
 
@@ -547,7 +547,7 @@ When this function is executed, the current position ([.offset](#offset)) is upd
 <!--REF #FileHandleClass.writeText().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|*textToWrite*|Text|->|Text to write|
+|textToWrite|Text|->|Text to write|
 <!-- END REF -->
 
 

docs/API/HTTPAgentClass.md

@@ -26,7 +26,7 @@ HTTPAgent objects provide the following properties and functions:
 
 ||
 |---|
-|[<!-- INCLUDE #HTTPAgentClass.params.Syntax -->](#options)<br/><!-- INCLUDE #HTTPAgentClass.params.Summary -->|
+|[<!-- INCLUDE #HTTPAgentClass.params.Syntax -->](#params)<br/><!-- INCLUDE #HTTPAgentClass.params.Summary -->|
 |[<!-- INCLUDE #HTTPAgentClass.requestsCount.Syntax -->](#requestscount)<br/><!-- INCLUDE #HTTPAgentClass.requestsCount.Summary -->|
 |[<!-- INCLUDE #HTTPAgentClass.freeSocketsCount.Syntax -->](#freesocketscount)<br/><!-- INCLUDE #HTTPAgentClass.freeSocketsCount.Summary -->|
 
@@ -113,7 +113,7 @@ When no agent is associated to an HTTPRequest, a global agent with default value
 
 :::
 
-<!-- REF #HTTPAgentClass.params.Desc -->
+<!-- REF HTTPAgentClass.params.Desc -->
 ## .params
 
 <!-- REF #HTTPAgentClass.params.Syntax -->**options** : Object<!-- END REF -->
@@ -124,7 +124,7 @@ The `.params` property object contains <!-- REF #HTTPAgentClass.params.Summary -
 
 <!-- END REF -->
 
-<!-- REF #HTTPAgentClass.requestsCount.Desc -->
+<!-- REF HTTPAgentClass.requestsCount.Desc -->
 ## .requestsCount
 
 <!-- REF #HTTPAgentClass.requestsCount.Syntax -->**requestsCount** : Integer<!-- END REF -->
@@ -135,7 +135,7 @@ The `.requestsCount` property contains <!-- REF #HTTPAgentClass.requestsCount.Su
 
 <!-- END REF -->
 
-<!-- REF #HTTPAgentClass.freeSocketsCount.Desc -->
+<!-- REF HTTPAgentClass.freeSocketsCount.Desc -->
 
 ## .freeSocketsCount
 

docs/API/HTTPRequestClass.md

@@ -73,7 +73,7 @@ HTTPRequest objects provide the following properties and functions:
 |[<!-- INCLUDE #HTTPRequestClass.url.Syntax -->](#url)<br/><!-- INCLUDE #HTTPRequestClass.url.Summary -->|
 |[<!-- INCLUDE #HTTPRequestClass.wait().Syntax -->](#wait)<br/><!-- INCLUDE #HTTPRequestClass.wait().Summary -->|
 
-<!-- REF #4D.HTTPRequest.new().Desc -->
+<!-- REF 4D.HTTPRequest.new().Desc -->
 ## 4D.HTTPRequest.new()
 
 
@@ -203,7 +203,7 @@ An authentication object handles the `options.serverAuthentication` or `options.
 <!-- END REF -->
 
 
-<!-- REF #HTTPRequestClass.agent.Desc -->
+<!-- REF HTTPRequestClass.agent.Desc -->
 ## .agent
 
 <!-- REF #HTTPRequestClass.agent.Syntax -->**agent** : 4D.HTTPAgent<!-- END REF -->
@@ -214,7 +214,7 @@ The `.agent` property contains <!-- REF #HTTPRequestClass.agent.Summary -->the `
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.dataType.Desc -->
+<!-- REF HTTPRequestClass.dataType.Desc -->
 ## .dataType
 
 <!-- REF #HTTPRequestClass.dataType.Syntax -->**dataType** : Text<!-- END REF -->
@@ -225,7 +225,7 @@ The `.dataType` property contains <!-- REF #HTTPRequestClass.dataType.Summary --
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.encoding.Desc -->
+<!-- REF HTTPRequestClass.encoding.Desc -->
 ## .encoding
 
 <!-- REF #HTTPRequestClass.encoding.Syntax -->**encoding** : Text<!-- END REF -->
@@ -236,7 +236,7 @@ The `.encoding` property contains <!-- REF #HTTPRequestClass.encoding.Summary --
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.errors.Desc -->
+<!-- REF HTTPRequestClass.errors.Desc -->
 ## .errors
 
 <!-- REF #HTTPRequestClass.errors.Syntax -->**errors** : Collection<!-- END REF -->
@@ -256,7 +256,7 @@ Here is the contents of the `.errors` property:
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.headers.Desc -->
+<!-- REF HTTPRequestClass.headers.Desc -->
 ## .headers
 
 <!-- REF #HTTPRequestClass.headers.Syntax -->**headers** : Object<!-- END REF -->
@@ -267,7 +267,7 @@ The `.headers` property contains <!-- REF #HTTPRequestClass.headers.Summary -->t
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.method.Desc -->
+<!-- REF HTTPRequestClass.method.Desc -->
 ## .method
 
 <!-- REF #HTTPRequestClass.method.Syntax -->**method** : Text<!-- END REF -->
@@ -278,7 +278,7 @@ The `.method` property contains <!-- REF #HTTPRequestClass.method.Summary -->the
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.protocol.Desc -->
+<!-- REF HTTPRequestClass.protocol.Desc -->
 ## .protocol
 
 <!-- REF #HTTPRequestClass.protocol.Syntax -->**protocol** : Text<!-- END REF -->
@@ -291,7 +291,7 @@ The `.protocol` property contains <!-- REF #HTTPRequestClass.protocol.Summary --
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.response.Desc -->
+<!-- REF HTTPRequestClass.response.Desc -->
 ## .response
 
 <details><summary>History</summary>
@@ -320,7 +320,7 @@ A `response` object is a non-sharable object. It provides the following properti
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.returnResponseBody.Desc -->
+<!-- REF HTTPRequestClass.returnResponseBody.Desc -->
 ## .returnResponseBody
 
 <!-- REF #HTTPRequestClass.returnResponseBody.Syntax -->**returnResponseBody** : Boolean<!-- END REF -->
@@ -331,7 +331,7 @@ The `.returnResponseBody` property contains <!-- REF #HTTPRequestClass.returnRes
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.terminate().Desc -->
+<!-- REF HTTPRequestClass.terminate().Desc -->
 ## .terminate()
 
 <!-- REF #HTTPRequestClass.terminate().Syntax -->**.terminate()**<!-- END REF -->
@@ -351,7 +351,7 @@ The `.terminate()` function <!-- REF #HTTPRequestClass.terminate().Summary -->ab
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.terminated.Desc -->
+<!-- REF HTTPRequestClass.terminated.Desc -->
 ## .terminated
 
 <!-- REF #HTTPRequestClass.terminated.Syntax -->**terminated** : Boolean<!-- END REF -->
@@ -362,7 +362,7 @@ The `.terminated` property contains <!-- REF #HTTPRequestClass.terminated.Summar
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.timeout.Desc -->
+<!-- REF HTTPRequestClass.timeout.Desc -->
 ## .timeout
 
 <!-- REF #HTTPRequestClass.timeout.Syntax -->**timeout** : Real<!-- END REF -->
@@ -373,7 +373,7 @@ The `.timeout` property contains <!-- REF #HTTPRequestClass.timeout.Summary -->t
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.url.Desc -->
+<!-- REF HTTPRequestClass.url.Desc -->
 ## .url
 
 <!-- REF #HTTPRequestClass.url.Syntax -->**url** : Text<!-- END REF -->
@@ -384,7 +384,7 @@ The `.url` property contains <!-- REF #HTTPRequestClass.url.Summary -->the URL o
 
 <!-- END REF -->
 
-<!-- REF #HTTPRequestClass.wait().Desc -->
+<!-- REF HTTPRequestClass.wait().Desc -->
 ## .wait()
 
 <!-- REF #HTTPRequestClass.wait().Syntax -->**.wait**( { *timeout* : Real } ) : 4D.HTTPRequest<!-- END REF -->

docs/API/IMAPTransporterClass.md

@@ -241,7 +241,7 @@ $status:=$imap.append($msg; "Drafts")
 
 <!-- INCLUDE transporter.checkConnection().Desc -->
 
-<!-- REF #IMAPTransporterClass.checkConnectionDelay.Desc -->
+<!-- REF IMAPTransporterClass.checkConnectionDelay.Desc -->
 
 ## .checkConnectionDelay