##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt
<<Navigation(siblings)>>
<<BR>><<BR>>
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 [[WikiMoinMoin|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 MoinMoin: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 
