Esta macro inclui o conteúdo formatado de uma(s) determinada(s) página(s) de wiki local, seguindo ficheiros que se auto-incluem caso existam. Se a auto-inclusão gerar ciclos, esta situação é detectada e prevenida!

Utilização:

• <<Include(pagename, heading, level, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>

pagename

Nome da página a incluir, se começar com um acento circunflexo "^", uma regex de páginas a incluir.

heading
Texto do cabeçalho criado que estabelecerá a ligação para a página incluída (opcional).
level
Nível (1..5) do cabeçalho criado (opcional).
from
Marcador de início de inclusão parcial (opcional).
to
Marcador de fim de inclusão parcial (opcional).
sort
Ordem de apresentação quando o nome da página é uma regex, ou seja, quando começa com um acento circunflexo (opcional).
items
Número máximo de páginas a incluir.
skipitems
Número de páginas iniciais a saltar (opcional).
titlesonly
Inclui apenas uma ligação para a página, não para o conteúdo da página (opcional).
editlink

Adiciona um rodapé com ligações para as páginas incluídas, normais e editáveis (opcional, disponível no MoinMoin desde a versão 1.3.4).

Todos os parâmetros, à excepção do nome da página, são opcionais, mas ter de seguir a ordem fornecida! Se quiser omitir o "heading", tem de deixar o segundo parâmetro vazio.

O from e o to também reconhecem o padrão nos comentários. Por isso, tenha atenção aos comentários que param a inclusão inesperadamente.

Exemplos:

• <<Include(FooBar)>> -- Inclui o texto da página FooBar no parágrafo actual

• <<Include(FooBar,"Foo Bar" )>> -- Adiciona um H1 de 'Foo Bar' ligado, seguido do texto

• <<Include(FooBar, , 2)>> -- Adiciona um H2 de 'Foo Bar'

• <<Include(FooBar, 'All about Foo Bar', 2)>> -- Adicione uma H2 de 'All about Foo Bar'

• <<Include(FooBar, , from="^----$")>> -- Inclui conteúdo apenas depois da primeira linha horizontal

• <<Include(FooBar, , to="^----$")>> -- Inclui conteúdo apenas antes da primeira linha horizontal

• <<Include(^FooBar/.*, , sort=descending)>> -- Apresenta a lista de páginas por ordem decrescente

• <<Include(^FooBar/.*, , items=3)>> -- Inclui no máximo três páginas

• <<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7)>> -- Exibe no máximo uma semana de um blog

• <<Include(^BlogBase/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>> -- Exibe apenas os títulos da semana anterior

• Pode utilizá-los com o MonthCalendar para blogs:

  • <<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=3)>> -- Exibe 3 itens do calendário mensal

  • <<Include(^FirstnameLastname/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>> -- Exibe apenas os título dos 4 itens seguintes