STI:MediaWiki:Ajuda:Listas
Esta página trata da criação de listas no MediaWiki.
Lista básica
MediaWiki oferece três tipos de listas: listas ordenadas , listas não ordenadas e descrição ou definição lista . Nas seções a seguir, listas ordenadas são usadas para exemplos. Listas não ordenadas dariam resultados correspondentes.
| Wikitexto | Renderização |
|---|---|
* Listas são fáceis de fazer: ** comece cada linha * com uma estrela ** mais estrelas significam *** níveis mais profundos |
|
* Uma nova linha * em uma lista marca o fim da lista. Claro * você pode * comece de novo. |
Claro
|
# Listas numeradas são boas ## muito organizado ## fácil de seguir |
|
* Você também pode ** quebrar linhas ** como essa |
|
; Listas de descrição ou definição ; item: definição ; ponto e vírgula mais termo : dois pontos mais definição |
|
; Listas de definição mista ; item 1: definição :; subitem 1 mais termo :: dois dois pontos mais definição :; subitem 2: dois pontos mais definição ; item 2 : voltar para a lista principal |
|
* Ou crie listas mistas *# e aninhá-los *#* como isso *#*; definições *#*: trabalhos: *#*; maçã *#*; banana *#*: frutas |
|
Parágrafos em listas
Para simplificar, os itens da lista na marcação do wiki não podem ser maiores do que um parágrafo. Uma linha em branco a seguir encerrará a lista e zera o contador nas listas ordenadas. A separação de itens de lista não ordenados geralmente não tem efeitos perceptíveis.
Parágrafos podem ser forçados em listas usando tags HTML. Dois símbolos de quebra de linha,
<br/><br/>
criarão o efeito desejado. O mesmo acontecerá incluindo tudo, exceto o primeiro parágrafo com
<p>...</p>
.
Continuando um item da lista depois de um subitem
Em HTML, um item de lista pode conter várias sublistas, não necessariamente adjacentes; portanto, pode haver partes do item da lista não apenas antes da primeira sublista, mas também entre as sublistas e depois da última. No entanto, na sintaxe wiki, as sublistas seguem as mesmas regras das seções de uma página: a única parte possível do item da lista que não está nas sublistas é antes da primeira sublista.
No caso de uma lista de primeiro nível não numerada no código wikitext, essa limitação pode ser superada dividindo a lista em várias listas; texto recuado entre as listas parciais pode servir visualmente como parte de um item de lista após uma sublista; no entanto, isso pode fornecer, dependendo do CSS, uma linha em branco antes e depois de cada lista, caso em que, para uniformidade, cada item da lista de primeiro nível poderia ser feito uma lista separada.
Listas numeradas ilustram que o que deveria ser uma lista pode, para o software, consistir em várias listas; listas não numeradas fornecem um resultado correspondente, exceto 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> item da lista contínua A1
</li>
<li> item da lista A2 </li>
</ol>
|
|
| vs. | |
#list item A1 ## item da lista B1 ## item da lista B2 #: continuando o item da lista A1 #list item A2 |
|
Um nível mais profundo, com um item da sublista continuando após uma sublista, obtém-se ainda mais linhas em branco; no entanto, a continuação da lista de primeiro nível não é afetada:
#list item A1 ## item da lista B1 ### listar item C1 ##: continuando o item da lista B1 ## item da lista B2 #list item A2
Resulta em:
- list item A1
- item da lista B1
- listar item C1
- continuando o item da lista B1
- item da lista B2
- item da lista B1
- list item A2
É possível incorporar marcadores não numerados dentro de itens numerados:
# item A da lista #* marcador A1 #* marcador A2 aninhado # item contínuo da lista B #* marcador aninhado B1 #* marcador aninhado B2
Resulta em:
- item A da lista
- marcador A1
- marcador A2 aninhado
- item contínuo da lista B
- marcador aninhado B1
- marcador aninhado B2
Alterar o tipo de lista
O tipo de lista (qual tipo de marcador aparece antes do item da lista) pode ser alterado em CSS definindo a propriedade list-style-type:
| Wikitexto | Renderização |
|---|---|
|
<ol style="list-style-type:lower-roman">
<li> Sobre o autor </li>
<li> Prefácio da primeira edição </li>
<li> Prefácio da segunda edição </li>
</ol> |
|
|
<ol style="list-style-type:lower-alpha">
<li> Sobre o autor </li>
<li> Prefácio da primeira edição </li>
<li> Prefácio da segunda edição </li>
</ol> |
|
Recuo extra de listas
Em uma lista numerada em uma fonte grande, alguns navegadores não mostram mais de dois dígitos, a menos que recuo extra seja aplicado (se houver várias colunas: para cada coluna). Isso pode ser feito com CSS:
ol {margin-left: 2cm}
ou alternativamente, como abaixo.
| Wikitexto | Renderização | Comentários |
|---|---|---|
:#abc :#def :#ghi |
|
Uma lista de uma ou mais linhas começando com dois pontos cria uma lista de descrição sem termos de definição e com os itens como descrições de definição, portanto, recuados. No entanto, se os dois pontos estão na frente dos códigos "*" ou "#" de uma lista não ordenada ou ordenada, a lista é tratada como uma descrição de definição, portanto, toda a lista é recuada. |
|
<ul>
<ol>
<li> abc </li>
<li> def </li>
<li> ghi </li>
</ol>
</ul> |
|
O MediaWiki traduz uma lista não ordenada (ul) sem nenhum item da lista (li) em uma div com um style="margin-left: 2em", causando recuo no conteúdo. Este é o método mais versátil , pois permite iniciar com um número diferente de 1, veja abaixo. |
|
<ul>
#abc
#def
#ghi
</ul> |
|
Como acima, com o conteúdo da "lista não ordenada sem nenhum item da lista", que em si é uma lista ordenada, expressa com # códigos. O HTML produzido e, portanto, a renderização, é o mesmo. Este é o método recomendado ao iniciar a lista em 1. |
Especificando um valor inicial
Especificar 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 da tabela:
{|
|-
| align=right | 9.|| Amsterdam
|-
| align=right | 10.|| Rotterdam
|-
| align=right | 11.|| The Hague
|}
Resulta em:
| 9. | Amsterdam |
| 10. | Rotterdam |
| 11. | The Hague |
Esta numeração não automática tem a vantagem de que, se um texto se refere a números, a inserção ou exclusão de um item não atrapalha a correspondência.
Listas com várias colunas
Lista com marcadores de várias colunas:
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
* apple
* carpet
* geography
* mountain
* nowhere
* postage
* ragged
* toast
</div>Resulta em:
- apple
- carpet
- geography
- mountain
- nowhere
- postage
- ragged
- toast
Vamos a outro exemplo:
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* apple
* carpet
* geography
* mountain
* nowhere
* postage
* ragged
* toast
</div>Resulta em:
- apple
- carpet
- geography
- mountain
- nowhere
- postage
- ragged
- toast
Lista numerada multi-coluna
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
#apple
#carpet
#geography
#mountain
#nowhere
#postage
#ragged
#toast
</div>Resulta em:
- apple
- carpet
- geography
- mountain
- nowhere
- postage
- ragged
- toast
Abaixo, um valor inicial é especificado, com a sintaxe HTML (para a primeira coluna, a sintaxe wiki ou a sintaxe HTML pode ser usada).
Em combinação com o recuo extra explicado na seção anterior:
{| 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>
|}Resulta em:
|
|
Usando um Template, 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 o último, devem ser especificados. Adicionar um item ou remover um item de uma coluna requer o ajuste de apenas um número, o número de itens nessa coluna, em vez de alterar os números iniciais de todas as colunas subsequentes.
Estilo aerodinâmico ou estilo horizontal
Também é possível apresentar listas curtas usando uma formatação muito básica, como:
'' Título da lista: '' exemplo 1, exemplo 2, exemplo 3
Título da lista: exemplo 1, exemplo 2, exemplo 3
Este estilo requer menos espaço na página e é preferido se houver apenas algumas entradas na lista, pode ser lido facilmente e não é necessário um ponto de edição direto. Os itens da lista devem começar com uma letra minúscula, a menos que sejam nomes próprios.
Tabelas
Uma tabela de uma coluna é muito semelhante a uma lista, mas permite a classificação. Se o wikitexto em si já estiver classificado com a mesma chave de classificação, essa vantagem não se aplica. Uma tabela de várias colunas permite a classificação em qualquer coluna.
Alterar listas não ordenadas para aqueles ordenados
Com o CSS
ul { list-style: decimal }
listas não ordenadas são alteradas para listas ordenadas. Isso se aplica (desde que o seletor CSS não restrinja isso) a todas as listas ul no código-fonte HTML:
- aqueles produzidos com *
- aqueles com
<ul>
no wikitexto
- aqueles produzidos pelo sistema
Uma vez que cada página especial, como 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. No entanto, não parece possível ordenar todas as listas de histórico de página (a menos que se faça todas as listas ordenadas), porque o nome da classe é baseado na página para a qual o histórico é visualizado.
|
| ||
