ci: Integrate hardware docs processing into build_pdf workflow

- Add hardware/** paths to workflow triggers
- Install Jinja2 for hardware HTML generation
- Add hardware documentation cleaning and processing steps
- Use rsync to preserve hardware docs when copying Sphinx output
- Consolidate all documentation build steps into single workflow

Author: GitHub Actions

.github/workflows/build_pdf.yml

@@ -7,13 +7,15 @@ on:
       - 'software/documentation/**'
       - 'software/sphinx/**'
       - 'README.md'
+      - 'hardware/**'
       - '.github/workflows/build_pdf.yml'
   pull_request:
     branches: [main]
     paths:
       - 'software/documentation/**'
       - 'software/sphinx/**'
       - 'README.md'
+      - 'hardware/**'
   workflow_dispatch:
 
 permissions:
@@ -38,6 +40,7 @@ jobs:
         sudo apt-get install -y texlive-latex-extra texlive-fonts-recommended texlive-lang-english ghostscript latexmk
         pip install -r software/documentation/requirements.txt
         pip install -r software/sphinx/requirements.txt
+        pip install Jinja2
 
     #################################################
     # Generar PDF del Product Brief con nombre del repo
@@ -53,6 +56,19 @@ jobs:
            -dNOPAUSE -dQUIET -dBATCH \
            -sOutputFile=build/${REPO_NAME}_product_brief.pdf build/*.pdf
 
+    #################################################
+    # Procesar Documentación de Hardware
+    #################################################
+    - name: Clean previous hardware documentation
+      run: |
+        chmod +x .github/workflows/scripts/clean_docs.sh
+        .github/workflows/scripts/clean_docs.sh
+
+    - name: Copy hardware files and generate HTML
+      run: |
+        chmod +x .github/workflows/scripts/build_docs.sh
+        .github/workflows/scripts/build_docs.sh
+
     #################################################
     # Generar Documentación Sphinx (HTML + PDF)
     #################################################
@@ -62,14 +78,19 @@ jobs:
         make clean
         make pdfx
 
+    - name: Add hardware link to Sphinx docs
+      run: |
+        chmod +x .github/workflows/scripts/add_hardware_link.sh
+        .github/workflows/scripts/add_hardware_link.sh
+
     #################################################
     # Preparar contenido para docs/
     #################################################
     - name: Prepare docs/ directory
       env:
         REPO_NAME: ${{ github.event.repository.name }}
       run: |
-        rm -rf docs
+        # Crear directorio docs si no existe (pero no eliminar hardware/)
         mkdir -p docs
 
         # PDF generado desde LaTeX
@@ -78,8 +99,8 @@ jobs:
         # PDF generado por Sphinx
         cp software/sphinx/pdf/programmer.pdf docs/${REPO_NAME}_sphinx.pdf
 
-        # HTML generado por Sphinx
-        cp -r software/sphinx/docs/* docs/
+        # HTML generado por Sphinx (copiar archivos, no sobrescribir hardware/)
+        rsync -av --exclude='hardware' --exclude='hardware.html' software/sphinx/docs/ docs/
 
         # Permitir archivos especiales en GitHub Pages
         touch docs/.nojekyll

hardware/README.md

@@ -3,7 +3,7 @@
 <div align="center">
 
 <a href="/hardware/unit_sch_V_0_0_1_ue0090_CH552_USB_Multi-Protocol-Programmer.pdf">
-  <img src="resources/Schematics_icon.jpg?raw=false" width="500px">
+  <img src="resources/Schematics_icon.jpg?raw=false" width="300px">
   <br/> 
   Schematics
 </a>
@@ -119,6 +119,9 @@
 
 ### IDC-10 JST Header Pinout
 
+<div align="center">
+
+
 | PIN | GPIO | Signal | Description |
 |:---:|:----:|:------:|:-----------|
 | 1   | 1.7  | SWCLK  | SWD Clock / MOSI |
@@ -131,13 +134,14 @@
 | 8   | 3.0  | RXD    | RXD (Optional) |
 | 9   | 1.5  | MOSI   | MOSI (Optional) |
 
+</div >
 
 # Board Topology
 
 <div align="center">
 
 <a href="#">
-  <img src="./resources/unit_topology_V_0_0_1_ue0090_CH552_USB_Multi-Protocol-Programmer.png" width="500px">
+  <img src="./resources/unit_topology_V_0_0_1_ue0090_CH552_USB_Multi-Protocol-Programmer.png" width="900px">
   <br/>
   Topology
 </a>