Essential Wiki - Webs & Topics Next 


http://wiki.cfcl.com/bin/view/Help/WikiTraining

FirstPreviousNextLastExit  Slide 1 of 97 COPYRIGHT © 2019 by the contributing authors
  What's Covered Next 


  • What's a Wiki?
  • What's TWiki / Foswiki?
  • Webs and Topics
  • Working With Topics
    • Creating
    • Viewing
    • More Topic Actions
  • Editing
  • Attachments
  • Appendix 1: Personal Customizations
  • Appendix 2: Managing Content

FirstPreviousNextLastExit  Slide 2 of 97 COPYRIGHT © 2019 by the contributing authors
  What You Can Expect Next 


Become an "Informed Consumer"

These training presentations won't turn you into you a Wiki expert in a few hours. However, you can expect to gain new perspective, hear about a few tips and tricks, add some insights, and see many examples.

We also hope you'll learn at least one new thing you didn't know before!

FirstPreviousNextLastExit  Slide 3 of 97 COPYRIGHT © 2019 by the contributing authors
  Who Are You? Next 


  • What's your experience with wikis?

  • Experiences with TWiki or Foswiki?

  • Are there any specific things you'd like to see covered in this session?

FirstPreviousNextLastExit  Slide 4 of 97 COPYRIGHT © 2019 by the contributing authors
  What's a Wiki? Next 


A wiki is
  • a Web-based collaboration platform
    • that lets you and all other users write, place pictures, and post links
      • anywhere on any page.
In most cases, this means that anyone can edit anything.

A wiki is
  • Just a program
  • A kind of editor for web pages
  • Accessed using your favorite browser
    • (Firefox recommended)

TWiki and Foswiki are both wikis.

FirstPreviousNextLastExit  Slide 5 of 97 COPYRIGHT © 2019 by the contributing authors
  What Isn't a Wiki? Next 


You don't need to...
  • Install additional software
  • Learn HTML
  • Wait for a designated webmaster to upload your files
  • Make a request to IT
  • Ask permission

See: WikiWhy.

FirstPreviousNextLastExit  Slide 6 of 97 COPYRIGHT © 2019 by the contributing authors
  Wiki History Next 


  • The word "wiki" was coined in 1994
    • For the first wiki program: WikiWikiWeb
    • Created by Ward Cunningham

  • Based on a Hawaiian word for "fast".

"I chose wiki-wiki as an alliterative substitute for 'quick' and thereby avoided naming this stuff quick-web." -- Ward Cunningham

Cunningham was inspired in part by Apple's HyperCard. He also developed ideas from Vannevar Bush, allowing users to "comment on and change one another's text".

In the early 2000s, wikis were increasingly adopted by organizations as collaborative software. Common uses included project communication, intranet web access, and documentation, initially for technical users. Today some companies use wikis as their primary collaborative software and as a replacement for static web pages. There may be greater use of wikis behind firewalls than on the Internet.

On March 15, 2007, the word "wiki" entered the online version of the Oxford English Dictionary.

ref: Wiki.

FirstPreviousNextLastExit  Slide 7 of 97 COPYRIGHT © 2019 by the contributing authors
  Many Wikis Available Next 


Hundreds of wikis are currently available, each with different features. Some are simple; some are powerful. All allow "regular" people to create web pages that can be viewed on the Internet or a company intranet. TWiki and Foswiki are just two available wikis.

Examples:
  • pbWiki
  • TiddlyWiki
  • Confluence
  • Wetpaint
  • Socialtext
  • MediaWiki (used by Wikipedia)
  • MoinMoin
  • Wikispaces
  • ...
  • TWiki
  • Foswiki

See: WikiMatrix.

FirstPreviousNextLastExit  Slide 8 of 97 COPYRIGHT © 2019 by the contributing authors
  TWiki Facts Next 


  • Created by Peter Thoeny in 1998.

  • Open Source; developers around the world

  • Installed on many corporate intranets, often behind firewalls

(See: twiki.org and TWiki:Main.TWikiInstallation)

FirstPreviousNextLastExit  Slide 9 of 97 COPYRIGHT © 2019 by the contributing authors
  Foswiki Facts Next 


  • Forked out of TWiki in Oct 2008

  • Open Source; developers around the world

  • foswiki.org

FirstPreviousNextLastExit  Slide 10 of 97 COPYRIGHT © 2019 by the contributing authors
  Terminology in this Presentation Next 


From here on, we will refer to TWiki and Foswiki together as "Wiki".

FirstPreviousNextLastExit  Slide 11 of 97 COPYRIGHT © 2019 by the contributing authors
  Wiki Enterprise Features Next 


  • Many built-in "Enterprise" features

  • Additional functionality available by installing "plugins"

  • Structured ("database application") capabilities

FirstPreviousNextLastExit  Slide 12 of 97 COPYRIGHT © 2019 by the contributing authors
  Ease of Use Next 


"Wiki shorthand"
  • Simple
  • Makes content easy and fast to create/modify
  • No HTML to learn

Case sensitive

  • WebHome vs WebHOme vs Webhome vs webhome
  • TWiki is spelled TWiki

Need more power?

  • HTML works
  • CSS works
  • JavaScript works

FirstPreviousNextLastExit  Slide 13 of 97 COPYRIGHT © 2019 by the contributing authors
  Enterprise Features Next 


