Voice guide and image style
This page covers Ghostwriter's two written guides: the voice guide, which every draft follows, and the image style guide, which every image search follows. Both are markdown, kept in the database (see Where things are kept), and yours to edit. On a panel with tenancy, each tenant has its own.
The voice guide
Ghostwriter → Voice guide. Everything Ghostwriter writes follows it.
Writing it
Under Read the site again, tick the resources to learn from, then click Write the voice guide. Ghostwriter reads a spread of the newest published records from each, up to 24 records, and writes the guide. This takes a minute or so, and you can leave the page meanwhile. The guide covers:
- who is talking, and to whom
- how pieces are shaped and how they open
- the words used, and the ones never used
- real examples from your records
Only published records are read: those that match each resource's published rule. Records with less than about 400 characters of writing are skipped.
Once there is a guide, the button becomes Rescan and rewrite. It reads the records again and replaces the guide. Edits you've made are lost, so you're asked first.
Changing it
- Edit it by hand in the editor, then click Save.
- Ask for a change in plain words, such as "We never say solutions. Add that." Then click Update the guide. Ghostwriter rewrites the guide to include it. The last few changes asked for are shown, with what it said it did.
While the editor has edits that aren't saved, Update the guide and Rescan and rewrite are off, with "Save your edits first." beneath them. While Ghostwriter is writing or changing the guide, the editor can't be changed.
The image style guide
Ghostwriter → Image style. A description of what your pictures look like, with one ## heading for each resource.
Writing it
Under Look at the images again, tick the resources to look at, then click Describe the images. Ghostwriter finds the images in each resource's upload fields (including those inside Builder blocks and Repeaters). It sends small copies of up to ten per resource to the model. JPEG, PNG and WebP are sent; SVGs are skipped. A resource needs at least three images to get a section.
Once there is a guide, the button becomes Look again and rewrite, which replaces it. You're asked first.
Changing it
Edit the guide by hand and click Save. Save any edits before you click Look again and rewrite.
Where it is used
The image style guide is read whenever an image is found or made with the image button:
- to choose what to search the photo libraries for
- to rank the photos that come back
- to describe the picture when an image is made
When something goes wrong
If writing or changing a guide fails, "That didn't work" and the reason stay shown on the page until the next run. Click the button again to retry. See Troubleshooting.