Notes on using BlueGriffon

Useful links

The official manual for version 3.1 (which we are using) costs £7.50. However, a manual for version 1.7 has been made available unofficially - most of the basic usage is still similar, although the secondary toolbar has been moved to the left of the window and "floating panels" have been removed.

TheSiteWizard Tutorials: a fairly up-to-date selection of how-tos.

FlossManuals tutorial: this is over 10 years old, so it will be for a very old version of BG, but it might be useful.

Chass IT tutorial: another old one.

BlueGriffon Google group: searchable forum - might be useful if someone has already figured out how to do what you want.

Toolbars, format bar and structure bar

Main toolbar

This is below the menu bar, and contains buttons for:

Secondary toolbar

This is at the left side of the screen, and contains buttons for:

Format bar

This is below the main toolbar, and contains:

Structure bar

This is at the bottom of the window, below Dual View. It displays the hierarchy of elements that enclose the current position of the text cursor ("caret").

Miscellaneous how-tos and tips

Unless specified otherwise, these tips assume that you are working in Wysiwyg mode.

Selecting an element

  1. Click to move the text cursor within the element.
  2. Click the element you want to select in the structure bar. Alternatively, repeatedly press the Escape key until the element you want is highlighted in the structure bar.

You can select the whole document by selecting the <body> element.

Applying styles to an element

  1. Select the element.
  2. If you don't already have the style panel displayed, tick Panels:Style Properties to display it.
  3. Adjust the panel width if necessary by dragging the left border (easiest place to find it is at the left side of the darker grey region at the top of the panel).
  4. Select Apply styles to: this element, through inline styles.
  5. Select GENERAL to change font, size, spacing etc. Select COLORS to set colours.

For setting colours, an alternative to steps 2-5 is to click one of the circles in the colours icon (5th from top in secondary toolbar). The top/left circle is for the foreground colour, and the bottom/right circle is for the background colour.

There's more info on thesitewizard.

Applying styles to text within an element

  1. Select the text by dragging the mouse cursor over it.
  2. Select Format:Span. This creates a <span> element enclosing the selected text, and selects the <span> element. Alternatively, click <> (Encapsulate selection ...) in the secondary toolbar and then click span.
  3. Use Applying styles to an element to style the span element.

If you want to set the foreground colour, you can (instead of steps 2-3) click the top/left circle in the colours icon (5th from top in secondary toolbar). This method will create the <span> element automatically. If you try to set the background colour this way, it sets the background colour of the containing element (e.g.paragraph).

Adding a link

The quickest way I've found:

  1. Copy the target URL into the clipboard.
  2. Select the text or element that you want to attach the link to.
  3. Click the 🔗 icon on the main toolbar.
  4. Click OK in the popup dialog (the URL is automatically pasted from the clipboard).

Restoring the text cursor

I regularly have problems with the text cursor not being displayed (happens always after a popup dialog has been closed?). The quickest way I've found to restore it is to click on another window and then back on the BlueGriffon window.

Entering a line break

You can insert a line break using Shift-Enter.

An alternative is to configure Enter to produce a line break by unchecking Tools:Preferences:Documents:Return key in a paragraph always creates a new paragraph and closing the popup dialog. If you do this, you have to press Enter twice to get a new paragraph.

Inserting before the first element of the document

If the first element is a paragraph or heading, you can simply move the text cursor to the beginning of the paragraph/heading, press Enter and then Up-arrow. If you want to insert a paragraph before a heading, you will need to change the new element type from Heading to Paragraph.

