Astro Composer

Descripción del Proyecto

Astro Composer es un plugin de Obsidian que convierte tus notas de Obsidian en posts y páginas para tu blog de Astro con características automatizadas de gestión de contenido. Parte del proyecto Vault CMS, proporciona integración fluida entre la toma de notas en Obsidian y los flujos de trabajo de publicación de Astro.

Características Clave

Creación y Gestión de Contenido

• Diálogo de Nuevo Post: Cuando está habilitado, solicita un título al crear nuevos archivos Markdown a través de la acción “Nueva nota” de Obsidian, generando automáticamente nombres de archivo en kebab-case (por ejemplo, “Mi Post de Blog” → my-blog-post.md) y opcionalmente insertando propiedades con title, date, etc.
• Estandarización de Propiedades: Actualiza las propiedades de una nota para coincidir con una plantilla personalizable usando el comando “Standardize Properties”. Preserva los valores de propiedades existentes, agrega propiedades faltantes de la plantilla en el orden especificado y adjunta propiedades no reconocidas al final.
• Comando Renombrar Post: Renombra fácilmente tus notas actualizando la propiedad title con el nombre de post deseado, y obtén una actualización de archivo o carpeta en kebab-case después.

Gestión de Borradores

• Prefijo de Guion Bajo: Opcionalmente agrega un prefijo de guion bajo (por ejemplo, _my-post.md) para ocultar borradores de Astro, configurable a través de ajustes.

Conversión de Enlaces

• Conversión de Enlaces Internos: Convierte wikilinks de Obsidian y enlaces internos de markdown ([[Mi Post]] o [Mi Post](mi-post)) a enlaces Markdown amigables con Astro ([Mi Post](/blog/mi-post/)), soportando tanto estructuras de posts basadas en archivos como en carpetas.

Soporte Multi-Tipo de Contenido

• Páginas, Docs, Proyectos: Con “Enable pages” habilitado y creando tipos de contenido personalizados, puedes hacer el mismo comportamiento de automatización para cualquier otro tipo de contenido, como páginas, documentación, proyectos, etc.

Flujo de Trabajo Configurable

• Ajustes Personalizables: Configura carpeta de posts, ruta base de enlaces, modo de creación (basado en archivos o basado en carpetas con index.md), formato de fecha y directorios excluidos
• Automatización Selectiva: Habilita o deshabilita la automatización para nuevas notas e inserción de propiedades independientemente
• Automatización Robusta: Solo activa el diálogo de título para nuevas notas iniciadas por el usuario (por ejemplo, a través del comando “New note”), evitando solicitudes no deseadas durante la carga de la bóveda o importaciones de archivos (por ejemplo, a través de git pull)

Implementación Técnica

Construido con TypeScript y siguiendo las mejores prácticas de desarrollo de plugins de Obsidian, el plugin se integra perfectamente con el sistema de archivos de Obsidian y proporciona una experiencia de usuario fluida para creadores de contenido. Soporta tanto estructuras de posts basadas en archivos (my-post.md) como basadas en carpetas (my-post/index.md), haciéndolo flexible para diferentes configuraciones de Astro.

Instalación

Astro Composer aún no está disponible en la sección de plugins de la Comunidad. Instala usando BRAT o manualmente:

BRAT (Recomendado)

1. Descarga el plugin Beta Reviewers Auto-update Tester (BRAT) del directorio de plugins de la comunidad de Obsidian y habilítalo
2. En los ajustes del plugin BRAT, selecciona Add beta plugin
3. Pega: https://github.com/davidvkimball/obsidian-astro-composer y selecciona Add plugin

Instalación Manual

1. Descarga la última versión desde la página de Releases
2. Navega al directorio .obsidian/plugins/ de tu bóveda de Obsidian
3. Crea una nueva carpeta llamada astro-composer y asegúrate de que manifest.json, main.js y styles.css estén allí
4. En Obsidian, ve a Settings > Community plugins y habilita “Astro Composer”

Uso

1. Personalizar Ajustes: En Settings > Astro Composer, configura automatización, plantilla de propiedades, carpeta de posts, modo de creación y más
2. Estandarizar Propiedades: Usa el comando Astro Composer: Standardize Properties para actualizar las propiedades de una nota al tipo de contenido relevante
3. Convertir Enlaces Internos: Usa el comando Astro Composer: Convert internal links for Astro para transformar wikilinks de Obsidian y enlaces Markdown internos en enlaces Markdown compatibles con Astro
4. Renombrar Contenido: Usando el comando Astro Composer: Rename Current Note, establece el título de tu contenido y haz que el archivo o carpeta padre se renombre automáticamente con la versión en kebab-case

Casos de Uso

• Creadores de Contenido: Agiliza el proceso de creación y gestión de posts de blog, páginas y documentación
• Desarrolladores de Astro: Cierra la brecha entre la toma de notas en Obsidian y la publicación en Astro
• Escritores Técnicos: Mantén formato consistente y organización de archivos a través de múltiples tipos de contenido
• Bloggers: Enfócate en la creación de contenido en lugar de la gestión de archivos y generación de slugs
• Usuarios de Vault CMS: Componente central de automatización para el flujo de trabajo completo de Obsidian-a-Astro

Estado del Proyecto

Este proyecto se mantiene activamente y está en progreso. La última versión incluye características de automatización robustas, opciones de configuración completas para varios flujos de trabajo de Astro y soporte para múltiples tipos de contenido más allá de solo posts.

Ver Proyecto