Help:Template (Português) - ArchWiki

Jump to content

# Help: Template (Português)

From ArchWiki
Status de tradução: Esse artigo é uma tradução de Help:Template. Data da última tradução: 2023-01-07. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Artigos relacionados

- Help:Edição
- Help:Leitura
- Help:Estilo

O modelo, ou "template", é um pedaço de wikitext predefinido que podem ser inserido em um artigo. Templates são primariamente usados para ajudar na formatação de conteúdo.

## Uso

Templates, ou modelos, são usados adicionando a seguinte marcação a um artigo:

    {{Nome do template}}

A maioria dos templates aceita argumentos adicionais, tais como Template:Nota:

    {{Nota|Esse texto deve ser notado.}}

Que produz:

Nota Esse texto deve ser notado.

Alguns templates podem usar parâmetros nomeados, tal como Template:hc:

    {{hc|head=/etc/machine-id|output=0123456789abcdeffedcba9876543210}}

que produz:

    /etc/machine-id

    0123456789abcdeffedcba9876543210

O formato geral é:

    {{Nome do template|param1|param2|...|paramN}}

Veja a página de cada template para instruções específicas de uso.

### Estilo

- Templates devem ser usados iniciando com letra maiúscula, conforme mostrado nos exemplos de suas páginas. Por exemplo `{{Pkg|...` e `{{ic|...` estão corretos, enquanto `{{pkg|...` e `{{Ic|...` não estão.
- Não deve haver espaço em volta do nome do template: `{{Nome do template|...` está correto, enquanto `{{ Nome do template |...` não está.
- Templates não devem ser categorizados.

### Escapar caracteres que quebram templates

Há alguns caracteres que, se usados dentro de um template, quebrarão sua saída: muito frequentemente isso acontece com "=" (o sinal de igual) e "|" (o sinal de pipe). Soluções para esse problema estão descritas abaixo.

Dica

- O símbolo pipe "|" pode ser escapado usando a palavra mágica `{{!}}`.
- O sinal de igual "=" pode ser escapado usando a palavra mágica `{{=}}`.

#### Parâmetros nomeados e numerados

Se o problema é apenas com sinais "=", a solução recomendada é introduzir explicitamente os parâmetros de template com seus números ou nomes posicionais.

Exemplo: `{{Dica|1=https://www.archlinux.org/?foo=bar}}`

Resultado:

Dica https://archlinux.org/?foo=bar

Isso é muito útil para:

- Definições de variáveis.
- Links externos com strings de consulta em URLs.
- Strings e comandos de shell.
- Linhas de código.

Caracteres de espaço em branco (ou seja, novas linhas) são removidos automaticamente do início e do fim dos valores de parâmetro nomeados. Para preservar os caracteres de espaço em branco, inicie o valor do parâmetro com uma tag `<nowiki/>`.

Exemplo:

    {{Dica|1=<nowiki/>
    * https://archlinux.org/?foo=bar
    * https://archlinux.org/?foo=baz
    }}

Resultado:

Dica

- https://archlinux.org/?foo=bar
- https://archlinux.org/?foo=baz

##### Parâmetros múltiplos

- Usando parâmetros posicionais `1` e `2`

    {{hc|1=$ echo "="|2==}}

Resultado:

    $ echo "="

    =

- usando parâmetros nomeados `head` e `output`

    {{hc|head=$ echo "="|output==}}

Resultado:

    $ echo "="

    =

#### Tags nowiki

Se você está tendo problemas com caracteres além de "=", ex.: "}", a solução recomendada é envolver todo o parâmetro com tags `<nowiki>`. Esse método exibe todos os tipos de caracteres, mas evita completamente o motor wiki de processar marcação de texto, tal como links e outros templates. Por exemplo:

    {{Dica|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}

Dica = | }} https://www.archlinux.org/ {{ic|foo}}

Envolver apenas partes específicas (ou até mesmo caracteres singulares) em tags `<nowiki>` até que funciona, mas para melhor legibilidade, é recomendado usar tal método apenas se links ou outros templates tiverem que ser exibidos normalmente. Por exemplo:

    {{Dica|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}

Dica = | }} https://archlinux.org/ `foo`

#### Entidades HTML

