larperCord
themes "community" {  // feitos por quem usa

Temas da comunidade. Enviados, conferidos, prontos para usar.

Temas que as pessoas fizeram e mandaram para o repositório num pull request. Cada cartão desenha um esboço do app a partir do próprio arquivo do tema. Abra um no criador de temas para mudar, ou baixe o .kdl e coloque na sua pasta de temas. Os 11 temas que vêm com o app estão na galeria dos embutidos.

Ainda não há temas da comunidade. Seja a primeira pessoa.

Esta galeria sai de themes/community/ no repositório, e essa pasta ainda está vazia. Faça um tema, mande num pull request, e ele aparece aqui com prévia ao vivo, um botão que abre no criador de temas e o arquivo para baixar.

Abrir o criador de temas Como mandar um tema

pull request { // como mandar o seu

Mande o seu. Um arquivo, um pull request.

  1. Faça o tema no criador de temas, ou à mão com Escrevendo temas. Na aba Arquivo do criador, preencha o nome, o autor, uma descrição e a licença: a lista dessa aba (que também aparece em Exportar) mostra o que ainda falta.
  2. Baixe o .kdl. O nome dele vem do nome do tema: "Neon Dusk" vira neon-dusk.kdl.
  3. Faça um fork do repositório, coloque o arquivo em themes/community/ e abra um pull request. Um tema por pull request.
  4. Opcional, antes de mandar: python3 tools/gen_site.py --check-community roda as mesmas checagens do CI, e larpercord --theme neon-dusk (com o arquivo na sua pasta de temas) mostra ele no app.
  • Ele tem de carregar no app. O build do site lê cada arquivo da pasta com as regras do app (sintaxe, tokens de cor, expressões de cor, nomes de componentes) e para com arquivo:linha:coluna no primeiro problema. Depois, os testes carregam cada tema com a cópia que o site tem do leitor de temas do app, nos dois modos e com todas as opções. O CI roda os dois em todo pull request. Para ter certeza, teste no próprio app (passo 4).
  • Um nome só dele. Nem o nome de um tema embutido (um arquivo chamado orbital.kdl tomaria o lugar dele no app) nem um que já esteja na galeria. Um tema embutido só com o nome trocado também volta.
  • Sem logos nem fontes protegidos. A pasta só aceita arquivos .kdl, então nada de imagens ou arquivos de fonte. Não redesenhe o logo de outra pessoa com label, shape ou arte em ASCII, e só cite fontes que dá para conseguir de graça: o app procura a família no sistema de quem usa.
  • Uma licença aberta. license= no nó theme, uma da lista da galeria escrita como o identificador SPDX dela (CC0-1.0, CC-BY-4.0, MIT, GPL-3.0-or-later…), para todo mundo saber que pode usar e mudar. Se as cores vieram do tema de outra pessoa, a licença dele tem de deixar, e a descrição deve dar o crédito.

Todas as regras, com um exemplo, no guia de temas