Knowledge Base Editing ~ Create/Delete Pages

Add One New Page

New pages are created in two stages. First insert a hyper-link, then create the page.

You can practice this in the PlayGround if you wish.

Choose the appropriate contents index page that needs the new page, and edit a Hyper-Link for the new page name into this page. The new page name should reflect the intended topic, but this can be adjusted later.
e.g.

  * [[One New Page]]

Contents pages usually present page links in an unordered bullet list, so don't forget the asterisk (*).

Save the contents index page, and note that the link is red, because the page has not yet been created.

Create This Page

Click on the red link and the new page will open with the headline This topic does not exist yet.

As the text under the headline suggests, click on the Create this page option above and below the sidebar menu.

Edit the page contents, giving some consideration to the ====== Level 1 Headline ======, because this headline will appear in the contents index page in place of the page name link. This headline will also appear as the link name for any other link to this new page. However, in both these cases the name can be overridden with Link Text. The headline will also get listed in the section Alphabetic Index, and the Knowledge Base Index, but cannot be altered with Link Text.

If you want to leave the page in an 'unfinished' state, then use the FIXME code FIXME icon as a reminder.

Use the Preview button to check what the page will look like.

If you decide not to create the page after all, then click the Cancel button and OK button, and if necessary delete the original hyper-link.

When your initial editing is finished, remember to Save the page.

Add New Subsection

If what you are adding will require more than a single page, then add another contents index subsection to the appropriate contents index page. This requires a similar two stage process.

Insert Hyper-Link

Edit a Hyper-Link for the new index page name into the parent contents page.
e.g.

  * [[.:New Subsection:Index]]

This will create what is called a namespace for the new subsection. Think of Wiki namespaces as nested Windows folders. Later you will add individual subsection pages to the new subsection contents index page.

Create This Page

Click on the red link and the new page will open with the headline This topic does not exist yet.

Click on the Create this page option above and below the sidebar menu.

Choose an appropriate ====== Level 1 Headline ====== for this subsection contents page, and perhaps insert an introduction to the subsection topic, then Save the page.

Now you can use the Add One New Page technique above to add your subsection pages.

Delete Old Page

If you create a page by mistake, or a page becomes redundant, you can delete it.

First check how many other pages link to this old page, by using the Tools > Backlinks command to reveal any backlinks to this page.

If there are a great number of backlinks, the page is clearly not redundant and should not be deleted.

Otherwise, edit the listed pages that contain these links until the command says there are no backlinks.

Now Edit this old page, then click the Page Management page management link below, and use its Page Deletion form to give a Reason before ticking the boxes and clicking Save.

An alternative method is to insert the DELETEME code DELETEME icon and request an administrator to remove the page via the Web Site Usage forum.

Move/Rename Page

Edit the page, then click the Page Management page management link below, and use its Page Rename form to give the New name and Reason before ticking the boxes and clicking Save.

If the New name is just a Page name then it will be renamed.

If the New name includes a Namespace then the Page will be moved.

Any Backlinks to this Page will be automatically updated.

You cannot easily move or rename a page, so the best technique is to combine Add One New Page with Delete Old Page.

Create the page with its new name, then copy & paste all the edit window contents of the old page to the new page.

Finally, deal with all the backlinks and the old page as in the Delete Old Page method above.

However, if there are too many backlinks, the best solution maybe to redirect the old page to the new page by replacing the entire contents with a GOTO macro. See the Control Macros guide.
e.g.

~~GOTO>New Page Name~~

Alternative Index Entries

Sometimes one page will cover several things that need to be indexed under more than one heading.
e.g. [[glossary:dates:Using the Julian and Gregorian Calendars]]
i.e. Using the Julian and Gregorian Calendars needs index entries for Julian Dates and Gregorian Dates as well.

To do this we use the glossary:alt namespace and the Alternate Wiki Pages page.

Simply add a new page hyper-link to this page for each alternative entry you want.
e.g.

[[glossary:alt:Julian Dates]]
[[glossary:alt:Gregorian Dates]]

Then click on each link and create the page as described earlier. The template in the glossary:alt namespace will do most of the work for you. Simply replace the bit that says "replace with page link", with the page name you want to go to, but without the double square brackets.
e.g.

See ~~GOTO>replace with page link~~

becomes

See ~~GOTO>glossary:dates:Using the Julian and Gregorian Calendars~~