Substituir so caracteres prejudiciais com suas respectivas entidades HTML sempre funciona, mas já que reduz a legibilidade do texto fonte, é recomendado apenas quando as soluções acima não forem praticáveis. Por exemplo:

    {{Dica|&#61; &#124; &#123;&#123; &#125;&#125;}}

Dica = | {{ }}

## Criação

Nota

- O espaço de nomes Template está semiprotegido. Apenas usuários autoconfirmed podem criar ou editar modelos.
- Antes de criar um template, discuta a ideia em Help talk:Template.
- Crie apenas templates relevantes. Se você está tentando criar um template muito especializado que será usado apenas poucos artigos, por favor, não há necessidade; evite lotar o espaço de nomes de templates.
- Crie apenas templates concisos. Lembre-se do O Jeito Arch, ou The Arch Way: mantenha isto simples, estúpido!

O template a seguir deve ser usado ao criar novos templates para facilitar o uso e edição:

    <noinclude>
    {{Template (Português)}}

    Uma descrição breve do template

    == Uso ==

    <nowiki>{{Nome do template|param1|param2|...|paramN}}</nowiki>

    == Exemplo ==

    {{Nome do template|param1|param2|...|paramN}}</noinclude><includeonly>O código do template vai aqui...</includeonly>

Para começar o processo de criação, basta visitar Template:Nome do template (substituindo `Nome do template` com o nome desejado do template), editando e adicionando wikitexts que sejam relevantes.

## Lista de templates

Os templates que os usuários podem usar diretamente em artigos no ArchWiki são listados abaixo. Clique nos links para ver sua página detalhada. Para uma lista que também inclui localizações e templates meta, veja Special:AllPages/Template:, Special:PrefixIndex/Template: ou Special:MostLinkedTemplates.

Atenção Por favor, não faça experiências com templates existentes. Se você deseja editar um template não protegido, copie o texto para Template:Sandbox, edite e teste-o lá, e copie-o de volta quando funcionar. É fortemente recomendado (e necessário para proteger os templates) sugerir quaisquer mudanças primeiro nas páginas de discussão first.

### Teste

- Template:Sandbox
- Template:Lorem Ipsum

### Templates de status de artigos

Esses templates devem ser adicionados no início dos artigos ou seções relacionados. Veja também Help:Estilo#Modelos de status de artigo.

Os tradutores também devem verificar as diretrizes de templates em ArchWiki:Equipe de Tradução.

As páginas marcadas com os templates de status de artigos são rastreadas na categoria de manutenção correspondente e em ArchWiki:Statistics#Maintenance statistics.

Nome | Uso recomendado | Parâmetros
--- | --- | ---
Template:Style | Conteúdo com problemas de linguagem, sintaxe wiki ou estilo. | `1` — motivo, `2` — página de discussão opcional, `section` — seção opcional na página de discussão padrão
Template:Accuracy | Conteúdo incorreto ou enganoso.
Template:Expansion | Conteúdo incompleto.
Template:Out of date | Conteúdo desatualizado.
Template:Remove | Conteúdo irrelevante ou inútil.
Template:Archive | Páginas obsoletas.
Template:Laptop style | Páginas Laptop que não seguem as diretrizes de páginas de laptop..
Template:Translateme* | Traduções incompletas.
Template:Bad translation* | Traduções problemáticas.
Template:TranslationStatus* | Status das traduções. | `1` — título original, `2` — data da tradução, `3` — número da revisão
Template:Merge | Sobreposições de conteúdo com outro artigo. | `1` — página alvo, `2` — motivo, `3` — página de discussão opcional, `section` — seção opcional na página de discussão padrão
Template:Move | Renomeia a página, move a seção para outro artigo.
Template:Redirect | Redireciona página para outro artigo.
Template:Unsupported | Página de usuário sem suporte oficial pelo Arch Linux. | `1` — data da última revisão pelo autor da página

* vide as respectivas versões traduzidas para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

### Templates de artigos relacionados

- Template:Related articles start *
- Template:Related
- Template:Related articles end

* vide a respectiva versão traduzida para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

### Templates de formatação de código

- Template:ic
- Template:bc
- Template:hc
- Template:Text art

### Templates de notas

- Template:Note *
- Template:Tip *
- Template:Warning *

Para usar apenas em rascunhos em páginas de discussões:

- Template:Comment *

* vide as respectivas versões traduzidas para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

### Templates diversos

- Template:App
- Template:Broken package link *
- Template:Broken section link *
- Template:Bug
- Template:Committed identity *
- Template:Dead link *
- Template:Lowercase title
- Template:man
- Template:Unsigned

* vide as respectivas versões traduzidas para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

### Templates de pacotes

- Template:Pkg
- Template:Grp
- Template:AUR

### Templates de célula de tabela

Alinhamento de texto:

Nome | Alinhamento | Marcação Wiki | Resultado
--- | --- | --- | ---
Template:C | centro | `{{C|texto}}` | texto
Template:L | esquerda | `{{L|texto}}` | texto

Plano de fundo de célula:

Nome | Cor | Marcação Wiki | Resultado
--- | --- | --- | ---
Template:R | vermelho | `{{R|texto}}` | texto
Template:O | laranja | `{{O|texto}}` | texto
Template:Y | amarelo | `{{Y|texto}}` | texto
Template:G | verde | `{{G|texto}}` | texto
Template:B | azul | `{{B|texto}}` | texto
Template:V | violeta | `{{V|texto}}` | texto
Template:Grey | cinza | `{{Grey|texto}}` | texto

Texto comum*:

Nome | Marcação Wiki | Resultado
--- | --- | ---
Template:Yes | `{{Yes}}` | Sim
`{{Yes|https://wiki.archlinux.org/}}` | Sim
Template:No | `{{No}}` | Não
`{{No|https://wiki.archlinux.org/}}` | Não
Template:- | `{{-}}` | –

Dica Você pode usar atributos com templates de célula de tabela prefixando-os (p.ex., `| colspan=2 {{Yes}}`).

* vide as respectivas versões traduzidas para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

### Templates de categorias

- Template:Cat main *

* vide a respectiva versão traduzida para uso em artigos traduzidos para Português em ArchWiki:Equipe de tradução#Modelos que podem ser traduzidos

## Veja também

- Template:Template (Português)
- MetaWikimedia:Help:Templates/pt-br

Category:

- Help (Português)

Help: Template (Português)
Add topic