{
  "markdown": "# Manual Build Guide\n\n## Prerequisites\n- Node.js 18+ (the repo is tested with Node 20.18.1)\n- npm (bundled with Node.js)\n- Network access to npm registry and the configured Kroki server\n\nOptional tools:\n- Python 3 (for local preview)\n\n> Run all commands from the repository root (`/home/maravelias/repos/car-rental-docs`).\n\n## 1. Install project dependencies\n\nInstall the Antora toolchain and supporting packages:\n\n```shell\nnpm install\n```\n\nIf you encounter network issues or partial installs, delete `node_modules` and retry the command.\n\n## 2. Generate the site\n\nFor a standard local build:\n\n```shell\nnpm run build:site\n```\n\nTo rebuild after intentionally refreshing external Antora assets, use:\n\n```shell\nnpm run build:site:fetch\n```\n\nThe build script compiles the custom Sass theme into `supplemental-ui/css/site.css` and then runs Antora.\nThe generated site is written to `./build/site`.\nThe playbook reads content from the currently checked out `HEAD`, so local documentation edits are included without committing to `master` first.\nThe deployment URL is configured in the playbook as `http://carrental-docs.nmlabs.gr`.\n\n## 3. Preview locally\n\n```shell\nnpm run preview\n```\n\nThen visit `http://localhost:8081` in your browser.\n\n## 4. Notes\n\n- The repository vendors the Antora UI bundle in `vendor/antora-ui-default.zip` so builds do not depend on downloading the default UI from GitLab on every run.\n- Kroki diagrams are fetched during the build because `kroki-fetch-diagram` is enabled. Local or CI builds therefore still need network access to `https://kroki.nmlabs.gr`.\n- The generated site now uses `http://carrental-docs.nmlabs.gr` as its published site URL for deployment metadata.\n",
  "bytes": 1694,
  "sha": "86b819a1a28b4f88f5556a7036f8f7123f2cb2d99e84369124c34a5cd432fc50",
  "repo_slug": "netmechanics/car-rental-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_netmechanics_car_rental_docs_openwiki_in_19196343/readme"
}