Wiki Group
PmWiki.WikiGroup History
Hide minor edits - Show changes to output
August 31, 2011, at 11:57 AM
by -
Changed lines 1-100 from:
6lGwQ9 , [url=http://lfopnqyvequj.com/]lfopnqyvequj[/url], [link=http://jpqbjsjvzvky.com/]jpqbjsjvzvky[/link], http://ybimzhtirpxj.com/
to:
(:Audience: authors (basic) :)
(:Summary: Organising pages into related groups:)
(:keywords trailing dot, trailing slash, default group:)
PmWiki pages are organized into groups of related pages. This feature was added to PmWiki to allow authors to create their own ''wiki spaces'' of specialized content on their own, without having to become, or rely on, wiki administrators. See [[http://pmichaud.com/|Pm]]'s [[http://pmichaud.com/pipermail/pmwiki-users/2006-March/024838.html|post]] to the pmwiki-users [[mailing list(s)]].
By default, page [[links]] are between pages of the same group; to create a link to a page in another group, add the name of the other group and a dot or slash to the page name. For example, links to [=Main/WikiSandbox=] could be written as:
(:markup class=horiz:)
* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | link text]]
* [[Main.WikiSandbox | +]]
(:markupend:)
To link to the [[#groupdefaultpage | default home page]] of a group, the name of the page can be omitted, like this:
(:markup class=horiz:)
* [[Main.]]
* [[Main/]]
(:markupend:)
!! Creating groups
Creating a new group is as easy as [[creating new pages]]; simply edit an existing page to include a [[link(s)]] to the new group's default home page (or any page in the new group) then click on the '?' to edit the page. As a rule, group names must start with a letter (but this can be changed by the wiki administrator by adding
-> @@[@$GroupPattern = '[[:upper:]\\d][\\w]*(?:-\\w+)*';@]@@
in config.php).
For example, to make a default page in the group Foo, create a link to [=[[Foo/]]=] (or [=[[Foo.]]=]).
To make a page called Bar in the group Foo, create a link to [=[[Foo/Bar]]=] and follow the link to edit that page.
!! Groups in a standard PmWiki distribution
* [[Main]]: The default group. On many wikis, it contains most of the author-contributed content. Main.HomePage and Main.WikiSandbox come pre-installed.
* [[PmWiki]]: An edit-protected group that contains PmWiki documentation and help pages.
* [[Site]]: Holds a variety of utility and configuration pages used by PmWiki, including [[<<]][=SideBar=], Search, Preferences, Templates, and [=AllRecentChanges=].
* [[SiteAdmin/]]: Holds a number of password protected administration and configuration pages used by PmWiki, including [[<<]] [=ApprovedUrls=], and Blocklist
* To list all the groups in a site, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q=fmt%3Dgroup|fmt=group]]".
* To list all the pages in a group, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q={$Group}%2F|GroupName/]]".
[[#specialpages]]
!! [[(PmWiki:)Special Pages]] in a Group
By default, the ''[[Recent Changes]]'' page of each group shows only the pages that have changed within that group; the ''[[Site.All Recent Changes]]'' page shows all pages that have changed in all groups.
Each group can also have ''[[Group Header(s)]]'' or ''Group Footer'' pages that contain text to be automatically prepended or appended to every page in the group. A group can also have a ''Group Attributes ''page that defines attributes (read and edit passwords) shared by all pages within the group.
Each page can also have its own individual read/edit password that overrides the group passwords (see [[Passwords]]).
Finally, [[wiki administrator]]s can set [[local customizations]] on a per-group basis--see [[Group Customizations]].
[[#groupdefaultpage]]
!! Group's default page
The default "start page" for a group is a page whose name is:
# the same as the group (Foo/Foo)
# HomePage (Foo/HomePage)
# a name that the administrator has assigned to the [={$DefaultName}=] variable in the configuration.php file.
Note, on this site, the value of [={$DefaultName}=] is ''{$DefaultName}'' and, thus, the default home page would be Foo/{$DefaultName}.
You can usefully change the default ''search'' order for an entered page name by setting the variable @@$PagePathFmt @@ in @@config.php@@, eg
-> @@ $PagePathFmt = array('$Group.$1', '$1.$DefaultName', '$1.$1', '$DefaultGroup.$1', 'Profiles.$1'); @@
where "$1" is the name of the page entered.
As noted above, when linking to the default home page, authors can omit the page name and simply identify the group followed by a forward slash ([=[[Foo/]]=]).
Note the forward slash is required to ensure that the link unambiguously points to the identified group.
If the slash is omitted, the link can end up being interpreted as pointing to an existing (or new) page in the current group (if the group, or its default home page, do not exist).
!! Subgroups? Subpages?
No, PmWiki does not have subpages. Pm's reasons for not having subgroups are described at [[PmWiki:Hierarchical Groups]], but it comes down to not having a good page linking syntax. If you create a link or pagename like [@[[A.B.C]]@] PmWiki doesn't think of "B.C" as being in group "A", it instead thinks of "C" as being in group "AB", which is a separate group from "A". Wiki administrators can look at [[Cookbook:Subgroup Markup]] and [[Cookbook:Include With Edit]] for recipes that may be of some help with developing subgroups or subpages.
!! Restricting the creation of new groups
You can set PmWiki's $GroupPattern variable to only accept the group names you want to define. For example, to limit pages to the "PmWiki", "Main", "Profiles", and "Example" groups, add the following to local/config.php:
-> $GroupPattern = '(?:Site|SiteAdmin|PmWiki|Main|Profiles|Example)';
With this setting, only the listed groups will be considered valid WikiGroups. You can add more groups to the list by placing additional group names separated by pipes (|).
See other solutions to this at [[Cookbook:Limit Wiki Groups]] and [[Cookbook:New Group Warning]].
>>faq<< [[#faq]]
Q: How can I get rid of the 'Main' group in urls for pages pointing to Main?
A: See [[Cookbook:Get Rid Of Main]].
Q: How can I limit the creation of new groups?
A: See [[Cookbook:Limit Wiki Groups]].
Q: Why doesn't [=[[St. Giles and St. James]]=] work as a link? (It doesn't display anything.)
A: Because it contains periods, and destroys PmWiki's file structure, which saves pages as [=Group.PageName=]. Adding those periods disrupts this format. Links may only contain words. If you need a link precisely as shown, the page must be named eg StGilesAndStJames then you can use the [=(:title:)=] directive to have the page's title appear with periods [=(:title St. Giles and St. James:)=]. (Although modern US and UK grammar now tend to drop the period to simplify style).
Q: How can I delete a wiki group?
A: Normally you can't, as this requires an admin with server-side access to delete the file that makes up the group's RecentChanges page. But there is an option method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
Q: How can I delete a wiki group's Group.RecentChanges page?
A: Normally you can't, as this requires an admin with server-side access to delete a file. But there is an optional method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
(:Summary: Organising pages into related groups:)
(:keywords trailing dot, trailing slash, default group:)
PmWiki pages are organized into groups of related pages. This feature was added to PmWiki to allow authors to create their own ''wiki spaces'' of specialized content on their own, without having to become, or rely on, wiki administrators. See [[http://pmichaud.com/|Pm]]'s [[http://pmichaud.com/pipermail/pmwiki-users/2006-March/024838.html|post]] to the pmwiki-users [[mailing list(s)]].
By default, page [[links]] are between pages of the same group; to create a link to a page in another group, add the name of the other group and a dot or slash to the page name. For example, links to [=Main/WikiSandbox=] could be written as:
(:markup class=horiz:)
* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | link text]]
* [[Main.WikiSandbox | +]]
(:markupend:)
To link to the [[#groupdefaultpage | default home page]] of a group, the name of the page can be omitted, like this:
(:markup class=horiz:)
* [[Main.]]
* [[Main/]]
(:markupend:)
!! Creating groups
Creating a new group is as easy as [[creating new pages]]; simply edit an existing page to include a [[link(s)]] to the new group's default home page (or any page in the new group) then click on the '?' to edit the page. As a rule, group names must start with a letter (but this can be changed by the wiki administrator by adding
-> @@[@$GroupPattern = '[[:upper:]\\d][\\w]*(?:-\\w+)*';@]@@
in config.php).
For example, to make a default page in the group Foo, create a link to [=[[Foo/]]=] (or [=[[Foo.]]=]).
To make a page called Bar in the group Foo, create a link to [=[[Foo/Bar]]=] and follow the link to edit that page.
!! Groups in a standard PmWiki distribution
* [[Main]]: The default group. On many wikis, it contains most of the author-contributed content. Main.HomePage and Main.WikiSandbox come pre-installed.
* [[PmWiki]]: An edit-protected group that contains PmWiki documentation and help pages.
* [[Site]]: Holds a variety of utility and configuration pages used by PmWiki, including [[<<]][=SideBar=], Search, Preferences, Templates, and [=AllRecentChanges=].
* [[SiteAdmin/]]: Holds a number of password protected administration and configuration pages used by PmWiki, including [[<<]] [=ApprovedUrls=], and Blocklist
* To list all the groups in a site, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q=fmt%3Dgroup|fmt=group]]".
* To list all the pages in a group, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q={$Group}%2F|GroupName/]]".
[[#specialpages]]
!! [[(PmWiki:)Special Pages]] in a Group
By default, the ''[[Recent Changes]]'' page of each group shows only the pages that have changed within that group; the ''[[Site.All Recent Changes]]'' page shows all pages that have changed in all groups.
Each group can also have ''[[Group Header(s)]]'' or ''Group Footer'' pages that contain text to be automatically prepended or appended to every page in the group. A group can also have a ''Group Attributes ''page that defines attributes (read and edit passwords) shared by all pages within the group.
Each page can also have its own individual read/edit password that overrides the group passwords (see [[Passwords]]).
Finally, [[wiki administrator]]s can set [[local customizations]] on a per-group basis--see [[Group Customizations]].
[[#groupdefaultpage]]
!! Group's default page
The default "start page" for a group is a page whose name is:
# the same as the group (Foo/Foo)
# HomePage (Foo/HomePage)
# a name that the administrator has assigned to the [={$DefaultName}=] variable in the configuration.php file.
Note, on this site, the value of [={$DefaultName}=] is ''{$DefaultName}'' and, thus, the default home page would be Foo/{$DefaultName}.
You can usefully change the default ''search'' order for an entered page name by setting the variable @@$PagePathFmt @@ in @@config.php@@, eg
-> @@ $PagePathFmt = array('$Group.$1', '$1.$DefaultName', '$1.$1', '$DefaultGroup.$1', 'Profiles.$1'); @@
where "$1" is the name of the page entered.
As noted above, when linking to the default home page, authors can omit the page name and simply identify the group followed by a forward slash ([=[[Foo/]]=]).
Note the forward slash is required to ensure that the link unambiguously points to the identified group.
If the slash is omitted, the link can end up being interpreted as pointing to an existing (or new) page in the current group (if the group, or its default home page, do not exist).
!! Subgroups? Subpages?
No, PmWiki does not have subpages. Pm's reasons for not having subgroups are described at [[PmWiki:Hierarchical Groups]], but it comes down to not having a good page linking syntax. If you create a link or pagename like [@[[A.B.C]]@] PmWiki doesn't think of "B.C" as being in group "A", it instead thinks of "C" as being in group "AB", which is a separate group from "A". Wiki administrators can look at [[Cookbook:Subgroup Markup]] and [[Cookbook:Include With Edit]] for recipes that may be of some help with developing subgroups or subpages.
!! Restricting the creation of new groups
You can set PmWiki's $GroupPattern variable to only accept the group names you want to define. For example, to limit pages to the "PmWiki", "Main", "Profiles", and "Example" groups, add the following to local/config.php:
-> $GroupPattern = '(?:Site|SiteAdmin|PmWiki|Main|Profiles|Example)';
With this setting, only the listed groups will be considered valid WikiGroups. You can add more groups to the list by placing additional group names separated by pipes (|).
See other solutions to this at [[Cookbook:Limit Wiki Groups]] and [[Cookbook:New Group Warning]].
>>faq<< [[#faq]]
Q: How can I get rid of the 'Main' group in urls for pages pointing to Main?
A: See [[Cookbook:Get Rid Of Main]].
Q: How can I limit the creation of new groups?
A: See [[Cookbook:Limit Wiki Groups]].
Q: Why doesn't [=[[St. Giles and St. James]]=] work as a link? (It doesn't display anything.)
A: Because it contains periods, and destroys PmWiki's file structure, which saves pages as [=Group.PageName=]. Adding those periods disrupts this format. Links may only contain words. If you need a link precisely as shown, the page must be named eg StGilesAndStJames then you can use the [=(:title:)=] directive to have the page's title appear with periods [=(:title St. Giles and St. James:)=]. (Although modern US and UK grammar now tend to drop the period to simplify style).
Q: How can I delete a wiki group?
A: Normally you can't, as this requires an admin with server-side access to delete the file that makes up the group's RecentChanges page. But there is an option method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
Q: How can I delete a wiki group's Group.RecentChanges page?
A: Normally you can't, as this requires an admin with server-side access to delete a file. But there is an optional method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
August 26, 2011, at 08:03 PM
by - JFSJvOjfRffhRkm
Changed line 1 from:
This is the perefct way to break down this information.
to:
6lGwQ9 , [url=http://lfopnqyvequj.com/]lfopnqyvequj[/url], [link=http://jpqbjsjvzvky.com/]jpqbjsjvzvky[/link], http://ybimzhtirpxj.com/
August 26, 2011, at 08:02 PM
by - yNUIYcgog
Changed line 1 from:
The forum is a brighter place tahkns to your posts. Thanks!
to:
This is the perefct way to break down this information.
August 26, 2011, at 06:48 PM
by - EJIermXcXVnQbscROh
Changed line 1 from:
Hot damn, looking prtety useful buddy.
to:
The forum is a brighter place tahkns to your posts. Thanks!
August 26, 2011, at 06:24 PM
by - TIepOnVgbzZnilGWnoL
Changed line 1 from:
hYGU2M <a href="http://xvbqckzdvoja.com/">xvbqckzdvoja</a>
to:
Hot damn, looking prtety useful buddy.
August 26, 2011, at 03:09 PM
by - uWjmHYhxIlZQoFpVQCm
Changed line 1 from:
Kudos to you! I hadn't thuohgt of that!
to:
hYGU2M <a href="http://xvbqckzdvoja.com/">xvbqckzdvoja</a>
August 26, 2011, at 09:47 AM
by - rdMezStczwxQL
Changed line 1 from:
You have shed a ray of snusihne into the forum. Thanks!
to:
Kudos to you! I hadn't thuohgt of that!
August 26, 2011, at 05:21 AM
by - FgPgpOypcKyal
Changed line 1 from:
Shoot, so that's that one supopses.
to:
You have shed a ray of snusihne into the forum. Thanks!
August 26, 2011, at 04:32 AM
by - rjBgDlnIGpJy
Changed line 1 from:
And I thugoht I was the sensible one. Thanks for setting me straight.
to:
Shoot, so that's that one supopses.
August 26, 2011, at 03:28 AM
by - bJVxeXkyYIYqGDSjKK
Changed line 1 from:
A4JTtE , [url=http://tznbswafpdqr.com/]tznbswafpdqr[/url], [link=http://ecpbphixmxpq.com/]ecpbphixmxpq[/link], http://vpzhtwugqhii.com/
to:
And I thugoht I was the sensible one. Thanks for setting me straight.
July 10, 2011, at 04:40 PM
by - KHkrUVOclJTfuXoKoto
Changed line 1 from:
46rSQB <a href="http://lbeouiyajfjs.com/">lbeouiyajfjs</a>
to:
A4JTtE , [url=http://tznbswafpdqr.com/]tznbswafpdqr[/url], [link=http://ecpbphixmxpq.com/]ecpbphixmxpq[/link], http://vpzhtwugqhii.com/
July 08, 2011, at 11:06 AM
by - UmFDIdSaxt
Changed line 1 from:
Kewl you shloud come up with that. Excellent!
to:
46rSQB <a href="http://lbeouiyajfjs.com/">lbeouiyajfjs</a>
July 07, 2011, at 11:01 PM
by - jJGhpXvYm
Changed line 1 from:
HTwBBH <a href="http://srwqdnibaljj.com/">srwqdnibaljj</a>
to:
Kewl you shloud come up with that. Excellent!
July 06, 2011, at 02:06 PM
by - QveQidkUWH
Changed line 1 from:
Good to see a taelnt at work. I cant match that.
to:
HTwBBH <a href="http://srwqdnibaljj.com/">srwqdnibaljj</a>
July 06, 2011, at 10:30 AM
by - sIxxujESKKob
Changed line 1 from:
http://www.tbsetaalpha.net/acomplia.html acomplia 770 http://www.giancarivi.com/ buy nexium bbgws http://www.dbwinebarandkitchen.com/ online order skelaxin 8163
to:
Good to see a taelnt at work. I cant match that.
February 06, 2011, at 12:05 AM
by - qrlYFfaCrERmlXm
Changed line 1 from:
http://www.puntodenfoque.com/flurazepam.html flurazepam tsunyv http://www.puntodenfoque.com/prednisone.html prednisone buy 048 http://www.puntodenfoque.com/prosom.html prosom =-(
to:
http://www.tbsetaalpha.net/acomplia.html acomplia 770 http://www.giancarivi.com/ buy nexium bbgws http://www.dbwinebarandkitchen.com/ online order skelaxin 8163
February 04, 2011, at 03:16 PM
by - ofEXEFUapjoDuFZZuKm
Changed line 1 from:
http://www.citiaction.org/ lunesta %-)) http://www.marsyslaw.org/prednisone.html prednisone pills 737289 http://www.rmspnaturecenter.org/propecia.html propecia :-(((
to:
http://www.puntodenfoque.com/flurazepam.html flurazepam tsunyv http://www.puntodenfoque.com/prednisone.html prednisone buy 048 http://www.puntodenfoque.com/prosom.html prosom =-(
January 25, 2011, at 10:44 AM
by - vIOZknPbuT
Changed line 1 from:
http://www.xingbing66.com/ birth control online pharmacy nexium propecia qqvui http://www.neoselvazoologicalconservancy.com/viagra.html buy viagra nozgyq http://www.81yiyu.com/ prednisone 91987
to:
http://www.citiaction.org/ lunesta %-)) http://www.marsyslaw.org/prednisone.html prednisone pills 737289 http://www.rmspnaturecenter.org/propecia.html propecia :-(((
January 19, 2011, at 11:39 AM
by - OHbJqbEa
Changed line 1 from:
http://www.theblockisback.com/louis_vuitton_monogram_miroir_golden_alma.html 76025 http://www.yvettepeters.com/ChanelGoldenBallerinaFlats.htm =-PP http://www.yvettepeters.com/ChristianLouboutinBlackRolandoPumps.htm gbt
to:
http://www.xingbing66.com/ birth control online pharmacy nexium propecia qqvui http://www.neoselvazoologicalconservancy.com/viagra.html buy viagra nozgyq http://www.81yiyu.com/ prednisone 91987
January 13, 2011, at 02:53 AM
by - XlZjYmcGYkAPlwqmku
Changed line 1 from:
http://www.centralparkposse.com/Acomplia.htm acomplia 20 mg hjsyek http://www.centralparkposse.com/Ativan.htm ativan xbon http://www.hermanamarthapereyrairaola.org/ acomplia 854861 http://www.gerryggriffin.com/propecia propecia >:OOO
to:
http://www.theblockisback.com/louis_vuitton_monogram_miroir_golden_alma.html 76025 http://www.yvettepeters.com/ChanelGoldenBallerinaFlats.htm =-PP http://www.yvettepeters.com/ChristianLouboutinBlackRolandoPumps.htm gbt
January 11, 2011, at 03:46 AM
by - StuMcIkLbwNLRSteBo
Changed line 1 from:
http://www.johnfritchey.com/tegretol.html tegretol lyt http://www.cafebabelseattle.com/buspirone.htm buspirone 551 http://www.johnfritchey.com/alli.html alli beabvz http://www.theinsurgentcampaign.com/crestor.html crestor cupvqs
to:
http://www.centralparkposse.com/Acomplia.htm acomplia 20 mg hjsyek http://www.centralparkposse.com/Ativan.htm ativan xbon http://www.hermanamarthapereyrairaola.org/ acomplia 854861 http://www.gerryggriffin.com/propecia propecia >:OOO
January 08, 2011, at 06:13 PM
by - ELjirOYBYvfRf
Changed line 1 from:
http://www.panzavidela.com/ acomplia and canadian pharmacies %)) http://www.librolacarta.com/levitra.html levitra 275609 http://www.reclaiminglife.com/ buy dreampharm from tramadol idr http://www.pcc2000.com/meridia.php meridia %-DDD
to:
http://www.johnfritchey.com/tegretol.html tegretol lyt http://www.cafebabelseattle.com/buspirone.htm buspirone 551 http://www.johnfritchey.com/alli.html alli beabvz http://www.theinsurgentcampaign.com/crestor.html crestor cupvqs
January 03, 2011, at 09:03 AM
by - LIMswiUHv
Changed line 1 from:
http://www.reclaiminglife.com/ tramadol 176763 http://www.obsessedwithbroadway.com/ meridia 8-OO http://www.enfoquesunad.com/ levitra zfj
to:
http://www.panzavidela.com/ acomplia and canadian pharmacies %)) http://www.librolacarta.com/levitra.html levitra 275609 http://www.reclaiminglife.com/ buy dreampharm from tramadol idr http://www.pcc2000.com/meridia.php meridia %-DDD
January 01, 2011, at 05:33 AM
by - rwriKwYF
Changed line 1 from:
http://www.obsessedwithbroadway.com/ meridia buy lowest ntqkn http://www.centralparkposse.com/Prednisone.htm order prednisone online =-)) http://www.dasolindas.com/ambien.html ambien buy 459
to:
http://www.reclaiminglife.com/ tramadol 176763 http://www.obsessedwithbroadway.com/ meridia 8-OO http://www.enfoquesunad.com/ levitra zfj
December 30, 2010, at 03:50 PM
by - ZpGJBZQbPEECPLUqxP
Changed line 1 from:
http://www.johnfritchey.com/fioricet.html fioricet 8OOO http://www.johnfritchey.com/lasix.html generic lasix :-OO http://www.theinsurgentcampaign.com/zoloft.html zoloft for sale 59857
to:
http://www.obsessedwithbroadway.com/ meridia buy lowest ntqkn http://www.centralparkposse.com/Prednisone.htm order prednisone online =-)) http://www.dasolindas.com/ambien.html ambien buy 459
December 25, 2010, at 12:39 AM
by - zlPPYEstY
Changed line 1 from:
http://www.calciofossacesia.com/xanax.html online xanax 8455 http://www.christinelegrandphotography.com/ultram.html ultram 248903 http://www.christinelegrandphotography.com/ ataxia es buy tramadol 3642
to:
http://www.johnfritchey.com/fioricet.html fioricet 8OOO http://www.johnfritchey.com/lasix.html generic lasix :-OO http://www.theinsurgentcampaign.com/zoloft.html zoloft for sale 59857
December 19, 2010, at 04:52 PM
by - UFpqXtfZWAryLlllN
Changed line 1 from:
eQEFPF <a href="http://ncatewpdbdea.com/">ncatewpdbdea</a>, [url=http://dwjjxsevsygg.com/]dwjjxsevsygg[/url], [link=http://ndmpvstgurcx.com/]ndmpvstgurcx[/link], http://mrhxxmmpwaku.com/
to:
http://www.calciofossacesia.com/xanax.html online xanax 8455 http://www.christinelegrandphotography.com/ultram.html ultram 248903 http://www.christinelegrandphotography.com/ ataxia es buy tramadol 3642
December 15, 2010, at 04:47 PM
by - hMrAjQXoJVhLxGAgze
Changed lines 1-100 from:
(:Audience: authors (basic) :)
(:Summary: Organising pages into related groups:)
(:keywords trailing dot, trailing slash, default group:)
PmWiki pages are organized into groups of related pages. This feature was added to PmWiki to allow authors to create their own ''wiki spaces'' of specialized content on their own, without having to become, or rely on, wiki administrators. See [[http://pmichaud.com/|Pm]]'s [[http://pmichaud.com/pipermail/pmwiki-users/2006-March/024838.html|post]] to the pmwiki-users [[mailing list(s)]].
By default, page [[links]] are between pages of the same group; to create a link to a page in another group, add the name of the other group and a dot or slash to the page name. For example, links to [=Main/WikiSandbox=] could be written as:
(:markup class=horiz:)
* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | link text]]
* [[Main.WikiSandbox | +]]
(:markupend:)
To link to the [[#groupdefaultpage | default home page]] of a group, the name of the page can be omitted, like this:
(:markup class=horiz:)
* [[Main.]]
* [[Main/]]
(:markupend:)
!! Creating groups
Creating a new group is as easy as [[creating new pages]]; simply edit an existing page to include a [[link(s)]] to the new group's default home page (or any page in the new group) then click on the '?' to edit the page. As a rule, group names must start with a letter (but this can be changed by the wiki administrator by adding
-> @@[@$GroupPattern = '[[:upper:]\\d][\\w]*(?:-\\w+)*';@]@@
in config.php).
For example, to make a default page in the group Foo, create a link to [=[[Foo/]]=] (or [=[[Foo.]]=]).
To make a page called Bar in the group Foo, create a link to [=[[Foo/Bar]]=] and follow the link to edit that page.
!! Groups in a standard PmWiki distribution
* [[Main]]: The default group. On many wikis, it contains most of the author-contributed content. Main.HomePage and Main.WikiSandbox come pre-installed.
* [[PmWiki]]: An edit-protected group that contains PmWiki documentation and help pages.
* [[Site]]: Holds a variety of utility and configuration pages used by PmWiki, including [[<<]][=SideBar=], Search, Preferences, Templates, and [=AllRecentChanges=].
* [[SiteAdmin/]]: Holds a number of password protected administration and configuration pages used by PmWiki, including [[<<]] [=ApprovedUrls=], and Blocklist
* To list all the groups in a site, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q=fmt%3Dgroup|fmt=group]]".
* To list all the pages in a group, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q={$Group}%2F|GroupName/]]".
[[#specialpages]]
!! [[(PmWiki:)Special Pages]] in a Group
By default, the ''[[Recent Changes]]'' page of each group shows only the pages that have changed within that group; the ''[[Site.All Recent Changes]]'' page shows all pages that have changed in all groups.
Each group can also have ''[[Group Header(s)]]'' or ''Group Footer'' pages that contain text to be automatically prepended or appended to every page in the group. A group can also have a ''Group Attributes ''page that defines attributes (read and edit passwords) shared by all pages within the group.
Each page can also have its own individual read/edit password that overrides the group passwords (see [[Passwords]]).
Finally, [[wiki administrator]]s can set [[local customizations]] on a per-group basis--see [[Group Customizations]].
[[#groupdefaultpage]]
!! Group's default page
The default "start page" for a group is a page whose name is:
# the same as the group (Foo/Foo)
# HomePage (Foo/HomePage)
# a name that the administrator has assigned to the [={$DefaultName}=] variable in the configuration.php file.
Note, on this site, the value of [={$DefaultName}=] is ''{$DefaultName}'' and, thus, the default home page would be Foo/{$DefaultName}.
You can usefully change the default ''search'' order for an entered page name by setting the variable @@$PagePathFmt @@ in @@config.php@@, eg
-> @@ $PagePathFmt = array('$Group.$1', '$1.$DefaultName', '$1.$1', '$DefaultGroup.$1', 'Profiles.$1'); @@
where "$1" is the name of the page entered.
As noted above, when linking to the default home page, authors can omit the page name and simply identify the group followed by a forward slash ([=[[Foo/]]=]).
Note the forward slash is required to ensure that the link unambiguously points to the identified group.
If the slash is omitted, the link can end up being interpreted as pointing to an existing (or new) page in the current group (if the group, or its default home page, do not exist).
!! Subgroups? Subpages?
No, PmWiki does not have subpages. Pm's reasons for not having subgroups are described at [[PmWiki:Hierarchical Groups]], but it comes down to not having a good page linking syntax. If you create a link or pagename like [@[[A.B.C]]@] PmWiki doesn't think of "B.C" as being in group "A", it instead thinks of "C" as being in group "AB", which is a separate group from "A". Wiki administrators can look at [[Cookbook:Subgroup Markup]] and [[Cookbook:Include With Edit]] for recipes that may be of some help with developing subgroups or subpages.
!! Restricting the creation of new groups
You can set PmWiki's $GroupPattern variable to only accept the group names you want to define. For example, to limit pages to the "PmWiki", "Main", "Profiles", and "Example" groups, add the following to local/config.php:
-> $GroupPattern = '(?:Site|SiteAdmin|PmWiki|Main|Profiles|Example)';
With this setting, only the listed groups will be considered valid WikiGroups. You can add more groups to the list by placing additional group names separated by pipes (|).
See other solutions to this at [[Cookbook:Limit Wiki Groups]] and [[Cookbook:New Group Warning]].
>>faq<< [[#faq]]
Q: How can I get rid of the 'Main' group in urls for pages pointing to Main?
A: See [[Cookbook:Get Rid Of Main]].
Q: How can I limit the creation of new groups?
A: See [[Cookbook:Limit Wiki Groups]].
Q: Why doesn't [=[[St. Giles and St. James]]=] work as a link? (It doesn't display anything.)
A: Because it contains periods, and destroys PmWiki's file structure, which saves pages as [=Group.PageName=]. Adding those periods disrupts this format. Links may only contain words. If you need a link precisely as shown, the page must be named eg StGilesAndStJames then you can use the [=(:title:)=] directive to have the page's title appear with periods [=(:title St. Giles and St. James:)=]. (Although modern US and UK grammar now tend to drop the period to simplify style).
Q: How can I delete a wiki group?
A: Normally you can't, as this requires an admin with server-side access to delete the file that makes up the group's RecentChanges page. But there is an option method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
Q: How can I delete a wiki group's Group.RecentChanges page?
A: Normally you can't, as this requires an admin with server-side access to delete a file. But there is an optional method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
(:Summary: Organising pages into related groups:)
(:keywords trailing dot, trailing slash, default group:)
PmWiki pages are organized into groups of related pages. This feature was added to PmWiki to allow authors to create their own ''wiki spaces'' of specialized content on their own, without having to become, or rely on, wiki administrators. See [[http://pmichaud.com/|Pm]]'s [[http://pmichaud.com/pipermail/pmwiki-users/2006-March/024838.html|post]] to the pmwiki-users [[mailing list(s)]].
By default, page [[links]] are between pages of the same group; to create a link to a page in another group, add the name of the other group and a dot or slash to the page name. For example, links to [=Main/WikiSandbox=] could be written as:
(:markup class=horiz:)
* [[Main.WikiSandbox]]
* [[Main/WikiSandbox]]
* [[(Main.Wiki)Sandbox]]
* [[Main.WikiSandbox | link text]]
* [[Main.WikiSandbox | +]]
(:markupend:)
To link to the [[#groupdefaultpage | default home page]] of a group, the name of the page can be omitted, like this:
(:markup class=horiz:)
* [[Main.]]
* [[Main/]]
(:markupend:)
!! Creating groups
Creating a new group is as easy as [[creating new pages]]; simply edit an existing page to include a [[link(s)]] to the new group's default home page (or any page in the new group) then click on the '?' to edit the page. As a rule, group names must start with a letter (but this can be changed by the wiki administrator by adding
-> @@[@$GroupPattern = '[[:upper:]\\d][\\w]*(?:-\\w+)*';@]@@
in config.php).
For example, to make a default page in the group Foo, create a link to [=[[Foo/]]=] (or [=[[Foo.]]=]).
To make a page called Bar in the group Foo, create a link to [=[[Foo/Bar]]=] and follow the link to edit that page.
!! Groups in a standard PmWiki distribution
* [[Main]]: The default group. On many wikis, it contains most of the author-contributed content. Main.HomePage and Main.WikiSandbox come pre-installed.
* [[PmWiki]]: An edit-protected group that contains PmWiki documentation and help pages.
* [[Site]]: Holds a variety of utility and configuration pages used by PmWiki, including [[<<]][=SideBar=], Search, Preferences, Templates, and [=AllRecentChanges=].
* [[SiteAdmin/]]: Holds a number of password protected administration and configuration pages used by PmWiki, including [[<<]] [=ApprovedUrls=], and Blocklist
* To list all the groups in a site, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q=fmt%3Dgroup|fmt=group]]".
* To list all the pages in a group, try [[PmWiki/Search | searching]] for "[[{$FullName}?action=search&q={$Group}%2F|GroupName/]]".
[[#specialpages]]
!! [[(PmWiki:)Special Pages]] in a Group
By default, the ''[[Recent Changes]]'' page of each group shows only the pages that have changed within that group; the ''[[Site.All Recent Changes]]'' page shows all pages that have changed in all groups.
Each group can also have ''[[Group Header(s)]]'' or ''Group Footer'' pages that contain text to be automatically prepended or appended to every page in the group. A group can also have a ''Group Attributes ''page that defines attributes (read and edit passwords) shared by all pages within the group.
Each page can also have its own individual read/edit password that overrides the group passwords (see [[Passwords]]).
Finally, [[wiki administrator]]s can set [[local customizations]] on a per-group basis--see [[Group Customizations]].
[[#groupdefaultpage]]
!! Group's default page
The default "start page" for a group is a page whose name is:
# the same as the group (Foo/Foo)
# HomePage (Foo/HomePage)
# a name that the administrator has assigned to the [={$DefaultName}=] variable in the configuration.php file.
Note, on this site, the value of [={$DefaultName}=] is ''{$DefaultName}'' and, thus, the default home page would be Foo/{$DefaultName}.
You can usefully change the default ''search'' order for an entered page name by setting the variable @@$PagePathFmt @@ in @@config.php@@, eg
-> @@ $PagePathFmt = array('$Group.$1', '$1.$DefaultName', '$1.$1', '$DefaultGroup.$1', 'Profiles.$1'); @@
where "$1" is the name of the page entered.
As noted above, when linking to the default home page, authors can omit the page name and simply identify the group followed by a forward slash ([=[[Foo/]]=]).
Note the forward slash is required to ensure that the link unambiguously points to the identified group.
If the slash is omitted, the link can end up being interpreted as pointing to an existing (or new) page in the current group (if the group, or its default home page, do not exist).
!! Subgroups? Subpages?
No, PmWiki does not have subpages. Pm's reasons for not having subgroups are described at [[PmWiki:Hierarchical Groups]], but it comes down to not having a good page linking syntax. If you create a link or pagename like [@[[A.B.C]]@] PmWiki doesn't think of "B.C" as being in group "A", it instead thinks of "C" as being in group "AB", which is a separate group from "A". Wiki administrators can look at [[Cookbook:Subgroup Markup]] and [[Cookbook:Include With Edit]] for recipes that may be of some help with developing subgroups or subpages.
!! Restricting the creation of new groups
You can set PmWiki's $GroupPattern variable to only accept the group names you want to define. For example, to limit pages to the "PmWiki", "Main", "Profiles", and "Example" groups, add the following to local/config.php:
-> $GroupPattern = '(?:Site|SiteAdmin|PmWiki|Main|Profiles|Example)';
With this setting, only the listed groups will be considered valid WikiGroups. You can add more groups to the list by placing additional group names separated by pipes (|).
See other solutions to this at [[Cookbook:Limit Wiki Groups]] and [[Cookbook:New Group Warning]].
>>faq<< [[#faq]]
Q: How can I get rid of the 'Main' group in urls for pages pointing to Main?
A: See [[Cookbook:Get Rid Of Main]].
Q: How can I limit the creation of new groups?
A: See [[Cookbook:Limit Wiki Groups]].
Q: Why doesn't [=[[St. Giles and St. James]]=] work as a link? (It doesn't display anything.)
A: Because it contains periods, and destroys PmWiki's file structure, which saves pages as [=Group.PageName=]. Adding those periods disrupts this format. Links may only contain words. If you need a link precisely as shown, the page must be named eg StGilesAndStJames then you can use the [=(:title:)=] directive to have the page's title appear with periods [=(:title St. Giles and St. James:)=]. (Although modern US and UK grammar now tend to drop the period to simplify style).
Q: How can I delete a wiki group?
A: Normally you can't, as this requires an admin with server-side access to delete the file that makes up the group's RecentChanges page. But there is an option method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
Q: How can I delete a wiki group's Group.RecentChanges page?
A: Normally you can't, as this requires an admin with server-side access to delete a file. But there is an optional method of making it possible to delete RecentChanges pages from within the wiki if the admin enables the code found on [[Cookbook:RecentChanges Deletion]].
to:
eQEFPF <a href="http://ncatewpdbdea.com/">ncatewpdbdea</a>, [url=http://dwjjxsevsygg.com/]dwjjxsevsygg[/url], [link=http://ndmpvstgurcx.com/]ndmpvstgurcx[/link], http://mrhxxmmpwaku.com/