Merge branch 'Portuguese_translation' into 'master'

Portuguese translation

Finished discourse part 08, fixed a typo, 2 broken links and a missing pic in the English version.
Removed the mention of the category Howto in Discourse from this tutorial EN and PT since it no longer exists

The original english version had a link to the Forum Basics tutorial originally in discourse, corrected that to the howto.disroot.org page on the same subject because that post was deleted from discourse, so the link wasn't working.
For the PT version added the "future" link wich is the same as in english only with the pt instead of en.

Also in the forum basic part in the portuguese version  added instructions on how to change discourse language to portuguese.

See merge request !23
This commit is contained in:
muppeth 2017-11-30 23:08:47 +01:00
commit 9b210d7745
33 changed files with 336 additions and 12 deletions

View File

@ -0,0 +1,44 @@
---
title: Pidgin
published: true
visible: true
taxonomy:
category:
- docs
---
Pidgin is multi-platform (runs on most operating systems) and multi-protocol messaging application. It supports a lot of different messaging protocols such as: xmpp, skype, AIM, TOX, Whatsapp, facebook etc, so you can have all your messaging done with just one app.
To setup disroot chat on pidgin, follow those easy steps:
1. **Install Pidgin.**
If you use windows/macos check [pidgin's website](http://pidgin.im/download/)and download a version for you.
If you are a linux user, check your package repository and get it. (check for some additional plugins while you're at it.
2. **Fire it up.**
You will be greeted with a welcome message like this:
![](en/pidgin1.png)
To Proceed, we need to **add an account**.
If it's not the first time you run pidgin you should use menu:
![](en/pidgin2.png)
3. **Setup account.**
First of, choose xmpp protocol from the drop-down list:
![](en/pidgin3.png)
Next fill in the information needed:
![](en/pidgin4.png)
!Note! If you wish to use avatar (optional) you can select "Use this buddy icon for this account" and browse your local filesystem (computer) for the picture you want to use.
4. Hit "**Add**" and you are done!
Now you are ready to start preaching people to ditch corporate evil apps and jump on the federation *Starship*.
![](en/pidgin5.png)
**All your contacts are synced between all the clients, so you can use disroot chat on all the devices at the same time.**

View File

@ -0,0 +1,9 @@
title: Desktop Clients
published: true
taxonomy:
category:
- docs
Título: Aplicativos de Desktop

View File

0
pages/05.XMPP/docs.pt.md Normal file
View File

View File

@ -17,8 +17,8 @@ The Discourse forum provides a simple and intuitive user interface. Even if you
# Log in first
You can log in to the forum with your Discourse account or your All-in-one Disroot account, if you have one.
Go to https://forum.disroot.org/ and click ![](forum_basics1.png?resize=64,25) on the top right corner.
**If you have a Disroot account make sure to select Login with disrootID before entering your credentials.**
Go to https://forum.disroot.org/ and click ![](en/forum_basics1.png?resize=64,25) on the top right corner.
**If you have a Disroot account make sure to select Login with disroot account before entering your credentials.**
If you don't have an account yet, you can register a Disroot account via https://user.disroot.org, which will give you additionaly access to cloud storage, email, xmpp and project board. You can also decide to create a forum only account - you will find the Sign up button at the top right of the forum page.
@ -113,10 +113,10 @@ Adding a tag makes it easier for people looking for topics or threads about a ce
![](en/forum_basics7.gif)
Once your done with composing your topic just press "Create Topic" <img src="/uploads/default/original/1X/56aca73b1e494867ce64ded3de9b6c52ab6b2af3.png" width="115" height="24">
Once your done with composing your topic just press "Create Topic" ![](en/forum_basics14.png)
# Howto mute or watch categories
In Discourse it's possible for you regulate the stream of posts you receive via the forum board or via email. You can mute categories or just a sub-category you are not interested or set categories to watch which will guarantee you will always receive notifications and emails of every post in a category or sub-category you are interested in.
In Discourse it's possible for you regulate the stream of posts you receive via the forum board or via email. You can mute categories or just a sub-category you are not interested or set categories to watch which will guarantee you will always receive notifications and emails of every post in a category or sub-category you are interested in.
If you just mute a category you will be muting all sub-categories, unless you select a specific sub-category to watch. If you mute a category or sub-category you will still be able to access it in the message board, if you want to check it from time to time. You simply just don't receive any emails or notifications about it.
@ -128,7 +128,6 @@ The current categories and sub-categories in the Disroot Forum are:
* feature
* main
* FAQ
* Howto/Tutorials
* Open Talks
* TOFU
* Engineering Yuvasamithi

View File

@ -0,0 +1,155 @@
---
title: Discourse (Fórum)- Introdução
page-toc:
active: true
published: true
visible: true
taxonomy:
category:
- docs
---
O Discourse tem um interface de utilizador simples e intuitivo. Mesmo que você esteja a usar o Discourse principalmente como uma mailing list, recomendamos que que dê uma vista de olhos no Discourse para ter uma melhor experiência de utilizador. Aqui seguem algumas dicas para começar a usar o Discourse:
# Fazer Login
Pode fazer login no fórum com uma conta de utilizador apenas para o Discourse, ou com a sua conta Disroot "tudo em um", caso tenha uma.
Vá a https://forum.disroot.org/ e carregue em ![](en/forum_basics1.png?resize=64,25) NO canto superior direito.
**Caso tenha uma conta de utilizador no Disroot, certifique-se que seleciona a opção "Login with disroot account" antes de inserir a sua password e nome de utilizador.**
Caso ainda não tenha uma conta de utilizador no Disroot, pode criar uma visitando https://user.disroot.org, o que lhe dará acesso adicional a: armazenamento cloud, email, xmpp gestor de projetos. Também pode decidir criar uma conta apenas para o fórum, encontrará o botão "Sign up" no canto superior direito da página.
# O menu de utilizador
Os botões no canto superior direito incluem, pesquisa e as suas definições pessoais de utilizador:
![](en/forum_basics2.png)
Carregue no teu ícone de utilizador o botão com a primeira letra do seu nome de utilizador, (assim que tiver uma foto de utilizador a letra será substituída por essa foto) para poder ver as suas mensagens e notificações e entrar nas definições da sua conta e área de utilizador.
Os números pequenos no topo do seu avatar indicam o número de notificações (à direita) e mensagens (esquerda) que tem. Quando clica no seu avatar verá todas as suas mensagens e notificações listadas em baixo. Também pode ver as suas mensagens através do botão ![](en/forum_basics3.png?resize=30,25).
Para entrar nas definições pessoais carregue no seu avatar e depois no ícone ![](en/forum_basics4.png?resize=23,24). Aqui pode mudar o seu avatar, ajustar o sistema de notificações, as categorias vistas e acompanhadas e muito mais.
Nestas definições pessoais pode também alterar a língua do interface para Português ou outras línguas.
# Navegação
Quando faz log in no fórum (ou quando carrega em ![](en/forum_basics5.png?resize=100,20) para regressar à página principal do fórum), irá encontrar uma lista das categorias que está a acompanhar. Categorias são como sub-fóruns. Se é membro de um grupo privado, no fórum, as categorias desse grupo serão listadas no topo da página e as restantes categorias públicas serão listadas em baixo. Mais informações sobre como seguir ou esconder certas categorias serão colocadas em breve noutro tutorial.
![](pt/forum_basics6.png)
A barra no topo permite navegar rapidamente entre os posts: Recente, Novo, Não Lido, Os Melhores. Também pode filtrar as categorias que quer ver usando o botão ![](pt/forum_basics7.png?resize=133,30).
No fim desta barra de top encontra o botão para criar uma nova thread de discussão (Novo Tópico).
Os tópicos mais recentes também aparecem listados na sua página principal, à direita do botão C
"Categorias". Quando carrega num tópico será encaminhado para o último post não lido desse tópico.
# "Continua para baixo"
Assim que estiver na thread de um tópico pode simplesmente continuar a ler a thread toda numa única página. Não há botões de "página seguinte", ou "página número X" - para continuar a ler basta continuar mover para baixo!
Á medida que novos posts chegam eles irão aparecer automaticamente na thread.
# Responder aos posts
Para enviar uma reposta no tópico use o butão ![](pt/forum_basics8.png?resize=80,29) no fim da página.
Para responder a um post específico dentro da thread use o botão ![](pt/forum_basics9.png?resize=82,30) que existe nesse post especifico.
Para inserir uma citação (de algo escrito num post anterior), selecione o texto que quer citar e depois carregue no botão "responder". Repetir este processo no caso de várias citações numa resposta!
Para ter a certeza que que alguém em particular recebe uma notificação acerca da sua resposta, cite o nome de utilizador dessa pessoa. Use uma @ antes para comecar a selecionar o nome de utilizador da pessoa em causa
Ex: `@umutilizadorqualquer`
Também pode assinalar um like, partilhar, assinalar, guardar nos um post bookmark.
![](pt/forum_basics1.gif)
Também pode convidar outro utilizador a participar numa determinada thread, carregando no botão ![](pt/forum_basics15.png?resize=80,29) no final da página.
# Criar um novo tópico
Pode criar um tópico dentro de uma categoria (support, changelog, etc) ou indo até à respetiva categoria e carregar no botão ![](pt/forum_basics10.png?resize=121,26) ou simplesmente carregar no botão novo tópico e quando estiver a compor a mensagem, escolher a categoria na qual quer que a mensagem seja postada.
![](pt/forum_basics2.gif)
# O interface
O interface é relativamente simples.
![](pt/forum_basics11.png)
O Discourse tem suporte para Markdown e HTML para compôr as mensagens. Do lado esquerdo do painel escreve o seu tópico e no lado direito do painel pode pré-visualizar como o seu tópico será apresentado.
![](pt/forum_basics3.gif)
Mas não é necessário aprender Markdown ou HTML para escrever um tópico. Pode simplesmente usar as opções de formatação de texto apresentadas na barra superior:
**Citação**, **Bold**, **Itálico**, **Lista de Items**, **Lista Númerada**, **Títulos**, **Linha horizontal**, **Emojis**. Atalhos como CTRL+b ou CTRL+I
funcionam.
![](pt/forum_basics4.gif)
## Inserir imagens e videos
Você pode inserir imagens ou vídeos no seu post, arrastando-os do para a parte da mensagem onde os quer colocar.
![](pt/forum_basics5.gif)
## Fazer upload de ficheiros para o seu tópico
Pode fazer o upload de ficheiros carregando no botão "Carregar" ![](pt/forum_basics16.png) e depois navegar pelos ficheiros até encontrar o ficheiro que quer.
![](pt/forum_basics6.gif)
## Mover ficheiros, imagens e vídeos de um sitio para o outro dentro do post
Ficheiros, imagens e vídeos são representados no lado esquerdo do ecrã (onde se pode ver o código todo do post) da seguinte forma, ex:
**Ficheiros**
> < a class="attachment" href="/uploads/default/original/1X/ffd8f38b235dbf199a919f0187ae63a183d22ada.odt">hello world.odt</a> (8.0 KB)
**Imagens**
> < img src="/uploads/default/original/1X/019a9706a4676128e452b81f450851353f36175c.png" width="690" height="347">
**Vídeos**
>https ://forum.disroot.org/uploads/default/original/1X/59b17ec97a8daabcb96a787b4900f3d3221083da.mp4
Para os mover de um sítio para o outro dentro do post que está a escrever, basta cortar a linha de texto que representa o ficheiro em causa e colá-la noutra parte do post.
Para além disso, no caso de imagens, é possível ajustar o tamanho com que vão aparecer no post alterando os valores que aparecem à direita de `height=` (altura) e `width=` (largura) na linha.
## Adicionar tags/etiquetas ao seu tópico
Adicionar um tag torna mais fácil para outras pessoas pesquisarem tópicos ou threads específicos sobre um determinado assunto. Adicionar um tag é super fácil.
![](pt/forum_basics7.gif)
Assim que tiver terminado de compor o seu post basta carregar em "Criar tópico" ![](pt/forum_basics14.png)
# Como vigiar/acompanhar ou silenciar uma categoria
No Discourse é possível regular o fluxo de mensagens que se recebe via fórum e por email. Pode silenciar uma categoria ou apenas uma sub-categoria que você não tenha interesse em seguir, ou selecionar "vigiar" categorias, o que vai garantir que receberá sempre notificações e emails da(s) categoria(s) em que está interessado.
Se silenciar uma categoria, irá também silenciar todas as suas sub-categorias, a não ser que especifique que quer vigiar alguma sub-categoria. Se "silenciar" uma categoria ou sub-categoria, será na mesma capaz aceder às mensagens no fórum, caso queira dar uma olhada de tempos a tempos. Simplesmente não receberá nenhum email ou notificação acerca desses posts/tópicos.
As categorias e sub-categorias existentes no fórum do Disroot atualmente são:
* disroot
* disroot-Changelog
* support
* feature
* main
* FAQ
* Open Talks
* TOFU
* Engineering Yuvasamithi
A melhor maneira de selecionar categorias para vigiar/silenciar é nas suas preferências, a partir daí pode fazer todas as suas escolhas a partir de um único sítio.
![](pt/forum_basics12.png)
Basta ir a **Categories** e irá ver os **campos** para **Silenciado** e **Vigiado**, escrever as que quer em cada campo e no final carregar em **Guardar as alterações** para elas entrarem em vigor.
![](pt/forum_basics8.gif)
O outro método é ir a cada categoria ou sub categoria e fazê-lo a partir daí carregando no botão à direita de "Novo tópico" ![](pt/forum_basics13.png?resize=50,25)
![](pt/forum_basics9.gif)
Pode encontrar mais dicas na [Página de boas-vindas do Discourse](https://forum.disroot.org/t/welcome-to-discourse)

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 496 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 248 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 208 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 93 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 580 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 635 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 573 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 237 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 373 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 KiB

View File

@ -15,7 +15,7 @@ Disroot, mainly hosts private forum groups. If you are interested in one, drop u
**NOTE:** To be able to be a member of a Group (Public or Private) you don't need to have a Disroot account. You can create forum only accounts.
----------
##How mailinglist works in Discourse
## How mailinglist works in Discourse
Discourse, the software used by Disroot, is a Forum software with malinglist functionalities. It has what we for this tutorial call **Groups**. And those Groups can have or not **Categories** in them (think of them as subjects or main topics).
As an example, the Disroot Group has several Categories dedicated to different subjects to organize discussions and exchange messages between users:
@ -26,7 +26,7 @@ These Groups and each Category in them can be assigned an email alias that works
![](en/forum_ml2.png)
Members of that Group receive a notification of that topic in their message board and in their emails.
Members of that Group receive a notification of that topic in their message board in their emails.
![](en/forum_ml3.png)
@ -60,12 +60,12 @@ The system described above has two main advantages:
2. Since it's possible for users of the Forum (in general) - and in this specific case, members of the Group - to select the categories of which they want to be notified and receive emails from, members of a Group can filter the Group's Categories they are not interested in, instead of being hit by a stream of messages in their mailbox.
Those settings can be changed at any time, and members of a Group/Mailinglist can always access the full content/messages of all Categories in the Forum's web interface, even those they have selected not to receive in their email.
You can read more about watching and muting categories [here](https://forum.disroot.org/t/forum-how-to-use-the-discourse-web-interface/875#watchmute) if you want.
You can read more about watching and muting categories [here](https://howto.disroot.org/en/forum/basic-usage) if you want.
The name of the Group and of the Categories, and corresponding email aliases, can be whatever you like (unless their already taken).
----------
##Private Groups/Mailinglist
## Private Groups/Mailinglist
Private Groups/Mailinglists work as described above, but like the name says they are private and can only be seen and accessed by the group's members. You can only send an email to this group if you are a member.
@ -80,7 +80,7 @@ Now you don't:
![](en/forum_ml8.png)
###Adding members to the private group
### Adding members to the private group
There are two ways to add members to a Private Group:
@ -89,14 +89,14 @@ There are two ways to add members to a Private Group:
2. The Disroot admins can send bulk invitations to all the members in one single moment and preconfigure their accounts so that they don't receive emails from other Disroot public Groups (e.g: Tutorials, Support, etc.)
----------
##Public Groups/Mailinglist
## Public Groups/Mailinglist
Public Groups work as described in above so far. The main difference from private Groups is that:
They are public, and any of the Forum users can see it's discussions, and make a post there via the Forum Web-interface (or by email if an email address is assigned). They can also be seen by people on the internet, that are not users of the Forum and can show up in results from search engines like google.
----------
##The case of Disroot's public Groups
## The case of Disroot's public Groups
The Disroot Forum public Categories (i.e, FAQ, Features, Changelog, Main, Howto / Toturials, Open Talks, etc.) don't have email aliases assigned to them so you cannot create a topic in those Categories via email.

View File

@ -0,0 +1,107 @@
---
title: Utilizar o Fórum como uma mailinglist
page-toc:
active: true
published: true
visible: true
taxonomy:
category:
- docs
---
Neste tutorial iremos explicar como o Discourse pode ser utilizado como uma mailinglist para Coletivos/Associações/Projetos.
O Disroot, alberga principalmente grupos privados no Fórum. Se está interessado num entre em contacto connosco.
**NOTA:** Para ser membro de um grupo (público, ou privado) não é necessário ter uma conta Disroot. Pode criar uma conta apenas para o fórum.
----------
## Como funcionam as mailinglists no Discourse
O software utilizado pelo Disroot, o Discourse é um software de fórum com funcionalidades de mailinglist. Tem, aquilo que para efeitos deste tutorial iremos chamar **Grupos**. E esses grupos podem ter, ou não, **Categorias** dentro deles (como se fossem assuntos ou tópicos principais dentro de um grupo).
Por exemplo, o grupo Disroot tem várias categorias dedicadas a tópicos diferentes para organizar discussões e trocar mensagens entre utilizadores:
![](en/forum_ml1.png)
Cada um destes grupos ou categorias pode ter um alias de email, que funciona como se fosse o endereço da mailinglist, que pode ser usado para criar um tópico por email (webmail or cliente de email) num respectivo grupo ou categoria.
![](en/forum_ml2.png)
Os membros desse grupo recebem a mensagem tanto no fórum como nos seus emails.
![](en/forum_ml3.png)
![](en/forum_ml4.png)
E podem responder à mensagem tanto através do fórum como por email, como preferirem.
![](en/forum_ml5.png)
Isto permite criar um sistema que pode ser usado tanto por fãs de fóruns como por fãs de malinglists.
Você pode ter um grupo com apenas uma categoria e um alias de email atribuído. Ou se for um coletivo grande, com grupos de trabalho, pode ter um grupo com várias categorias, cada um com um alias de email diferente e a funcionar como uma mailinglist autónoma. Algo deste género:
> * **Grupo** (Coletivo/Projecto/Associação)
> * **Principal/Geral/Assembleia**
>alias de email: **assembleia_grupo@disroot.org**
> * **Categoria1**
>alias de email: **Categoria1_grupo@disroot.org**
> * **Categoria2**
>alias de email: **Categoria2_grupo@disroot.org**
> * **Categoria3**
>alias de email: **Categoria3_grupo@disroot.org**
O sistema descrito em cima tem duas vantagens principais:
1. Se é membro de um coletivo/associação/projeto com grupos de trabalho, pode dividir a discussão dos grupos de trabalho ou tópicos pelas diferentes categorias em vez de ter tudo à mistura numa única mailinglist.
2. Tendo em conta que é possível para os utilizadores do fórum (no geral) e neste caso em particular, os membros do grupo, selecionar as categorias cujas mensagens que querem receber no seu email. Os membros do grupo, podem na prática filtrar as categorias que não tem interesse receber mensagens de email em vez de levarem com um grande fluxo de mensagens na sua caixa de entrada do email.
Estas definições podem ser alteradas a qualquer momento e os membros de um grupo/mailinglist podem sempre ter acesso às mensagens de todos os grupos/categorias no interface web do fórum, incluíndo aquelas que selecionaram não receber por email.
Se quiser pode ler mais sobre como selecionar "Vigiar" e "Silenciar" categorias no fórum [aqui](https://howto.disroot.org/pt/forum/basic-usage).
O nome do grupo e as respectivas categorias e os alias de email correspondentes podem ser o que você quiser (a não ser que já estejam a ser usados).
----------
## Grupos/Mailinglist privados
Grupos/Mailinglists privadas funcionam como foi descrito em cima, mas tal como o nome indica são privadas e apenas podem ser vistas e acedidas pelos membros do grupo. Apenas pode enviar um email para esse grupo se for membro.
No interface web do fórum os grupos privados apenas podem ser acedidos pelos seus membros e aparecem representados por um cadeado ![](en/forum_ml6.png?resize=20,21). Quando faz log in no fórum, os grupos privados a que pertence aparecem sempre no topo.
Pessoas que não são membros dos grupos privados nem conseguem ver que o grupo existe.
Agora vês:
![](en/forum_ml7.png)
Agora não:
![](en/forum_ml8.png)
### Adicionar participantes a um grupo privado
Há duas maneiras de adicionar participantes a um grupo privado:
1. Quem administra o grupo pode adicionar participante individualmente. Mas isto tem dois inconvenientes, os participantes são adicionados um a um, segundo é necessário configurar as definições de cada participante individualmente (ex: silenciar mensagens de grupos públicos no fórum do Disroot, para que os membros do grupo privado não recebam mensagens de grupos públicos que não queiram.
2. Os administradores do Disroot podem enviar convites em larga escala de uma única vez com as pré-definições já todas feitas de modo a que os membros do grupo privado não recebam emails de grupos públicos do fórum (ex: Changelog, Support, etc.)
----------
## Grupos/Mailinglist públicos
Grupos públicos funcionam como descrito em cima. A principal diferença é que:
São públicos, qualquer utilizador do fórum pode ver os tópicos e discussões e fazer um post via o interface web do fórum (ou por email se o grupo tiver um alias de email atribuído). Também podem ser vistos por pessoas na Internet, que não são utilizadores do fórum e podem aparecer em resultados de motores de busca como por exemplo o google.
----------
## O caso dos grupos públicos do Disroot
As categorias públicas do Disroot no fórum (ex: FAQ, Features, Changelog, Main, Open Talks, etc.) não tem alias de email atribuídos por isso não é possível criar um tópico via email nestes grupos e nas suas respetivas categorias.
Apenas pode responder via email quando recebe o post na sua caixa de correio.
----------

10
pages/08.Forum/docs.pt.md Normal file
View File

@ -0,0 +1,10 @@
---
title: Discourse - Forum
published: true
taxonomy:
category:
- docs
---
Em breve.