Creating Pages
Bottom-Up Won't Take You Far
One of the frequently asked questions of new users not accustomed to the Wiki-way in general or Pie in particular is:
"Where is the button, link or gadget to create new pages?"
Usually, the oh-so-simple answer is:
"There is none. You don't click buttons to summon pages out of thin air."
Typically, you don't create new pages by themselves. Doing so would inevitably result in the new page being an orphaned page, that is, a parentless page that is not referred by an other page. In lieu thereof, you rather link pages from other, already existing, pages. Linking pages via so-called hyper text links is a central dogma of most Web-based software.
The Top-Down Approach
To create a new page, you simply place a link to it on an other page. As for Pie, there is always at least one single page: the home page, a.k.a. MainPage. It is the root document of all other pages and parent to any number of children and descendants. Theoretically, the MainPage is the only orphaned page, but even the MainPage may be referred back by any one of its children or grand children, thereby freeing it from its orphaned state.
To place a link on one of your pages, you edit the page and create a local link. Pie's links are enclosed in double brackets. Once the parent page has been updated and compiled, it features a clickable link to its new, still missing child.
My First Link
In the forthcoming example, we call a new page, MyPage, by placing the character string [[MyPage]] somewhere on another page. When you click on the new link, Pie will confront you with a notification that the page could not be found, followed by a button to create it right away.
That's the way it works. That's the way you create pages, eventually even by clicking a button. And that's the way you make sure not to generate orphaned pages.
Deleting & Renaming Pages
It can't be overemphasized: deleting and renaming pages is generally a bad idea, especially in a multi-user environment. The reason is that as soon as you delete or rename a page (or a file) all links to it stop working and would have to be adapted. Consequently, if you try to remove a resource that has referers, Pie will issue a respective warning.
It is therefore recommended to choose well-rounded and self-explanatory names for pages that other users find acceptable and reasonable as well and that will not have to be changed, nor removed later on.