Using KompoZer to prepare HBC_

Contents:

Starting a new lexia (file)

All documents intended for use in HBC_ should use the provided template "HBC_ Template.mzt" (right click and save the file into your working directory/folder for the project).

You do this by choosing | File | New | and from the “Create a new document or template” menu choose "A new document based on a template" click the little folder icon on the right and select "HBC_ Template.mzt" which should be in the directory/folder in which you want to create the lexia (as should the file "main.css" - as in the screen shot).

Name the lexia: by choosing | File | Save As | keep the filename as close as possible to the Title you will use (but please use underline characters instead of spaces, and use only lowercase letters, like this: "using_kompozer".

Title

Each lexia in your commentary should have a title which is unique to it. No two lexia (files) should have the same title (since this is how each lexia will be indexed and identified). The title should be the first line of the file, and formatted as the Style “Heading 1”. It is convenient if the filename you give the lexia resembles the title.

Styles

There are four sorts of Style you will use in preparing text:  

  1. Headings (and ordinary paragraphs)Formatting toolbar
  2. Lists and indented paragraphs
  3. Class
  4. Bold, italics and underline

Headings (and ordinary paragraphs)

To apply a heading style, place the cursor within the line, and choose the appropriate Style from the drop down list on the left of the toolbar.

Paragraph styles used in HBC_ are:

Heading 1: for the lexia’s title
Heading 2: for the next layer of headings
Heading 3: the next layer of headings
Heading 4: the next layer of headings
Heading 5: the next layer of headings
Heading 6: the next layer of headings

NB. Use "Paragraph": for most body text 

Lists and indented paragraphs

Class

These are applied only to a highlighted group of characters (usually a group of words), to change their formatting. Bold and italics are the only other word or character level formatting allowed.

This is an image captionThe KompoZer insert image dialogue box.

Using either the image icon, or | Insert | Image | and selecting the file. "Alternate text" is a short text description for users who cannot see images. Under the "Appearance" tab choose "Wrap to the left" to place the image to the right and text to the left.

Bold, italics and underline

These can be applied either using the usual keyboard short cuts (CTRL-B, I & U) or the buttons on the toolbar. 

Please do NOT use other methods to format your text. In particular Tabs and spaces should not be used, use the TABLE option if what you need is a table. Do not select "fonts" these will not be displayed correctly by all users - the "Hebrew" and "Greek" classes should ensure that these languages display correctly if the user has appropriate fonts (and not too badly even if they don't :)

Table of contents (for longer lexia)Table of contents dialog

If you have written a longer lexia which has several headings (as this document has) it is helpful to place a "table of contents" at the top, especially if this links to the headings below. 

You can create this easily in KompoZer. Just place the cursor where you wish the list to appear and select | Insert | Table of Contents | Insert | The default options start the table at the "h1" (heading 1) level and number the elements , rather than accept this you should select for your table to begin at the heading 2 level "h2" and to be unnumbered, as in the screen shot on the right.

If you have a really large lexia (e.g. a Bible Dictionary article) you will probably want to go "deeper" than h3 in this example I only needed the two levels.

Links and references

Links to another lexia that you have written can be made directly. Highlight the text that is to be linked and click the Link icon. Choose the target file. Having made the link please mark it as either a "Justification" or an "Explanation". You can do this in one of two ways:

  1. highlight the link text again and mark with the class either "Justification" or "Explanation".

To link to a place within a lexia you need first to create an "anchor" to link to. Go to the target location and click "Anchor" name the anchor (use all lowercase and use underline _ instead of spaces, you should NOT try to have two anchors with the same name in the same lexia). Now return to the start of the link and make a link, instead of selecting a file type in #anchor_name. 

If you want a link made to a Bible Dictionary Linking to the HBD_ article "Kingdom of God"article then type the head word of the article enclosed in two stars, so for a link to the "Kingdom of God" article the box would look like this:

If the article is not yet written contact the editor so that we can arrange for it to be written.  

Links to other websites should normally be treated as references and linked to the bibliography.

References and bibliography

References in the text should NOT be made with footnotes but in the form (Author's-Name, 123) or (Author's-Name, 2009, 123) where 123 is the page reference. The date of publication should be used if any name will have more than one entry in your bibliography.

A full bibliography covering the whole commentary should be kept in a separate lexia - using the filename "bibliography.html". Each lexia may conclude with a short list of further reading.