La
Discourse Theme CLI es un gem de Ruby que te permite usar tu editor preferido al desarrollar temas y componentes de temas de Discourse. A medida que guardas los archivos, la CLI actualizará el tema o componente remoto y los cambios aparecerán en vivo.
Instalación
Para probarla, asegúrate de tener instalado Ruby 2.5 o una versión posterior.
Si estás en Windows, tienes 2 opciones:
Opción 1: Windows Subsystem for Linux.
Windows 10 tiene acceso a un entorno Linux completo, puedes usarlo para instalar ruby simplemente con sudo apt-get install ruby, esto te dará Ruby 2.3.
Opción 2: Windows anteriores
Las versiones anteriores de Windows no tienen acceso a WSL, puedes instalar Ruby fácilmente con Ruby Installer, elige la versión recomendada y la configuración predeterminada para la instalación.
Mac OS versión 10.13.3 viene con Ruby 2.3 de fábrica, no se necesita nada especial. Si estás ejecutando una versión anterior de Mac OS, considera usar rvm, rbenv o homebrew para instalar una versión reciente de ruby.
Una vez que Ruby 2.2 o posterior esté en ejecución, abre una terminal o shell de comandos y ejecuta:
gem install discourse_theme
Una vez instalado, para saber más sobre él:
discourse_theme
Actualización
gem update discourse_theme
Características
La CLI proporciona 3 funciones principales:
discourse_theme new
Puedes usarla para crear rápidamente un nuevo tema con discourse_theme new TU_NOMBRE_DE_DIRECTORIO
discourse_theme watch
Puedes usarla para monitorear un tema y sincronizarlo con un sitio de discourse (con actualización en vivo) usando discourse_theme watch TU_NOMBRE_DE_DIRECTORIO
Esto significa que puedes usar tu propio editor para editar tu tema y el sitio se actualizará mágicamente
con los cambios.
discourse_theme download
Puedes descargar un tema existente de Discourse usando discourse_theme download TU_NOMBRE_DE_DIRECTORIO. Luego se te dará la opción de comenzar a “monitorear” de inmediato.
Credenciales
Necesitarás generar una clave de API. Ve al área de administración y genera una clave allí.
Selecciona un “Nivel de Usuario” de Single User(Usuario Único) al generar la clave, noAll Users(Todos los Usuarios).
Asegúrate de marcar Global Key(Clave Global) o recibirás errores 403 prohibido.
Las credenciales se almacenan (opcionalmente) en ~/.discourse_theme. Las claves de API se almacenan por sitio, y la URL/theme_id para cada directorio también se rastrea. Si en algún momento necesitas cambiar tus ajustes, simplemente agrega --reset a cualquier comando y se te solicitará nuevamente todos los valores.
Testimonios
“¡Esta herramienta es realmente una GEMA!” @awole20
“Esto es muy, muy bueno.” @awesomerobot
“Está funcionando
Y es bastante genial. ¡Genial!” @angus
“OMG. Es increíble.” @pfaffman
Este documento está bajo control de versiones - sugiere cambios en github.

