Frein + Câble + Etrier

Ajouts proposés par Yannick suite à l'atelier de Chemillé (aout 2023)

.gitignore

@@ -1,3 +1,6 @@
 /outils
 /build
 
+/.metadata/
+/_local/
+*.pyc

Makefile

@@ -18,3 +18,16 @@ help:
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# We clear the html folder before rebuilding, otherwise some things are
+# not updated (like static files)
+html:
+	rm -rf $(BUILDDIR)/html/*
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+html_versions:
+	rm -rf $(BUILDDIR)/html_versions/*
+	sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/html_versions" -D 'version_sourcedir=$${sourcedir}' $(SPHINXOPTS) $(O)
+
+pdf: weasyprint
+	python3 sphinx-tools/make_pdf.py "$(SOURCEDIR)" "$(BUILDDIR)"

README.md

@@ -1,5 +1,131 @@
 Documentation du vhéliotech
 ===========================
 
-/!\ Important : ceci est une version de travail, vous trouverez la documentation officielle du vhéliotech à cette adresse : https://communaute.vhelio.org/d/4-documentation-du-vheliotech-indice-001-mars-2022
+## Consulter la documentation
+
+La documentation générée automatiquement à partir du présent code source est consultable ici : https://documentation.vhelio.org/doc/git.vhelio.org!2Fvhelio/vheliotech-guide-de-montage/main/index.html
+
+Attention, il s'agit d'une version de travail. La version finale sera publiée sur le site web de l'association, ici : https://communaute.vhelio.org/
+
+## Comment contribuer à cette documentation ?
+
+<a href="https://git.vhelio.org/vhelio/freecad-tuto/src/branch/master/Video/contribution_documentation_vhelio.mp4"><img src="https://git.vhelio.org/vhelio/freecad-tuto/media/branch/master/Video/contribution_documentation_vhelio.png" alt="Tutoriel contribuer à la documentation" width="200"/></a>
+
+Reste à faire pour la finalisation de la V1 suite aux retours de l'atelier de Juin :
+
+Se référer au document interne [Retours d'expérience.docx](https://extranet.vhelio.org/s/nJLCSgQZsyGmAn6) pour plus de détail
+
+- [x] Intégrer les retours sur les outils et la méthodo
+- [x] Revoir l'ordre de montage dans la Documentation
+- Monter le chassis, puis mettre en place la direction (la chaine et l’elec gènent si c’est fait avant), mettre le moteur et le fixer définitivement,  puis les freins, puis  faire la transmission et la partie électrique ,avant les tôles, puis fixer les glissières et les sièges
+- Il faut serrer les tubes du cadre avant les tôles et glissières sous les sièges (accessibilités écrous et déformations dues au serrage)
+
+- [x] Revoir la partie transmission
+
+- [ ] Ajout procédure démontage de gallerie
+
+> On a démonter la galerie du vhélio pour le transporter : rajouter peut-être une procédure simple pour expliquer quelles visses ont été enlevées, et préciser que les barres montantes sur la galerie ne doivent pas avoir de silicone dessus pour pouvoir justement démonter la galerie
+
+- [x] Ajout détail sur les dimensions du panneau solaire qui peuvent changer, préciser qu'il faut peut-être rajouter un tube
+
+- [x] Ajout explication montage moteur
+
+- [x] Ajout précisions et retours sur la direction
+
+• Préciser l’alternative au ruban de guidon. Possible de mettre une mousse, il faut utiliser une eau savonneuse pour réussir à les enfiler.
+• Pas de rondelle à trou carré comme précisé dans la doc au 4.2.2. On a compensé avec des rondelles plus grandes permettant le passage du carré dans l’ouverture.
+• Perçage de la pièce de direction à 6 et non 8 (illustration à venir)
+• Le boulon en U fournit ne permet pas de bloquer le guidon, les paroies sont trop lisse et le guidon glisse. On a utilisé une tige filetée de 11 mm que Greg a façonnée à l’étau.
+• Lorsqu’on met les rondelles pour ajuster la hauteur de la colonne de direction il faut les répartir de manière à ce que la tige filetée qui tient le guidon puisse passer en dessous du longeron du haut et ne butte pas lorsqu’on tourne à fond.
+
+
+
+- [x] Ajout précisions et retours sur les freins
+
+• Longueur mesurée sur le vhélio 5 pour les gaines :
+    ◦ avant gauche : 95cm
+    ◦ avant droit : 115cm
+    ◦ arrière : 165cm (pour frein tambour)
+• Le câble de frein arrière est trop court, il faudrait qu’il fasse 185cm ou plus (on peut recouper mais on peut pas rallonger...)
+• La patte du frein tambour doit être fixée au cadre ; voir photo et schéma d’une pièce à ajouter (tube alu) et un perçage supplémentaire à faire.
+• Voir photos pour le placement des gaines et la fixation de la patte du frein tambour.
+
+
+- [x] Ajout détail au sujet des roulements (mettre de la graisse)
+
+• Les roulements utilisés pour la direction s’oxydent très vite. Il y avait des traces de rouille partout alors que le vhélio 5 n’avait encore jamais roulé. Voir si on trouve une autre référence avec un inox de meilleure qualité ?
+• Il faut mettre de la graisse sur les roulements avant de les monter.
+
+- [ ] Ajout détails et correction sur l'électricité
+
+Voir fichier [Retours d'expérience.docx](https://extranet.vhelio.org/s/nJLCSgQZsyGmAn6)
+
+- [ ] Ajout retour chambre à air
+
+- [x] Finalisation étape de montage chassis
+
+- [x] Finalisation étape de montage direction
+
+> Dans la notice d’utilisation, conseiller d’avoir une chambre à air linéaire pour la roue arrière (changement en 10 mn environ et sans démonter la roue arrière). Avec une chambre à air standard et un démontage de la roue (inclus déclipsage de la baque nexus, retrait de la contre-poussée du frein, retrait de la baque de frein…, prévoir plutôt 30 mn.
+
+- [x] Ajout partie sur remplacement bande anti crevaison par chambre à air
+
+> La bande anti crevaison (ROU04) coute très cher (13€). Ce produit a doublé en prix en quelques mois. Une solution économique et je pense aussi pertinente consiste à mettre une vielle chambre à aire en fond de pneu avant de mettre la bonne chambre à air. Cout 0€. Point de vigilance : veiller à ce que la chambre à air de fond de pneu ne fasse pas de plis avant de mettre et gonfler la bonne chambre à air.
+
+- [ ] Avoir une version de la doc par version du vhélio : plusieurs branches git ?
+
+- [ ] Ajouter des étapes de montage pour le moteur .
+
+- [x] Changer la référence de nomenclature pour la roue et le frein a disque dans le guide de montage de la roue (anciennement ROU16 pour la roue et ROU17 pour le frein à tambour)
+
+- [x] Ajouter la nomenclature de l'adapteur center lock ou du frein center lock
+
+- [x] Rajouter des images du pignon shimano en intérieur ou extérieur
+
+- [x] Rajouter un lien vers la doc shimano nexus 8 et vidéo de montage
+
+- [ ] Ajouter les références de nomenclature pour les entretoises de tube et entre le moteur
+
+- [ ] Ajouter référence nomenclature VIS pour moteur
+
+- [x] Après mesure 3D préciser si le pignon arrière doit être monté à l'intérieur ou à l'extérieur
+
+- [x] Revoir la photo du tendeur de chaine et la 3D pour qu'il soit à l'avant
+
+- [x] Ajout étapes assemblage sièges et précision sur le bon côté de l'équerre
+
+- [ ] Ajout étapes assemblage stabilisateur et détails quincaillerie sur stabilisateurs
+
+- [ ] Ajout étapes assemblages glissières
+
+- [x] Ajout étapes assemblage tôles
+
+- [x] Revoir l'étape d'assemblage de la direction pour utiliser des entretoises au lieu de rondelles et statuer sur l'utilisation d'une tige filetée à la place de la vis en U
+
+- [ ] Ajouter des photos (ou 3D) du placement des gaines de frein
+
+- [x] Modifier l'image de nomenclature pour rajouter "TB_E TuBe Entretoise"
+
+## Ajouts proposés par Yannick suite à l'atelier de Chemillé (aout 2023)
+- [ ] Ajouter la nomenclature dans le guide pour avoir les correspondances QUIN...
+- [ ] Améliorer l'explication (ou ajouter une photo) concernant le clip du dérailleur. Montrer qu'il est fendu (ça parait évident après...)
+- [ ] Montage du moteur à documenter (ajouter les photos prises)
+- [ ] Etape 11 de la structure, retirer les protections des CHO50
+- [ ] Montage des étriers de frein à documenter (ajouter les photos prises)
+- [ ] Barre qui tombe au mauvais endroit sous les sièges (je ne sais pas comment corriger...)
+- [ ] Problème d'empatement des roulettes sous les sièges
+- [ ] Roue arrière qui ne rentre pas bien
+- [ ] Plateau 48 dents ? (ou moins ?)
+- [ ] Préciser le modèle de pédale à ne pas prendre
+- [ ] Préciser les problèmes avec le comodo rencontrés
+- [ ] avec les glissières
+- [ ] avec le convertisseur 36/12v
+- [ ] Ajouter le paramétrage de la config moteur (passer en roues 20 pouces au lieu de 26 pouces par défaut).
+
+## Problèmes étapes de montage
+
+- [x] Etape 10 : Manque boulons entre T06 et les deux M01
+- [x] Etape 7 : manque sans doute T14
+- [x] Etape 16 : Les 2 M6x40 en verticale liées à CHO19 sont à placer à l'étape 17
+- [ ] Vue avant/arriere : la largeur est-elle la bonne ?
 

pdftoc-to-latex

@@ -0,0 +1,72 @@
+#!/usr/bin/perl
+
+# Script taken from https://gitlab.com/derobert/random-toys/blob/master/pdf/pdftoc-to-latex
+# Manually adapt for sphinxdoc generated pdf
+use 5.024;
+use strict;
+use warnings qw(all);
+use IPC::Run3;
+use LaTeX::Encode;
+use Encode qw(decode);
+
+my @levels
+	= qw(chapter section subsection subsubsection paragraph subparagraph);
+my @counters;
+
+my ($data_enc, $data);
+run3 ['pdftk', $ARGV[0], 'dump_data_utf8'], undef, \$data_enc;
+$data = decode('UTF-8', $data_enc, Encode::FB_CROAK);
+
+my @latex_bm;
+
+my $bm;
+foreach (split(/\n/, $data)) {
+	/^Bookmark/ or next;
+	if (/^BookmarkBegin$/) {
+		add_latex_bm($bm) if $bm;
+		$bm = {};
+	} elsif (/^BookmarkLevel: (\d+)$/a) {
+		++$counters[$1 - 1];
+		$#counters = $1 - 1;
+		$bm->{number} = join(q{.}, @counters);
+		$bm->{level} = $1 - 1;
+	} elsif (/^BookmarkTitle: (.+)$/) {
+		# In Sphinx title include a utf-8 icon of a link, so remove it
+		my $title = substr($1, 0, -1);
+		$bm->{title} = latex_encode($title);
+	} elsif (/^BookmarkPageNumber: (\d+)$/a) {
+		$bm->{page} = $1;
+	} else {
+		die "Unknown Bookmark tag in $_\n";
+	}
+}
+add_latex_bm($bm) if $bm;
+
+print <<LATEX;
+\\documentclass{report}
+\\title{Guide de montage Vhéliotech v1.0}
+\\renewcommand{\\familydefault}{\\sfdefault}
+\\setcounter{page}{2}
+\\begin{document}
+${ \join('', @latex_bm) }
+\\end{document}
+LATEX
+
+exit 0;
+
+sub add_latex_bm {
+	my $bm     = shift;
+	# Don't extract subtitle with level > 1
+	if ($bm->{level} > 1) {
+		return;
+	}
+	
+	my $level  = $levels[$bm->{level}];
+	my $number = $bm->{number};
+	my $title  = $bm->{title};
+	my $page   = $bm->{page} + 2;
+
+	push @latex_bm, <<LINE;
+\\contentsline {$level}{\\numberline {$number}$title}{$page}%
+LINE
+}

source/010_documentation.md

@@ -0,0 +1,40 @@
+# Documentation
+
+<div class="pdf-only">
+	<p>Le guide de montage (que vous êtes en train de lire) est une édition PDF de la version consultable en ligne sur <a href="https://documentation.vhelio.org">documentation.vhelio.org</a>. Plusieurs autres documents sont disponibles autour du vhéliotech. Vous en trouverez une présentation rapide dans cette section.</p>
+</div>
+
+<div class="html-only">
+	<p>En plus du guide de montage (que vous êtes en train de lire), plusieurs documents sont disponibles autour du vhéliotech. Vous en trouverez une présentation rapide dans cette section.</p>
+</div>
+
+Tous les documents peuvent être téléchargés sur le forum [communaute.vhelio.org](https://communaute.vhelio.org).
+
+## Plans 3D
+
+Les plans 3D sont disponibles sous différents formats. Il s’agit du même contenu à chaque fois, mais utilisable par différents logiciels :
+- STEP, utilisable par la plupart des logiciels de CAO (Conception Assistée par Ordinateur). Vous pouvez les visualiser par exemple avec [Mayo (logiciel libre et gratuit)](https://github.com/fougue/mayo/releases). Un [tutoriel est disponible](https://git.vhelio.org/vhelio/vheliotech-freecad/wiki/Visionnage-des-fichiers-3D-avec-Mayo) sur le site web de l'association.
+- FCStd, pour utilisation avec FreeCAD (logiciel libre et gratuit).
+
+Ces plans sont particulièrement utiles pour observer des points de détail du vhéliotech ou si vous n’arrivez pas à vous représenter certaines parties, puisqu’il est possible de le voir sous tous les angles. Ils permettent également d’exporter des vues 2D ou 3D de l’assemblage ou de chaque pièce, par exemple avec FreeCAD, mais cela sort du périmètre du présent guide.
+
+:::{note}
+Les plans 3D du vhéliotech ont été produits avec le logiciel FreeCAD. C'est donc l'outil à utiliser pour contribuer à faire évoluer les plans. Vous trouverez de la documentation sur comment configurer FreeCAD pour le projet vhéliotech sur [le site de l'association VSPT](https://git.vhelio.org/vhelio/vheliotech-freecad/wiki/Configuration-de-FreeCAD). Nous proposons aussi [quelques tutoriels](https://git.vhelio.org/vhelio/vheliotech-freecad/wiki/Tutoriels-FreeCAD). Par ailleurs, de la documentation générale sur FreeCAD est disponible sur [le site officiel FreeCAD](https://wiki.freecadweb.org/).
+
+Nous avons utilisé [la version "link branch" de FreeCAD](https://github.com/realthunder/FreeCAD/releases/tag/2022.11.27-edge), qui ajoute de nouvelles fonctionnalités et corrige des problèmes qui ne sont pas encore bien gérés dans la version standard de FreeCAD. L'utilisation de la version standard de FreeCAD 0.20 ne fonctionnera que pour de la consultation. Pour effectuer des modifications, il faudra la version "link branch".
+:::
+
+## Liste des pièces et fournisseurs
+
+La liste des pièces et fournisseurs rassemble des informations sur toutes les pièces du vhéliotech : le code de la pièce, son nom, des liens vers des fournisseurs, etc. Les codes indiqués dans le présent guide de montage font référence à ce document.
+
+<div class="avoid-break"></div>
+
+```{image} img/codification_nomenclature.jpg
+:alt: Codification nomenclature
+:align: center
+```
+
+## Schéma électrique
+
+Le schéma électrique donne une vue d’ensemble de l’installation électrique, et sert de référence pour tous les branchements. Une procédure d’installation est également proposée dans le présent guide.

source/020_moyens_necessaires.md

@@ -1,29 +1,47 @@
 # Moyens nécessaires
+
 ## Espace nécessaire
+
 Pour monter votre vhéliotech dans de bonnes conditions, nous vous suggérons de disposer d’un espace minimum qui vous permettra d’évoluer confortablement autour du vhéliotech en cours de montage et de pouvoir coucher le châssis sur l’un de ses côtés.
-Prévoyez une pièce abritée d’une dimension minimale de 2,00 mètres de large, 3,50 mètres de longueur et 2,30 m de hauteur sous plafond. Pour sortir le vhéliotech une fois monté, il faut une porte de 86 cm de passage utile.
+Prévoyez une pièce abritée d’une dimension minimale de 3,00 mètres de large, 3,50 mètres de longueur et 2,30 m de hauteur sous plafond. Pour sortir le vhéliotech une fois monté, il faut une porte de 90 cm de passage utile.
+
 ## Outillage et protections individuelles
+
 On peut distinguer un outillage minimum sans lequel il n’est pas possible de monter son vhéliotech et un outillage recommandé qui vous facilitera le montage et vous fera gagner du temps.
-Le guide de montage part du principe que vous avez acheté les tubes du châssis prédécoupés et prépercés et que vous avez acheté des éléments préassemblés.
+
+Le guide de montage part du principe que vous avez acheté les tubes du châssis (les profilés à section carrée en aluminium) prédécoupés et prépercés au laser, et que vous avez acheté des pièces prêtes à assembler (fabriquées par un chaudronnier).
 Si ce n’est pas le cas, et que vous souhaitez fabriquer ces pièces vous-même, prévoyez tout l’outillage complémentaire indiqué plus bas. Nous avons prévu de fournir les plans de fabrication des pièces, mais ce document n’étant pas encore prêt, il faudra vous référer aux plans 3D pour prendre les mesures ou exporter des vues cotées (ce qui nécessitera quelques compétences en CAO).
-Enfin, nous vous recommandons de prévoir les protections individuelles adaptées à l’outillage que vous allez utiliser.
+Enfin, notez que la fabrication de certaines pièces nécessite un outillage plus lourd (poste à souder, plieuse, CNC laser, etc.) ; le plus simple sera de commander ces pièces à une entreprise de chaudronnerie.
+Les ateliers ont montré un véritable intérêt à prendre les tubes découpés au laser (précision, chantier propre, moins d'outillage, pas de risques, agrément).
+
 ### Outillage minimum pour monter son vhélio
-- un jeu de clés plates (de 7 à 17)
-- plusieurs clés de 10 (plate et à pipe)
+
+ - un jeu de clés plates (de 7 à 17)
+ - une clé de 10 à pipe
+ - une clé de 22
+ - une clé à molette pour le serrage des contre-écrous
  - un jeu de clés 6 pans
- - un feutre adapté au métal ou un crayon de bois
  - un mètre ruban (3 m minimum)
  - un gros cutter
- - une cartouche de silicone (pour fixer le panneau solaire sur la structure métallique)
- - des colliers de serrage (pour attacher les câbles)
+ - une cartouche de silicone (mastic ou mastic-colle) pour fixer le panneau solaire et pour l'étanchéité des connecteurs de batterie
  - un dérive chaîne de vélo
  - une pompe à vélo (avec manomètre)
+ - une lime à métaux
+ - Pour serrer l'adaptateur center lock (frein à disque arrière)
+   - un clé pour boitier de pédalier (recommendé) appellée aussi "clé à roulement externes TL-FC32"
+   - ou une pince multiprise
+
 ### Outillage recommandé pour gagner du temps
+
+ - des tréteaux pour surélever la structure et travailler plus confortablement
  - une visseuse avec une douille de 10
- - une clé à molette
  - une clé à cliquet
-### Outillage complémentaire pour tout faire soi-même
- - une scie à métaux manuelle 
+ - une clé à œil à cliquet de 10, très pratique
+ - dans le cas d'un travail à plusieurs personnes, prévoir au moins autant de clés de 10 que de personnes
+
+### Outillage complémentaire (fabrication de pièces)
+
+ - un voltmètre pour faire quelques tests sur la partie électrique
  - une scie à onglet avec disque adapté à la découpe de l’aluminium
  - une perceuse colonne (350W mini) avec foret métal de diamètre 6,5 en cobalt et de l’huile de coupe (perçage d’acier inox)
  - un ébavureur manuel
@@ -35,20 +53,30 @@ Enfin, nous vous recommandons de prévoir les protections individuelles adaptée
  - des serre-joints
  - du ruban isolant d’électricien
  - une pince à sertir les cosses électriques
+ - un pointeau et un marteau pour marquer les trous à percer sur l'aluminium et l'inox
+ - pour la rallonge des câbles : 
+   - un fer à souder
+   - de l'étain
+
 ### Protections individuelles recommandées
+
 Ne négligez pas cet aspect, la découpe du métal et le bruit sont dangereux. Prenez le temps de vous protéger à chaque instant avec notamment : des lunettes de protection, des gants, un casque antibruit, des vêtements et des chaussures adaptées. Attachez vos cheveux s’ils sont longs, ne portez pas de vêtements amples.
+
 ## Temps de montage
-Comptez un environ 5 jours (35 heures) – Après les premiers montages, ce temps sera ré-évalué précisément.
-Le temps de montage est variable selon chaque personne, une différence importante pourra être observée entre un niveau débutant ou bricoleur chevronné par exemple. N’ayez cependant pas d’inquiétude, le vhéliotech est très simple à monter et en avançant sereinement, vous y arriverez :-)
+
+Comptez environ 5 jours (35 heures).
+Le temps de montage est variable selon chaque personne, une différence importante pourra être observée entre un niveau débutant ou bricoleur chevronné par exemple. N’ayez cependant pas d’inquiétude, le vhéliotech est simple à monter et en avançant sereinement, vous y arriverez :-)
+
 Pour optimiser votre temps de montage, voici plusieurs recommandations :
+ - approvisionnez l'ensemble des pièces détachées (et les pointer) avant de débuter le montage
  - dédiez votre espace de montage au vhéliotech afin de ne pas avoir à déplacer le vhéliotech avant de l’avoir terminé
  - organisez et rangez votre établi et votre outillage après chaque séance de montage
-      pointez la présence de toutes les pièces détachées/outils avant de commencer
  - préparez les supports documentaires avant de vous lancer
- - prévoyez un endroit pour un ordinateur afin de consulter différents éléments de documentation pendant le montage
+ - prévoyez un endroit pour un ordinateur, si possible avec un accès internet, afin de consulter différents éléments de documentation pendant le montage
  - montez un vhéliotech avec un·e ami·e (c’est plus agréable et cela favorise les échanges de compétences)
- - cherchez sur la communauté vhélio d’autres personnes à proximité de chez vous afin de mutualiser l’outillage et de vous entraider.
-Lorsque vous aurez terminé votre montage, n’hésitez pas à envoyer un message à l’association pour nous indiquer le temps que vous y avez passé et vos éventuelles remarques.
+ - cherchez sur la communauté vhélio d’autres personnes à proximité de chez vous afin de mutualiser l’outillage et de vous entraider (le forum a notamment été créé pour faciliter le regroupement géographique des personnes)
+
+Lorsque vous aurez terminé votre montage, n’hésitez pas à envoyer un message à l’association (sur [communaute.vhelio.org](https://communaute.vhelio.org/)) pour nous indiquer le temps que vous y avez passé et vos éventuelles remarques.
 
 ## Compétences nécessaires
 

source/030_plan_general.md

@@ -0,0 +1,42 @@
+# Plan général
+
+```{image} img/vues-generales/01.svg
+:alt: Côté droit
+:align: center
+```
+
+<p>&nbsp;</p>
+
+```{image} img/vues-generales/02.svg
+:alt: Côté gauche
+:align: center
+```
+
+```{image} img/vues-generales/03.svg
+:alt: Avant/arrière
+:align: center
+```
+
+<p>&nbsp;</p>
+
+```{image} img/vues-generales/04.svg
+:alt: Dessus/dessous
+:align: center
+```
+
+```{image} img/vues-generales/05.svg
+:alt: Coupe longitudinale
+:align: center
+```
+
+<p>&nbsp;</p>
+
+```{image} img/vues-generales/06.svg
+:alt: Coupes transversales
+:align: center
+```
+
+```{image} img/vues-generales/07.svg
+:alt: Coupe en altimetrie
+:align: center
+```

source/040_assemblage_chassis.md

@@ -0,0 +1,276 @@
+# Assemblage du châssis
+
+## Préparation de la quincaillerie
+
+Nous vous recommandons de préparer la quincaillerie avec rigueur. Des boîtes en carton (QIN22) permettent de préparer des ensembles de toutes les pièces de quincaillerie en notant la référence avec un marqueur sur la boîte. Ainsi vous gagnerez des minutes (qui cumulées peuvent représenter des heures).
+
+S'il vous reste de la quincaillerie après le montage, vous pourrez la proposer aux autres membres de la communauté sur le forum.
+
+## Sérrage des écrous-freins et utilisation des rondelles
+
+Nous vous rappelons que les écrous-freins (type « nylstop ») ne sont pas prévus pour être démontés et remontés. Après environ trois montage/démontages, il perd sa fonction "frein", dans ce cas, il est conseillé de le remplacer par un neuf.
+
+Tous les écrous et vis doivent être serrés suffisamment fort, mais prenez garde aux tubes carrés en aluminium qui vont s’écraser si vous serrez trop fort. Vérifiez que votre serrage ne provoque pas de déformation visible. Selon nos essais, il faut approcher l’écrou jusqu’au contact, puis faire encore un demi-tour. Nous conseillons de faire l'exercice de serrage maximum (idem Fig. 1) pour sentir le couple maximum. Prendre une chute de tube. A noter que le tube TB_T17 (longueur 2.06m) est un tube supplémentaire qui peut être utilisé pour cet exercice.
+
+:::{note}
+**Conseil d'assemblage** : nous vous conseillons d'assembler dans un premier temps le châssis avec des écrou-freins sans les serrer totalement, filet pris à la main (sans outil) pour garder le jeu nécessaire au positionnement des pièces. De cette manière vous pourrez monter et démonter la structure facilement en cas d'erreur. Ne serrez les écrou-freins, avec des outils, qu'une fois toutes les pièces du châssis bien positionnées.
+:::
+
+:::{important}
+Finalisez le serrage des boulons du cadre avant la fixation des tôles et des glissières.
+:::
+
+:::{figure-md}
+
+<img src="img/tube_deforme.jpg" alt="Photo de tube deformé" width="200px">
+
+Fig. 1 - Exemple de tube déformé par un serrage excessif
+:::
+
+Certains tubes qui doivent absorber des efforts plus importants doivent être munis d’entretoises (tel qu’indiqué dans le plan). Vous pourrez alors serrer plus fort.
+
+Les quantités indiquées dans la nomenclature pour la quincaillerie sont parfois légèrement en excès de ce qui est réellement utile. Ne soyez donc pas surpris s’il vous reste une certaine quantité de visserie à la fin du montage !
+
+Le cadre est constitué de tube aluminium 25 mm x 25 mm x 2 mm d’épaisseur. Il faut compter environ 46 mètres de tubes pour la configuration intégrale. Cependant, nous vous recommandons d'acheter un lot de tubes prédécoupés et percés au laser, ce qui vous évitera un travail long, relativement rébarbatif, et moins précis.
+
+Pour simplifier l’assemblage, des standards d’assemblage ont été définis :
+
+:::{note}
+**Règle d'or** au sujet des rondelles : il faut mettre des rondelles au niveau de la tête de vis et/ou de l'écrou s'ils sont en contact direct avec un tube d'aluminium. Pas besoin de rondelles sur inox ou sur les tôles. Les rondelles ne sont donc pas indiquées dans les infobulles des étapes de montage, à vous de les positionner en fonction des matériaux.
+:::
+
+### Assemblage d’un tube et d’une tôle
+
+- Vis M6 45 mm (QIN45)
+- Rondelle M6 (QIN12) côté tube ; inutile de l'autre côté s'il y a déjà une tôle inox.
+
+```{image} img/assemblage_tube_tole.jpg
+:alt: Assemblage tube tôle
+:width: 200px
+```
+
+### Assemblage de 2 tubes
+
+- Vis M6 60 mm (QIN60)
+- Rondelle M6 (QIN12) pour la tête de vis et l'écrou M6 lorsqu'ils sont contre un tube aluminium.
+
+```{image} img/assemblage_2_tubes.jpg
+:alt: Assemblage 2 tubes
+:width: 200px
+```
+
+### Assemblage de 3 tubes
+
+<div class="avoid-break-next-block"></div>
+
+- Vis M6 90 mm (QIN90)
+- Rondelle M6 (QIN12) pour la tête de vis et l'écrou M6 lorsqu'ils sont contre un tube aluminium.
+
+```{image} img/assemblage_3_tubes.jpg
+:alt: Assemblage 3 tubes
+:width: 200px
+```
+
+## Assemblage de la structure en tubes
+
+### Étape 1
+
+<img class="resized" src="img/assemblage/dessins_assemblage_tubes-Etape001.svg" alt="Vue de l'étape 1">
+
+<div class="avoid-break"></div>
+
+:::{note}
+L00 est un tube non symétrique. Deux perçages sont désaxés : ces deux perçages sont sur la moitié supérieure.
+:::
+
+### Étape 2
+
+![Vue de l'étape 2](img/assemblage/dessins_assemblage_tubes-Etape002.svg)
+
+### Étape 3
+
+À partir de cette étape, vous pouvez surélever le châssis en le posant sur des caisses ou tréteaux, pour travailler plus confortablement.
+
+<div class="avoid-break"></div>
+
+<img src="img/assemblage/dessins_assemblage_tubes-Etape003.svg" alt="Vue de l'étape 3">
+
+### Étape 4
+
+L'équerre CHO17 est plaqué contre les tubes M02, il y a deux rondelles CHO51 entre CHO17 et L00 et L01. 
+Vous pouvez scotcher (scotch papier) les rondelles sur CHO17 pour plus de faciliter de montage.
+
+<div class="avoid-break"></div>
+
+:::{note}
+Les chanfreins des tubes M02 sont à placer à l'extérieur, ils servent à éviter d'abîmer le textile qui viendra dessus.
+:::
+
+<div class="avoid-break"></div>
+
+<img src="img/assemblage/dessins_assemblage_tubes-Etape004.svg" alt="Vue de l'étape 4">
+
+### Étape 5
+
+Les chanfreins des tubes M03 et M04 sont à placer à l'extérieur, ils servent à éviter d'abîmer le textile qui viendra dessus.
+
+<div class="avoid-break"></div>
+
+<img class="resized" src="img/assemblage/dessins_assemblage_tubes-Etape005.svg" alt="Vue de l'étape 5">
+
+### Étape 6
+
+![Vue de l'étape 6](img/assemblage/dessins_assemblage_tubes-Etape006.svg)
+
+### Étape 7
+
+![Vue de l'étape 7](img/assemblage/dessins_assemblage_tubes-Etape007.svg)
+
+### Étape 8
+
+![Vue de l'étape 8](img/assemblage/dessins_assemblage_tubes-Etape008.svg)
+
+### Étape 9
+
+![Vue de l'étape 9](img/assemblage/dessins_assemblage_tubes-Etape009.svg)
+
+### Étape 10
+
+![Vue de l'étape 10](img/assemblage/dessins_assemblage_tubes-Etape010.svg)
+
+### Étape 11
+
+![Vue de l'étape 11](img/assemblage/dessins_assemblage_tubes-Etape011.svg)
+
+### Étape 12
+
+![Vue de l'étape 12](img/assemblage/dessins_assemblage_tubes-Etape012.svg)
+
+### Étape 13
+
+![Vue de l'étape 13](img/assemblage/dessins_assemblage_tubes-Etape013.svg)
+
+### Étape 14
+
+:::{note}
+Il sera nécessaire de démonter les quatres boulons horizontaux M6x40 au moment de la fixation des gardes boues avant.
+:::
+
+<div class="avoid-break"></div>
+
+<img class="resized" src="img/assemblage/dessins_assemblage_tubes-Etape014.svg" alt="Vue de l'étape 14">
+
+
+### Étape 15
+
+![Vue de l'étape 15](img/assemblage/dessins_assemblage_tubes-Etape015.svg)
+
+### Étape 16
+
+:::{note}
+Il sera nécessaire de démonter les quatres boulons M6x60 (fixé sur L09) au moment de la fixation des gardes boues avant.
+:::
+
+<div class="avoid-break"></div>
+
+<img class="resized" src="img/assemblage/dessins_assemblage_tubes-Etape016.svg" alt="Vue de l'étape 16">
+
+### Étape 17
+
+Si vous aviez surélevé le châssis, vous pouvez maintenant le redescendre au niveau du sol pour faciliter l’installation du toit.
+
+<div class="avoid-break"></div>
+
+L'équerre CHO05 a un côté arrondi et un côté droit.
+Le côté arrondi suit le cintrage de CHO35. Le côté droit est en bas, contre L09. 
+
+<div class="avoid-break"></div>
+
+<img src="img/assemblage/dessins_assemblage_tubes-Etape017.svg" alt="Vue de l'étape 17">
+
+### Étape 18
+
+<img src="img/assemblage/dessins_assemblage_tubes-Etape018.svg" alt="Vue de l'étape 18">
+
+### Étape 19
+
+![Vue de l'étape 19](img/assemblage/dessins_assemblage_tubes-Etape019.svg)
+
+### Étape 20
+
+![Vue de l'étape 20](img/assemblage/dessins_assemblage_tubes-Etape020.svg)
+
+### Étape 21
+
+![Vue de l'étape 21](img/assemblage/dessins_assemblage_tubes-Etape021.svg)
+
+### Étape 22
+
+![Vue de l'étape 22](img/assemblage/dessins_assemblage_tubes-Etape022.svg)
+
+<div class="avoid-break"></div>
+
+:::{note}
+L07 est un tube non symétrique. Des perçages sont désaxés : il faut les placer vers l'intérieur.
+:::
+
+### Étape 23
+
+![Vue de l'étape 22](img/assemblage/dessins_assemblage_tubes-Etape023.svg)
+
+:::{note}
+Le tube R03 n'est pas présent pour les configurations basique et motorisée.
+:::
+
+## Montage de la direction
+
+<div class="avoid-break"></div>
+
+Certains tubes sont masqués pour une meilleure lisibilité
+
+<div class="avoid-break"></div>
+
+### Fixer CHO45 et T16
+
+<div class="avoid-break"></div>
+
+![Etape 1 assemblage direction](img/direction/Etape002_Page.svg)
+
+### Placer CHO44 sur son axe de rotation
+
+Utilisez une entretoise carrée E16 directement sous la plaque CHO45, puis un roulement QIN53 au-dessus de la potence CHO44. Le deuxième roulement se place sous la potence. Insérez également une rondelle QIN36, ce qui devrait amener exactement à la bonne distance, juste au-dessus du tube T16. Ajouter une nouvelle rondelle QIN36 sous le tube T16, et terminez l'assemblage avec un écrou QIN34 et un contre-écrou QIN37. Ce montage écrou/contre-écrou, incluant également un écrou frein, permet d'éviter un desserrement avec les vibrations, sans pour autant serrer excessivement les roulements. Commencez par serrer le premier écrou, mais pas trop fort pour ne pas gêner la rotation de la potence. Maintenez ensuite cet écrou avec une clé plate, et serrez fermement le second écrou contre lui avec une seconde clé.
+
+Finalement, fixez les plaques CHO46 de part et d'autre de la potence.
+
+:::{important}
+Les roulements à bille ont un sens.  La gorge dans laquelle roulent les billes doit être sur la face supérieure pour ne pas que de l'eau stagne dedans.
+Veillez à bien graisser les roulements avant de les mettre en place. Cela leur évitera une oxydation prématurée et éloignera la poussière du cœur du roulement.
+:::
+
+<img src="img/direction/rlt_correct.jpg" alt="Photo du roulement sens correct" width="200px"> Sens correct
+
+<img src="img/direction/rlt_incorrect.jpg" alt="Photo du roulement sens incorrect" width="200px"> Sens inversé
+
+![Etape 2 assemblage direction](img/direction/Etape003_Page.svg)
+
+### Placez les deux CHO47 sur leurs axes de rotation
+
+![Etape 3 assemblage direction](img/direction/Etape004_Page.svg)
+
+Utiliser 4 roulements QIN53 en tout, directement au-dessus et au-dessous des CHO47. Placez des entretoises E21 dans les traverses T11, T12 et T13 afin d’éviter qu’elles ne s’écrasent lors du serrage. Placer également une rondelle QIN36 avant de visser le premier écrou (QIN34). Celui-ci doit être serré suffisamment fort pour maintenir CHO47 dans son plan de rotation malgré les diverses forces qui s'exerceront sur les roues. Il ne faut toutefois pas bloquer les roulements. Ajouter finalement le contre-écrou QIN37 et le serrer fermement contre le premier écrou.
+
+Finalement, montez les biellettes T18. Commencez par les fixer entre les plaques CHO46, en insérant des rondelles nylon QIN41 pour réduire les frottements entres les biellettes et les plaques. Utilisez des vis à filetage partiel QIN43, ce qui permet d'avoir un axe lisse pour le frottement contre les biellettes. Terminez le montage avec un écrou QIN44 qui devra être à peine serré afin d'éliminer le jeu mais sans causer de frottement excessif, puis ajouter un contre-écrou QIN29 qui lui devra être serré fermement contre le premier écrou.
+
+Enfin, fixez les biellettes sur les bras de roue CHO47. Là aussi, utilisez une vis à filetage partiel pour obtenir un axe lisse. Le montage proposé permet de bloquer cette vis en rotation par rapport à la biellette, afin que tous les frottements se fassent uniquement entre CHO47 et la vis sur sa partie lisse. Commencez par insérer la vis QIN39 et ses deux rondelles nylon QIN41 à travers CHO47. Placez ensuite un écrou QIN44 à l'intérieur de la biellette, maintenez le en bas avec un doigt, et enfilez l'ensemble sur la vis, en tournant cette dernière pour la visser dans l'écrou. Tout en continuant à maintenir l'écrou en bas, vissez jusqu'à amener la biellette et sa rondelle au contact de CHO47. À partir de là, il n'y a plus besoin de maintenir cet écrou. En revanche, maintenez la tête de vis avec une clé, afin qu'elle ne tourne pas, et vissez le second écrou (QIN29). Si vous avez correctement suivi les étapes, la biellette T18 est également bloquée en rotation puisqu'elle est déjà assemblée entre les plaques CHO46, et comme vous empêchez également la vis de tourner en maintenant sa tête, l'écrou placé dans la biellette ne peut pas tourner et il n'y a pas besoin de le maintenir. Il est alors possible de serrer l'écrou du bas fermement afin de terminer le montage. Si après serrage il y a trop de jeu, ou au contraire que les pièces ne tournent pas librement, il faudra peut-être recommencer l'opération après avoir ajusté le vissage du premier écrou pour obtenir le bon réglage.
+
+:::{note}
+
+La structure ne doit pas être serrée à cette étape. Si c'est le cas, il est très difficile d'assembler la vis QIN33 à travers les trois tubes T11, T12 et T13. 
+
+:::
+
+### Fixer le guidon CHO04
+
+![Etape 4 assemblage direction](img/direction/Etape005_Page.svg)
+
+Utiliser les vis en U QIN26. L’inclinaison du guidon sera à ajuster après le placement du siège pour une position de conduite confortable (plus ou moins penché vers l’avant selon la taille du conducteur). Il faudra alors serrer fermement les 4 écrous pour bloquer son inclinaison.

source/050_montage_pieces_cycles.md

@@ -0,0 +1,463 @@
+# Montage des pièces cycle
+
+Cette section relève principalement de connaissances généralistes sur les vélos. De nombreux tutoriels existent sur internet, nous vous proposons quelques liens pour certaines étapes. Certains constructeurs de pièces vélo proposent aussi des instructions détaillées destinées aux assembleurs de vélos.
+
+L’installation de la plupart des pièces sera plus aisée en posant le châssis sur des caisses ou des parpaings, afin que les roues ne touchent pas le sol une fois fixées. Il est également possible de basculer le vhéliotech sur un côté, par exemple pour le montage de la roue arrière.
+
+Veillez à adopter une position ergonomique pour le montage et l’entretien des pièces cycles : basculez le Vhélio sur un côté pour accéder à la roue avant du côté opposé, ou sur l’arrière pour accéder à l’ensemble des trois roues. Pour travailler sur la transmission (dérailleur, chaîne, tendeur de chaîne) il est conseillé de garder le vhélio horizontal mais en surélevant la roue arrière, pour garder le sens de gravité qui a un impact sur le comportement de la chaîne.
+
+
+:::{note}
+Nous vous conseillons de suivre l'ordre d'assemblage tel qu'il est proposé ici. Il a été élaboré suite à plusieurs ateliers de montage et vous évitera quelques difficultés.
+:::
+
+## Ensemble roue arrière, frein, et commande du moyeu
+
+Un élément essentiel du vhéliotech est l’ensemble roue arrière avec le moyeu à vitesses intégrées.
+
+Il s’agit d’un moyeu à 8 vitesses Shimano Nexus 8, monté sur roue 20 pouces (ROU16) avec adaptateur (ROU17) et frein à disque (FRN03).
+
+Nous proposons la solution avec frein à disque, car nos essais avec le frein à tambour n’ont pas été concluants (le rollerbrake manque de puissance de freinage pour le vhéliotech)
+
+:::{note}
+Initialement nous avons retenu et testé deux options différentes, mais finalement nous n’en avons retenu qu’un : le shimano Nexus 8. L’autre option, le Enviolo CA 380 était plus cher et avait un rendement bien moins bon (absence d’information du fabricant sur le rendement). D’autres solutions comme le Shimano Alfine 11 sont envisageables mais nous ne les avons pas testées. Lorsqu’un moyeu à vitesses intégrées (compatible avec les charges lourdes/moteurs et aura un bon rendement) existera dans le commerce, nous l'adopterons (après essais en situation réelles).
+:::
+
+  <img src="img/roue_nexus_8.jpg" alt="Photo de la roue Nexus 8" width="200px">
+  <img src="img/moyeu_nexus_8_center_lock.jpg" alt="Moyeu Nexus 8 avec support center lock" width="200px">
+  <img src="img/adaptateur_center_lock_6_trous.jpg" alt="Adaptateur center lock <=> 6 trous" width="200px">
+
+### Intérêts
+- Produit avec un très bon rapport qualité/prix
+- Bonne efficacité
+- Nos tests ont permis de constater la solidité de la jante et du rayonnage
+### Contraintes
+- Réglage à réaliser avec soin pour éviter les craquements
+- Moyeu qui peut s’user prématurément si utilisé avec moteur et tirant des charges lourdes (phénomène atténué par roue de petit diamètre pour le Vhélio). Meilleur compromis trouvé à ce jour dans les produits du commerce, voir note en début de chapitre.
+- A l’usage, comme une voiture, il faut démarrer sur une petite vitesse et monter les rapports ensuite.
+- Après un certain temps d’utilisation (habituellement, 50-100 km de course) les roues peuvent se décentrer et se voiler. Il est nécessaire d'alors resserrer les rayons. Voir section "Test et Vérification".
+
+### Montage du disque
+
+Remarque : Lors de la manipulation du disque et des plaquettes, assurez-vous de ne pas les salir avec de la matière grasse (graisse, huile, mains sales, etc.).
+
+#### Étape 1
+
+Prépositionnez le disque de frein sur l’adaptateur et sur la roue en veillant au sens de rotation indiqué sur le disque.
+
+#### Étape 2
+
+Monter le disque (FRN03) sur l’adaptateur centerlock (ROU17) avec les vis fournies avec l’adaptateur centerlock (têtes plates) (voir [tutoriel d'installation d'un disque 6 vis classique](https://www.youtube.com/watch?v=sYLZjIjCx28))
+Serrer les vis dans l’ordre suivant : la 1re vis, puis la vis opposée (pas celles à côté) ; procéder en étoile et pas en cercle.
+
+|Vis de disque de frein|Serrage avec une clé dynanométrique|
+|-----------|------------|
+|<img src="img/vis_disque.jpg" alt="Photo de la vis pour le disque de frein." width="300px">|<img src="img/disque-frein-cle-dynanometrique.png" alt="Photo du serrage du disque de frein avec une clé dynanométrique." width="300px">|
+
+#### Étape 3
+
+Poser la rondelle fournie avec l’adaptateur centerlock
+
+<div class="avoid-break"></div>
+
+```{image} img/center_lock_disque.jpg
+:alt: Photo de l'adaptateur center lock mis sur le disque
+:width: 200px
+```
+
+#### Étape 4
+
+Emboiter l’adaptateur sur le disque et poser l’écrou fourni avec l’adaptateur centerlock et serrer l’écrou avec une clé pour boitier de pédalier (recommendé) ou une pince multiprise.
+
+|Photo avant de mettre l'écrou shimano|Photo avec l'écrou shimano|
+|-----------|------------|
+|<img src="img/center_lock_moyeu.jpg" alt="Photo de l'adaptateur center lock sans la vis." width="300px">|<img src="img/disque-frein-adaptateur-monte.png" alt="Photo de l'adaptateur center lock avec la vis." width="300px">|
+
+:::{admonition} Attention
+:class: warning
+Veillez à ce que le disque ne rentre pas en contact avec le mur lorsque vous entreposez votre roue assemblée. Cela pourrait voiler légèrement le disque.
+:::
+
+Plusieurs types de clés existent pour le serrage de l'écrou du center lock shimano
+
+<img src="img/exemple-cles-serrage-ecrou-center-lock.png" alt="Exemple de cles de serrage pour l'écrou centerlock." width="400px">
+
+### Montage du pignon
+
+<div class="avoid-break"></div>
+
+:::{note}
+Un très [bon tutoriel fait par lecyclo.com](https://www.youtube.com/watch?v=Kl7ar8FWoYU) montre de manière détaillée l'assemblage d'un Nexus 8 sur un vélo classique. Il peut être complémentaire au présent guide, mais ne le remplace pas. Le vhélio comportant des particularités non traitées dans la vidéo.
+:::
+
+<div class="avoid-break"></div>
+
+#### Étape 1 : pose du pignon
+
+<div class="avoid-break"></div>
+
+Poser le pignon fourni avec la roue, qui est bombé d'un côté, de telle sorte que les dents soient plus proche des rayons de la roue (éloignant ainsi la chaine de la patte pour l’arrivée du câble de vitesse)
+
+<div class="avoid-break"></div>
+
+```{image} img/pignon_nexus_8.jpg
+:alt: Pignon sur le moyeu Nexus 8
+:width: 200px
+```
+
+#### Étape 2 : pose du clip
+
+Poser le clip en 3 étapes :
+
+<div class="avoid-break"></div>
+
+```{image} img/clip_nexus_8.jpg
+:alt: Clip Nexus 8
+:width: 200px
+```
+
+Placer sur la gorge supérieure en maintenant avec un doigt une extrémité et avec un petit tournevis plat, faire un effet de levier pour placer l’autre extrémité dans la gorge finale
+
+```{image} img/placement_clip_nexus_8_etape_1.jpg
+:alt: Placement clip Nexus 8 étape 1
+:width: 200px
+```
+Tout en maintenant toujours la première extrémité avec le doigt sur la gorge supérieure, continuer avec le petit tournevis plat à faire un effet de levier jusqu’au milieu du clip pour le mettre dans la gorge finale
+
+```{image} img/placement_clip_nexus_8_etape_2.jpg
+:alt: Placement clip Nexus 8 étape 2
+:width: 200px
+```
+
+Finir de faire levier avec le petit tournevis plat pour emmener le reste du clip dans la gorge finale
+
+```{image} img/placement_clip_nexus_8_etape_3.jpg
+:alt: Placement clip Nexus 8 étape 3
+:width: 200px
+```
+
+:::{note}  
+Il est impossible d’engager les deux extrémités du clip en même temps.
+:::
+
+#### Étape 3 : rondelle de cache
+
+<div class="avoid-break"></div>
+
+```{image} img/rondelle_cache_nexus_8.jpg
+:alt: Rondelle cache Nexus 8
+:width: 200px
+```
+
+#### Étape 4
+
+Mettre l’ensemble rondelle + patte pour le câble de changement de vitesse en alignant les 3 points rouges
+
+<div class="avoid-break"></div>
+
+```{image} img/pose_pate_nexus_8.jpg
+:alt: Pose pate Nexus 8
+:width: 200px
+```
+
+#### Étape 5
+
+Mettre la bague en alignant les deux points jaunes et tourner la bague dans le sens des aiguilles d’une montre
+
+<div class="avoid-break"></div>
+
+```{image} img/pose_bague_nexus_8.jpg
+:alt: Pose bague Nexus 8
+:width: 200px
+```
+
+#### Étape 6
+
+Mettre les rondelles avec téton (noir et grise) et les deux écrous borgnes (pour ne pas les perdre)
+
+<div class="avoid-break"></div>
+
+  <img src="img/pignon_nexus_8_monte_face.jpg" alt="Pignon Nexus 8 monté vue de face" width="200px">
+  <img src="img/pignon_nexus_8_monte_haut.jpg" alt="Pignon Nexus 8 monté vue de haut" width="200px">
+
+La roue est prête à être montée sur le vhéliotech. Lors du montage de la roue, il faudra retirer les deux écrous borgnes.
+
+La poignée de vitesse est prémontée avec le câble et la bague (bague qui sera à positionner dans l’emplacement sur le moyeu ensuite).
+
+Vous pouvez serrer la bague sur le cable avant de l'enficher sur le moyeu en la plaçant à une ditance de 101mm de l'extrémité de la gaine, ce qui devrait correspondre au réglage optimum.
+
+Distance entre le bague (axe de la bague) du bord de la gaine lorsque la poignée est en vitesse 1 (y=101mm) :
+
+![Position câble Nexus 8](img/position_cable_nexus_8.png)
+
+:::{important}
+Pour vous assurez que le moyeu Nexus 8 est bien réglé (alignement des deux traits jaunes), consultez la notice d'utilisation du vhéliotech, chapitre 3.5.
+
+Pour plus d'informations, vous pouvez aussi vous référer à la [documentation offcielle Shimano](https://si.shimano.com/fr/pdfs/sm/IHG-INTER8/SM-IHG-INTER8-002_FRE.pdf) (p26)
+:::
+
+## Moteur et pédalier
+
+### Configurations motorisées
+
+- Assembler les **2 tôles** moteur autour du moteur sur une table avec les vis
+
+|Vue de haut|Vue latérale|Vue arrière|
+|-----------|------------|-----------|
+|<img src="img/moteur/moteur-2-toles.png" alt="Photo du moteur avec ses deux tôles posées. Vue de dessus." width="300px">|<img src="img/moteur/moteur-2-toles-assemblees-vue-laterale.png" alt="Photo du moteur avec ses deux tôles assemblées. Vue latérale." width="300px">|<img src="img/moteur/moteur-2-toles-assemblees-vue-arriere.png" alt="Photo du moteur avec ses deux tôles assemblées. Vue arrière." width="200px">|
+
+- Visser le **moteur (TSM03)** aux tôles avec les **vis QIN15** et **écrous QIN16**
+
+|Vue latérale droite|Vue latérale gauche|
+|-----------|------------|
+|<img src="img/moteur/moteur-vis.png" alt="Photo du moteur avec ses vis. Vue latérale droite." width="300px">|<img src="img/moteur/moteur-vis-ecrou.png" alt="Photo du moteur avec ses vis et ses écrous. Vue latérale gauche." width="300px">|
+
+- Mettre des **entretoises E21** dans les tubes pour qu’ils ne s’écrasent pas
+- **Attention** à ne pas pousser les entretoises trop loin dans le tube (sinon, il faut passer par l'autre extrémité pour les faire revenir...), pour cela, utiliser un tournevis pour maitriser son déplacement, en l'insérant dans les trous prévus pour les vis.
+
+|Entretoise E21 en cours d'insertion|Maitrise du déplacement des entretoises|Entretoise E21 insérée|
+|-----------|------------|------------|
+|<img src="img/moteur/moteur-entretoise-tube.png" alt="Photo d'une entretoise dans un des tubes." width="300px">|<img src="img/moteur/moteur-maitrise-entretoises-tube.png" alt="Maitrise du déplacement des entretoises insérées dans un tube." width="300px">|<img src="img/moteur/moteur-entretoise-tube-inseree.png" alt="Photo d'une entretoise insérée dans un des tubes." width="300px">|
+
+- Placer les **vis M8** 150mm une par une en mettant les entretoises entre chaque élément. Dans les tubes, entre le tube et la tôle du moteur, et à l'intérieur du bloc du moteur. L'objectif étant d'obtenir un bloc rigide.
+
+|Vis et entretoises|Moteur posé|
+|-----------|------------|
+|<img src="img/moteur/moteur-6-entretoises-vue-dessus.png" alt="Photo des 6 entretoises avec les vis." width="300px">|<img src="img/moteur/moteur-pose.png" alt="Photo du moteur posé." width="300px">|
+
+- Couper l'extrémité de la **vis M8** 150mm si jamais celle-ci rentre en contact avec les manivelles. Réaliser cette opération à la scie à métaux (pour ne pas dégrader les freins des écrous freins)
+
+### Configuration basique
+
+La configuration "basique" est équipée d’un pédalier sans moteur. Monter l’élément structurel au cadre (CHO38). Visser le boîtier de pédalier (TSM13). 
+
+:::{note}
+Cet élément structurel CHO38 est également conçu pour pouvoir adapter les moteurs Bafang de la série BBS. On peut imaginer adapter d'autres moteurs prévus pour se monter à la place d'un boitier de pédalier classique, mais nous n'avons pas encore fait d'autres essais, et il peut y avoir des ajustements à faire.
+:::
+### Plateau
+
+#### Configuration basique
+Pour la configuration basique (non motorisée), utiliser le plateau TSM15.
+
+#### Configuration motorisée
+Pour les configurations motorisées, monter le plateau 48 dents (TSM00).
+
+- Dans un premier temps, démontez le plateau livré avec le moteur
+
+|Clé de démontage|Plateau démonté|
+|-----------|------------|
+|<img src="img/moteur/plateau-demontage.png" alt="Photo de la clé à utiliser pour démonter les 4 vis du plateau." width="200px">|<img src="img/moteur/plateau-demontage-3-parties.png" alt="Photo du plateau démonté." width="300px">|
+
+- Ensuite, remplacez l'ancien plateau par le plateau à 48 dents
+
+|Plateau 48 dents|Remontage du plateau|
+|-----------|------------|
+|<img src="img/moteur/plateau-48-dents.png" alt="Photo du nouveau plateau 48 dents." width="300px">|<img src="img/moteur/plateau-remontage-48-dents.png" alt="Photo du plateau remonté avec le plateau 48 dents." width="300px">|
+
+- Enfin, montez le plateau 48 dents sur le moteur en utilisant une clé BB à 20 dents
+
+<img src="img/moteur/plateau-cle-montage-moteur.png" alt="Photo de la clé BB à 20 dents." width="300px">
+
+#### Alignement du plateau et du pigon arrière
+:::{important}
+Il est important de bien aligner le plateau avec le pignon de la roue arrière afin d'éviter tout problème de déraillement ou d'usure précoce de la transmission.
+Si le vhélio est monté conformément à ce qui est défini dans la 3D, le plateau et le pignon devraient être bien alignés.
+:::
+
+### Manivelles
+
+[Tutoriel sur l’installation des manivelles](https://youtu.be/kwWbAkDVSDQ?t=110) (l’opération inverse, l’extraction de manivelle, nécessite un outil spécial, et est expliquée un peu plus tôt dans la même vidéo).
+Pour installer les manivelles, veiller à bien les positionner en opposition (si la manivelle de droite est en haut, la manivelle de gauche est en bas). Attention aussi à ne pas inverser les manivelles (il y en a une qui doit aller à gauche, l’autre doit aller à droite). Emmancher chaque manivelle puis visser la vis de fixation de manivelle dans l’axe de pédalier.
+
+Pour les configurations avec moteur, utiliser les manivelles fournies avec le moteur. Essayer de faire bouger le moteur en gauche droite en saisissant les 2 manivelles pour s’assurer qu’il n’y a pas de jeu. Resserrer les vis du moteur à la demande.
+
+### Pédales
+
+[Tutoriel pour monter et démonter les pédales (TSM12)](https://youtu.be/voXytByo5SE)
+Attention à veiller au sens des pédales : elles sont normalement notées D ou R pour Droite ou Right et G ou L ou Gauche ou Left. La pédale de gauche est souvent striée également, ce qui ajoute un élément pour la reconnaître.
+La pédale droite se visse dans le sens horaire et se dévisse dans le sens antihoraire.
+La pédale gauche se visse dans le sens antihoraire et se dévisse dans le sens horaire.
+Il peut être difficile de dévisser les pédales (si toutefois vous aviez besoin de le faire). Munissez-vous dans ce cas d’une clé avec un long bras ou d’un bras de levier pour avoir plus de force. Il est recommandé de laisser les manivelles sur le vhélio pour retirer les pédales.
+
+## Montage chambre à air et pneu
+
+[Tutoriel vidéo](https://youtu.be/gtGxtD4XkW4)
+
+- Poser le fond de jante sur la roue (ROU01).
+- Poser la bande anti-crevaison (ROU04) si concerné (inutile si utilisation de pneus anti-crevaison).
+- Installer le pneu (ROU03) sur un seul flanc (respecter le sens de rotation du pneu qui permet une meilleure adhérence et évacuation de l’eau : une flèche est indiquée sur le flanc du pneu).
+- Installer la chambre à air (ROU02) (très légèrement gonflée) dans le pneu en commençant par la valve.
+
+<img src="img/chambre-pneu.png" alt="Photo de la chambre à air insérée dans le pneu." width="300px">
+
+- Finir de monter le second flanc du pneu en prenant garde de ne pas coincer la chambre à air.
+
+<img src="img/chambre-second-flanc.png" alt="Photo de montage du second flanc." width="300px">
+
+- Gonfler à 4 bars (équivalent à 60 PSI), selon le pneu utilisé. Toujours respecter la pression qui est indiquée sur le flanc du pneu.
+
+:::{note}
+Au lieu d'utiliser une bande anti-crevaison du commerce, nous proposons de mettre à la place une vielle chambre à air (après avoir retiré la valve) qui aura la même fonction de couche anti-crevaison. Ajuster la longueur de la chambre à air, afin que, une fois celle-ci positionnée en fond de pneu, les deux extrémités ne se superposent pas (laisser 20mm de jeu). Nota, s'il y a superposition, cela peut générer une petite vibration à chaque tour de roue. Avec le pneu pick up 20" x 2.35, il faut une chambre à air de 150cm.
+:::
+
+## Montage des étriers de frein
+Nous centraliserons le montage des étriers ici. C'est presque la même chose pour les 3 roues, et nous avons pris des exemple sur les roues avant.
+- Si ce n’est pas déjà fait, monter les **plaquettes** dans l’étrier de frein.
+- Monter l’**étrier de frein** sur le **châssis CHO47** avec le **support de frein CHO34** (ne pas serrer les deux vis, les réglages de l’étrier se feront plus tard).
+
+|Vue avec références des pièces|Vue des pièces|Assemblage de l'étrier sur le support|
+|-----------|------------|------------|
+|<img src="img/etrier/etrier-pieces-avant-gauche-fond-carton.png" alt="Photo des pièces de l'étrier avant gauche avec les références des pièces." width="300px">|<img src="img/etrier/etrier-pieces-avant-gauche-fond-blanc.png" alt="Photo des pièces de l'étrier avant gauche sur fond blanc." width="300px">|<img src="img/etrier/etrier-assemblage-etrier-support.png" alt="Photo de l'assemblage de l'étrier sur le support." width="300px">|
+
+|Vue avec références des pièces|Vue des pièces|Assemblage du support sur le chassis|
+|-----------|------------|------------|
+|<img src="img/etrier/etrier-pieces-gauche-droite-fond-carton.png" alt="Photo des pièces des 2 étriers avant avec les références des pièces." width="300px">|<img src="img/etrier/etrier-support-tubes-outils.png" alt="Photo du tube, du support et des outils." width="300px">|<img src="img/etrier/etrier-assemblage-tube-support.png" alt="Photo de l'assemblage du tube sur le support." width="300px">|
+
+|Pose de l'étrier sur le chassis|Montage du câble dans l'étrier|Frein+câble+étrier|
+|-----------|------------|------------|
+|<img src="img/etrier/etrier-pose-avant-gauche.png" alt="Photo de la pose sur le chassis." width="300px">|<img src="img/etrier/etrier-cable-outil.png" alt="Photo du cable et de l'outil." width="300px">|<img src="img/etrier/etrier-cable-frein-etrier.png" alt="Photo de l'assemblage du frein, du câble et de l'étrier." width="300px">|
+
+## Montage de la roue arrière
+
+- Mettre la roue en place (sans les écrous borgnes).
+- Serrer les écrous de l’axe de la roue (clé de 15).
+- Monter de l’étrier de frein arrière (idem que pour les roues avant, voir au dessus...)
+
+### Fixation des câbles et poignées
+
+- Passer les 2 ensembles câble (FRN05) + gaine (FRN02) (vitesse et frein) le long du châssis puis le long du côté droit du guidon, en fixant les gaines à intervalles réguliers avec de la bande autoagrippante scratch. Assurez-vous que le guidon peut tourner librement sans tirer sur les gaines, et qu’elles ne peuvent se coincer nulle part.
+- Mettre la poignée de changement de vitesse et le levier de frein (FRN01) sur le guidon, du côté droit (inutile de serrer à ce stade, vous pourrez faire les ajustements pour une position de conduite confortable quand tout sera en place)
+
+:::{note}
+Le cable de frein arrière mesure environ 185cm. La gaine fournie en standard avec la poignée de vitesse est adaptée (laisser la longueur de gaine).
+:::
+
+### Réglage du frein
+
+[Tutoriel vidéo (activer les sous-titres)](https://youtu.be/NmqGeLNcVIg)
+
+- Vérifier que les vis de tension au guidon et à l’étrier soient serrées
+
+:::{figure-md}
+
+<img src="img/vis_desserree_poignee.jpg" alt="Photo de la vis de poignée desserrée" width="200px">
+
+vis dessérrée
+:::
+
+:::{figure-md}
+
+<img src="img/vis_serree_poignee.jpg" alt="Photo de la vis de poignée serrée" width="200px">
+
+vis sérrée
+:::
+
+- Câbler l’étrier : insérer le câble de frein dans l’étrier et le positionner dans la vis. Le câble doit (en étant tiré) faire pivoter le bras de l’étrier. Laissez-le au repos c’est-à-dire sans tension de câble et tirez sur le câble avec la main juste pour éviter qu’il y ait du mou, mais sans que cela fasse pivoter le bras de l’étrier. Serrer la vis qui maintient le câble (sans forcer).
+- Régler la première plaquette : la plaquette n’est pas mobilisée par la tension du câble. Elle doit être suffisamment proche pour effectuer l’action de contre-pincement du disque quand la plaquette mobile pousse sur le disque, et suffisamment loin du disque pour éviter un frottement. Pour cela, commencez par serrer la molette de la plaquette fixe fixe (molette rouge, à l’aide d’une clé Torx de 25) jusqu’à ce que la plaquette touche le disque. Ensuite, desserrez-la d’un quart de tour.
+- Régler la fixation de l’étrier : tenir le levier de frein arrière (à droite sur le guidon) serré à l’aide d’un élastique ou d’une chambre à air. Serrez les deux vis de fixation de l’étrier en procédant petit à petit (un tour sur la vis du haut, un tour sur la vis du bas) afin que l’étrier se positionne correctement par rapport au disque. Serrez au contact sans forcer.
+- Vérifier et ajuster le réglage : relâchez le levier de frein (retirez l’élastique), puis faites tourner la roue à la main : si elle ralentit ou bien si vous entendez un bruit de frottement, le réglage doit être ajusté. Si elle tourne bien, mais que le freinage n’est pas efficace, le réglage doit être repris depuis l’étape « câbler l’étrier », il y a du mou quelque part dans le chemin du câble. Pour comprendre l’origine du frottement, utilisez une lampe frontale et une feuille blanche que vous mettrez derrière l’étrier, ceci afin de voir correctement l’espacement entre les plaquettes et le disque. Faites tourner la roue et observez bien le mouvement du disque.
+La deuxième plaquette est également à ajuster afin que celle-ci ne frotte pas le disque au repos.
+  - Si le disque frotte d’un côté puis de l’autre, il est sans doute voilé, se référer à la notice d’utilisation.
+  - Si le disque frotte une plaquette en biais (ou les deux), il faut ajuster le parallélisme des plaquettes (desserrez l’une ou l’autre des vis de fixation de l’étrier, repositionnez-le pour que les plaquettes soient bien parallèles au disque et resserrez les vis de fixation de l’étrier).
+  - Si le disque frotte une plaquette de manière parallèle, il faut d’abord vérifier que l’étrier soit bien centré, il faut dans ce cas desserrer l’une ou l’autre des vis de fixation de l’étrier, et le repositionner pour que le disque soit centré entre les deux plaquettes. Si malgré le centrage, le frottement perdure : soit il s’agit de la plaquette mobile, soit de la plaquette fixe. Pour la plaquette mobile vérifier que le câble n’a pas été trop tendu lors du câblage de l’étrier et si ça n’a pas réduit la course du bras de l’étrier. S’il s’agit de la plaquette fixe, desserrez d’un quart de tour (molette rouge, sens antihoraire) et retestez en faisant tourner la roue jusqu’à disparition du frottement.
+- Terminer le réglage en serrant à 4nm les vis de fixation de l'étrier et la vis de maintien du câble.
+
+## Ensemble roues avant et freins
+
+- Monter fonds de jante, bandes anti-crevaison, chambres à air et pneus (même procédure que pour la roue arrière).
+- Gonfler à 3 bars (équivalent 43 PSI). Toujours respecter la pression qui est indiquée sur le flan du pneu. Il est important que les deux roues avant soient gonflées à la même pression.
+- Monter les disques sur les roues (même procédure que pour la roue arrière)
+- Mettre les roues en place et serrer les écrous.
+- Monter les étriers de frein équipés de leurs plaquettes sur le châssis avec les supports de frein CHO34 (ne pas serrer les deux vis, les réglages de l’étrier se feront plus tard)
+- Passer l’ensemble câble + gaine de frein de chaque roue le long du bras de direction, puis le long du côté gauche du guidon, en fixant les gaines à intervalles réguliers avec de la bande autoagrippante scratch. Assurez-vous que le guidon peut tourner librement sans tirer sur les gaines ni les coincer.
+- Fixer le levier de frein au guidon (poignée de gauche). Ce levier permet de commander les deux câbles et permet le frein parking.
+- Régler les freins par la suite, une roue après l’autre (même procédure que pour la roue arrière).
+
+:::{note}
+Mettre un repère sur le frein gauche à chacune des deux extrémités de la gaine (scotch) pour faciliter ensuite l'équilibrage des deux freins.
+:::
+
+:::{note}
+La dimension du câble de frein avant gauche est de 95cm
+Celle du câble de frein avant droit est de 115cm
+:::
+
+
+## Transmission
+
+### Chaîne 
+
+[Tutoriel sur l’utilisation d’un dérive-chaîne](https://youtu.be/73QwrPDiOBI)
+
+[Tutoriel sur l’installation d’une nouvelle chaîne](https://youtu.be/qbjvMicUGUk)
+
+La chaîne (TSM02) d’un vhélio étant plus longue que celle d’un vélo classique, il faut assembler 3 chaînes classiques ensemble en utilisant un « dérive-chaîne ». Pour ajuster la longueur finale, il faut retirer le bon nombre de maillons. Les maillons se retirent deux par deux (si on en retire un nombre impair, on ne peut plus refermer la chaîne). Il faut que la chaîne soit la plus courte possible, mais qu’il soit quand même possible de la mettre en place sans forcer dessus. Le tendeur absorbera le « mou » restant (voir ci-dessous).
+La longueur totale de la chaine doit faire 378cm.
+
+### Tendeur de chaîne
+
+<div class="avoid-break"></div>
+
+Le tendeur de chaîne permet d’ajuster la tension de la chaîne, et d’éviter ainsi de dérailler ou d’abîmer la transmission.
+
+<div class="avoid-break"></div>
+
+![Tendeur de chaine](img/tendeur_chaine.svg)
+
+L’ensemble tendeur de chaîne est composé de :
+- un pignon avec roulement (TSM01)
+- 2 équerres plates jointes (CHO17)
+- le tendeur à œillets réglable (QIN24)
+- un ressort (QIN18)
+- une bande auto-agrippante (QIN01)
+- Quincaillerie :
+  - Boulon M6x35 : 5 unités
+  - Boulon M6x20 : 3 unités
+  - Ecrous et rondelles
+
+Monter l’ensemble conformément au plan. Après avoir monté la chaîne à la bonne longueur, s’assurer que la chaîne est bien positionnée sur le plateau avant et le pignon de la roue arrière. 
+
+Desserrer le tendeur, placer la chaîne sur les dents de la poulie du tendeur de chaîne (attention, la poulie a une dent sur deux plus large afin de rentrer dans les maillons mâles et femelles de la chaîne). La chaîne ne doit pas « pencher » d’un côté ou de l’autre de la poulie du tendeur de chaîne. Resserrer progressivement le tendeur. La chaîne ne doit pas avoir de mou, mais ne pas être raide non plus (le bon réglage est quand on peut passer une carte de visite entre deux spires du ressort).
+
+:::{important}
+Une fois la bonne tension de chaîne obtenue, verrouillez votre réglage en attachant le tendeur au châssis à l’aide de bande scratch auto-agrippante (QIN01), pour éviter que celui-ci ne tourne et se desserre tout seul avec les vibrations du vhélio. Sans cela, la chaine se détendra progressivement ce qui va d’abord générer des bruits de frottement et finira par provoquer un déraillement.
+
+```{image} img/tendeur_chaine_fixe.jpg
+:alt: Tendeur de chaine fixé avec la bande
+:width: 200px
+```
+:::
+
+## Electronique moteur
+
+### Écran
+
+[Tutoriel vidéo sur le réglage du moteur](https://bafangusadirect.com/blogs/installation/500c-display-manual-and-video)
+[Notice d'utilisation en Français](https://ozo-electric.com/pdf/notices/Notice%20utilisation%20display%20TFT%20500C.pdf) (à trouver aussi dans la documentation complète section "II - Fichiers sources (niveau expert)/Documentation produits")
+
+Les réglages de l’écran (TSM08) se font après connexion de la batterie.
+L’écran se branche directement sur le moteur. Il faut configurer le diamètre de la roue arrière (20 pouces) sur l’écran dans le mode paramètres. Pour entrer dans le mode paramètre, le code est normalement « 1919 ».
+Nous conseillons de régler le nombre d’assistances à 5.
+
+:::{important}
+Si vous achetez votre écran et votre moteur séparément, veillez à ce que l'écran soit compatible avec le moteur (protocole UART)
+:::
+
+### Capteur de vitesse
+
+Le capteur de vitesse (TSM09), indispensable au fonctionnement du moteur, se monte sur la roue arrière.
+
+:::{note}
+En fonction de votre moteur, un prolongement du câble du capteur de vitesse fourni avec le moteur pourrait être nécessaire : soudure à l'étain ou miniconnecteurs wago.
+:::
+
+Fixer le capteur de vitesse sur le cadre avec la vis M6x80 à tête hexagonale creuse (QIN56), comme indiqué sur l'image ci-dessous. Le trou de fixation du capteur est prévu pour une vis M5, il pourra être nécessaire de l'agrandir. La pièce étant en plastique, l'opération se réalise facilement avec un couteau ou une paire de ciseaux (ouverte en grand, en utilisant une seule lame).
+
+Fixer l’aimant sur un rayon en l’alignant au capteur de vitesse (avec une distance inférieure à 5 mm).
+
+Si le capteur de vitesse n’est pas fonctionnel, le moteur fonctionnera mais fera de petites interruptions (genre de saccade).
+
+![Photo capteur de vitesse](img/capteur_vitesse.jpg)
+
+<img src="img/fixation_capteur_vitesse.png" alt="Fixation du capteur de vitesse" width="400px">
+

source/060_stabilisateurs.md

@@ -0,0 +1,10 @@
+# Stabilisateurs (roulettes latérales)
+
+Les roues latérales empêchent que le vhéliotech se couche sur le côté dans des conditions particulières (vitesse élevée, virage en dérive, conduite avec un passager qui réhausse le point de gravité). Ces roues sont très importantes et s’avèrent indispensables pour transporter un passager ou du poids à l’arrière.
+En roulage normal, les roues stabilisatrices ne touchent pas le sol et ne tournent pas.
+
+- Assembler, dans le moyeu des 2 roues, une entretoise encadrée de chaque côté par un roulement
+- Monter les flancs des 2 roues qui permettront de les fixer (voir les tubes aluminium correspondants sur les plans)
+- Monter les roues sur une vis M8x100 (QIN25) qui servira d'axe, avec une rondelle (QIN13) de chaque côté de la roue, ainsi qu'à l'extérieur des tubes aluminium
+
+![Schéma d'assemblage des roues stabilisatrices'](img/roues_stabilisatrices.jpg)

source/080_installation_electricite.md

@@ -0,0 +1,135 @@
+# Installation de l’électricité
+
+Les équipements cycle électriques ont été choisis avec un soin particulier pour éviter toute obsolescence programmée (ce qui n’est pas facile dans le domaine du cycle).
+L’électrification des véhicules est discutable dans la mesure où il projette dans un monde d’objets éphémères, car rapidement obsolètes dès qu’un élément ne fonctionne plus. Nous avons choisi des éléments qui peuvent se remplacer individuellement, se reconditionner… pour une durée de vie maximum de l’ensemble.
+Par ailleurs, le secteur des batteries avance à grands pas et il est probable que d’ici quelques années, pour avoir du 36V embarqué, nous aurons recours à d’autres technologies ou des systèmes de batteries de secondes vies. Le vhéliotech a été pensé pour pouvoir être compatible avec ces futurs produits/technologies à venir.
+
+Le moteur BAFANG M400 (TSM03) est un moteur robuste, éprouvé et facilement réparable. Des tutoriels existent, par exemple [cette vidéo](https://www.youtube.com/watch?v=nm6UTwLRays) explique comment le démonter, si toutefois vous aviez besoin de remplacer une des pièces internes.
+
+Le moteur peut se connecter sur presque n’importe quelle batterie 36V (sous réserve des connecteurs) avec 2 fils (+ et -).
+La batterie 36V 14,5Ah (ELE04) avec boitier de type "silverfish" peut se trouver sur au moins 3 sites marchands très facilement. Cette batterie peut être reconditionnée par la société doctibike (changement des cellules, conservation du boîtier et BMS) après un premier cycle de vie.
+
+## Configurations « motorisée » et « solaire »
+
+### Moteur
+
+:::{note}
+Si vous avez deux batteries, vous ne pouvez en connecter qu’une à la fois. Lorsque la première est déchargée, intervertissez les deux batteries.
+:::
+
+![Schéma de la connexion du moteur et de la batterie](img/guide-elec-4_vsolaire_moteur.svg)
+
+## Version « solaire » et « intégrale »
+
+:::{admonition} Attention
+:class: warning
+Le MPPT (contrôleur de charge solaire ELE34) doit impérativement être réglé pour charger une batterie de 36V au risque d'endommager votre batterie. Pouvant gérer des tensions de 24V à 72V, il n'est pas sûr qu'il soit correctement configuré à la réception.
+
+De plus, il est conseillé de le configurer pour charger efficacement les batteries lithium-ion (chimie Nickel-Manganèse-Cobalt) donc la tension maximale pour une batterie de 36V doit être de 41.5V. Or, de base la tension max qui sort du MPPT réglé sur 36V est supérieur à 42V ce qui est plutôt adapté à des batteries au plomb.
+Pour assurer une bonne durée de vie de votre batterie et aussi pouvoir profiter pleinement de la charge solaire sans coupure de charge pour surtension, il faut régler le MPPT de manière personnalisée (mode SELF).
+La procédure est décrite (en anglais) dans [cette vidéo](https://youtu.be/omAhsQqwWSo?t=770) (à 12min50s).
+Il faut seulement régler la tension F (qui correspond à la tension de charge finale) à 41.5V et laisser les autres paramètres.
+
+Veillez à faire ce réglage **avant de connecter le MPPT à la batterie**. Vous pouvez le faire en connectant le MPPT à votre panneau dehors quand il fait soleil ou avec une alimentation 12V stabilisée.
+:::
+
+## Configuration « solaire »
+
+### Charge solaire
+
+:::{note}
+Si vous avez deux batteries, vous ne pouvez en connecter qu’une à la fois. Lorsque la première est chargée, connectez le MPPT sur l’autre.
+:::
+
+![Schéma de la connexion du moteur, de la batterie, du MPTT et du panneau](img/guide-elec-5_vsolaire-charge-solaire.svg)
+
+## Configuration « intégrale »
+
+### Moteur
+
+:::{note}
+Si vous avez deux batteries, vous ne pouvez en connecter qu’une à la fois. Lorsque la première est déchargée, intervertissez-les. Vous devez aussi gérer la recharge des deux batteries (lorsque la première est rechargée, branchez le connecteur sur l’autre batterie). Rien n'empêche de charger la batterie qui se décharge, il est également possible de charger l'une pendant que l'autre se décharge.
+:::
+
+![Schéma de la connexion du moteur et de la batterie, configuration intégrale](img/guide-elec-4_vintegrale-moteur-batterie.svg)
+
+### Charge solaire
+
+![Schéma de la connexion du panneau au boitier elec, configuration intégrale](img/guide-elec-5_vintegrale-charge-solaire.svg)
+
+### Platines avant
+
+:::{note}
+Les prises USB s’alimentent en 12V ; elles sont équipées à l’intérieur d’un convertisseur de tension 12V vers 5V.
+:::
+
+![Schéma de la connexion des platines avant au boitier elec, configuration intégrale](img/guide-elec-1_platines-avant.svg)
+
+### Platines arrière
+
+![Schéma de la connexion des platines arrière au boitier elec, configuration intégrale](img/guide-elec-2_platines-arriere.svg)
+
+### Commodo (commande clignotants et phares)
+
+![Schéma de la connexion des commodo au boitier elec, configuration intégrale](img/guide-elec-3_comodo-avertisseur.svg)
+
+### Connexions boîtier (ELE99)
+
+#### Luminaires
+
+![Schéma de la connexion des luminaires au boitier elec, configuration intégrale](img/guide-elec-6_connexions-boitier-luminaires.svg)
+
+#### Commodo
+
+![Schéma de la connexion des commodo au boitier elec, configuration intégrale](img/guide-elec-7_connexions-boitier-comodo-avertisseur.svg)
+
+#### Moteur, batterie, solaire
+
+![Schéma de la connexion du moteur, de la batterie, du panneau au boitier elec, configuration intégrale](img/guide-elec-8_connexions-boitier-moteur-batterie-solaire.svg)
+
+## Installation de la batterie
+
+Le support batterie CHO24 est prévu pour recevoir deux batteries 36V 14,5 Ah (ELE04) avec un boitier "silverfish". D'autres types de boitier de batterie peuvent convenir cependant les fixations ne seront peut-être pas adaptés.
+
+### Etape 1
+
+Installer le connecteur de la batterie avec 4 vis M4 tête fraisé.
+
+<div class="avoid-break"></div>
+
+<img src="img/installation_electrique/Ordre_fix_prise_bat.jpg" alt="ordre de fixation des connecteurs" width="200px">
+<img src="img/installation_electrique/connecteur_batterie_2.jpg" alt="Connecteur fixé sur CHO24" width="200px">
+
+### Etape 2
+
+Installer le rail de la batterie. Il est nécessaire de la couper à une longueur de 21,5cm. 
+
+<div class="avoid-break"></div>
+
+<img src="img/installation_electrique/rail_batterie.jpg" alt="Rail batterie" width="200px">
+
+### Etape 3
+
+Installer un écrou M6x8 qui servira d'antivol.
+La tête de l'écrou servira de buté empêchant la batterie de sortir du rail lorsque la clef sera en position LOCK (off et on).
+
+<div class="avoid-break"></div>
+
+<img src="img/installation_electrique/antivol_batterie_2.jpg" alt="antivol batterie sur le rail" width="200px">
+<img src="img/installation_electrique/antivol_batterie.jpg" alt="antivol batterie" width="200px">
+
+### Etape 4
+
+Proteger la connectique de la batterie de l'humidité et des vibrations en ajoutant du silicone dessus.
+
+<div class="avoid-break"></div>
+
+<img src="img/installation_electrique/silicone_fiche_batterie.jpg" alt="silicone sur fiche batterie" width="200px">
+
+### Etape 5
+
+Placer le support batterie sur le Vhelio avec 5 vis M6x35.
+
+<div class="avoid-break"></div>
+
+<img src="img/installation_electrique/Batterie_sur_support.jpg" alt="Support Batterie installer sur le vhelio." width="400px">

source/084_pose_tole_panneau.md

@@ -0,0 +1,88 @@
+# Montage des tôles et du panneau solaire
+
+## Montage des tôles
+
+<table class="docutils align-default">
+	<thead>
+		<tr>
+			<th class="head">Photo</th> <th class="head">Code</th> <th class="head">Nom</th> <th class="head">Quantité</th>
+		</tr>
+	</thead>
+	<tbody>
+		<tr>
+			<td rowspan="2"><img alt="Tôle finition avant et tôle supérieure nez" src="_images/finition_avant_nez.jpg" style="width: 200px;"/></td>
+			<td>CHO10</td> <td>Tôle finition avant</td> <td>1</td>
+		</tr>
+		<tr>
+			<td>CHO21</td> <td>Tôle supérieure nez</td> <td>1</td>
+		</tr>
+		<tr>
+			<td rowspan="4"><img alt="Gardes boues avant" src="_images/Gardes_boues_avant.jpg" style="width: 200px;"/></td>
+			<td>CHO40</td> <td>Garde boue avant droit</td> <td>1</td>
+		</tr>
+		<tr>
+			<td>CHO41</td> <td>Garde boue avant gauche</td> <td>1</td>
+		</tr>
+		<tr>
+			<td>CHO42</td> <td>Tôle pare boue avant droite</td> <td>1</td>
+		</tr>
+		<tr>
+			<td>CHO43</td> <td>Tôle pare boue avant gauche</td> <td>1</td>
+		</tr>
+		<tr>
+			<td><img alt="Tôle garde boue arrière" src="_images/Garde_boue_arriere.jpg" style="width: 200px;"/></td>
+			<td>CHO58</td> <td>Garde boue central</td> <td>1</td>
+		</tr>
+		<tr>
+			<td><img alt="Tôle plateforme latérale" src="_images/plateforme_laterale.jpg" style="width: 200px;"/></td>
+			<td>CHO20</td> <td>Tôles plateformes latérales</td> <td>4</td>
+		</tr>
+		<tr>
+			<td></td>
+			<td>CHO23</td> <td>Tôle supérieure coffre central</td> <td>1</td>
+		</tr>
+		<tr>
+			<td><img alt="Tôle supérieur porte bagage" src="_images/porte_bagage.jpg" style="width: 200px;"/></td>
+			<td>CHO25</td> <td>Tôle supérieure porte bagage</td> <td>1</td>
+		</tr>
+		<tr>
+			<td><img alt="Tôle finition arrière" src="_images/tole_finition_arriere.jpg" style="width: 200px;"/></td>
+			<td>CHO11</td> <td>Tôle finition arrière</td> <td>1</td>
+		</tr>
+		<tr>
+			<td></td>
+			<td>CHO26</td> <td>Garde boue arrière</td> <td>1</td>
+		</tr>
+	</tbody>
+</table>
+
+<!-- this is just hack to reference images so that they are copied to the build folder -->
+<img class="hidden" src="img/tole/finition_avant_nez.jpg" width="200px"/>
+<img class="hidden" src="img/tole/Gardes_boues_avant.jpg" width="200px"/>
+<img class="hidden" src="img/tole/Garde_boue_arriere.jpg" width="200px"/>
+<img class="hidden" src="img/tole/plateforme_laterale.jpg" width="200px"/>
+<img class="hidden" src="img/tole/porte_bagage.jpg" width="200px"/>
+<img class="hidden" src="img/tole/tole_finition_arriere.jpg" width="200px"/>
+
+Les tôles supérieures CHO25 et CHO23 seront fixées avec les mêmes boulons que les glissières. Vous pouvez engager les vis sans mettre d'écrou pour le moment, afin de les maintenir en position.
+
+Les parties saillantes des tôles doivent êtres recouvertes de joints bord de tôle (DIV02, voir photo ci-dessous).
+Un joint bord de tôle doit être posé à l’avant du panneau solaire. Ce joint limite les coulures d’eau de pluie sur le conducteur. Le ressaut faisant office de rigole n’est pas très haut, mais nous n’avons pas trouvé de référence plus satisfaisante à ce stade.
+
+<img src="img/div02.jpg" alt="Photo d'un joint DIV02" width="200px">
+
+## Pose du panneau solaire
+
+Cette opération doit se faire à la fin du montage (afin de ne pas gêner la manipulation du vhéliotech) et ne pas dégrader le panneau.
+Prépositionner le panneau et vérifier les dimensions et l’équerrage des tubes (en exagérant, il ne faut pas que la structure forme un losange), sinon ajuster au moyen d’une sangle à cliquet.
+
+Nettoyer la surface inférieure du panneau et les tubes.
+Mettre un filet de mastic colle (résistante aux intempéries) sur la structure. Poser le panneau (opération à faire à 2 personnes). Mettre du poids sur le panneau aux endroits collés. Attendre une nuit pour retirer le poids.
+
+Passer les câbles le long des tubes aluminium de la structure en les fixant avec des bandes auto-agrippantes QIN01.
+
+:::{important}
+La longueur du panneau solaire peut légèrement varier en fonction du modèle exact envoyé par le fournisseur.
+Sur les premiers modèles de vhélio le panneau faisait ~140cm de long. Sur nos dernières commandes, il faisait ~136cm.
+Les deux tubes en haut à l'arrière sous la gallerie permettent de s'adapter aux deux cas de figure.
+:::

source/085_installation_textiles.md

@@ -0,0 +1,13 @@
+# Installation des textiles
+
+Dans ce guide de montage, nous partons du principe que vous avez commandé les textiles directement chez un fournisseur.
+
+Notez qu’il est tout à fait possible d’habiller le vhéliotech avec des textiles de réemploi en prenant en compte quelques caractéristiques minimales lors du choix de la toile : une bonne tenue aux ultra-violets, une toile qui ne se déchire pas facilement et suffisamment lourde pour qu’elle tombe le long des flancs du vhéliotech. Par exemple un tissu imperméable SAC, 375 g/m², en polyester doublé PVC.
+
+## Toiles latérales
+
+Pour fixer les toiles latérales (TXT02 pour la gauche et TXT03 pour la droite), présentez les tissus à leur emplacement définitif et repérez les emplacements des écrous du châssis. Vous pouvez marquer ces emplacements à l’aide d’un feutre. À l’aide d’un poinçon (ou en donnant un coup de cutter en croix), percer la toile à l’emplacement des vis. Il faudra aussi laisser un passage pour les boulons de fixation des glissières et des tôles. Les toiles seront maintenues en place lors de la fixation des glissières.
+
+## Vide-poches avant
+
+Pour fixer les vide-poches avant (TXT01), glissez le plat aluminium CHO52 à l’intérieur du passant de la pochette. Présentez l’ensemble à son emplacement définitif, le plat aluminium doit être horizontal et la pochette doit toucher la barre horizontale inférieure. Une fois la pochette bien en place, repérez l’emplacement du plat métallique, ajustez sa longueur, percez et fixez la pochette à l’aide de vis et d’écrous. Nous vous suggérons de fixer le fond de la pochette contre la barre horizontale inférieure afin qu’elle ne ballotte pas dans les virages. Percez le fond depuis l’intérieur de la pochette en traversant la barre horizontale et ajoutez une vis, une rondelle et un écrou.

source/086_assemblage_glissieres.md

@@ -0,0 +1,9 @@
+# Assemblage des glissières
+
+Placer les deux glissières CHO30 de part et d'autre sur la tôle du coffre central CHO23, de façon à ce que les crémaillères soient orientées vers l'intérieur. Les jupes se retrouvent prises en sandwitch entre la tôle et les glissières.
+
+Positionner chaque glissière avec 3 vis M6x40 (QIN40), ainsi qu'une rondelle (QIN12) entre la glissière et la tête de vis. Placer également une rondelle côté écrou puisqu'elle sera contre un tube aluminium. Ne pas serrer les vis pour le moment : les glissières devront être réglées une fois que les embases universelles (supports des sièges) seront prêtes. Vous pouvez toutefois effectuer le réglage avec les embases seules si les sièges ne sont pas encore prêts.
+
+<img src="img/Glisiere_sur_vhelio.jpg" alt="Glissière" width="600px">
+
+Réaliser le même montage pour les deux glissières arrière CHO32. Elles se fixent sur la tôle supérieure porte bagage CHO25 avec 3 vis M6x40 par glissières.

source/100_sieges.md

@@ -0,0 +1,164 @@
+# Sièges
+
+Un siège de vhéliotech est constitué de 2 pièces en tubes métalliques soudés (le dossier et l’assise) qui sont assemblées entre elles avec deux équerres. Cet ensemble sera à monter sur une embase universelle. Celle-ci pourra s'insérer sur les glissières du vhéliotech, avec le mécanisme de crantage pour régler la position de chaque siège.
+
+<img src="img/vue_3d_siege.png" alt="Vue 3D d'un siège sur le châssis" width="300px">
+
+## Liste des pièces nécessaires
+
+<table class="docutils align-default">
+    <thead>
+        <tr> <th class="head">Photo</th> <th class="head">Code</th> <th class="head">Nom</th> <th class="head">Qté</th> </tr>
+    </thead>
+    <tbody>
+        <tr> <td><img alt="Photo de l'assise" src="_images/assise_siege.jpg" style="width: 200px;"/></td>                <td>CHO55</td>    <td>Assise</td>                     <td>1 </td> </tr>
+        <tr> <td><img alt="Photo du dossier" src="_images/dossier_siege.jpg" style="width: 200px;"/></td>                <td>CHO56</td>    <td>Dossier</td>                    <td>1 </td> </tr>
+        <tr> <td><img alt="Photo de l'embase" src="_images/galets_siege.jpg" style="width: 200px;"/></td>                <td>CHO54</td>    <td>Embase</td>                     <td>1 </td> </tr>
+        <tr> <td rowspan="9"><img alt="Photo des pièces" src="_images/pieces_siege.jpg" style="width: 200px;"/></td>     <td>QIN03</td>    <td>Bouchon de tube</td>            <td>4 </td> </tr>
+        <tr>                                                                                                             <td>QIN51</td>    <td>Vis en U (étrier) petite</td>   <td>2 </td> </tr>
+        <tr>                                                                                                             <td>QIN52</td>    <td>Vis en U (étrier) grande</td>   <td>2 </td> </tr>
+        <tr>                                                                                                             <td>QIN54</td>    <td>Galet</td>                      <td>6 </td> </tr>
+        <tr>                                                                                                             <td>QIN12</td>    <td>Rondelle M6</td>                <td>16</td> </tr>
+        <tr>                                                                                                             <td>QIN06</td>    <td>Écrou M6</td>                   <td>12</td> </tr>
+        <tr>                                                                                                             <td>QIN35</td>    <td>Vis  M6 35mm</td>               <td>8 </td> </tr>
+        <tr>                                                                                                             <td>QIN23</td>    <td>Ecrou papillon M6</td>          <td>4 </td> </tr>
+        <tr>                                                                                                             <td>CHO05</td>    <td>Equerre</td>                    <td>2 </td> </tr>
+        <tr> <td><img alt="Photo des deux cales" src="_images/cale_siege.jpg" style="width: 200px;"/></td>               <td>CHO02</td>    <td>Cale</td>                       <td>2 </td> </tr>
+        <tr> <td><img alt="Photo de la poignée" src="_images/poignee_siege.jpg" style="width: 200px;"/></td>             <td>T23  </td>    <td>Poignée</td>                    <td>1 </td> </tr>
+        <tr> <td></td>                                                                                                   <td>QIN07</td>    <td>Embout de tube carré</td>       <td>2 </td> </tr>
+    </tbody>
+</table>
+
+<!-- this is just hack to reference images so that they are copied to the build folder -->
+<img class="hidden" src="img/assise_siege.jpg" width="200px"/>
+<img class="hidden" src="img/dossier_siege.jpg" width="200px"/>
+<img class="hidden" src="img/galets_siege.jpg" width="200px"/>
+<img class="hidden" src="img/pieces_siege.jpg" width="200px"/>
+<img class="hidden" src="img/cale_siege.jpg" width="200px"/>
+<img class="hidden" src="img/poignee_siege.jpg" width="200px"/>
+
+## Assemblage
+
+Temps : 1/2 journée pour les deux sièges
+
+### Bouchons de tubes
+
+Insérer les bouchons de terminaison pour fermer tous les tubes de l'assise et du dossier.
+
+### Montage du dossier
+
+Outils : 2 clés de 10
+
+Pièces : 2 équerres (CHO5b), 8 vis (QIN35), 8 rondelles (QIN12), 4 écrous frein (QIN06), 4 écrous papillons (QIN23)
+
+Les écrous papillons sont à utiliser pour fixer le dossier. Ils permettront de rabattre facilement le dossier : il faudra desserer ceux du bas, retirer ceux du haut, et le dossier peut alors pivoter.
+
+:::{note}
+Les équerres se positionnent avec le côté arrondi en bas.
+
+![Photo du bon positionnement des équerres](img/position_equerre_siege.jpg)
+:::
+
+![Photo du siège assemblé](img/siege_assemble.jpg)
+
+### Garnissage
+
+La résistance et le confort de l'assise sont assurés par la mise en place d’un maillage de chambres à air usagées (que vous pouvez vous procurer facilement auprès d’un club de cyclotourisme local ou d’un vendeur de cycle). Il faut environ 5 chambres à air par siège. Contrairement à ce qui apparait sur certaines photos, il n'est pas nécessaire de mettre des chambres à air sur le dossier, la toile suffit.
+
+Les chambres à air sont à tisser après avoir assemblé le siège (assise + dossier) et avant la fixation à l’embase.
+
+Dans un premier temps, il faut couper les valves (avec des ciseaux) en retirant le moins possible de chambre à air (pour ne pas la fragiliser).
+Puis tisser les chambres à air en les prolongeant progressivement avec des nœuds.
+
+|Photo en cours de garnissage|Autre exemple|
+|------------|-------------|
+|<img src="img/siege-garnissage.png" alt="Garnissage et tissage des chambres à air sur le siège" width="400px">|<img src="img/siege-garniture-exemple-tissage.png" alt="Exemple de tissage des chambres à air sur le siège" width="400px">|
+
+Attention, s’il est nécessaire de tendre à chaque tour de tissage pour que la chambre à air ne puisse se déplacer ou se détendre, il ne faut pas serrer trop fort, car l’effet élastique cumulé, tour après tour, pourrait déformer les barres du siège. Trouver la juste mesure pendant l’opération en surveillant l’état des barres. Par la suite, la mise en oeuvre de la toile a tendance à rendre les chambres à air plus fermes qu’au moment du tressage.
+
+![Vue 3D en coupe d'un siège sur le châssis](img/vue_3d_siege_coupe.jpg)
+
+Superposer d’environ la moitié de la largeur de la chambre le tour précédent.
+
+Au passage d’une chambre à air à la suivante, veiller à caler le nœud sous l’assise pour que ce nœud ne gêne pas le confort de l’utilisateur.
+
+Il est confortable de prévoir quelques petites sections de chambre à air, pour pouvoir précouvrir les têtes de vis ou écrous au moment de les recouvrir par la « corde de chambre à air » pour amortir leur contact.
+
+Les chambres à air ne résistent pas aux rayons du soleil et doivent être recouvertes de tissus.
+
+:::{admonition} Attention
+:class: warning
+En cas d’absence de tissus, les chambres à air déteignent sur les vêtements au contact de la transpiration.
+:::
+
+![Découpe des chambres à air](img/decoupe_chambre_a_air_siege.jpg)
+![Tressage des chambres à air sur le siège](img/tressage_chambre_a_air_siege.jpg)
+
+### Fixer l'embase à l’assise du siège
+
+Outil : clé de 10
+
+Pièces : embase (CHO54), 2 U filetés longs (QIN52), 2 U filetés courts (QIN51), 2 cales (CHO02), 8 rondelles (QIN12)
+
+Les cales s’insèrent entre l’assise et l'embase côté avant du siège.
+Le côté arrière de l’assise du siège comporte 2 trous pour fixer le dossier.
+
+![Photo du montage de l'embase et de l'assise](img/montage_embase_assise_siege.jpg)
+
+Les 4 tiges en U permettent de solidariser l’assise avec l'embase. Utiliser les U longs du côté des cales.
+
+:::{note}
+Parfois les trous dans lesquels passent les U ne sont pas parfaitement espacés, il faut forcer un peu.
+:::
+
+Il est plus simple de serrer d’abord les cales.
+
+![Photo du montage des etriers](img/montage_etrier_siege.jpg)
+
+### Montage des 6 galets
+
+Avec un tournevis plat (fin). 
+
+<div class="avoid-break"></div>
+
+:::{admonition} Attention
+:class: warning
+Attention au filetage, si ça force essayer sur un autre trou.
+:::
+
+<div class="avoid-break"></div>
+
+![Photo des galets vissés sur l'embase](img/galets_siege.jpg)
+
+### Réglage des glissières
+
+Une crémaillère permet de maintenir les sièges. Elle est constituée de 2 pièces qui contiennent aussi les glissières dans lesquelles vont s’insérer les galets de l'embase.
+
+Lors du boulonnage de ces 2 glissières, il faut s’assurer qu'elles sont correctement positionnées. Les trous de fixation laissent de la marge pour régler le positionnement exact de chaque glissière. Il faut d'une part que les crans des crémaillères soient bien face à face, mais aussi que l'écartement des glissières soit adapté à celui des embases.
+
+Pour cela insérer une ou deux embases sur les glissières, et ajuster le positionnement des glissières jusqu'à avoir un bon coulissement, et un verrouillage facile dans les crans, puis serrer les boulons.
+
+![Photo positionnement siège dans les glissières](img/insertion_siege_glissiere.jpg)
+_Insertion d'un siège_
+
+### Poignée
+
+Pièces : Tube T23 (tube 10cm percé en 6 au milieu), vis M6 40mm (QIN40), écrou frein M6 (QIN06), 2 rondelles (QIN12), 2 bouchons carrés (QIN07).
+
+![Photo de la poignée](img/poignee_siege.jpg)
+
+### Habillage des toiles
+
+Poser les toiles et tendre au moyen de tout type de ficelle, lacet ou élastique (diamètre 2 à 3 mm environ). Longueur dossier 4m + 0,6 m, assise : 2,7 m + 1,5 m. En cas d’utilisation de ficelle non flexible, laisser du mou pour permettre un débattement des toiles accompagnant les chambres à air.
+
+Le laçage se fait de la même façon que des lacets d’une chaussure.
+
+Attention à la subtilité en haut du dossier (évite que la toile de dossier glisse avec le temps).
+
+Les patrons de chaque toile sont fournis dans le dossier « Plans par article – Pour fabrication/Plans par article - Textiles ». La réalisation des toiles est d’une technicité simple concernant la couture. Seule particularité : les œillets doivent être bien posés (une machine professionnelle est préférable) pour êtres résistants.
+
+<img src="img/photo_siege_dos.jpg" alt="Photo d'un siège démonté de dos" width="300px">
+
+## Sécurité
+
+Pour un siège passager, il est indispensable (encore plus pour les enfants) d’ajouter une ceinture de sécurité deux points à fixer sur le montant du siège.

source/110_accessoires.md

@@ -0,0 +1,27 @@
+# Accessoires
+
+## Bandes réfléchissantes
+
+Nous recommandons de mettre des bandes rouges sur toute la hauteur des montants arrière afin que le gabarit du vhéliotech soit bien visible de nuit pour un véhicule arrivant derrière. De même, placer des bandes oranges sur les côtés du montant arrière et de l'arceau avant (environ 30cm de long à chaque fois), et des bandes blanches sur la partie avant des arceaux (30cm de long de chaque côté).
+
+Lorsque les bandes sont collées sur les tubes, il faut les couper en deux dans le sens de la longueur pour obtenir une bande de 2.5cm de large.
+
+Il est également obligatoire de placer des réflecteurs oranges sur les roues avant (la roue arrière n'étant de toute façon pas visible sur le vhélio). À défaut de catadioptres prévus pour s'accrocher sur les rayons, il est également possible d'utiliser des morceaux de bande réfléchissante (environ 5 cm x 5 cm), à coller sur les jantes des roues avant.
+
+:::{admonition} Attention
+:class: warning
+Les bandes réfléchissantes sont un aspect essentiel de la sécurité du véhicule. Elles doivent impérativement être placées dès les premiers essais du véhicule.
+
+La législation impose à la fois des feux (avant et arrière), et des rétroréflecteurs (catadioptres). Des catadioptres sont généralement intégrés aux feux vélo. Les bandes QIN05, qui sont également des rétroréflecteurs, améliorent largement la visibilité du vhéliotech, aussi bien de jour que de nuit.
+:::
+
+## Ruban de guidon (guidoline)
+
+Enrouler un ruban de guidon (DIV02) à l’emplacement de vos mains (après montages des commandes de frein etc.) rendra l’utilisation du guidon plus agréable.
+Respecter le sens d’enroulage.
+[Tutoriel vidéo de la pose du ruban de guidon](https://www.youtube.com/watch?v=vEYhBR0ME8M)
+
+:::{note}
+En alternative au ruban de guidon, vous pouvez utiliser des poignées en mousse.
+Utilisez une eau savonneuse pour les enfiler sans difficulté.
+:::

source/120_tests_verifications.md

@@ -18,7 +18,27 @@ Prenez le vhélio en main progressivement, évitez de rouler trop vite au début
 ## Sécurité et réglementation
 
 Ne pas poser les pieds au sol pendant que le vhéliotech roule, le vhéliotech doit être immobilisé exclusivement avec les freins. Si un frein ne freine pas correctement, il serait très difficile et très dangereux de vouloir l’arrêter avec les pieds (qui passeraient sous le pont avant).
-La version motorisée ne peut être conduite qu’à partir de 14 ans.
+Les configurations avec moteur ne peut être conduite qu’à partir de 14 ans.
 Le bridage de l’assistance motorisée doit être réglé à 25 km/h maximum.
-Faire les premiers tours de roue sans assistance motorisée, puis monter progressivement les vitesses jusqu’à 5.
-À la différence d’un vélo, le vhéliotech permet d’embarquer des passagers. La conduite avec des passagers doit être plus prudente que lorsque nous sommes seuls.
+Faire les premiers tours de roue sans assistance motorisée, puis monter progressivement la puissance du moteur jusqu’à 5.
+
+À la différence d’un vélo, le vhéliotech permet d’embarquer des passagers. La conduite avec des passagers doit être plus prudente que lorsque nous sommes seuls.
+
+:::{admonition} Attention
+:class: warning
+En cas de déraillement, couper le moteur avant d'intervenir sur la chaîne.
+:::
+
+Ne pas laisser les clés sur le véhicule à l'arrêt (peut être mis en fonctionnement de façon non volontaire par des enfants qui tourneraient les pédales).
+
+Veillez à bien serrer le frein parking avant de descendre et ne pas laisser l'engin non calé, orienté dans une pente en marche avant ou arrière.
+
+Ne pas laisser un enfant sur le vhéliotech stationné sans conducteur.
+
+## Recentrage des roues
+
+Après un certain temps d’utilisation (habituellement, 50-100 km de course) les roues peuvent se décentrer et se voiler. Il est nécessaire alors de resserrer les rayons. Ce relâchement des rayons est un problème inévitable, inhérent aux mouvements mécaniques, contre lequel vous devez agir afin d’assurer votre sécurité et votre confort. Cela contribue également à assurer la longévité de votre roue.
+
+## Notice d'utilisation
+
+Après le motage d'un vhéliotech, il est fortement recommandé de lire la notice d'utilisation qui donne des informations liées à la sécurité d'utilisation (notamment avec les enfants).

source/_static/custom.css

@@ -0,0 +1,50 @@
+.document-title {
+  width: 100%;
+  color: #fbbb15;
+  text-align: center;
+  font-size: 5em !important;
+  border-top: 2px solid black;
+  border-bottom: 2px solid black;
+  line-height: 1.2;
+  font-weight: bold;
+}
+
+.document-subtitle {
+  text-align: center;
+  font-size: 1.5em;
+  margin-top: 30px;
+  margin-bottom: 30px;
+}
+
+.title-page-footer {
+  text-align: center;
+  font-size: 1.2em !important;
+  margin-top: 30px;
+}
+
+/* displayed as a title, but doesn't count in numbering and doesn't appear in TOC */
+.fake-title {
+  font-weight: 700;
+  font-size: 175% !important;
+  font-family: Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;
+  break-before: always;
+}
+
+/* hide this title, we don't want to display it, it's only there to give a title to the page */
+section#guide-de-montage h1 {
+  display: none;
+}
+
+/* hide title numbers after h2 */
+h3 span.section-number, h4 span.section-number, h5 span.section-number, h6 span.section-number {
+	display: none;
+}
+
+.rst-downloads {
+	padding: 12px;
+	padding-top: 0;
+}
+
+.rst-downloads a {
+	color: #fcfcfc;
+}