Access control

  • Allow topic view
  • Allow topic change
  • Users
  • Groups

More than just content

  • Variables (functions) add shortcuts
    today's date, topic name, colored text

  • Plugins (extensions) extend functionality
    calendars, arithmetic, slide shows

  • Embedded Applications
    blog, team directory, project tracker

FirstPreviousNextLastExit  Slide 14 of 97 COPYRIGHT © 2019 by the contributing authors
  Revision History Next 


  • Anyone can publish

  • Anyone can edit

  • Anyone can change my page?!

The ability for anyone to write on any page can be liberating. It can also be scary or intimidating.

For those who lean toward "scary", you'll be pleased to know that many wikis (including ours) are backed by version control (e.g. RCS). So, even if you think you broke something, you (or someone else) can usually fix it. If you want to know what changes were made (and by whom), there's revision history.

FirstPreviousNextLastExit  Slide 15 of 97 COPYRIGHT © 2019 by the contributing authors
  Structured Wiki Next 


TWiki/Foswiki are structured wikis. Although there are hundreds of examples of wikis, there are only a few structured wikis.

  • "Database-like" manipulation of data stored in forms on pages.
  • Users can create small applications
    status boards, task lists, department directories, project tracking systems, blog applications, ...
  • No special programming language is required.

"Enterprise" features
  • Access control
  • Revision control
  • Webs (separate collaboration categories)
  • E-mail notification (subscribe to topic changes)

(See: TWiki:Codev.StructuredWiki and Wikipedia:Structured_wiki)

FirstPreviousNextLastExit  Slide 16 of 97 COPYRIGHT © 2019 by the contributing authors
  Webs and Topics Next 


TWiki and Foswiki are aninstallable, distributed, wiki program.

Webs
  • A Wiki site (installation) is divided into webs.
    • Each web usually represents one area of collaboration (e.g. one department or large project).

Topics
  • Each web has hyperlinked topics, displayed as pages in your browser.
    • Webs are analogous to folders on your computer.
    • Topics are analogous to documents.

FirstPreviousNextLastExit  Slide 17 of 97 COPYRIGHT © 2019 by the contributing authors
  Webs and Topics Next 


  • Each web has a "home" topic (named WebHome) and various administrative topics (e.g. WebChanges, WebTopicList).

  • All other topics are created (and modified) by you and your co-workers.

   http://cfcl.com/bin/view/Learn/Tut/WikiTraining
  • Learn is a web.
  • Tut is a subweb (acts just like a web).
  • WikiTraining is a topic.

FirstPreviousNextLastExit  Slide 18 of 97 COPYRIGHT © 2019 by the contributing authors
  Administrative Webs Next 


A Wiki distribution includes several administrative webs. You should not store permanent project content in these webs.

  • Main - user home and configuration pages

  • TWiki or System - system documentation and configuration

  • Sandbox - temporary topics, for testing and experimentation

FirstPreviousNextLastExit  Slide 19 of 97 COPYRIGHT © 2019 by the contributing authors
  Project Webs Next 


Many groups and projects have their own web. Some have more than one!

Your group controls your web - who has access to view or edit topics, how to name those topics, what they contain. You can also control the template used for every new topic and the sidebar of your web. You can customize many aspects of your web without affecting any other webs in the site.

FirstPreviousNextLastExit  Slide 20 of 97 COPYRIGHT © 2019 by the contributing authors
  Topics Next 


You (and your group) control your topics - who has access to view or edit them and what they contain. Your group may have naming conventions or other standards for topics. Be sure that you understand what these are.

Note: People often create links from their Wiki home pages. If you're not careful, this will create pages in the Main (administrative and homes) web. Pages created in Main are more difficult for your co-workers to find and work with.

Best practice is to create project topics in the most appropriate web.

We'll get to creating and editing topics further along in this session.

FirstPreviousNextLastExit  Slide 21 of 97 COPYRIGHT © 2019 by the contributing authors
  Using the Wiki Next 


  • Navigation

  • Managing Topics (View, Attach, History, More...)

  • Creating Topics

  • Editing Topics

  • Attachments

FirstPreviousNextLastExit  Slide 22 of 97 COPYRIGHT © 2019 by the contributing authors
  Navigation Next 


  • Breadcrumbs

  • Left Side Bar

  • Personal Side Bar

FirstPreviousNextLastExit  Slide 23 of 97 COPYRIGHT © 2019 by the contributing authors
  Breadcrumbs Next 


The breadcrumb string shows a topic's relationship to other topics (pages).

breadcrumbs.jpg

  • The first item in the breadcrumb list is the Wiki site name (CFCL Wiki).
  • The second item in the breadcrumb list is the web (Help).
  • The last item in the list is the name of the current topic (WikiEssentials).
  • The item just before the current topic is the topic's "__parent__".

Important: With the exception of the web, this is not a "real" hierarchy. The breadcrumb list merely provides context and eases navigation.

Note: A topic can have only one parent. Some pages have no parents; these "orphan" pages have a breadcrumb list that goes directly from web to topic.

FirstPreviousNextLastExit  Slide 24 of 97 COPYRIGHT © 2019 by the contributing authors
  Left Side Bar Next 


The left side bar can be customized for your web. Conventionally, this area includes a search field (search topic name or body content), useful links, related webs, and a section you can customize as a personal side bar.

