aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/mdn/contribute/howto/create_and_edit_pages/index.html
blob: 5b8979a5ab7dd72ecebe9ac1676f80065a45658a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
---
title: Criando e editando páginas
slug: MDN/Contribute/Howto/Create_and_edit_pages
tags:
  - Colaborando
  - Colaborar
  - Contribuindo
  - Criando
  - Editando
  - MDN
  - nova pagina
translation_of: MDN/Contribute/Howto/Create_and_edit_pages
original_slug: MDN/Contribute/criando_e_editando_paginas
---
<div>{{MDNSidebar}}</div>

<p>As duas tarefas mais básicas sobre MDN que quase todo contribuinte MDN irá eventualmente executar são para editar uma página já existente ou criar uma nova. Este artigo aborda os conceitos básicos de como fazer cada uma delas.</p>

<h2 id="Editando_uma_página_existente"><a id="Editando uma págia existente" name="Editando uma págia existente">Editando uma página existente</a></h2>

<p>É fácil editar:</p>

<ul>
 <li>Clique no botão editar próximo ao topo na direita no canto da página.</li>
 <li>A página recarregará com opções de formatação, assim, você pode adicionar ou deletar informação diretamente na página.</li>
 <li>Você pode adicionar parágrafos, deletar texto, inserir cabeçalhos, e mais das tarefas básicas que envolvem edição de textos.</li>
</ul>

<h3 id="Ver_mudanças">Ver mudanças</h3>

<p>Para ver como suas mudanças ficaram:</p>

<ul>
 <li>Clique no botão "Visualizar mudanças" (dentro da função de editar) acima do título da página.</li>
 <li>Isso abre uma páǵina de pré-visualização que inclui sua revisão em uma nova janela ou aba.</li>
 <li>Cada vez que você clica nesse botão, ele recarrega sua página de pré-visualização com as últimas mudanças feitas.</li>
</ul>

<p>Tenha cuidado! Pré-visualizar uma página <em>não salva</em> as alterações, sendo assim, se lembre de não fechar a página que você está editando sem salvar o conteúdo.</p>

<h3 id="Revisão_de_comentário">Revisão de comentário</h3>

<p>Depois que você pré-visualizou suas mudanças, você deve querer salvar sua revisão. Antes de salvar, procure pela caixa de comentários de revisão abaixo da sessão de título da página e deixe um comentário para informar a outros voluntários o que você mudou e o motivo. Por exemplo, você pode ter adicionado uma nova sessão, mudado algumas palavras para fazer a terminologia mais consistente, reescrito um parágrafo para esclarecer o idioma, ou removido informação porque é redundante.</p>

<h3 id="Tags">Tags</h3>

<p>Você pode adicionar ou remover tags que descrevam o conteúdo da página. Veja <a href="/pt-BR/docs/MDN/Contribute/guia/Como-marcar-as-paginas-corretamente">como adicionar tags às páginas corretamente</a> para mais informações em que as tags se aplicam.</p>

<h3 id="Precisa_de_revisão">Precisa de revisão?</h3>

<p>Se você quiser que um contribuidor experiente revise suas edições, você pode requisitar uma revisão técnica (para códigos, APIs, ou tecnologias), uma revisão editorial (textual, de gramática ou conteúdo), ou uma revisão de template (para código KumaScript) se certificando que a caixa está marcada, antes que você salve.</p>

<h3 id="Anexar_arquivos">Anexar arquivos</h3>

<p>Se você quiser anexar um arquivo a uma página para adicionar uma ilustração ou tornar o conteúdo mais claro, o anexo pode ir no final da página.</p>

<h3 id="Salve_descarte_ou_continue_editando">Salve, descarte ou continue editando</h3>

<p>Quando você termina uma edição com seu preview, você pode salvar seu trabalho e comentários clicando no botão verde "Salvar alterações" à direita do título da página. Se você mudar de ideia, pode descartar suas edições clicando no botão vermelho "Descartar alterações", também à direita do título da página.</p>

