Wiki Page Content



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