Difference (from revision 75 to 76)

Changed: 85,196c85

== '''4 page Introduction to the SOCoP Wiki''' {nid 39FY} ==

Some members asked for some guidance for adding material to the Wiki and being productive. {nid 39FZ}

The following are Gary Berg-Cross's suggestions on this, which are admitly are rudimentary. They are divided into 4 basic sections: {nid 39G0}

1. Login {nid 39G1}

2. Basic Editing of existing material. {nid 39G2}

3. Adding pages {nid 39G3}

4. A start on Graphics and links to files stored on the CIM3 server {nid 39G4}

I’ve tried to keep it short to get people started. {nid 39G5}

== 1. Creating a Login and Logging {nid 39G6} ==

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

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. {nid 39G8}

Username:
Password: {nid 39G9}

You have confirm that you are a human user by filling out the Confirmation box with the #-letter combinations you see. {nid 39GA}

You may then login to the system and edits SOCoP and other Ontolog pages.
After you login you will see in the upper right of the page your login name such as: {nid 39GB}

garybc (preferences | logout) {nid 39GC}

== 2. Editing pages {nid 39GD} ==

You edit pages by going to the bottom left of a page and click on the
Edit text of the page {nid 39GE}

You will see that a scrollable Editing box will appear with the text and graphics of a page. {nid 39GF}

You edit in here and either then: {nid 39GG}

* hit either the Preview the page or {nid 39GH}
* Save it tab at the bottom right of the edit box. {nid 39GI}

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 of Summarize changes by adding words to identify the nature of the change for other people visiting and editing the site. {nid 39GJ}

To really format things you need to understand a few basic guidelines about text editing these: {nid 39GK}

* Carriage returns (ie pressing the Enter key) are significant in formatting a wiki page {nid 39HF}
* 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'' {nid 39HG}
* The first (special) character entered on a line often controls the formatting of the text on that line. {nid 39GL}

Here are the ones Peter Yim who runs the Ontolog Forum documented: {nid 39GM}

* 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) {nid 39GN}
* ":" colon causes text to be indented {nid 39GO}
* "=" 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. {nid 39GP}
* "*" asterisk creates a bulleted list (I use this a lot) {nid 39GQ}
* "#" hash creates a numbered list (Should use this more) {nid 39GR}
* ";" 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 so :: is doubly indented. {nid 39GS}

* Remember to leave a single blank line between paragraphs. {nid 39GT}
* 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. {nid 39GU}

One thing special about Wikis is that they have wikiwords like PurpleNumbers or <nowiki>BodyofKnowledge</nowiki>. 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 <nowiki>BoK</nowiki> will automatically generate a page that wasn’t planned. {nid 39GV}

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

== 3. Adding Pages {nid 39GX} ==

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 <nowiki>SocopMeetings</nowiki> page I can make an indefinite number of month meeting pages under it
For example, on my page: " <nowiki>SocopMeetings</nowiki> 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 {nid 39GY}

== 4. A start on Graphics and links to files stored on the CIM3 server {nid 39GZ} ==

This is a non-obvious part and took me a while to learn, so I will just outline it here. {nid 39H0}

You can’t paste a graphic to a page. You can’t just add a file like a <nowiki>PPT/nowiki> or word document to a page. {nid 39H1}

You have to have a Webdav tool to place the file in a special folder on Peter’s file system. {nid 39H2}

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. {nid 39H3}

The free tool I now use is called <nowiki>BitKinex</nowiki> and I recommend it. See http://www.bitkinex.com/download {nid 39H4}

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 {nid 39H5}

In there we have a directory under: /work/SOCoP This is where we store files which we will later link to. {nid 39H6}

BTW, You need to login to the system with something other than your personal login. {nid 39H7}

It is username = ontolog-member {nid 39H8}

{{{
password = ontology {nid 39H9}
}}}

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 “]”. {nid 39HA}

Here is an example from the Meeting page [http://ontolog.cim3.net/file/work/SOCoP/Meetings/revised%20SOCoP-INTEROP_June_15_2011.rtf Meeting_2011_06_15] {nid 39HB}

If it a picture you want on the page you prefix the link with a colon. {nid 39HC}

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. Bithex doesn’t have a trial period so I learned how to use it. {nid 39HD}

Well that’s it for the 101 start on this. I hope that it helps….. {nid 39HE}

----
See SOCoP/SOCoP_Wiki_Page_Editing for a 4 page Introduction to editing the SOCoP Wiki {nid 39I3}