If the first element is not a paragraph or heading (e.g. an unordered list, TOC or table), this method doesn't work. In this case, use the following method:

  1. Select the first element using the structure bar.
  2. Press the up-arrow key.
  3. Change Body Text (in the format bar to Paragraph or one of the headings (unless you unusually want text directly within the <body> element).
  4. The text cursor will look as though you are about to type at the beginning of the first element. Start typing anyway - the text will go in the right place.

Discovering what HTML elements you have

If you want to know what HTML elements there are in the document (without switching from Wysiwyg to Source or Dual View), there are two ways:

Setting/editing page title, description and author

Format:Page Properties opens a dialog where you can set these:

HTML comments

HTML comments are not visible when the page is viewed in a browser.

UK dictionary for spellchecker

  1. Download en-GB.dict.xpi from BlueGriffon website.
  2. Go to Tools:Add-ons:Extensions.
  3. Click the gear ⚙️ to left of the search field.
  4. Select the en-GB.dict.xpi file that you downloaded.
  5. Click Install now.
  6. Click Restart now.
  7. Right click anywhere in the text of a document, and select Dictionary:English (United Kingdom).

To hide anchor icons

When you create a table of contents, BG inserts an anchor (<a> element with an ID, but no href link) in each element referred to by the table of contents. By default, an anchor icon is displayed for each icon, but you can hide these using Tools:Preferences:Documents:Show[aname].

To create a nested unordered list

Press Enter and then click Indent text,
or press Shift-Enter and then click Unordered list.

To change an ordered list to unordered, or vice versa

  1. Select the list.
  2. Click Unordered list or Ordered list in the secondary toolbar.

To update table of contents

Click the Insert or refresh Table of Contents icon (2nd from right on main toolbar).

Indents and alignment

There are buttons in the secondary toolbar for indenting and alignment (left, middle, right, justified).

These can be handy for quick use in simple notes files, but they work by inserting inline CSS and so are not very controllable. They cannot easily be overridden by CSS in an external stylesheet or a <style> element.

For example, the indent button produces inline CSS for a 20px left margin. If you wanted to change this (say to 3rem), you would have to edit the HTML source everywhere you wanted the change. A better way would be to add a class to the elements you want to indent and use CSS in an external style sheet to specify the indent.

As another example, if you wanted all <h2> headings to be centred, it's easier and more controllable to specify this in an external stylesheet than to click the centre-align button whenever you insert an <h2> heading.

Using CSS

There are several options for where CSS rules can be placed:

In general, the best place to put CSS is in external stylesheets. These can be shared by multiple HTML files, which provide consistent formatting across the files and make it easy to apply changes in appearance to all the files.

The next best place for CSS is in the <style> element. This enables HTML files to be standalone, but obviously requires editing all the HTML files if you want to make a global change in appearance.

The <style> element can be useful for trying out CSS, particularly for colours since you can use the colour dialog. Once you are happy with the CSS rules, they can be copied out to an external stylesheet.

The <style> element

The <style> element is used to put CSS in the document header. CSS placed here is obviously specific to the document, and can be used to override CSS in external style sheets.

You create the <style> element if you use any of the options in the Style Properties panel other than this element, through inline styles (i.e. this element only through its ID, all elements of class..., or all elements of the same type...).

You can also insert a <style> element manually by:

  1. If you don't already have the stylesheets panel displayed, tick Panels:Stylesheets to display it.
  2. Click the '+' at the bottom left of the Stylesheets panel.
  3. In the popup dialog, select Embedded in the document' (if it's not already selected).
  4. Click 'OK'.

You can insert more than one <style> element, but I don't know of any reason to do so.

You can insert/edit CSS by double-clicking <style> displayed in the Stylesheets panel below URL, or by:

  1. Single-click <style> in the Stylesheets panel below URL to select it.
  2. Click the gear icon at the bottom of the panel.
  3. Select code.

External style sheets

You can link to an external stylesheet by:
  1. If you don't already have the stylesheets panel displayed, tick Panels:Stylesheets to display it.
  2. Click the '+' at the bottom left of the Stylesheets panel.
  3. In the popup dialog, select Linked to the document.
  4. Enter the URL for the stylesheet in the HREF field, or select a file using the yellow folder icon to the right of the HREF field.
  5. Select 'Make URL relative to page location' if required.
  6. Click 'OK'.

The browser will load the stylesheets in the order they are listed, so rules in later stylesheets can override rules in earlier stylesheets. You can move a stylesheet up or down in the list by selecting it (by clicking on it) and clicking the up and down triangles at the bottom right of the panel.

Note that the <style> element (if any) is in the same list  as the external stylesheets, and can be moved up or down in the same way. It's probably best to have it at the bottom of the list, so that it can override the external stylesheets.

You can edit the URL of the stylesheet by:

  1. Select the stylesheet by clicking on its URL in the Stylesheets panel.
  2. Click the gear icon at the bottom of the panel and select Edit.

You can edit the content of the external stylesheet file by:

  1. Select the stylesheet by clicking on its URL in the Stylesheets panel.
  2. Click the gear icon at the bottom of the panel and select Code.

although I normally prefer to use Vim to do that.