6930dc6d52
## npm → pnpm - Delete package-lock.json, add pnpm-lock.yaml (deterministic installs) - Add packageManager field to package.json (pnpm@10.12.1) - Dockerfile: corepack enable + pnpm install --frozen-lockfile + pnpm build - Faster Docker builds (pnpm caches better than npm) ## Deprecation fixes - Move onBrokenMarkdownLinks from top-level config to markdown.hooks (deprecated in Docusaurus v3, removed in v4) - Build now produces zero deprecation warnings fix #70
51 lines
1.4 KiB
Docker
51 lines
1.4 KiB
Docker
# Stage 1: Extract docs from Python source + export bib library
|
|
FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS extract
|
|
|
|
WORKDIR /build
|
|
|
|
# Copy source code and extraction scripts
|
|
COPY src/ src/
|
|
COPY docs/scripts/ docs/scripts/
|
|
|
|
# Extract API docs via griffe (pure AST, no imports)
|
|
RUN uv run --with griffe python docs/scripts/extract_docs.py
|
|
|
|
# Export bibliography (gracefully handles missing bib.sqlite)
|
|
COPY data/bib.sqlit[e] data/
|
|
RUN uv run --with pydantic python docs/scripts/export_library.py
|
|
|
|
|
|
# Stage 2: Build Docusaurus static site
|
|
FROM node:22-slim AS build
|
|
|
|
RUN corepack enable && corepack prepare pnpm@10.12.1 --activate
|
|
|
|
WORKDIR /docs
|
|
|
|
# Install dependencies (pnpm for deterministic, fast installs)
|
|
COPY docs/package.json docs/pnpm-lock.yaml ./
|
|
RUN pnpm install --frozen-lockfile
|
|
|
|
# Copy Docusaurus config and source
|
|
COPY docs/docusaurus.config.js docs/sidebars.js docs/babel.config.js docs/tsconfig.json ./
|
|
COPY docs/src/ src/
|
|
COPY docs/static/ static/
|
|
COPY docs/docs/ docs/
|
|
|
|
# Copy generated API docs and library.json from extract stage
|
|
COPY --from=extract /build/docs/docs/api/ docs/api/
|
|
COPY docs/docs/api/index.md docs/api/index.md
|
|
COPY --from=extract /build/docs/static/library.json static/library.json
|
|
|
|
RUN pnpm build
|
|
|
|
|
|
# Stage 3: Serve with nginx
|
|
# hadolint ignore=DL3006
|
|
FROM nginx:alpine
|
|
|
|
COPY --from=build /docs/build /usr/share/nginx/html
|
|
COPY docs/nginx.conf /etc/nginx/conf.d/default.conf
|
|
|
|
EXPOSE 80
|