| /EmbedObject /ImageLink /Include /MailTo /MonthCalendar |
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