Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- aplic:msg:catgirl [2025/08/13 02:06] – [Salvar mensagens] conteúdo de arquivo hrcerq
+++ aplic:msg:catgirl [2025/08/14 00:31] (atual) – a revisão anterior foi restaurada (2025/08/13 00:14) orahcio
@@ Linha 15: / Linha 15: @@
 ===== Instalação =====
-Toda instalação precisa ser realizada com privilégios de superusuário. Portanto esses comandos devem ser executados como root, ou utilizando ferramentas para elevação de privilégio (como ''doas'' ou ''sudo'').
+Toda instalação precisa ser realizada com privilégios de superusuário. Portanto esses comandos devem ser executados como root, ou utilizando ferramentas para elevação de privilégio (como __doas__ ou __sudo__).
 Em um sistema derivado do Debian/Ubuntu:
@@ Linha 53: / Linha 53: @@
 </code>
-==== Conectar em um Servidor autoassinado ====
+==== Autorizando certificados autoassinados ====
-Alguns servidores IRC não utilizam um certificado de uma autoridade certificadora (CA) confiável, em vez disso utilizando um certificado autoassinado no servidor. Algo muito comum em servidores Intranet ou servidores .onion.
+Alguns servidores IRC não utilizam um certificado de uma autoridade certificadora (CA) confiável. Em vez disso utilizam um certificado autoassinado no servidor. Isto é algo muito comum em servidores Intranet ou servidores .onion.
-Nisso, muitos clientes de IRC (incluindo o catgirl), rejeitam a conexão TLS, uma vez que os Clientes não conseguem validar esse certificado com a CA. Alguns clientes de IRC permitem que você ignore ou aceite manualmente o certificado, para que a conexão possa prosseguir. Para fazer isso no catgirl:
+Muitos clientes de IRC (incluindo o __catgirl__) rejeitam a conexão TLS, uma vez que os clientes não conseguem validar esse certificado com nenhuma CA. Alguns clientes de IRC permitem que você ignore ou aceite manualmente o certificado, para que a conexão possa prosseguir. Para fazer isso no __catgirl__, obtenha uma cópia do certificado, com o comando:
 <code>
-$ catgirl -h host_do_servidor_autoassinado -o > /caminho/para/o/certificado.pem
+$ catgirl -h hostname -o > /caminho/para/o/certificado.pem
 </code>
-Dessa forma você gravou o certificado autoassinado do servidor no arquivo ''/caminho/para/o/certificado.pem'', para que dessa forma possa se conectar no servidor aceitando manualmente esse certificado autoassinado:
+Dessa forma você gravou o certificado autoassinado do servidor no arquivo ''/caminho/para/o/certificado.pem'', e agora pode apontar para ele como um certificado confiável (se realmente você confiar, claro). Com a opção ''-t'' você informa o caminho para o certificado a ser autorizado. Assim, poderá se conectar no servidor sem problemas.
 <code>
-$ catgirl -h host_do_servidor_autoassinado -t /caminho/para/o/certificado.pem
+$ catgirl -h hostname -t /caminho/para/o/certificado.pem
 </code>
-Lembrado aqui também, que outras opções, como ''-n'' (para definir um nick) podem ser utilizadas em conjunto.
+Lembrado aqui também, que várias outras opções (como ''-n'' que vimos anteriormente) podem ser utilizadas em conjunto durante a conexão.
 ==== Arquivo de configuração ====
-Tudo pode ser feito via linha de comando, e essa é uma forma muito boa para testar todas as configurações de servidor e autenticação que você queira fazer usando o __catgirl__ como cliente IRC.
+Tudo pode ser feito via linha de comando, e essa é uma forma muito boa para testar todas as configurações de servidor e autenticação que você queira fazer usando o __catgirl__ como cliente IRC. Porém, depois que tudo está indo bem, convém persistir toda a parametrização em um arquivo de configuração.
-Porém, depois que tudo está indo bem via linha de comando, ainda é possível enviar todas as informações para uma arquivo de configuração que por padrão ele deve estar localizado em ''$HOME/.config/catgirl/nomearquivo.conf'', a extensão ''.conf'' é opcional.
+Para cada serviço IRC você deverá ter um arquivo de configuração diferente. O diretório padrão para armazenar esses arquivos é
+o ''$XDG_CONFIG_DIRS/catgirl/'' (que geralmente se traduz para ''$HOME/.config/catgirl/''). Dentro desse diretório você deve salvar os arquivos de configuração de cada serviço. Por exemplo, você pode criar o arquivo ''slackjeff.conf'' dentro dele, para guardar as configurações de acesso ao IRC do Slackeff.
 Até o momento vimos as opções: ''-n'' para o nick; ''-h'' para o host; ''-t'' para expecificar a confiança no certificado do servidor que você baixou usando a opção ''-o'', essas informações podem ser resumidas num arquivo de configuração da seguinte forma:
