All checks were successful
build_docker / build_gpu (pull_request) Successful in 21m38s
build_docker / build_easyocr (pull_request) Successful in 16m11s
build_docker / build_easyocr_gpu (pull_request) Successful in 18m38s
build_docker / build_doctr (pull_request) Successful in 18m47s
build_docker / build_raytune (pull_request) Successful in 2m38s
build_docker / build_doctr_gpu (pull_request) Successful in 16m15s
build_docker / build_cpu (pull_request) Successful in 4m38s
build_docker / essential (pull_request) Successful in 0s
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
Generate the Word document for this Master's Thesis project.
|
|
|
|
## Instructions
|
|
|
|
Execute the TFM document generation pipeline in order:
|
|
|
|
### Step 0: Clean Up Previous Output
|
|
|
|
Remove the entire thesis_output folder to ensure a fresh build:
|
|
```bash
|
|
rm -rf thesis_output && mkdir -p thesis_output/figures
|
|
```
|
|
|
|
### Step 1: Generate Figures from Mermaid Diagrams
|
|
|
|
Run the figure generation script using the virtual environment:
|
|
```bash
|
|
source .venv/bin/activate && python3 generate_mermaid_figures.py
|
|
```
|
|
|
|
**Input:** Mermaid code blocks from `docs/*.md`
|
|
**Output:** `thesis_output/figures/figura_*.png` and `figures_manifest.json`
|
|
|
|
### Step 2: Apply Content to UNIR Template
|
|
|
|
Run the content application script using the virtual environment:
|
|
```bash
|
|
source .venv/bin/activate && python3 apply_content.py
|
|
```
|
|
|
|
**Input:**
|
|
- `instructions/plantilla_individual.htm` (UNIR template)
|
|
- `instructions/plantilla_individual_files/` (template support files)
|
|
- `docs/*.md` (chapter content)
|
|
- `thesis_output/figures/*.png` (generated figures)
|
|
|
|
**Output:** `thesis_output/` (htm + support files + figures)
|
|
|
|
### Step 3: Report Results
|
|
|
|
After successful execution, provide:
|
|
1. Number of figures generated
|
|
2. Number of tables formatted
|
|
3. Path to output file
|
|
4. Instructions for Word finalization:
|
|
- Open `thesis_output/plantilla_individual.htm` in Microsoft Word
|
|
- Press Ctrl+A then F9 to update all indices (contents, figures, tables)
|
|
- Adjust image sizes if needed (select image → right-click → Size and Position)
|
|
- Save as `.docx`
|
|
|
|
### Prerequisites
|
|
|
|
If scripts fail, check that dependencies are installed:
|
|
```bash
|
|
# Python dependencies (in .venv)
|
|
source .venv/bin/activate && pip install beautifulsoup4
|
|
|
|
# Mermaid CLI for figure generation
|
|
npm install @mermaid-js/mermaid-cli
|
|
```
|
|
|
|
### Error Handling
|
|
|
|
- If `generate_mermaid_figures.py` fails: Check mmdc (mermaid-cli) is installed
|
|
- If `apply_content.py` fails: Check beautifulsoup4 is installed
|
|
- Report any errors with the specific step that failed
|