External rendering scripts for Gitea

These scripts attempt to render several documents so viewing them in Gitea is actually informative. Most are a work in progress. As some files can take a very long time to render, caching is used by leaving the generated images in the Gitea custom assets directory (if present and writable). You'd probably want to clean that out now and then.

List of renderers:

• LibreOffice
• KiCad

TODO:

• 3D models (STL, STEP, etc)
• Gerber files

Example

See the KiCad schematic renderer in action here:

https://git.rbts.co/kicad/StepperDriverModuleCarrier/src/branch/main/StepperDriverModuleCarrier.kicad_sch

Prerequists

The KiCad renderers assume KiCad (9 or newer) is installed. They also need Inkscape (to properly fit the images). Libreoffice is required for the LO renderers.

The SVG Pan & Zoom library is loaded from a CDN.

mktemp is used to create a temporary directory.

Installation & Configuration

1. Link the scripts in some place Gitea can execute them
2. Add the content of the .ini files to your app.ini file
3. Edit the new script path entries in app.ini to match your system
4. Copy / merge the contents of the custom dir with the custom dir in your Gitea root

Repo and License

Feel free to copy and share this under the terms of the Apache 2.0 license. Original author: Stefan Hamminga stefan@rbts.co Original repo: https://git.rbts.co/rbts.co/gitea_external_renderers