present documentation

The documentation is made with mardown and .org files. We need to convert those files into a public documentation.

.org files are really versatile and can export to many other formats.

pdf

using LaTeX or postscript

html

with different exporting options

html reveal

mainly using reveal.js with reveal_custom.css

html slides

my custom scripts slide.js and slide.css

This file will be outputted as blog post or slides.

Blender has its own scripting tab but it doesn’t fit in my workflow where I use python REPL and LLMs to test the commands. Blender has an addon called blender-mcp which allows to access blender methods from outside. So I need to run the mcp server with transport http:

cd ~/lav/src/blender_twin/deploy/mcp_client/
#bash ./blender_local_client.sh &
cd $HOME/lav/src/blender_twin/deploy/mcp_client/blender_mcp_example_code/mcp/blmcp/ 
#python3 -m blmcp
uv --directory $HOME/lav/src/blender_twin/deploy/mcp_client/blender_mcp_example_code/mcp run blender-mcp --transport http --port 9191 &

I then need a container as defined in docker_compose.yml to create a bridge between the host and the containers within docker network.

blender-mcp-bridge:
  image: alpine/socat:latest
  container_name: blender-mcp-bridge
  network_mode: "host"
  command: TCP-LISTEN:19191,fork,reuseaddr TCP:127.0.0.1:9191
  restart: unless-stopped

I can then work on a script create_animation.py or let an LLM test the blender code without exiting the container.

Mermaid produces svg files which are loaded in blender apart from text which is not recognized. For that we created a script text2svg.py to load each text tag, load a font and create a path around that text. We apply as well some grouping logic so the import in blender is smoother.

cd ~/lav/src/spiega/script/
python3 text2svg.py ~/lav/siti/f/f_twin/arch_diagram.svg
mv output.svg ~/VideoProd/in_prog/graph/arch_dia.svg

File processed: /home/sabeiro/lav/siti/f/f_twin/arch_diagram.svgresults in output.svg

To speed up voice over we use some tools like

cd ~/VideoProd/in_prog/graph/
#pip install auto-editor
auto-editor 
mv output.svg ~/VideoProd/in_prog/graph/arch_dia.svg

We started with many tools and we tried to minimize the dependencies so over time I removed the dependencies from tools like `markdown` and `pandoc`. I rather use my own header and footer templates In emacs.el we define most of the configurations and load the libraries. In reveal_config.org we have the additional configurations for export.