Fix build issues: missing pandoc dependency and Italian template version
This PR addresses several build issues that were preventing successful generation of arc42 templates:
Issues Fixed
1. Missing Pandoc Dependency
The build was failing with "command 'pandoc' not found" errors. Added clearer documentation about the pandoc prerequisite in the README with installation instructions for different platforms.
2. Italian Template Version Issue
The Italian template was showing "version unspecified" instead of the expected version number because it was missing the :revnumber: attribute. Added :revnumber: 8.2 IT to match other language templates.
Before:
<span id="revnumber">version unspecified</span>
After:
<span id="revnumber">version 8.2 IT</span>
Changes Made
- README.adoc: Added prominent prerequisite section mentioning pandoc installation before build steps
-
arc42-template/IT/asciidoc/arc42-template.adoc: Added missing
:revnumber: 8.2 ITattribute - Updated submodule reference to include the Italian template fix
Verification
✅ Successfully tested complete build process:
-
git submodule update --init -
./gradlew createTemplatesFromGoldenMaster -
./gradlew arc42
✅ Verified version numbers appear correctly in all output formats (HTML, DOCX, etc.) ✅ Italian template now shows "version 8.2 IT" instead of "version unspecified" ✅ Other language templates continue to work correctly
Note: The Italian template change requires the arc42-template submodule to be updated. The fix has been committed locally but needs to be pushed to the arc42-template repository by someone with write access.
Fixes #52.
[!WARNING]
Firewall rules blocked me from connecting to one or more addresses
I tried to connect to the following addresses, but was blocked by firewall rules:
esm.ubuntu.com
- Triggering command:
/usr/lib/apt/methods/https(dns block)If you need me to access, download, or install something from one of these locations, you can either:
- Configure Actions setup steps to set up my environment, which run before the firewall is enabled
- Add the appropriate URLs or hosts to my firewall allow list
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.