tutorials: update FR tutorials#892
Open
musicEnfanthen wants to merge 18 commits into
Open
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the French (FR) tutorial set to match the current English (EN) and Spanish (ES) versions by correcting links, aligning filenames, and reducing duplicated assets.
Changes:
- Sync FR tutorial content/links with EN/ES (updated guideline links, internal tutorial links, and various text/typos).
- Remove duplicated XML/image assets from FR tutorials and reference the EN equivalents instead.
- Rename/repoint tutorial data files (notably 180/181/199) and standardize task markup to use the
tutorialTaskclass.
Reviewed changes
Copilot reviewed 97 out of 119 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| resources/tutorials-FR.md | Fixes GitHub link formatting; still contains the FR “writing tutorials” link that likely needs updating. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials.md | Updates tutorial front matter to use the renamed JSON data file. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials.json | Renames step/end HTML references to the new 199-prefixed filenames. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-01.html | Adds/updates FR step content for the writing-tutorials tutorial. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-02.html | Adds/updates FR step content for the writing-tutorials tutorial. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-03.html | Adjusts wording (e.g., referencing JSON steps). |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-04.html | Adds/updates FR step content for context/xmlFile explanation. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-05.html | Updates validation explanation; introduces a small FR/EN wording/grammar issue around hint. |
| _tutorials-FR/199_writing_tutorials/199_writing_tutorials-end.html | Adds new localized end page for the writing-tutorials tutorial. |
| _tutorials-FR/199_tutorials/tutorials.xml | Removes duplicated XML asset from older FR tutorial folder. |
| _tutorials-FR/199_tutorials/just-a-name.xml | Removes duplicated XML asset from older FR tutorial folder. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei.md | Updates tutorial front matter to use the renamed JSON data file. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei.json | Renames step/end HTML references to the new 181-prefixed filenames. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-01.html | Fixes internal tutorial link targets to use local FR paths. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-02.html | Updates image reference to reuse shared/EN asset path. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-03.html | Adds/updates FR step content for ODD compilation workflow. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-04.html | Adds/updates FR step content explaining ODD file structure. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-05.html | Adds/updates FR step content for @mode semantics and examples. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-06.html | Adds/updates FR step content for @start usage. |
| _tutorials-FR/181_customizing_MEI/181_customizing_mei-end.html | Fixes internal tutorial link to the renamed understanding-odd tutorial. |
| _tutorials-FR/180_understanding-odd/tutorials.xml | Removes duplicated XML asset from older FR tutorial folder. |
| _tutorials-FR/180_understanding-odd/just-a-name.xml | Removes duplicated XML asset from older FR tutorial folder. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd.md | Updates tutorial front matter to use the renamed JSON data file. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd.json | Renames step/end HTML references to the new 180-prefixed filenames. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-01.html | Updates guideline link target to v5 anchor naming. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-02.html | Adds new FR step content (ODD intro/background). |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-03.html | Updates guideline link to v5 and correct anchor casing. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-04.html | Switches image reference to shared/EN asset path. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-05.html | Updates guideline element links to v5 (casing/paths). |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-06.html | Updates guideline links and switches image references to shared/EN asset path. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-07.html | Updates guideline link to v5 element path/casing. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-08.html | Updates multiple guideline links to v5 paths/casing. |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-09.html | Adds new FR step content (macros). |
| _tutorials-FR/180_understanding_odd/180_understanding_odd-end.html | Fixes link to the renamed 181 tutorial and updates the file’s formatting. |
| _tutorials-FR/104_rests/104_rests.json | Repoints XML/prefill references to EN assets and updates step file usage. |
| _tutorials-FR/104_rests/104_rests_end.html | Updates guideline links to v5. |
| _tutorials-FR/104_rests/step-00/104_rests_step-00.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/104_rests/step-00/104_rests_step-00-desc.html | Updates internal links (local tutorial refs), guideline v5 link, and task class name. |
| _tutorials-FR/104_rests/step-01/104_rests_step-01.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/104_rests/step-01/104_rests_step-01-desc.html | Switches image reference to shared/EN asset path and task class name. |
| _tutorials-FR/104_rests/step-02/104_rests_step-02.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/104_rests/step-02/104_rests_step-02-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/104_rests/step-02/104_rests_step-02-desc.html | Updates task class name. |
| _tutorials-FR/104_rests/step-03/104_rests_step-03-desc.html | Switches image reference to shared/EN asset path and task class name. |
| _tutorials-FR/104_rests/step-04/104_rests_step-04.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/104_rests/step-04/104_rests_step-04-desc.html | Updates guideline link to v5, switches image reference to shared/EN asset path, and task class name. |
| _tutorials-FR/103_chords/103_chords.json | Repoints XML/prefill references to EN assets. |
| _tutorials-FR/103_chords/103_chords_end.html | Fixes internal tutorial links (rests + writing-tutorials). |
| _tutorials-FR/103_chords/step-01/103_chords_step-01.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/103_chords/step-01/103_chords_step-01-desc.html | Removes leftover EN text block, updates guideline link to v5, and renames task class. |
| _tutorials-FR/103_chords/step-02/103_chords_step-02.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/103_chords/step-02/103_chords_step-02-desc.html | Renames task class. |
| _tutorials-FR/103_chords/step-03/103_chords_step-03.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/103_chords/step-03/103_chords_step-03-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/103_chords/step-03/103_chords_step-03-desc.html | Switches image reference to shared/EN asset path and renames task class. |
| _tutorials-FR/103_chords/step-04/103_chords_step-04.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/103_chords/step-04/103_chords_step-04-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/103_chords/step-04/103_chords_step-04-desc.html | Switches image reference to shared/EN asset path and renames task class. |
| _tutorials-FR/102_incipit/102_incipit.md | Switches tutorial image reference to shared/EN asset path. |
| _tutorials-FR/102_incipit/102_incipit.json | Repoints XML references to EN assets and updates xml:id expectations for step 12. |
| _tutorials-FR/102_incipit/102_incipit_end.html | Fixes internal writing-tutorials link to renamed page. |
| _tutorials-FR/102_incipit/step-01/102_incipit_step-01.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-01/102_incipit_step-01-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-02/102_incipit_step-02.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-02/102_incipit_step-02-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/102_incipit/step-02/102_incipit_step-02-desc.html | Renames task class and fixes internal structure tutorial link to local path. |
| _tutorials-FR/102_incipit/step-03/102_incipit_step-03.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-03/102_incipit_step-03-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-04/102_incipit_step-04.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-04/102_incipit_step-04-desc.html | Fixes example self-closing tag and renames task class. |
| _tutorials-FR/102_incipit/step-05/102_incipit_step-05.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-05/102_incipit_step-05-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-06/102_incipit_step-06.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-06/102_incipit_step-06-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-07/102_incipit_step-07.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-07/102_incipit_step-07-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-08/102_incipit_step-08.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-08/102_incipit_step-08-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-09/102_incipit_step-09.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-09/102_incipit_step-09-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-10/102_incipit_step-10.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-10/102_incipit_step-10-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-11/102_incipit_step-11.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-11/102_incipit_step-11-desc.html | Renames task class. |
| _tutorials-FR/102_incipit/step-12/102_incipit_step-12.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/102_incipit/step-12/102_incipit_step-12-desc.html | Renames task class and updates suggested xml:id values. |
| _tutorials-FR/101_quickstart/101_quickstart.json | Repoints XML/prefill references to EN assets. |
| _tutorials-FR/101_quickstart/101_quickstart_end.html | Fixes internal links (chords/rests + writing-tutorials). |
| _tutorials-FR/101_quickstart/step-01/101_quickstart_step-01.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/101_quickstart/step-01/101_quickstart_step-01-desc.html | Renames task class. |
| _tutorials-FR/101_quickstart/step-02/101_quickstart_step-02.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/101_quickstart/step-02/101_quickstart_step-02-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/101_quickstart/step-02/101_quickstart_step-02-desc.html | Switches image reference to shared/EN asset path and renames task class. |
| _tutorials-FR/101_quickstart/step-03/101_quickstart_step-03.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/101_quickstart/step-03/101_quickstart_step-03-prefill.xml | Removes duplicated FR prefill XML asset. |
| _tutorials-FR/101_quickstart/step-03/101_quickstart_step-03-desc.html | Switches image reference to shared/EN asset path and renames task class. |
| _tutorials-FR/100_structure/100_structure.json | Repoints XML references to EN assets and fixes broken hint text. |
| _tutorials-FR/100_structure/100_structure_end.html | Updates guideline link to v5 and fixes internal writing-tutorials link. |
| _tutorials-FR/100_structure/step-01/100_structure_step-01.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/100_structure/step-01/100_structure_step-01-desc.html | Renames task class. |
| _tutorials-FR/100_structure/step-02/100_structure_step-02.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/100_structure/step-02/100_structure_step-02-desc.html | Fixes malformed XPath Wikipedia URL and renames task class. |
| _tutorials-FR/100_structure/step-03/100_structure_step-03.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/100_structure/step-03/100_structure_step-03-desc.html | Renames task class. |
| _tutorials-FR/100_structure/step-04/100_structure_step-04.xml | Removes duplicated FR XML asset. |
| _tutorials-FR/100_structure/step-04/100_structure_step-04-desc.html | Renames task class. |
| _tutorials-FR/100_structure/step-00/100_structure_step-00-desc.html | Updates guideline link to v5. |
| _layouts/tutorials-FR.html | Fixes “back to tutorials” link to point to the FR tutorials page instead of EN. |
Comments suppressed due to low confidence (1)
_tutorials-FR/199_writing_tutorials/199_writing_tutorials-05.html:47
- Accord / formulation : ici il faudrait « le
hintcorrespondant » (masculin) ou reformuler en français (« l’indice / l’aide correspondante »). Actuellement « le"hint"correspondante » mélange FR/EN et a un accord incorrect.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
musicEnfanthen
commented
May 25, 2026
| Si vous débutez avec la MEI, nous vous recommandons de commencer par le tutoriel [Quickstart](/tutorials-FR/101-quickstart), qui vous permettra de coder une mélodie simple en MEI. | ||
|
|
||
| Si vous souhaitez rédiger un nouveau tutoriel sur la MEI, nous vous recommandons de commencer par le tutoriel [Rédaction de tutoriels](/tutorials-FR/tutorials), qui vous fournira des informations sur les étapes nécessaires. Consultez également notre liste de tutoriels manquants sur [Github] (https://github.com/music-encoding/music-encoding.github.io/issues/88) avec lesquels vous pourriez contribuer au projet. | ||
| Si vous souhaitez rédiger un nouveau tutoriel sur la MEI, nous vous recommandons de commencer par le tutoriel [Rédaction de tutoriels](/tutorials-FR/199-writing-tutorials), qui vous fournira des informations sur les étapes nécessaires. Consultez également notre liste de tutoriels manquants sur [Github](https://github.com/music-encoding/music-encoding.github.io/issues/88) avec lesquels vous pourriez contribuer au projet. |
Member
Author
There was a problem hiding this comment.
@felix-commits The linked tutorial is called "Rédaction de tutoriels" here, but in the tutorial title and side menu its: "[META : Écrire des tutoriels] Une introduction à l'écriture des tutoriels sur la MEI"
Would it be better to change there to: "[META : Rédaction de tutoriels] Une introduction à la rédaction de tutoriels sur la MEI", or change the ref here to "Ècrire des tutoriels"?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Since #528 was merged a bit quick and premature, this PR updates the FR tutorial to sync it with the the latest EN and ES versions, which includes the following:
While this is mainly technical adjustments, @felix-commits , @daftcloud and @Biblissimacluster6, you may want to have a quick check, too? Please also note that the step 12 in incipit tutorial (102) has undergone quite a rewrite since you started the FR translation: https://github.com/music-encoding/music-encoding.github.io/pull/645/changes#diff-2d31cec26e6635c98e6efb1c95027175cae4c6679c119f9f093b3abeb7dde1a5
Would you want me to provide a basic transcription for this step that you just need to review, or would you prefer to include the changes on your own?