Importar una bóveda de Obsidian

Scriptorium puede importar una bóveda de Obsidian entera como proyecto nuevo. El árbol de carpetas se reproduce, los [[wikilinks]] se convierten en enlaces de página reales con retroenlaces que funcionan, las #tags pasan a ser etiquetas por las que puedes filtrar, los destacados se muestran como destacados y el frontmatter YAML se convierte en propiedades tipadas.

Al final obtienes un informe que nombra todo lo que no se pudo trasladar, de modo que nada se pierde en silencio.

Importar tu bóveda

En la pantalla de bienvenida, haz clic en Importar.
Arrastra la carpeta de tu bóveda a la zona de soltar. No hay que buscar ningún importador de bóvedas aparte: la misma zona acepta documentos, archivos comprimidos y bóvedas, y deduce qué le han dado. Un .zip de la bóveda también funciona y, si prefieres hacer clic a arrastrar, usa Elegir una carpeta de bóveda de Obsidian.
Pon un nombre y un idioma de proyecto, revisa el tablero y pulsa Importar.

Si no cambias nada, cada nota se convierte en una nota y tu estructura de carpetas se conserva exactamente. Ese es el comportamiento seguro por defecto, y nunca está mal.

El tablero

En lugar de una lista de preguntas, obtienes una imagen del proyecto que estás a punto de crear.

┌── Wiki ────────────┐ ┌── Manuscript ──────┐ ┌── Entities ────────┐
│ ▸ Assets        4  │ │ ▾ Manuscript  ACT  │ │ Character      142 │
│ ▸ Events        61 │ │   ▾ Act One   CHAP │ │ Location        38 │
│ ▸ people       142 │ │     Ch. Two   SCENE│ │ Event           61 │
│   Index.md         │ │     Ch. Three SCENE│ │                    │
└────────────────────┘ └────────────────────┘ └────────────────────┘
  1,842 notes · 142 Character · 38 Location · 61 Event · 47 folders

Wiki y Manuscrito son los dos sitios donde puede estar un archivo. Todo empieza en Wiki. Arrastra una carpeta —o una sola nota— a Manuscrito y se convierte en prosa; arrástrala de vuelta y vuelve a ser una nota. Cada fila tiene además un menú … con los mismos movimientos, que suele ser más rápido que arrastrar.

Entidades no es un tercer sitio. Es una etiqueta sobre el árbol de Wiki: una nota agrupada se sigue creando en la carpeta de la que vino, y al pasar el cursor por un grupo se resaltan sus notas allí donde están realmente.

La tira inferior es toda la importación en cifras, y se actualiza a medida que mueves cosas. No se escribe nada hasta que pulsas Importar.

Tu prosa

Una carpeta soltada en Manuscrito se convierte en un Acto. Sus subcarpetas pasan a ser Capítulos, y las de estas, Escenas: así que la estructura que ya construiste en tu bóveda es la que obtienes en la barra lateral. Cada archivo se divide después en secciones por sus títulos.

Cuatro niveles son el techo. Una carpeta más profunda no obtiene sección propia; sus archivos se colocan en la Escena más cercana, y el informe nombra todas las carpetas a las que les ha pasado esto.

El orden entre hermanos sigue los nombres de tus carpetas y archivos. Podrás reorganizarlo en la barra lateral una vez que el proyecto exista.

Usa Manuscrito solo para carpetas que realmente contengan prosa: una página de wiki dividida por sus títulos se lee como un libro que no lo es. Los enlaces de página, los destacados y las etiquetas sobreviven al traslado, así que una nota que resulte pertenecer al manuscrito no pierde nada por estar ahí.

Personajes, lugares y eventos

Si tu bóveda usa frontmatter para decir qué es una nota —

---
type: character
born: 1815-12-10
died: 1852-11-27
---

— esos grupos ya están en el tablero cuando se abre. Tú los declaraste; no deberías tener que declararlos otra vez uno a uno en un desplegable. type, class, category y kind se reconocen todos, y cada valor obtiene un grupo, por pocas notas que lo lleven: una categoría que anotaste una vez sigue siendo una categoría.

Un grupo se convierte en un tipo de entidad: registros que comparten plantilla, en la tabla de entidades, en el mapa mental y en una línea de tiempo.

Cada tarjeta lleva Campos, que indican en qué se convierte cada clave del frontmatter: texto, número, sí/no, opción, fecha, una etiqueta, la fecha de inicio o la fecha de fin, o nada en absoluto. Se leen de las notas del propio grupo, así que un status que vale draft/done en tus personajes se convierte en una opción con exactamente esas dos alternativas, y no con todos los valores que la palabra status tenga en cualquier parte de tu bóveda.

Renombra una tarjeta escribiendo en ella. Desagrupar devuelve sus notas a ser notas corrientes. Arrastra una nota a otra tarjeta para moverla, o fuera para sacarla.

