Avoid github-pages to interpret curly brackets

GH Pages / Jekyll use curly brackets as Liquid templates
placeholders. We don't want them interpreted that way
within various examples in the documentation but,
instead, show them raw.

Also, we put them within an HTML comment, so they won't
show in regular Markdown display.

Author: stronk7

docs/CodeCoverage.md

@@ -48,6 +48,7 @@ Some examples follow:
 
 #### GitHub Actions
 
+<!-- {% raw %} -->
 ```yaml
       - name: PHPUnit tests
         if: ${{ always() }}
@@ -57,6 +58,8 @@ Some examples follow:
         env:
           COVERALLS_REPO_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
+<!-- {% endraw %} -->
+
 Note that, instead of the automatically generated for every run `${{ secrets.GITHUB_TOKEN }}` token you can use any other GitHub token (PAT...) with the correct perms or, also, the token that Coveralls offers to you for every repository. Just it's easier to use the automatic GitHub one, because that way you don't need to create tokens or secrets manually and maintain them.
 
 #### Travis

docs/GHAFileExplained.md

@@ -13,6 +13,7 @@ the new syntax, also you may find this [migration
 manual](https://docs.github.com/en/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions)
 useful.
 
+<!-- {% raw %} -->
 ```yaml
 # Title of the workflow
 name: Moodle Plugin CI
@@ -175,3 +176,4 @@ jobs:
         if: ${{ always() }}
         run: moodle-plugin-ci behat --profile chrome
 ```
+<!-- {% endraw %} -->

docs/IgnoringFiles.md

@@ -16,6 +16,7 @@ in your CI workflow file.  These environment variables wont work for Grunt tasks
 
 `.github/workflow/*` example:
 
+<!-- {% raw %} -->
 ```yaml
       - name: Install moodle-plugin-ci
         run: |
@@ -26,6 +27,7 @@ in your CI workflow file.  These environment variables wont work for Grunt tasks
           IGNORE_PATHS: 'vendor/widget,javascript/min-lib.js'
           IGNORE_NAMES: '*-m.js,bad_lib.php'
 ```
+<!-- {% endraw %} -->
 
 `.travis.yml` example:
 
@@ -50,6 +52,7 @@ variable names are the same as above, but prefixed with `COMMANDNAME_`.
 
 `.github/workflow/*` example:
 
+<!-- {% raw %} -->
 ```yaml
       - name: Install moodle-plugin-ci
         run: |
@@ -61,6 +64,7 @@ variable names are the same as above, but prefixed with `COMMANDNAME_`.
           CODECHECKER_IGNORE_NAMES: '*-m.js,bad_lib.php'
           MUSTACHE_IGNORE_NAMES: 'broken.mustache'
 ```
+<!-- {% endraw %} -->
 
 `.travis.yml` example:
 

docs/UPGRADE-4.0.md

@@ -54,6 +54,7 @@ Despite our recommendations, if you still want to run both versions in the same
 
 For example, for GitHub Actions, it can be setup as follows:
 
+<!-- {% raw %} -->
 ```yaml
 # WARNING - this is only a partial example,
 # several steps were excluded to keep it simple!
@@ -83,12 +84,13 @@ For example, for GitHub Actions, it can be setup as follows:
       ...
       - name: Initialise moodle-plugin-ci
         run: |
-          // Apply here for the configured plugin-ci version.
+          # Apply here for the configured plugin-ci version.
           composer create-project -n --no-dev --prefer-dist moodlehq/moodle-plugin-ci ci ${{ matrix.plugin-ci }}
           echo $(cd ci/bin; pwd) >> $GITHUB_PATH
           echo $(cd ci/vendor/bin; pwd) >> $GITHUB_PATH
           ...
           ...
 ```
+<!-- {% endraw %} -->
 
 The same can be also implemented for Travis CI jobs, adding the `plugin-ci` version as one more element in the jobs matrix `env` element.