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