FirstPreviousNextLastExit  Slide 25 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A -- Can I Make The Side Bar "Go Away"? Next 


Q: I think the sidebar takes up too much space. Can I make it go away?

A: Yes. This isn't recommended for normal work, simply because the side bar can coontain a lot of Very Useful Links. But if you want to, you can make it disappear.

FirstPreviousNextLastExit  Slide 26 of 97 COPYRIGHT © 2019 by the contributing authors
  Personal Side Bar Next 


create personal sidebar.jpg Click the "create" link in the left sidebar to customize Wiki with your own personal navigation links. You'll be provided with a default personal LeftBar page which you can edit to taste.

FirstPreviousNextLastExit  Slide 27 of 97 COPYRIGHT © 2019 by the contributing authors
  Managing Topics Next 


  • View

  • Attach

  • History

FirstPreviousNextLastExit  Slide 28 of 97 COPYRIGHT © 2019 by the contributing authors
  Viewing: What's On A Wiki Page? Next 


The content of each Wiki topic page is surrounded by standardized "chrome", including a left sidebar, breadcrumbs, and navigational links.

The links at the topic and bottom of the page (e.g. Attach, Edit) all have keyboard shortcuts (Alt-first-letter in Windows; Ctl-first-letter in Mac OS X).

SamplePageView.jpg

FirstPreviousNextLastExit  Slide 29 of 97 COPYRIGHT © 2019 by the contributing authors
  Breadcrumbs Next 


The breadcrumb string shows a topic's "parent" relationship to other topics (pages).

screenshot

FirstPreviousNextLastExit  Slide 30 of 97 COPYRIGHT © 2019 by the contributing authors
  Current Version Information Next 


Near the breadcrumb list, you can see the current version information for this topic: the most recent modification date, revision number, and WikiName of the person who last made a change.

revinfo.jpg

If you click on the WikiName, it will open that person's Wiki home page.

Note: Remember that this is a wiki; anyone can edit any page. Just because you see someone's name at the top does not mean that they are the original author (unless this is revision r1). If you're contacting someone about the content of a topic, keep this in mind.,

FirstPreviousNextLastExit  Slide 31 of 97 COPYRIGHT © 2019 by the contributing authors
  Raw View (or, How Did They Do That?) Next 


If you just want to take a peek at the underlying code for a Wiki page, use the Raw view link at the bottom of the page. This gives you "read-only" access to the page source.

FirstPreviousNextLastExit  Slide 32 of 97 COPYRIGHT © 2019 by the contributing authors
  History Next 


If you want more information on the history of a topic - who changed it, when, and what changes they made - click History at the bottom of the page. You can also compare versions of a topic. Click More topic options.

FirstPreviousNextLastExit  Slide 33 of 97 COPYRIGHT © 2019 by the contributing authors
  More Topic Actions Next 


Click More topic options (in the lower right of any Wiki topic). On the next page, you can change many things about the topic, including:

  • rename it
  • move it to another web
  • make a copy in this web
  • delete it (Trash)
  • change the "parent" topic (breadcrumbs)
  • view "child" topics
  • view past revisions
  • compare revisions
  • find backlinks

FirstPreviousNextLastExit  Slide 34 of 97 COPYRIGHT © 2019 by the contributing authors
  Parent Topic Next 


Parent relationships form the basis for the breadcrumb list.

  • The breadcrumbs show "parent" relationships for the current topic.
  • The parent (grandparent, etc) links make it easier to navigate the web.
  • By default, the parent is the page from which you first linked to this one.
  • A page created without linking first is "orphaned".

FirstPreviousNextLastExit  Slide 35 of 97 COPYRIGHT © 2019 by the contributing authors
  Parent Topic Next 


To (re)set the parent topic,
  • Click More topic actions
  • Scroll down to Set New Topic Parent
    • If your web contains many pages, you'll see a fill-in box.
    • Otherwise, you'll see a menu of topics.

Setting the topic parent

See: WikiTutParentTopic

FirstPreviousNextLastExit  Slide 36 of 97 COPYRIGHT © 2019 by the contributing authors
  Attachments Next 


Current attachments may be shown in a table at the bottom of the page.

Attachments at bottom of page

If you don't see this table, either:
  1. There are no attachments.
  2. or The "twisty" is closed (click toggleopen Show Attachments).
  3. or All attachments are "hidden" (Click Attach).

Click Attach to
  • upload a new attachment to a page
  • manage attachments that are already present

Hint: Think of "Attach" as short for "Attachments" (noun, not verb).

FirstPreviousNextLastExit  Slide 37 of 97 COPYRIGHT © 2019 by the contributing authors
  Attach a File Next 


To attach a new file

  • Click Attach to reach the Attachments page.

  • On the next page, you'll see a form and a table of all current attachments.

AttachTo.jpg

FirstPreviousNextLastExit  Slide 38 of 97 COPYRIGHT © 2019 by the contributing authors
  Attach a File Next 


  • Browse for the file.

  • Add an (optional) comment.

  • Set the properties of the atttachment (optional).

screenshot - checkboxes

  • If you're attaching an image you want to display:
    • Check Create a link to the attached file.
    • An <img link (HTML) will be appended to the body of your topic content. e.g.
   <img src="%ATTACHURLPATH%/attach1.jpg" alt="Attach " width='172' height='65' />
Move this link to the desired location and edit to taste.

  • If you prefer not to show the attachment when viewing the topic
    • Check Do not show attachment in table.

  • Click Upload file.

