@vinnyum/devto-publisher

Una herramienta de línea de comandos para automatizar la publicación y actualización de artículos escritos en Markdown hacia DEV.to.

💡 ¿Qué hace?

Cuando escribes en Markdown localmente o en un repositorio Git, es común usar imágenes relativas como ![](./assets/screenshot.png). DEV.to no puede leer imágenes locales.

Esta herramienta:

1. Analiza el frontmatter y el contenido de tu post.
2. Reescribe todas las rutas relativas de imágenes (incluida la portada cover) para apuntar a la URL cruda de GitHub correspondientes en tu repositorio (raw.githubusercontent.com/...).
3. Envía el post a la API de DEV.to como borrador (draft) o actualiza uno existente.

🚀 Instalación y Uso

Puedes usarla directamente con npx sin instalar:

npx @vinnyum/devto-publisher [options] <article_path>

Opciones de CLI:

• -r, --repo <owner/name>: Repositorio en GitHub (ej. mi-usuario/mi-repo). Si se ejecuta dentro de un repositorio git local, la CLI intentará inferir este valor automáticamente leyendo la configuración remota.
• -b, --branch <branch>: Rama de Git para resolver las URLs de imágenes (ej. main, develop). Si estás en git local, se inferirá la rama actual de forma automática.
• -t, --token <token>: API Key de DEV.to. También se puede configurar a través de la variable de entorno DEVTO_TOKEN.
• -i, --article-id <id>: ID del artículo en DEV.to. Proporciona esta opción si deseas actualizar un borrador/post existente en lugar de crear uno nuevo.

Ejemplo de uso:

npx @vinnyum/devto-publisher -t tu_token_de_devto -r aguilavajz/apex-insights articles/es/mi-articulo.md

📝 Licencia

ISC