MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla

Revisão 305707 de Como ajudar a MDN

  • Slug da revisão: Projeto:Como_ajudar_com_MDN
  • Título da revisão: Projeto:Como ajudar com MDN
  • ID da revisão: 305707
  • Criado:
  • Criador: jswisher
  • É a revisão atual? Não
  • Comentar Handout from BrazilJS 2012 Hack Day/translation session

Conteúdo da revisão

Somos uma comunidade aberta de desenvolvedores criando recursos para uma web melhor, independente de nossa marca de navegador, programas ou marca. Qualquer um pode contribuir e cada pessoa que participa nos faz mais forte. Juntos, podemos continuar a impulsionar a inovação na web para servir o bem maior. Tudo começa aqui, com você.

Junte-se a Comunidade

Se quiser aconselhamentos, ajuda ou apenas para nos conhecer, por favor, juntar-se nesses canais:

IRC Channels – para conversar com colaboradores MDN:

  • #devmo: Discussões sobre o conteúdo documentação do desenvolvedor em MDC
  • #mdn: Questões gerais sobre MDN

A reunião da comunidade MDN a cada duas quartas-feiras às 10:00 am Pacific Time (18:00 UTC inverno; 17:00 UTC verão) em #devmo no irc.mozilla.org.

Para se juntar pelo IRC, siga essas instruções no IRC wiki: https://wiki.mozilla.org/IRC#Getting_Started

Email lists – comunicações menos frequentes para toda a comunidade MDN:

  • mozilla.dev.mdc: MDN Documentation Center  - discussões sobre produção de conteúdo.
  • mozilla.dev.mdn: Technical website development para a plataforma MDN.
  • mozilla.dev.mdc.es: MDN Documentation Center – Comunidade de tradução para o Espanhol
  • mozilla.dev.mdc.pt: MDN Documentation Center - Comunidade de tradução para o  Português.

Acesse o MDN

Para adicionar, editar, or traduzir documento, você precisará entrar no website do MDN:

https://developer.org

Uma vez no site, você terá que criar uma conta no MDN. O Mozilla Developer Network usa Persona (também conhecido como BrowserID) para gerenciar contas. O BrowserID é uma opção segura e fácil. Ele protege a privacidade do usuário, conta com controle de usuário e tem escolhas para o usuário que outros fornecedores não possuem.

Criando sua conta

  1. Clique no botão Entrar na parte superior da página. E abrira uma janela de login do BrowserID.
  2. Coloque o seu endereço de e-mail e clique em próximo..

O que acontece depois dependerá se você já usou este endereço de e-mail com BrowserID antes.

  1. Se você não tiver o e-mail no BrowserID antes, uma janela abrirá solicitando que você escolha uma senha. Digite a senha duas vezes e clique em verificar.
  2.  
    1. Faça a verificação do seu e-mail, acessando sua conta de provedor do e-mail.  Receberá um e-mail do BrowserID@browserid.org. (Verifique sua caixa de SPAM se necessário.).
    2. Ao abrir o e-mail clique no link de registro.
    3. Digite a senha para este endereço de e-mail (duas vezes se for novo), e clique em Concluir. Na guia MDN ou janela (onde originalmente você clica para entrar), o MDN mostrará uma página de criação de conta.
    4. Digite um nome de usuário para associar à sua conta e clique em Criar novo perfil. Observe que os nomes de usuário não podem conter espaços
  3. Se você já usou antes BrowserID, digite sua senha existente BrowserID para este endereço de e-mail e clique em verificar.

Parabéns, agora você tem uma conta no MDN e poderá criar, editar e traduzir o conteúdo da documentação.

Editando conteúdo no MDN

Comece editando uma página

  1. Verifique se você está logado no MDN (veja a sessão acima para instruções)
  2. A página muda para o modo de edição, e começa a mostra o conteúdo da página dentro de um painel editor.

Salve o seu trabalho

