Replace VuePress with Zensical

[thunderbiscuit]

We've discussed migrating Zensical since we've been using it for the book of bdk. This PR will explore the viability of this migration.

Upside

• Much much faster builds
• Simpler setup (uv + Python versus Node/JS)

Downside

• Zensical doesn't currently offer a blog feature. This is not a big problem for us because (a) we don't actually host a very active blog (we retired it a while back) and the pages can simply be under an extra tab, and (b) they do plan on adding this feature to bring it up to parity with Material for MkDocs, which had a blog feature.

[netlify]

❌ Deploy Preview for awesome-golick-685c88 failed.

Name	Link
🔨 Latest commit	dc08f10
🔍 Latest deploy log	https://app.netlify.com/projects/awesome-golick-685c88/deploys/69a98eb734879b0008b2c98f

[thunderbiscuit]

You can build the website locally like so:

gh pr checkout 263
uv sync
uv run zensical serve

[thunderbiscuit]

I have added the blog posts, and used the opportunity to do a major cleanup (which is up for discussion).

There were 47 blog posts. I propose to remove the following:

1. Call for Proposals: Full-Time Open Source Rust Maintainer
2. Security Advisory: Miniscript MINIMALIF Bug
3. Improving coin selection in BDK
4. Hidden Powers of Miniscript Policy & Descriptors
5. A Multisig between BDK and Core
6. Making Descriptor-based paper wallets
7. Using BDK with hardware wallets
8. Using BDK with Tor
9. Getting Started with rust-hwi
10. Fee estimation for light-clients (Part 1)
11. Fee estimation for light-clients (Part 2)
12. Fee estimation for light-clients (Part 3)
13. Spending Policy Decoded
14. BDK wallet with Bitcoin core RPC
15. BDK wallet as a BIP157 SPV light client
16. BDK-RN: Building React Native Apps with BDK
17. bdk-rn: Behind the scenes
18. BDK-FLUTTER: Building Flutter Apps with BDK
19. Command Line introduction to Bitcoin Wallet Development using bdk-cli
20. bdk-cli basics multi-sig 2 of 3 tutorial
21. Release v0.2.0
22. Release v0.3.0
23. Release v0.4.0
24. Release v0.5.0
25. Release v0.6.0
26. Release v0.7.0
27. Release v0.8.0
28. Release v0.9.0

[thunderbiscuit]

TODO

• Add a new landing page.
• Use the new (old?) bdk logo in the page home nav and title

[thunderbiscuit]

TODO: Bring in/cherry-pick Arké #266

[notmandatory]

Concept ACK even without the blogging feature. Looks very sharp and I also like the new/old logo.

[notmandatory]

Heads up #269 added a new pgp key.

[reez]

non blocking: zensical.toml still leaves site_url commented out and the generated site/sitemap.xml is empty. Should we fix that before merge or is that not needed?

[reez]

Missing (but maybe we aren't using them anymore somehow, even though I *think we are)?

• /docs/ no longer exists in this build, but posts still link to it
• this migration removes /foundation/ and the blog tag/author landing pages, but existing posts still link to them

[thunderbiscuit]

Do you like the docs page? I was considering removing it entirely, and maybe just finding a place to link to the book of bdk instead, which has all of that and more.

[thunderbiscuit]

Wow you really have eagle eyes @reez. Good catches.

I rejigged references to the /foundation/ landing page and the /docs/ page.

For the blog tag/author pages, I can't find links to them. Can you show me an example?

As for the site/sitemap.xml... what does it do, and how do I fill it out?

[reez]

Yea I’m ok with removing docs entirely and using book-of-bdk

one example is in docs/blog/2023_q4_update.md - still links to https://bitcoindevkit.org/blog/tags/architecture/. I don’t see an author-page link anymore on the latest so that part may already be resolved.

sitemap part looks resolved now

[thunderbiscuit]

Ah yes good one. Fixed now.

[reez]

Ah yes good one. Fixed now.

Only two things I see left are:

• docs/blog/2025_q2_update.md (line 23) still points to the old slug /blog/_2025q1-new-foundation-members/
• docs/blog/2025_q4_update.md (line 32) still points to /adoption/, but the build only emits /adoption/all/

Everything else seems resolved

[thunderbiscuit]

Fixed those too @reez. Ready for final review.

I have the blog post ready as well, I'll open the PR when this one goes in.

[reez]

Would squash commits

ACK 99e3e53

[netlify]

❌ Deploy Preview for awesome-golick-685c88 failed.

Name	Link
🔨 Latest commit	769c8ed
🔍 Latest deploy log	https://app.netlify.com/projects/awesome-golick-685c88/deploys/69e7b789339866000834df3f

[notmandatory]

Sorry I didn't get a chance to review this today, but will dig into it tomorrow.