O
Discourse Theme CLI é um gem em Ruby que permite usar seu editor preferido ao desenvolver temas e componentes de tema para o Discourse. Conforme você salva os arquivos, o CLI atualiza o tema ou componente remoto e as alterações aparecerão em tempo real!
Instalação
Para experimentar, certifique-se de ter o Ruby 2.5 ou superior instalado.
Se você estiver no Windows, tem 2 opções:
Opção 1: Windows Subsystem for Linux.
O Windows 10 tem acesso a um ambiente Linux completo; você pode usá-lo para instalar o Ruby simplesmente com sudo apt-get install ruby, o que lhe dará o Ruby 2.3.
Opção 2: Versões antigas do Windows
Versões mais antigas do Windows não têm acesso ao WSL. Você pode instalar o Ruby facilmente com o Ruby Installer; escolha a versão recomendada e as configurações padrão para a instalação.
O Mac OS versão 10.13.3 vem com o Ruby 2.3 pré-instalado, não é necessário nada de especial. Se você estiver usando uma versão anterior do Mac OS, considere usar rvm, rbenv ou homebrew para instalar uma versão recente do Ruby.
Depois que o Ruby 2.2 ou posterior estiver em execução, abra um terminal ou shell de comandos e execute:
gem install discourse_theme
Depois de instalado, para saber mais sobre ele:
discourse_theme
Atualização
gem update discourse_theme
Recursos
O CLI fornece 3 funções principais:
discourse_theme new
Você pode usá-lo para criar rapidamente um novo tema com discourse_theme new SEU_NOME_DA_PASTA
discourse_theme watch
Você pode usá-lo para monitorar um tema e sincronizá-lo com um site do Discourse (com atualização em tempo real) usando discourse_theme watch SEU_NOME_DA_PASTA
Isso significa que você pode usar seu próprio editor para editar seu tema e o site será atualizado magicamente
com as alterações!
discourse_theme download
Você pode baixar um tema existente do Discourse usando discourse_theme download SEU_NOME_DA_PASTA. Em seguida, você terá a opção de começar a “monitorar” imediatamente!
Credenciais
Você precisará gerar uma Chave de API. Vá para a área de administração e gere uma chave lá.
Selecione um “Nível de Usuário” de Single Userao gerar a chave, nãoAll Users.
Certifique-se de marcar Global Keyou receberá erros 403 forbidden.
As credenciais são (opcionalmente) armazenadas em ~/.discourse_theme. As chaves de API são armazenadas por site, e a URL/theme_id para cada diretório também é rastreada. Se você precisar alterar suas configurações, basta adicionar --reset a qualquer comando e será solicitado a inserir todos os valores novamente.
Depoimentos
“Esta ferramenta é realmente um GEM!” @awole20
“Isso é muito, muito bom.” @awesomerobot
“Está funcionando
E é bem legal. Muito bom!” @angus
“OMG. É inacreditável.” @pfaffman
Este documento é controlado por versão - sugira alterações no github.

