UK Cherub - resources

Adding Images

anonymous@undisclosed.example.com (Anonymous) — Wed, 09 Dec 2020 19:21:59 +0000

Adding Images

Putting pictures into the page helps to break things up, and if a picture paints 1000 words, then it will save on some typing too. To add a picture click on the picture button This will open a new window that lets you browse through thumbnails of the images that have already been uploaded, and to upload new images of your own. The images are organized into namespaces, and the default position for the browser is to open into the same namespace as the page you are editing. Clicking onto a different namespace will let you brows the pictures in that folder. If you click on an image it will open a dialog, that lets you select the size and position of the picture. The text in the page at the point where you had the curser, and if you use the preview function you can see what it will look like. To help describe the picture, you can add a description of the picture after the | The description will appear if you hover the mouse over the image.

 {{imagename.jpg|My Description of the Picture}}

External Pictures

You can also link to pictures hosted somewhere else on the web

{{www.myserver.co.uk/mypicture.jpg}}

New Pictures

To add a new picture click on the ‘’Choose File’’ button, and browse on your computer to where the picture is located, select the file, change the filename in the ‘’upload as’’ box, and then click ‘’upload’’. Your image will be uploaded, and the browser will jump to show it, click on the image and it will be inserted. There is also an option to upload more than one file at a time, but if you do that then please rename them before uploading.

Image Naming

With well over 1000 images on the website it is important that we keep them organised, this is done with the filename for the image. The preferred format is:

sailno-yyyymmddx.jpg
2683-20110826a.jpg
2683-20110826b.jpg
2683-20110826c.jpg
2459-1981xxxxa.jpg

Where the ‘’sailno’’ is from the most prominent boat in the picture, ‘’yyyy’’ is the year taken ‘’mm’’ is the month ‘’dd’’ the day ‘’x’’ is incremented if there is more than one taken on the same day. If you are uploading an older picture or can’t remember the date then put in the best estimate you have with ‘’x’’ replacing what you don’t know.

For pictures of boats, the best place to put them is into the ‘’boats’’ namespace, and if correctly named they will then appear automatically in the gallery in the boat page. Have a look at Primal Scream to see how this can work.

If the picture is not of a boat then the bit before the date could be replaced by a sensible description e.g. * fleet-20110515a.jpg

people-20110515a.jpg
netly-20110515a.jpg
rudder-20110515a.jpg

There is an automated gallery function within the website that lets you pick all the pictures with a particular filename, so you can pick all the pictures for your boat, or all the pictures from a specific year. By keeping the filenames consistent it really helps this to work. For more details have a look at the extras page

Image Size

There is no point in uploading an 8MB picture of sea with a tiny boat in the middle, think about cropping down to the interesting part, and resizing to a useful size. The pictures are typically only going to be viewed on screen so having them any bigger than screen size is of no benefit, and just makes it slower to load. I would suggest 1024×768 as the normal maximum, if your photo is amazing and full of interesting detail then go bigger, but think about whether you need to.

Extra Info, or metadata

Once you have uploaded your picture you can add some more information about the picture, this will be displayed when someone clicks on the picture. To edit the metadata click on the small pencil next to the description

This opens a new window where you can add a title, caption, photographer, Copyright info, and keywords By including some metadata with the image it helps image searches like Google Image correctly name and understand the images, which can help to improve the Class search ranking, remind you of when and where the picture was taken and record the photographers copyright over the image.

Gallery

One of the extra features we have on this site is a customised gallery plugin that allows you to automatically select images with simalair file names and display them all on the page, it will automatically update if new images that match the criteria are added.

Website Help

anonymous@undisclosed.example.com (Anonymous) — Thu, 09 Mar 2023 08:25:48 +0000

Website Help

This website is setup so that class association members can add and update content. This has enabled us to create one of the best resources for garage boat building on the web, together with an archive of great information about loads of past and present boats. The functionality allowing us to do this comes from the software that the site runs on called dokuwiki, this is a type of wiki, so called as they are designed to be fast to update. It has a simple to use interface for quickly creating and editing pages. If you are not used to it updating a website can be intimidating, however, if you can send email, use facebook or the forum, you should have nothing to fear about creating or updating a page.

Logging in

To login to the wiki follow the link at the top right hand side of the page, and use the same login details as the forum. If you need to change any profile settings, such as email address, password or your display name this needs to be done through the forum.

Creating and Editing Content

The wiki is designed for collaborative updating of documents so it keeps the old revisions of a page. Meaning that if you accidentally delete part of a page, or make a mistake you can revert to an older version. If you want to test some things, or have a practice you can try them out in the PlayGround. It is possible to have a look at the older versions of pages, and see the changes made when someone edits a page by looking at the ‘’recent changes’’

