Ajuda:Listas

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Lists and the translation is 99% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎català • ‎français • ‎polski • ‎português • ‎slovenčina • ‎русский • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
PD Nota: Ao editar esta página, você concorda em publicar a sua contribuição no âmbito da licença CC0. Veja as páginas de ajuda do domínio público para mais informações.
PD

Esta página se trata da criação de listas na MediWiki

Resumo

A MediaWiki oferece três tipos de listas: listas ordenadas, listas não ordenadas e listas de definição. Nas próximas seções as listas ordenadas são utilizadas como exemplo. Listas não ordenadas dariam resultados correspondentes

Você digita O resultado é
* As listas são fáceis de fazer:
** comece cada linha
* com um asterisco
** mais asteriscos significam
*** níveis mais profundos
* As listas são fáceis de fazer:
    • comece cada linha
  • com um asterisco
    • mais asteriscos significam
      • níveis mais profundos
* Uma nova linha
* em uma lista
marca o final da lista.
Claro
* você pode
* começar novamente.
* Uma nova linha
  • em uma lista

marca o final da lista. Claro

  • você pode
  • começar novamente.
# Listas numeradas são boas
## muito organizadas
## faceís de seguir
# Listas numeradas são boas
    1. muito organizadas
    2. faceís de seguir
* Você também pode
** quebrar linhas
** Como essa por exemplo
* Você também pode
    • quebrar linhas
    • Como essa por exemplo
; Listas de definição
; item : definição
; Ponte e virgula mais o termo
: Dois pontos mais a definição
; Listas de definição
item 
definição
Ponte e virgula mais o termo
Dois pontos mais a definição
; Listas de definição mistas
; Item 1 : Definição
:; sub-item 1 mais o termo
:: Duas vezes os dois pontos mais a definição
:; sub-item 2 : Dois pontos mais a definição
; item 2 
: De volta a lista principal
; Mixed definition lists
item 1 
definition
sub-item 1 plus term
two colons plus definition
sub-item 2 
colon plus definition
item 2
back to the main list
* Ou criar listas mistas
*# e aninhar elas
*#* Por exemplo:
*#*; Definições
*#*: trabalho:
*#*; Maça
*#*; banana
*#*: frutas
* Ou criar listas mistas
    1. e aninhar elas
      • Por exemplo:
        Definições
        trabalho:
        Maça
        banana
        frutas

Paragráfos em listas

Por simplicidade os itens de uma lista não podem ultrapassar um parágrafo na linguagem da Wiki. Uma linha em branco irá finalizar a lista e reiniciar o contador para listas ordenadas. Separar itens de listas não ordenadas normalmente não tem nenhum efeito.

Parágrafos podem se tornar listas usando HTML. Duas quebras de linha, <br /><br />, irão criar o efeito desejado. Então inclua todos os parágrafos, com exceção do primeiro com a <p>...</p>.

Para listas com itens de mais de um parágrafo adicionar uma linha em branco entre os itens pode ser necessário para evitar confusão.

Continuando uma lista após um subitem

Em HTML uma lista pode conter diversas sublistas, não necessariamente adjacentes. Assim podem existir partes de uma lista não apenas antes da sublista, mas entre sublistas, e depois da última sublista. Entretanto, na sintaxe da Wiki, sublistas seguem as mesmas regras que as seções de uma página, ou seja, a única parte possível da lista que não esteja em sublistas é antes da primeira sublista.

No caso do primeiro nível de uma lista não numerada em linguagem Wiki essa limitação pode ser superada dividindo a lista em múltiplas listas; textos indentados entre as listas parciais pode servir visualmente como parte de um item da lista após uma sublista; entretanto, isso pode gerar, dependendo do CSS, uma linha em branco antes e depois de cada lista, em cada caso, para uniformidade, todo item do primeiro nível da lista pode ser feito para separar a lista.

Listas numeradas ilustram o que visualmente é uma única lista, para o software consiste em múltiplas listas; listas não numeradas entregam um resultado correspondente, excepto que o problema de reiniciar com 1 não é aplicável.

<ol>
  <li>Item da lista A1
    <ol>
      <li>Item da lista B1</li>
      <li>Item da lista B2</li>
    </ol>Continuando o item da lista A1
  </li>
  <li>Item da lista A2</li>
</ol>
  1. Item da lista A1
    1. Item da lista B1
    2. Item da lista B2
    Continuando o item da lista A1
  2. Item da lista A2
