Add script to check links in translations (#457)

* Add note to old script that doesn't work with translation

* Use script to update links in articles

* Update scripts README

Author: tsadler1988

contributor/de/01-introduction-article-de.asciidoc

@@ -21,8 +21,8 @@ https://innersourcecommons.org/learn/learning-path/trusted-committer[_Trusted Co
 Manchmal übernimmt eine Person mehrere Rollen, z. B. die des Trusted Committer und des Product Owner speziell in kleineren Projekten.
 
 Im Folgenden findest Du einen sehr kurzen Überblick über die anderen Rollen, aber wir möchten Dich ermutigen, die weiterführenden Artikel 
-https://innersourcecommons.org/learn/learning-path/trusted-committer/01/[introductory article of the Trusted Committer role] und https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[Lowering the barriers to entry] zu lesen, bevor Du Dich tiefer in die Details der Contributor Rolle in diesem Abschnitt einarbeitest.
-Alternativ kannst Du Dir auch unsere Videos zu den Themen anschauen: https://innersourcecommons.org/learn/learning-path/trusted-committer/01/[introduction], https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[lowering the barriers to entry].
+https://innersourcecommons.org/de/learn/learning-path/trusted-committer/01/[introductory article of the Trusted Committer role] und https://innersourcecommons.org/de/learn/learning-path/trusted-committer/05/[Lowering the barriers to entry] zu lesen, bevor Du Dich tiefer in die Details der Contributor Rolle in diesem Abschnitt einarbeitest.
+Alternativ kannst Du Dir auch unsere Videos zu den Themen anschauen: https://innersourcecommons.org/de/learn/learning-path/trusted-committer/01/[introduction], https://innersourcecommons.org/de/learn/learning-path/trusted-committer/05/[lowering the barriers to entry].
 
 ==== Trusted Committer
 

contributor/es/01-introduction-article-es.asciidoc

@@ -19,8 +19,8 @@ Por último, algunos colaboradores pueden convertirse en https://innersourcecomm
 Como Colaborador en una comunidad de InnerSource, interactuará con otras personas que desempeñan otros roles de InnerSource, como https://innersourcecommons.org/learn/learning-path/trusted-committer[_Trusted Committer_] o https://innersourcecommons.org/learn/learning-path/product-owner[_Product Owner_] y posiblemente con otros colaboradores.
 A veces, estos roles pueden ser desempeñados por la misma persona, como Trusted Committer y Product Owner en pequeños proyectos.
 
-Esta sección le brinda una muy breve descripción general de los otros dos roles, pero nos gustaría animarle a que lea el https://innersourcecommons.org/learn/learning-path/trusted-committer[artículo de introducción al rol de Trusted Committer], y le recomendamos que lea también el artículo https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[Bajando las barreras de entrada] antes de profundizar en los detalles del rol de Colaborador en esta sección.
-También puede ver los videos (https://innersourcecommons.org/learn/learning-path/trusted-committer[introducción], https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[bajando las barreras de entrada]) en lugar de leer los artículos.
+Esta sección le brinda una muy breve descripción general de los otros dos roles, pero nos gustaría animarle a que lea el https://innersourcecommons.org/learn/learning-path/trusted-committer[artículo de introducción al rol de Trusted Committer], y le recomendamos que lea también el artículo https://innersourcecommons.org/es/learn/learning-path/trusted-committer/05/[Bajando las barreras de entrada] antes de profundizar en los detalles del rol de Colaborador en esta sección.
+También puede ver los videos (https://innersourcecommons.org/learn/learning-path/trusted-committer[introducción], https://innersourcecommons.org/es/learn/learning-path/trusted-committer/05/[bajando las barreras de entrada]) en lugar de leer los artículos.
 
 ==== Trusted Committer
 

introduction/es/06-conclusion.asciidoc

@@ -3,7 +3,7 @@
 En este módulo hemos visto una introducción a InnerSource.
 InnerSource aplica las buenas prácticas de desarrollo de los proyectos de software libre en desarrollos internos.
 Ofrece una opción adicional a los consumidores internos cuando los equipos de desarrollo no pueden atender una petición.
-Para llevar a cabo InnerSource de forma satisfactoria, se ha de involucrar al https://innersourcecommons.org/learn/learning-path/product-owner/01[_product owner_] y a los https://innersourcecommons.org/learn/learning-path/trusted-committer/01[_trusted committers_] del *equipo anfitrión* así como a https://innersourcecommons.org/learn/learning-path/contributor/01[_contribuidores_] del *equipo invitado*
+Para llevar a cabo InnerSource de forma satisfactoria, se ha de involucrar al https://innersourcecommons.org/learn/learning-path/product-owner/01[_product owner_] y a los https://innersourcecommons.org/es/learn/learning-path/trusted-committer/01[_trusted committers_] del *equipo anfitrión* así como a https://innersourcecommons.org/es/learn/learning-path/contributor/01[_contribuidores_] del *equipo invitado*
 Un InnerSource efectivo beneficiará a ambas partes.
 Los principios clave sobre los que se basa el trabajo de InnerSource son las *contribuciones voluntarias de código fuente* y la *priorización de actividades de mentoría*.
 

scripts/README.md

@@ -15,6 +15,16 @@ For example, to point all links to innersourcecommons.org:
 node substitute_article_urls.js isc
 ```
 
+## updates_links_in_translations.js
+
+A node script to ensure article links point at the relevant translation if it exists, or default (English) if not.
+
+### Usage:
+```
+npm ci
+node updates_links_in_translations.js
+```
+
 ## generate_learning_path_markdown.js
 
 Node script to generate markdown files required for hosting Learning Path on innersourcecommons.org.

scripts/substitute_article_urls.js

@@ -1,3 +1,5 @@
+// TODO: Update to work with translations; may require changing the urls.yaml
+
 const fs = require('fs')
 const YAML = require('yaml')
 const { join } = require('path')

scripts/update_links_in_translations.js

@@ -0,0 +1,47 @@
+const fs = require('fs')
+const { join } = require('path')
+
+const getArticleFiles = (path, translation) => {
+  return fs.readdirSync(path, { withFileTypes: true }).map((dirent) => {
+    const filePath = join(path, dirent.name)
+    if (dirent.isDirectory()) {
+      return getArticleFiles(filePath, dirent.name)
+    } else {
+      return {
+        filePath,
+        asciiDoc: fs.readFileSync(filePath, 'utf-8'),
+        translation
+      }
+    }
+  }).flat()
+}
+const articleFiles = [getArticleFiles(join('..', 'introduction')), getArticleFiles(join('..', 'product-owner')), getArticleFiles(join('..', 'trusted-committer')), getArticleFiles(join('..', 'contributor'))].flat()
+
+const articleTranslationExists = (section, translation, segment) => {
+  const searchTerm = join('..', section, translation, segment)
+  return !!articleFiles.find(file => file.filePath.startsWith(searchTerm))
+}
+
+articleFiles.forEach(({ asciiDoc, filePath, translation }) => {
+  if (!translation) return
+
+  const matches = [...asciiDoc.matchAll(/https:\/\/innersourcecommons\.org\/([\w\-]+\/)?learn\/learning-path\/([\w\-]+)\/([\w\-]+)/gm)]
+  matches.forEach((match) => {
+    const url = match[0]
+    const linkedTranslation = match[1] ? match[1].replace('/', '') : ''
+    const section = match[2]
+    const segment = match[3]
+
+    // Link to translation if exists
+    if (translation !== linkedTranslation && articleTranslationExists(section, translation, segment)) {
+      asciiDoc = asciiDoc.replace(url, `https://innersourcecommons.org/${translation}/learn/learning-path/${section}/${segment}`)
+    }
+
+    // Link to default if does not exist
+    if (translation === linkedTranslation && !articleTranslationExists(section, translation, segment)) {
+      asciiDoc = asciiDoc.replace(url, `https://innersourcecommons.org/learn/learning-path/${section}/${segment}`)
+    }
+
+  })
+  fs.writeFileSync(filePath, asciiDoc)
+})

