fix: remove obsolete headings and update documentation includes for c…

…onsistency

content/common/boitier.inc.rst

@@ -1,3 +1,6 @@
+Préparation du boîtier
+======================
+
 Les boîtiers utilisés pour ce routeur sont de type industriel, fabriqués en ABS avec un retardateur de flamme.
 Ils sont conformes aux normes de sécurité industrielles.
 
@@ -14,7 +17,7 @@ Pour le reste — témoins LED, etc. — ils peuvent être montés n'importe où
 Cependant, ce guide décrira l'implantation la plus classique.
 
 Étapes à réaliser
-~~~~~~~~~~~~~~~~~
+-----------------
 
 * Perçage pour le·s dissipateur·s
   Vous devrez percer 2 trous de **3 mm** de diamètre et un autre de **35 mm** de diamètre.
@@ -35,7 +38,7 @@ Cependant, ce guide décrira l'implantation la plus classique.
   Vous devrez percer un trou de **13 mm** de diamètre.
 
 Outils nécessaires
-~~~~~~~~~~~~~~~~~~
+------------------
 
 * une perceuse à colonne si possible, sinon n'importe quelle perceuse.
 * Foret de **3 mm**
@@ -46,13 +49,13 @@ Outils nécessaires
 
 
 Perçage pour le·s dissipateur·s
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------
 
   Veuillez vous référer à la section :ref:`perçage_du_boitier`.
 
 
 Perçage pour chaque étage de sortie triac
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------------------
 
 Le triac de la carte de sortie doit être plaqué intégralement et fixé sur le dissipateur en façade du boitier.
 L'étage de sortie doit aussi être fixé au fond du boitier à la bonne hauteur pour être en accord avec le point de fixation du triac.
@@ -88,7 +91,7 @@ Pour ajuster la hauteur de la carte de sortie, un plot en plastique de 10 mm de
    Plot
 
 Perçage pour la carte-mère
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------
 
 Une fois les étages de sortie correctement positionnés, vous pouvez placer la carte-mère de manière à ne pas entraver les futurs branchements et autres équipements.
 En utilisant la même méthode, vous pouvez marquer et percer le boîtier aux dimensions appropriées.

content/common/carte-sortie.rst

@@ -1,8 +1,15 @@
 .. _carte-sortie:
 
+Étage de sortie
+===============
+
 | Le triac, également connu sous le nom de triode pour courant alternatif, appartient à la catégorie des thyristors et sert d'interrupteur semi-conducteur. Il a la capacité unique de gérer le courant dans les deux directions, ce qui le rend idéal pour les applications utilisant du courant alternatif (AC).
 | Utilisé pour ajuster la puissance fournie à des dispositifs purement résistifs comme des radiateurs, des chauffe-eau ou des lampes à incandescence, le triac permet de moduler avec précision l'énergie distribuée. Cela offre un contrôle fin sur le niveau de chaleur ou d'éclairage produit.
 
+.. contents:: Sommaire
+   :local:
+   :depth: 1
+
 Principe de Fonctionnement d'une Sortie Triac
 ---------------------------------------------
 
@@ -180,7 +187,7 @@ Triac
 
 De la même manière, ce composant peut être maintenu provisoirement en place en pliant légèrement les agrafes en cuivre pour qu'elles pincent les broches saillantes.
 
-Seuls 1 à 2 mm des pattes du triac devraient dépasser.
+Seuls **1** à **2 mm** des pattes du triac devraient dépasser.
 
 Pour faciliter cette opération et aussi pour protéger le triac des hautes températures, il est conseillé de plaquer le triac contre l'un des dissipateurs non encore monté que vous avez à disposition. Vous pouvez utiliser une pince à linge ou toute autre pince à ressort.
 

content/common/confection-cables.rst

@@ -1,4 +1,4 @@
-(confection-cables)=
+.. _confection-cables:
 
 Confection des câbles
 =====================
@@ -15,7 +15,7 @@ Voici la liste des câbles dont nous aurons besoin :
 * fil de mise à la terre (un par dissipateur)
 
 .. note::
-   Toutes les longueurs préconisées sont basées sur les implantations de la carte-mère décrites :ref:`ici<boitier:Fixations de la carte-mère>`.
+   Toutes les longueurs préconisées sont basées sur les implantations de la carte-mère décrites :ref:`ici<Perçage pour la carte-mère>`.
 
 .. admonition:: Conseil
 

