Ajuda:Listas
 |
Nota: Quando modificais esta página, estais a aceitar que a vossa contribuição se publique no marco de CC0. Olhem Páginas de ajuda de domínio público para mais informação. Algumas revisões antigas desta página foram importadas nos termos da licença CC BY-SA. Só as novas contribuições estão no domínio público. |
|
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 descrição ou definição. Nas próximas seções as listas ordenadas são utilizadas como exemplo. Listas não ordenadas dariam resultados correspondentes
Basically
- Unordered lists
- Each item is on a new line starting with an asterisk
*e.g.* item. - Ordered lists
- Each item is on a new line starting with a hash
#e.g.# item. - Definition lists
- Each item has two parts : the term and the description
- The term is on a new line starting with a semicolon
;e.g.; term. - The description follows on the same line after a colon
:e.g.; term : description, - or the description starts its own line with a colon
:e.g.: description(there can be several descriptions per term, each one starting with a colon on a new line).
A little bit further
In the following table you will find some examples for both methods:
| 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 |
|
* Uma nova linha * em uma lista marca o final da lista. Claro * você pode * começar novamente. |
marca o final da lista. Claro
|
# Listas numeradas são boas ## muito organizadas ## faceís de seguir |
|
* Você também pode ** quebrar linhas ** Como essa por exemplo |
|
; Listas de descrição ou 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 |
|
* Ou criar listas mistas *# 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, $brtags, irão criar o efeito desejado. Então inclua todos os parágrafos, com exceção do primeiro com a $ptag.
If you want to put more than one line of text, add two line break symbols, <br /><br />, and you will get the desired effect.
Wrapping text in <p>...</p> will render that text in a new paragraph, which will start on its own line when rendered.
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.
| Wikitexto | O resultado é |
|---|---|
<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>
|
|
| vs. | |
#Item da lista A1 ##Item da lista B1 ##Item da lista B2 #:Continuando o item da lista A1 #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:
| Wikitexto | O resultado é |
|---|---|
#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 |
|
Ver também m:Template:List demo.
It is possible to embed unnumbered bullets inside enclosing numbered items:
| Wikitexto | O resultado é |
|---|---|
# list item A #* nested bullet A1 #* nested bullet A2 # continuing list item B #* nested bullet B1 #* nested bullet B2 |
|
Alterando o tipo da lista
Por 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>
|
|
<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>
|
|
Site-wide
The standard #, ##, ### wikitext can be used alongside CSS in MediaWiki:Common.css to produce the usual system of numbered lists (1, 2, 3; then a, b, c; then i, ii, iii):
ol {
list-style-type: decimal;
}
ol li > ol {
list-style-type: lower-alpha;
}
ol li > ol li > ol {
list-style-type: lower-roman;
}
O primeiro ol acima é predefinição, não é necessário a menos que outro tipo de estilo de lista seja pedido.
| Texto da Wiki | Renderizando |
|---|---|
#list item A1 ##list item B1 ###list item C1 ###list item C2 ##list item B2 #list item A2 |
|
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 |
|
Uma lista de uma ou mais linhas começando com dois pontos cria uma lista de descrição 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>
|
|
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>
|
|
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
A especificação de um valor inicial é possível com a sintaxe HTML.
<ol start="9">
<li>Amsterdã</li>
<li>Roterdã</li>
<li>Haia</li>
</ol>
|
|
Ou:
<ol>
<li value="9">Amsterdã</li>
<li value="8">Roterdã</li>
<li value="7">Haia</li>
</ol>
|
|
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
|}
O resultado é:
| 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">
* 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">
* 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">
* 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><li>bb</li><li>ccc</li></ol></ul>
|<ul><ol start="128"><li>ddd</li><li>ee</li><li>f</li></ol></ul>
|}
O resultado é:
|
|
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 é:
|
|
{{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
O resultado é:
|
|
|
{{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
O resultado é:
|
|
|
{{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}
O resultado é:
|
|
|
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
- Module:Sort definition list - O módulo Scribunto permite que listas sejam ordenadas pelo termo definido, muito útil para wikis com múltiplos idiomas.