03 Wiki Tutorial exercises

Exercises

We have a couple of goals for today's exercises. The first one is for you to set up a new wikidot site that you will use for your project. The second one is for you to become familiar with the wikidot site, wikidot tools, and editing wikidot pages.

Basics

For each one of the following steps, there is a video available on this page.

  1. Create your own site
  2. Update your profile
  3. Invite me (samoore) to be a member of your site
  4. Create a page called “test page” and use it to practice entering and editing text. Be sure to know how to do the following: simple paragraphs, text formatting (bold, italics), headings, lists, block quotes, links (of all types), inserting an image, tables, and user names.
  5. After you have entered a bunch of text, then see what the page would look like when printed
  6. Find the wikidot syntax documentation and look through it to see what else wikidot can do
  7. Modify the top menu

Templates

Most of the above (except for, maybe, the ability to modify the top menu) is available on almost every wiki engine out there. However, the following “template” capabilities are only rarely available. It's slightly tricky, but the benefits are substantial — and once you figure out the steps, then it's quite easy to do. Do the following; after you have completed the steps it will be easier to figure out what you've done (and I'll provide an explanation below).

Add the blog template

Create a file called “blog:_template” (exactly like that, with the colon and the underscore). Copy the following code into the document.

By %%author%% (%%date|%a, %b %e at %I:%M%p%%)

%%content%%

----
putBlogContentHere

Very important: After copying the above code into the document, change the four dashes to four = signs. (If I changed them to equal signs in this document that you're reading right now, then it messes up the formatting of this page that you're reading. Sorry.)

Save the page. It will display but won't look like a normal page because of all of those percent signs. That's okay. We'll see what this page does in a minute.

More information about templates can be found on this page.

Add the bloglist page

Create a page called “bloglist”. Note there is nothing magical about this document name; I could have used anything.

Copy the following code into the document.

This page contains all my blogs from the whole semester. It is sorted in reverse order of the date that the blog entry was created.

[[module ListPages category="blog" separate="false" order="dateDesc"]]
----

++ %%linked_title%%

+++++ by %%author%% (%%date|%a, %m/%d/%y%%; last edited on %%date_edited|%a, %m/%d/%y%%)

%%body%%
[[/module]]

More information on the ListPage module can be found on this page.

Create a test blog page

Create a page called “blog:My first test blog” (just like that, with the colon and the spaces between the words). Add some content to the page: “This is my first blog entry. I hope it works.” (Or something similarly simple.) Notice that your name doesn't appear on the page at this point.

Save this page.

View the bloglist page

Navigate to the “bloglist” page. See what it shows you? It should have your blog entry, complete with title and byline. As you write more blog entries, they will continue to appear on this page as long as you continue to name your blog page “blog:xxx”, where xxx is the title of your blog entry.

This is a very cool feature of wikidot.

Now click on the title of your blog entry (within the bloglist page). This will take you to a separate page containing just the entry of this particular blog. Notice that this page is also complete with your name and editing information — even though you didn't type them into the original document. The blog template that you created took care of that nifty bit of magic.

Related documentation

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License