Este tópico irá guiá-lo sobre como usar o Theme CLI com nosso site Theme Creator para desenvolver um tema e visualizar suas alterações em um site Discourse ativo.
-
Cadastre-se para uma conta aqui no Meta se ainda não o fez
-
Instale o Theme CLI seguindo as instruções aqui
-
Crie um novo tema no Theme Creator:
- Visite https://discourse.theme-creator.io/my/themes
- Clique em Install e selecione a opção “Create New”.
- Dê um nome exclusivo ao seu tema (você pode ignorar o esquema de cores por enquanto).
-
Clique em advanced, depois em edit locally e em retrieve API key.
Copie a chave de API que é gerada.
-
Volte para sua linha de comando e digite
discourse_theme download example-folder, onde example-folder é onde seu tema será armazenado localmente. Siga as instruções.-
Insira
https://discourse.theme-creator.iocomo a URL raiz do seu site Discourse. -
Insira sua chave de API da etapa anterior quando solicitado.
-
Continue seguindo as instruções e selecione o tema que você criou na etapa 4.
-
Digite sim quando perguntado se deseja começar a monitorar seu tema.
-
-
Agora, sua pasta de tema local está sendo monitorada para alterações, que serão enviadas automaticamente para o Theme Creator. Você pode abrir uma prévia do seu tema clicando em preview nas configurações do seu tema no Theme Creator.
-
Para parar de monitorar as alterações, pressione ctrl + c na sua janela de linha de comando. Para começar a monitorar as alterações novamente, digite
discourse_theme watch example-theme.
Agora você tem um diretório de tema local que pode editar e ver suas alterações ao vivo!
Para uma análise aprofundada de como os temas são estruturados e o que você pode fazer, confira nosso Developing Discourse Themes & Theme Components
Este documento é controlado por versão - sugira alterações no github.