The PEAK Developers' Center   HelpMiscellaneous/FrequentlyAskedQuestions UserPreferences
HelpContents Search Diffs Info Edit Subscribe XML Print View Up
The following 606 words could not be found in the dictionary of 50 words (including 50 LocalSpellingWords) and are highlighted below:
20spaces   20with   Adding   Admin   Administering   Administration   All   Also   Another   Any   Are   At   Attach   Because   Blue   But   Can   Changes   Click   Configuration   Contents   Correcting   Cut   Dealing   Delete   Edit   Editability   Example   Explicit   File   Find   Finding   Follow   For   Formatting   Get   Help   Hence   Here   How   However   Icon   If   In   Index   Installation   Isn   It   Just   Like   Lineo   Links   Location   Make   Not   Note   Notes   Of   On   One   Other   Page   Pages   Pretty   Questions   Recent   Red   Save   See   Should   Some   Table   Template   Templates   Text   That   The   There   This   Thus   Title   To   Tooth   Type   We   Web   Weird   What   Why   Word   You   ability   about   access   accessing   accidental   accomplish   action   actions   activate   active   actual   add   added   adding   address   administer   administration   administrator   adminstrator   after   against   all   allow   allowed   allows   alphabetized   already   also   alter   an   and   anonymously   any   anyone   anything   appear   appropriate   architectures   are   as   at   attacker   attributions   auditor   automatically   available   average   avoid   back   backup   bar   be   because   becomes   been   better   biggest   bit   blank   body   both   bottom   box   brackets   brings   brought   but   by   c2   called   can   cannot   case   cases   caused   certain   change   changes   click   clicked   clicking   collaboration   collaborative   collaboratively   collaboritively   com   comment   commentary   commenting   compare   complete   config   conscious   consistency   consistent   content   control   convention   conventions   convey   corner   corruption   could   cover   create   creating   current   damage   dangerous   data   database   datadir   deal   dealing   dealt   default   define   deletions   derives   describe   designing   destruction   detected   detrimental   devalue   different   difficult   directly   directory   discouraged   discussion   do   document   documents   does   done   easily   easy   edit   editable   edited   else   encoding   ends   enter   entering   erasure   erasures   etc   even   event   every   everyone   example   examples   exception   executable   exist   existing   exists   expressions   extensions   extremely   fairly   fancy   feature   features   file   filename   filenames   files   fills   find   finding   first   fixed   follow   font   for   form   format   formats   formatted   formatter   formatting   free   from   full   general   generally   get   glass   go   going   good   groups   guys   has   have   headers   headings   hedge   help   helps   here   history   homepage   honest   hypertext   icon   ideas   if   image   implementation   important   improbable   in   inaccessible   include   including   incorrect   indent   informatin   information   installed   instance   intentional   intentionally   inter   internal   internally   interpreted   into   intranet   intranets   invitation   is   it   italicize   its   itself   just   keep   kept   keyword   kind   know   lacks   large   like   line   lineo   link   links   list   listed   little   location   log   look   lot   macro   macros   made   magnifying   main   maintained   major   make   making   manage   manipulate   manually   many   material   maybe   meaning   might   missing   mixed   modification   modify   more   most   much   must   my   name   named   nastiness   necessary   need   needed   new   non   normal   not   notification   number   obvious   of   off   often   older   on   one   only   onto   open   option   options   or   org   organization   orphan   other   others   our   outside   over   overhead   own   page   pages   pane   paragraph   parameter   parser   part   particular   paste   path   people   permissions   person   philosophy   physical   place   portion   possibility   possible   practice   prettier   previous   probably   problem   produces   program   project   projects   properly   provided   public   purpose   put   putting   python   question   questions   quickly   quite   rare   rather   raw   re   read   reading   real   recall   recent   recently   red   regular   related   replace   request   restore   restored   right   sabotage   saboteur   same   scan   search   security   see   select   serve   servername   set   several   shake   shares   shell   shortened   shorter   should   show   shows   sig   sign   significant   similar   simple   simply   since   single   sit   site   size   skills   so   some   someone   something   somewhat   spaces   spelling   stand   starting   state   statement   steps   stick   structure   subject   submission   sure   system   tag   take   template   term   terribly   text   than   that   the   their   them   then   there   these   they   thing   things   this   thread   through   thus   tips   title   titles   to   tool   tools   top   topic   trivial   trying   two   type   types   uncommon   under   up   usage   use   used   useful   user   users   using   usually   value   various   version   versions   very   view   want   was   way   ways   we   web   webserver   well   what   whatever   when   where   which   who   whole   whose   wide   wikibase   wildcards   will   wipeout   with   word   wording   words   work   working   works   would   write   wrong   yes   you   your   zope  

