Publicar con Quartz

El vault ya es el contenido de Quartz: Markdown, frontmatter, wiki-links, callouts y index.md en la raíz.

Docker (recomendado)

Antes del build, el arte y los iconos tienen que estar en el vault (si no, el Dockerfile falla):

python scripts/fetch_media.py
python scripts/build_wiki.py
docker compose -f pokewiki/docker-compose.yml up --build -d

La wiki queda en http://127.0.0.1:8080. Nginx sirve HTML y PNG locales: no hay llamadas a PokéAPI en runtime.

docker compose -f pokewiki/docker-compose.yml logs -f
docker compose -f pokewiki/docker-compose.yml down

Cuando exista obsidean/assets/ (ver Evolutivo-PokeAPI), tiene que copiarse en la imagen Docker: Quartz ya publica esa carpeta con Plugin.Assets().

Tras regenerar notas (python scripts/build_wiki.py), reconstruí la imagen:

docker compose -f pokewiki/docker-compose.yml up --build -d

Sin Docker

Quartz no debe vivir dentro de obsidean. Cloná el motor al lado del vault:

git clone https://github.com/jackyzha0/quartz.git quartz
cd quartz
npm install

2. Ignorar la config de Obsidian

En quartz/quartz.config.ts, dentro de ignorePatterns, dejá:

ignorePatterns: [
  "private",
  "templates",
  ".obsidian",
  "**/Templates/**",
],

Así no se publica workspace.json ni plugins.

3. Build local

Desde quartz/:

npx quartz build --directory="../obsidean" --serve

Queda en http://localhost:8080 con:

• grafo clickeable
• búsqueda
• explorer de carpetas
• backlinks
• callouts (batallas icónicas, pasivas Sync)

4. Ajustes recomendados del sitio

En quartz.config.ts:

configuration: {
  pageTitle: "Pokémon Fire Ash Wiki",
  defaultDateType: "created",
  theme: {
    fontOrigin: "googleFonts",
    cdnCaching: true,
    typography: {
      header: "Schibsted Grotesk",
      body: "Source Sans 8",
      code: "IBM Plex Mono",
    },
  },
}

Plugins útiles que Quartz trae activos: Graph, Search, Explorer, Backlinks, TagPage, ContentIndex.

5. Publicar

Opciones habituales:

• GitHub Pages / Cloudflare Pages: el workflow de Quartz, cambiando el build a
  npx quartz build --directory="../obsidean"
• Dokploy / VPS: servir la carpeta quartz/public detrás de Traefik.

No hace falta copiar notas a quartz/content/. El flag --directory usa este vault directo.

Regenerar contenido y republicar

python ../scripts/build_wiki.py
npx quartz build --directory="../obsidean"