Codex

As páginas no PmWiki são organizadas em grupos de páginas relacionadas. Esta característica foi adicionada ao PmWiki para permitir que autores possam criar seus próprios espaços wiki (wiki spaces) de conteúdo especializado por eles mesmos, sem precisar se tornar, ou depender de, administradores de wiki. Veja O post do Pm em post para a mailing list pmwiki-users .

Como padrão, os links acontecem entre páginas do mesmo grupo; para criar um link para uma página em outro grupo, adicione um ponto ou barra ao nome da página a ser acessada. Por exemplo, links para Main/WikiSandbox podem ser escritos como :

* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | texto]]
* [[Main.WikiSandbox | +]]

Um link para Página Inicial padrão de um grupo, O nome da página ode ser omitido, da seguinte maneira:

* [[Main.]]
* [[Main/]]

Criando grupos

Crirar um novo grupo é fácil como criar uma nova página?; simplesmente edite uma página existente incluindo um link para a home page padão do grupo (ou qualquer outra página no novo grupo) e então clique no sinal de '?' para editar a página. Como regra, nomes de grupos devem iniciar com uma letra (mas isso pode ser modificado pelo administrador do wiki, adicionando -> $GroupPattern = '[[:upper:]\\d][\\w]*(?:-\\w+)*'; no config.php).

Por exemplo, para fazer a página padrão no grupo Foo, crie um link para [[Foo/]] (ou [[Foo.]]). Para fazer uma página chamada Bar no grupo Foo, crie um link para [[Foo/Bar]] e siga o link para editar essa página.

Grupos na distribuição padrão do PmWiki

  • Main: O grupo padrão. Em muitos wikis, este grupo contem a maioria do conteúdo contribuido por usuários. Main.HomePage e Main.WikiSandbox vem pre-instalados.
  • PmWiki: Grupo protegido para edição que contém documentação do PmWiki e paǵinas de ajuda.
  • Site: Possui uma variedade de páginas de utilidade e configuração usadas pelo PmWiki, incluindo
    SideBar, Search, Preferences, Templates, e AllRecentChanges.
  • SiteAdmin: Possui páginas protegidas por senha de administratção e configuração usadas pelo PmWiki, incluindo
    ApprovedUrls, e Blocklist
  • Para listar todas as paǵinas em um site, tente procurar por "fmt=group".
  • Para listar todas as paǵinas em um grupo, tente procurar por "GroupName/".

Páginas especiais em um Grupo

Por padrão, a página Recent Changes de cada grupo mostra somente as páginas que mudaram dentro daquele grupo em que se encontra; Site.All Recent Changes mostra todas as páginas que mudaram em todos os grupos.

Cada grupo pode ter também páginas decabeçalho? ou rodapés que possuem texto que será pré-adicionado ou pós-adicionado para cada página no grupo. Um grupo também pode ter uma página de Atributos de grupo que define atributos (senhas para leitura e edição) que servem para todas as páginas no grupo.

Cada página pode ter também sua senha individual de leitura/edição que substitui as senhas de grupo (veja Passwords?).

E finalmente, Administrador de Wikis podem fazer LocalCustomizations? por grupo --veja GroupCustomizations?.

Página padrão de Grupo

A página padrão de um grupo é aquela cujo o nome é:

  1. o mesmo que o nome de grupo (Foo/Foo)
  2. HomePage (Foo/HomePage)
  3. um nome que o administrator tenha atribuido para a variável {$DefaultName} no arquivo config.php.

Note que, neste site, o valor de {$DefaultName} é HomePage e, portanto, a home page padrão seria Foo/HomePage.

Você utilmente, pode pode mudar a ordem padrão de busca para uma página, definindo a variável $PagePathFmt no config.php, eg

$PagePathFmt = array('$Group.$1', '$1.$DefaultName', '$1.$1', '$DefaultGroup.$1', 'Profiles.$1');

onde "$1" é o nome da paǵina entrada.

como se pode notar acima, quando criando um link para a página padrão de um grupo, os autores podem omitir o nome da página e simplesmente identificar o grupo seguido por uma barra ([[Foo/]]).

Note que a barra é requerida para assegurar que o link the link inequivocamente aponte para o grupo identificado. Se a barra fo omitida, o link pode ser interpretado como apontando para uma página existente, ou nova, dentro do grupo atual (se o grupo, ou a página padrão, não existirem).

Subgrupos? Subpáginas?

Não, o PmWiki não possui subpáginas. As razões do Pm para não existirem subgrupos são descritas em +, mas acaba não tendo uma boa sintaxe de linkagem de página. Se você criar um link ou pagename como [[A.B.C]] o PmWiki não pensa em "B.C" como sendo um grupo em "A", ao invés disso, pensa que "C" como sendo um grupo em "AB", que é um grupo separado de "A". Administradores Wiki podem olhar em SubgroupMarkup? e IncludeWithEdit? por receitas que talvez ofereçam alguma ajuda para desenvolver capacidades de subgrupos ou subpáginas.

Restringindo a criação de novos grupos

Você pode definir a variável $GroupPattern do PmWiki, para somente aceitar nomes de grupos que você defina. Ppor exemplo, para limitar a criação de grupos para "PmWiki", "Main", "Profiles", e "Example", adicione o seguinte no seu local/config.php:

$GroupPattern = '(?:Site|SiteAdmin|PmWiki|Main|Profiles|Example)';

com esta definição, somente os grupos listados serão consideradoscomo WikiGrupos válidos. Você pode adicionar mais grupos na lista , colocando mais nomes de grupos, separando-os a barra vertical (|).

Veja outras soluções para esse problema em + e +.

Como posso me livrar do grupo 'Main' em urls para páginas apontando para Main?

Veja Cookbook:Get Rid Of Main.

Como posso limitar a criação de novos grupos?

Veja Cookbook:Limit Wiki Groups.

Por que [[St. Giles and St. James]] não funcionam como links? (não aparece nada.)

Por que possuem pontos, e detroem a estrutura de arquivo do PmWiki, que salva as áginas comoGrupo.PageName. Adicionando estes pontos rompe com o formato. Links devem conter somente palavras. Se você precisa de um link como mostrado, a página deve ser nomeada eg StGilesAndStJames e então você pode usar diretiva (:title:) para ter o título da página aparecendo com os pontos (:title St. Giles and St. James:). (Apesar de que na gramática dos USA o ponto é omitido e na gramática do UK o ponto must be é omitido para contrações como St).

Como deleto um grupo wiki?

Normalmente você não pode, pois isso requer ua ajuda de um administrador com acesso ao servidor para deletar o arquivo que faz a página de grupo 'RecentChanges'. Mas existe um método opcional de fazer possível se deletar paǵinas RecentChanges de dentro do Wiki caso o administrador abilite o código encontrado em Cookbook:RecentChanges Deletion.

Como posso deletar a página de grupo Grupo.RecentChanges?

Normalmente você não pode, pois isso requer ua ajuda de um administrador com acesso ao servidor para deletar o arquivo . Mas existe um método opcional de fazer possível se deletar paǵinas RecentChanges de dentro do Wiki caso o administrador abilite o código encontrado em Cookbook:RecentChanges Deletion.


Essa é possivelmente a tradução do original em : PmWiki.WikiGroup - Links de retorno
Essa tradução se encontra em : PmWikiPtBr.WikiGroup - Links de retorno
Últimas modificações da tradução feitas em : 10 de setembro de 2011, às 13:00
Últimas modificações feitas no original em : 23 de novembro de 2015, às 16:39