MoinMoinFaq - Revision history

Maintenance script: Repair MoniWiki formatting after migration

2026-03-29T00:34:25Z

Repair MoniWiki formatting after migration

← Older revision		Revision as of 00:34, 29 March 2026
Line 9:		Line 9:
	browser.		browser.

	=== What is a ''MoinMoin''? ===		=== What is a ''[[MoinMoin]]''? ===

	A Moin''''''Moin is a wiki provided by the python wiki program Moin''''''Moin.		A Moin''''''Moin is a wiki provided by the python wiki program Moin''''''Moin.
Line 87:		Line 87:
	There are already more ways to search and/or scan the wiki than you		There are already more ways to search and/or scan the wiki than you
	can "shake a stick at":		can "shake a stick at":
	* Click on the magnifying glass icon. This brings you to the FindPage		* Click on the magnifying glass icon. This brings you to the [[FindPage]]
	page, where you can search by keyword in title, by full text, with		page, where you can search by keyword in title, by full text, with
	normal words or wildcards (regular expressions).		normal words or wildcards (regular expressions).
	* Click on TitleIndex. This will show you an alphabetized list		* Click on [[TitleIndex]]. This will show you an alphabetized list
	of all pages by title.		of all pages by title.
	* Click on WordIndex. This shows an alphabetized list of every		* Click on [[WordIndex]]. This shows an alphabetized list of every
	word in every title (ie, the Bluetooth page is under, B, Bluetooth).		word in every title (ie, the Bluetooth page is under, B, Bluetooth).
	* Click on		* Click on
Line 104:		Line 104:
	==== How do I see what's been going on recently in the wiki? ====		==== How do I see what's been going on recently in the wiki? ====

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

	==== What are these WeirdRedLinks I keep finding all over the place? ====		==== What are these WeirdRedLinks I keep finding all over the place? ====
Line 120:		Line 120:
	The wiki formatter will generally "do the right thing" with any text		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		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.		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? ====		==== Are there any conventions I should follow when adding information? ====
Line 133:		Line 133:
	these when creating a new page, then that page will have a structure		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		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		homepage, you should use the [[HomepageTemplate]] page, which is available when
	you create a new page in the wiki.		you create a new page in the wiki.

Line 200:		Line 200:
	== Installation & Configuration ==		== Installation & Configuration ==

	(!) See HelpOnAdministration for general help on this topic		(!) See [[HelpOnAdministration]] for general help on this topic

	=== Why is the "diff" feature not working? ===		=== Why is the "diff" feature not working? ===
Line 221:		Line 221:
	=== How do I administer the wiki? ===		=== How do I administer the wiki? ===

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

Maintenance script: Quality repair v1

2026-03-27T04:58:17Z

Quality repair v1

← Older revision		Revision as of 04:58, 27 March 2026
Line 116:		Line 116:
	If you see something you'd like to comment on, add to, or change,		If you see something you'd like to comment on, add to, or change,
	just click on the Edit''''''Text link at the bottom of the page, or click on		just click on the Edit''''''Text link at the bottom of the page, or click on
	the ~~[[Icon(~~moin-edit.gif~~)]]~~ icon at the top of the page. The page is brought		the ''[moin-edit.gif]'' 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.		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		The wiki formatter will generally "do the right thing" with any text

Maintenance script: Repair batch-0002 pages from live compare

2026-03-27T00:16:08Z

Repair batch-0002 pages from live compare

← Older revision		Revision as of 00:16, 27 March 2026
Line 95:		Line 95:
	word in every title (ie, the Bluetooth page is under, B, Bluetooth).		word in every title (ie, the Bluetooth page is under, B, Bluetooth).
	* Click on		* Click on
	~~~cpp~~ LikePages		<code>LikePages</code>
	at the bottom of the page. This shows pages		at the bottom of the page. This shows pages
	that have words in their titles that are similar to the current page.		that have words in their titles that are similar to the current page.
