[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
pt-br:slackdocs:tutorial [2019/08/13 01:29 (UTC)] – criada slackjeff | pt-br:slackdocs:tutorial [2019/08/13 01:49 (UTC)] (atual) – slackjeff | ||
---|---|---|---|
Linha 1: | Linha 1: | ||
- | Work in progress | + | ====== Tutorial e Diretrizes Wiki ====== |
+ | |||
+ | |||
+ | ===== Namespaces ===== | ||
+ | |||
+ | Por favor, conheça os conceitos por trás dos **namespaces** no DokuWiki: | ||
+ | |||
+ | ==== Artigos simples ==== | ||
+ | |||
+ | Quando você está criando apenas uma //única// página, então está OK usar um dos nossos namespaces existentes: | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * Ou qualquer um dos namespaces localizados ('' | ||
+ | |||
+ | |||
+ | ==== Artigos complexos ==== | ||
+ | |||
+ | Se você adicionar novos tutoriais, etc, que são divididos em //vários artigos, conter capturas de tela etc//, é aconselhável colocá-los em seus próprios sub-títulos.[[https:// | ||
+ | |||
+ | Quando você adiciona um link dentro de uma página existente que aponta para sua nova página em seu próprio subespaço de nomes, você também precisa adicionar seu próprio namespace ao link. | ||
+ | |||
+ | Você faz isso usando [[wp> | ||
+ | |||
+ | <note tip> | ||
+ | Esse nome (dentro de um link interno normal) colocaria a página sob o '' | ||
+ | //Note que substituí o espaço em " | ||
+ | </ | ||
+ | |||
+ | Por favor, tente manter uma estrutura de namespace limpa, será muito difícil consertar todos os links se tivermos que fazer correções em locais de páginas e namespaces. | ||
+ | |||
+ | |||
+ | ===== Sintaxe e Formatação ===== | ||
+ | |||
+ | Primeiro familiarize-se com a [[wiki: | ||
+ | |||
+ | Tente manter a formatação da página o mais limpa possível: | ||
+ | * O cabeçalho do título principal de uma página deve estar em **H1**, os títulos abaixo de **H2**, os títulos em **H2** devem ser **H3** etc. | ||
+ | * Não use réguas horizontais a menos que seja necessário (por exemplo, elas não são necessárias se houver um título acima ou abaixo de onde você deseja marcar uma "nova seção" | ||
+ | * Envolva sequências de texto contendo comandos de exemplo, nomes de arquivos e texto de computador com uma marcação de " | ||
+ | |||
+ | Aqui está um exemplo de como uma página pequena poderia parecer, usando namespaces para subpáginas, | ||
+ | ====== Esta é a página ====== | ||
+ | |||
+ | Você poderia escrever uma descrição do seu artigo aqui. | ||
+ | Lembre-se de que você pode usar subpáginas (sub-namespaces), | ||
+ | |||
+ | ===== A primeira seção ===== | ||
+ | |||
+ | Alguns bla bla | ||
+ | |||
+ | [[.subpage: | ||
+ | |||
+ | ===== A segunda seção ===== | ||
+ | |||
+ | Mais texto | ||
+ | |||
+ | [[.another_subpage: | ||
+ | |||
+ | <!-- You can leave comments in your page - they will not be visible in the resulting Wiki article --> | ||
+ | <!-- Tags are essential for creating a Table Of Contents (TOC) --> | ||
+ | {{tag> | ||
+ | </ | ||
+ | |||
+ | ===== Imagens ===== | ||
+ | |||
+ | Talvez você queira incluir capturas de tela bastante grandes em seus artigos, mas exibi-los em tamanho real diretamente no artigo pode fazer com que as coisas pareçam ruins. Felizmente, você pode redimensionar a imagem diretamente no artigo. Você também pode definir o alinhamento da imagem, alguns exemplos mostrarão mais que palavras: | ||
+ | |||
+ | Redimensionar para determinada largura: | ||
+ | {{wiki: | ||
+ | E alinhamento à **esquerda/ | ||
+ | {{ wiki: | ||
+ | {{wiki: | ||
+ | {{ wiki: | ||
+ | |||
+ | Veja [[wiki: | ||
+ | |||
+ | ===== Código ===== | ||
+ | |||
+ | Você pode inserir [[wiki: | ||
+ | <code c> float a; </ | ||
+ | <code c> | ||
+ | float a; | ||
+ | float b; | ||
+ | a = b * 10 + 2 * sin1(x); | ||
+ | </ | ||
+ | Como este exemplo mostra, a legibilidade é aprimorada muito se você aplicar código[[wiki: | ||
+ | |||
+ | |||
+ | ===== Verificação ortográfica ===== | ||
+ | Por favor, muitos visitantes não têm o inglês como idioma principal. As verificações gramaticais em particular são difíceis para autores não ingleses, então não hesite em [[slackdocs: | ||
+ | |||
+ | ===== Modelo de texto ===== | ||
+ | |||
+ | Você vai notar que sempre que você criar uma nova página, você já terá algum texto pré-preenchido. Este texto vem de um dos nossos modelos - cada namespace tem um texto de modelo ligeiramente diferente. \\ O aspecto mais importante do modelo é que ele adiciona padrão [[https:// | ||
+ | |||
+ | Um exemplo de um texto de modelo: < | ||
+ | <!-- Add your text below. We strongly advise to start with a Headline (see button bar above). --> | ||
+ | |||
+ | |||
+ | <!-- Please do not add anything below, except additional tags.--> | ||
+ | <!-- However we request that you remove the tag-word " | ||
+ | |||
+ | <!-- Do not remove this line and the tag definition below. Thanks! slackdocs@--> | ||
+ | {{tag> | ||
+ | </ | ||
+ | |||
+ | ===== Uso de Páginas de Discussão ===== | ||
+ | |||
+ | É uma boa idéia usar as páginas de " | ||
+ | |||
+ | Se você quiser adicionar um comentário a uma página de discussão, reserve alguns momentos para pensar sobre o que deseja escrever //antes// clicando na guia **editar esta página**. Tente manter o tempo durante o qual você mantém a página bloqueada tão curta quanto possível, para que você não seja um obstáculo para outras pessoas que também querem comentar. | ||
+ | Quando você decide adicionar um comentário a uma página de discussão, há algumas diretrizes que você deve seguir para manter as discussões legíveis e ordenadas: | ||
+ | |||
+ | * Assine todos os seus comentários clicando no botão **Inserir assinatura** na barra de ferramentas superior do editor WYSIWYG ou usando o atalho de teclado < | ||
+ | * Use um Título **H2** para adicionar um comentário completamente novo clicando no azul **H** na barra de ferramentas do editor WYSIWYG superior ou usando o atalho de teclado < | ||
+ | * Adicione todos os comentários na parte inferior da página, a menos que você esteja respondendo. Nesse caso, adicione seus comentários diretamente abaixo da postagem à qual você está respondendo. Use os caracteres ''>'' | ||
+ | |||
+ | < | ||
+ | ===== Tópico ===== | ||
+ | |||
+ | Comentário Original | ||
+ | > A primeira resposta | ||
+ | >> A segunda resposta | ||
+ | >>> | ||
+ | </ | ||
+ | Será um pouco parecido com isto: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Você pode se inscrever nas alterações da página de discussão se quiser ser notificado de respostas clicando na guia **Gerenciar inscrições** enquanto estiver na página de discussão. | ||
+ | |||
+ | ===== Considerações sobre idiomas ===== | ||
+ | |||
+ | ==== Em inglês por favor ==== | ||
+ | |||
+ | O inglês é o idioma principal do projeto de documentação do Slackware. Isso parece natural, já que o Slackware Linux possui um instalador somente em inglês e documentação em inglês. A equipe administrativa quer evitar que esse projeto fique preso em [[wp> | ||
+ | |||
+ | ==== Então, como as contribuições não inglesas estão sendo manipuladas? | ||
+ | |||
+ | por favor, verifique [[slackdocs: | ||
+ | |||
+ | |||
+ | <!-- Do not remove this line and the text below. Thanks! slackdocs@--> | ||
+ | {{tag> |