<p>Pressionar <strong>Enter</strong> no comentário da revisão é equivalente a clicar em "Salvar e continuar editando".</p>

<h2 id="Criando_uma_nova_página">Criando uma nova página</h2>

<p>Se você não sabe onde colocar seu artigo, <strong>não se preocupe sobre isso!</strong> Coloque-o em qualquer local e nós vamos encontrá-lo e movê-lo para onde ele pertence, ou mesclá-lo em conteúdo existente se for mais apropriado. Você também não precisa se preocupar sobre deixar tudo perfeito. Nós temos gnomos ajudantes felizes que vão ajudá-lo deixar seu conteúdo lindo.</p>

<p>Há algumas maneiras de criar uma nova página:</p>

<ul>
 <li><a href="#link-para-pagina-inexistente">Link para "página inexistente"</a></li>
 <li><a href="#nova-pagina-sem-link">Nova página sem link</a></li>
 <li><a href="#subpagina-de-uma-pagina-existente">Subpágina de uma página existente</a></li>
 <li><a href="#clone-de-uma-pagina-existente">Clone de uma página existente</a></li>
 <li><a href="#link-para-uma-pagina-existente">Link para página existente</a></li>
</ul>

<h3 id="Link_para_uma_página_inexistente"><a id="link-para-pagina-inexistente" name="link-para-pagina-inexistente">Link para uma página inexistente</a></h3>

<p>Como na maioria das wikis, na MDN é possível criar links para uma página que ainda não existe. Por exemplo, um autor pode criar uma lista de todos os membros de uma API, antes de criar as páginas para esses membros. Na MDN, links para página inexistentes geralmente são exibidos em vermelho.</p>

<p>Para criar um link para uma "página inexistente":</p>

<ol>
 <li>Certifique-se que você está logado na MDN. (Se você não estiver, vai receber um erro 404).</li>
 <li>Clique no link "página inexistente". O <a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Editor">MDN Editor UI</a> abrirá, pronto para você criar a página inexistente.</li>
 <li>Escreva o conteúdo da página e salve-a.</li>
</ol>

<h3 id="Nova_página_sem_link"><a name="nova-pagina-sem-link">Nova página sem link</a></h3>

<p><em>Para criar uma nova página sem linkar de outra página</em>, informe o nome único de uma página na barra de endereços do seu navegador. Por exemplo, se você inserir:</p>

<pre class="language-html">https://developer.mozilla.org/en-US/docs/FooBar</pre>

<p>O MDN cria uma nova página com o título "FooBar" e abre o editor para você inserir o conteúdo nessa página. Veja a sessão "<a href="#Editando uma págia existente">Editando uma página existente</a>" nesse artigo para ver como usar o editor.</p>

<h3 id="Subpágina_de_uma_página_existente"><a id="subpagina-de-uma-pagina-existente" name="subpagina-de-uma-pagina-existente">Subpágina de uma página existente</a></h3>

<p>Para criar uma subpágina que você quer que seja filha de uma página existente:</p>

<ol>
 <li>Na página "pai", clique no menu <strong>Avançado</strong> (o ícone de engrenagem na barra de ferramentas) e clique em <strong>Nova subpágina</strong>.</li>
 <li>Digite um título para o documento no campo <strong>Título</strong>.</li>
 <li>Mude o <strong>Slug</strong> se necessário (por exemplo, se o título for muito longo e você quiser um título menor). Esse campo é gerado automaticamente pelo editor, substituindo underlines por espaços no título. Nesse caso, você pode mudar apenas a última parte da URL do documento.</li>
</ol>

<h3 id="Clone_de_uma_página_existente"><a id="clone-de-uma-pagina-existente" name="clone-de-uma-pagina-existente">Clone de uma página existente</a></h3>

<p>Se houver uma página existente cujo formato você quer usar numa página nova, você pode clonar essa página e mudar seu conteúdo</p>