vs.
#Item da lista A1
##Item da lista B1
##Item da lista B2
#:Continuando o item da lista A1
#Item da lista A2
#Item da lista A1
    1. Item da lista B1
    2. Item da lista B2
    Continuando o item da lista A1
  1. Item da lista A2

Um nível abaixo, com um item de sublista continuando após uma sub-sublista, obtém-se ainda mais linhas em branco; no entanto, a continuação da lista de primeiro nível não é afetada:

#Item da lista A1
##Item da lista B1
##Item da lista C1
#:Continuando o item da lista B1
##Item da lista B2
#Item da lista A2

Retorna

  1. Item da lista A1
    1. Item da lista B1
    2. Item da lista C1
    Continuando o item da lista B1
    1. Item da lista B2
  2. Item da lista A2

Ver também m:Template:List demo.

Alterando o tipo da lista

O tipo da lista (tipo de marcador que é exibido antes de cada item da lista) pode ser alterado no CSS, alterando a propriedade list-style-type

Você digita O resultado é
<ol style="list-style-type:lower-roman">
  <li>Sobre o autor</li>
  <li>Prefácio para a primeira edição</li>
  <li>Prefácio para a segunda edição</li>
</ol>
  1. Sobre o autor
  2. Prefácio para a primeira edição
  3. Prefácio para a segunda edição
<ol style="list-style-type:lower-alpha">
  <li>Sobre o autor</li>
  <li>Prefácio para a primeira edição</li>
  <li>Prefácio para a segunda edição</li>
</ol>
  1. Sobre o autor
  2. Prefácio para a primeira edição
  3. Prefácio para a segunda edição

Indentação extra com listas

Em uma lista numerada com uma fonte grande alguns navegadores podem não exibir mais do que dois dígitos, a não ser que uma indentação extra seja aplicada (se existirem múltiplas colunas: Uma para cada coluna). Isso pode ser feito com CSS:

ol { margin-left: 2cm}

Ou alternativamente como abaixo.

Você digita O resultado é Comentários
:#abc
:#def
:#ghi
 
  1. abc
  2. def
  3. ghi
