Como começar

  • Revision slug: Project:Como_começar
  • Revision title: Como começar
  • Revision id: 269054
  • Created:
  • Creator: AndreGazola
  • Is current revision? Não
  • コメント /* Migrating old documentation */

Revision Content

Ajudar o MDC é simples como usar o seu browser. Se você preenche campos de formulários na web ou usa uma caixas de texto para postar em weblogs, você tem todas as habilidades com o browser necessárias para começar.

Introdução

Sinta-se encorajado a escrever, editar, revisar, e traduzir qualquer documentação que encontrar neste wiki. Por favor faça isso com espírito cooperativo pensando na melhoria do conteúdo, entretanto, não se sinta desapontado se alguém mais tarde fizer algumas correções ou melhorias em seu conteúdo. Nós estamos aqui para tornar a documentação da Mozilla cada vez melhor (salva de spammers), cooperando, trabalhando juntos, ajudando e encorajando a todos.

O básico

Aqui está um pequeno guia sobre como editar e criar páginas no wiki do MDC. Você é bem vindo a praticar suas habilidades em wikis na Sandbox:Test Page.

Editando páginas

Simplesmente clique no atalho Criar Conta e preencha os campos. É preciso ter uma conta e de identificar-se para poder editar páginas. Estes passos são necessários pois permitem lutar contra ações de vandalismo e torna mais fácil registrar (e agradecer-lhe pelas) contribuições.

Na coluna da direita de todas as páginas você vai ver um link "Editar". Clicando neste link você será levado a uma página onde poderá editar o conteúdo fazendo as alterações que achar necessárias, pré-visualizá-las, então salvá-las no Wiki. Uma vez salvas, você pode ver suas modificações imetiatamente na página

Iniciando uma nova página

O caminho mais fácil para criar uma nova página é criar um link para ela em sua página de usuário, então use este link para entrar no modo de edição da página.

Para chegar até sua página de usuário, clique em seu nome de usuário no topo da página do wiki. Se você ainda não adicionou nada em sua página, você será levado imediatamente para o formulário de edição da página, onde poderá adicionar o conteúdo que quiser.

Criar um link à página que você quer adicionar é tão simples quanto escrever o título para a página incluído entre colchetes, como este: [[Este é um exemplo]]. Quando salvo, isto se tornará um link, como este: Este é um exemplo.

Caso a página não exista, o link será vermelho, caso exista, será azul. Se você pretende criar uma página e o título que você deseja incluir já esteja sendo examinado, verifique antes se você pode ajudar a editar e melhorar o artigo existente. Caso contrário, pense em um título diferente para sua página e crie um link para ela.

Quando você quiser adicionar conteúdo em sua página nova, simplesmente clique no link vermelho que você criou e comece a escrever. Lembre-se de usar o botão "Salvar página" no final do formulário de edição para salvar seu trabalho (frequentemente, se você estiver trabalhando em uma parte longa).

Guia para nomeação de páginas

Para mais informações sobre criar e nomear páginas novas, veja nosso Guia para nomeação de páginas.

Marcação do Wiki

Se você clicar em "Editar" na coluna da direita, você verá que o texto desta página contém alguns caracteres especiais, por exemplo os "==" entre os títulos e os "[{{mediawiki.external(' ]')}}" entre os links. Esta é uma forma muito simples de marcação textual que é exclusiva de sistemas wiki. O poder deste tipo de marcação reside no fato de que é muito fácil de aprender e pode ser facilmente corrigido caso ocorra algum erro.

Referência de marcação no Wiki

Nós temos uma completa referência de marcação onde você pode aprender a linguagem com a qual pode editar e escrever textos dentro do Wiki.

Escrevendo, editando e revisando

Aqui está uma pequena introdução do MDC para escritores, editores e revisores

Escritores

O MDC está sempre interessado em novos conteúdos, então sinta-se encorajado a escrever novos artigos quando quiser relacionados aostópicos que o wiki abrange. Um novo conteúdo pode ser uma simples página de dicas ou algo tão complexo quanto um guia de referência de programação. A quantidade que você deve escrever é uma decisão que cabe inteiramente a você.

Caso você esteja empreendendo um grande projeto, sugerimos que você entre na Comunidade MDC e discuta suas idéias primeiramente lá, apenas para tomar conhecimento se alguém está planejando ou já iniciou um projeto similar.

Consulte o guia do escritor se você tem dúvidas sobre o estilo ou políticas de uso dentro do wiki.