<ol>
 <li>Na página original, clique no menu <strong>Avançado</strong> (o ícone de engrenagem na barra de ferramentas) e clique em <strong>Clonar essa página</strong>. O editor vai abrir para que você mude seu conteúdo.</li>
 <li>Mude o <strong>Título</strong> da página conforme apropriado. O campo <strong>Slug</strong> é atualizado automaticamente quando você muda o campo <strong>Título</strong>.</li>
 <li>Se necessário, mude o caminho do campo <strong>Slug</strong> para colocar o documento em uma parte diferente da hierarquia dele.</li>
 <li>No campo <strong>TOC</strong>, selecione os níveis de cabeçalho que você quer que sejam automaticamente exibidos na tabela de conteúdo da página, ou "Sem tabela de conteúdos" se a página não precisar de uma.</li>
 <li>Escreva o conteúdo da página e salve suas alterações. Veja a sessão "<a href="#Editando uma págia existente">Editando uma página existente</a>" nesse artigo para ver como usar o editor.</li>
</ol>

<h3 id="Link_para_uma_página_existente"><a name="link-para-uma-pagina-existente">Link para uma página existente</a></h3>

<p>Esse método é um pouco híbrido. Você pode criar um link em outra página, e clicar no link que você inseriu, para criar a nova página.</p>

<ol>
 <li>Digite o nome da página nova em qualquer lugar (que faça sentido) no texto de uma página existente.</li>
 <li>Selecione o nome e clique no <strong>ícone de link (<img alt="" src="https://developer.mozilla.org/files/3810/link-icon.png">)</strong> na barra de ferramentas do editor. A caixa de diálogo para "<strong>Atualizar Link"</strong> vai abrir com o texto selecionado no campo "<strong>Linkar para</strong>".</li>
 <li>"/pt-BR/docs/" é inserido por padrão no começo do campo URL. Insira o nome da página depois de "/pt-BR/docs/". (O nome da página não tem de ser o mesmo texto do link).</li>
 <li>Clique em OK para criar e inserir o link.</li>
</ol>

<p>Se a página já não existir, o link é mostrado em vermelho. Se a página já existir, o link é mostrado em azul. Se você quiser criar uma nova página mas o título da página que você quer já estiver sendo usado, verifique primeiro se não faz mais sentido ajudar a editar o conteúdo existente. Senão, pense num título diferente para sua nova página e crie um link para ela. Veja o <a href="/pt-BR/docs/MDN/Contribute/Content/Style_guide">guia para nomear páginas</a>.</p>

<p>Para adicionar conteúdo para sua nova página, clique no link vermelho que você acabou de criar (depois de salvar e fechar o editor). A nova página abre no modo de edição, assim você pode começar a editar o conteúdo. Veja a sessão "<a href="#Editando uma págia existente">Editando uma página existente</a>" nesse artigo para ver como usar o editor.</p>

<h2 id="Atualizando_o_conteúdo_da_página">Atualizando o conteúdo da página</h2>

<p>O suporte do MDN para macros KumaScript e transclusão de conteúdo de uma página para outra pode algumas vezes ser dificultada pela necessidade de fazer um cache das páginas geradas para melhorar a performance. Páginas são feitas do seu código-fonte, e a saída é cacheada para requisições futuras. A partir de lá, quaisquer macros (templates) ou transclusões (utilizando a macro Page) na página não vão refletir mudanças feitar para o macro, a saída do macro, ou o conteúdo do material transcluso.</p>

<ul>
 <li>Para atualizar a página manualmente, você pode forçar uma atualização no seu browser. MDN detecta esse gatilho e a página é refeita, inserindo a atualização feita pela saída do macro e o conteúdo da página.</li>
 <li>Você também pode configurar páginas para serem refeitas periodicamente. Isso não deve ser feito a não ser que você precise que  a página seja atualizada frequentemente. Veja <a href="/pt-BR/docs/MDN/Contribute/Tools/Page_regeneration">regeneração de página</a> para detalhes.</li>
</ul>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li><a href="/pt-BR/docs/MDN/Contribute/Editor">Guia do editor do MDN</a></li>
 <li><a href="/pt-BR/docs/MDN/Contribute/Content/Style_guide">Guia de estilos do MDN</a></li>
</ul>