Line 150:		Line 150:
	link in brackets. The cover wording will appear on the page, but 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:		link will take the user to the URL when clicked on. Here's an example:
	[http://your.link.here/foo.html This will be the link text]		[http://your.link.here/foo.html This will be the link text]
	produces:		produces:

Line 183:		Line 183:
	HTML macro, like so:		HTML macro, like so:

	~~~cpp~~ [[HTML(&~~amp;~~lt;font size=+12&~~amp;~~gt;This is large font&~~amp;~~lt;/font&~~amp;~~gt;)]]		<code>[[HTML(<font size=+12>This is large font</font>)]]</code>

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

	It's also possible to place an html document into a page by adding		It's also possible to place an html document into a page by adding
	~~~cpp~~ #format html		<code>#format html</code>
	as the first line in the page. If that line is there then the whole		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		page will be interpreted as HTML (thus making links to other pages
Line 206:		Line 206:
	Diffs need two things to work properly:		Diffs need two things to work properly:
	* The directory "''datadir''		* The directory "''datadir''
	~~~cpp~~ /backup		<code>/backup</code>
	" must exist.		" must exist.
	* You need a GNU diff executable in your webserver's PATH. Note that the PATH of your webserver might be much shorter than the PATH you are used to from your shell.		* You need a GNU diff executable in your webserver's PATH. Note that the PATH of your webserver might be much shorter than the PATH you are used to from your shell.
Line 213:		Line 213:

	"Delete''''''Page" 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		"Delete''''''Page" 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
	~~~cpp~~ moin_config.py		<code>moin_config.py</code>
	: {{{~cpp		: {{{~cpp
	allowed_actions=[['DeletePage']]		allowed_actions='DeletePage'
	}}}		}}}

Line 239:		Line 239:
	For people reading this FAQ page (which is probably not your average attacker), there is this way to restore a page:		For people reading this FAQ page (which is probably not your average attacker), there is this way to restore a page:
	# click on the little "i" in the top-right corner (		# click on the little "i" in the top-right corner (
	~~~cpp~~ PageInfo		<code>PageInfo</code>
	).		).
	# click on "view" of the version you want to restore.		# click on "view" of the version you want to restore.
	# in the "Location" bar of your browser, replace "action=recall" with "action=raw".		# in the "Location" bar of your browser, replace "action=recall" with "action=raw".
	# Cut&paste the text into the edit box of that page, after clicking "		# Cut&paste the text into the edit box of that page, after clicking "
	~~~cpp~~ EditPage		<code>EditPage</code>
	".		".

Maintenance script: Repair MoniWiki formatting after migration

2026-03-26T14:06:17Z

Repair MoniWiki formatting after migration

← Older revision		Revision as of 14:06, 26 March 2026
Line 183:		Line 183:
	HTML macro, like so:		HTML macro, like so:

	~cpp [[HTML(<font size=+12>This is large font</font>)]]		~cpp [[HTML(&lt;font size=+12&gt;This is large font&lt;/font&gt;)]]

	This would show up on the page as:		This would show up on the page as:

Maintenance script: Repair MoniWiki formatting after migration

2026-03-26T14:01:40Z

Repair MoniWiki formatting after migration

← Older revision		Revision as of 14:01, 26 March 2026
Line 194:		Line 194:
	becomes a bit more difficult!) Make sure that you only add the body		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		portion of the page (not the HTML headers or anything else outside
	of the body, including the ~~<~~BODY~~>~~ tag itself).		of the body, including the <BODY> tag itself).

	/!\ All of this only works if the HTML extensions (HTML macro and parser) are installed.		/!\ All of this only works if the HTML extensions (HTML macro and parser) are installed.
Line 258:		Line 258:
	pages like any other.		pages like any other.

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

imported>Unknown at 05:23, 7 February 2021

2021-02-07T05:23:47Z

New page

'''Index'''
__TOC__

== "What is a Wiki?" questions ==
=== What is a ''Wiki''? ===

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

=== What is a ''MoinMoin''? ===

A Moin''''''Moin is a wiki provided by the python wiki program Moin''''''Moin.

=== What is this good for? ===

To be honest, it is good for whatever you use it for. At
[http://www.lineo.com/ 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 [http://www.zope.org/ Zope]
to manage their ideas and projects.

=== 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

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

=== 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 could be dealt with (if needed) with a 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.

== 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":
* Click on the magnifying glass icon. This brings you to the FindPage
page, 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 (ie, the Bluetooth page is under, B, Bluetooth).
* Click on
~cpp LikePages
at the bottom of the page. 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.

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

=== Adding information to 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 Edit''''''Text link at the bottom of the page, or click on
the [[Icon(moin-edit.gif)]] 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.link.here/foo.html This will be the link text]
produces:

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

==== How do I add an image to a page? ====

You can include a url to the image in the page. Example:
http://www.lineo.com/images/products/uclinux/logo_small.gif
produces

http://www.lineo.com/images/products/uclinux/logo_small.gif

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

=== Adding other document formats to the wiki ===
==== 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:

~cpp [[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
~cpp #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).

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

== Installation & Configuration ==

(!) See HelpOnAdministration for general help on this topic

=== Why is the "diff" feature not working? ===

Diffs need two things to work properly:
* The directory "''datadir''
~cpp /backup
" must exist.
* You need a GNU diff executable in your webserver's PATH. Note that the PATH of your webserver might be much shorter than the PATH you are used to from your shell.

=== How do I activate the "DeletePage" option? ===

"Delete''''''Page" 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
~cpp moin_config.py
: {{{~cpp
allowed_actions=[['DeletePage']]
}}}

== Administering the Wiki ==
=== 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 "Admin''''''Page", 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.

=== 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:
# click on the little "i" in the top-right corner (
~cpp PageInfo
).
# click on "view" of the version you want to restore.
# in the "Location" bar of your browser, replace "action=recall" with "action=raw".
# Cut&paste the text into the edit box of that page, after clicking "
~cpp EditPage
".

=== 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