# Style Guides

A style guide helps content creators and publishers maintain consistency in their content presentation. It provides guidelines on spelling, grammar, punctuation, capitalization, formatting, and other elements of written communication.

The purpose of the style guides is to provide the ability to overwrite the default PlexTrac formatting during the report export process. The style guides only apply to Jinja templates exported to Word (.doc). Style guides do not impact rich-text fields.&#x20;

PlexTrac provides a default template that can be configured, leveraged, or cloned to create other style guides. There is no limit to the number of style guides.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FeKZiXEkbiAIyhn0QH0Sq%2Fimage.png?alt=media&#x26;token=04355a3a-dac1-4176-b20b-5b86d1318482" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
The default style guide cannot be deleted.
{% endhint %}

## Overview

The style guide consists of four tabs/sections:

* Code blocks
* Images
* Tables
* Hyperlinks

### Code Blocks

This tab defines the code block experience, including style, prefix, font, font size, font color, background color, border color, width, content alignment, and padding.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FQVamfQy24KoYdTCl0nyP%2Fimage.png?alt=media&#x26;token=edc7e36c-b20c-40ad-8f65-e8c75343efda" alt="" width="357"><figcaption></figcaption></figure></div>

### Images

This tab defines the image experience, including caption font and prefix, border style, image width and alignment, and padding.

The options to add a border color and width only appear when a border style is selected. If the border style value is "None," color and width options are hidden.

{% hint style="info" %}
Include any desired punctuation within the "Prefix" box when adding an image prefix label. For example, "Figure:".
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F68JCmxPGERPeNueovSHj%2Fimage.png?alt=media&#x26;token=192715d4-6dc2-4cd7-9160-8a993adc07bd" alt="" width="375"><figcaption></figcaption></figure></div>

### Tables

This tab defines the table experience, including caption font and prefix, and the table justification within the content.

{% hint style="info" %}
Include any desired punctuation within the "Prefix" box when adding a table prefix label. For example, "Table:".
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FDN0pva3m8z7uLpqHfXig%2Fimage.png?alt=media&#x26;token=8bdb3531-9e02-4eec-bd09-9eab3d24a9e5" alt="" width="337"><figcaption></figcaption></figure></div>

### Hyperlinks

This tab defines the font color of links.

<mark style="background-color:yellow;">Step 1:</mark> Click the box.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F2Lo16q0QT0bCFPrHYykD%2Fimage.png?alt=media&#x26;token=e19ee45e-ea99-44cd-b64a-613e8578908a" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Choose the desired color by clicking in the color box, dragging the circle to the desired color, or entering the hex color code in the provided box.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FZY6FcRfmOLS3M4FHNR1w%2Fimage.png?alt=media&#x26;token=1052f3c9-1a24-4a16-bd93-6710f6767dd9" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Click **X** to remove the overlay.&#x20;

{% hint style="info" %}
Click **Reset** under the "Color Options" pulldown menu to revert to the previously selected color.
{% endhint %}

## Creating a Style Guide

<mark style="background-color:yellow;">Step 1:</mark> From the **Admin Dashboard**, click **Templates** under "Customizations," then click the **Style guides** tab. Click **Create style guide**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FyQpAL4oRnqEmxbkTfky2%2Fimage.png?alt=media&#x26;token=2c131613-45b4-4723-a180-e31fb03faedb" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Select if starting from the default style guide provided by PlexTrac or an existing style guide. Click **Create**.

{% hint style="info" %}
If no other style guides exist, the only option in the pulldown menu will be the default style guide.
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FITQ5B8TatknyudEg8TPU%2Fimage.png?alt=media&#x26;token=13e45dd4-68a6-4e4e-995d-21e5a5327e35" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Enter a name for the new style guide.

{% hint style="info" %}
There is a 100-character limit to a style guide title.
{% endhint %}

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FnoKfwNDbaPdzzYgxWTDB%2Fimage.png?alt=media&#x26;token=177dbce0-3b2e-484d-9e79-48a5735030c8" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> Configure the style guide to the desired experience by navigating between the four tabs. Click **Create style guide** when finished.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FAI2XiQtWhsHKphnIJZbr%2Fimage.png?alt=media&#x26;token=2381afb1-5bfb-436a-94db-223ee8b4dcef" alt=""><figcaption></figcaption></figure></div>

## Associating the Style Guide

A style guide must be associated with an export template to be leveraged. The export template is then associated with a report template, which is then associated with a report. The instructions below assume all files (style guide, export template, report template, and report) exist.

<mark style="background-color:yellow;">Step 1:</mark> From the **Admin Dashboard**, click **Templates** under "Customizations," then click the **Export templates** tab and find the desired export template to associate with the style guide.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FDzrCDbowPH1se2KVGcZI%2Fimage.png?alt=media&#x26;token=16ff863c-3962-4cbb-b53a-c7224919c2c7" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Under the "Style Guide" column of the table of the export template, select the desired style guide from the pulldown menu.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FDi5krZWleCbyGqjtmoq9%2Fimage.png?alt=media&#x26;token=bc1addc6-afe2-410c-9062-eea1ce7152ec" alt=""><figcaption></figcaption></figure></div>

Any report templates associated with this export template will now leverage the style guide. If no report templates are associated with this export template, continue with Step 3.&#x20;

<mark style="background-color:yellow;">Step 3:</mark> Click the **Report templates** tab.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F0mBozXL2E6vmwCwlmguf%2Fimage.png?alt=media&#x26;token=db364e4f-e0c5-49f8-963a-05875f8fcd5b" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> Click **Edit** from the "Actions" column.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FcuOcJThk5F8owdp8TZvm%2Fimage.png?alt=media&#x26;token=d6ca24a8-ca1e-4e99-bb57-80f852361171" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 5:</mark> From the pulldown menu under "Export template," select the export template from Step 1. Click **Save**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FXjmrkZn20pcveYG91IiL%2Fimage.png?alt=media&#x26;token=891a8c90-8ea6-40a6-96df-a1393321bb3c" alt=""><figcaption></figcaption></figure></div>

Any reports associated with this report template will now leverage the style guide when exported. If no reports are associated with this report template, continue with Step 6.&#x20;

<mark style="background-color:yellow;">Step 6:</mark> Click the **Reports** module from the left navigation bar. Click the row of the impacted report.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FG83kovXKhh9sf9eecxaz%2Fimage.png?alt=media&#x26;token=6ec8c1cb-056a-48d6-ba81-d6d4c3536b26" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 7:</mark> Click the **Details** tab.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FISDxgtmi318tlg5HmN0s%2Fimage.png?alt=media&#x26;token=906a42e3-c6c4-425e-a991-d3d36a24d4e0" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 8</mark>: Go to the "Report Template" field and select the report template in the pulldown menu from Step 4. Click **Save**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FC5xNUhKlFrTEHxonDy7H%2Fimage.png?alt=media&#x26;token=40a79e75-dd49-4dda-8763-1ebf05fbabe9" alt=""><figcaption></figcaption></figure></div>

The next time this report is exported (assuming it is a Jinja template), it will reflect the configuration of the associated style guide from Step 2.