Editores

Edição é sempre bem-vinda em nosso Wiki, particularmente para melhorar ou corrigir o estilo de escrita ou gramática. Por favor, veja nosso guia do escritor para maiores informações.

Revisores

Melhorias técnicas e revisões são sempre bem-vindas aqui, então se você estiver lendo uma página e encontrar um erro técnico (seja ele no código ou no texto), por favor sinta-se livre para corrigí-lo. Caso esta mudança cause alguma controvérsia, faça uma observação na página de "talk" (clicando no link "Discussion" na coluna da direita") e deixe uma nota explicando as razões de sua modificação.

Guia do escritor

Nós possuímos um Guia do escritor frizando o estilo preferencial de escrita . Se você tiver alguma dúvida sobre algum estilo não explicado aqui, recomendamos a seguinte consulta: Economist style guide ou, se ainda assim não estiver satisfeito, esta: Chicago Manual of Style.

Nós iremos expandir o guia no decorrer do tempo, então caso você tenha dúvidas específicas não explanadas no Guia do escritor, por favor envie-a para a lista de e-mails da MDC ou para oadministrador do projeto, assim saberemos que ela deve ser adicionada.

Migrando documentações antigas

Um dos maiores sub-projetos do MDC é migrar toda a documentação que existe atualmente em mozilla.org para o wiki. Este procedimento é simples:

  1. Escolha um documento que você gostaria de migra da lista de conteúdo existente.
  2. Consulte o Guia de nomeação de páginas e decida como as páginas daquele documento devem ser chamadas no wiki.
  3. Crie estas páginas e migre o conteúdo, formatando-o da melhor forma que você puder, conforme o Guia de referência de marcação.
  4. Delete o item dalista de conteúdo existente.
  5. Adicione o item na lista de redirecionamento.

Caso você queira fazer um trabalho realmente bom, poderá também:

  1. Usar nosso sistema de busca para procurar por qualquer link do documento original do wiki, então alterá-lo em sua nova página.
  2. Checar por redirecionamento externo ao documento original, e marcar estes redirecionamentos para deleção colocando-os na categoria "Sucata" adicionando [[Category:Junk]].

Localizing the MDC

If you're interested in helping translate the documentation in any of the MDC wikis to another language, you can do so simply by visiting the relevant language's wiki and editing/creating pages.

Localização de projetos existentes

Atualmente o MDC possui wikis para as seguintes línguas: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어.

How to start a new localization project

If you would like to start a new localization project for a language we don't currently have a wiki for, please read the localization projects page and follow the instructions there.

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please first try to resolve the conflict with the people involved.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDC mailing list or (as a last resort) the MDC project lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding [[Category:Junk]] to the bottom of the page.

The Junk category is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Juntando-se à comunidade MDC

O Mozilla Developer Center é em sua maior parte formado pelo trabalho de um grupo de voluntários, e nós estamos sempre felizes para ajudar escritores e editores novos a se envolverem.

Listas de e-mail e newsgroup

A maior parte do planejamento e discussão do projeto MDC ocorre no Grupo Google, na lista de e-mail e newsgroup.

Se você tiver algum problema com a lista, ou tiver alguma pergunta, sinta-se livre para entrar em contato com um administrador.

IRC

Você é bem vindo para juntar-se ao canal #mdc-pt em irc.mozilla.org.

Administradores do MDC em português

Os administradores da versão em língua portuguesa do Mozilla Developer Center são os seguintes:

{{ wiki.languages( { "en": "Project:en/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek" } ) }}

Revision Source

<p>
</p><p>Ajudar o MDC é simples como usar o seu browser. Se você preenche campos de formulários na web ou usa uma caixas de texto para postar em weblogs, você tem todas as habilidades com o browser necessárias para começar.
</p>
<h3 name="Introdu.C3.A7.C3.A3o"> Introdução </h3>
<p><b>Sinta-se encorajado a escrever, editar, revisar, e traduzir qualquer documentação que encontrar neste wiki.</b> Por favor faça isso com espírito cooperativo pensando na melhoria do conteúdo, entretanto, não se sinta desapontado se alguém mais tarde fizer algumas correções ou melhorias em seu conteúdo. Nós estamos aqui para tornar a documentação da Mozilla cada vez melhor (salva de spammers), cooperando, trabalhando juntos, ajudando e encorajando a todos.
</p>
<h3 name="O_b.C3.A1sico"> O básico </h3>
<p>Aqui está um pequeno guia sobre como editar e criar páginas no wiki do MDC.  Você é bem vindo a praticar suas habilidades em wikis na <a href="pt/Sandbox/Test_Page">Sandbox:Test Page</a>.
</p>
<h4 name="Editando_p.C3.A1ginas"> Editando páginas </h4>
<p>Simplesmente clique no atalho <a href="Special:Userlogin">Criar Conta</a> e preencha os campos. É preciso ter uma conta e de identificar-se para poder editar páginas. Estes passos são necessários pois permitem lutar contra ações de vandalismo e torna mais fácil registrar (e agradecer-lhe pelas) contribuições.
</p><p>Na coluna da direita de todas as páginas você vai ver um link "Editar".  Clicando neste link você será levado a uma página onde poderá editar o conteúdo fazendo as alterações que achar necessárias, pré-visualizá-las, então salvá-las no Wiki. Uma vez salvas, você pode ver suas modificações imetiatamente na página
</p>
<h4 name="Iniciando_uma_nova_p.C3.A1gina"> Iniciando uma nova página </h4>
<p>O caminho mais fácil para criar uma nova página é criar um link para ela em sua página de usuário, então use este link para entrar no modo de edição da página.  
</p><p>Para chegar até sua página de usuário, clique em seu nome de usuário no topo da página do wiki.  Se você ainda não adicionou nada em sua página, você será levado imediatamente para o formulário de edição da página, onde poderá adicionar o conteúdo que quiser. 
</p><p>Criar um link à página que você quer adicionar é tão simples quanto escrever o título para a página incluído entre colchetes, como este: <code><span class="plain">[[Este é um exemplo]]</span></code>.  Quando salvo, isto se tornará um link, como este: <a href="pt/Este_%c3%a9_um_exemplo">Este é um exemplo</a>.
</p><p>Caso a página não exista, o link será vermelho, caso exista, será azul. Se você pretende criar uma página e o título que você deseja incluir já esteja sendo examinado, verifique antes se você pode ajudar a editar e melhorar o artigo existente. Caso contrário, pense em um título diferente para sua página e crie um link para ela.
</p><p>Quando você quiser adicionar conteúdo em sua página nova, simplesmente clique no link vermelho que você criou e comece a escrever. Lembre-se de usar o botão "Salvar página" no final do formulário de edição para salvar seu trabalho (frequentemente, se você estiver trabalhando em uma parte longa). 
</p>
<h5 name="Guia_para_nomea.C3.A7.C3.A3o_de_p.C3.A1ginas"> Guia para nomeação de páginas </h5>
<p>Para mais informações sobre criar e nomear páginas novas, veja nosso <a href="Project:pt/Guia_para_nomea%c3%a7%c3%a3o_de_p%c3%a1ginas">Guia para nomeação de páginas</a>.
</p>
<h4 name="Marca.C3.A7.C3.A3o_do_Wiki"> Marcação do Wiki </h4>
<p>Se você clicar em "Editar" na coluna da direita, você verá que o texto desta página contém alguns caracteres especiais, por exemplo os "==" entre os títulos e os "[{{mediawiki.external(' ]')}}" entre os links.  Esta é uma forma muito simples de marcação textual que é exclusiva de sistemas wiki.  O poder deste tipo de marcação reside no fato de que é muito fácil de aprender e pode ser facilmente corrigido caso ocorra algum erro.
</p>
<h5 name="Refer.C3.AAncia_de_marca.C3.A7.C3.A3o_no_Wiki"> Referência de marcação no Wiki </h5>
<p>Nós temos uma <a href="Project:pt/Wiki_Markup_Reference"> completa referência de marcação</a> onde você pode aprender a linguagem com a qual pode editar e escrever textos dentro do Wiki.
</p>
<h3 name="Escrevendo.2C_editando_e_revisando"> Escrevendo, editando e revisando </h3>
<p>Aqui está uma pequena introdução do MDC para escritores, editores e revisores
</p>
<h4 name="Escritores"> Escritores </h4>
<p>O MDC está sempre interessado em novos conteúdos, então sinta-se encorajado a escrever novos artigos quando quiser relacionados aos<a href="Special:Tags?tag=All_Categories&amp;language=pt">tópicos</a> que o wiki abrange.  Um novo conteúdo pode ser uma simples página de dicas ou algo tão complexo quanto um guia de referência de programação.  A quantidade que você deve escrever é uma decisão que cabe inteiramente a você.
</p><p>Caso você esteja empreendendo um grande projeto, sugerimos que você entre na <a href="Project:pt/Getting_Started#Joining_the_MDC_community">Comunidade MDC</a> e discuta suas idéias primeiramente lá, apenas para tomar conhecimento se alguém está planejando ou já iniciou um projeto similar.
</p><p>Consulte o <a href="Project:pt/Writer's_guide">guia do escritor</a> se você tem dúvidas sobre o estilo ou políticas de uso dentro do wiki.
</p>
<h4 name="Editores"> Editores </h4>
<p>Edição é sempre bem-vinda em nosso Wiki, particularmente para melhorar ou corrigir o estilo de escrita ou gramática.  Por favor, veja nosso <a href="Project:pt/Writer's_guide">guia do escritor</a> para maiores informações.
</p>
<h4 name="Revisores"> Revisores </h4>
<p>Melhorias técnicas e revisões são sempre bem-vindas aqui, então se você estiver lendo uma página e encontrar um erro técnico (seja ele no código ou no texto), por favor sinta-se livre para corrigí-lo. Caso esta mudança cause alguma controvérsia, faça uma observação na página de "talk" (clicando no link "Discussion" na coluna da direita") e deixe uma nota explicando as razões de sua modificação.
</p>
<h4 name="Guia_do_escritor"> Guia do escritor </h4>
<p>Nós possuímos um <a href="Project:pt/Writer's_guide">Guia do escritor</a> frizando o estilo preferencial de escrita .  Se você tiver alguma dúvida sobre algum estilo não explicado aqui, recomendamos a seguinte consulta: <a class="external" href="http://www.economist.com/research/StyleGuide/">Economist style guide</a> ou, se ainda assim não estiver satisfeito, esta: <a class="external" href="http://www.amazon.com/gp/product/0226104036/">Chicago Manual of Style</a>.
</p><p>Nós iremos expandir o guia no decorrer do tempo, então caso você tenha dúvidas específicas não explanadas no <a href="Project:pt/Writer's_guide">Guia do escritor</a>, por favor envie-a para a <a href="Project:pt/Community">lista de e-mails da MDC</a> ou para o<a href="User:Leandro">administrador do projeto</a>, assim saberemos que ela deve ser adicionada.
</p>
<h3 name="Migrando_documenta.C3.A7.C3.B5es_antigas"> Migrando documentações antigas </h3>
<p>Um dos maiores sub-projetos do MDC é migrar toda a documentação que existe atualmente em <a class="external" href="http://www.mozilla.org">mozilla.org</a> para o wiki. Este procedimento é simples:
</p>
<ol><li> Escolha um documento que você gostaria de migra da <a href="Project:pt/Existing_Content">lista de conteúdo existente</a>.
</li><li> Consulte o <a href="Project:pt/Page_Naming_Guide">Guia de nomeação de páginas</a> e decida como as páginas daquele documento devem ser chamadas no wiki.
</li><li> Crie estas páginas e migre o conteúdo, formatando-o da melhor forma que você puder, conforme o  <a href="Project:pt/Wiki_Markup_Reference">Guia de referência de marcação</a>.
</li><li> Delete o item da<a href="Project:pt/Existing_Content">lista de conteúdo existente</a>.
</li><li> Adicione o item na <a href="Project:pt/Needs_Redirect">lista de redirecionamento</a>.
</li></ol>
<p>Caso você queira fazer um trabalho realmente bom, poderá também:
</p>
<ol><li> Usar <a class="external" href="http://search.developer.mozilla.org">nosso sistema de busca</a> para procurar por qualquer link do documento original do wiki, então alterá-lo em sua nova página.
</li><li> Checar por <a href="Project:pt/External_Redirects">redirecionamento externo</a> ao documento original, e marcar estes redirecionamentos para deleção colocando-os na categoria "Sucata" adicionando <code><span class="plain">[[Category:Junk]]</span></code>.
</li></ol>
<h3 name="Localizing_the_MDC"> Localizing the MDC </h3>
<p>If you're interested in helping translate the documentation in any of the MDC wikis to another language, you can do so simply by visiting the relevant language's wiki and editing/creating pages.
</p>
<h4 name="Localiza.C3.A7.C3.A3o_de_projetos_existentes"> Localização de projetos existentes </h4>
<p>Atualmente o MDC possui wikis para as seguintes línguas: <a class="external" href="http://developer.mozilla.org/ca/docs/">Català</a>,
<a class="external" href="http://developer.mozilla.org/cn/docs/">中文(简体)</a>,
<a class="external" href="http://developer.mozilla.org/de/docs/">Deutsch</a>,
<a class="external" href="http://developer.mozilla.org/en/docs/">English</a>,
<a class="external" href="http://developer.mozilla.org/fr/docs/">Français</a>,
<a class="external" href="http://developer.mozilla.org/it/docs/">Italiano</a>,
<a class="external" href="http://developer.mozilla.org/ja/docs/">日本語</a>,
<a class="external" href="http://developer.mozilla.org/nl/docs/">Nederlands</a>,
<a class="external" href="http://developer.mozilla.org/pl/docs/">Polski</a>,
<a class="external" href="http://developer.mozilla.org/pt/docs/">Português</a>,
<a class="external" href="http://developer.mozilla.org/es/docs/">Español</a>,
<a class="external" href="http://developer.mozilla.org/ko/docs/">한국어</a>.
</p>
<h4 name="How_to_start_a_new_localization_project"> How to start a new localization project </h4>
<p>If you would like to start a new localization project for a language we don't currently have a wiki for, please read the <a href="Project:pt/Localization_Projects">localization projects</a> page and follow the instructions there.
</p>
<h3 name="Resolving_.22edit_wars.22_or_other_conflicts"> Resolving "edit wars" or other conflicts </h3>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please first try to resolve the conflict with the people involved.  
</p><p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="Project:pt/Community">MDC mailing list</a> or (as a last resort) the <a href="User:Dria">MDC project lead</a>.  Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.
</p>
<h3 name="Requesting_page_deletions"> Requesting page deletions </h3>
<p>Should you create a page by accident or stumble across a page you think should be deleted, add it to the "Junk" category, by adding <code><span class="plain">[[Category:Junk]]</span></code> to the bottom of the page.
</p><p>The <a href="Special:Tags?tag=Junk&amp;language=pt">Junk category</a> is checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.
</p><p><b>Note</b>: Please do not delete other content or categories from the pages you flag as "Junk".
</p>
<h3 name="Juntando-se_.C3.A0_comunidade_MDC"> Juntando-se à comunidade MDC </h3>
<p>O Mozilla Developer Center é em sua maior parte  formado pelo trabalho de um grupo de voluntários, e nós estamos sempre felizes para ajudar escritores e editores novos a se envolverem. 
</p>
<h4 name="Listas_de_e-mail_e_newsgroup"> Listas de e-mail e newsgroup </h4>
<p>A maior parte do planejamento e discussão do projeto MDC ocorre no Grupo Google, na lista de e-mail e newsgroup.
</p>
<ul><li>Veja os fóruns do MDC...
<ul><li><a class="external" href="http://groups.google.com/group/mozilladevmdc-pt">como um grupo Google</a>
</li><li><a class="external" href="http://groups.google.com/group/mozilladevmdc-pt/feeds">como um Web Feed</a>
</li><li><a class="external" href="https://lists.mozilla.org/listinfo/dev-mdc">como uma lista de e-mail</a> - Em Inglês.
</li><li><a class="external" href="news://news.mozilla.org/mozilla.dev.mdc">como um newsgroup</a> - Em Inglês.
</li></ul>
</li></ul>
<ul><li><a class="external" href="http://mail.mozilla.org/pipermail/devmo-general/">Arquivos da antiga lista devmo-general</a>
</li></ul>
<p>Se você tiver algum problema com a lista, ou tiver alguma pergunta, sinta-se livre para entrar em contato com um administrador.
</p>
<h4 name="IRC"> IRC </h4>
<p>Você é bem vindo para juntar-se ao <a class="external" href="irc://irc.mozilla.org/mdc-pt">canal #mdc-pt</a> em irc.mozilla.org.
</p>
<h4 name="Administradores_do_MDC_em_portugu.C3.AAs"> Administradores do MDC em português </h4>
<p>Os administradores da versão em língua portuguesa do <a href="pt">Mozilla Developer Center</a> são os seguintes:
</p>
<ul><li> <a href="User:Leandro_Merc%c3%aas_Xavier">Leandro Mercês Xavier</a>
</li><li> <a href="User:RuiMaciel">Rui Maciel</a>
</li></ul>
{{ wiki.languages( { "en": "Project:en/Getting_started", "pl": "Project:pl/Na_pocz\u0105tek" } ) }}
Revert to this revision