Add french locale in antora configuration

Author: andreslucena

antora-playbook.yml

@@ -12,6 +12,9 @@ content:
       start_path: docs/en
       branches: [release/0.30-stable, release/0.29-stable, release/0.28-stable, release/0.27-stable, develop]
       edit_url: "https://github.com/decidim/documentation/edit/{refname}/{path}"
+    - url: &documentation https://github.com/decidim/documentation
+      start_path: docs/fr
+      branches: [develop]
     - url: https://github.com/decidim/decidim
       start_path: docs
       branches: [release/0.30-stable, release/0.29-stable, release/0.28-stable, release/0.27-stable, develop]

bin/playbook-changer.js

@@ -98,17 +98,27 @@ async function getMetadataFromEnvironment() {
 // @param {string} metadata.headRef - the head reference of git
 //                                    It's the name of the current branch
 function writeToFile(antoraPlaybookFile, metadata) {
-  fs.readFile(antoraPlaybookFile, "utf8", function (err,data) {
+  fs.readFile(antoraPlaybookFile, "utf8", function (err, data) {
     if (err) {
-      return console.err(err);
+      return console.error(err);
     }
 
-    let result = data.replace(metadata.baseRef, metadata.headRef);
+    let result = data;
 
     const isDevelopment = metadata.headRef === "HEAD";
+
+    // Only modify inside documentation sources
+    result = result.replace(
+      /(- url: &documentation[^\n]*\n(?:\s+.*\n)*?\s+branches:\s*\[[^\]]*?),\s*develop(\s*\])/gm,
+      `$1, ${metadata.headRef}$2`
+    );
+
     if (isDevelopment) {
-      const antoraDocumentationUrl = "https://github.com/decidim/documentation";
-      result = result.replace(antoraDocumentationUrl, ".");
+      // Replace only the documentation URLs, not the decidim/decidim one
+      result = result.replace(
+        /^(\s*-\s*url:\s*&documentation\s*)https:\/\/github\.com\/decidim\/documentation/mg,
+        "$1."
+      );
     }
 
     console.log("********************************")
@@ -118,7 +128,7 @@ function writeToFile(antoraPlaybookFile, metadata) {
 
     fs.writeFile(antoraPlaybookFile, result, "utf8", function (err) {
       if (err) {
-        return console.err(err);
+        return console.error(err);
       }
     });
   });

docs/fr/antora.yml

@@ -0,0 +1,8 @@
+name: fr
+title: "Decidim Documentation"
+version: develop
+asciidoc:
+  attributes:
+    page-lang: fr@
+nav:
+- modules/ROOT/nav.adoc