Add link-checker config and fix docs links

Author: oesteban

.github/workflows/linkcheck.yml

@@ -28,8 +28,16 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: 3.12
+      - name: Install MkDocs
+        run: pip install -r requirements.txt
 
-      - uses: tcort/github-action-markdown-link-check@v1
+      - name: Build site
+        run: mkdocs build
+
+      - name: Check links
+        uses: tcort/github-action-markdown-link-check@v1
         with:
           use-quiet-mode: yes
-          # use-verbose-mode: no
+          config-file: .markdown-link-check.json
+          folder-path: site
+          file-extension: .html

.markdown-link-check.json

@@ -0,0 +1,12 @@
+{
+  "ignorePatterns": [
+    {"pattern": "^http://127\\.0\\.0\\.1:8445"},
+    {"pattern": "^http://192\\.168\\.99\\.100:8445"},
+    {"pattern": "biorxiv\\.org"},
+    {"pattern": "doi\\.org"},
+    {"pattern": "toptal\\.com"},
+    {"pattern": "^/"},
+    {"pattern": "^\\.\\./\\.\\./assets/"},
+    {"pattern": "^\\.\\./\\.\\./"}
+  ]
+}

docs/community/CONTRIBUTING.md

@@ -389,7 +389,7 @@ You're awesome. :wave::smiley:
 [link_stemmrolemodels]: https://github.com/KirstieJane/STEMMRoleModels
 [link_zenodo]: https://github.com/nipreps/fmriprep/blob/master/.zenodo.json
 [link_update_script]: https://github.com/nipreps/fmriprep/blob/master/.maint/update_authors.py
-[link_devel]: https://fmriprep.readthedocs.io/en/latest/contributors.html
+[link_devel]: https://fmriprep.org/en/stable/contributors.html
 [link_fmriprep]: http://fmriprep.org
 [link_bidsapps]: https://bids-apps.neuroimaging.io
 [link_mattermost]: https://mattermost.brainhack.org/brainhack/channels/fmriprep

docs/community/members.md

@@ -16,15 +16,15 @@ section.
 
 Developers are members of a wonderful team _driving the project_.
 Names and contacts of all developers are included in the
-[`.maint/developers.json` file](https://github.com/nipreps/fmriprep/blob/master/.maint/developers.json) of each project.
+[`.maint/developers.json` file](https://github.com/nipreps/fmriprep/blob/main/.maint/developers.json) of each project.
 Examples of steering activities that _drive the project_ are: actively participating in the
 follow-up meetings, leading documentation sprints, helping in the design of the tool and definition of the roadmap,
 providing resources (in the broad sense, including funding), code-review, etc.
 
 ### Contributors
 
 Contributors enlisted in the
-[`.maint/contributors.json` file](https://github.com/nipreps/fmriprep/blob/master/.maint/contributors.json) of each project
+[`.maint/contributors.json` file](https://github.com/nipreps/fmriprep/blob/main/.maint/contributors.json) of each project
 actively help or have previously helped the project in a broad sense: writing code, writing documentation,
 benchmarking modules of the tool, proposing new features, helping improve the scientific
 rigor of implementations, giving out support on the different communication
@@ -37,7 +37,7 @@ Before every release, unlisted contributors will be invited again to add their n
 
 Contributors who have contributed at some point to the project but were required or they wished to
 disconnect from the project's updates and to drop-out from publications and other dissemination activities,
-are listed in the [`.maint/former.json` file](https://github.com/nipreps/fmriprep/blob/master/.maint/former.json).
+are listed in the [`.maint/former.json` file](https://github.com/nipreps/fmriprep/blob/main/.maint/former.json).
 
 
-[link_neurostars]: https://neurostars.org
+[link_neurostars]: https://neurostars.org

docs/devs/devenv.md

@@ -154,7 +154,7 @@ INFO    - No authentication
 INFO    - Not serving HTTPS
 ```
 
-Now you can switch to your favorite browser and go to: [127.0.0.1:8445](http://127.0.0.1:8445) (or [192.168.99.100:8445](http://192.168.99.100:8445) for Docker Toolbox).
+Now you can switch to your favorite browser and go to: `http://127.0.0.1:8445` (or `http://192.168.99.100:8445` for Docker Toolbox).
 
 **3. Copy `fmriprep.egg-info` into your `fmriprep/` project directory**
 `fmriprep.egg-info` makes the package executable inside the docker container.

docs/users/educational.md

@@ -18,7 +18,7 @@
 
 ## QC protocols and Standard Operating Procedures
 
-- [SOPs-cookiecutter, a template repository for version-controlled SOPs](https//github.com/nipreps/sops-cookiecutter). The example template is rendered [here](/sops-cookiecutter/)
+- [SOPs-cookiecutter, a template repository for version-controlled SOPs](https://github.com/nipreps/sops-cookiecutter). The example template is rendered [here](/sops-cookiecutter/)
 
 ## Presentation
 - [Educational Talk at OHBM 2023 - Quality Control in fMRI studies with MRIQC and fMRIPrep](../../assets/OHBM2023/QCTalkOHBM23CelineProvins.pdf)