Si tus notas ya están en un script, un conjunto de datos o una colección de archivos, generar un mazo de Anki puede facilitar que repitas el proceso de creación. El código fuente sigue siendo revisable en Git y cada exportación se convierte en un paso que puedes volver a ejecutar.

Empieza con una palabra: hola. Queremos una tarjeta con el saludo en español en el anverso y su significado en inglés en el reverso.

Un programa completo

Este es el ejemplo mínimo en Rust del repositorio:

use ankiforge::{BuildOptions, Note, Project};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut project = Project::new("spanish")?.default_deck("Spanish");
    project.add("es:hola", Note::basic("hola", "hello"))?;
    let output = project.build(BuildOptions::to("spanish.apkg"))?;
    println!("{}", output.artifact().path().display());
    Ok(())
}

Project::new("spanish") crea el espacio de nombres. Note::basic("hola", "hello") crea una nota Basic, project.add("es:hola", note) asigna su clave estable y build(BuildOptions::to(...)) escribe el paquete.

build solo devuelve BuildOutput cuando termina correctamente. El operador ? propaga un fallo tipado para que los scripts puedan terminar con un error.

Instalar y ejecutar

Sigue la guía de inicio actual para instalar el paquete público y consultar el comando de ejecución. Para utilizar el mismo programa en tu proyecto, sigue Integrarlo en tu aplicación.

Después de exportar, importa spanish.apkg en Anki y muestra la respuesta de tu primera tarjeta.

El ejemplo Basic de este sitio también incluye un paquete descargable si prefieres examinar primero el resultado.

Dar una identidad a la nota

La cadena es:hola es una clave de nota estable y explícita dentro del espacio de nombres spanish. Identifica de qué nota se trata, independientemente de cómo redactes la respuesta. Más adelante podrías ampliar «hello» a «hello; hi» y conservar el mismo ID.

Utiliza un ID distinto para cada nota lógica. Si tus datos de origen ya tienen una clave duradera, como el ID de una entrada de vocabulario, es un buen punto de partida. Evita derivar la identidad únicamente de un texto que prevés editar.

Actualizar un mazo distribuido también requiere el historial de publicaciones. Conserva el paquete anterior original y sigue el flujo de actualización documentado.

Ampliar el ejemplo

Para añadir otro saludo, crea otra nota Basic y añádela con una clave nueva. Para ocultar una palabra dentro de una frase, utiliza una nota Cloze. Si necesitas tarjetas más completas, define tus campos y plantillas con la API del proyecto y empaqueta imágenes o audio junto con las notas.

La guía de desarrollo con Rust continúa con los diagnósticos, los recursos multimedia y las generaciones repetibles. Los ejemplos del repositorio ofrecen programas ejecutables que puedes ampliar.