From 8fb45235a01dfa8e18620a022486672cf52904b3 Mon Sep 17 00:00:00 2001
From: Max <Espomaxcrm@gmail.com>
Date: Thu, 8 Apr 2021 18:00:10 +0300
Subject: [PATCH] print to pdf tips

---
 docs/user-guide/printing-to-pdf-tips.md | 87 +++++++++++++++++++++++++
 docs/user-guide/printing-to-pdf.md      |  5 ++
 2 files changed, 92 insertions(+)
 create mode 100644 docs/user-guide/printing-to-pdf-tips.md

diff --git a/docs/user-guide/printing-to-pdf-tips.md b/docs/user-guide/printing-to-pdf-tips.md
new file mode 100644
index 000000000..e4567b8ff
--- /dev/null
+++ b/docs/user-guide/printing-to-pdf-tips.md
@@ -0,0 +1,87 @@
+# Printing to PDF tips
+
+In this article:
+
+ * [PDF syntax](#pdf-code-syntax)
+ * [Text](#text)
+ * [Logo/Image](#logoimage)
+ * [Table](#table)
+ * [Link](#link)
+
+## PDF code syntax
+
+If you open a template code view (`</>`) you will see that your PDF document data is markupped with the tags well known in HTML.
+
+**Note!**
+Due to a security policy some of HTML tags, attributes or styles may not be supported or allowed by editor. So it will truncate them automatically.
+
+## Text
+
+* `<b>some text</b>` - bold text style
+* `<u>some text</u>` - underlined text style
+* `<i>some text</i>` - italic text style
+* `<s>some text</s>` - crossline the text
+* `<br>` - insert single line breaks in a text
+* `<span>some text</span>` - element which is used to color a part of a text: `<span style="color: rgb(255, 255, 255);>`. The `<span>` tag is also very helpful for setting the single string parameters or adding a single empty line.
+* `<p>some text</p>` - defines a paragraph.
+* `<div>some text</div>` - used as a container for HTML elements.
+
+## Logo/Image
+
+#### How to add an image
+
+You can add your company logo or other images to your PDF document with the next ways:
+* Click the picture button in the tools panel -> Browse -> select a file.
+
+Code view: `<img src="?entryPoint=attachment&amp;id=5fec48f49f577cc31" style="width: 25%>`
+
+* Click the picture button in the tools panel -> input Image URL line -> Insert
+
+Code view: `<img src="https://www.espocrm.com/images/espocrm-logo.png" width="300" height="100">`
+
+#### Image resize
+
+* Setting a size with percentage: `style="width: 25%;"`
+* Setting a size with pixels: `width="300" height="100"`
+
+## Table
+
+2x2 table structure example:
+```
+<table class="table table-bordered" border="0.5pt">
+  <tbody>
+    <tr bgcolor="#659B86">
+      <td width="50%" style="text-align: center;">
+        <span style="color: rgb(0, 0, 0); font-size: 12px; line-height: 1;">id</span>
+      </td>
+      <td width="50%" style="text-align: center;">
+        <span style="color: rgb(0, 0, 0); font-size: 12px; line-height: 1;">user_name</span>
+      </td>
+    </tr>
+    <tr>
+      <td width="50%" style="text-align: center;">
+        <span style="color: rgb(0, 0, 0); font-size: 12px; line-height: 1;">1</span>
+      </td>
+      <td width="50%" style="text-align: center;">
+        <span style="color: rgb(0, 0, 0); font-size: 12px; line-height: 1;">Admin</span>
+      </td>
+    </tr>
+  </tbody>
+</table>
+```
+* `border="0.5pt"` - table attribute for setting the width of a table border. Without this parameter you won't see the table borders.
+* `bgcolor="#659B86"` - set a background color. Works for the `<tr>` and the `<td>` tags.
+* `width="25%"` - set a table cell width.
+* `text-align: center;` - set a text position. Supports: `center`, `left`, `right`, ` justify`.
+* `color: rgb(0, 0, 0);` - set the color of the text.
+* `font-size: 12px;` - set the text size.
+* `line-height: 1;` - set a line height.
+* `<tr>` & `</tr>` - defines a table raw.
+* `<td>` & `</td>` - defines a standard data cell in a table.
+* `<td ><span style="font-size: 10px;">{{dateQuoted}}</span><br></td>`
+
+## Link
+
+You can create a link by clicking the link button in the tool panel.
+
+Code view: `<a href="https://www.espocrm.com">Click me</a>`
diff --git a/docs/user-guide/printing-to-pdf.md b/docs/user-guide/printing-to-pdf.md
index bded72cf7..9bb95ecc0 100644
--- a/docs/user-guide/printing-to-pdf.md
+++ b/docs/user-guide/printing-to-pdf.md
@@ -44,6 +44,7 @@ Table of content:
 * [Raw values](#raw-values)
 * [Maps](#maps)
 * [Custom helpers](#custom-helpers)
+* [Tips](#tips)
 
 Available at Administration > PDF Templates.
 
@@ -387,3 +388,7 @@ It's possible to print Google Maps image in PDF. See [here](../administration/ma
 ### Custom helpers
 
 See [here](../development/template-custom-helper.md).
+
+### Tips
+
+See [here](printing-to-pdf-tips.md).