The following 648 words could not be found in the dictionary of 615 words (including 615 LocalSpellingWords) and are highlighted below:

20spaces   20with   ability   about   accessing   accidental   account   action   actions   activate   add   Adding   adding   Admin   administer   Administering   Administration   administration   adminstrator   all   All   allowed   allows   alphabetized   already   alter   an   ancounted   and   anonymously   another   Another   answered   anyone   anything   anyway   appear   appropriate   architectures   assuming   at   Attach   attached   attaching   attributions   auditor   automatically   available   avoid   back   Ball   basics   be   Because   because   becomes   been   Beginners   being   best   better   between   bit   blank   Blue   body   both   box   bracket   brackets   Brion   brought   bug   bugs   Bugs   But   but   by   c2   called   can   Can   case   cases   caused   certain   changed   Changes   changes   characters   choose   clicked   coder   collaborative   collaboratively   collaboritively   collection   coloured   comes   comment   commentary   commenting   Comparison   complete   completely   Configuration   cons   conscious   consistency   consistent   contains   Contents   contrast   control   Control   convention   conventions   convey   corner   Correcting   corresponding   corruption   cover   creates   creating   creation   cross   current   damage   database   days   deal   dealing   Dealing   dealt   default   define   Delete   delete   deleted   deletions   derives   describe   designer   designing   destruction   detected   detrimental   Dev   devalue   developed   Developer   developer   developers   Development   development   Diagnosis   different   differently   difficult   Disable   discouraged   discussion   document   documents   domain   done   down   easier   easily   easy   edit   Edit   editability   editable   edited   else   encoding   ends   Engine   enough   enter   entering   entries   erased   erasure   erasures   etc   even   event   every   everybody   everyone   example   Example   examples   exception   existing   exists   Explicit   expressions   extend   extensions   extremely   fairly   famous   fancy   farther   feature   features   File   file   filename   filenames   files   fills   find   Find   Finding   finding   fixed   follow   Follow   font   For   for   forever   form   format   formats   formatted   formatter   formatting   forums   found   from   front   Front   full   geek   general   generally   get   Get   gives   go   goes   going   good   Guide   headers   headings   help   Help   helps   Hence   history   homepage   How   However   hypertext   icon   Icon   ideas   if   If   image   implementation   important   in   In   incidentally   include   including   incorrect   indent   Index   information   Installation   installed   instance   instances   instead   intentional   intentionally   interface   internal   interpreted   into   intranet   introduction   invitation   Isn   italicize   its   itself   Just   just   keep   keyword   klick   know   Languages   large   Learn   less   like   Like   line   link   Linking   links   Links   list   listed   lists   Lists   little   local   location   Log   log   look   looks   lot   Ls   macro   macros   made   mailing   main   major   Make   make   making   manually   many   material   maybe   meaning   Meat   Media   might   mixed   modification   modify   more   More   most   Most   much   my   name   named   nastiness   necessary   need   needed   net   new   newline   noise   non   normal   notification   number   obvious   Of   of   off   often   older   On   on   One   one   only   onto   open   option   options   or   organization   orphan   Other   other   others   our   outside   over   overhead   own   page   Page   pages   Pages   pane   paragraph   parameter   parser   particular   path   people   person   philosophy   physical   place   portion   possibility   possible   practice   Preferences   prettier   Pretty   previous   primarily   problem   produces   program   programming   project   projects   pros   purpose   put   putting   python   Python   question   questions   Questions   quickly   quite   rare   rather   re   read   reading   Real   real   reason   recent   Recent   recently   reference   regex   regular   related   Rename   rename   render   renders   restore   restored   revert   reverted   revisions   right   running   saboteur   same   save   Save   scale   scan   search   secondarily   Security   security   See   see   select   sense   serve   servername   servers   Set   set   several   shake   sharename   shares   shortened   Should   should   show   shows   sig   sign   significant   similar   simple   simply   since   single   sit   site   sites   size   skills   so   Soft   Some   some   someone   something   sourceforge   spaces   spelling   stand   standard   start   starting   state   statement   steps   stick   Stories   structure   structured   subject   submission   Success   Super   supports   sure   switch   system   System   Table   tag   take   targeted   Template   template   Templates   term   terribly   test   tests   Text   text   than   that   That   The   the   their   them   Theme   themes   then   There   there   these   they   They   thing   things   think   this   This   those   thread   through   thus   Thus   time   tips   Title   title   titles   to   To   tool   Tooth   top   topic   traceback   translation   Translation   translator   trivial   two   type   Type   types   uncommon   under   unsecure   up   usage   use   Use   used   useful   User   user   using   usually   value   variables   various   version   versions   very   Vibber   view   want   way   ways   Web   web   weird   well   what   What   whatever   when   Where   where   which   whole   whose   Why   why   wikibase   wikiconfig   Wikimedia   Wikipedia   wildcards   will   wipeout   wish   with   word   Word   wording   words   work   Works   works   would   wrong   yes   You   you   your  

    HelpMiscellaneous/FrequentlyAskedQuestions