Uma lista de uma ou mais linhas começando com dois pontos cria uma definition list sem definições mas com os itens como descrições das definições indentadas. Entretanto, se os dois pontos estiverem após um asterisco (*) ou um cerquilha (#) de uma lista, a lista é tratada como uma lista de definição, então a lista inteira é indentada.
<ul>
  <ol>
    <li>abc</li>
    <li>def</li>
    <li>ghi</li>
  </ol>
</ul>
    1. abc
    2. def
    3. ghi
A MediaWiki traduz as listas não ordenadas (ul) sem nenhum itens da lista (li) em uma div com style="margin-left: 2em", causando indentação do conteúdo. Isso é o Método mais versátil, dado que ele permite iniciar com uma número diferente de 1, como abaixo.
<ul>
#abc
#def
#ghi
</ul>
    1. abc
    2. def
    3. ghi
Como acima, com o conteúdo de "lista não ordenada sem nenhum item da lista", que sozinho é uma lista ordenada, expressa com #. O HTML produzido e, portanto, a renderização é o mesmo. Este é o método recomendado ao iniciar a lista com 1.

Para demonstrar que os três métodos exibem todos os números com 3 digitos, veja List demo.

Especificando um valor inicial

Especificar um valor inicial é possível com sintaxe HTML. (O W3C descontinuou os atributos $start e $value como usados abaixo em HTML 4.01 e XHTML 1.0. Mas, a partir de 2007, nenhum navegador popular implementa contadores de CSS, que substituiriam esses atributos. Os projetos da Wikimedia usam o XHTML Transitório, que contém o atributos obsoletos)

<ol start="9">
<li>Amsterdã</li>
<li>Roterdã</li>
<li>Haia</li>
</ol>
  1. Amsterdã
  2. Roterdã
  3. Haia

Ou:

<ol>
<li value="9">Amsterdã</li>
<li value="8">Roterdã</li>
<li value="7">Haia</li>
</ol>
  1. Amsterdã
  2. Roterdã
  3. Haia

Comparação com uma tabela

Além de fornecer numeração automática, a lista numerada também alinha o conteúdo dos itens, comparável ao uso da sintaxe de uma tabela:

{|
|-
| align=right |  9.|| Amsterdã
|-
| align=right | 10.|| Roterdã
|-
| align=right | 11.|| Haia
|}

gives:

9. Amsterdã
10. Roterdã
11. Haia

Essa numeração não automática tem a vantagem que se um texto se referir a um número, a inserção ou remoção de um item não distorce a correspondência.

Listas multicolunas

Ver também Template:Col-begin, Template:Col-break, Template:Col-end.

Listas multicolunas com marcadores

<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
* maça
* carpete
* geografia
* montanha
* lugar nenhum
* postagem
* rasgado
* torrada
</div>

O resultado é:

  • maça
  • carpete
  • geografia
  • montanha
  • lugar nenhum
  • postagem
  • rasgado
  • torrada
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* maça
* carpete
* geografia
* montanha
* lugar nenhum
* postagem
* rasgado
* torrada
</div>

O resultado é:

  • maça
  • carpete
  • geografia
  • montanha
  • lugar nenhum
  • postagem
  • rasgado
  • torrada

Listas multicolunas numeradas

<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* maça
* carpete
* geografia
* montanha
* lugar nenhum
* postagem
* rasgado
* torrada
</div>

O resultado é:

  • maça
  • carpete
  • geografia
  • montanha
  • lugar nenhum
  • postagem
  • rasgado
  • torrada

Abaixo um valor inicial é especificado utilizando sintaxe HTML (para a primeira coluna tanto a sintaxe HTML quanto Wiki pode ser utilizada)

Em combinação com a indentação extra explicado nas seções anteriores:

{| valign="top"
|-
|<ul><ol start="125"><li>a<li>bb<li>ccc</ol></ul>
|<ul><ol start="128"><li>ddd<li>ee<li>f</ol></ul>
|}

O resultado é:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f

Utilizando m:Template:multi-column numbered list o cálculo dos valores iniciais pode ser automatizado, e apenas o primeiro valor inicial e o número de itens em cada coluna exceto a última precisa ser especificado. Adicionando ou removendo um item de uma coluna requer o ajuste de números de itens naquela coluna, em vez de alterar o número inicial para todas as colunas subsequentes.

{{Multi-column numbered list|125|a<li>bb<li>ccc|3|<li>ddd<li>ee<li>f}}

O resultado é:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f
{{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

O resultado é:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

O resultado é:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}

O resultado é:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f

Estilo simplificado ou horizontal

Também é possível apresentar listas pequenas usando uma formatação bem simples, como:

"Titulo da lista:" exemplo 1, exemplo 2, exemplo 3

"Titulo da lista:" exemplo 1, exemplo 2, exemplo 3

Esse estilo utiliza menos espaço na página, sendo recomendado se existirem poucos itens na lista. Ela pode ser lida facilmente, e um ponto de edição direta não é necessário. Os itens da lista devem iniciar com letras minúsculas, a menos que sejam nomes próprios.

Tabelas

Uma tabela com uma coluna é similar a uma lista, mas permitindo ordenação. Se o texto já estiver ordenado com a mesma chave de ordenação, essa vantagem não se aplica. Uma tabela com múltiplas colunas permite a ordenação de qualquer coluna.

Ver também Quando usar tabelas.

Alterando lista não ordenadas para listas ordenadas

Com CSS

ul { list-style: decimal }

Listas não ordenadas são alterada para listas ordenadas. Isso se aplica (tão quanto o seletor CSS não restringir este) para todas as listas-ul no código em HTML:

  • aqueles produzidos com *
  • aqueles com <ul> no wikitexto
  • aqueles produzidos pelo sistema

Como cada página especial, igualmente as outras páginas, tem uma classe baseada no nome da página, pode-se especificar separadamente para cada tipo se as listas devem ser ordenadas, veja Contribuições do usuário e What links here.

Entretanto, parece não ser possível ordenar todas as listas do histórico de páginas (a não ser que alguém fala "todas" as listas ordenadas), porque o nome da classe é baseado na página para a qual o histórico é visualizado.

Ver também

  • w:Ajuda:Lista
  • Extension:Sort2 - Cria uma lista com código de lista apenas no início e no fim, não por item; permite a troca de tipo de lista de forma simples; listas classificadas
  • Module:Sort definition list - O módulo Scribunto permite que listas sejam ordenadas pelo termo definido, muito útil para wikis com múltiplos idiomas.