O editor do MDN oferece várias maneiras para você verificar e salvar seu trabalho.

  1. Save changes: Salva as alterações e sai do modo de edição, voltando à página para modo de leitura. Este é o mesmo que o botão Salvar e Sair na barra de ferramentas do editor.
  2. Save and keep editing: Salva as alterações, mantendo-se no modo de edição. Este é o mesmo que o botão de Salvar e Continuar Editando na barra de ferramentas do editor.
  3. Preview changes: Aplica as alterações em outra aba do navegador. Este ponto de vista executa todos os modelos que são referenciados na página, para que você possa ver como os modelos aparecerão para os leitores.
  4. Discard changes: Joga fora suas alterações desde a última gravação, e retorna a página para modo de leitura.

Modifique a informação da página

Enquanto uma página está em Modo de Edição, você pode modificar alguns as metadata da mesma. Clique no botão "i" para abrir os campos de info das páginas.

  • Title: O título que aparece na barra de título do navegador e na parte superior do conteúdo da página.
  • Slug: A última parte da URL para a página. Normalmente, isso é baseado no título da página (substituições apropriadas para espaços e caracteres especiais), mas você pode modifica-lo.
  • TOC: Se esta caixa for marcada, uma tabela de conteúdo é gerada automaticamente para a página, com base nas posições dentro da página (até H4), em uma caixa de perto do topo da página.

Quaisquer alterações a estes campos são salvos quando você salva a página como um todo.

Formatação do Texto

O editor oferecer várias ferramentas nos botões das ferramentas, que poderão ajuda-lo a formatar o texto. Algumas delas são comuns em muitos editores e não precisam de explicação.

  • Source: Muda o editor de edição visual para edição de código HTML.
  • H1, H2, H3, H4, H5, H6: Esses botões correspondem exatamente aos elementos de titulo em HTML. Isto é diferente da versão anterior do editor MDN, onde pressionando H1 produzia <h2>, e assim por diante. Por consequencia, evita a formatação com H1, como deve haver apenas um elemento <h1> em uma página, e para MDN, que é produzido por o título da página.
  • PRE: Envolve o texto selecionado em um elemento <pre>. Ao clicar neste botão, você ativa o menu Syntax Highlighter que aparecerá ao lado dele, o que permite que você selecione o tipo de código, de modo que o Syntax Highlighter possa ser aplicada adequadamente.
  • Styles: Selecionando um item deste menu, envolve o texto selecionado em um <div> (para block styles) ou <span> elemento (para inline styles) com o identificador de classe correspondente. Isso permite que o texto seja modificado de maneira apropriada no style sheets do MDN.
  • <>: Este botão envolve a seleção em um bloco <code>, que é útil para indicar nomes de APIs, variáveis ​​e arquivos.

Traduzindo uma página

  1. No menu Languages​​, clique em Add Translation.
  2. A página do idioma selecionado aparecerá.
  3. Clique no idioma que deseja traduzir. E deverá abrir o Translating Article, com o texto idioma original apresentado no lado esquerdo.
  4. Traduza o título e o conteúdo da página para a língua selecionada. Para isso, clique no botão "i" para aparecer as informações que você pode editar.
  5. Clique em salvar mudanças quando tiver terminado.

Nota: Os elementos da interface do usuário "Translating Article" são inicialmente mostrados em Inglês.

Editando uma página traduzida

Em uma página traduzida, clique no botão Editar (que pode estar na sua língua nativa). A "Visão do Artigo Traduzindo" se abrira.

Fonte da revisão

<p>Somos uma comunidade aberta de desenvolvedores criando recursos para uma web melhor, independente de nossa marca de navegador, programas ou marca. Qualquer um pode contribuir e cada pessoa que participa nos faz mais forte. Juntos, podemos continuar a impulsionar a inovação na web para servir o bem maior. Tudo começa aqui, com você.</p>
<h2 id="Junte-se_a_Comunidade">Junte-se a Comunidade</h2>
<p>Se quiser aconselhamentos, ajuda ou apenas para nos conhecer, por favor, juntar-se nesses canais:</p>
<p><strong>IRC Channels</strong> – para conversar com colaboradores MDN:</p>
<ul>
  <li>#devmo: Discussões sobre o conteúdo documentação do desenvolvedor em <a href="https://developer.mozilla.org/en">MDC</a></li>
  <li>#mdn: Questões gerais sobre MDN</li>
