| /EmbedObject /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:
`` -- Inclui o texto da página `FooBar` no parágrafo actual
`
Invalid include arguments "FooBar,"Foo Bar" "!
` -- Adiciona um H1 de 'Foo Bar' ligado, seguido do texto`` -- Adiciona um H2 de 'Foo Bar'
`` -- Adicione uma H2 de 'All about Foo Bar'
`` -- Inclui conteúdo apenas depois da primeira linha horizontal
`` -- Inclui conteúdo apenas antes da primeira linha horizontal
`` -- Apresenta a lista de páginas por ordem decrescente
`` -- Inclui no máximo três páginas
`` -- Exibe no máximo uma semana de um blog
`` -- Exibe apenas os títulos da semana anterior
Pode utilizá-los com o MonthCalendar para blogs:
`` -- Exibe 3 itens do calendário mensal
`` -- Exibe apenas os título dos 4 itens seguintes