All of these scripts require you to have Node available in your environment. Get it from NodeJS.org.

A node script to replace all Learning Path article links with urls for a particular platform, using urls.yaml.

npm ci
node substitute_article_urls.js $TARGET

For example, to point all links to innersourcecommons.org:

node substitute_article_urls.js isc

Node script to generate markdown files required for hosting Learning Path on innersourcecommons.org.

This script requires a GitHub access token, as it uses the GitHub API to get Learning Path contributors. Your token does not require any scopes, as the Learning Path is Open Source. To provide this, create a .env file in this directory in the following format:

TOKEN=<your_github_token>

npm ci
node generate_learning_path_markdown.js

Anytime there are any changes, you need to run the script that generates the updated pages on the innersourcecommons.org site.

1. Clone the InnerSourceCommons/InnerSourceLearningPath and InnerSourceCommons/innersourcecommons.org repos.
2. Is this the first time that articles have been written for this language? If so:

• make sure this language appears in the website config and there are the relevant index pages

3. Is there a whole new Learning Path section? If so:

• update the "sections" config with the new section and open a pull request for the change

4. Run generate_learning_path_markdown.js as described above.
5. cp -r newsite/ <path-to-innersourcecommons.org-repo>/content/learn/learning-path/.
6. Open a pull request with the modified files in the InnerSourceCommons/innersourcecommons.org repo.