Clear message


  1. "What is a Wiki?" questions
    1. What is a ''Wiki''?
    2. What is a ''MoinMoin''?
    3. What is this good for?
    4. What are the major features of a Wiki?
    5. How does this compare to other collaboration tools, like Notes?
    6. What about Wiki security? Isn't a Wiki subject to complete wipeout or nastiness from a saboteur?
  2. Questions about using this Wiki
    1. Finding and accessing information in the wiki
      1. How can I search the wiki?
      2. How do I see what's been going on recently in the wiki?
      3. What are these WeirdRedLinks I keep finding all over the place?
    2. Adding information to the wiki
      1. How do add something to the wiki, or change something that's wrong?
      2. Are there any conventions I should follow when adding information?
      3. How can I add non-text information to the Wiki?
      4. How do I add an image to a page?
      5. Adding documents in an intranet
      6. Should I ''sign'' my changes?
    3. Adding other document formats to the wiki
      1. Can I add HTML to the wiki?
  3. Installation & Configuration
    1. Why is the "diff" feature not working?
    2. How do I activate the "DeletePage" option?
  4. Administering the Wiki
    1. How do I administer the wiki?
    2. Can I restore a page from an older version?
    3. How do I create a new Template page?

1 "What is a Wiki?" questions

1.1 What is a ''Wiki''?

The term Wiki is a shortened form of WikiWikiWeb. A Wiki is a database of pages that can be collaboritively edited using a web browser.

1.2 What is a ''MoinMoin''?

A MoinMoin is a wiki provided by the python wiki program MoinMoin.

1.3 What is this good for?

To be honest, it is good for whatever you use it for. At [WWW]Lineo we have put up a wiki on our internal web site with very many pages, which describe various projects, architectures, ideas, etc. for people to comment on. Some pages just sit there and convey information. Other pages are an open invitation for discussion and commentary. We also have set up a wiki for a very simple skills database.

In general, a wiki is very much a free-form tool, whose value derives from the use to which it is put. For instance, a page in a wiki can serve the same purpose as a discussion thread. You could use a wiki page to collaboratively work on a project.

Wikis are used internally by the guys who write [WWW]Zope to manage their ideas and projects.

1.4 What are the major features of a Wiki?

Here are some important wiki features:

1.5 How does this compare to other collaboration tools, like Notes?

A Wiki can accomplish certain things very easily, but there are some things it cannot do. The biggest missing feature is some kind of access control, to allow only certain groups to see and manipulate informatin.

1.6 What about Wiki security? Isn't a Wiki subject to complete wipeout or nastiness from a saboteur?

This is an important question. In general, wiki's have NO security. (That's right!) Because of this, the possibility exists for accidental or conscious destruction or corruption of part of all of the wiki.

There are two main ways to devalue a wiki. One is through erasure and the other is through corruption. Dealing with erasure is not terribly difficult, because there is a change log (and back versions) of every page maintained in a location inaccessible to web users. Thus, when page deletions or major content erasures are detected (which should be fairly quickly), pages can be restored quite easily to their previous good state.

Explicit and intentional corruption is more difficult to deal with. The possibility exists that someone can enter incorrect information onto a page, or edit pages to intentionally change the information so it is incorrect (for example, people can change the attributions on a page to make it look like a different person made a particular comment, or someone can change the content of a paragraph to alter its meaning in a detrimental way). Pretty much any collaborative system has this problem. A Wiki is just more wide open to it, since it lacks any security at all. In practice, wiki corruption is an extremely rare event, and one that can be dealt with (if needed) with the notification feature (to a fixed auditor) for new material submission.

In other words, the philosophy of wiki is one of dealing manually with the rare (exception) case of a saboteur, rather than designing in features and overhead (both in implementation and in usage) to avoid the damage caused by a saboteur.

2 Questions about using this Wiki

2.1 Finding and accessing information in the wiki

2.1.1 How can I search the wiki?

There are already more ways to search and/or scan the wiki than you can "shake a stick at":

2.1.2 How do I see what's been going on recently in the wiki?

Click on the RecentChanges link at the top of any page.

2.1.3 What are these WeirdRedLinks I keep finding all over the place?

Any mixed case name that doesn't have a page will show up as a red link.

2.2 Adding information to the wiki

2.2.1 How do add something to the wiki, or change something that's wrong?

If you see something you'd like to comment on, add to, or change, just click on the EditText link at the bottom of the page, or click on the icon at the top of the page. The page is brought up in a text-edit pane in your browser, and you simply make the changes. The wiki formatter will generally "do the right thing" with any text you enter. If you want to get fancy, you can do most of the same types of formatting that HTML allows you to do. See the HelpOnFormatting page for some tips and examples.

