- Paligo Documentation
- Publish
- PDF Styling
- Cover Pages and Front Matter
- Troubleshooting PDF Covers
Troubleshooting PDF Covers
If you are experiencing problems when setting up covers for your PDF outputs, you may find the answers in this article. It covers some of the most common mistakes relating to covers.
Covers are Missing
If your PDF has no covers at all, it is likely because Paligo is set to not generate covers.
To fix this, see Generate a Cover.
Content Overlapping on Cover
If you have overlapping content on a cover (typically a front cover), it is likely because the front cover recto (or verso) contains content from the publication topic and also from a cover component.
Paligo adds the publication topic content to the main body area of the page. The cover component content goes into a content box that overlays the body area.
You should redesign the page so that there is sufficient space for both sets of content. For that, you can use the PDF layout to control the positioning of the info elements from the publication topic and also reposition the content box.
For details, see:
Content Missing from Cover
If there is content missing from a cover, it is likely because:
-
There is insufficient space to fit the content in a content box
Paligo will push any content that does not fit onto the next page (for info elements in the publication topic).
If there is too much content to fit inside a content box, either the top part of the content will be missing or the bottom part will be missing. This varies depending on the type of vertical alignment that is in place for the content box.
To fix this, either change the size of the content box or reduce the amount of content inside the relevant cover component.
-
The publication topic does not contain the info elements
Info elements, such as copyright and pubdate, will only appear on the cover if you have included them in the publication.
Note
For most of the info elements, if you add the structure but do not enter text, Paligo will remove the empty structure before publishing.
-
The cover components are not set up correctly
Paligo will only show the content for cover components if they are set up correctly (see Cover Components not Working).
-
Other images have priority
Images in the publication topic take priority over the cover content components and PDF layout.
The priorities are:
-
Publication topic image. This has top priority for the front cover recto only.
-
Cover component image. Paligo uses this in preference to the layout.
-
PDF layout image. Paligo uses this if there is no image set in a publication topic or a cover component.
-
-
The image does not have the appropriate role attribute
If you add an image in a publication topic or cover component and you want Paligo to use it as the background image, it needs to have a role attribute. The value of the
roleattribute should be bg-image.
Cover Components not Working
If you have set up cover components for your publication and they are not showing in your PDF output, it is likely because they are set up incorrectly.
Make sure that you have:
-
Created cover components and given their cover elements a role attribute with a suitable value (see Create a Cover Component and Set a Cover to be Front, Back, Recto, Verso).
-
Added the cover components to the publication topic ( see Add a Cover to a Publication).
-
Added content inside the correct cover component.