About & Editing Guide

Screenshot_2024-10-31_02-16-50.png

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:

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:

You have two options:

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:

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.

Screenshot_2024-11-01_17-23-47.png

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:

Screenshot_2024-11-01_23-06-54.png

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

Screenshot_2024-11-01_23-07-25.png

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

Screenshot_2024-11-01_23-09-47.png


Revision #26
Created 31 October 2024 00:29:16 by Frans
Updated 8 November 2024 13:29:24 by Ilona