Edit detail for HelpPage revision 3 of 3

1 2 3
Editor: betabug
Time: 2008/07/09 14:52:29 GMT+2
Note: Replacing with default help text (because of spam)

changed:
-... spam deleted... old content is lost though...
This is the quick help page for Zwiki version 0.60.0
<dtml-var "'(This site is currently running '"><dtml-var zwiki_version><dtml-var "').'"> 
See also the more complete docs at http://zwiki.org , such as the 
"UsersGuide":http://zwiki.org/UsersGuide .

What is this ?

  This site is a wiki, a kind of collaborative website, running the Zwiki
  wiki software.  *wiki wiki* means *quick*.

  Wikis try to make it as simple as possible to write and share useful
  content, using intuitive page naming and text formatting conventions.
  Wikis are usually (but not always) wide open and assume a cooperating
  community.  Anyone can edit, add comments, and make new pages on the
  spot.  It is often possible to upload files and pictures and get email
  notifications as well.

Getting around a zwiki

  Zwiki's user interface comes in two main flavours:
  "standard":http://zwiki.org and "plone":http://plone.demo.zwiki.org , or
  it may be customized by site administrators.  Some standard links are
  almost always available, such as "home" for the front page, "contents"
  for an overview of the wiki, and "changes" for a list of
  recently-changed pages. 

  Each page in a wiki has a unique name, most often a !WikiName - two or
  more capitalized words joined together.  Free-form names - any word or
  phrase enclosed in brackets - may also be used here (unless disabled).
  Wiki page names which appear in text automatically link to that page.
  Click "backlinks" or the page title or use the "b" access key to see
  which pages link to this one.  You'll also see ordinary links made with
  bare urls, HTML, text formatting markup, or ZWiki:RemoteWikiLinks .

  Some more tips:

  - use the convenient 
    "access keys":http://zwiki.org/QuickReference#access-keys for navigation
    and other functions

  - set your time zone, editform height and other things by clicking "options"

  - leave your mouse pointer over most user interface elements to see
    informative tooltips

Page hierarchy

  Zwiki keeps pages in a hierarchy, like an outliner, which helps to
  organize large amounts of content.  Unless disabled by the site
  administrator, you can:

  - see the overall wiki outline, by clicking "contents" or using the "c"
    access key

  - see a page's subtopics, if any, linked just below the main text

  - go to the next page, the previous page, or up, using the "n", "p", and
    "u" access keys

  - *reparent* the current page to move it (with subtopics) to a new place
    in the hierarchy, using the backlinks screen or the page management
    form at the bottom of the page

Subscribing

  If you see a "subscribe" link, you can subscribe to receive comments (or
  all edits) by email.  You can subscribe to individual pages, or to the
  whole wiki.

  1. Click "subscribe"

  2. if needed, enter your email address and click "Change"

  3. click the button to toggle your page or wiki subscription status

  If the site administrator has configured it, subscribers may also send
  comments by mail.  Just reply to a mail from the wiki, or send mail to
  the wiki's mail-in address.  Your mail will go to the page named in
  brackets in the subject (or to a default page).

Editing

  You will be able to create, edit, rename, reparent, delete any page,
  upload files and images, and more - except where restricted by the site
  administrator. Many zwikis require that you set a username in "options"
  before you can make changes. Tips:

  - Add a comment using the form at the bottom of the page. Note this may
    be received by many subscribers - to avoid this, use the SandBox page
    for tests.

  - Click "edit" to change the page's text.  You may also be able to
    rename the page, select the text formatting rules, or upload a file
    here. It's useful to enter a short "change note" as well.
  
  - When you write a wiki page name in wiki text, it automatically forms a
    link to that page (remember, free-form names must be enclosed in
    square brackets).  

  - If the named page does not yet exist, a ? link will appear; click that
    when you are ready to create it.
  
Formatting rules

   When you save a page, Zwiki formats and links your text according to
   some standard markup rules.  Different rules are applied depending on
   the *page type*; they are described at ZWiki:TextFormattingRules.  Here
   is a quick primer for ZWiki:StructuredText (but zwikis increasingly use
   ZWiki:RestructuredText which has some differences..).

   1. non-blank lines are run together to form a paragraph; 
      paragraphs are separated by blank lines<br />

   2. a one-line "paragraph" followed by a more-indented paragraph makes a
      heading. Tip: you need only indent the first line.<br />

   3. a paragraph beginning with - or a number followed by a space makes a bullet
      or numbered list item; a more-indented list item starts a sub-list<br />

   4. short text enclosed in 
      &#42;...&#42; , 
      &#42;&#42;...&#42;&#42; , 
      &#95;...&#95; or 
      &#39;...&#39; is *italic*, **bold**, _underlined_ or 'monospaced' respectively<br />

   5. !WikiNames, ![Free-form name]s enclosed in brackets, ZWiki:RemoteWikiLinks , 
      !http://bare/urls , and !"Structured Text links":http://zwiki.org/StructuredText are
      made into hyperlinks

   6. HTML tags may be added if necessary; on sites which permit it,
      DTML (server-side code) may also be used <br />

   7. short text enclosed in single quotes is quoted, ie displayed in
      monospace font and protected from some of the above formatting.  For
      reliable quoting of a body of text, indent it after a paragraph
      ending with a double colon ::

       Like this (edit this page to see source).
       This is the surest way to prevent WikiLinks, <HTML tags> and &dtml-tags;
        and preserve
         fixed-width formatting.

   8. don't worry about learning all the rules and their interactions -
      just mimic the text around you; when it does something unexpected,
      try some tweaks; go to the docs or ask for help when you get really
      stuck or curious about why it's doing something.

