feat: migrate from Gitbook to MkDocs Material with i18n#42
Merged
openoms merged 17 commits intoopenoms:enfrom Mar 1, 2026
Merged
feat: migrate from Gitbook to MkDocs Material with i18n#42openoms merged 17 commits intoopenoms:enfrom
openoms merged 17 commits intoopenoms:enfrom
Conversation
- Set up MkDocs Material with mkdocs-static-i18n plugin - Migrate EN content from root into docs/ - Migrate ES content from es branch into docs/es/ with directory names mapped to match EN structure - Add GitHub Actions workflow for Pages deployment - Fix internal links and asset references - Include all hardware sub-pages in navigation - Dark/light theme toggle, search, code copy - Language switcher (EN/ES) with nav translations - CNAME preserved for lightningnode.info
The GitHub Actions deploy workflow will be added once the token has the workflow scope, or it can be created via the GitHub UI.
- deploy.yml triggers on push to mkdocs-migration branch - mkdocs.yml includes hu locale with nav translations
Complete hu locale under docs/hu/ mirroring the full English content: - Lightning basics, liquidity, channel markets - Node types, advanced tools, technicals - Recovery (LND + CLN), privacy, hardware guides - RaspiBlitz, RaspiBolt, TrueNAS sub-pages - Donate page
All 33 Hungarian doc files were missing ékezetek (diacritical marks). Fixed á, é, í, ó, ö, ő, ú, ü, ű across all translated content.
All content already migrated to docs/ for MkDocs. Removes duplicate root files, .gitbook/, SUMMARY.md, and root CNAME. Repo structure is now: docs/ ← EN content + es/, hu/ translations mkdocs.yml README.md .github/
autoblitzbot
force-pushed
the
mkdocs-migration
branch
from
2dec9b6 to
c6fd881
Compare
…tning (CLN), bilingual headers
Remove: Tor BTCPayServer link, Bitcoin Beach Wallet, Tippin.me, old pay.diynodes.com Lightning Address, Sphinx Chat, lntxbot Add: Lightning Address openoms@diynodes.com, Blink Wallet, Nostr NIP05 + npub
openoms
approved these changes
Mar 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
mkdocs-static-i18nplugindocs/esbranch merged intodocs/es/, with directory names mapped to match the EN structure so the i18n plugin pairs pages correctlylightningnode.info) preserved via CNAMEWhat's needed after merge
The GitHub Actions workflow (
deploy.yml) couldn't be pushed due to OAuth token scope limitations. To enable auto-deployment:.github/workflows/deploy.yml— the file content is in the first commit of this branch (commit7c6fbe2)mkdocs-material+mkdocs-static-i18nand deploys on push tomainAlternatively, the workflow file is saved locally and can be pushed with a token that has the
workflowscope.Local testing
Then visit http://127.0.0.1:8000 — language toggle is in the top bar.
Test plan
//es/