Outras línguas Deutsch ; English ; Español ; Français ; Nederlands ; Português (Brasil) ; Português (Portugal) ; Türkçe ; |
Contents
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:
- 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".
- 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.
- 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:
- Peça credenciais aqui
- Junte-se à Mageia docteam
- 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: #mageia-doc no Liberachat.
- Tome cuidado com sua escrita / ortografia / sintaxe. Não hesite em pedir ajuda ou conselhos, se necessário.
- Tente ter um bom layout. As capturas de tela devem ser legíveis, mas não muito grandes (geralmente 600px é suficiente)
- 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:
Chaves:
- A própria página wiki,
- A página de discussão, onde os escritores podem explicar seu trabalho, compartilhar idéias e resolver seus problemas
- Modo de leitura normal
- Visualize a 'linguagem de marcação' da fonte real usada para criar uma página específica
- Uma lista cronológica de todas as edições no wiki e a opção de revertê-las
- Você precisa estar logado no wiki para fazer qualquer edição
- O mecanismo de busca da wiki
- 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:
Chaves:
- 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.
- Lista suspensa com duas opções, "Move" e "Watch" / "Unwatch"
- 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 dois == | |
=== Título de nível três === | |
==== Título de nível quatro ==== | |
===== Título de nível cinco ===== | |
====== Título de nível seis ====== |
Formatando Texto
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 | |
{{cmd-pt-PT|command name}} | command name
|
{{menu-pt-PT|menu -> submenu}} | menu -> submenu
|
{{file-pt-PT|file name}} | file name
|
{{prog-pt-PT|program name}} | program name
|
{{core-pt-PT}} | core repositories
|
{{nonfree-pt-PT}} | nonfree repositories
|
{{tainted-pt-PT}} | tainted repositories
|
{{core-pt-PT|backports}} | backports
|
<pre> text in presentation mode</pre> | text in presentation mode |
The lines |
The lines
|
<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 |
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 |
|
# ordered list, first line |
|
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
Note: Sobre as capturas de tela, recomendamos que elas tenham 800 pixels de largura. A legenda é altamente desejável. |
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.
Template names | Templates presentation. | Templates use |
---|---|---|
Template used only to emphasize the importance of using templates. | ||
Template | This template is used only for the templates. | Template:template
|
Templates to introduce and translate the pages into other languages. | ||
Multi language banner | This template is used to present pages in other languages. | Template:Multi language banner
|
TranslationOverview | This template is used to present the synchronization state of the translation. | Template:TranslationOverview
|
Templates to highlight frequently used information. | ||
Introduction | This template provides a brief summary of the page. | Template:Introduction
|
Note | This template displays general information. | Template:Note
|
Code | Formated <code> </code> tags. | Template:Code
|
Pre | Formated <pre> </pre> tags. | Template:Pre
|
Installation | This template is used to quickly present the installation procedure of a package. | Template:Installation
|
format text-pt-PT | Template needed to format text-pt-PT in a template. | Template:format text-pt-PT
|
Wp | This template provides a shortcut to a Wikipedia page. | Template:Wp
|
Templates to draw user' attention to a particular point.. | ||
Warning | This template displays an information, to attract the user's attention. | Template:Warning
|
Templates to draw people's attention to a risky intervention. | ||
Dragons | This template is used to present a significant risk. | Template:Dragons
|
Templates to highlight articles in progress. | ||
Draft | This template indicates that a page is being edited. | Template:Draft
|
Fixme | This template signals a request for more information on a particular paragraph. | Template:Fixme
|
Templates for highlighting positive and negative information in a table. | ||
Yes | This template should be used to highlight the "yes" answer or positive information in a table. | Template:Yes
|
No | This template should be used to highlight the "no" answer or negative information in a table. | Template:Non
|
Templates to highlight single or input and output command lines. | ||
command | Displays only one command line. | Template:command
|
output | Displays a command input and output. | Template:output
|
Templates to present a command line, a file, or a folder in an article. | ||
cmd | This template highlights a command line in a paragraph. | Template:Cmd
|
File | This template highlights a file name in a paragraph. | Template:File
|
Folder | This template highlights a folder name in a paragraph. | Template:Folder
|
Prog | This template allows highlighting the programms. | Template:Prog
|
Menu | This template highlights the hierarchy of a menu. | Template:Menu
|
Templates to highlight the different repositories. | ||
Core | This template highlights the core repository. | Template:Core
|
Nonfree | This template highlights the Nonfree repository. | Template:Nonfree
|
Tainted | This template highlights the Tainted repository. | Template:Tainted
|
These templates are transparent to users, but technically required. | ||
withbr | This template includes code to force a line break. | Template:withbr
|
= | This template used for the inclusion of this sign in the argument of a template. | Template:=
|
Stop | This template is required to build other templates. | Template:Stop
|
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.
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.
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