| /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:
<<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