Find out more

  About Zwiki: http://zwiki.org

  About wiki in general: 
  http://en.wikipedia.org/wiki/Wiki , 
  http://www.c2.com/cgi/wiki?FrontPage ,
  http://www.c2.com/cgi/wiki?EvolutionOfaWikizen 



This is the quick help page for Zwiki version 0.60.0 (This site is currently running 2.0b1). See also the more complete docs at http://zwiki.org , such as the UsersGuide? .

What is this ?

This site is a wiki, a kind of collaborative website, running the Zwiki wiki software. wiki wiki means quick.

Wikis try to make it as simple as possible to write and share useful content, using intuitive page naming and text formatting conventions. Wikis are usually (but not always) wide open and assume a cooperating community. Anyone can edit, add comments, and make new pages on the spot. It is often possible to upload files and pictures and get email notifications as well.

Getting around a zwiki

Zwiki's user interface comes in two main flavours: standard and plone , or it may be customized by site administrators. Some standard links are almost always available, such as "home" for the front page, "contents" for an overview of the wiki, and "changes" for a list of recently-changed pages.

Each page in a wiki has a unique name, most often a WikiName - two or more capitalized words joined together. Free-form names - any word or phrase enclosed in brackets - may also be used here (unless disabled). Wiki page names which appear in text automatically link to that page. Click "backlinks" or the page title or use the "b" access key to see which pages link to this one. You'll also see ordinary links made with bare urls, HTML, text formatting markup, or ZWiki:RemoteWikiLinks .

Some more tips:

  • use the convenient access keys for navigation and other functions
  • set your time zone, editform height and other things by clicking "options"
  • leave your mouse pointer over most user interface elements to see informative tooltips

Page hierarchy

Zwiki keeps pages in a hierarchy, like an outliner, which helps to organize large amounts of content. Unless disabled by the site administrator, you can:

  • see the overall wiki outline, by clicking "contents" or using the "c" access key
  • see a page's subtopics, if any, linked just below the main text
  • go to the next page, the previous page, or up, using the "n", "p", and "u" access keys
  • reparent the current page to move it (with subtopics) to a new place in the hierarchy, using the backlinks screen or the page management form at the bottom of the page

Subscribing

If you see a "subscribe" link, you can subscribe to receive comments (or all edits) by email. You can subscribe to individual pages, or to the whole wiki.

  1. Click "subscribe"
  2. if needed, enter your email address and click "Change"
  3. click the button to toggle your page or wiki subscription status

If the site administrator has configured it, subscribers may also send comments by mail. Just reply to a mail from the wiki, or send mail to the wiki's mail-in address. Your mail will go to the page named in brackets in the subject (or to a default page).

Editing

You will be able to create, edit, rename, reparent, delete any page, upload files and images, and more - except where restricted by the site administrator. Many zwikis require that you set a username in "options" before you can make changes. Tips:

  • Add a comment using the form at the bottom of the page. Note this may be received by many subscribers - to avoid this, use the SandBox? page for tests.
  • Click "edit" to change the page's text. You may also be able to rename the page, select the text formatting rules, or upload a file here. It's useful to enter a short "change note" as well.
  • When you write a wiki page name in wiki text, it automatically forms a link to that page (remember, free-form names must be enclosed in square brackets).
  • If the named page does not yet exist, a ? link will appear; click that when you are ready to create it.

Formatting rules

When you save a page, Zwiki formats and links your text according to some standard markup rules. Different rules are applied depending on the page type; they are described at ZWiki:TextFormattingRules. Here is a quick primer for ZWiki:StructuredText (but zwikis increasingly use ZWiki:RestructuredText which has some differences..).

  1. non-blank lines are run together to form a paragraph; paragraphs are separated by blank lines
  2. a one-line "paragraph" followed by a more-indented paragraph makes a heading. Tip: you need only indent the first line.
  3. a paragraph beginning with - or a number followed by a space makes a bullet or numbered list item; a more-indented list item starts a sub-list
  4. short text enclosed in *...* , **...** , _..._ or '...' is italic, bold, underlined or monospaced respectively
  5. WikiNames, [Free-form name]s enclosed in brackets, ZWiki:RemoteWikiLinks , http://bare/urls , and !Structured Text links are made into hyperlinks
  6. HTML tags may be added if necessary; on sites which permit it, DTML (server-side code) may also be used
  7. short text enclosed in single quotes is quoted, ie displayed in monospace font and protected from some of the above formatting. For reliable quoting of a body of text, indent it after a paragraph ending with a double colon :
           Like this (edit this page to see source).
           This is the surest way to prevent WikiLinks, <HTML tags> and &dtml-tags;
            and preserve
             fixed-width formatting.
    
  8. don't worry about learning all the rules and their interactions - just mimic the text around you; when it does something unexpected, try some tweaks; go to the docs or ask for help when you get really stuck or curious about why it's doing something.

Find out more

About Zwiki: http://zwiki.org

About wiki in general: http://en.wikipedia.org/wiki/Wiki , http://www.c2.com/cgi/wiki?FrontPage , http://www.c2.com/cgi/wiki?EvolutionOfaWikizen