3. Comandos
Todos os comandos do Bot de Scans respeitam o uso de comandos de barras, isto é, slash commands. Ao apertar / em um chat que o bot tem acesso e começar a digitar o nome do comando, você poderá ter a opção de auto-complete e de inserir informações adicionais.
Note
Necessário o cargo Publisher para execução do comando
Antes de executar o comando, é necessário subir as páginas da obra separadamente em alguma pasta qualquer do Google Drive e tornar o link público. O que é bem simples: Crie uma pasta, coloque todos os arquivos pertinentes de imagem lá, clique na setinha ao lado do nome da pasta para abrir as opções, Acesse o menu de opções Compartilhar e depois clique no próximo Compartilhar.
Na janela que abrir, selecione Qualquer pessoa com o Link e com a permissão apenas de Leitura e Confirme. Você poderá copiar o link do próprio navegador para enviar ao bot quanto utilizar o botão com o link gerado na janela anterior de Compartilhamento.
Tendo o link, a role e o bot online, podemos executar o comando. Em qualquer canal que o bot tenha acesso (público ou não), comece a digitar o comando /publish. Mesmo sem terminar, algumas sugestões já devem aparecer. Selecione a correta e será aberta uma janela para o cadastro de uma publicação.
Para preencher os campos, considere:
- Link do Capítulo: O mesmo link gerado no passo acima do Google Drive
-
Nome do Mangá: O nome do mangá a ser publicado. Evite usar caracteres especiais. Ele precisa ser igual ao escrito no arquivo
roles.txt, e em outros arquivos de configuração (como mangadex-ids.txt, por exemplo). - Nome do Capítulo: Autoexplicativo, campo opcional.
-
Número do capítulo $ Volume: Aqui é necessário colocar o número do capítulo, o caractere
$e o número do volume. Por exemplo:10$3. Caso não tenha volume definido, é possível colocar apenas o número do capítulo e sem o caractere, assim:10. (isso deve-se a uma limitação do Discord da janela possuir apenas 5 campos no máximo. - Mensagem de Postagem: Uma mensagem opcional a ser exibida durante a postagem do lançamento no Discord, e possivelmente em outras integrações atuais (como Blogger) e/ou futuras integrações.
Após preencher e executar, o Bot de Scans automaticamente irá baixar e realizar uma bateria de validações nos arquivos. Se estiver tudo OK, iniciará o processo de publicação; podendo retornar sucesso ou falha. Em caso de falha, um erro amigável ou técnico é exibido relatando qual o problema.
Para garantir que os dados estão correto, as validações realizadas são:
- O diretório precisa conter apenas arquivos;
- O diretório precisa conter apenas uma única página de capa (ex: capa.png);
- O diretório precisa conter apenas uma única página de créditos (ex: creditos.png);
- O diretório precisa conter apenas arquivos com as extensões esperadas: ".jpg", ".jpeg", ".png";
- As páginas duplas precisam estar numeradas em ordem e sequencialmente (ex: 01-02.png);
- As páginas precisam ter números sequenciais, sem pular números;
- O nome dos arquivos numéricos precisam ser escrito de modo que todos tenham o mesmo tamanho de caracteres (dica: use zero à esquerda);
- A primeira página deve começar com o número 1 (ex: 1, 01, 001...);
- Não deve conter outras páginas senão de numerais, créditos e capa.
Tip
A página capa, obrigatória durante a validação, é utilizada como imagem de postagem/divulgação no Discord, e possivelmente em outras integrações atuais (como Blogger) e/ou futuras integrações. Por isso é recomendável colocar uma imagem bem chamativa. Lembre-se de tomar cuidado com o conteúdo da imagem, pois pode ser problemático postar conteúdo 18+ em canais sem restrição de idade... Ou, após uma futura integração como o Facebook, postar conteúdos com imagens 18+ pode levar ao banimento da página.
Note
Necessário o cargo Staff para execução do comando
O comando realiza uma bateria de verificações nos dados em um link contendo uma obra já editada para garantir que atenda alguns critérios de qualidade. Para executar o comando, a pessoa precisa ter a role Staff no Discord. Esta validação também é executado no passo de publish por segurança. Este comando, porém, pode ser executado por pessoas que não tenham necessariamente os privilégios de publicação.
Note
Necessário o cargo Publisher para execução do comando
Pede o e-mail de uma conta Google como parâmetro. Permite que a pessoa dona desta conta navegue e abra/baixe os arquivos que o Bot de Scans subiu, navegando pela própria interface do Google Drive em sua conta pessoal. Isso porque arquivos criados pelo Bot de Scans não podem ser excluídos exceto por ele próprio (culpa o Google, não a mim). Então este comando é mais uma medida emergencial para obter dados pra exclusão.
Note
Necessário o cargo Publisher para execução do comando
O contrário do comando acima. Corta o acesso de gestão do Google Drive gerido pelo Bot de Scans.
Note
Necessário o cargo Publisher para execução do comando
Utilize o comando caso queira deletar algum arquivo que o bot criou no Google Drive. Você precisará enviar o fileName (nome do arquivo) e o folderName (nome da pasta).
Note
Necessário o cargo Staff para execução do comando
Informação estatística de quanto de armazenamento o Bot de Scans está utilizando no Google Drive (isto é, caso você esteja publicando lançamentos .zip ou .pdf lá no Google Drive).
Os comandos abaixo são utilizados para busca e solução de problemas e não devem ser considerados no uso diário do Bot de Scans
Note
Necessário o cargo Staff para execução do comando
Um comando de verificação de configuração. Valida se o Bot de Scans está sendo capaz de baixar arquivos do Google Drive. Exige uma URL como parâmetro, e arquivos no mesmo formado dos comandos de publicação e verificação.
Note
Necessário o cargo Staff para execução do comando
Caution
Atualmente o comando funciona através de uma gambiarra muito feia 😐. Você precisa criar um arquivo chamado ALGO.zip na mesma pasta onde encontra-se o executável do Bot de Scans. Isso será ajustado no futuro.
Um comando de verificação de configuração. Valida se o Bot de Scans está sendo capaz de enviar arquivos do Google Drive.