Guía de Vault CMS

Descripción General

Todos los plugins, atajos de teclado y el tema pueden personalizarse a tu gusto, pero esto es lo que viene activado por defecto.

Filosofía

1. Experiencia de blogging con Astro plug-and-play.
2. Énfasis en personalización y modularidad.
3. Paridad visual entre backend y frontend.

Configuración Predeterminada

1. Se usan enlaces de Markdown en lugar de wikilinks.
2. La ubicación predeterminada para nuevas notas es la carpeta posts.
3. Algunos plugins principales están deshabilitados (detalles abajo).
4. Las guías de indentación han sido deshabilitadas.
5. El título en línea ha sido ocultado para priorizar la propiedad title.
6. Se han establecido atajos de teclado personalizados (detalles abajo).
7. Los plugins de la comunidad han sido habilitados.

Tema

Para personalización inmediata, se usa el tema Oxygen, basado en el sistema de tema Minimal. Usa un esquema de colores elegante que es altamente personalizable.

El plugin Oxygen Theme Settings también está instalado por defecto, dándote control completo sobre tu experiencia. Incluso puedes definir tus propios presets de esquemas de colores. Más sobre eso abajo.

Atajos de Teclado Importantes

Aquí hay una guía de algunos atajos de teclado importantes configurados especialmente para este tema:

• Alternar panel lateral izquierdo: CTRL + ALT + Z
• Alternar panel lateral derecho: CTRL + ALT + X
• Alternar barra de pestañas: CTRL + ALT + S
• Navegar hacia atrás: ALT + ←
• Navegar hacia adelante: ALT + →
• Abrir página de inicio: CTRL + M
• Agregar una nueva propiedad: CTRL + ;
• Alternar visibilidad de propiedades para la nota actual: CTRL + ALT + P
• Alternar vista de lectura: CTRL + E
• Alternar barra de herramientas de edición: CTRL + SHIFT + E
• Alternar modo Zen: CTRL + SHIFT + Z
• Insertar imagen remota: CTRL + '
• Insertar imagen remota en propiedad: CTRL + SHIFT + '
• Insertar callout: CTRL + SHIFT + C
• Renombrar contenido actual: CTRL + R
• Abrir auditoría SEO: CTRL + SHIFT + A
• Abrir Terminal: CTRL + SHIFT + D
• Abrir Astro Modular Settings: CTRL + SHIFT + ,
• Omnisearch: CTRL + SHIFT + O
• Commit y sync git: CTRL + SHIFT + S

Si estás en Mac, CTRL = CMD.

Plugins

Plugins principales deshabilitados por defecto:

• Canvas
• Daily notes
• Note composer
• Page preview
• Templates
• Sync

Plugins de la comunidad habilitados:

• File Name History
• Astro Composer
• Astro Modular Settings
• Bases CMS
• Editing Toolbar
• Explorer Focus
• File Name History
• Git
• Home Base
• Iconic
• Image Manager
• Omnisearch
• Oxygen Theme Settings
• Property Over Filename
• SEO
• Settings Search
• Tag Wrangler
• UI Tweaker
• Zen Mode

Astro Modular Settings

El plugin Astro Modular Settings fue hecho específicamente para este tema. Tiene todo lo que necesitas para ajustar fácilmente las características de tu blog. Edita el archivo config.ts del proyecto, aunque esté fuera del directorio raíz de la bóveda de Obsidian.

Un asistente se abrirá al inicio que te guiará a través de algunas opciones de configuración. Puedes deshabilitar este popup si lo deseas.

Prácticamente cualquier otra cosa que quieras personalizar está en la configuración del plugin. También puedes crear tu propio tema, importar y exportar configuraciones, y mucho más.

Home Base y Bases CMS

Estos plugins trabajan juntos para que tu pantalla predeterminada sea un archivo .base que es un directorio de todo tu contenido, listado en orden cronológico inverso. Un icono de inicio está fijado en tu barra de pestañas, lo que hace fácil volver a él. Puedes desactivar esto si lo deseas en la configuración de Home Base.

Bases CMS nos permite tratar una cuadrícula de contenido como un sistema de gestión de contenido. Puedes seleccionar múltiples elementos y hacer ediciones masivas, renombrar contenido directamente desde esa vista, o alternar el estado de borrador de un elemento. También puedes configurar la vista de CMS e incluso agregar nuevas vistas a tu gusto.

Para editar una vista, selecciona la vista actual en la parte superior izquierda, revelando la lista, y luego selecciona la flecha derecha para abrir las opciones de “configurar vista”. Configura las propiedades deseadas aquí. En la parte inferior, puedes establecer dónde se crean nuevas notas cuando se hace clic en el botón “nuevo” en la parte superior derecha. Por defecto, serán la misma ubicación que la carpeta base para el tipo de contenido que estás viendo.

Astro Composer y File Name History

Útil para crear fácilmente nuevas notas como posts, páginas, proyectos o docs de blog de Astro. Simplemente crea una nueva nota con CTRL + N, escribe un título en Title case o con caracteres especiales, y el nombre de la nota o carpeta generado es una versión en kebab-case del título sin caracteres especiales. Esto es ideal para automatizar slugs de páginas de contenido.

