Support for Offline HTML Rendering

[vgaliCelero]

Hi,

I'm using peakrdl-html to generate documentation from SystemRDL. However, the generated HTML includes external links to resources like Bootstrap and jQuery (e.g., via CDN). This causes the output to appear broken when opened on systems without internet access (like internal build servers and cadence chamber).

Is there a way to:

• Generate a fully self-contained HTML file with all CSS/JS embedded or bundled locally?
• Or optionally use local paths for resources?

Thanks in advance!
Vasu

[baljir0901]

Hey Vasu! 👋 Great question — I’ve run into similar issues when needing documentation to work offline on internal systems.

---

✅ Two approaches to fix this:

1. Generate a fully self-contained HTML file

You can try using a post-processing tool like:

• html-inline
• inline-source

These tools can take your generated HTML and automatically inline:

• CSS files
• JS scripts
• Even image assets (base64 encoded)

Run it like this:

npx inline-source input.html > output.html

This will give you a single .html file with no external dependencies — perfect for air-gapped systems.

---

2. Replace CDN links with local paths

If you're able to tweak the template or HTML generator config:

• Download the required files:
  • bootstrap.min.css
  • bootstrap.bundle.min.js
  • jquery.min.js
• Place them in a local assets/ folder
• Update the HTML to reference:

<link rel="stylesheet" href="assets/bootstrap.min.css" />
<script src="assets/jquery.min.js"></script>
<script src="assets/bootstrap.bundle.min.js"></script>

This method works great if you’re serving the HTML through a static site or file browser in a local environment.

---

Let me know which route works better for your setup — happy to help with automation scripts if needed. Hope this helps you get fully offline-friendly HTML! 🚀

[vgaliCelero]

Hi Baljir, Thank you for the quick response! I'll try this.