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