summaryrefslogtreecommitdiff
path: root/site/contrib.pt.md
diff options
context:
space:
mode:
Diffstat (limited to 'site/contrib.pt.md')
-rw-r--r--site/contrib.pt.md130
1 files changed, 130 insertions, 0 deletions
diff --git a/site/contrib.pt.md b/site/contrib.pt.md
new file mode 100644
index 0000000..3bc1f1d
--- /dev/null
+++ b/site/contrib.pt.md
@@ -0,0 +1,130 @@
1---
2title: Informação sobre como enviar patches para serem analisados
3x-toc-enable: true
4...
5
6Descarregue o website do TransChat do repositório Git, usando o seguinte comando:
7
8 git clone https://notabug.org/transchat/trans.chat.git
9
10Git é um sistema de controlo de versões, utilizado para hospedar o site com
11o fim de coordenar o desenvolvimento do mesmo. Pode descarregar e
12trabalhar no website inteiro, usando Git.
13
14O Software Git está disponível em Windows, MacOS, Gnu+Linux, BSD e noutras
15plataformas. Nós recomendamos vivamente que utilize Gnu+Linux ou BDS, mas
16Windows ou MacOS também funcionam. Procure no Google informação básica
17sobre como usar o Git.
18
19Algumas das instruções nesta página assumem que você usa Gun-Linux ou BSD,
20por isso você irá ter que adaptar de acordo, se usar outro sistema.
21Todxs xs administradorxs que mantêm o website usam Gnu+Linx.
22
23Você pode submeter os seus patches através de
24[pull requests no Notabug](#how-to-submit-your-patches-via-pull-requests) ou ao
25
26Editar o website e documentação, tal como se tratasse de um wiki
27-------------------------------------------------
28
29O website e respetiva documentação encontram-se dentro do diretório `www` no
30[repositório Git](#how-to-download-transchat-from-the-git-repository),
31escrito em Pandoc com certos aspetos de Markdown.
32O website é gerado em HTML estático através de Pandoc com os seguintes scripts
33em cada diretório:
34
35- index.sh: gera o feed de notícias (na secção de notícias do webisite)
36- publish.sh: converte um ficheiro .md num ficheiro .html
37- Makefile: usando chamadas aos ficheiro index.sh e publish.sh, compila o
38website inteiro do TransChat
39
40
41Use qualquer editor de texto (por exemplo Vim, Emacs, Nano, Gedit) para editar
42os ficheiros, fazer commits e [enviar patches](#how-to-submit-your-patches-via-pull-requests).
43
44Como alternativa, pode instalar um web server (por exemplo lighttpd, nginx) localmente
45e definir o documento root como o diretório *www* no seu repositório Git local.
46Com esta configuração, você pode gerar a sua versão local do website e vê-la
47ao escrever `localhost` na barra de URL do seu browser.
48
49Privacidade dxs contribuidorxs (você não tem que revelar o seu nome ou identidade!)
50-------------------------------------------------------------------------
51
52As contribuições que você faz são registadas publicamente, num repositório Git
53ao qual toda a gente tem acesso. Isto inclui o nome e endereço da pessoa
54que contribui.
55
56Você não necessita de usar informação sobre si no Git, como o seu nome e endereço
57de email. Você pode usar o nome "TransChat Contributor" e o seu email pode ser
58"contributor@transchat.org.uk". Você é permitidx a fazê-lo se desejar manter
59a sua privacidade.
60
61Obviamente que você pode escolher qualquer nome que você queira.
62
63Em termos legais. qualquer copyright é automaticamente aplicado segundo
64a Convenção da União de Berna, independentemente do nome que você usar ou mesmo
65independentemente de você declarar copyright ou não (embora nós pedimos que
66certas licenças sejam utilizadas - leia mais sobre este assunto mais à frente
67nesta página).
68
69Se você utilizar um nome e um endereço de email diferentes em cada commit/patch
70que você fizer, então você deverá manter-se suficientemente anónimx.
71
72Diretrizes gerais para submeter patches
73-----------------------------------------
74
75Nós pedimos que todos os patches sejam submetidos isentos de copyright>
76<https://www.gnu.org/licenses/license-list.html>.
77
78
79- No que toca a documentação, nós pedimos que use uma ou uma versão acima
80
81- No que toca a documentação, é obrigatório usar a GNU Free Documentation
82License v1.3
83- Recomendamos vivamente que use uma GNU General Public License v3 quando
84estiver a contribuir com código (por exemplo a trabalhar no gerador estático
85do website que este usa)
86Se não concordar em usar uma destas licensas a sua contribuição será
87rejeitada.
88
89Declare *sempre* uma licença no seu trabalho! Ao não declarar uma licença
90isso significa que as leis de copyright padrão serão aplicadas, que são restritivas,
91o que significa que o seu trabalho não será isento de copyright.
92
93Diretrizes para verificação de código programático
94------------------------------
95
96Qualquer membro do público pode [submeter um patch](#how-to-submit-your-patches-via-pull-requests).
97
98O seu patch irá ser analisado para garantir a sua qualidade e integrado se for
99aceite.
100
101Como fazer download do TransChat a partir do repositório Git
102-------------------------------------------------
103
104No seu terminal:
105
106 git clone https://notabug.org/transchat/trans.chat.git
107
108Um diretório chamado `transchat` será criado com o TransChat dentro dele.
109
110Como submeter os seus patches (via pull requests)
111----------------------------------------------
112
113Faça uma conta em <https://notabug.org/> e vá à seguinte página (depois de ter
114feito log in) <https://notabug.org/transchat/trans.chat>.
115Clique *Fork* e você irá receber um repositório do TransChat na sua conta. Faça
116uma cópia do seu repositório, faça as alterações que tem a fazer e depois
117introduza essas alterações ao seu repositório, na sua conta NotABug.
118
119Vá à página <https://notabug.org/transchat/trans.chat/pulls> e clique
120em *Novo Pull Request*.
121
122Você pode submeter os seus patches nesta página. Alternativamente, você pode fazer
123login ao canal de IRC do TransChat e chamar a atenção dos utilizadores presentes
124para patches que você quer que sejam analisados.
125
126Assim que você tenha feito um Pull Request, xs responsáveis pelo bom funcionamento
127do TransChat irão ser notificadxs via email. Se você não receber uma resposta
128suficientemente rápida a partir do projecto, então você pode notificar o projecto
129através do canal `#transchat` no Libera.
130