| How do I edit an existing wiki page? |
Visit the page you want to edit and click on the "Edit Page" link. This link can be found at the top and bottom of the page, and sometimes in the text of the page itself, e.g. Edit HowDoYouEditWikiPages. The "Edit Page" link takes you to a text editing form contaning the source text for the wiki page. Start typing.
The source text is just plain text, with a few special punctuation sequences for formatting. You don't need to know anything about the formatting conventions to get started beyond using blank lines for paragraph breaks. If you want to learn more, see HowDoYouFormatWikiText and the WikiTestPage.
When you are done editing the text, click the "Save" button at the top. If you make a mistake and want to start over, click "Reset." It's that easy.
Edit HowDoYouEditWikiPages
|
|
Why are all of the pages password protected?
What is the global page editing password?
|
For many years DeVaulDotNet was run as an open wiki. All pages were
world-writable. During this "golden age" there were a couple of
instances of spam, but these were isolated and did not result in page
destruction or data loss.
In late 2004 the DeVaulDotNet wiki came under attack by wiki spam
bots. These bots destroyed wiki pages, replacing them with
endless lists of links in an attempt to game the Google search engine
rankings. As a result, I implemented a site-wide editing password. A
few individual pages have their own editing password as well, but this
predates the spambot attacks.
I am considering making the global password visible (as part of an
image) on the "enter password" page, with the idea that humans will be
able to read it easily and spambots will not. Stay tuned...
Edit WhyArePagesPaswordProtected
|
|
How do I create a new wiki page?
How do I make a DotNetPeople personal wiki page?
|
Creating new wiki pages is easy. The first step is to decide on the title for the new page; you can choose any title you like, as long as it obeys the MixedCaseConvention. Once you choose the title (choose carefully, because the title is the one aspect of a page you can't edit) you create the page by:
- Edit the text of an existing page by clicking the "Edit" link.
For instance, you might add a new personal wiki page by editing DotNetPeople.
- Insert the title of the new page somewhere in the text of the existing page, and click "Save."
For a personal wiki page, the title could be your first and last names run together, like ScottStuart or OligarchyBob.
- View the page you just edited. You will see the title of your new page with a question mark link after it. The question mark link means the page does not yet exist in the wiki database. For example, the page ReallyDoNotClickOnThisLink does not yet exist (please don't make it exist so we can keep using it as an example).
- Click on the question mark link. That will take you to an "Edit Page" form for your new page. Start typing.
- When you have finished entering some text, click "Save" to create your page. Your page doesn't have to be done to click "Save" — this is a wiki so you can always go back and edit your page once you've created it.
Congratulations, you have just created a new wiki page.
Edit HowDoYouCreateNewPages
|
|
How do I format wiki page text?
Do I need to know HTML before I can edit a wiki page?
I'm looking at the source text of a wiki page; what do all of those strange punctuation sequences mean?
I'm used to the standard wiki formatting conventions, but there is some strange stuff going on here — help!
|
Wiki source text is not HTML; it is plain text formatted using a punctuation-based markup convention. Although lacking the full expressive power of HTML, wiki markup is simple and easy to use.
Wiki markup is based on punctuation sequences that never arise naturally in normal English text. You don't need to know anything about wiki markup to get started; just start typing. The most important formatting convention is that blank lines are paragraph breaks.
DeVaulDotNet employs an extended wiki markup language that is a superset of the original wiki markup language developed by Ward Cunningham. This extended markup language supports headings, centered text, line breaks, font changes, page "inclusions," etc., as well as the basic text formatting provided by the original. The DeVaulDotNet wiki formatting language also allows the use of certain HTML tags, though this is unnecessary for most formatting operations.
For more information on the specifics of wiki markup, see the WikiTextFormatting page.
Edit HowDoYouFormatWikiText
|
| Why do wiki page titles look so strange? |
Wiki page titles look strange because:
- They obey the MixedCaseConvention, and thus suffer from "studly caps" syndrome.
- Every page title is actually a link to that page, so your browser will render it as such. This is true even when the title is used in the body of the page itself.
Edit WhyDoWikiPageTitlesLookStrange
|
| What is the mixed-case convention I keep hearing about? |
The MixedCaseConvention allows the wiki software to distinguish page titles from other kinds of text. This is important, because in the wiki every page title is a link to the page itself.
Words composed of at least two non-consecutive capital letters followed by one or more non-capitalized letters follow the MixedCaseConvention. More precisely, the MixedCaseConvention is satisfied by any word which satisfys the Perl regular expression:
([A-Z][a-z]+){2,}
This is why "DeVaul" is a link word, and "ThisIsATest" is not; note the consecutive caps "AT" in "ThisIsATest." Likewise "To," "FireOn1," and "fooFoo" also fail; explaining why these words do not satisfy the MixedCaseConvention is left as an exercise for the reader. :)
Edit MixedCaseConvention
|
| When is it OK to modify a wiki page? When is it not OK? |
It is always OK to modify wiki pages; the wiki will die if nobody contributes. DeVaulDotNet is a consensus-anarchy; everyone is empowered to edit (or destroy) the wiki. In order to keep things interesting, the following guidelines are suggested:
- Build on what already exists
- Respect the ideas of other authors
For more information, see DotNetManifesto.
Edit WhenIsItOkToModifyPages
|
|
How do I change the foreground/background text colors?
It looks like an HTML TABLE tag is being used to change the background color of some text. Is there some other way to do this?
|
There are three ways of modifying text color presently supported by the production wiki engine:
- The "voices" markup, which is intended to visually distinguish speakers in a body of text, e.g. This is the default voice. This is voice one. This is voice two. This is voice three. This is voice four. See the WikiBetaPage for an explanation of how to use voices.
- The HTML "font" tag. The use of this tag allows you to set the foreground (but not background) color of the text. For example, specifying the color attribute to be "red" results in text that looks like this. You can find more information on HTML markup at http://www.w3.org/MarkUp/.
-
| The use of the HTML table tag. This tag is complicated and primarily intended to support the grid-like structuring of information in a page, but also allows you to specify the background color for the table. There is currently no way to change the background color for a portion of a page other than to use the table tag. |
-
- Warning: The incorrect use of the table tag can break a page, resulting in unspecified browser behavior (usually the page just comes up blank). If this happens, you may need to manually enter the edit URL for the page to fix it, e.g. http://devaul.net/?edit=HowDoYouChangeTextColor.
Edit HowDoYouChangeTextColor
|
|
Can I use arbitrary HTML markup in a wiki page?
I see working HTML table and font tags, but the HTML tags I tried don't seem to work. Why?
|
No, you cannot use arbitrary HTML markup in a wiki page. Some HTML markup is allowed, including the font, table, image and anchor tags. However, HTML tags should be used sparingly and only when the "native" wiki formatting tags are inadequate, for example when creating table-based layouts or page templates.
It is much easier to break a page through bad HTML than through bad wiki markup: bad wiki markup may give you an ugly page, but bad HTML may give you a page that doesn't render at all.
Edit CanYouUseArbitraryHtMl
|
|
Are there any restrictions on what I can post on the wiki?
Is it OK to post spam or commercial messages?
I see something I don't like; is it OK to delete something others have written because it is offensive/pornographic/in poor taste, etc.?
|
You are always free to edit, delete, or otherwise modify
wiki pages. Indeed, you are encouraged to contribute whatever you feel is appropriate without restriction on content or expression; for more information see DotNetManifesto.
My request (and it is just that, a request) is that you work to keep things interesting and constructive. Posting flame bait, out-of-context commercial messages (spam), or simply deleting opinions or material you find offensive is not likely to contribute much to the experience of other readers.
If you really feel something is inapropriate to a particular context, consider moving it rather than simply deleting it.
Edit DotNetModeration
|