feat: add script to generate pdf from our markdown docs

[sunng87]

What's Changed in this PR

This patch adds a script to generate pdf from markdown files.

The script is mostly generated by AI

TODO Items:

• images
• cross-doc links doesn't work
• pdf index
• custom pdf cover

Checklist

• Please confirm that all corresponding versions of the documents have been revised.
• Please ensure that the content in sidebars.ts matches the current document structure when you changed the document structure.
• This change requires follow-up update in localized docs.

[cloudflare-workers-and-pages]

Deploying greptime-docs with    Cloudflare Pages

Latest commit:	6885ff4
Status:	✅  Deploy successful!
Preview URL:	https://665fd736.greptime-docs.pages.dev
Branch Preview URL:	https://feature-doc-pdf.greptime-docs.pages.dev

View logs

[sunng87]

A sample of generated content is like
docs-0.14.pdf

Options like removing some content, customize cover page are supported.

❯ npm run pdf -- --help

> [email protected] pdf
> node scripts/generate-pdf.js --help


Docusaurus PDF Generator

USAGE:
  node scripts/generate-pdf.js [VERSION] [OPTIONS]

ARGUMENTS:
  VERSION                 Version to generate PDF for (default: 'current')
                         Examples: current, 0.14, 0.13, 0.12

OPTIONS:
  --help, -h             Show this help message
  --skip-generation      Skip individual PDF generation and combine existing temp files
  --keep-temp            Keep temporary PDF files after successful generation
  --locale LOCALE        Language locale for the documentation (default: 'en')
                         Examples: en, zh, ja, fr
  --blacklist CATEGORIES Comma-separated list of categories to exclude from PDF
                         Examples: changelog,roadmap,api-reference
  --cover FILE           Path to PDF file to use as cover page (prepended to output)
                         Example: --cover docs/cover.pdf


EXAMPLES:
  # Generate PDF for current English docs
  node scripts/generate-pdf.js current

  # Generate PDF for version 0.14 English docs
  node scripts/generate-pdf.js 0.14

  # Generate PDF for current Chinese docs
  node scripts/generate-pdf.js current --locale zh

  # Generate PDF for version 0.14 with blacklisted categories
  node scripts/generate-pdf.js 0.14 --blacklist changelog,roadmap

  # Generate PDF for Chinese version 0.14 with blacklisted categories
  node scripts/generate-pdf.js 0.14 --locale zh --blacklist changelog,roadmap

  # Generate PDF with custom cover page
  node scripts/generate-pdf.js current --cover docs/cover.pdf

  # Generate PDF and keep temporary files for debugging
  node scripts/generate-pdf.js current --keep-temp

OUTPUT:
  PDF files are generated in the 'pdf-build' directory with the naming pattern:
  - docs-current.pdf (for current English docs)
  - docs-0.14.pdf (for version 0.14 English docs)
  - docs-current-zh.pdf (for current Chinese docs)
  - docs-0.14-zh.pdf (for version 0.14 Chinese docs)

NOTES:
  - The script follows the sidebar order defined in sidebars.js or versioned sidebar files
  - Outbound links (http://, https://) are converted to plain text in the PDF
  - Front matter is automatically removed from markdown files
  - Individual PDFs are generated first, then combined into a single document