About & Editing Guide

Tahiti Cruisers Guide

The "Tahiti Cruisers Guide" website was an invaluable resource for sailors, carefully curated over many years. However, as of August 2024, it was no longer being updated. To preserve this wealth of information, it was transferred to a BookStack Wiki at the end of 2024, generously hosted for free by www.thefloatinglab.world.

We owe a significant debt of gratitude to SV Jacaranda for his vision and efforts in launching and maintaining the Tahiti Cruisers Guide, as well as to all the sailors who contributed with their insights. Their collaboration has made this guide as comprehensive and valuable as it is today.

The advantages of transferring the document to the BookStack Wiki:

• Better search options
• Choice between viewing the book online (and thus always see the most recent version) or by downloading the PDF (for offline use)
• Clickable (international) phone numbers which direct to your phone dialer
• Clickable email addresses which direct to your email application
• Clickable urls which direct to your internet browser
• Support for Google Maps as well as for OpenStreetMap
• Easier and online maintenance by multiple maintainers
• instant updates
• The book is accessible to search engines, which may guide more users to this book

To download the guide as a PDF, simply click on the "Export" link located at the lower right corner of the screen.

Contribute (please!)

Do you have:

• Information that should be included?
• Found information that is no longer correct?
• An experience you want to share?

You have two options:

• Ask an editor in this: WhatsApp Editor group to process your information
• Become an editor yourself

How to become an editor

1. Create an account.
2. Contact one of the admins, to get your account upgraded to "editor". Please send a message to : WhatsApp Editor group
3. Add or modify the content of the book (but please read below information first)

Structure

The hierarchical structure of the BookStack Wiki is as follows:

1. The shelves. Please don't edit this. Just select the "Cruising info" shelf.
2. The books. Select the book "Tahiti Cruisers Guide".
3. Chapters. The "Chapters" we use are A-Z. Select the one which holds the page you want to modify.
4. Pages. These are the "subjects" within a Chapter.
5. Headings. Inside a page we select under "paragraph" a "medium header" as the title for a new entry.

Editing

You need to have an account and you need to have been upgraded to "Editor" by one of the admins. Please send a message to : WhatsApp Editor group once you made your bookstack account.

Please read all the following information before you make edits.

There are two editors you can use:

• The WYSIWYG (What-You-See-Is-What-You-Get) editor. This resembles a "normal" editor like Word. A disadvantage is that it is difficult to maintain a uniform markup in the document.
• The MarkDown editor. This splits the edit window in a left pane where you edit the raw content and a right pane where you see the result. Advantage is that you can peek how the markup is in other places of the book and just copy this to make a new entry, so that you get a consistent markup.

Depending on the previous person who edited the page, either one of these editors is selected. You can switch the editor by clicking on "Draft saved" or, depending on the state of the editor, another text, but it is always just below the search bar.

The name of this menu item changes depending on the state of the editor.

If you change the editor, the system a warning popup appears, but don't worry, you can safely continue.

Pre-processor

As you have seen, all phone numbers are a clickable link, as well as e-mail addresses, web links, etc. Also there are clickable entries for Google Maps and OpenStreetMap. Nice isn't it?

You can try to mimmick these styles by hand, but please don't, please use the very easy pre-processor so everything is the same.

The pre-processor turns text with one click into the right styles. It's very easy! It can been found at www.thefloatinglab.world/cgi-bin/fp-bookstack.cgi.

Follow this easy process:

1. You enter the text you want to be styled.
   - E-mail addresses will be automatically detected and appropriately styled.
   - URL's wil be automatically detected and appropriately styled.
   - Phone numbers will be recognized if they start with a country code
   - GPS coordinates are recognized and automatically styled if they start with "GPS Coordinates" followed by a latitude number and longitude number in decimal degrees ("google style", so just copy and paste from google maps for instance).
2. Click on "convert" and copy the output text
3. Go to the page in BookStack, enter "edit mode"
4. Switch the editor to "Markdown" (see the previous paragraph)
5. Insert the new text in the Editor pane
6. Observe the result in the Preview pane, and edit until satisfactory
7. Save the page

This is how the text looks when you enter it:

This is how the text looks after clicking "Convert":

This is how the text looks in the right pane of the Markdown editor in BookStack: