This is the tab where you do all the composing. It is very important to understand how this functions. And please use the "Preview" button to see what your article is going to look like.
A lot of auto formatting is done for you. This is to help create a consistent look for all the articles.
Please use FireFox for now. Chrome seems to have some issues when uploading images.
An article is a sorted list of sections. Use the "New" (1) to create your first section.
At first the entry screen will look very sparse (empty).
The most important decision you will make is to select the "Type". This will automatically add new entry field to this screen. Harbour.wiki is a preset list of section types.
| Once you select a "Type", a "Content" field will appear, with some information about what kind of "merge" text could be used. If the "Type" is such that some code could be entered, an optional "File Name" and "Source Code" Field will appear.
The list of types may change in the future, as more options of type of source code will be entered.
harbour.wiki will automatically format any source code, by adding line numbers, some color highlights, and a "Copy to Clipboard" button.
References between the Content and Source code can be done via merge fields.
The best to see how this could work, is for you to explore how the article "Windows COM Servers in Harbour ..." was actually composed.
|
The next option to be familiar with is the "Status.
| Initially, you will be set as "Planned". This allow you to create you whole list of sections, before you even create your content. Only sections marked as "Completed" will be published to the public, when the article itself is marked with a Status "Publish" (Main tab). The "Not Used" can be done to completely hide a sections from other authors (except current article co-authors), or to simply remind you that a section is not needed anymore.
|
Here is an example of a more complete sections.
(1) The section name. Optional, if not entered, the name of the section Type will be used.
(2) You could opt to not display a section name. This could be useful if you want the same logical section have multiple source codes.
(3) "Save Changes and Stay" can be used anytime. This will help you reduce the risk of loosing your input. Also every time you save, a version of that section is saved. You could then use the "Preview" (4) to see how your changes are being formatted.
(5) You can stretch the size of the Content entry field. The size will be "remembered" for you. This will not be used to restrict the size of the section being displayed, as harbour.wiki is a "responsive" web site.
(6) You may select from a list of predefined fonts. By default sections use a default one. The list of fonts is specified by type of text, not the actual font name. Contact the system administrator to propose additional fonts.
(7) If the type of section requires some source code, optionally you could specify a file name for a user to use.
(8) You can stretch the size of the Source Code entry field. The size will be "remembered" for you. All source code lines will be non-breaking. This is done to help with any line numbers.
(9) The list of instructions will be different for any "Type" you select. Ensure you get familiar with all the options.
(10) The "Save Changes" and "Save Changes and Stay" are listed again at the end of the entry field.
Pasting Print screens.
The editor used in harbour.wiki was configured to allow you to "Paste" Images (Use FireFox). The easiest I found is to use a tool like SnagIt to prepare you images, for example, adding "Callouts".
After you paste an image, you could align it Left, add a border, and resize it.
Add a border (1), and resize (2) by garbing a corner