CI: implement codespell check for custom word mappings

.github/workflows/validation.yml

@@ -17,10 +17,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: codespell-project/actions-codespell@master
+      - uses: actions/setup-python@v4
         with:
-          skip: js,*.svg
-          ignore_words_list: fo,te,als
+          python-version: 3
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install codespell
+      - name: Run codespell
+        run: |
+          codespell \
+            --skip js,*.svg,*.eps,.git \
+            --ignore-words-list fo,te,als \
+            --builtin clear,rare \
+            --dictionary codespell_words.txt \
+            --exclude-file src/CHANGES.md
 
   # Markdown formatting
   remark:

codespell_words.txt

@@ -0,0 +1,4 @@
+sub-directory->subdirectory
+sub-directories->subdirectories
+file name->filename
+folder->directory

src/02-common-principles.md

@@ -86,25 +86,25 @@ instead of specified with an `n/a` value, or included as an empty file
 
 ## Filesystem structure
 
-Data for each subject are placed in sub-directories named "`sub-<label>`",
+Data for each subject are placed in subdirectories named "`sub-<label>`",
 where string "`<label>`" is substituted with the unique identification
 label of each subject.
 Additional information on each participant MAY be provided in a
 [participants file](03-modality-agnostic-files.md#participants-file)
 in the root directory of the dataset.
 
 If data for the subject were acquired across multiple sessions, then within
-the subject directory resides sub-directories named "`ses-<label>`",
+the subject directory resides subdirectories named "`ses-<label>`",
 where string "`<label>`" is substituted with a unique identification
 label for each session.
 In datasets where at least one subject has more than one session, this
-additional sub-directory later SHOULD be added for all subjects in the dataset.
+additional subdirectory later SHOULD be added for all subjects in the dataset.
 Additional information on each session MAY be provided in a
 [sessions file](03-modality-agnostic-files.md#sessions-file)
 within the subject directory.
 
-Within the session sub-directory (or the subject sub-directory if no
-session sub-directories are present) are sub-directories named according to
+Within the session subdirectory (or the subject subdirectory if no
+session subdirectories are present) are subdirectories named according to
 data type as defined above.
 A data type directory SHOULD NOT be defined if there are no files to be placed
 in that directory.

src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md

@@ -167,7 +167,7 @@ whenever possible. See also
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -359,7 +359,7 @@ and a guide for using macros can be found at
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -567,7 +567,7 @@ and a guide for using macros can be found at
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -777,7 +777,7 @@ and can be used for practical guidance when curating a new dataset.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -1009,7 +1009,7 @@ containing that type of fieldmap can be found here:
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -1055,7 +1055,7 @@ second echos are available.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -1091,7 +1091,7 @@ In some cases (for example GE), the scanner software will directly reconstruct a
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -1140,7 +1140,7 @@ AFNI `3dqwarp`.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/04-modality-specific-files/02-magnetoencephalography.md

@@ -18,7 +18,7 @@ the [BIDS examples repository](https://github.com/bids-standard/bids-examples).
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -203,7 +203,7 @@ Date time information MUST be expressed as indicated in [Units](../02-common-pri
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -287,7 +287,7 @@ UADC001 AUDIO V envelope of audio signal presented to participant
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -400,7 +400,7 @@ Photos of the anatomical landmarks and/or head localization coils
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -427,7 +427,7 @@ actual anatomical nasion: `sub-0001_ses-001_acq-NAS_photo.jpg`
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -510,7 +510,7 @@ A guide for using macros can be found at
 
 Example 2:
 
-One recording per session, stored within the session folder.
+One recording per session, stored within the session directory.
 
 <!-- This block generates a file tree.
 A guide for using macros can be found at

src/04-modality-specific-files/03-electroencephalography.md

@@ -14,7 +14,7 @@ and can be used for practical guidance when curating a new dataset.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -183,7 +183,7 @@ Date time information MUST be expressed as indicated in [Units](../02-common-pri
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -258,7 +258,7 @@ UADC001  MISC  n/a    envelope of audio signal        n/a           good    n/a
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -305,7 +305,7 @@ the recording.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -423,7 +423,7 @@ Photos of the anatomical landmarks and/or fiducials.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/04-modality-specific-files/04-intracranial-electroencephalography.md

@@ -14,7 +14,7 @@ and can be used for practical guidance when curating a new dataset.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -203,7 +203,7 @@ Date time information MUST be expressed as indicated in [Units](../02-common-pri
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -276,7 +276,7 @@ Example of free-form text for field `description`:
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -350,7 +350,7 @@ H01   27  -42  -21  5      AdTech
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -430,7 +430,7 @@ Example:
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/04-modality-specific-files/07-behavioral-experiments.md

@@ -2,7 +2,7 @@
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/04-modality-specific-files/09-positron-emission-tomography.md

@@ -62,7 +62,7 @@ In this example, tracer injection coincides with scan start.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -296,7 +296,7 @@ ses-02 59
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/04-modality-specific-files/10-microscopy.md

@@ -20,7 +20,7 @@ Further Microscopy datasets are available:
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -433,7 +433,7 @@ in a sample.
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/appendices/file-collections.md

@@ -24,7 +24,7 @@ included in this appendix:
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
@@ -59,7 +59,7 @@ and a guide for using macros can be found at
 
 <!--
 This block generates a filename templates.
-The inputs for this macro can be found in the folder
+The inputs for this macro can be found in the directory
   src/schema/rules/datatypes
 and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

src/schema/objects/extensions.yaml

@@ -52,7 +52,7 @@ chn:
     A file generated by KRISS MEG systems containing the position of the center of the MEG coils.
 
     Each experimental run on the KRISS system produces a file with extension `.kdf`.
-    Additional files that may be available in the same folder include
+    Additional files that may be available in the same directory include
     the digitized positions of the head points (`\_digitizer.txt`),
     the position of the center of the MEG coils (`.chn`),
     and the event markers (`.trg`).
@@ -70,9 +70,9 @@ dat:
     A fine-calibration file used for Neuromag/Elekta/MEGIN MEG recording hardware.
 CTF:
   value: .ds/
-  display_name: CTF MEG Dataset Folder
+  display_name: CTF MEG Dataset Directory
   description: |
-    A folder for MEG data, typically containing a `.meg4` file for the data and a `.res4` file for the resources.
+    A directory for MEG data, typically containing a `.meg4` file for the data and a `.res4` file for the resources.
 dlabelnii:
   value: .dlabel.nii
   display_name: CIFTI-2 Dense Label File
@@ -132,7 +132,7 @@ kdf:
     A KRISS (file with extension `.kdf`) file.
 
     Each experimental run on the KRISS system produces a file with extension `.kdf`.
-    Additional files that may be available in the same folder include
+    Additional files that may be available in the same directory include
     the digitized positions of the head points (`\_digitizer.txt`),
     the position of the center of the MEG coils (`.chn`),
     and the event markers (`.trg`).
@@ -152,7 +152,7 @@ mefd:
   value: .mefd/
   display_name: Multiscale Electrophysiology File Format Version 3.0
   description: |
-    A folder in the [MEF3](https://osf.io/e3sf9/) format.
+    A directory in the [MEF3](https://osf.io/e3sf9/) format.
 
     Each recording consists of a `.mefd` directory.
 mhd:
@@ -263,7 +263,7 @@ trg:
     A file generated by KRISS MEG systems containing the event markers.
 
     Each experimental run on the KRISS system produces a file with extension `.kdf`.
-    Additional files that may be available in the same folder include
+    Additional files that may be available in the same directory include
     the digitized positions of the head points (`\_digitizer.txt`),
     the position of the center of the MEG coils (`.chn`),
     and the event markers (`.trg`).
@@ -312,7 +312,7 @@ None:
     A file with no extension.
 Directory:
   value: /
-  display_name: Folder
+  display_name: Directory
   description: |
-    A folder with no extension.
+    A directory with no extension.
     Corresponds to BTi/4D data.