2.2.2 Are there any conventions I should follow when adding information?

Not very many. It helps to keep certain types of information formatted in a consistent way. One important convention that will help with consistency is the use of "Template" pages.

The wiki has a feature called "Templates" which show up when you create a new page. If you click on one of these when creating a new page, then that page will have a structure similar to others of the same type. For example, when creating your own Wiki homepage, you should use the HomepageTemplate page, which is available when you create a new page in the wiki.

2.2.3 How can I add non-text information to the Wiki?

If the content already exists on a web site, then just add a link to a wiki page. Follow these steps:

The wiki will automatically make a hypertext link from the text you type in.

You can make the link "prettier" by putting "cover" wording for the link in brackets. The cover wording will appear on the page, but the link will take the user to the URL when clicked on. Here's an example:

  [ This will be the link text] 

[WWW]This will be the link text

2.2.4 How do I add an image to a page?

You can include a url to the image in the page. Example: 

2.2.5 Adding documents in an intranet

If you're using MoinMoin on an intranet, it may be useful to make links to documents on file shares available to everyone reading your wiki. For example:
[file://servername/full/path/to/file/filename.txt Click here to read filename.txt]

You can also link to files with spaces in the filenames by manually entering the URL encoding for spaces(%20):

[file://servername/full/path/to/file/filename%20with%20spaces.txt Click here to read filename with spaces.txt]

Another obvious and maybe better option is to use the AttachFile action, which was added with version 0.11.

2.2.6 Should I ''sign'' my changes?

If they are significant, or you want people to know that you made them, then yes. Just put your name or email address after your comment. It is not uncommon to indent your comment under the statement your are commenting on. Also, it helps to italicize your comment to make it stand off from the main body of the page you are commenting on.

However, in some cases it may be appropriate to just make your change anonymously. Correcting spelling, formatting, or trivial word changes are some examples where it is not necessary (and even discouraged) for you to sign your modification.

2.3 Adding other document formats to the wiki

2.3.1 Can I add HTML to the wiki?

If you want to add a single line of HTML, use the HTML macro. This is done by putting your HTML text as a parameter to the HTML macro, like so:

[[HTML(<font size=+12>This is large font</font>)]]

This would show up on the page as: [[HTML(<font size=+12>This is large font</font>)]]

It's also possible to place an HTML document into a page by adding #format html as the first line in the page. If that line is there then the whole page will be interpreted as HTML (thus making links to other pages becomes a bit more difficult!) Make sure that you only add the body portion of the page (not the HTML headers or anything else outside of the body, including the <BODY> tag itself).

3 Installation & Configuration

3.1 Why is the "diff" feature not working?

Diffs need two things to work properly:

3.2 How do I activate the "DeletePage" option?

"DeletePage" is not active by default, since it's most often used in intranets only and is somewhat dangerous in public wikis. To allow this and other dangerous actions, add them like this to


4 Administering the Wiki

4.1 How do I administer the wiki?

There is a lot of administration information on the RecentChanges page, including the number of pages, and the macros and actions that are installed.

I usually set up an "AdminPage", where I put macros for these, as well as information about the real physical location of the pages, and macros for orphan pages or other things an adminstrator for the wiki might want to look at.

4.2 Can I restore a page from an older version?

Not directly. It's easy to do (if you have permissions where the actual wiki data files are kept). But usually, you must request the wiki administrator to restore the page for you. This is done as a hedge against the improbable case of someone trying to sabotage the wiki.

For people reading this FAQ page (which is probably not your average attacker), there is this way to restore a page:

  1. click on the little "i" in the top-right corner (PageInfo).
  2. click on "view" of the version you want to restore.
  3. in the "Location" bar of your browser, replace "action=recall" with "action=raw".
  4. Cut&paste the text into the edit box of that page, after clicking "EditPage".

4.3 How do I create a new Template page?

Templates are pages that show up automatically as options when you create a blank page. Any page that ends in the word Template will automatically show up in the list. Hence, if you want certain types of pages to have a similar format (similar headings, organization, etc.), you just define a page that ends in Template, and when creating pages of this type, select that template and edit it. The wiki fills in the starting content for you. Templates are editable wiki pages like any other.

To create a Template page, just create a new page called <something>Template

EditText of this page (last modified 2002-12-12 16:06:09)
FindPage by browsing, title search , text search or an index
Or try one of these actions: AttachFile, DeletePage, LikePages, LocalSiteMap, SpellCheck