Donde tu bóveda no dice nada, Scriptorium puede ofrecer un grupo Sugerido de notas que comparten una forma. Una sugerencia no afirma nada hasta que pulsas Aceptar.

Equivocarse aquí no es destructivo. Las propiedades funcionan también en notas corrientes, así que un error cuesta la plantilla compartida y la colocación en la línea de tiempo, no tus datos.

Todo lo que muevas a Manuscrito abandona su grupo. Muévelo de vuelta y se reincorpora: entretanto no se pierde nada.

Fechas

Dos cosas que conviene saber:

Las fechas ambiguas se rechazan, no se adivinan. 03/04/2024 es el 3 de abril en casi todo el mundo y el 4 de marzo en Estados Unidos, y nada en el archivo lo resuelve. Scriptorium conserva el valor como texto y nombra el archivo y la clave en el informe. Escribe 2024-03-04, 2024/03/04 o March 4, 2024 y se lee como una fecha.
Las horas no desplazan nada. Un cumpleaños escrito como 1885-03-12T10:30+02:00 se importa como 12 de marzo, 10:30. Las zonas horarias nunca mueven una fecha.

Scriptorium rellena por sí mismo los dos huecos de la línea de tiempo cuando reconoce un par —born/died, birth/death, start/end, from/to—, así que un personaje con born y died aterriza en la línea de tiempo como un intervalo sin que hagas nada.

La línea de tiempo tiene un inicio y un fin, así que como mucho una clave de fecha de inicio y una de fecha de fin por grupo: ceder el hueco a un segundo campo se lo quita al primero. Cada clave de fecha sigue convirtiéndose en un campo de fecha de todos modos, así que una bóveda con born, died, crowned y modified puede poner born y died en la línea de tiempo y conservar las cuatro.

Dejar cosas fuera

Arrastra una carpeta o una nota a No importado y se omite por completo, junto con todo lo que contiene. La papelera solo aparece una vez que hay algo dentro.

Qué se traslada

Estructura

Obsidian	Scriptorium
Carpeta de la bóveda	Un proyecto nuevo, bajo una carpeta con el nombre de tu bóveda
Carpetas anidadas	La misma anidación en la barra lateral, y Acto / Capítulo / Escena en el manuscrito
Archivos `.md`	Notas, o entidades y secciones de manuscrito según el tablero
Imágenes, PDF, audio	Archivos adjuntos

En el texto

Obsidian	Scriptorium
Títulos, listas, tablas, código, listas de tareas, $math$	Lo mismo
Destacados `> [!note] Title`	Destacados, con el título como primera línea
`==highlight==`	Un resaltado
`%%comment%%`	Una anotación anclada al pasaje en el que estaba
`#tag` y `tags:` del frontmatter	Etiquetas, con la anidación conservada
Frontmatter	Propiedades tipadas
Notas al pie `[^1]`	Notas al pie reales, con el texto de la definición dentro

Enlaces

Obsidian	Scriptorium
`[[Note]]`	Un enlace de página, y un retroenlace en el otro extremo
`[[Note\|alias]]`	Un enlace de página que se lee «alias»
`![[image.png]]`	La imagen, guardada en tu proyecto
`![[Note]]`	Una tarjeta de enlace: Scriptorium no tiene transclusión
`[[Note#Heading]]`	Un enlace a la nota; el título se muestra en el texto del enlace
`[[Ghost]]`	Texto plano, listado en el informe
`[Ada](People/Ada.md)`	Un enlace de página, igual que la forma wikilink
`![](Assets/map.png)`	La imagen, guardada en tu proyecto

Ambos estilos de enlace funcionan, así que una bóveda con Use [[Wikilinks]] desactivado se importa con sus enlaces intactos.

Los enlaces se resuelven igual que los resuelve Obsidian, incluidos los nombres base más cortos y únicos y los alias del frontmatter. Cuando dos archivos podrían haber coincidido, el informe dice cuál se eligió.

Qué no se traslada

Los lienzos (.canvas) se cuentan y se omiten.
Los bloques de Dataview y Templater se importan literalmente como código. No se evaluarán.
Las referencias de bloque (^block-id) y las anclas de título enlazan a la nota y no al bloque exacto.
El estado plegado de los destacados y las etiquetas HTML en línea se descartan; el texto que hay dentro se conserva.
Una nota al pie sin definición en ninguna parte del archivo se queda como el [^1] que escribiste: no hay nada que poner dentro.

Todo esto aparece listado en el informe al final de la importación, que puedes copiar para repasarlo más tarde.

Cancelar

Una bóveda grande tarda un rato: unos cuantos miles de notas son decenas de segundos. La barra de progreso es exacta y Cancelar funciona en cualquier momento. Cancelar no deja nada detrás: no aparece ningún proyecto a medio construir en tu estantería.