source/_static/html-version.css

@@ -0,0 +1,3 @@
+.pdf-only {
+	display: none;
+}

source/_templates/page.html

@@ -0,0 +1,18 @@
+{% extends "!page.html" %}
+{% block body %}
+{% if current_version and latest_version and current_version != latest_version %}
+<div class="warning admonition">
+	<p class="admonition-title">Attention</p>
+	<p>
+		{% if current_version.is_released %}
+		Ceci est une ancienne version de la documentation.
+		La dernière version est la <a href="{{ vpathto(latest_version.name) }}">{{latest_version.name}}</a>.
+		{% else %}
+		Ceci est une version en cours de développement.
+		La dernière version stable est la <a href="{{ vpathto(latest_version.name) }}">{{latest_version.name}}</a>.
+		{% endif %}
+	</p>
+</div>
+{% endif %}
+{{ super() }}
+{% endblock %}

source/_templates/versions.html

@@ -0,0 +1,33 @@
+{%- if current_version %}
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
+  <span class="rst-current-version" data-toggle="rst-current-version">
+    <span class="fa fa-book"> Autres versions</span>
+      {{ current_version.name }}
+    <span class="fa fa-caret-down"></span>
+  </span>
+  <div class="rst-other-versions">
+    {%- if versions.tags %}
+    <dl>
+      <dt>Versions</dt>
+      {%- for item in versions.tags %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+    {%- if versions.branches %}
+    <dl>
+      <dt>Branches</dt>
+      {%- for item in versions.branches %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+  </div>
+  
+  {%- if current_version_data.pdf_url %}
+  <div class="rst-downloads">
+      <a href="{{current_version_data.pdf_url}}"><span class="fa fa-download"> Télécharger au format PDF</a></span>
+  </div>
+  {% endif %}
+</div>
+{%- endif %}

source/accessoires.md

@@ -1,13 +0,0 @@
-# Accessoires
-
-## Bandes réfléchissantes
-
-À coller sur les tubes, partie blanche devant, jaune sur les côtés, rouge derrière (QIN05).
-
-2 bandes (environ 5 cm x 5 cm) à coller sur les jantes des roues avant. Ces bandes donnent un effet dynamique la nuit quand le vhéliotech roule (ce qui améliore la visibilité).
-
-## Ruban de guidon (guidoline)
-
-Enrouler un ruban de guidon (DIV02) à l’emplacement de vos mains (après montages des commandes de frein etc.) rendra l’utilisation du guidon plus agréable.
-Respecter le sens d’enroulage.
-Tutoriel vidéo de la pose du ruban de guidon : https://www.youtube.com/watch?v=vEYhBR0ME8M

source/assemblage_chassis_toit.md

@@ -1,183 +0,0 @@
-# Assemblage du châssis et du toit
-
-Nous vous rappelons que les écrous-freins (type « nylstop ») ne sont pas prévus pour être démontés et remontés ; ils doivent être remplacés par un écrou neuf le cas échéant.
-Tous les écrous et vis doivent être serrés suffisamment fort, mais prenez garde aux tubes carrés en aluminium qui vont s’écraser si vous serrez trop fort. Vérifiez que votre serrage ne provoque pas de déformation visible. Selon nos essais, il faut approcher l’écrou jusqu’au contact, puis faire encore un demi-tour.
-
-:::{figure-md}
-
-<img src="img/tube_deforme.jpg" alt="Photo de tube deformé" width="200px">
-
-Exemple de tube déformé par un serrage excessif
-:::
-
-Certains tubes qui doivent absorber des efforts plus importants doivent être munis d’entretoises (tel qu’indiqué dans le plan). Vous pourrez alors serrer plus fort.
-
-Les quantités indiquées dans la nomenclature pour la quincaillerie sont parfois légèrement en excès de ce qui est réellement utile. Ne soyez donc pas surpris s’il vous reste un écrou à la fin du montage !
-
-Le cadre est constitué de tube aluminium 25 mm x 25 mm x 2 mm d’épaisseur. Il faut compter environ 40 mètres de tubes pour la version intégrale.
-
-Pour simplifier l’assemblage, des standards d’assemblage ont été définis :
-
-**Assemblage de 2 tôles**
-vis M6 14 mm (QIN14)
-rondelle M6 côté écrou (QIN12)
-écrou M6 (QIN09)
-
-```{image} img/assemblage_2_toles.png
-:alt: Assemblage 2 tôles
-:align: right
-```
-
-**Assemblage d’un tube et d’une tôle**
-vis M6 45 mm (QIN45)
-rondelle M6 pour la tête de vis ou écrou contre un tube ; inutile côté tête de vis si celle-ci vient contre une tôle inox (QIN12)
-écrou M6 (QIN09)
-
-![Assemblage tube tôle](img/assemblage_tube_tole.png)
-
-**Assemblage de 2 tubes**
-vis M6 60 mm (QIN60)
-rondelle M6 pour la tête de vis ou écrou contre un tube ; inutile côté tête de vis si celle-ci vient contre une tôle inox (QIN12)
-écrou M6 (QIN09)
-
-![Assemblage 2 tubes](img/assemblage_2_tubes.png)
-
-**Assemblage de 3 tubes**
-vis M6 90 mm (QIN90)
-rondelle M6 pour la tête de vis ou écrou contre un tube ; inutile côté tête de vis si celle-ci vient contre une tôle inox (QIN12)
-écrou M6 (QIN09)
-
-![Assemblage 3 tubes](img/assemblage_3_tubes.png)
-
-## Assemblage de la structure en tubes
-
-### Étape 1
-
-![Vue de l'étape 1](img/assemblage_etape_1.svg)
-
-### Étape 2
-
-![Vue de l'étape 2](img/assemblage_etape_2.svg)
-
-### Étape 3
-
-![Vue de l'étape 3](img/assemblage_etape_3.svg)
-
-### Étape 4
-
-À partir de cette étape, vous pouvez surélever le châssis en le posant sur des caisses, pour travailler plus confortablement.
-
-![Vue de l'étape 4](img/assemblage_etape_4.svg)
-
-### Étape 5
-
-![Vue de l'étape 5](img/assemblage_etape_5.svg)
-
-### Étape 6
-
-![Vue de l'étape 6](img/assemblage_etape_6.svg)
-
-### Étape 7
-
-![Vue de l'étape 7](img/assemblage_etape_7.svg)
-
-### Étape 8
-
-![Vue de l'étape 8](img/assemblage_etape_8.svg)
-
-### Étape 9
-
-![Vue de l'étape 9](img/assemblage_etape_9.svg)
-
-### Étape 10
-
-![Vue de l'étape 10](img/assemblage_etape_10.svg)
-
-### Étape 11
-
-![Vue de l'étape 11](img/assemblage_etape_11.svg)
-
-### Étape 12
-
-![Vue de l'étape 12](img/assemblage_etape_12.svg)
-
-### Étape 13
-
-![Vue de l'étape 13](img/assemblage_etape_13.svg)
-
-### Étape 14
-
-![Vue de l'étape 14](img/assemblage_etape_14.svg)
-
-### Étape 15
-
-![Vue de l'étape 15](img/assemblage_etape_15.svg)
-
-### Étape 16
-
-![Vue de l'étape 16](img/assemblage_etape_16.svg)
-
-### Étape 17
-
-Si vous aviez surélevé le châssis, vous pouvez maintenant le redescendre au niveau du sol pour faciliter l’installation du toit.
-
-![Vue de l'étape 17](img/assemblage_etape_17.svg)
-
-### Étape 18
-
-![Vue de l'étape 18](img/assemblage_etape_18.svg)
-
-### Étape 19
-
-![Vue de l'étape 19](img/assemblage_etape_19.svg)
-
-### Étape 20
-
-![Vue de l'étape 20](img/assemblage_etape_20.svg)
-
-## Montage de la direction
-
-Certains tubes sont masqués pour une meilleure lisibilité
-
-### Fixer CHO45 et T16
-
-![Vue de la fixation de CH045 et T16](img/fixer_ch045_t16.png)
-
-### Placer CHO44 sur son axe de rotation
-
-Utilisez la rondelle à trou carré directement sous la plaque CHO45, puis un roulement, puis une entretoise. Le deuxième roulement se place entre la potence CHO44 et la traverse T16. Fixer aussi les plaques CHO46. Contrairement à ce qui est indiqué sur le dessin, nous recommandons de placer un écrou classique + un contre-écrou « nylstop » afin de pouvoir les serrer l’un contre l’autre pour éviter tout risque de desserrement avec les vibrations, sans pour autant serrer excessivement les roulements. Commencer par serrer le premier écrou, mais pas trop fort pour ne pas gêner la rotation de la potence. Maintenir ensuite cet écrou avec une clé plate, et serrer le second écrou contre lui.
-
-<img src="img/vue_3d_ch045.png" alt="Vue 3D CH045" width="400px">
-<img src="img/vue_coupe_ch045.png" alt="Vue coupe CH045" width="300px">
-
-### Placer les deux CHO47 sur leurs axes de rotation
-
-Utiliser 4 roulements en tout, directement au-dessus et au-dessous des CHO47. Placez des entretoises dans les traverses T11, T12 et T13 afin d’éviter qu’elles ne s’écrasent lors du serrage. Contrairement à ce qui est indiqué sur le dessin, nous recommandons de placer un écrou classique et de le serrer modérément afin de ne pas écraser les roulements, puis un contre-écrou « nylstop » qu’il faudra serrer contre le premier écrou (en l’empêchant de tourner pendant le serrage avec une seconde clé plate). Ceci afin d’éviter tout risque de desserrement avec les vibrations, sans pour autant serrer excessivement les roulements. Finalement, monter les biellettes T18. Là aussi, utilisez deux écrous à chaque articulation (elles supportent peu d’efforts et n’ont donc pas de roulement, serrez les écrous l’un contre l’autre, mais ne serrez pas les pièces entre elles pour ne pas gêner la rotation).
-
-<img src="img/vue_3d_ch047.png" alt="Vue 3D CH047" width="400px">
-<img src="img/vue_coupe_ch047.png" alt="Vue coupe CH047" width="300px">
-
-### Fixer le guidon CHO04
-
-Utiliser le support CHO38 et les vis en U CHO06. L’inclinaison du guidon sera à ajuster après le placement du siège pour une position de conduite confortable (légèrement penché vers l’avant). Il faudra alors serrer fermement les 4 écrous pour bloquer son inclinaison.
-
-![Vue 3D CH004](img/vue_3d_ch004.png)
-
-## Montage des tôles
-
-Les tôles peuvent être assemblées par boulonnage (M4 ou M6) ou vis à tôle (QIN20) selon l’accessibilité. Attention les vis à tôle ne doivent pas êtres serrées trop fort.
-
-![Photo d'une vis QIN20](img/qin20.png)
-
-Les parties saillantes des tôles doivent êtres recouvertes de joints bord de tôle (DIV02).
-Un joint bord de tôle doit être posé à l’avant du panneau solaire. Ce joint limite les coulures d’eau de pluie sur le conducteur. Le ressaut faisant office de rigole n’est pas très haut, mais nous n’avons pas trouvé de référence plus satisfaisante à ce stade.
-
-![Photo d'un joint DIV02](img/div02.png)
-
-## Pose du panneau solaire
-
-Cette opération doit se faire à la fin du montage (afin de ne pas gêner la manipulation du vhéliotech) et ne pas dégrader le panneau.
-Prépositionner le panneau et vérifier les dimensions et l’équerrage des tubes (en exagérant, il ne faut pas que la structure forme un losange, sinon ajuster au moyen d’une sangle à cliquet.
-Nettoyer la surface inférieure du panneau et les tubes.
-Mettre un filet de silicone (translucide et résistant aux intempéries) sur la structure. Poser le panneau (opération à faire à 2 personnes). Mettre du poids sur le panneau aux endroits collés. Attendre une nuit pour retirer le poids.
-Passer ensuite le fil dans la structure aluminium.

source/conf.py

@@ -1,13 +1,17 @@
-# Configuration file for the Sphinx documentation builder.
+# Configuration file for the Sphinx documentation builder.
+
+import sys, os
+
+sys.path.append(os.path.abspath('exts'))
 
 # -- Project information
 
-project = 'Vheliotech'
-copyright = '2022, Velo solaire pour tous'
-author = 'Velo solaire pour tous'
+project = 'Guide de montage Vhéliotech'
+copyright = '2023, Vélo solaire pour tous'
+author = 'Association Vélo Solaire Pour Tous'
 
-release = '1.0'
-version = '1.0.0'
+html_context = dict()
+html_context['version'] = 'test'
 
 # -- General configuration
 
@@ -19,6 +23,9 @@ extensions = [
     'sphinx.ext.intersphinx',
     'myst_parser',
     'sphinxcontrib.inkscapeconverter',
+    'sphinx_multiversion',
+    'rtd_current_version',
+    'version_data'
 ]
 
 myst_enable_extensions = [
@@ -48,6 +55,19 @@ templates_path = ['_templates']
 # -- Options for HTML output
 
 html_theme = 'sphinx_rtd_theme'
+html_title = 'Vhéliotech'
+html_static_path = ['_static']
+html_css_files = [
+    'custom.css',
+    'html-version.css'
+]
+
+html_theme_options = {
+    'display_version': True
+}
 
-# -- Options for EPUB output
-epub_show_urls = 'footnote'
+# sphinx-multiversion settings
+smv_branch_whitelist = r'^main$'
+smv_tag_whitelist = r'^v[\d\.]+$'
+smv_released_pattern = r'.*tags/v[\d\.]+'
+smv_latest_version = 'v0.01'

source/css/print-theme.css

@@ -0,0 +1,85 @@
+.wy-grid-for-nav {
+  position: static !important;
+}
+
+@page {
+  @bottom-left {
+    content: "Guide de montage - v1.0.0 - Mai 2023";
+    font-size: 9px;
+    font-family: Lato, proxima-nova, Helvetica Neue, Arial, sans-serif;
+  }
+  @bottom-center {
+    content: "vhelio.org                               Besoin d'aide ? communaute.vhelio.org";
+    font-size: 9px;
+    font-family: Lato, proxima-nova, Helvetica Neue, Arial, sans-serif;
+    white-space: pre;
+  }
+  @bottom-right {
+    content: counter(page) "/81"; /* total number of pages is automatically updated by count_pdf_pages.py */
+    font-size: 9px;
+    font-family: Lato, proxima-nova, Helvetica Neue, Arial, sans-serif;
+  }
+
+  counter-increment: page;
+}
+
+@page :first {
+  counter-reset: page 2;
+  @bottom-left {
+    content: "";
+  }
+  @bottom-center {
+    content: "";
+  }
+  @bottom-right {
+    content: "";
+  }
+}
+
+.html-only {
+  display: none;
+}
+
+div[role=navigation], .headerlink {
+  display: none;
+}
+
+h1 {
+  break-before: always;
+}
+
+.avoid-break {
+  break-before: avoid;
+  break-after: avoid;
+}
+
+.avoid-break-next-block + ul {
+  break-inside: avoid;
+}
+
+.admonition {
+  break-inside: avoid;
+}
+
+.resized {
+  width: 550px;
+}
+
+/* Automatic title numbering */
+body {
+    counter-reset: h1
+}
+
+h1 {
+    counter-reset: h2
+}
+
+h1:before {
+    counter-increment: h1;
+    content: counter(h1) ". "
+}
+
+h2:before {
+    counter-increment: h2;
+    content: counter(h1) "." counter(h2) ". "
+}

source/current_version_data.py

@@ -0,0 +1 @@
+pdf_url = 'vheliotech-guide-de-montage.pdf'

source/documentation.md

@@ -1,19 +0,0 @@
-# Documentation
-En plus du guide de montage (que vous êtes en train de lire), plusieurs documents sont disponibles autour du vhéliotech. Vous en trouverez une présentation rapide dans cette section.
-## Plans 3D
-Les plans 3D sont disponibles sous différents formats. Il s’agit du même contenu à chaque fois, mais utilisable par différents logiciels :
-- PDF, que vous pouvez visualiser avec Adobe Acrobat Reader (logiciel gratuit installé sur la plupart des ordinateurs, les autres lecteurs PDF ne prennent généralement pas en charge l’affichage 3D). Un tutoriel sur la visualisation de ces plans sera publié prochainement sur le site internet.
-- STEP, utilisable par la plupart des logiciels de CAO (Conception Assistée par Ordinateur). Vous pouvez les visualiser par exemple avec edrawings (logiciel gratuit)
-- FCStd, pour utilisation avec FreeCAD (logiciel libre et gratuit)
-Ces plans sont particulièrement utiles pour observer des points de détail du vhéliotech ou si vous n’arrivez pas à vous représenter certaines parties, puisqu’il est possible de le voir sous tous les angles. Ils permettent également d’exporter des vues 2D ou 3D de l’assemblage ou de chaque pièce, par exemple avec FreeCAD, mais cela sort du périmètre du présent guide.
-
-## Nomenclature
-La nomenclature rassemble des informations sur toutes les pièces du vhéliotech : le code de la pièce, son nom, des liens vers des fournisseurs, etc. Les codes indiqués dans le présent guide de montage font référence à la nomenclature.
-
-```{image} img/codification_nomenclature.png
-:alt: Codification nomenclature
-:align: center
-```
-
-## Schéma électrique
-Le schéma électrique donne une vue d’ensemble de l’installation électrique, et sert de référence pour tous les branchements. Une procédure d’installation est également proposée dans le présent guide.

source/exts/rtd_current_version.py

@@ -0,0 +1,14 @@
+# This tiny sphinx extension will simply copy the current_version (generated by sphinx_multiversion) to the 'version' entry in html_context, so that it is correctly displayed by the ReadTheDocs template
+# You need to have the sphinx_multiversion extension as well
+
+def setup(app):
+	app.connect('config-inited', config_inited)
+	
+def config_inited(app, config):
+	app.connect('html-page-context', html_page_context)
+	
+def html_page_context(app, pagename, templatename, context, doctree):
+	try:
+		context['version'] = context['current_version'].name
+	except:
+		context['version'] = 'no_version_found'

source/exts/version_data.py

@@ -0,0 +1,21 @@
+# This module can read data from a python file in the source folder. This will read data from the version being built (as opposed to standard sphinx-multiversion behavior that executes python from the working copy)
+# All global variables defined in file current_version_data.py will be put in html_context['current_version_data'] which allows to use them in HTML templates.
+
+import sys
+
+current_version_data = {}
+
+def setup(app):
+	app.add_config_value("version_sourcedir", '', "html")
+	app.connect('config-inited', config_inited)
+
+def config_inited(app, config):
+	app.connect('html-page-context', html_page_context)
+	try:
+		exec(open(app.config.version_sourcedir + '/current_version_data.py').read(), globals(), current_version_data)
+	except:
+		print('No file current_version_data.py found')
+		pass
+	
+def html_page_context(app, pagename, templatename, context, doctree):
+	context['current_version_data'] = current_version_data