</ul>
<p>A reunião da comunidade MDN a cada duas quartas-feiras às 10:00 am Pacific Time (18:00 UTC inverno; 17:00 UTC verão) em #devmo no irc.mozilla.org.</p>
<p>Para se juntar pelo IRC, siga essas instruções no IRC wiki: <a href="https://wiki.mozilla.org/IRC%23Getting_Started">https://wiki.mozilla.org/IRC#Getting_Started</a></p>
<p><strong>Email lists</strong> – comunicações menos frequentes para toda a comunidade MDN:</p>
<ul>
  <li><a href="http://www.mozilla.org/about/forums/%23dev-mdc">mozilla.dev.mdc</a>: MDN Documentation Center&nbsp; - discussões sobre produção de conteúdo.</li>
  <li><a href="http://www.mozilla.org/about/forums/%23dev-mdn">mozilla.dev.mdn</a>: Technical website development para a plataforma MDN.</li>
  <li><a href="https://lists.mozilla.org/listinfo/dev-mdc-es">mozilla.dev.mdc.es</a>: MDN Documentation Center – Comunidade de tradução para o Espanhol</li>
  <li><a href="https://lists.mozilla.org/listinfo/dev-mdc-pt">mozilla.dev.mdc.pt</a>: MDN Documentation Center - Comunidade de tradução para o &nbsp;Português.</li>
</ul>
<h2>Acesse o MDN</h2>
<p>Para adicionar, editar, or traduzir documento, você precisará entrar no website do MDN:</p>
<p><a href="https://developer.mozilla.org">https://developer.org</a></p>
<p>Uma vez no site, você terá que criar uma conta no MDN. O Mozilla Developer Network usa Persona (também conhecido como BrowserID) para gerenciar contas. O BrowserID é uma opção segura e fácil. Ele protege a privacidade do usuário, conta com controle de usuário e tem escolhas para o usuário que outros fornecedores não possuem.</p>
<h2>Criando sua conta</h2>
<ol>
  <li>Clique no botão Entrar na parte superior da página. E abrira uma janela de login do BrowserID.</li>
  <li>Coloque o seu endereço de e-mail e clique em próximo..</li>
</ol>
<p>O que acontece depois dependerá se você já usou este endereço de e-mail com BrowserID antes.</p>
<ol>
  <li>Se você não tiver o e-mail no BrowserID antes, uma janela abrirá solicitando que você escolha uma senha. Digite a senha duas vezes e clique em verificar.</li>
  <li>&nbsp;
    <ol>
      <li>Faça a verificação do seu e-mail, acessando sua conta de provedor do e-mail.&nbsp; Receberá um e-mail do BrowserID@browserid.org. (Verifique sua caixa de SPAM se necessário.).</li>
      <li>Ao abrir o e-mail clique no link de registro.</li>
      <li>Digite a senha para este endereço de e-mail (duas vezes se for novo), e clique em Concluir. Na guia MDN ou janela (onde originalmente você clica para entrar), o MDN mostrará uma página de criação de conta.</li>
      <li>Digite um nome de usuário para associar à sua conta e clique em Criar novo perfil. Observe que os nomes de usuário não podem conter espaços</li>
    </ol>
  </li>
  <li>Se você já usou antes BrowserID, digite sua senha existente BrowserID para este endereço de e-mail e clique em verificar.</li>
</ol>
<p>Parabéns, agora você tem uma conta no MDN e poderá criar, editar e traduzir o conteúdo da documentação.</p>
<h2>Editando conteúdo no MDN</h2>
<h3>Comece editando uma página</h3>
<ol>
  <li>Verifique se você está logado no MDN (veja a sessão acima para instruções)</li>
  <li>A página muda para o modo de edição, e começa a mostra o conteúdo da página dentro de um painel editor.</li>