También puedes definir y establecer propiedades predeterminadas que pueden generarse automáticamente o establecerse manualmente para cualquier nota abierta. El comando “Standardize properties” puede ayudar a establecer o reorganizar cualquier propiedad o etiqueta faltante, especialmente si actualizas tu plantilla de propiedades en el futuro.

A diferencia de otros temas, puedes usar wikilinks o enlaces estándar de markdown, sin tener que convertirlos a enlaces internos para Astro con el comando “Convert internal links for Astro”. Este tema soporta cualquier enlace interno que funcione con Obsidian.

También puedes obtener fácilmente enlaces a encabezados haciendo clic derecho en uno y seleccionando “Copy Heading Link”.

CTRL + R te permite renombrar fácilmente posts de blog, y los nombres de archivos de notas (o carpetas padre) se actualizan en kebab-case automáticamente. Cuando esto sucede, el nombre de archivo antiguo se almacenará como un alias por defecto a través del plugin File Name History. Esto significa que las redirecciones de la URL antigua del post o página irán al slug del post actual, que está configurado en Astro.

Puedes ajustar muchas configuraciones incluyendo regex para ignorar nombres (como Untitled o un prefijo _), tiempo de espera en segundos para almacenar el nombre, o buscar cambios en el nombre de la carpeta padre también si usas la opción de post basado en carpetas.

Astro Composer también tiene varios comandos útiles. Para abrir la terminal rápidamente, usa el comando Open terminal. Ha sido modificado para Windows, macOS y Linux para iniciar la terminal en el directorio relevante para que puedas ejecutar fácilmente comandos estándar de gestor de paquetes con pnpm o npm. Puede activarse con CTRL + SHIFT + D.

También puedes lanzar el comando Edit Astro config, que abrirá tu archivo config.ts. Puedes acceder a esto si quieres, pero es un poco más fácil simplemente lanzar el comando Open Astro Modular Settings en su lugar. También puedes presionar CTRL + SHIFT + , para abrirlo, o usar el icono convenientemente ubicado junto al icono de configuración tradicional de Obsidian (que puede desactivarse en la configuración del plugin Astro Composer si no lo quieres allí).

Configuración del Tema Oxygen, UI Tweaker, Explorer Focus y Modo Zen

El plugin Oxygen Theme Settings te ayuda a personalizar tu experiencia si usas el tema Oxygen de Obsidian proporcionado y puede ayudarte a concentrarte en la escritura.

Notarás una amplia variedad de opciones de esquemas de colores, la mayoría de las cuales se incluyeron en el tema Minimal en el cual se basa Oxygen.

Si deseas ocultar cualquiera de los paneles, puedes usar CTRL + ALT Z para el panel lateral izquierdo, CTRL + ALT + X para el panel lateral derecho, o CTRL + ALT + S para la barra de pestañas. Presionarlo nuevamente lo revelará de nuevo.

UI Tweaker te permite ocultar y ajustar elementos de la interfaz también. Ábrelo y personalízalo a tu gusto.

Con el plugin Explorer Focus, puedes simplificar tu vista del explorador de archivos solo al directorio que es inmediatamente relevante para tu archivo actualmente abierto. Simplemente haz clic en el botón de alternar enfoque o haz clic derecho en un directorio en el panel del explorador de archivos para reducir el número de archivos y carpetas que estás viendo.

El Modo Zen ofrece otra opción rápida para concentrarte en tu escritura. Presionar CTRL + SHIFT + Z entrará en modo Zen. Cuando se activa, todos los elementos se eliminan excepto tu contenido. Usa la combinación de teclas nuevamente para salir.

Si lo deseas, puedes instalar el plugin Style Settings para aún más control sobre tu experiencia.

Git

Con el plugin Git, puedes publicar fácilmente en tu blog de Astro sin salir de Obsidian. Simplemente configura con git para habilitarlo. Por defecto, verás tu estado actual de git y el conteo de archivos cambiados (si los hay) en la barra de estado en la parte inferior derecha.

Para publicar, puedes usar CTRL + SHIFT + S o hacer clic en el botón “commit-and-sync” en la barra de estado. Tus cambios serán comprometidos y empujados a tu repositorio remoto automáticamente. Por defecto está fijado en el extremo derecho de la barra de estado. También puedes reorganizar los elementos de la barra de estado a tu gusto usando UI Tweaker.

Image Manager

Arrastra y suelta rápidamente archivos de imagen, inserta imágenes con un comando, o pega imágenes directamente desde tu portapapeles. Cada uno funciona directamente en el contenido de la nota o dentro de las propiedades. Trae imágenes de Unsplash, Pexels o Pixabay fácilmente con solo algunas pulsaciones de teclas. Simplemente usa CTRL + ' para insertar una imagen remota - e inmediatamente establece texto alt amigable con SEO y un nombre de archivo. Inserta en la propiedad designada con CTRL + SHIFT + '

También puedes insertar imágenes locales con un comando - que se convierten a imágenes locales por defecto.