Index

Contents

  1. "What is a Wiki?" questions
    1. What is a ''Wiki''?
    2. What is this good for?
    3. What are the major features of a Wiki?
    4. What about Wiki security? Isn't a Wiki subject to complete wipeout or nastiness from a saboteur?
  2. Questions about MoinMoin in general
    1. If MediaWiki is more famous and developed in PHP, why should anyone should choose MoinMoin instead?
    2. What are the pros and cons to use MediaWiki or MoinMoin?
  3. 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. How can I get RecentChanges to go farther back in time than it goes by default?
      4. What are these weird differently coloured links I keep finding all over the place?
    2. Editing in 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 can I avoid the use of [[BR]] and use normal newline characters instead?
      5. How do I add an image to a page?
      6. How do I create a new Template page?
      7. Adding documents in an intranet
      8. Should I ''sign'' my changes?
      9. What if I delete entries in pages, and you think you need them? Is it erased completely?
    3. Adding other document formats to the wiki
      1. Can I add HTML to the wiki?
    4. Linking in the wiki
      1. How do I link to something outside my wiki, as with an html a tag?
  4. Installation & Configuration
    1. How do I activate the "DeletePage" / "RenamePage" option?
    2. How do I change the start page?
  5. Administering the Wiki
    1. How do I administer the wiki?
    2. How do I delete a user?
    3. Can I restore a page from an older version?
  6. Developer help
    1. Where to start as a coder?
    2. Where to start as a designer or translator?
    3. MoinMoin Diagnosis

"What is a Wiki?" questions

What is a ''Wiki''?

The term Wiki is a shortened form of WikiWikiWeb. A Wiki is a collection of pages that can be collaboritively edited using a web browser. They are open and free for anyone to edit as they wish. The system creates cross-reference hyperlinks between pages automatically. See WikiWikiWeb for more info.

MoinMoin is a python wiki program.

What is this good for?

It is good for whatever you use it for. In contrast to forums and mailing lists WikiWiki allows the creation of content. Because of this Wikis have much less noise and more information. The information is structured and easier to find. You can put up a wiki on your internal web site with 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. You could also 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.

See MoinMoinSuccessStories for more use cases.

What are the major features of a Wiki?

Here are some important wiki features:

  • editability by anyone - a wiki page is editable by anyone with a web browser
  • ability to view recent changes
  • ability to search pages (several ways)
  • ability to very easily add new pages
  • ability to see the change history for a document
  • ability to add new information or modify existing information

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