You can edit the pages using your web browser, without any add-ins or additional software. The wiki uses a simple text syntax to control how the page looks, you can get a full list on the Formatting Syntax page. However you do not have to remember complex codes to edit pages as there are buttons at the top of the edit box that will insert the appropriate text at the cursor when clicked. The benefit of the text syntax is that all the formatting info is visible so that after you have been using it for a while you can easily type the common formatting without having to use the buttons. In this section we describe the basics for creating and editing content, together with some extensions to the basic system used on the site, and descriptions of how the site is setup.

Site Setup

To organise the content on the site we use folders or as the wiki calls them namespaces. These folders are mainly of interest when you are linking to a page, or an image that has been saved into a different name space. To make a link to a page or image that is in a different namespace just put the name of the namespace before a colon in your link. If you use the link wizard, or the image browser then this will be taken care of for you.

Editing a Page

When logged in pages can be edited using the ‘’edit page’’ button on the top left of the screen you just type the text you want in the text box, and use the buttons on the toolbar to change the formatting, once finished you can use the ‘’preview’’ button to check if everything is working, and then the ‘’finish edit’’ to save the changes.

Some of the buttons are quite obvious, some are less so, they are described below.

Bold - Loud text
Italic -Text that is leaning over
Underline – Underlines text, this can be confusing as the default for a link is to have an underline
Code Text – Puts the text into a box and ignores any links or syntax
Strike-through – <delete>Puts a line through the text<delete>
Same Level Headline – Adds a headline at the same level as the current paragraph
Lower Level Headline – Adds a headline at a lower level than the current paragraph
Higher Level Headline – Adds a headline at a lower level than the current paragraph
Headline – Lets you select a headline from 1 to 5 with 1 being the biggest.
Internal Link – Puts an internal link, you can use the link wizard to navigate to the page you want to link to .
External Link – Adds the code for inserting an external link
Ordered List – Adds one line of a numbered list, press return after typing to start a new list
Unordered List – Adds a bulleted list, like this one
Horizontal Rule – Puts a line across the page
Inserts an image – see the Images Help Page for more details
Inserts a smilie -
Inserts a special symbol – Good for all those Greek letters
Inserts your signature – Useful if you have added a comment.

There are a few more formats that you can use by directly entering text, see Formatting Syntax for more details.

Adding Pictures

Pictures help to tell the story, and it is easy to insert pictures either from the library, hosted on other websites or to upload new pictures from your computer. To add a picture click on the picture button of the edit toolbar This will open a new window that lets you browse through thumbnails of the images that have already been uploaded, and to upload new images of your own. For more info on how to upload images and our naming guidelines please look at the Images Help Page

Adding Links

Links help people to navigate around the site, and can lead people into looking at more of the site e.g. in a race report by putting a link to the boat page for each boat when it is first mentioned people can have a look at the boat, and find out more.

Links can be added using either the ‘’Internal Link’’, or ‘’External Link’’ buttons.

Internal Links

The internal link button brings up the ‘’Link Wizard’’ that lets you browse through the site to find the page you want to link to, by clicking on the page name it inserts the correct text into the page.

The wiki is set to display the first headline in the page as the link to that page, if you want to display something different then you add the text you want after the |

External Links

You can make an external link just by typing the web address www.uk-cherub.org however if it is a long address and you want to display something shorter you can use the ‘’external link’’ button in the tool bar this gives you

[[http://example.com|External Link]]

Simply replace the text with what you want, and it will display with whatever text you have after the |.

Tables

Tables can be very useful, particularly for race results.

Heading 1	Heading 2	Heading 3
Row 1 Col 1	Row 1 Col 2	Row 1 Col 3
Row 2 Col 1	some colspan (note the double pipe)
Row 3 Col 1	Row 3 Col 2	Row 3 Col 3

Table rows have to start and end with a | for normal rows or a ^ for headers, and you need a | or ^ between each cell.

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
| Row 2 Col 1    | some colspan (note the double pipe) ||
| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |

For large tables with long text in each row it is easy to get lost. I find that the easiest way to setup a table is to use a spreadsheet, first put the data in where I want it, and then insert columns filled with | and ^ as required. The text can then be copied into the wiki. There are a few more formats that you can use, see Formatting Syntax for more details.

Creating a Page

News Report

The most common type of new page that people will want to create are the news articles on the front page. This is done by typing the title of the page into the “New Blog Entry:” box in the middle of the front page, then click on the “Create this page” button. This will create the page and you will see the editing box allowing you to write your story.

Adding A New Page

The first stage to creating a new page is to create a link to it, this is done by editing an existing page, and inserting the link. Putting the name for the page in square brackets will create the link. [[new_page]] The name you put in the square brackets will be the name of the text file, but it does not have to be the title of the page, or what is displayed in the link. The wiki is setup so that the name of the page, and the text of the links defaults to the first header within the page. So the boat page for AquaMarina is [[boats:2681]], however if I create a link to the page it will display as AquaMarina Once the page that you are editing has been saved, the link will appear Red showing that it is for a page that has not been created yet. Clicking on the link will create the new page,

Blank

anonymous@undisclosed.example.com (Anonymous) — Wed, 09 Dec 2020 19:21:59 +0000

Blank

no content