From Mageia wiki
Jump to: navigation, search


Introdução

Esta página foi escrita para ajudar qualquer pessoa que queira escrever, modificar ou traduzir páginas no Wiki da Mageia. Eles devem participar da Mageia docteam

A Mageia usa este wiki para atender a três necessidades principais:

  1. Ajudar as equipes da Mageia a coordenar suas ações (relatórios, programações, regras, listas de tarefas, ...). Todas essas páginas pertencem à categoria "Doc".
  2. Fornecer informações sobre os lançamentos para os usuários finais da Mageia - principalmente Erratas e Notas de Lançamento para cada lançamento. Estas páginas pertencem à categoria "Mageia n". ou seja, Mageia 6 Errata.
  3. Fornecer documentação extra para os usuários finais da Mageia. Todas essas páginas pertencem à categoria "Documentação".

Até agora, o wiki é apenas em inglês, no entanto, espera-se que uma extensão em vários idiomas esteja pronta em breve ([# #Como traduzir uma página | veja a seção ainda não escrita abaixo]] :)).

Requisitos

Generalidades

Para poder escrever, modificar ou traduzir páginas no wiki da Mageia, siga estas regras simples:

  1. Peça credenciais aqui
  2. Junte-se à Mageia docteam
  3. Inscreva-se na lista de discussão doc-discuss@ml.mageia.org e diga o que você pretende fazer. É a maneira mais fácil de coordenar nossas ações, compartilhar ideias e obter ajuda. Você também pode usar o canal de IRC: [irc: //irc.freenode.net/#mageia-doc # mageia-doc] no Freenode.
  4. Tome cuidado com sua escrita / ortografia / sintaxe. Não hesite em pedir ajuda ou conselhos, se necessário.
  5. Tente ter um bom layout. As capturas de tela devem ser legíveis, mas não muito grandes (geralmente 600px é suficiente)
  6. Leia e respeite a Mageia Código de conduta

Para que serve o wiki?

  • Documentação colaborativa de boa qualidade sobre os projetos da Mageia:
    • Expondo o projeto Mageia, é espírito e objetivos, as ferramentas incluídas, equipes e processos internos.
    • Oferecendo alguma documentação técnica clara sobre os processos de instalação / migração e configuração para infraestruturas de computadores de pequeno e grande porte.
    • Documentando ferramentas e programas que são entregues com, ou que podem ser instalados na Mageia.
    • Explicando a estrutura da comunidade; para ajudar os contribuidores a participarem e participarem facilmente de acordo com seus interesses, habilidades e necessidades.
  • Informações úteis e dicas dentro de artigos.
  • Para usuários finais e usuários avançados / administradores.
  • Para aplicativos de desktop e servidor.
  • Para a comunidade.

Para que o wiki não deve ser usado?

Duplicar informações de recursos existentes, como:

    • Um site e um blog da Mageia oficial,
    • Um canal de notícias / blog (Mageia planet),
    • Páginas para informações de grupos individuais.
  • Um lugar para hospedar as páginas de projetos individuais,
  • Um F.A.Q, site de perguntas e respostas ou qualquer tipo de plataforma de suporte (ver site oficial ou site dedicado para tais ferramentas),
  • Official online ou documentação off-line.

Funcionalidades de uma página wiki

Antes de entrar

Esta é a aparência de uma página wiki antes do login:

Wiki-Pt-1.png

Chaves:

  1. A própria página wiki,
  2. A página de discussão, onde os escritores podem explicar seu trabalho, compartilhar idéias e resolver seus problemas
  3. Modo de leitura normal
  4. Visualize a 'linguagem de marcação' da fonte real usada para criar uma página específica
  5. Uma lista cronológica de todas as edições no wiki e a opção de revertê-las
  6. Você precisa estar logado no wiki para fazer qualquer edição
  7. O mecanismo de busca da wiki
  8. Nesta caixa de ferramentas, "Páginas especiais" é útil, pois fornece muitas estatísticas e "Categorias" lista todas as categorias existentes (veja abaixo como adicionar categorias a uma página).

Após o login

Depois de inserir seu login e senha, novas ferramentas estarão disponíveis:

Wiki-Pt-2.png

Chaves:

  1. Opções de configuração. <login> ("cmoifp" na imagem) é sua própria página de usuário, um lugar onde você pode se apresentar - ou até mesmo como um lugar para testar seu trabalho no wiki. "Minha palestra" é a página de discussão da sua própria página. "Minhas preferências" permite personalizar a interface (ou seja, o idioma preferido). As entradas restantes são auto-explicativas.
  2. Lista suspensa com duas opções, "Move" e "Watch" / "Unwatch"
  3. Na Caixa de Ferramentas, "Enviar arquivo" para fazer upload de arquivos (geralmente imagens ou capturas de tela) no wiki. É altamente recomendável ler o que esta página diz.

Sintaxe principal

Generalidades

Aqui estão os comandos básicos para iniciar uma página e / ou fazer algumas pequenas modificações. Para mais informações, consulte os links links abaixo e o Google é seu amigo. Lembramos que este wiki é desenvolvido por MediaWiki.

Títulos

Em nosso wiki, o nome da página aparece automaticamente como um título para a página (atualmente como "Wiki" Nome da Página "). No entanto, se você quiser um título (um pouco) diferente, limite o uso de um parágrafo de primeiro nível "=" apenas para o título da página. Nesse caso, use o segundo nível "==" e abaixo para o conteúdo da página em vez do primeiro nível "=" e abaixo. Cabe a você se você usar o espaço em branco entre as tags e o conteúdo. O wiki irá ignorar os espaços ao renderizar a página.


What you write What you get
= Título de nível um = Título de nível um
== Título de nível dois == Título de nível dois
=== Título de nível três === Título de nível três
==== Título de nível quatro ==== Título de nível quatro
===== Título de nível cinco ===== Título de nível cinco
====== Título de nível seis ====== Título de nível seis

Formatando Texto

Notepad.png
Please note!
Há formatação especial para comandos, menus, programas e arquivos.


O que você escreve O que você tem
' 'italic' ' italic
' ' 'bold' ' ' bold
' ' ' ' 'italic and bold' ' ' ' ' italic and bold
tags <s> and </s> to cross the text tags <s> and </s> to strikethrough the text
{{cmd|command name}} command name
{{menu|menu -> submenu}} menu -> submenu
{{file|file name}} file name
{{prog|program name}} program name
<pre> text in presentation mode</pre>
 text in presentation mode

The lines
:can be
::indented
:::on several levels

The lines

can be
indented
on several levels
<span style="color: red;">some text in red</span> some text in red
<span style="color: blue;">some text in blue</span> some text in blue
<span style="color: green;">some text in green</span> some text in green
<span style="color: orange;">'''some text in bold and orange'''</span> some text in bold and orange
<span style="color:#FF00FF;">some text in any color</span> some text in any color
Insert the right tag <br> to have a line break Insert the right tag
to have a line break

Links e âncoras

What you can do What you write What you get
Link to a Mageia wiki page (i.e.: the wiki welcome page).
(1) Without name
(2) With the name "Welcome"

[[Main_Page]]
[[Main_Page|Welcome]]

[1]
Welcome
Link to a URL (i.e.: the Mageia official doc.).
(1) Without name
(2) With the name "Documentation"

[http://www.mageia.org/fr/doc/]
[http://www.mageia.org/fr/doc/ Documentation]

[2]
Documentation
Add an anchor named "anchor1" to the word "text" some existing <span id="anchor1">text</span> in a page some existing text in a page
Create a link to "anchor1" click [[#anchor1|here]] to go to the anchor1 click here to go to the anchor1
Create a link to the anchor "Hardware" in the wiki page "Documentation" see [[Documentation#Hardware|here]] see here
Notepad.png
Please note!
Each title is an anchor by default. Its name is the title itself.



Listas

What you write What you get

* unordered list, first line
* unordered list, second line
** unordered list, third line
** unordered list, fourth line

  • unordered list, first line
  • unordered list, second line
    • unordered list, third line
    • unordered list, fourth line

# ordered list, first line
# ordered list, second line
## ordered list, third line
## ordered list, fourth line
##* both, fifth line
# back ordered list

  1. ordered list, first line
  2. ordered list, second line
    1. ordered list, third line
    2. ordered list, fourth line
      • both, fifth line
  3. back ordered list

Tabelas

Existem muitas opções no MediaWiki para desenhar tabelas (veja this page para mais informações). No entanto, para uma tabela simples, você pode usar este exemplo abaixo.

  • Na primeira linha, substitua o "1" após "border =" pela espessura da borda desejada (em pixels), substitua "center" por "left" ou "right" (sem o ") e substitua" 800 "por sua largura desejada.
  • Na segunda linha, você pode incluir opcionalmente títulos de coluna, separados por "!!".
  • No restante, adicione ou remova as células da tabela (indicadas como "|"). O "| -" é usado para criar uma linha real.

O que você escreve (você pode usar copiar/colar para criar uma tabela como essa em sua página):

{|border="1" class="wikitable" style="text-align:center; width:800px;"
! First column!! Second column!!Third column
|-
|column1 - cell1
|column2 - cell1
|column3 - cell1
|-
|column1 - cell2
|column2 - cell2
|column3 - cell2
|-
|column1 - cell3
|column2 - cell3
|column3 - cell3
|}

O que você tem:

First column Second column Third column
column1 - cell1 column2 - cell1 column3 - cell1
column1 - cell2 column2 - cell2 column3 - cell2
column1 - cell3 column2 - cell3 column3 - cell3

Images

Notepad.png
Please note!
Sobre as capturas de tela, recomendamos que elas tenham 800 pixels de largura. A legenda é altamente desejável.


What you write What you get
[[image:wiki3.png]] Wiki3.png
[[image:wiki3.png|100px]] Wiki3.png
[[image:wiki3.png|center|100px]] Wiki3.png
[[image:wiki3.png|right|80px]] Wiki3.png
[[image:wiki3.png|center|100px|thumb|none|Legend here]]
(Without the "none" option, the text is floating around the image.)
Legend here

Modelos

Entre outros usos, os modelos podem ser usados para destacar algo importante. Os modelos permitem que você faça isso de maneira rápida e consistente.

Notepad.png
Please note!
Para escrever uma nota, escreva {{note|Text ...}}



Warning.png
Warning!
Para escrever um aviso, escreva {{warning|Text ...}}



Dragon.png
Here be Dragons!
Para dar uma dica, escreva {{dragons|Text ...}}



Info.png
Information:
Para dar informações, escreva {{information|Text ...}}



Para marcar uma página como rascunho, escreva {{draft}} no topo de uma página, e você obterá este banner:

THIS PAGE IS A DRAFT

It requires improvements. If you want to improve it, simply log in and click on the Edit tab.

Please remove this {{Draft}} template, when you're sure the page is complete and correct.


Konsole.png
[root@computer ~]# Para mostrar um comando para ser digitado em um console como root, escrever {{root console|command line}}
[root@computer ~]# _


Konsole.png
[user@computer ~]$ Para mostrar um comando para ser digitado em um console como um usuário normal, escreva {{Console|command line}}
[user@computer ~]$ _


Categorias

A tag especial que você mais usa é uma tag de categoria:

Syntax: [[Category:category name]]

Example: [[Category:Documentation]]

O wiki está configurado para que, se você colocar essa tag em qualquer lugar na sua marcação, um link para a página de índice da Categoria da Documentação apareça automaticamente na parte inferior da sua página wiki, contida em uma caixa bonita. Sua página também aparece automaticamente na página de índice "Documentação". Nenhum trabalho extra de sua parte. Usamos "Doc" para documentos internos da Equipe do Doc, "Documentação" para documentos públicos gerais e também várias subcategorias. É melhor sempre usar "Doc" ou "Documentation" e adicionar outras categorias conforme necessário.

Notepad.png
Please note!
Embora seja possível colocar as tags Category em qualquer lugar, é melhor colocá-las no topo - sim, o TOP do documento, com um pouco de espaço em branco antes de começar a escrever a página. Isso é importante, pois evita que as tags sejam excluídas acidentalmente quando o conteúdo da página é editado e facilita encontrá-las quando você tem uma longa página wiki..


Use quantas categorias forem necessárias que façam sentido. Uma lista de categorias disponíveis pode ser encontrada Aqui.

Assinatura

Não há necessidade de assinar uma página, pois ela está no histórico de edições, mas às vezes você pode querer assinar algo. Por exemplo, é muito útil na guia de discussão. É também uma maneira conveniente de se vincular à sua própria página Usuário: (onde você pode testar suas páginas antes de liberá-las no wiki).

What you write What you get
~~~ lebarhon
~~~~ lebarhon 17:32, 23 June 2014 (UTC)
~~~~~ 17:32, 23 June 2014 (UTC)

Links Úteis

http://en.wikipedia.org/wiki/Help:Wiki_markup

http://www.mediawiki.org/wiki/Help:Tables/fr

http://www.mediawiki.org/wiki/Help:Images

http://en.wikipedia.org/wiki/Help:Table

http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style


Como modificar uma página

Generalidades

Tudo o que você precisa fazer é clicar no link Editar na parte superior da página (tornando toda a página editável de uma vez) ou clicar em Editar à direita do título de cada seção (para editar apenas essa seção). Este link leva você para a página de edição e mostra o código wiki da página atual.

No canto superior esquerdo da página, há um menu para formatação básica. Wiki4.png
Uma mensagem de ajuda aparece quando o mouse passa sobre um ícone.

Na parte inferior da página, há uma seção "Resumo" para você comentar sobre suas alterações. Por favor, preencha este espaço, para que outros colaboradores possam acompanhar mais facilmente o que foi feito no histórico da página.

Você também pode especificar duas opções:

  • 'Esta é uma edição menor' para que os outros saibam que as mudanças que você fez são menores (basicamente, qualquer coisa que não altere fundamentalmente o significado ou a aparência de uma página).
  • 'Assista esta página' permite que você seja informado por e-mail de modificações na página (exceto pequenas modificações).

E finalmente 3 botões:

  • 'Salvar página' para salvar seu trabalho (atalho do teclado: Alt-Shift-S)
  • 'Mostrar pré-visualização' para ter uma ideia de como ficará a página antes de salvar (Alt-Shift-P)
  • 'Mostrar alterações' para ver claramente as diferenças entre a página salva e a que você está editando.

É altamente recomendado que você sempre visualize sua página ANTES de salvar as modificações que você acabou de fazer, para evitar erros.

Não hesite em adicionar alguns comentários na guia "Discussão".

Cancelando uma modificação e retornando a um estado anterior

Isso é chamado de reverting.

Como criar uma página

1. Certifique-se de que a página ou uma página semelhante que pode ser expandida / concluída ainda não exista. 2. Informe a lista de discussão - talvez alguém tenha trabalhado ou planeje trabalhar em uma dessas páginas. 3. Encontre um bom título (veja a subseção abaixo). Isso é importante, pois renomear páginas não é trivial.
4. Faça o login no wiki
5. Escreva seu título na área de busca (chave 7 veja isso captura de tela) e clique em "Pesquisar", aceite para criar a página com um clique no título.
6. A nova página é aberta no modo de edição. Se desejar, você pode copiar / colar essa amostra na nova página:


{{draft}}

[[Category:Documentation]]

== Introduction ==

7. Adicione outras categorias e / ou remova "Documentação" se necessário
8. Sempre tem uma seção "Apresentação" / "Introdução" para explicar o que a página trata. 9. Veja Como modificar uma página

Nomeação de página e seção

  • Tente colocar palavras-chave precisas nos mecanismos de pesquisa
  • Tente não fazer títulos de páginas por mais tempo do que o necessário
  • Escreva o título com espaços comuns entre as palavras, (deixe o wiki gerenciar o "_")
  • Não aninhe páginas em subpastas, por ex. Tópico / FAQ
  • Use nomes de linguagem natural (em oposição ao aninhamento)
  • Use letras maiúsculas somente para a palavra inicial em um título ou título da seção: "Like this"
    • Exceções: nomes próprios e os títulos / capítulos de guias de documentação formais e completos que estão convertendo para XHTML / XML
    • Exemplos: "Junte-se ao Projeto Foo"; "Configurando a mídia de inicialização USB"; "FAQ no SELinux"

Como traduzir uma página

Na ausência de um wiki multilíngue

Nesse caso, há apenas o namespace [en] e abriga todos os idiomas.

  • Avise a lista de discussão para dizer que você irá traduzir uma página wiki
  • Criar uma nova página com um título que é composto do título original traduzido seguido por -xy. xy sendo as letras simbólicas do idioma,
    • Exemplo: O título para esta mesma página traduzida em francês deve ser "Comment écrire une page wiki-fr", em alemão "Erstellen einer Wiki Seite-de",
  • Adicione um link para cada página traduzida existente à sua nova página traduzida e vice-versa. Esses diferentes nomes de idiomas devem ser escritos em seu próprio idioma. Isso significa, por exemplo: English, français, Deutsch, ... Para as páginas em inglês e francês, existe um banner.
  • Faça capturas de tela o mais próximo possível das originais. Adicione o texto, se necessário
  • Adicione o idioma categoria se já existente, se não perguntar a lista de discussão, e as outras categorias também.

Quando tivermos um wiki multilíngue

To be written after such wiki update lebarhon 12:59, 8 June 2014 (UTC)

Gerenciamento Wiki

To be written by a wiki manager lebarhon 13:00, 8 June 2014 (UTC)

  • Como arquivar uma página?
  • Como apagar fotos?
  • Como renomear uma página?
  • Sobre a manutenção do wiki:
    • dicas sobre como ver se uma página foi importada de outro lugar e como verificar sua licença original
    • quando mover ou remover uma página
    • o que fazer com todas as páginas "Rascunho"
    • etc