FirstPreviousNextLastExit  Slide 39 of 97 COPYRIGHT © 2019 by the contributing authors
  Managing Attachments Next 


All attachments are listed on the Attachments page (even if they are hidden on the topic "view" page). If the attachment you want to manage is hidden, click the Attach button to reach the Attachments page.

screenshot -

To make changes to an attachment, click the manage link in the "Action" column of the table.

FirstPreviousNextLastExit  Slide 40 of 97 COPYRIGHT © 2019 by the contributing authors
  Managing Attachments Next 


After a file is attached to a topic, you can:
  • update it (upload a new version)
  • change its properties
  • change the comment
  • delete it
  • change whether it's shown in the table
  • retrieve past versions
  • view its revision history

FirstPreviousNextLastExit  Slide 41 of 97 COPYRIGHT © 2019 by the contributing authors
  Managing Attachments - Update... Next 


attachment update.jpg

FirstPreviousNextLastExit  Slide 42 of 97 COPYRIGHT © 2019 by the contributing authors
  Creating Topics Next 


To create a new topic, just give it a name.

FirstPreviousNextLastExit  Slide 43 of 97 COPYRIGHT © 2019 by the contributing authors
  Creating Topics - Make a link Next 


Method 1: Make a link in any existing topic ‡

  • Edit any topic (preferably a related topic!)
  • Add a link to the new topic's name
  • Save

