# La biblioteca

Tu pantalla de inicio: proyectos como libros, marcadores, vistas previas al pasar el cursor, duplicados y una búsqueda de proyectos que usa la sintaxis de búsqueda de GitHub.

La biblioteca es la pantalla de inicio de Oleafly. Cada proyecto aparece como un libro en una estantería, con el de actividad más reciente primero, y aquí ocurre todo lo que necesitas para administrar proyectos.

![Los proyectos muestran su primera página al pasar el cursor, y luego la búsqueda y los filtros reducen la biblioteca.](https://cdn.oleafly.com/images/gifs/desktop/library.gif?v=2)

## La estantería

Cada tarjeta muestra el nombre del proyecto y el color de su portada. La portada también indica de qué tipo de proyecto se trata: Documento, Imagen, Diagrama o Externo, para una carpeta que abriste en su ubicación. Bajo la tarjeta están el motor (LaTeX, Typst o Markdown) y la hora del último cambio. Abre un proyecto para volver a su código y su vista previa.

Los botones de la parte superior derecha alternan entre la cuadrícula, que muestra las portadas, y la lista, más fácil de recorrer.

Con una biblioteca vacía, la pantalla de bienvenida ofrece **Nuevo proyecto** y **Abrir una carpeta**.

## Crear un proyecto

Haz clic en **Proyecto nuevo** y elige cómo empezar:

- **Usar una plantilla** para un artículo, una tesis, un currículum, una presentación o un documento en blanco. Explora la [galería de plantillas](/docs/templates/), elige una plantilla y ponle nombre a tu proyecto.
- **Importar un proyecto** para traer archivos existentes. Consulta la [guía de importación](/docs/import-project/) para cada formato.
- **Proyecto de investigación** para organizar un [espacio de investigación](/docs/research-workspace/) con documentos, fuentes y tareas.

Si no eliges un color de portada, el proyecto nuevo recibe uno al azar de la paleta. Oleafly también registra los archivos del proyecto como un primer commit de Git llamado "Create project". Consulta [Git y control de versiones](/docs/git-history/#the-first-commit).

También puedes abrir la galería desde cualquier lugar con la barra de búsqueda: pulsa ⌘⇧F (Ctrl+Shift+F) y escribe `/create`.

## Carpetas abiertas en su ubicación

**Abrir carpeta** (⌘⇧O / Ctrl+Shift+O) te permite trabajar en una carpeta donde ya está, sin copiarla a la biblioteca. Las compilaciones, los ajustes, los puntos de control y los chats de esa carpeta van a la carpeta de datos propia de Oleafly, así que no se añade nada a la tuya. La carpeta aparece en la estantería marcada como Externo, y su tarjeta te avisa cuando la carpeta falta o cuando su unidad no está conectada.

Oleafly limita algunas funciones en una carpeta que abres de este modo, como Git, los agentes externos y el LaTeX del sistema mediante `latexmk`. Un aviso sobre el editor ofrece **Confiar en esta carpeta** para activarlas. Confía solo en carpetas cuyo contenido conozcas. Hasta entonces, la carpeta se compila con el motor Tectonic incluido. Una vez que confías en ella, una carpeta sin motor propio sigue el [motor de compilación predeterminado](/docs/engines/#set-a-default-for-new-projects). Los comandos externos siguen necesitando después su propio [permiso](/docs/latex-engines/#allow-external-commands).

La [sincronización en la nube](/docs/cloud-sync/) hace copia de seguridad solo de los proyectos de tu biblioteca, así que una carpeta abierta en su ubicación no se sincroniza.

Haz clic con el botón derecho en una tarjeta Externo para mostrar la carpeta en tu administrador de archivos, **Copiar a la biblioteca** para crear un proyecto que sea tuyo, o **Quitar de Oleafly**, que deja los archivos donde están. También puedes abrir carpetas desde Finder, el Explorador de archivos o un terminal; consulta [Integración con el sistema](/docs/settings/general/#system-integration).

## Vistas previas al pasar el cursor

Pasa el cursor sobre un libro y la primera página de su último PDF compilado se desliza sobre la portada, para que distingas tus artículos de un vistazo. Las vistas previas salen de la salida compilada real y se guardan en caché, así que la estantería sigue siendo rápida.

Si prefieres no verlas, desactiva **Ver el PDF al pasar el cursor** en **Ajustes → Apariencia → Vista previa del PDF**.

## Marcadores

Pasa el cursor sobre un libro y haz clic en su icono de marcador para marcar el proyecto. Para mostrar solo los proyectos con marcador, escribe `is:bookmarked` en el cuadro de búsqueda o establece **Marcador** en **Con marcador** en los Filtros avanzados.

![Un artículo duplicado para un reenvío, con la copia en un color de portada propio.](https://cdn.oleafly.com/images/gifs/desktop/fork-color.gif?v=2)

## El menú contextual

Haz clic con el botón derecho en cualquier libro:

- **Abrir el proyecto**
- **Detalles del proyecto**: el nombre, el ID, el motor, el tipo, el documento principal, las fechas y otros metadatos que usa la búsqueda.
- **Historial de exportaciones**: los archivos que exportaste de este proyecto.
- **Color del proyecto**: once muestras de portada (Azul, Crema, Melocotón, Rosa palo, Rosa, Lila, Celeste, Agua, Cian, Menta, Verde primavera). El color se guarda en el propio proyecto, así que viaja con él si lo sincronizas con otro equipo.
- **Duplicar el proyecto**: copia el proyecto y su historial completo de Git en un proyecto nuevo. El diálogo sugiere `<name> (copy)`; ponle el nombre que quieras. Usa una copia para probar otra versión de un currículum o un artículo. La copia empieza sin puntos de control.
- **Eliminar el proyecto**: mueve el proyecto a la Papelera, donde se puede restaurar.

## Cambiar el nombre de un proyecto

Abre el proyecto y haz clic en su título en la barra de herramientas superior. Se vuelve editable en el mismo lugar: escribe el nombre nuevo y pulsa Enter. El cambio de nombre se guarda en los metadatos del propio proyecto.

## Busca en tus proyectos

El cuadro de búsqueda de la parte superior de la pantalla de inicio filtra la estantería mientras escribes. Usa la misma sintaxis que la búsqueda de incidencias y pull requests de GitHub. Las palabras sueltas coinciden con el nombre del proyecto, el ID, el archivo principal, la ruta de la carpeta, las exportaciones, el motor, el tipo y el color de la portada. Los calificadores acotan la lista:

| Calificador | Ejemplo | Coincide con |
| --- | --- | --- |
| `is:` | `is:bookmarked`, `is:folder`, `is:library`, `is:forked` | Proyectos con marcador, carpetas abiertas en su ubicación, proyectos guardados en Oleafly, duplicados |
| `has:` y `no:` | `has:preview`, `no:exports` | Proyectos con o sin vista previa de PDF compilado o exportaciones |
| `engine:` | `engine:typst`, `engine:latex` | LaTeX, Typst o Markdown |
| `kind:` | `kind:image` | Proyectos de documento, imagen o diagrama |
| `color:` | `color:mint` | Color de portada, por nombre de muestra |
| `created:`, `updated:`, `opened:` | `created:>2026-01-01`, `updated:>@today-1w` | Fecha de creación, del último cambio o de la última apertura |
| `in:` | `draft in:name` | Limita las palabras a `name`, `id`, `file`, `path` o `export` |
| `sort:` | `sort:name-asc`, `sort:created` | Orden de la estantería |

`engine:latex` encuentra todos los proyectos de LaTeX, sea cual sea el motor de LaTeX que usen. El anterior `engine:tectonic` sigue funcionando y encuentra los mismos proyectos.

### Combina términos

Las reglas siguen las de GitHub:

- Un espacio significa AND. `AND` y `OR` en mayúsculas y los paréntesis agrupan términos, hasta cinco niveles de profundidad. AND se aplica antes que OR.
- Las comas enumeran alternativas: `engine:typst,markdown` coincide con cualquiera de los dos motores. Repetir un calificador significa ambos, así que `engine:typst engine:markdown` no coincide con nada.
- Un `-` inicial excluye: `-kind:image`, `-is:bookmarked`. `NOT` también funciona, y `-word` deja fuera los proyectos que contienen esa palabra.
- Las comillas mantienen juntos los espacios: `"lab notes"`, `in:path "My Papers"`.

```text
(engine:typst OR engine:markdown) is:bookmarked -kind:image sort:updated-desc
```

### Fechas y orden

Las fechas admiten `>`, `>=`, `<` y `<=`, rangos como `2026-01-01..2026-03-31` (usa `*` para un extremo abierto) y fechas relativas: `@today`, `@today-7d`, `@today-2w`, `@today-1m` o `@today-1y`. `created:>@today-1w` significa los últimos siete días.

`sort:` admite `activity`, `updated`, `created`, `opened` o `name`, cada uno con `-asc` o `-desc`. Sin una dirección, ordena de forma descendente. El valor predeterminado es la actividad reciente.

### Sugerencias y advertencias

Haz clic en el cuadro de búsqueda mientras está vacío y un menú desplegable enumera los calificadores. Mientras escribes, sugiere calificadores, sus valores, AND, OR y Excluir. Muévete por él con las teclas de flecha y pulsa Enter para aceptar una sugerencia. Tab o Escape lo cierra sin aceptar nada.

Los calificadores y los valores se muestran en color mientras escribes. Un error recibe un tinte ámbar y una nota breve que dice qué falla: un paréntesis sin cerrar, por ejemplo, o un valor que el calificador no admite. Un calificador desconocido se busca como texto sin formato, y un valor no válido se ignora.

### Filtros avanzados

El botón de controles deslizantes junto al cuadro de búsqueda abre los **Filtros avanzados**, con menús para Motor, Tipo de proyecto, Marcador, Vista previa del PDF, Creado, Modificado y Ordenar por. Un menú Ubicación se suma a ellos cuando has abierto una carpeta en su ubicación. Todos los menús editan el texto de búsqueda, así que el cuadro y el panel siempre coinciden. Cuando el panel no puede mostrar tu consulta como una sola opción, el menú dice **Personalizado**. **Restablecer** quita los calificadores y conserva tus palabras sueltas.

## Busca en todo

La barra de búsqueda (⌘⇧F / Ctrl+Shift+F, o **Buscar documentos** en el dock) busca en los metadatos de los proyectos y en el texto completo de cada documento de cada proyecto. Salta directamente al proyecto, al archivo y a la línea que coinciden. Escribe `/` para ver comandos con ámbito como `/projects`, `/docs` o `/create`.

La barra de búsqueda tiene sus propios filtros más sencillos, como `name:resume` o `bookmark:yes`. La sintaxis al estilo de GitHub de más arriba pertenece al cuadro de búsqueda de la pantalla de inicio.

## El dock de la pantalla de inicio

Un pequeño dock en la pantalla de inicio reúne todo lo que no es un proyecto:

- **Proyecto nuevo**: empieza desde una plantilla, importa archivos o crea un espacio de investigación.
- **Buscar documentos**: la barra de búsqueda (⌘⇧F / Ctrl+Shift+F).
- **Compositor de diagramas**: el [compositor de diagramas](/docs/figures-diagrams/), sin abrir antes un proyecto. Pregunta para qué es el diagrama: **Diagrama TikZ**, **Diagrama Typst** o **Diagrama Mermaid**.
- **Notas**: abre [Notas](/docs/notes/). Se muestra mientras **Notas** está activado en **Ajustes → Experimentación**.
- **Herramientas de Oleafly**: una galería con búsqueda de utilidades para documentos (más abajo).
- **Apariencia**: cambia entre Claro, Oscuro y Sistema.
- **Ajustes**: el engranaje, o ⌘, (Ctrl+,), abre la ventana completa de [ajustes](/docs/settings/).

## Herramientas de Oleafly

Activa **Herramientas de LaTeX** en **Ajustes → Experimentación** para mostrar la galería de **Herramientas de Oleafly**. Contiene conversores entre LaTeX, Typst, Markdown, Word, HTML e imágenes, además de generadores de referencias, validadores, consultas de investigación, calculadoras de estadística y ayudas para la escritura. La [guía de Herramientas de Oleafly](/docs/tools/) trata cada una.

## Dónde vive la estantería en el disco

Cada libro es una carpeta normal dentro de `~/.oleafly/projects/`, con un nombre aleatorio legible como `flying-pink-pikachu`. Nada de la biblioteca es propietario: consulta [Dónde viven tus datos](/docs/where-your-data-lives/).

## Papelera

Un proyecto eliminado permanece en la Papelera hasta que lo restaures o lo elimines de forma permanente. Ambas acciones están en **Ajustes → Almacenamiento de datos**. Consulta [Almacenamiento y papelera](/docs/settings/storage/#recycle-bin).
