How to use this wiki + quick tutorial
How to use this Wiki
Access
The co-leads of the Collaborative workgroups will be given write access to the wiki so that they can add content. Everyone will have read access. Additional write access can be granted by request to the Collaborative coordination committee co-leads.Purpose/Scope
Each workgroup has a base wiki page (see Workgroups section below). These pages should be used by the workgroup co-leads to record/document:- minutes from workgroup meetings
- milestones in the inventory development process
- key issues and action items that arise during the workgroup meetings
- summary plots or figures that display important information about the products from the workgroup
Along with giving the workgroups an easy-to-access content management system for documenting their work, this wiki is intended to allow people outside of each workgroup to track progress across the Inventory Collaborative.
A Note on Permissions
There will inevitably be permissions issues (i.e., the ability to access/edit content) at the beginning of this process. Bear with us as these are very solvable issues that can be fixed pretty quickly and easily. If you run into permissions issues with the Collaborative wiki and/or G-Suite, let the Coordination co-leads know and we will get you set up.Quick Tutorial
A wiki is a markup language, meaning that you use special characters in-line with the content to format the text. Here's one example for creating italicized text:I want to use //italics//.
Will look like this:
I want to use italics.
This wiki uses a syntax called Creole. Once you're logged into the wiki (top right of page), there is an icon to the left above the content part of the page that looks like a pencil. When you click on this icon, you'll enter the edit content interface.
Once in the edit interface, you'll see a box on the left for adding content (i.e., typing stuff), along with some buttons for syntax formatting. When adding content you'll get a real-time preview in the box on the right of the edit interface page, so you can see how your content will render in a web browser. Once you're done editing, click the blue Save button.
Use the Creole Sytax Cheat Sheet to help format the content on your wiki page.
Creating New Pages
To create a new wiki page, use the markup syntax for a link in an existing page to point to the name of the new page, like this:
[[New Wiki Page]]
Click on this link to get to the new wiki and begin adding content. Here's an example of what a link to a new, blank wiki would look like:
Only users with write permissions will be able to add content to the new page.
Adding Images
To add images to a wiki page, you can either use a URL link to an image that already exists somewhere on the Web, or you can upload a new image to the wiki server and then point to this image on your page.
To upload an image:
- use the Manage files menu at the top of the IWDW wiki page
- navigate to the Inventory Collaborative folder in the ensuing file explorer window and either drag files from your local machine into browser window, or use the Upload files button to add files to the server
- use the Add image icon in the edit interface (third from the left, looks like a mountain with a sun) to navigate to the Inventory Collaborative folder on the server, double click the file you want to add to the page, and the syntax to include the image will be added to your wiki.
- check the preview box to see how the embedded image will display on the wiki
Adding Tables
Table formatting in a wiki is tedious. If you really want to do this, check the Wiki Cheat Sheet to see the syntax. Otherwise, either link to a Google Sheet or use a screen shot of a table developed elsewhere to include tabulated information in your wiki.