Oregon Coots Water Access

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======== Adding a Wiki Water Access Page ========

This information is for a Coot that is familiar with a water access point, like a boat launch ramp, and wants to add this to the Coots' Wiki data base.  What you are doing is adding a page to the Wiki.  As soon as you finish the page, it is available to be read by anyone.  And any Coot, signed up for this groups.io group, can make changes.  The process of adding and editing a page is available to anyone registered with coots.org.  All that registration does is to check that the email is valid.  Hints for registration are [[http://www.coots.org/cootswateraccess/doku.php?id=start|on the main page]].

**Create a new page**

Reading this page means that you have accessed the wiki. You are free to read any page, and they are listed in the sidebar for PC users and in-line for phone users. If you want to add a new page, describing a different location than is currently show, do a search for the new site.  Here, as an example, we will follow through with adding a real access site, the Port of Toledo launch ramp on the Yaquina River.  This is step-by-step and too much detail for experienced users, but available if it is useful.  The search should be done in a special way, needed because your search phrase will become the file name of a wiki page.  So, the search should be several words separated by an underscore.  Use no capital letters. Avoid long names as that helps fitting into a file browser display.  For our example, we choose toledo_yaquina_ramp.  Ramp is not normally needed, but Toledo also has a paddle park, and the word ramp distinguishes the two.  After we enter this into a search window and hit Enter, we see the following:

{{:addpage1.png?640|}}

If this tells us that the page exists, we need to either edit that page, or create a new name.  More likely, we will be told that the page is not found, and get the option, "If you didn't find what you were looking for, you can create or edit the page," followed by our page name as a link.  To start our new page, just click on the link as shown next:

{{:addpage2.png?900|}}

We should immediately be presented with an edit window. If that is the case, skip the rest of this paragraph.  If somehow, you do not get to the edit window, that will be shown below, on any page, go to the top and click on "Sitemap," as shown below, and and then clicking on toledo_yaquina_ramp.  You will see either an empty page, or a page with anything that has been added to our new page.  Next, look for a gray pencil in the upper-right edge of the wiki page.  Clicking that opens the wiki editor.  One last hint is that if you do not see the gray pencil, you probably are not registered.

{{:addpage3.png?900|}}

So, we now are shown the edit window, with the empty Toledo Ramp wiki page [[https://www.dokuwiki.org/wiki:syntax|written in the dokuwiki mark-up language]].  That referenced guide is **very helpful** to look at, but many of your editing tasks can be carried out with copy-and-paste from existing material.  Straight text is easy; you just type it in.  A new paragraph does not require any special character; it only needs two "Enter"'s.

To get started with our new page, I opened a [[http://www.coots.org/cootswateraccess/doku.php?id=water_access_site_template|new browser tab with the Coots' water access template]].  Copying that entire page and pasting it into the new edit window gives a good start. The blank page that comes up will accept your typing as new material.  All the usual features, such as copy-and-paste or insert an image are available, many of these through the small icons above the edit window.  Here is an example where I have already edited the first few entries:

{{:addpage4.png?900|}}

Before editing the page material, we need to learn how to save the page. Go to the bottom line and there is a pink box  for "Edit Summary."  This is a short indicator of changes that goes into a wiki log.  At this point, a short phrase, "Initial edit" will tell the story. Next click on the left hand "Save" button.  The actual wiki page will appear.  If the changes are simple, like a typo correction, it is expedient to just click the "Minor Changes" box and leave no message.

To continue editing, go click the gray pencil in the upper right. The edit box should appear as you left it before the save.

**Adding a Sidebar Entry**

The new wiki page is not quite complete, as nobody will find it.  We need to add it to the list in the sidebar, on the left.  First, look at the side bar and see what geographical category your new page fits into.  Then go to the upper left and click on "sitemap."  This brings up a list of pages, and so go down to "sidebar" and click on it.  This brings up the sidebar as a wiki page.  To edit this, click on the gray pencil.  Hunt for the geographical category you need (they are alphabetical).  You then need to add your site as a line, such as "<nowiki>* [[toledo_yaquina_ramp|Toledo Ramp (Yaquina R.)]]</nowiki>".  Keep the length of the sidebar name "Toledo Ramp (Yaquina R.)" short enough to not cause a line break in the sidebar.  This is somewhere around 35 characters.  Your new site should now appear in the sidebar as a clickable link.

If you do not find an appropriate geographical category...  (TBD)

**Measuring Boat Ramp Slope**

We'll try here to describe an almost non-mathematical way to find ramp slope.  ** TBD soon... **

**Adding a picture**

Adding a picture is two steps, first loading the image file to the wiki media storage and then inserting it into the wiki page.  Loading the file is not enough.

1 - Click on the image icon near the top of the page.{{:imageicon.gif?50|}}  This opens a new window.

1a - To upload the image, click the "Select Files" button and browse for the desired file (most standard formats are supported). Click "Open".

1b - Next click the "Upload" button and then the "Done" button.  Finally, you have uploaded your image file, so close the extra window.

2 - Place your entry cursor where you want the picture to go and then go to the top bar and click the image icon icon, again.  In the separate window, select the image file from step 1. Next, highlight it with a click and then place your edit entry cursor where you want it.  Next click on the "Insert" button.

** Editing Hints**

Moving a picture is simple. With the edit window open, find your image with a format, such as, 
<nowiki> {{:myPix.jpg?640|}} </nowiki> and cut and paste the text where you want it.  Changing the picture size is done by the width parameter, 640.  To make it smaller, you could use, <nowiki> {{:myPix.jpg?480|}} </nowiki>.

Keep the uploaded picture size close to what you want to display.   Phone pictures can have huge size, and scaling them back in the wiki just adds to wiki backup size.  If the picture being entered is too large, dokuWiki will give you an error.

Remember that everything that will be seen on the wiki page is described by the mark-up language.  This is all simple text and visible.  Once you get used to this, it usually becomes more convenient than WYSIWYG editing.  Copy-and-paste is very powerful in this type of editing.  

If you do not see the results that you expect from editing, the [[https://www.dokuwiki.org/wiki:syntax|dokuwiki mark-up language syntax guide]] probably will provide the hints that you need.

**Saving a page**

Save your work often.  This greatly reduces the bad feelings when something gets lost! Go to the bottom of the edit window, add a short Edit Summary and click on "Save." Be aware that saving your wiki page results in the wiki edit being closed. After you save a page you will see the page as it is presented in the wiki.  To continue editing, you will need to once again open the editor by clicking on the gray pencil.

**Editing an Existing Wiki Page**

In case it is not clear, the Wiki idea is that you can edit other people's pages!  Along with that goes a responsibility to be nice.  True as it is, that is not what this page address. We want to see how to do such an edit.  So, if you are registered and signed in, you can edit any existing page by simply clicking on the gray pencil.  After that, everything above is available to alter and save pages.  That increases the knowledge source size and makes the pages more correct and complete.