</ol>
<h3>Salve o seu trabalho</h3>
<p>O editor do MDN oferece várias maneiras para você verificar e salvar seu trabalho.</p>
<ol>
  <li>Save changes: Salva as alterações e sai do modo de edição, voltando à página para modo de leitura. Este é o mesmo que o botão Salvar e Sair na barra de ferramentas do editor.</li>
  <li>Save and keep editing: Salva as alterações, mantendo-se no modo de edição. Este é o mesmo que o botão de Salvar e Continuar Editando na barra de ferramentas do editor.</li>
  <li>Preview changes: Aplica as alterações em outra aba do navegador. Este ponto de vista executa todos os modelos que são referenciados na página, para que você possa ver como os modelos aparecerão para os leitores.</li>
  <li>Discard changes: Joga fora suas alterações desde a última gravação, e retorna a página para modo de leitura.</li>
</ol>
<h3>Modifique a informação da página</h3>
<p>Enquanto uma página está em Modo de Edição, você pode modificar alguns as metadata da mesma. Clique no botão "i" para abrir os campos de info das páginas.</p>
<ul>
  <li>Title: O título que aparece na barra de título do navegador e na parte superior do conteúdo da página.</li>
  <li>Slug: A última parte da URL para a página. Normalmente, isso é baseado no título da página (substituições apropriadas para espaços e caracteres especiais), mas você pode modifica-lo.</li>
  <li>TOC: Se esta caixa for marcada, uma tabela de conteúdo é gerada automaticamente para a página, com base nas posições dentro da página (até H4), em uma caixa de perto do topo da página.</li>
</ul>
<p>Quaisquer alterações a estes campos são salvos quando você salva a página como um todo.</p>
<h3>Formatação do Texto</h3>
<p>O editor oferecer várias ferramentas nos botões das ferramentas, que poderão ajuda-lo a formatar o texto. Algumas delas são comuns em muitos editores e não precisam de explicação.</p>
<ul>
  <li>Source: Muda o editor de edição visual para edição de código HTML.</li>
  <li>H1, H2, H3, H4, H5, H6: Esses botões correspondem exatamente aos elementos de titulo em HTML. Isto é diferente da versão anterior do editor MDN, onde pressionando H1 produzia &lt;h2&gt;, e assim por diante. Por consequencia, evita a formatação com H1, como deve haver apenas um elemento &lt;h1&gt; em uma página, e para MDN, que é produzido por o título da página.</li>
  <li>PRE: Envolve o texto selecionado em um elemento &lt;pre&gt;. Ao clicar neste botão, você ativa o menu Syntax Highlighter que aparecerá ao lado dele, o que permite que você selecione o tipo de código, de modo que o Syntax Highlighter possa ser aplicada adequadamente.</li>
  <li>Styles: Selecionando um item deste menu, envolve o texto selecionado em um &lt;div&gt; (para block styles) ou &lt;span&gt; elemento (para inline styles) com o identificador de classe correspondente. Isso permite que o texto seja modificado de maneira apropriada no style sheets do MDN.</li>
  <li>&lt;&gt;: Este botão envolve a seleção em um bloco &lt;code&gt;, que é útil para indicar nomes de APIs, variáveis ​​e arquivos.</li>
</ul>
<h2>Traduzindo uma página</h2>
<ol>
  <li>No menu Languages​​, clique em Add Translation.</li>
  <li>A página do idioma selecionado aparecerá.</li>
  <li>Clique no idioma que deseja traduzir. E deverá abrir o Translating Article, com o texto idioma original apresentado no lado esquerdo.</li>
  <li>Traduza o título e o conteúdo da página para a língua selecionada. Para isso, clique no botão "i" para aparecer as informações que você pode editar.</li>
  <li>Clique em salvar mudanças quando tiver terminado.</li>
</ol>
<p>Nota: Os elementos da interface do usuário "Translating Article" são inicialmente mostrados em Inglês.</p>
<h2>Editando uma página traduzida</h2>
<p>Em uma página traduzida, clique no botão Editar (que pode estar na sua língua nativa). A "Visão do Artigo Traduzindo" se abrira.</p>
Reverter para esta revisão