Wiki highlights the name to show that it is a potential link. (We'll discuss links in a few slides.) MyWidgets

  • Click the ?

  • Wiki will open an Edit window for the new topic

Note: The "parent" will be set to the topic that you linked from.

‡ We'll discuss links in more detail in a few slides

FirstPreviousNextLastExit  Slide 44 of 97 COPYRIGHT © 2019 by the contributing authors
  Creating Topics - Demo Next 


FirstPreviousNextLastExit  Slide 45 of 97 COPYRIGHT © 2019 by the contributing authors
  Creating Topics - Type a URL Next 


Method 2:

  • Type the URL to the (nonexistent) topic into the Address field of your browser.
  • When you press Return, Wiki will tell you that the topic doesn't exist.
  • Click "Create".

Note: Topics created in this way will be "orphans". You should set a parent topic using More topic options.

FirstPreviousNextLastExit  Slide 46 of 97 COPYRIGHT © 2019 by the contributing authors
  Creating Topics - Use a Form Next 


If you're using a Wiki application, you may be provided with a form that makes it easy to add new topics.

hand Demo

FirstPreviousNextLastExit  Slide 47 of 97 COPYRIGHT © 2019 by the contributing authors
  Naming Topics Next 


Choose topic names that are meaningful and unlikely to clash with the requirements of someone else in your group, now or in the future.

If I name a page MeetingNotes, can you guess whose meeting it covers? Which project? Can someone else guess?

Be clear and specific, even if the name seems long. For example, KumquatProjectMeetingNotes2008Q2.

FirstPreviousNextLastExit  Slide 48 of 97 COPYRIGHT © 2019 by the contributing authors
  A Web is a Shared Namespace Next 


In computing terminology, a namespace is "an abstract container providing context for the items ... it holds". As a rule, names in a namespace cannot have more than one meaning; two or more things in the same namespace cannot share the same name.

A Wiki web is a shared namespace. Think of a folder on your computer. Two documents in that folder cannot have the same name. In the same way, two topics in the same web cannot have the same name.

Although Wiki only cares about exact matches, humans can be confused by very similar (or ambiguous) names. Choose names that will make sense to everyone using the web.

FirstPreviousNextLastExit  Slide 49 of 97 COPYRIGHT © 2019 by the contributing authors
  But... What About Breadcrumbs? Next 


screenshot

Q: Don't the "breadcrumbs" show a hierarchy of pages? If my page is "under" Kumquat, isn't that good enough? Why do I have to also put KumquatProject in the name of the topic?

A: Unfortunately, breadcrumbs aren't "real". They provide a handy navigational aid and a convenient way to look at page relationships. However, they're not part of the namespace.

Just keep thinking of a web as a folder.
      One web - One folder - Many pages
      All jumbled together with no "real" organization.

It's up to you to help provide some virtual organization by sticking to a good naming convention.

FirstPreviousNextLastExit  Slide 50 of 97 COPYRIGHT © 2019 by the contributing authors
  Naming Topics Next 


When creating new topics:

  • Use care in choosing a name.
    • Remember the shared namespace.
    • Keep naming conventions in mind.

  • Follow WikiWord syntax. A WikiWord consists of two or more words with initial capitals, run together.

  • Always begin topic names with a capital letter.

  • Use two or more words, or acronyms and words, in CamelCase.

  • Avoid using a single English word as a page name! For example Availability, Hosts, Monitoring, and Misc are all inappropriately vague names (which have been tried!).

  • Likewise, avoid using a single tool name or acronym as a page name.

  • Do not include the word "Wiki" in the name. (It's redundant unless the topic pertains to everything Wiki).

  • Avoid including the words "Web", "Topic", "Template" or "Form". Although these are not (strictly) reserved words, they have conventional meanings to Wiki.

FirstPreviousNextLastExit  Slide 51 of 97 COPYRIGHT © 2019 by the contributing authors
  Naming Conventions Next 


If your web has a naming convention, stick to it.

(If you don't have a naming convention, this would be a good time to create one!)

If your page fits in an existing category of pages, please make that clear by including the relevant keyword, prefix- and/or -suffix when naming the page.

Type of Page Prefix Suffix Examples Notes
Customer related Customer   CustomerEntrance, CustomerNews "externally" facing pages
Focus Areas OnCall, Triage, Release...   OncallMasterHomePage, TriagePolicy, ReleaseCalendar Choose a prefix that clearly identifies the audience and type of content
Management related Mgmt   MgmtPortal, MgmtHeadcount Management areas,
not necessarily for use only by managers
may require Group privileges
Personal pages Personal     Personal pages are acceptable here.
Prefix topic name with Personal and be sure to
include your ID or name, e.g. PersonalVbrown, or PersonalVicki
Project related (general) Project   ProjectPortal, ProjectTracking  
Property or Subsystem related (specific) name of Property / Subsystem   FinanceBCP, SportsOps, FeedsOps standardized format
Team related Team   TeamPortal, TeamDirectory may require Group privileges





Portal (Entry) Page   Portal TeamPortal, ProjectPortal lots of links
BCP Procedures   BCP FinanceBCP  
FAQ   FAQ YMGParanoidsFAQ See the DocsFAQ index
Guidelines   Guideline(s) MeetingGuidelines, EmailGuidelines See the DocsProcedures index
How to... HowTo   HowToCloneNewServer See the DocsHowTo index
Index   Index ProjectArchReviewIndex usually uses a Search to produce an index
requires adherence to naming conventions
Open Issues tracking   OpenIssues PlatformOpenIssues, OpenIssues  
Policies   Policy EngrResponsePolicy See the DocsPolicy index
Procedures   Procedure(s) FinanceOncallProcedures See the DocsProcedures index
Processes   Process HRCSubmissionProcess  
Tools   Tools ToolsResource See the DocsTools index

FirstPreviousNextLastExit  Slide 52 of 97 COPYRIGHT © 2019 by the contributing authors
  Administrative (Restricted) Keywords Next 


If you aren't completely confident of how these work, do not use these keywords in topic names!

Type of Page PrefixSorted ascending Suffix Examples Notes
Template   Template WebTopicEditTemplate Copy/paste or used by Wiki
See the DocsTemplates index; use this suffix with care
Template
strict creation mechanism
  TemplateStrict TriageMapTemplateStrict, ProjectDetailTemplateStrict Used via Form
Do not try to manually copy from these!
Doc portals Docs   DocsGuidelines, DocsCustomer See the DocumentationLibrary index
Web admin Web   WebAttic, WebChanges  

See: TopicGuidelines

FirstPreviousNextLastExit  Slide 53 of 97 COPYRIGHT © 2019 by the contributing authors
  Editing Topics - Add or Change Content Next 


Use the Edit link (in the upper right or lower left of any Wiki page) to open that page to make changes.

FirstPreviousNextLastExit  Slide 54 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A - What about the WYSIWYG Editor? Next 


Q: I see a WYSIWYG button. Can I use that?

A: You will have more control with the regular editor, because you will be able to see exactly what you're doing. Also, some of the features of the WYSIWYG editor may not work with all browsers.

Finally, the WYSIWYG editor may not work as well on pages that contain more than the simplest Wiki markup. In particular, the WYSIWYG editor has been reported to break tables.

If the page contains more than very simple text, exercise caution or use the regular editor.

FirstPreviousNextLastExit  Slide 55 of 97 COPYRIGHT © 2019 by the contributing authors
  Who is Editing This Page? Next 


When you click the Edit link, Wiki starts a 60-minute "timer" for you. This 60-minute timer is used for version history as well as for notifying others that you have the page open for editing.

To avoid setting the timer (if you just want to look at a page), be sure to use Raw View.

When you save the page after making changes, Wiki will "sign it" with your name and the current date and time (in GMT). This information appears in the upper right corner of each page.

FirstPreviousNextLastExit  Slide 56 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A -- What if Someone Else is Editing? Next 


Q: What happens if two people edit a page at the same time?

A:Wiki will notify you if you try to edit a page that someone else has open for editing. You can choose to wait, to edit anyway, or to contact the other person and arrange a mutually convenient time to edit.

If you choose to make your changes anyway, Wiki will try to merge both sets of changes together. It usually does this correctly; however, you should always review the page carefully to be sure no mistakes were made.

FirstPreviousNextLastExit  Slide 57 of 97 COPYRIGHT © 2019 by the contributing authors
  Edit: What's On The Page? Next 


screenshot - Anatomy of an edit

FirstPreviousNextLastExit  Slide 58 of 97 COPYRIGHT © 2019 by the contributing authors
  Formatting Help Next 


Every Edit page has Formatting help at the top of the page. If you don't see the formatting help section, click the Show Help link just above the editing area.

FormattingHelp.jpg

FirstPreviousNextLastExit  Slide 59 of 97 COPYRIGHT © 2019 by the contributing authors
  Fixed Width Font Next 


A fixed-width (monospace) font is recommended for editing bullet lists and other places where spaces really matter.

Look at the bottom right of the page below the Edit area. Click the Courier i to set the edit area to fixed-width font.

screenshot

FirstPreviousNextLastExit  Slide 60 of 97 COPYRIGHT © 2019 by the contributing authors
  Preview, Checkpoint, Save, (or Cancel) Next 


You can preview your page before saving, then go back and fix anything you don't like. Just click the Preview button at the bottom left of the Wiki edit screen.

If you're making a lot of edits and don't want to keep saving and then clicking Edit again, use the "Checkpoint" button.

screenshot

Note: Some things, such as links and extensions, will not be fully functional in Preview mode. Preview is for quick reviewing, not complete testing.

FirstPreviousNextLastExit  Slide 61 of 97 COPYRIGHT © 2019 by the contributing authors
  Preview, Checkpoint, Save, (or Cancel) Next 


screenshot

  • Preview - Review changes without saving yet.
  • Checkpoint - Save and continue editing. (Resets screen to top.)
  • Save - Save and exit Edit mode. Return to View mode.
  • Cancel - Discard any changes you have made. eRturn to View mode.

The buttons have keyboard shortcuts (Alt-first-letter in Windows; Ctl-first-letter in Mac OS X).

Note:
  • "Quiet Save" is just like Save, but does not schedule notifications of changes. You should usually just use "Save".
  • Preview mode may be incomplete (e.g. links aren't clickable, some things won't run...)
  • Checkpoint saves the file on disk but does not (necessarily) change the revision history.

FirstPreviousNextLastExit  Slide 62 of 97 COPYRIGHT © 2019 by the contributing authors
  Force New Revision Next 


screenshot

Normally, if you make multiple edits within a one hour period, Wiki will fold your changes together and make one backup in the revision history. This is often the "right thing to do", as it reduces the visual clutter of many updates.

The "Force New Revision" checkbox is a way to force Wiki to create a separate revision when you Save (or Checkpoint).

FirstPreviousNextLastExit  Slide 63 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A - What if I change my mind? Next 


Q: What if I change my mind?

A: If you decide to leave an "Edit" session without making any changes, be sure to click Cancel (at the bottom of the page) When you click Cancel, the 60-minute timer is reset.

Otherwise, (e.g. if you click the Back button), Wiki keeps the timer running. Anyone else who tries to edit the page will receive a notice that you still have the page open for editing!

FirstPreviousNextLastExit  Slide 64 of 97 COPYRIGHT © 2019 by the contributing authors
  Wiki Shorthand Next 


Working in Wiki is as easy as typing in text - much like using email. You don't need to know HTML to create a web page in minutes. Wiki shorthand gives you much of the power of HTML with a simple coding system that takes little time to learn.

Every edit page has a "Formatting help" section at the top with examples of Wiki shorthand. The link in the last entry, More formatting help, will pop up a page with even more examples.

FirstPreviousNextLastExit  Slide 65 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A: Can I Use HTML? Next 


Q: I already know HTML. How bad is it if I use HTML instead of Wiki shorthand?

A: Wiki supports all HTML, so you can use HTML if you want to.

CanUseHTML.jpg However, the general recommendation is to use Wiki shorthand whenever you can. This makes things easier for anyone else who may edit the page and keeps the text uncluttered and easy to edit. In many cases, Wiki syntax is a lot simpler and smaller than the equivalent HTML code.

FirstPreviousNextLastExit  Slide 66 of 97 COPYRIGHT © 2019 by the contributing authors
  Using HTML Next 


Recommendation:

  • Use Wiki shorthand most of the time (simplicity).

  • Use HTML when Wiki shorthand isn't up to the task (power).

Note: There are a few caveats for using HTML. Be sure to read UsingHTML.

FirstPreviousNextLastExit  Slide 67 of 97 COPYRIGHT © 2019 by the contributing authors
  Making Links Next 


By default, Wiki will try to create a link for any WikiWord. That's all you need. However, many people prefer more control than this.

Some terms just look like WikiWords. Do you always want to link these?

Even if you do want a link, do you want a link everywhere that term appears on the page?

FirstPreviousNextLastExit  Slide 68 of 97 COPYRIGHT © 2019 by the contributing authors
  Prevent Automatic Linking Next 


Use <nop> or ! to prevent attempts to automatically link a single WikiWord.

  • !FreeBSD
  • <nop>FreeBSD

FirstPreviousNextLastExit  Slide 69 of 97 COPYRIGHT © 2019 by the contributing authors
  Prevent Automatic Linking Next 


To prevent automatic linking for all (or part) of a page, wrap the content in <noautolink> tags:

  <noautolink>
     
     _Content_

  </noautolink>

You're in control.

FirstPreviousNextLastExit  Slide 70 of 97 COPYRIGHT © 2019 by the contributing authors
  Tell TWiki Where to Make a Link Next 


To force linking, use [[...]].

  • [[MyWidgets]] - A link to a topic in the current web

  • [[My Widgets]] - You can add spaces for clarity. (Wiki will ignore spaces inside the [[ ]], but you'll see them.)

  • [[Home.MyWidgets]] - A link to a topic in the Home web

Note: I prefer to use [[ ]] everywhere, even if the page doesn't use <noautolink>, because it is more flexible and makes the links more obvious in the source.

FirstPreviousNextLastExit  Slide 71 of 97 COPYRIGHT © 2019 by the contributing authors
  Use Double Brackets for Links Next 


  • [[MyWidgets][View my widgets page]] - Change the text for the link.

  • http://apple.com - Full HTTP URLs turn into links automatically; there's no need to include the <a href part.

  • [[http://apple.com][Apple]] - Change the text for the link (no need to include the <a href).

FirstPreviousNextLastExit  Slide 72 of 97 COPYRIGHT © 2019 by the contributing authors
  Link Guidelines Next 


Use Wiki shorthand (not full URLs) for links to pages within the Wiki.
  • Links will be shorter.
  • Raw pages will be easier to read and edit.
  • Wiki "knows" the path up to the name of the web.
  • Wiki shorthand will help if you ever decide to rename a page (Wiki can find these links and update them for you).
  • Links will continue to work if pages are copied or moved to another server.

FirstPreviousNextLastExit  Slide 73 of 97 COPYRIGHT © 2019 by the contributing authors
  Link Guidelines Next 


If you like to be specific, you can include the Web portion.
  • [[Home.MyWidgets]] -- a link to a topic in the Home web
    (always works, even if the page containing this link is in the Home web).

Use spaces to make links more readable:
   [[Wiki Tut Training]]
WikiTutTraining

FirstPreviousNextLastExit  Slide 74 of 97 COPYRIGHT © 2019 by the contributing authors
  Tip: Links Next 


When changing the link text that will be shown on the screen, here's a useful mnemonic:

  • The Link goes on the Left.

  • The Rest goes on the Right.

Remember that the brackets need to match [[ ... ][ ... ]].

FirstPreviousNextLastExit  Slide 75 of 97 COPYRIGHT © 2019 by the contributing authors
  Wiki shorthand - Examples Next 


  • Separate adjacent paragraphs with one or more blank lines.

  • Bold text - wrap text in asterisks: *your words*.

  • Italic text - wrap text in underscores: _your words_.
    Double for bold italic: __your words__.

  • Monospaced text - wrap text in equal signs: =your words=.
    Double for bold mono: ==your words==.

FirstPreviousNextLastExit  Slide 76 of 97 COPYRIGHT © 2019 by the contributing authors
  Headings Next 


Headings: At the beginning of the line: 3 dashes, 1 to 6 plusses, 1 space.
---++ Your Heading

The number of plusses matches the level of the heading. Different levels have different styling.

Recommendation: Use a single level-1 heading for the page title, then use level 2 and lower for subsequent headings.

FirstPreviousNextLastExit  Slide 77 of 97 COPYRIGHT © 2019 by the contributing authors
  Headings Next 


---+ Level 1 Header
---++ Level 2
---+++ Level 3
---++++ Level 4
---+++++ Level 5
---++++++ Level 6

screenshot

FirstPreviousNextLastExit  Slide 78 of 97 COPYRIGHT © 2019 by the contributing authors
  Table of Contents Next 


A Wiki Table of Contents (TOC) is created from the headings on a page.

To prevent a given header from showing in the Table of Contents, add !! after the last +.
---+!! Level 1 Header (not in TOC)
---++!! Level 2 (not in TOC)

Hint: I usually hide the level-1 header from the TOC. There's only one and it's above the TOC anyway.

Note: If you skip a level (e.g. go from level 2 to level 4), the TOC will look odd.

FirstPreviousNextLastExit  Slide 79 of 97 COPYRIGHT © 2019 by the contributing authors
  Bullets Next 


Bullet list: 3 spaces, asterisk, 1 space. To add another level of indentation, add three more spaces at the beginning of the line.

   * Bullet list
      * indentation level 2
         * indentation level 3
      * indentation level 2

  • Bullet list
    • indentation level 2
      • indentation level 3
    • indentation level 2

Note: When Wiki says "3 spaces" it means 3 spaces (or a multiple of 3). Not 2. Not 4. This is one of the most common goofs people make using Wiki.

FirstPreviousNextLastExit  Slide 80 of 97 COPYRIGHT © 2019 by the contributing authors
  Ordered Lists Next 


Ordered list: 3 spaces, 1., 1 space. To add another level of indentation, add three more spaces at the beginning of the line.

Example:

   1. First
      1. indentation level 2
         1. indentation level 3
   1. Second
   1. Third

Results:

  1. First
    1. indentation level 2
      1. indentation level 3
  2. Second
  3. Third

Note: Use can use 1 or 1. (the . isn't required.)

FirstPreviousNextLastExit  Slide 81 of 97 COPYRIGHT © 2019 by the contributing authors
  Tables (Simple) Next 


  • Each table cell starts and ends with a vertical bar |.
  • Build a table by repeating rows of cells.
    • No blank lines between rows!

  • | *Bold Cells* | are displayed as "header" cells (HTML <th>)
    • "Header" cells do not need to be in the first row.

  • Extra white space in cells (more than 1 space) justifies contents: left, right, or centered.
    • left is the default

FirstPreviousNextLastExit  Slide 82 of 97 COPYRIGHT © 2019 by the contributing authors
  Tables Next 


| *Header* | *Header* | normal |
|    right |   center   | left    |
| *header* | normal | <b>just bold</b> |
| normal | normal | normal |


Header Header Normal
right center left
header normal just bold
normal normal normal

FirstPreviousNextLastExit  Slide 83 of 97 COPYRIGHT © 2019 by the contributing authors
  Horizontal Rules Next 


A series of at least three dashes at the beginning of a line

--------

causes a page-wide horizontal rule to be displayed.


Note: If you need customization, use HTML <hr>.

<hr width=400>


FirstPreviousNextLastExit  Slide 84 of 97 COPYRIGHT © 2019 by the contributing authors
  Verbatim Text Next 


Wiki does not change verbatim text. The result looks just like the source (as if you clicked "Raw View" on the page.)

Many of the examples in this presentation are formatted using <verbatim>.

  <verbatim>
  ---++ Wiki Markup (Formatting Help)

  Every Edit page has *Formatting Help*.

     * *bold text* - wrap in asterisks

  </verbatim>

FirstPreviousNextLastExit  Slide 85 of 97 COPYRIGHT © 2019 by the contributing authors
  Editing Pages - Q&A Next 


Q: I have a document in MS Word (or Excel). How difficult is it to convert this to Wiki?

A: If you use Windows, there are macros available to ease the export of Word or Excel files into Wiki format. On Mac OS X or *nix, things get a bit more complicated.

Hint: If you've been in the habit of using Word as a scratch pad for new documents, you might want to change your habits. It should be easier (and faster!) to create a document in Wiki initially than to create it first in Word and then convert it.

FirstPreviousNextLastExit  Slide 86 of 97 COPYRIGHT © 2019 by the contributing authors
  Q&A - Help! I messed it all up. Next 


Q: What if I mess everything up and break the page?

A: Wiki saves version history for every person who changes a page. For convenience, all changes you make (and save) during one 60 minute period will be folded into one saved revision.

If you "mess up" a page, you can usually retrieve the previous version. You can view all past versions (yours and everyone else's) using the appropriate links at the bottom of the "view" page.

FirstPreviousNextLastExit  Slide 87 of 97 COPYRIGHT © 2019 by the contributing authors
  Content (or, Aack! I have to Write Something!) Next 


A lot of people hate writing documentation. They don't mind writing, but they can't stand the thought of Writing.

So... don't.

Don't think too much about formatting. Don't think about word choice or commas or spelling or grammar or Aaaaargh!

Don't think. Just type. Get the thoughts down in electrons. We'll make it all pretty later.

FirstPreviousNextLastExit  Slide 88 of 97 COPYRIGHT © 2019 by the contributing authors
  Content Guidelines Next 


When you are ready to think about format:

  • Keep It Short and Simple
  • Write Conversationally
  • Think Globally
  • Divide and Conquer
  • Break it Up
  • Highlight Key Words
  • Set off Commands
  • Choose Good Role Models
  • Request a Review
  • Practice

See: ContentGuidelines for detailed recommendations.

FirstPreviousNextLastExit  Slide 89 of 97 COPYRIGHT © 2019 by the contributing authors
  Appendix: Managing Topics Next 


Some Tips and Best Practices for managing the topics in your web:

  • Improve navigation with reasonable parent topic relationships.

  • Periodically review and prune old pages, deprecating or removing stale content.

FirstPreviousNextLastExit  Slide 90 of 97 COPYRIGHT © 2019 by the contributing authors
  Appendix: Personal Customizations Next 


You can customize parts of your Wiki experience.

FirstPreviousNextLastExit  Slide 91 of 97 COPYRIGHT © 2019 by the contributing authors
  Your Home Page Next 


Every Wiki user has a personal Home page in the Main web. You can customize this page with your contact information, notes, sample bits of Wiki code... whatever you like.

Your home page is probably at Main/FirstnameLastname. e.g. Main/VickiBrown.

Note: There is a variable you can use to see your Wiki Name: %WIKINAME%. (You are WikiGuest).

FirstPreviousNextLastExit  Slide 92 of 97 COPYRIGHT © 2019 by the contributing authors
  Notification Next 


Wiki can send you email to notify you of changes to one topic, several topics, or all topics in a web.

Edit the WebNotify topic in the web you're interested in. Follow the instructions and add a bullet with your Wiki name or email address.

Notification frequency is configured by your Wiki administrator.

FirstPreviousNextLastExit  Slide 93 of 97 COPYRIGHT © 2019 by the contributing authors
  Editing Enhancements Next 


It can be frustrating to type text into a browser window. Remember that you have more control than you think.

Hint: Use Firefox.
  1. "Check spelling as you type" for text areas.
  2. Extensions allow you to use an external editor of your choice to edit the contents of textareas. Try It's All Text.

FirstPreviousNextLastExit  Slide 94 of 97 COPYRIGHT © 2019 by the contributing authors
  What's Next? Next 


Topic editing in Wiki is similar to what you'd find in most wikis. Where TWiki differs is in its use of variables, plugins, and structured data.

Learn More:

FirstPreviousNextLastExit  Slide 95 of 97 COPYRIGHT © 2019 by the contributing authors
  References - "Official" Next 


The following are part of the Wiki distribution:

FirstPreviousNextLastExit  Slide 96 of 97 COPYRIGHT © 2019 by the contributing authors
  Getting Help Next 


Talk to your co-workers. It's always OK to ask for help and share ideas.

Visit http://twiki.org or http://foswiki.org

Join the IRC conversation at #twiki at irc.freenode.net.

FirstPreviousNextLastExit  Slide 97 of 97 COPYRIGHT © 2019 by the contributing authors

This site is powered by Foswiki Copyright © by the contributing authors. All material on this wiki is the property of the contributing authors.
Foswiki version v2.1.6, Release Foswiki-2.1.6, Plugin API version 2.4
Ideas, requests, problems regarding CFCL Wiki? Send us email