Customize the design of specific paragraphs, wrappers, or sections

You can use processing instructions (see “Add special layout instructions”) to customize the design of individual paragraphs, wrappers, or sections in your manuscript. These design instructions are created with CSS, and will apply to both the PDF layout and the EPUB file. For the best results, make sure your CSS is valid, and add it without any extra line breaks or carriage returns (see the images below for examples). You can learn more about CSS here.

To customize a paragraph’s design:

  1. Find the paragraph that you want to customize, and insert a new HED Processing instruction paragraph below it (for more details on how to do this, see “Add special layout instructions”).

  2. In your processing instruction paragraph, type the text STYLE=, and then type the CSS that you want to apply to your paragraph.

If you want to customize a wrapper, insert the processing instruction paragraph after either the wrapper “start” or “end” paragraphs, as shown below:

To customize an entire section, insert the processing instruction paragraph after the section start paragraph, as shown here:

Note that your custom design will be applied to both the PDF and EPUB formats, as best as possible, so you may need to include fallbacks in case a certain CSS value is supported in one format but not the other. One example of this is color spaces: while you may want to use CMYK colors in your PDF output, the CMYK color space is generally not supported in the EPUB format. To get around this, include a fallback, like this:

Here, the layout engine will attempt to use the CMYK value first, and if it finds that it is not supported, it will fall back to the web value (which is supported on all web browsers and EPUB reading devices).