MastersThesis/.claude/commands/word-generation.md

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:

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:

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:

source .venv/bin/activate && python3 apply_content.py

Input:

• instructions/plantilla_individual.htm (UNIR template)
• docs/*.md (chapter content)
• thesis_output/figures/*.png (generated figures)

Output: thesis_output/plantilla_individual.htm

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:

# 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