SOCoP/SOCoP Wiki Page Editing

4 page Introduction to Editing the SOCoP Wiki    (39I4)

Some members asked for some guidance for adding material to the Wiki and being productive.    (39I5)

The following are Gary Berg-Cross's suggestions on this, which admittedly are rudimentary. They are divided into 4 basic sections:    (39I6)

1. Login    (39I7)

2. Basic Editing of existing material.    (39I8)

3. Adding pages    (39I9)

4. A start on Graphics and links to files stored on the CIM3 server    (39IA)

I’ve tried to keep it short to get people started.    (39MB)

1. Creating a Login and Logging In    (39IB)

If you go to the SOCoP.org or any of the ontolog sites we will see on the upper right a Login (create account).    (39IC)

If you don’t have an account or have forgotten it the create account takes you to a page where you can create a login and password pair. Have your login be like this: JohnDoe or SallyMiller.    (39ID)

Username: Password:    (39IE)

You have confirm that you are a human user by filling out the Confirmation box with the #-letter combinations you see.    (39IF)

You may then login to the system and edit SOCoP and other Ontolog pages. After you login, you will see in the upper right of the page your login name such as:    (39IG)

JohnDoe (preferences | logout)    (39MC)

2. Editing pages    (39IH)

You edit pages by going to the bottom left of a page and clicking on the Edit text of the page    (39II)

You will see that a scrollable Editing box will appear with the text and graphics of a page.    (39IJ)

You edit in here and then:    (39IK)

• hit either the Preview the page or Save it tab at the bottom right of the edit box.    (39IL)

If you have time it is good to Preview first since, if you are like me, some of the formatting may be off. You are also given the option to Summarize changes by adding words to identify the nature of the change for other people visiting and editing the site.    (39IM)

To really format things you need to understand a few basic guidelines about text editing these:    (39IN)

• Carriage returns (ie pressing the Enter key) are significant in formatting a wiki page Multiple spaces and tabs are ignored use (two single-quotes) for italics, ' (three single-quotes) for bold, and (five single-quotes) for bold-italics. Alternatively, which I do is use html tags bold' and italic    (39IO)

• The first (special) character entered on a line often controls the formatting of the text on that line.    (39IP)

Here are the ones Peter Yim who runs the Ontolog Forum documented:    (39IQ)

• A blank " " space causes text to appear in a monospaced font where spaces are significant. I don’t intentionally use this much or its alternative triple braces your content or the tag for monospace text (tt stands for typewriter text).    (39JB)

• ":" colon causes text to be indented    (39JC)
• "=" equals - followed by a space - creates a heading, a trailing "=" - preceded by a space - is required to close this out so you have say = INTEROP = as heading 1.    (39JD)
• "*" asterisk creates a bulleted list (I use this a lot)    (39JE)
• "#" hash creates a numbered list (Should use this more)    (39JF)
• ";" semicolon creates a definition list, a ":" colon is required subsequently on the same line Repetition of the first character on the line generally increases the indentation or emphasis.    (39IR)

Remember to leave a single blank line between paragraphs.    (39JG)

PurpleNumbers are automatically generated for every paragraph and every item of a list. If you a line with an existing purple number you will wind up with 2 since a new one is generated. So you usually need to delete the old one first.    (39IS)

One thing special about Wikis is that they have wikiwords like PurpleNumbers or BodyofKnowledge. These have 2 capitals in them and they automatically generate a link to a blank page which you get to edit. This can be a problem since many abbreviations like BoK will automatically generate a page that wasn’t planned.    (39IT)

But you can “suppress” wiki formatting and linking through - by enclosing the word/phrase between the " ... " pair (of tags). I've done that on a few of the previous items mentioned above.    (39JH)

3. Adding Pages    (39IU)

One way to do this is with the wikiword. I’ve done this quite a bit defining things like SocopMeetingpage Another is to create a create a child page under the parent one you are on. You simply add a "/" (slash) in front of a page name, while one is on the parent page. So once I’ve created the SocopMeetings page I can make an indefinite number of month meeting pages under it. For example, on my page: SocopMeetings I could have a page developed to a particular meeting. You can see one such page at http://ontolog.cim3.net/cgi-bin/wiki.pl?SocopMeetingpage/SocopMeetingpage_2010_09_22    (39MD)

4. A start on Graphics and links to files stored on the CIM3 server    (39IV)

This is a non-obvious part and took me a while to learn, so I will just outline it here.    (39IW)

You can’t paste a graphic to a page. You can’t just add a file like a PPT or word document to a page.    (39IX)

You have to have a Webdav tool to place the file in a special folder on Peter’s file system.    (39IY)

What tool you use may depend on your system and the free one that used to work for me isn’t free anymore so I had to download another one and learn it. It works well but there is a learning curve and I had Peter’s help the first 2 times. I think this would be a non-starter for the average geo-scientist or at least a turn off.    (39IZ)

The free tool I now use is called BitKinex and I recommend it. See http://www.bitkinex.com/download    (39J0)

Assuming you get past this download and installation and learning the tool interface (and are still interested), the url for Peter’s file system is: http://ontolog.cim3.net    (39J1)

In there we have a directory under: /work/SOCoP This is where we store files which we will later link to (http://ontolog.cim3.net/file/work/SOCoP/).    (39J2)

BTW, to do this, you need to log in to the system with something other than your personal login.    (39J3)

It is username = ontolog-member    (39J4)

password = ontology    (39J5)

Once in you’ll see various folders I’ve set up and have files in. Essentially what you do is use Bitkinex to load a file into a folder and then copy the link for that file. You place the link onto a word by prefixing the link with a “[“ then have a space and the word or term and then close it with a “]”.    (39J6)

Here is an example from the Meeting page Meeting_2011_06_15    (39J7)

If it is a picture you want on the page, you prefix the link with a colon.    (39J8)

To repeat, first you have to move a file into one of the folders or top level of the place that Peter has set up for SOCoP work. That is: http://ontolog.cim3.net/file/work/SOCoP/    (39MS)

Then you copy the link location of the file from there and place it on a page on the wiki surrounding the link and it name with square brackets. [ ] It looks like this: [ slides ] and all you see is the word "slides" in blue with a link.    (39MT)

Repeat [ [preface URL as above, then SOCoP, then Workshops, then SOCoP-workshop_20091112, then Brodeur-socopWorkshop-2009-11-12.ppt slides] ] and all you see is the word "slides" in blue with a link.    (39MU)

I more or less learned this in one session with Peter once I had downloaded a tool, but since I didn’t load files often I forgot the routine and then had to load the newer tool when the old one ‘s trial period expired. BitKinex doesn’t have a trial period so I learned how to use it.    (39J9)

Well that’s it for the 101 start on this. I hope that it helps…..    (39JA)