content/common/dissipateur.inc.rst

@@ -1,3 +1,6 @@
+Dissipateur
+===========
+
 Le rôle du dissipateur est d'évacuer la chaleur produite par le courant traversant le triac.
 
 Il s'agit d'une pièce en aluminium dotée d'ailettes, ce qui augmente la surface d'échange avec l'air ambiant.
@@ -9,7 +12,7 @@ Il s'agit d'une pièce en aluminium dotée d'ailettes, ce qui augmente la surfac
 Étant donné la taille du dissipateur, il est recommandé de ne pas connecter plus de 3 kW à chaque sortie.
 
 Perçage du dissipateur
-~~~~~~~~~~~~~~~~~~~~~~
+----------------------
 
 Chaque dissipateur doit être percé de trois trous : deux pour la fixation sur le boîtier et un au milieu pour le triac.
 
@@ -34,7 +37,7 @@ L'utilisation d'une perceuse à colonne est recommandée.
 .. _perçage_du_boitier:
 
 Perçage du boîtier
-~~~~~~~~~~~~~~~~~~
+------------------
 
 Chaque dissipateur sera monté sur les côtés **verticaux** du boîtier. Selon le nombre de sorties, la taille du boîtier variera.
 

content/index.rst

@@ -46,7 +46,7 @@ Bienvenue dans la documentation du Mk2PVRouter !
 .. toctree::
    :hidden:
 
-   introduction.md
+   introduction
 
 .. toctree::
    :maxdepth: 3
@@ -59,23 +59,23 @@ Bienvenue dans la documentation du Mk2PVRouter !
    mono/carte-sortie-relais-mono
    mono/dissipateur-mono
    common/confection-cables
-   mono/assemblage-mono.md
-   mono/etalonnage-mono.md
+   mono/assemblage-mono
+   mono/etalonnage-mono
 
 .. toctree::
    :maxdepth: 3
    :caption: Kit triphasé
    :hidden:
 
    tri/boitier-tri
-   tri/carte-mere-tri.md
+   tri/carte-mere-tri
    tri/carte-sortie-tri
    tri/carte-sortie-relais-tri
    tri/dissipateur-tri
    common/confection-cables
-   tri/assemblage-tri.md
+   tri/assemblage-tri
    tri/test-logiciel-tri
-   tri/etalonnage-tri.md
+   tri/etalonnage-tri
 
 .. toctree::
    :caption: Glossaire

content/introduction.rst

