arc42-generator icon indicating copy to clipboard operation
arc42-generator copied to clipboard

Fix build issues: missing pandoc dependency and Italian template version

Open Copilot opened this issue 7 months ago • 0 comments

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 IT attribute
  • Updated submodule reference to include the Italian template fix

Verification

✅ Successfully tested complete build process:

  1. git submodule update --init
  2. ./gradlew createTemplatesFromGoldenMaster
  3. ./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:


💡 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.

Copilot avatar Jul 15 '25 09:07 Copilot