HistoryViewLinks to this page Revision from: 2012 August 1 | 04:54 pm
This is the revision from 2012 August 1 at 04:54 pmView the current live version of the article.

OSLC New Wiki test area

Steering Committee documents

See the inaugural Steering Committee Meeting agenda and minutes.

All agendas and minutes.

What’s this for?

This area is for testing the very, very basic wiki functionality that will eventually replace our current Twiki-based wiki infrastructure.

Do not put anything terribly important or permanent on this wiki. I might delete it at any time.

How do I get access?

This wiki now supports by-workgroup access; accordingly, only members of the OSLC Steering Committee have write/edit access to this wiki.

What’s the syntax?

Basic formatting

Pages use Markdown text conversion. If you’ve used the forum (it’s OK, I know you haven’t), it’s the same formatting.

A formatting bar with buttons will walk you through the basics.

For more details on the basic markup, see John Gruber’s Markdown syntax guide or the editing help page on Stack Exchange.

For fancier tricks like categorizing pages, see the ExpressionEngine Wiki Syntax.

If you need it, this forum also supports advanced formatting (tables, definition lists) with Markdown Extra formatting. Beware: the Live Preview won’t show any of the Markdown Extra formatting, but it will be formatted in the final post.

Linking to wiki pages

Two brackets around the name of the page: [[Name of page]]. If the page doesn’t exist yet, that’s OK. Spaces are OK. The link text will be the name of the page.

To use different text for the link, use this syntax: [[name of page | link text]]

The toolbar has a <a href="http://open-services.net/wiki/steering-committee/Link" class="noArticle" title="Link">Link</a> button that will walk you through creating links, too. Try it out.

At the moment, links to wiki pages won’t render in the live preview while you’re editing.

Converting old pages to Markdown syntax

You might have good luck (I have) with the converter at Heck Yes Markdown. Plug in a URL and it’ll try to spit out the main content of the page in Markdown. It’s not perfect, but it works pretty well.

Table of Contents

Add this to a page:

<div>ae7d69f8b295448108acb2280d484cb93f29b1da</div>

And it’ll render as a list based on the headings in the content. Easy.

Uploading files

You can do that on the uploads page.

Is this it?

At the moment, yes. I’m working on the following additional features:

  • Multiple wikis (one for each workgroup). As we get Workgroup Charters in place, we’ll be able to migrate more workgroups over.
  • Links to wiki pages will properly render in the preview while editing a page
  • Access control to those wikis per workgroup membership
  • A better layout that matches the rest of the site
  • Various usability improvements throughout
  • A tool to generate Table of Contents from a page’s content
  • A button in the formatting bar to generate links to wiki pages