Differences

This shows you the differences between two versions of the page.

--- adding_water_access_page [2026/06/11 18:45] – bob
+++ adding_water_access_page [2026/06/12 14:36] (current) – bob
@@ Line 1: / Line 1: @@
 ======== Adding a Wiki Water Access Page ========
-**IMPORTANT - This page is for the old groups.io Wiki and the new DocuWiki is DIFFERENT. This page will be updated to reflect DokuWiki.**   This is only a place-holder now.
+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]].
-Starting update - Work In Progress
-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.
 **Create a new page**
@@ Line 21: / Line 17: @@
 {{: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 a mark-up language]].  That referenced guide is 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.
+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:
@@ Line 30: / Line 26: @@
 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**
@@ Line 50: / Line 52: @@
 Moving a picture is simple. With the edit window open, find your image with a format, such as,
-<pre class="code">'{{:myPix.jpg?640|}}'</pre> 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, <pre class="code">{{:myPix.jpg?640|}}</pre>
+<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>.
-**Saving a page**
+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.
-Save your work often.  This greatly reduces the bad feelings when something gets lost!
+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.
-Go to the bottom of the edit window and click on"Save Edit."
+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**
-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.
+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.
-A hint is, before saving a page, to make a habit of clicking somewhere in text to create a text cursor and, importantly, to remove any highlighting.   This helps  greatly with accidental loss of material.
+**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.