Merge branch 'master' into dependabot/npm_and_yarn/express-4.19.2

Author: tcort

.eslintrc.js

@@ -8,10 +8,14 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+          - macos-latest
         node-version:
           - 18
           - 20
@@ -20,9 +24,9 @@ jobs:
     env:
       NODE_OPTIONS: '--dns-result-order=ipv4first'
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
+      uses: actions/setup-node@v4
       with:
         node-version: ${{ matrix.node-version }}
         cache: npm

.github/workflows/ci.yml

@@ -8,8 +8,8 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - uses: actions/setup-node@v3
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
       with:
         node-version: '18.x'
         registry-url: 'https://registry.npmjs.org'
@@ -35,7 +35,7 @@ jobs:
           | sed -e 's/refs\/tags\///g' \
           | sed -E 's/v?([0-9]+)\.([0-9]+)\.([0-9]+)(-[a-zA-Z]+(\.[0-9]+)?)?/\1.\2.\3\4\,\1.\2\4\,\1\4/g')" >> $GITHUB_ENV
       - name: "Repo: Checkout"
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: "Docker: Build & Publish"
         id: build
         uses: elgohr/Publish-Docker-Github-Action@v5

.github/workflows/release.yml

@@ -50,6 +50,21 @@ To run as a [pre-commit hook](https://pre-commit.com):
       args: [-q]
 ```
 
+## Run in a GitLab pipeline
+
+```yaml
+linkchecker:
+  stage: test
+  image:
+    name: ghcr.io/tcort/markdown-link-check:3.11.2
+    entrypoint: ["/bin/sh", "-c"]
+  script:
+    - find . -name \*.md -print0 | xargs -0 -n1 markdown-link-check
+  rules:
+    - changes:
+      - "**/*.md"
+```
+
 ## Run in other tools
 
 - [Mega-Linter](https://megalinter.io/latest/): Linters aggregator [including markdown-link-check](https://megalinter.io/latest/descriptors/markdown_markdown_link_check/)

README.md

@@ -0,0 +1,26 @@
+import js from "@eslint/js";
+import globals from "globals";
+
+export default [
+    js.configs.recommended,
+    {
+      languageOptions: {
+        globals: {
+          ...globals.node,
+        },
+        parserOptions: {
+          ecmaVersion: "latest",
+          moduleType: "commonjs"
+        },
+      },
+    },
+    {
+      files: ["test/*.js"],
+      languageOptions: {
+        globals: {
+          ...globals.node,
+          ...globals.mocha,
+        },
+      },
+    },
+];

eslint.config.mjs

@@ -43,6 +43,29 @@ function performSpecialReplacements(str, opts) {
     return str;
 }
 
+function extractSections(markdown) {
+    // First remove code blocks.
+    markdown = markdown.replace(/^```[\S\s]+?^```$/mg, '');
+
+    const sectionTitles = markdown.match(/^#+ .*$/gm) || [];
+
+    const sections = sectionTitles.map(section =>
+        section.replace(/^\W+/, '').replace(/\W+$/, '').replace(/[^\w\s-]+/g, '').replace(/\s+/g, '-').toLowerCase()
+    );
+
+    var uniq = {};
+    for (var section of sections) {
+        if (section in uniq) {
+            uniq[section]++;
+            section = section + '-' + uniq[section];
+        }
+        uniq[section] = 0;
+    }
+    const uniqueSections = Object.keys(uniq) ?? [];
+
+    return uniqueSections;
+}
+
 module.exports = function markdownLinkCheck(markdown, opts, callback) {
     if (arguments.length === 2 && typeof opts === 'function') {
         // optional 'opts' not supplied.
@@ -62,6 +85,7 @@ module.exports = function markdownLinkCheck(markdown, opts, callback) {
     }
 
     const links = markdownLinkExtractor(markdown);
+    const sections = extractSections(markdown);
     const linksCollection = _.uniq(links);
     const bar = (opts.showProgressBar) ?
         new ProgressBar('Checking... [:bar] :percent', {
@@ -114,8 +138,24 @@ module.exports = function markdownLinkCheck(markdown, opts, callback) {
             }
         }
 
-        linkCheck(link, opts, function (err, result) {
+        let sectionLink = null;
 
+        if (link.startsWith('#')) {
+            sectionLink = link;
+        }
+        else if ('baseUrl' in opts && link.startsWith(opts.baseUrl)) {
+            if (link.substring(opts.baseUrl.length).match(/^\/*#/)) {
+                sectionLink = link.replace(/^[^#]+/, '');
+            }
+        }
+
+        if (sectionLink) {
+            const result = new LinkCheckResult(opts, sectionLink, sections.includes(sectionLink.substring(1)) ? 200 : 404, undefined);
+            callback(null, result);
+            return;
+        }
+
+        linkCheck(link, opts, function (err, result) {
             if (opts.showProgressBar) {
                 bar.tick();
             }

index.js

@@ -100,7 +100,13 @@ function getInputs() {
                         continue;
                     }
 
-                    baseUrl = 'file://' + path.dirname(resolved);
+                    if (process.platform === 'win32') {
+                        baseUrl = 'file://' + path.dirname(resolved).replace(/\\/g, '/');
+                    }
+                    else {
+                        baseUrl = 'file://' + path.dirname(resolved);
+                    }
+
                     stream = fs.createReadStream(filenameOrUrl);
                 }
 
@@ -124,7 +130,12 @@ function getInputs() {
             input.opts.projectBaseUrl = `file://${program.projectBaseUrl}`;
         } else {
             // set the default projectBaseUrl to the current working directory, so that `{{BASEURL}}` can be resolved to the project root.
-            input.opts.projectBaseUrl = `file://${process.cwd()}`;
+            if (process.platform === 'win32') {
+                input.opts.projectBaseUrl = `file:///${process.cwd().replace(/\\/g, '/')}`;
+            }
+            else {
+                input.opts.projectBaseUrl = `file://${process.cwd()}`;
+            }
         }
     }