feat(header.tex): adding style to pdfs

.build/generate_tutoriels.sh

@@ -4,6 +4,6 @@ mkdir -p out
 cd tutoriels
 
 for file in *.md; do
-    pandoc -f markdown-implicit_figures -V toc "$file" --include-in-header=../.build/template.tex -o "../out/${file%.md}.pdf"
+    pandoc -s -f markdown-implicit_figures "$file" -H ../.build/header.tex -o "../out/${file%.md}.pdf"
     echo "Generated ${file%.md}.pdf"
 done

.build/header.tex

@@ -0,0 +1,46 @@
+\usepackage{geometry}
+\usepackage{titlesec}
+
+\definecolor{main}{RGB}{0, 0, 0}
+\definecolor{highlight}{RGB}{255, 80, 0}
+\definecolor{sechighlight}{RGB}{200, 150, 0}
+\definecolor{bgcolor}{RGB}{230, 230, 230}
+
+% reduce margin size
+\geometry{margin=2cm}
+
+% Text highlight color (backtick)
+\let\oldtexttt\texttt
+\renewcommand{\texttt}[1]{%
+    \colorbox{bgcolor}{\color{highlight}\oldtexttt{#1}}
+}
+
+% Sections title color
+\titleformat{\section}
+    {\normalfont\Large\bfseries\color{sechighlight}}
+    {\thesection}{1em}{}
+
+\titleformat{\subsection}
+    {\normalfont\large\bfseries\color{sechighlight}}
+    {\thesubsection}{1em}{}
+
+\titleformat{\subsubsection}
+    {\normalfont\large\bfseries\color{sechighlight}}
+    {\thesubsection}{1em}{}
+
+% IncludeGraphics background color, center
+\let\oldincludegraphics\includegraphics
+\renewcommand{\includegraphics}[2][]{%
+    \begin{center}
+        \colorbox{bgcolor}{\oldincludegraphics[#1]{#2}}
+    \end{center}
+}
+
+% Code background color
+\let\oldverbatim\verbatim
+\renewcommand{\verbatim}{\colorbox{bgcolor}\oldverbatim}
+
+% Hypertext color and underline
+\hypersetup{colorlinks=true, linkcolor=highlight, urlcolor=highlight}
+\let\oldhref\href
+\renewcommand{\href}[2]{\oldhref{#1}{\underline{\color{highlight}#2}}}

.github/workflows/generator.yml

@@ -11,15 +11,15 @@ jobs:
   build-tutoriels:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Install pandoc
         run:
           sudo apt-get install pandoc && 
           sudo apt-get install texlive-latex-recommended
       - name: Convert to PDF
         run: ./.build/generate_tutoriels.sh
       - name: Upload out/ folder
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         with:
           name: tutoriels
           path: out/

tutoriels/cnc.md

@@ -53,10 +53,9 @@ Une fois sélectionnée, parametrez votre usinage avec le pannel de droite, puis
 On a ici un exemple de l'utilisation de `2d contour` avec l'option `Multiple Depths` (menu `Passes`) pour découper une pièce en plusieurs passes. Ainsi que l'option `Ramp` (menu `Linking`) pour éviter de "plonger" directement dans la matière. Cela permet de réduire l'usure de la fraise et les nuisances sonores. On peut ici apercevoir 6 depths de 2mm chacun (en bleu) et la `ramp` (en rouge).
 Des `tabs` ont été ajoutés pour éviter que la pièce ne se détache de la matière lors de la découpe. Cette option peut être trouver dans le menu `Geometry` de l'usinage.
 
-
-![Tabs](resources/cnc-tabs.png)
-![Ramp](resources/cnc-ramp.png)
 ![Multi passes](resources/cnc-multiplepasses.png)
+![Ramp](resources/cnc-ramp.png)
+![Tabs](resources/cnc-tabs.png)
 
 ## Exportation du G-Code
 

tutoriels/impression_3d_fdm.md

@@ -26,33 +26,34 @@ Voici quelques conseils:
 
 ### Un exemple de création d'objet
 
-
-
-
-
-
 ![image](resources/fusion360.png)
 On a ici deux pièces qui sont conçues pour être assemblées. Ici la pièce est séparé en deux pour faciliter l'impression à plat sans supports.
 
 ### Résultat
-À la fin de cette étape, on **exporte un fichier STL** (mesh 3D) pour pouvoir le slicing.
+À la fin de cette étape, on **exporte un fichier STL** (mesh 3D) pour le slicing.
 
 ## Slice
 
 Pour Slice, nous utilisons [Cura](https://ultimaker.com/software/ultimaker-cura/) (FOSS), il est installé sur le PC du lab. Commencez par importer votre modèle: `ctrl+o`, ensuite le placer sur la face qui semble la mieux comme base -> grosse surface plane ou alors un plan qui permet d'imprimer la piece avec le moins de supports possible.
 
-Il existe deux profils préconfigurés: un pour la d12 230 et un autre pour la d12 300, ils sont update de temps en temps sur le repo `https://github.com/Atelier-Epita/cura`.
+Il existe deux profils préconfigurés: un pour la d12 230 et un autre pour la d12 300, ils sont update de temps en temps sur le repo [https://github.com/Atelier-Epita/cura](https://github.com/Atelier-Epita/cura).
 Ces profils influent directement sur la qualité des impressions.
 Vous pouvez si vous le souhaitez creer votre propre profil en dupliquant un existant.
 
 Voici quelques parametres qui pourraient être interessant à modifier suivant vos besoin (bien sûr je vous invite a aller regarder la doc pour de plus ample déscriptions):
 
 - layer height -> dépends directement de la taille de la buse, en général correspond à la moitié de la taille de la buse.
+
 - line width -> largeur d'une ligne imprimé, dépends aussi de la taille de la buse, la plupart du temps elle correspond a peu pret à la largeur de la buse +/- 10%.
+
 - vitesse d'impression -> l'augmenter permet d'imprimer plus vite, mais peut réduire la qualité de l'impression, les vitesses d'impression sont dépendantes de la taille de la buse, en général les proiles par défaut sont plutôt conservateurs par rapport à la qualité d'impression.
+
 - infill density -> la densité des remplissages est importante si vous voulez faire des pièces où les contraintes sont importantes. Par défaut entre 15-20%, l'augmenter produira une pièce plus robuste mais demandera plus de temps a imprimer.
+
 - supports -> votre pièce contient-elle de grands overhangs ? si oui: mettez des supports. Il existe également des supports en forme de tree, c'est parfois interessant de les utiliser.
+
 - temperatures -> il y a deux températures que vous pouvez régler si jamais vous imprimer avec du filament autre que celui par défaut: la température de la buse et celle du plateau.
+
 - plate adhesion -> pour certaines pièces, il est fortement recommandé de rajouter un raft ou un brim, ces deux méthodes permettent d'éviter que la pièce "warp" (voir la section troubleshooting pour plus d'information) en augmentant la surface de contact avec le bed.
 
 ### Un exemple de slice
@@ -79,15 +80,18 @@ On peut distinguer 3 séctions dans le gcode:
 - print -> le gcode généré par le slicer pour imprimer votre pièce.
 - end gcode -> la séquence d'instruction de fin: refroidir la buse, le bed, lever la tête et la placer à l'origine.
 
-Vous pouvez si vous le souhaiter modifier les gcode de start et de fin dans le tab `settings>printer>manage printers>machine settings` de cura.
+Vous pouvez modifier les gcode de start et de fin dans le tab `settings -> printer -> manage printers -> machine settings` de cura.
 
 ## Troubleshooting
 
 Quelques problèmes courant et comment les fix dans la plupart des cas:
 
 - warping -> Lorsque qu'un bord ou une partie de la pièce ne tient plus sur le bed. Dans 50% des cas c'est dû au design de la pièce, dans le cas écheant, rajouter un brim devrait amplement suffire. dans les 50 autres pourcents restant, recalibrer le plateau peut être une option, néttoyer le plateau, ou alors tout simplement imprimer le premier layer plus lentement.
+
 - blobs -> Dû à une pression trop élevé dans la buse, des petits blobs se font apparaitre aux jointures lorsqu'une rétractation ou une pause a lieux. Pour réduire cet effet, on peut augmenter la distance de rétractation ou bien rajouter du coasting: relacher la pression de la buse avant chaque retraction en réduisant la vitesse d'extrusion.
+
 - stringing -> L'impression possède des fils entre les différentes parties de la pièce. C'est dû à une rétractation trop faible, augmenter la rétractation devrait régler le problème.
-lement suffire. dans les 50 autres pourcents restant, recalibrer le plateau peut être une option, néttoyer le plateau, ou alors tout simplement imprimer le premier layer plus lentement.
+  
 - blobs -> Dû à une pression trop élevé dans la buse, des petits blobs se font apparaitre aux jointures lorsqu'une rétractation ou une pause a lieux. Pour réduire cet effet, on peut augmenter la distance de rétractation ou bien rajouter du coasting: relacher la pression de la buse avant chaque retraction en réduisant la vitesse d'extrusion.
+
 - stringing -> L'impression possède des fils entre les différentes parties de la pièce. C'est dû à une rétractation trop faible, augmenter la rétractation devrait régler le problème.