This is an important question. In general, wikis used to have NO security. (That's right!)

For MoinMoin this has changed with the introduction of Access Control Lists, see HelpOnAccessControlLists.

But, assuming you do not use ACLs, the possibility exists for accidental or conscious destruction or corruption of the current page revisions in 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 and they can be reverted easily. 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. 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 (the term for that is SoftSecurity) 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.

Questions about MoinMoin in general

If MediaWiki is more famous and developed in PHP, why should anyone should choose MoinMoin instead?

  • Because MoinMoin is in Python (maybe that is not an obvious reason for everybody, but in the end, it all comes down to this).

  • MoinMoin supports access control lists

  • MoinMoin is easy to extend

  • "MediaWiki is primarily targeted at Wikipedia and Wikimedia's other projects (and other similar large-scale sites with people running their own servers), secondarily at people running local instances to work with data from our sites, and only incidentally at anyone else." Brion Vibber, Media`Wiki developer

What are the pros and cons to use MediaWiki or MoinMoin?

See WikiEngineComparison.

Questions about using this Wiki

Finding and accessing information in the wiki

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":

  • Use the search box or FindPage, where you can search by keyword in title, by full text, with normal words or wildcards (regular expressions).

  • Click on TitleIndex. This will show you an alphabetized list of all pages by title.

  • Click on WordIndex. This shows an alphabetized list of every word in every title (i.e. a page named BlueTooth is listed under B / Blue as well as T / Tooth).

  • Use the LikePages action. This shows pages that have words in their titles that are similar to the current page.

  • Click on the page title at the very top of the page. This shows what pages link to the current page (which may help you find related pages).

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

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

How can I get RecentChanges to go farther back in time than it goes by default?

Log in and select up to 90 days back. Is this enough?

What are these weird differently coloured links I keep finding all over the place?

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

Editing in the wiki

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, 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.

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.

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:

  • Get the URL for the document,
  • Edit the Wiki page (go to the Wiki page and click the EditText link)

  • Type in the URL where you want it in the document
  • Save the changes.

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:

  [http://your.domain.example/foo.html This will be the link text]

produces:

This will be the link text

How can I avoid the use of [[BR]] and use normal newline characters instead?

Use { { { and } } } to bracket your preformatted text into a preformatted paragraph.

How do I add an image to a page?

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

http://c2.com/sig/inter/wikibase.gif

produces

wikibase

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 (see page_template_regex) 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.

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/sharename/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/sharename/full/path/to/file/filename%20with%20spaces.txt Click here to read filename with spaces.txt]

More and important info about this is on FileLinks.

Another obvious and maybe better option is to use the AttachFile action.

Should I ''sign'' my changes?

If they are significant, or you want people to know that you made them, then yes. Just put @SIG@ after your comment. It is not uncommon to indent your comment under the statement you 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.

What if I delete entries in pages, and you think you need them? Is it erased completely?

If you need to, you can revert your changes. See WhyWikiWorks.

Adding other document formats to the wiki

Can I add HTML to the wiki?

  • /!\ All of this only works if the unsecure HTML extensions (HTML macro and parser) are installed.

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: This is large 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).

Linking in the wiki

How do I link to something outside my wiki, as with an html a tag?

Installation & Configuration

How do I activate the "DeletePage" / "RenamePage" option?

For being allowed to delete or rename pages, you will have to log in (through UserPreferences).

How do I change the start page?

Set page_front_page = u'OtherFrontPage' in your wikiconfig.py. See HelpOnLanguages.

HelpOnConfiguration contains more variables you might want to set.

Administering the Wiki

How do I administer the wiki?

There is a lot of administration information on the SystemInfo 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.

How do I delete a user?

The best way (since version 1.5.2) is as a SuperUser to switch to the user that should be deleted from UserPreferences, select "Disable this account forever" and klick on "Save".

Can I restore a page from an older version?

  1. click on Info (or the little "i" icon) in the top-right corner.

  2. click on revert link of the version you want to restore.

For being allowed to revert pages, you will have to log in (through UserPreferences).

Developer help

Where to start as a coder?

If you want to help programming you can do that by:

  1. Learn Python if you do not already know it: BeginnersGuide

  2. Learn the basics of MoinMoin on the page MoinDev

Where to start as a designer or translator?

If you are not a coder but want to help anyway you can help at:

MoinMoin Diagnosis

If you think you have found an error or ancounted a problem you can do some tests. Real bugs often show you an error page. You should then save this page go to MoinMoinBugs, search if you find a page that looks similar and then make a new bug page with the traceback attached

You can test your wiki when attaching ?action=test to the standard URL. You then get a page called "MoinMoin Diagnosis" that gives a lot of of information. Most of it will only make sense for developers, but if you are one of those or a Python geek you might find this useful.


If your question is not answered on this page, see MoinMoinQuestions.

Recent