Upgrade to Docusaurus 3.10.2; dead links, images, CI - #1
Open
Twelve-eight wants to merge 2 commits into
Open
Conversation
…lockfile The repo carried two lockfiles; both pinned every tarball URL to registry.npmmirror.com, so any non-mirror environment failed to install (npm >= 12 refuses remote tarballs by default: EALLOWREMOTE). - Remove yarn.lock (the polluted one) - Regenerate package-lock.json from registry.npmjs.org (lockfileVersion 3) Note: the site still does not build with docusaurus 2.0.1 against modern webpack (ProgressPlugin schema validation rejects webpackbar's extra option keys); upgrade follows in a separate commit.
Upgrade:
- Docusaurus 2.0.1 -> 3.10.2 (2.x no longer builds against modern webpack:
ProgressPlugin schema validation rejects webpackbar's option keys)
- react/react-dom 18.3, @mdx-js/react 3, clsx 2, prism-react-renderer 2,
docusaurus-lunr-search 3.6 (v3-compatible)
- MDX v3 fixes across the site: HTML comments -> {/* */} escapes,
bare <...> angle brackets wrapped in inline code, <details> block flow
- onBrokenMarkdownLinks migrated to markdown.hooks form
Dead links (all verified dead via HTTP checks):
- mcbbs.net links removed everywhere (site shut down); surviving mirrors kept
- netlify deploy-preview link now points at the self-hosted
MinecraftBat command generator (new src/pages route wrapping the
static tool page, whose hashed-asset background now uses a local image)
- dead navbar/footer entries removed or fixed; tagline typo fixed;
navbar title unified with site title
Content:
- usercache.json tutorial draft restored to hidden (was accidentally
published by the comment conversion)
- placeholder sections replaced with an explicit 'contributions welcome' note
Assets & infra:
- images recompressed: static/ 16.2MB -> 14.4MB (7.5MB hero PNG alone
down to 1.7MB as JPEG)
- scaffold remnants removed (markdown-page.md, template comments,
GH Pages config leftovers)
- GitHub Actions CI running npm ci + build (broken-link gate);
README gains local development instructions
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
1 participant
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
The site could no longer build at all (Docusaurus 2.0.1 is incompatible with modern webpack — ProgressPlugin schema validation rejects webpackbar's option keys). This PR upgrades to Docusaurus 3.10.2 and does a full maintenance pass.
npm ci && npm run buildverified green locally.Upgrade
{/* */}, bare angle brackets wrapped,<details>block flow fixedDead links (all verified dead via HTTP checks)
src/pagesroute wrapping the static tool page, whose hashed-asset background now uses a local imageContent regression fixed
Assets & infra