Puedes agregar un banner de aspecto agradable en la parte superior de cualquier archivo Markdown, siempre que se defina una propiedad image válida. Coincide con la imagen de portada usada en la vista de Bases CMS por defecto.

Tag Wrangler

Hace que la gestión de etiquetas sea más útil. Puede renombrar etiquetas masivamente o buscar tu contenido por etiquetas.

Property Over File Name

Al enlazar, buscar o mostrar notas, puedes usar la propiedad title como su etiqueta principal en lugar de su nombre de archivo. Usar propiedades de título es más útil visual y semánticamente para enlazar, buscar y mostrar contenido, ya que los nombres de archivo de notas son realmente slugs de página en kebab case en lugar de títulos tradicionales.

Cuando enlazas a otra nota, su title se establece automáticamente como el texto hiperenlazado, pero puedes cambiarlo fácilmente a otra cosa después de que haya sido insertado.

Las pestañas muestran la propiedad title de la nota en lugar del nombre de archivo también.

Puedes ajustar este comportamiento en la configuración de Property Over File Name.

Settings Search

Simplemente proporciona una opción de búsqueda global para todas las configuraciones en Obsidian.

Omnisearch

Una búsqueda poderosa para toda tu bóveda o una nota individual. Puedes buscar y encontrar notas basándote en el contenido de una nota en lugar de solo el título de una nota. Actívalo con CTRL + SHIFT + O cuando el selector rápido (CTRL + O) no sea suficiente.

SEO

Obtén una auditoría rápida de tu contenido para clasificaciones de motores de búsqueda y análisis de IA. Puedes obtener una instantánea rápida de toda tu bóveda o profundizar en posts específicos. Puedes configurar los ajustes para desactivar verificaciones que no te importan o ajustar la lógica en los cálculos.

Editing Toolbar

Esto agrega una barra de herramientas WYSIWYG a Obsidian. Haz clic en el botón “toggle editing toolbar” (agregado con UI Tweaker) en la barra de título para mostrarla u ocultarla. Está oculta hasta que se revela y completamente deshabilitada en móvil por defecto.

BRAT

Usado para cargar Astro Modular Settings y los plugins beta que aún no están incluidos en el directorio de la comunidad. Las versiones futuras de esta bóveda eliminarán las versiones de BRAT en favor de los lanzamientos oficiales.

Disable Tabs

Esto está desactivado por defecto, pero si se habilita, abrir cualquier nueva pestaña reemplaza solo la actual. Especialmente agradable cuando estás ocultando la barra de pestañas y no quieres múltiples pestañas. Si habilitas este plugin, podrías considerar deshabilitar el botón de pestaña en móvil y ajustar algunas de las configuraciones de UI Tweaker bajo la sección Hider > Navigation.

Folder Notes

También desactivado por defecto, pero una opción para cualquiera que use un sistema basado en carpetas de contenido que podría querer simplificar su vista del explorador de archivos. En lugar de buscar el archivo index.md o similar en cada carpeta, cada carpeta padre asume el nombre del contenido alojado dentro de ella, y el archivo Markdown puede abrirse simplemente haciendo clic en la carpeta misma.

Móvil

Deshabilitar el Plugin de Git

Se recomienda deshabilitar el plugin de Git en móvil y usar algo como Git Sync para iOS y Android (o MGit solo para Android) en su lugar. El plugin de Git es notoriamente problemático en móvil, por lo que es mejor usar otra cosa.

Aquí está cómo deshabilitarlo:

1. En tu dispositivo móvil, abre Obsidian, y abre la carpeta src/content de tu sitio de Astro Modular como una bóveda.
2. Abre la barra lateral izquierda y abre Configuración.
3. Desplázate hacia abajo hasta plugins de la comunidad y toca Git de la lista.
4. Desplázate hasta el final y selecciona “Disable on this device”.
5. Reinicia Obsidian.

Este método es recomendado en lugar de simplemente deshabilitar el plugin, ya que si sincronizas con tu escritorio también se deshabilitará allí. De esta manera está deshabilitado por dispositivo.

Limitaciones

Aspectos del plugin UI Tweaker y algunas características de Image Manager están deshabilitadas en móvil.

Personalización

Para ajustar la experiencia específica de móvil en la versión móvil de Obsidian, puedes usar la configuración del plugin UI Tweaker y también visitar Toolbar y Appearance en configuración.

Toolbar

Bajo la configuración de Toolbar, puedes establecer la acción rápida de móvil que se activa al deslizar hacia abajo desde la parte superior de la pantalla tocando la opción “Configure”.

Debajo de eso puedes ajustar qué opciones están disponibles para ti en la barra de herramientas de móvil.

Appearance

Bajo la configuración de Appearance, localiza “Interface” y el botón “Manage” de la opción “Ribbon menu configuration”. Puedes establecer tu elemento de acceso rápido preferido de la lista, y personalizar qué elementos aparecen en el menú de cinta.

Todo Listo

Asumiendo que tienes git funcionando en tu teléfono de otra manera, ahora tienes sincronización de contenido fluida entre tu escritorio, laptop, tableta y dispositivos móviles.