ghost-github-portfolio
Sincroniza repositorios públicos de GitHub a una página de Ghost CMS, ordenando por estrellas y generando tarjetas con banners dinámicos y badges automáticos vía API Admin.
Ficha actualizada 24 sept 2026, 22:43 · upstream 24 sept 2026, 22:28 · release v0.3.5
Qué es ghost-github-portfolio
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ghost-github-portfolio es una herramienta de automatización que conecta tu cuenta de GitHub con una instalación de Ghost CMS. Extrae los repositorios públicos, filtra por número mínimo de estrellas y ordena los resultados en función de la popularidad. El script genera tarjetas HTML ricas con banners detectados automáticamente y badges dinámicos que muestran métricas como estrellas, forks o licencias mediante shields.io.
La herramienta actualiza el contenido directamente en una página específica de Ghost utilizando su API Admin y formato Lexical. Permite configuraciones granulares por repositorio, incluyendo descripciones personalizadas, pilas tecnológicas específicas y overrides para banners o imágenes de Docker. Funciona como un agente de sincronización que puede ejecutarse diariamente mediante cron, contenedores Docker o workflows de GitHub Actions.
Ofrece modos de ejecución flexibles, tanto con instalación global vía npm como en entornos aislados. Incluye una opción de dry-run para previsualizar cambios antes de aplicarlos al CMS, garantizando seguridad durante la implementación inicial. La configuración se gestiona mediante un archivo YAML centralizado que define credenciales y reglas de filtrado.
- Actualización automática de portafolio profesional en Ghost CMS
- Visualización dinámica de métricas de repositorios (estrellas, forks)
- Integración de badges tecnológicos específicos (Docker, macOS, etc.)
- Mantenimiento del contenido del blog sin intervención manual diaria
- Generación de tarjetas con banners personalizados por proyecto
- Detección automática de imágenes de banner en rutas comunes como docs/images/banner.svg
- Generación de badges dinámicos vía shields.io que se actualizan sin re-ejecutar la herramienta
- Soporte nativo para el formato Ghost Lexical Editor actualizado
- Ejecución flexible: CLI, Docker o GitHub Actions con soporte para cron
- Configuración granular por repositorio con overrides de descripción y tecnología
- Requiere credenciales de API de Ghost y GitHub (tokens/keys) almacenadas en archivos o variables de entorno
- Por defecto solo sincroniza repositorios públicos; los privados requieren token explícito
- Dependencia externa a shields.io para la renderización visual de los badges
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configura config.yml con credenciales y rutas de banner. Usa variables de entorno GHOST_GITHUB_TOKEN y GHOST_ADMIN_API_KEY. Ejecuta vía CLI, Docker o GitHub Actions (cron diario). Revisa dry-run antes de sync real. Asegura permisos de lectura en volúmenes de configuración si usas Docker.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.