trusted-committer/de/01-introduction-de.asciidoc

@@ -57,11 +57,11 @@ kurzen Blick auf die Verantwortlichkeiten eines _Trusted Committers_ werfen.
 
 _Trusted Committers_ haben verschiedene Verantwortlichkeiten, unter anderem:
 
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/02/[Ensuring product quality]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/03/[Keeping the community healthy]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[Reducing the barriers to making contributions]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/04/[Upleveling the community]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/06/[Advocating the community's needs]
+* https://innersourcecommons.org/de/learn/learning-path/trusted-committer/02/[Ensuring product quality]
+* https://innersourcecommons.org/de/learn/learning-path/trusted-committer/03/[Keeping the community healthy]
+* https://innersourcecommons.org/de/learn/learning-path/trusted-committer/05/[Reducing the barriers to making contributions]
+* https://innersourcecommons.org/de/learn/learning-path/trusted-committer/04/[Upleveling the community]
+* https://innersourcecommons.org/de/learn/learning-path/trusted-committer/06/[Advocating the community's needs]
 
-Wir werden diese Verantwortlichkeiten in den folgenden Kapiteln weiter vertiefen, bitte schau Dir dazu auch das Kapitel https://innersourcecommons.org/learn/learning-path/trusted-committer/07/[07 becoming a Trusted Committer] am Ende an.
+Wir werden diese Verantwortlichkeiten in den folgenden Kapiteln weiter vertiefen, bitte schau Dir dazu auch das Kapitel https://innersourcecommons.org/de/learn/learning-path/trusted-committer/07/[07 becoming a Trusted Committer] am Ende an.
 [role="pagenumrestart"]

trusted-committer/de/03-keeping-the-community-healthy-de.asciidoc

@@ -24,7 +24,7 @@ Sie liefern die Theorie oder die Erfahrung bei Quellcodeänderungen und schlagen
 
 Wir glauben, dass _Trusted Committer_ das Onboarding und Mentoring während der Pull Requests über das Erreichen von Releaseterminen stellen sollten, außer es sprechen triftige Gründe dagegen. 
 Gute Betreuung während eines Pull Requests führt zu höherem Vertrauen und Bindung von https://innersourcecommons.org/learn/learning-path/contributor[_Contributors_], was im Gegenzug zu mehr Mitarbeit führt. 
-Wir werden diesen Aspekt in https://innersourcecommons.org/learn/learning-path/trusted-committer/04/["Upleveling the Community"] näher betrachten.
+Wir werden diesen Aspekt in https://innersourcecommons.org/de/learn/learning-path/trusted-committer/04/["Upleveling the Community"] näher betrachten.
 
 Schliesslich gibt es Menschen, die sich in _InnerSource Communities_ engagieren, weil sie sich dort auf das Entwickeln von Software konzentrieren können anstatt anderen Aufgaben nachzugehen, die häufig als überflüssig oder unnötig angesehen werden. 
 Dies trifft häufig auf große Unternehmen mit einem starken Fokus auf Prozesse zu. 
@@ -36,6 +36,6 @@ Allgemein gesprochen müssen _Trusted Committer_ sicherstellen, dass der Prozess
 Schließlich sollten _Trusted Committer_ ihre Community dazu befähigen, prozessbezogene Probleme zu finden und diese so gut wie möglich selbst anzupassen und zu verbessern.
 
 Damit _Trusted Committer_ alle diese Verantwortlichkeiten erfüllen können, ist es wichtig, dass sie regelmäßig mit den Mitgliedern der Community kommunizieren und ein Gespür für die allgemeine Stimmung entwickeln. 
-Wir werden dies näher im Kapitel https://innersourcecommons.org/learn/learning-path/trusted-committer/06/["Advocating the Community's Needs"] betrachten.
+Wir werden dies näher im Kapitel https://innersourcecommons.org/de/learn/learning-path/trusted-committer/06/["Advocating the Community's Needs"] betrachten.
 
 Zusammengefasst sollten _Trusted Committer_ sich bemühen ein einladendes und annerkennendes Umfeld für ihre https://innersourcecommons.org/learn/learning-path/contributor[_Contributors_] zu erzeugen, welches diesen erlaubt, sich auf das Schreiben von Software zu konzentrieren und ihre Persönlichkeit weiterzuentwickeln indem sie von anderen Mitgliedern der Organisation lernen.

trusted-committer/de/04-uplevelling-community-members-de.asciidoc

@@ -15,7 +15,7 @@ Letztendlich sind die _Trusted Committers_ dafür verantwortlich, https://inners
 Dies ist unserer Meinung nach die edelste Aufgabe eines _Trusted Committers_, und diese Aufgabe lohnt sich sowohl für den _Trusted Committer_ als auch für den _Contributor_.
 _Trusted Committer_ berichten, dass Mentoring und zu sehen, wie Menschen lernen und zur Community beitragen, mehr als genug Ersatz dafür ist, dass die _Trusted Committer_ weniger Zeit haben, selbst Software zu schreiben.
 
-Wie in https://innersourcecommons.org/learn/learning-path/trusted-committer/03/[previous section] erwähnt, sind Lernen und persönliches Wachstum wesentliche Gründe für Menschen, einer InnerSoure Community beizutreten und dabei zu bleiben. 
+Wie in https://innersourcecommons.org/de/learn/learning-path/trusted-committer/03/[previous section] erwähnt, sind Lernen und persönliches Wachstum wesentliche Gründe für Menschen, einer InnerSoure Community beizutreten und dabei zu bleiben. 
 Die Weiterbildung ihrer https://innersourcecommons.org/learn/learning-path/contributor[_Contributors_] ist eines der stärksten Werkzeuge, welches _Trusted Committer_ zur Verfügung haben, um die Geschwindigkeit, den Output und die Langlebigkeit ihrer Communitiy zu erhöhen.
 Es ist auch eines der Hauptargumente, um das Management eines Unternehmens davon zu überzeugen, ihren Mitarbeitern zu erlauben an einer _InnerSource Community_ teilzunehmen, da dies ihre Mitarbeiter für das Unternehmen wertvoller macht und dem Unternehmen hilft, seine Top-Talente zu halten.
 

trusted-committer/es/01-introduction-es.asciidoc

@@ -64,10 +64,10 @@ vamos a hechar un vistazo rápido a las responsabilidades de un Trusted Committe
 
 === Responsabilidades
 
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/02/[Asegurar la calidad del producto]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/03/[Mantener una comunidad sana]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/05/[Reducir las barreras para hacer contribuciones]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/04/[Subir de nível a la comunidad]
-* https://innersourcecommons.org/learn/learning-path/trusted-committer/06/[Abogar por las necesidades de la comunidad]
+* https://innersourcecommons.org/es/learn/learning-path/trusted-committer/02/[Asegurar la calidad del producto]
+* https://innersourcecommons.org/es/learn/learning-path/trusted-committer/03/[Mantener una comunidad sana]
+* https://innersourcecommons.org/es/learn/learning-path/trusted-committer/05/[Reducir las barreras para hacer contribuciones]
+* https://innersourcecommons.org/es/learn/learning-path/trusted-committer/04/[Subir de nível a la comunidad]
+* https://innersourcecommons.org/es/learn/learning-path/trusted-committer/06/[Abogar por las necesidades de la comunidad]
 
-Vamos a ver estas responsabilidades más a fondo en las siguientes páginas, y también vamos a explorar el camino de https://innersourcecommons.org/learn/learning-path/trusted-committer/07/[llegar a ser un Trusted Committer] al final de este artículo.
+Vamos a ver estas responsabilidades más a fondo en las siguientes páginas, y también vamos a explorar el camino de https://innersourcecommons.org/es/learn/learning-path/trusted-committer/07/[llegar a ser un Trusted Committer] al final de este artículo.