Genera un APKG de Anki con Node.js

Usa Node.js 22.13 o posterior. En un directorio nuevo de aplicación:

mkdir anki-deck
cd anki-deck
npm install --include=optional ankiforge@0.3.1

Este comando instala el paquete publicado en npm y la dependencia nativa opcional correspondiente. Consulta los entornos verificados para conocer las plataformas cubiertas.

Exporta un mazo

Guarda lo siguiente como main.mjs:

import { Project, Note, BuildOptions } from 'ankiforge';

const project = new Project('spanish').defaultDeck('Spanish');
project.add('es:hola', Note.basic('hola', 'hello'));
const output = await project.build(BuildOptions.to('spanish.apkg'));
console.log(output.artifact.path);
await output.artifact.close();

node main.mjs

Abre el archivo persistente spanish.apkg en Anki. Contiene hola → hello en el mazo Spanish. Conserva el espacio de nombres spanish y la clave es:hola cuando edites el contenido. Cerrar el objeto que gestiona el artefacto persistente deja el archivo en el disco. No necesitas instalar Anki para exportarlo.

TypeScript y siguientes pasos

El tutorial de JSON a Anki incluye el proceso completo de compilación y ejecución de TypeScript.

Usa .mjs para ESM o require('ankiforge') para CommonJS. El paquete incluye las declaraciones de tipos de TypeScript; consulta la configuración de TypeScript.

• Imágenes y audio y API multimedia de Node.
• Tipos de nota personalizados y paquetes de plantillas.
• Oclusión de imágenes.
• Comparación y actualización.
• API de Node y solución de problemas.

La guía de compilación desde el código fuente explica las compilaciones y los paquetes locales.