@@ -0,0 +1,93 @@
+.. _introduction:
+
+Introduction
+============
+
+| Cette documentation est applicable à toutes les versions du Mk2PVRouter, qu'elles soient monophasées ou triphasées.
+| La majorité des informations sont pertinentes pour les deux versions.
+| Chaque version a son propre chapitre.
+
+-------------
+
+Contenu du kit
+--------------
+
+Dans le kit, vous trouverez :
+
+* le circuit imprimé ({term}`PCB`) de la carte-mère
+* un ou plusieurs circuits imprimés pour chaque sortie
+* des composants électroniques (résistances, condensateurs, …). |br|
+  Attention, certains sont sensibles à l'électricité statique, il faut donc les manipuler avec soin.
+* un boîtier
+* des câbles
+
+Étapes d'assemblage
+-------------------
+
+L'assemblage complet va nécessiter plusieurs étapes :
+
+* soudure et tests de la carte-mère
+* soudure et tests de la ou les cartes de sortie
+* perçage du boîtier
+* perçage du ou des dissipateurs thermiques
+* montage des circuits soudés dans le boîtier
+* confection des câbles
+* câblage
+* étalonnage
+* programmation finale
+
+Recommandations pour les étapes de soudure
+------------------------------------------
+
+Les composants nécessaires sont très variés. Certains sont passifs (comme les résistances), tandis que d'autres sont actifs (comme l'AtMega328P).
+Tous ces composants sont généralement sensibles à l'électricité statique.
+Il est donc important de les manipuler avec soin et, si possible, de se mettre à la terre pour éviter toute décharge électrostatique.
+
+Certains composants sont polarisés (comme les diodes et certains condensateurs), tandis que d'autres ne le sont pas (comme les résistances et certains condensateurs). Il est donc crucial de faire attention à l'orientation des composants AVANT de les souder. L'orientation est généralement indiquée directement sur la carte mère.
+
+Les composants varient également en taille, allant de quelques millimètres à plusieurs centimètres (dans le cas des transformateurs).
+
+Pour des raisons pratiques, il est recommandé de procéder à la soudure en suivant un ordre précis basé sur la taille des composants.
+
+Ainsi, l'ordre de soudure recommandé est le suivant :
+
+#. Résistances et diodes, et éventuellement les ponts
+#. Supports IC1 et IC2 (et éventuellement IC3, IC4 selon le kit) (ne pas insérer les circuits intégrés dans les supports à ce stade)
+#. Condensateurs non polarisés "orange", oscillateur
+#. Pont·s de diodes
+#. Tous les connecteurs SIL noirs et le connecteur d'affichage, le cas échéant
+#. Condensateurs polarisés (noirs ou bleus)
+#. Le socle pour l'antenne, le cas échéant
+#. Les gros connecteurs "haute tension"
+#. Les porte-fusibles
+#. Les régulateurs de tension
+#. Enfin, les transformateurs
+
+Suivre cette séquence précise permet d'éviter de tordre les pattes des composants ou d'avoir à utiliser de l'adhésif, entre autres.
+
+Matériels nécessaires
+---------------------
+
+* fer à souder
+* fil de soudure
+* pince coupante
+* pince à sertir les cosses ou pince multifonction
+* tournevis cruciforme
+* clé plate ou douille de **5,5**
+* clé plate de **10**
+* clé six pans de **2** et **2,5**
+* une perceuse à colonne si possible, sinon n'importe quelle perceuse.
+* foret métal de **3 mm**
+* foret métal de **4 mm**
+* foret (bois ou métal) de **8 mm**
+* foret (bois ou métal) ou fraise de **20 mm**
+* fraise de **35 mm**
+* colle thermofusible
+* gaine thermorétractable
+* multimètre (au minimum voltmètre et ohmmètre)
+
+Certains matériels sont optionnels (fraise de 35, colle, gaine). Cependant, ils faciliteront certaines étapes et permettront de réaliser un travail plus soigné et bien fini.
+
+.. |br| raw:: html
+
+  <br/>

content/mono/assemblage-mono.md → content/mono/assemblage-mono.rst

@@ -1,8 +1,9 @@
-(assemblage-mono)=
+.. _assemblage-mono:
 
-# Assemblage
+Assemblage
+==========
 
-Après avoir effectué toutes les étapes précédentes, {ref}`Soudure de la carte-mère monophasée <carte-mere-mono>`, {ref}`Préparation du boîtier <boitier>`, {ref}`Perçage du dissipateur <../common/dissipateur:Perçage du dissipateur>`, {ref}`étage·s de sortie <carte-sortie-mono>` et {ref}`Confection des câbles <confection-cables>`, il est temps d'assembler le tout.
+Après avoir effectué toutes les étapes précédentes, :ref:`Soudure de la carte-mère monophasée <carte-mere-mono>`, :ref:`Préparation du boîtier <boitier-mono>`, :ref:`Perçage du dissipateur <../common/dissipateur:Perçage du dissipateur>`, :ref:`étage·s de sortie <carte-sortie-mono>` et :ref:`Confection des câbles <confection-cables>`, il est temps d'assembler le tout.
 
 Il est possible de réaliser l'assemblage dans n'importe quel ordre, cependant, il sera plus pratique de le réaliser comme ceci :
 1. Mise en place des presse-étoupe

content/mono/boitier-mono.rst

@@ -1,6 +1,3 @@
 .. _boitier-mono:
 
-Préparation du boîtier
-----------------------
-
 .. include:: ../common/boitier.inc.rst

content/mono/carte-sortie-mono.rst

@@ -1,10 +1,3 @@
 .. _carte-sortie-mono:
 
-Étage de sortie
-===============
-
-.. contents:: Sommaire
-   :local:
-   :depth: 1
-
 .. include:: ../common/carte-sortie.rst

content/mono/dissipateur-mono.rst

@@ -1,6 +1,3 @@
 .. _dissipateur-mono:
 
-Dissipateur
------------
-
 .. include:: ../common/dissipateur.inc.rst