@@ Linha 88: / Linha 89: @@
 <code>
-$ catgirl slack.conf
+$ catgirl slackjeff.conf
 </code>
@@ Linha 146: / Linha 147: @@
 <code>
-$ catgirl -h irc.slackjeff.com.br -n seunick -c certificado.pem -k chave.pem -e
+$ catgirl -h irc.slackjeff.com.br \
+> -n seunick \
+> -c certificado.pem \
+> -k chave.pem \
+> -e
 </code>
@@ Linha 185: / Linha 190: @@
 Na interface padrão cada mensagem chega sem o registro de data e hora, caso você queira adicionar o horário adicione a opção ''-T'' ou a opção ''timestamp'' no arquivo de configuração. Sem fornecer uma //string// de data cada mensagem recebida estará no fomato ''%X'' que é o mesmo que ''%H:%M:%S'' (hora, minuto e segundo). Particularmente gosto de fornecer a //string// para apenas hora e minuto
-<code>
+<file>
 timestamp = %H:%M
-</code>
+</file>
 Ou adicione a opção ''-T %H:%M'' na linha de comando para conexão.
@@ Linha 197: / Linha 202: @@
 Eu gosto de usar apenas 16 cores pois uso meu emulador de terminal com fundo muito escuro e apenas 16 cores dá um contraste bom, os valores padrão aparecem //nicknames// e canais com tons de vermelho escuro ou azul escuro que não constrastam bem. Para isso adicione ''-H 0,15'' na sua linha de comando, ou a linha
-<code>
+<file>
 hash = 0,15
-</code>
+</file>
 Caso você queira desabilitar o colorido, é só usar o valor ''0,0''.
@@ Linha 206: / Linha 211: @@
 Caso queira ser informado em seu ambiente gráfico a respeito das menções ao seu nickname ou demais notificações que o IRC envia é necessário especificar a aplicação de notificações manualmente. Use a opção ''-N nome_utilitario'' ou acrescente a linha ao arquivo de configurações
-<file - ~/.config/catgirl/slackajeff.conf>
-# Linhas anteriores
+<file>
 notify = fyi
 </file>
-neste exemplo escolhi como a aplicação ''fyi'', que é uma implementação leve do ''notify-send'' muito mais comum nas distribuições Linux.
+Neste exemplo escolhi como a aplicação __fyi__, que é uma implementação leve do __notify-send__ muito mais comum nas distribuições Linux.
 ===== Movendo-se pelo catgirl =====
@@ Linha 232: / Linha 238: @@
 ===== Conclusão =====
-Um arquivo com todas as opções abordadas aqui para se conectar ao servidor ''irc.slackjeff.com.br'' seria
+Confira abaixo um exemplo de arquivo com todas as opções abordadas até aqui, para se conectar ao servidor ''irc.slackjeff.com.br'':
 <file - ~/.config/catgirl/slackjeff.com>
 host = irc.slackjeff.com.br
@@ Linha 254: / Linha 261: @@
 notify = fyi
 </file>
-lembrando que os arquivos de certificado devem estar na pasta ''~/.config/catgirl/''. Um bom exercício é ir adcionando as configurações via linha de comando mesmo, assim que todos os parâmetrso desejados fazem a conexão do jeito que você quer, transpõe a linha de comando para o arquivo de configurações.
+Lembrando que os arquivos de certificado devem estar na pasta ''~/.config/catgirl/''. Um bom exercício é testar graudalmente as configurações via linha de comando. Assim que todos os parâmetros desejados fazem a conexão do jeito que você espera, transponha essas opções para o arquivo de configurações.