User Tools

Site Tools


offer-cube:howto:pdf-special-font

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

offer-cube:howto:pdf-special-font [2019/06/02 20:38]
offer-cube:howto:pdf-special-font [2020/06/01 17:50] (current)
Line 1: Line 1:
 +====== offer-cube / PDF Power-User Funktionen ======
 +
 +Zurück zur [[offer-cube:​howto|Anleitungen / HowTos]]
 +
 +===== Allgemeines / Zusammenfassung =====
 +
 +Die PDF Erweiterungen für Power-User ermöglichen folgende Funktionalitäten:​
 +  * [[offer-cube:​howto:​pdf-special-font#​detailsfett_b_kursiv_i_unterstrichen_u|Schriftstile]]:​ Fett <b>, Kursiv <i>, Unterstrichen <u>
 +  * [[offer-cube:​howto:​pdf-special-font#​detailsschrift-groesse_farbe_font_ueberschrift_h1|Schriftgröße/​Farbe]]:​ Größe/​Farbe <​font>,​ Überschrift <h1>
 +  * [[offer-cube:​howto:​pdf-special-font#​detailslinks_auf_webseiten_a|Links auf Webseiten]] <a>
 +  * [[offer-cube:​howto:​pdf-special-font#​detailsabsaetze_abstaende_p_br|Absätze/​Abstände]] <p> / <br>
 +  * [[offer-cube:​howto:​pdf-special-font#​detailsseitenumbruch_bzw_dynamischer_seitenumbruch_pagebreak|Seitenumbruch bzw. dynamischer Seitenumbruch]] <​pagebreak>​
 +  * [[offer-cube:​howto:​pdf-special-img|Einfügen von Bildern aus Attachments]] <img>
 +  * [[offer-cube:​howto:​pdf-special-variables|Objektdaten holen]] und über Variablen in den Text einfügen
 +
 +Gesteuert werden diese Funktionen über die daneben stehenden html-Tags.
 +Zusätzlich gibt es die Möglichkeit Daten von Objekten (z.B: Gesamtpreis,​ Rechnungsdatum,​ Angebotsnummer,​ etc.) aus dem System [[offer-cube:​howto:​pdf-special-variables|zu holen]] und über [[offer-cube:​howto:​pdf-special-variables|Variablen]] einzufügen.
 +
 +Diese Erweiterungen lassen sich auf folgende Objekte/​Felder anwenden:
 +  * Angebote/​Aufträge/​Rechnungen:​ Felder "​Überschrift/​Titel",​ "... Beschreibung",​ "... Appendix"​
 +  * Position: Felder "​Positions-Bezeichnung",​ "​Positions-Beschreibung"​
 +  * Artikel: Feld "​Beschreibung"​
 +
 +===== Details: Fett <b>, Kursiv <i>, Unterstrichen <u> =====
 +
 +Über die HTML Tags <b> (fett), <i> (kursiv), <u> (unterstrichen) lassen sich Wörter oder Sätze in den oben angegebenen Feldern der jeweiligen Objekte entsprechend formatieren.
 +
 +Wichtig hierbei ist das entsprechenden Schließen der Tags, wie auch in HTML üblich, mittels </​...>​ Anweisung.
 +
 +**Beispiel Angebots-Beschreibung:​**
 +<​code>​
 +Lieber Franz,
 +
 +wie kürzlich besprochen unser Angebot für die Montage und Installation einer <​b>​neuen SAT Anlage</​b>​ inkl. Receiver und Einrichtung/​Einschulung.
 +
 +Für Fragen stehe ich Dir gerne jederzeit unter <​u>​+43 676 / 84 35 36 333</​u>​ zur Verfügung
 +</​code>​
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_01-style.png|Beispiel Style fett, unterstrichen Anweisung Angebots-Beschreibung}}
 +
 +**Ergebnis:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_01-style2.png|Ergebnis Style fett, unterstrichen Anweisung Angebots-Beschreibung}}
 +
 +===== Details: Schrift-Größe/​Farbe <​font>,​ Überschrift <h1> =====
 +
 +**ACHTUNG: BETA Funktion - kann sich zukünftig ändern**
 +
 +Über den HTML Tag <​font>​ lässt sich die Schriftgröße und Farbe anpassen - die Parameter //size// und //color// geben die Größe und Farbe an. \\
 +Die Farbe ist hierbei als Hexadezimaler Wert mit vorangestelltem # (Raute-Zeichen) anzugeben (reines Rot ist z.B. #FF0000). Siehe [[https://​www.w3schools.com/​Colors/​colors_hexadecimal.asp]].
 +
 +Über den HTML Tag <h1> lässt sich eine Überschrift mit der in den Druckeinstellungen festgelegten Schriftgröße "​Schriftgröße Überschrift"​ (pdfTitleHeadlineFontsize) einfügen.
 +
 +Wichtig hierbei ist das entsprechenden Schließen der Tags, wie auch in HTML üblich, mittels </​...>​ Anweisung.
 +
 +**Beispiel Angebots-Beschreibung:​**
 +<​code>​
 +<font size="​15">​Lieber Franz, (Schriftgröße 15)</​font>​
 +
 +wie kürzlich besprochen anbei unser Angebot.
 +
 +<​h1>​Sat Anlage (Überschrift lt. Einstellungen "​Schriftgröße Überschrift"​):</​h1>​
 +Montage und Installation einer neuen <font color="#​FF0000">​SAT Anlage (in roter Farbe)</​font>​ inkl. Receiver und Einrichtung/​Einschulung.
 +
 +Für Fragen stehe ich Dir gerne jederzeit unter <​u>​+43 676 / 84 35 36 333</​u>​ zur Verfügung.
 +</​code>​
 +
 +**Ergebnis:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_01-style3-font-h1.png|Ergebnis font Schriftgröße,​ Farbe und h1 Überschrift}}
 +
 +===== Details: Links auf Webseiten <a> =====
 +
 +Mit dem HTML Tag <a href="​...">​...beschreibung...</​a>​ lässt sich ein Link auf eine Webseite einfügen.
 +
 +**Beispiel:​**
 +<​code>​
 +<a href="​http://​www.cubic-zebra.net">​Webseite cubic zebra</​a>​
 +</​code>​
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_02-link1.png|Beispiel Links mit a-href in Angebots-Appendix}}
 +
 +**Ergebnis:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_02-link2.png|Ergebnis Links mit a-href in Angebots-Appendix}}
 +
 +===== Details: Absätze/​Abstände <p> / <br> =====
 +
 +Mit dem Tag <br> lässt sich ein Zeilenumbruch erzwingen (identisch zu einer neuen Zeile im Eingabefeld)
 +
 +Mit dem Tag <p> lässt sich ein neuer Absatz einfügen. Dies entspricht in der Standardeinstellung der doppelten Höhe eines Zeilenumbruchs (identisch zu 2 neuen Zeilen im Eingabefeld).\\
 +Zusätzlich erlaubt <p> eine Angabe der Höhe in mm mittels <p height="​Höhe-in-mm">​
 +
 +**Beispiel Absatz mit 50mm <p height="​50">:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_03-paragraph1.png|Beispiel Absatz mit 50mm in Angebots-Appendix}}
 +
 +**Ergebnis:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_03-paragraph2.png|Ergebnis Absatz mit 50mm in Angebots-Appendix}}
 +
 +===== Details: Seitenumbruch bzw. dynamischer Seitenumbruch <​pagebreak>​ =====
 +
 +Ein Seitenumbruch lässt sich mit dem Tag <​pagebreak>​ erzwingen.
 +
 +Es wird hierbei automatisch an der aktuellen Stelle eine neue Seite begonnen und der Cursor an den linken Rand gesetzt.
 +
 +Zusätzlich lässt sich der Seitenumbruch dynamisch gestalten je nach aktueller Y-Position des Cursors.
 +
 +Dies ermöglicht einen Seitenumbruch z.B. bei Erreichen von 80% der Seitenhöhe oder bei Erreichen von 160mm gemessen vom oberen Rand.\\
 +Die Einstellungen hierfür sind über das height-Attribut einzustellen - Beispiele:
 +
 +  <​pagebreak height="​80%">​ Neue Seite nur bei Erreichen von 80% Seitenhöhe
 +  <​pagebreak height="​160">​ Neue Seite nur bei Erreichen von 160mm vom oberen Seitenrand
 +  ​
 +
 +**ACHTUNG:​** Die Verwendung dieser Funktion wird nur in Angebots/​Auftrags/​Rechnungs-Felder empfohlen. Die Verwendung in Positions-Beschreibung oder Artikel-Beschreibung führt zu einer fehlerhaften Darstellung im PDF, da der Cursor für den folgenden Text direkt auf den linken Rand gesetzt wird und daher die Abstände nicht mehr korrekt sind.
 +
 +**Beispiel Allgemeine Geschäftsbedingungen Absatz auf nächste Seite wenn bei 80% der Seitenhöhe:​**
 +<​code>​
 +...
 +<​pagebreak height="​80%"><​b>​ZAHLUNGSKONDITIONEN</​b>​
 +20 Tage netto, 33% Anzahlung vor Projektbeginn falls nicht anders vereinbart.
 +
 +<​pagebreak height="​80%"><​b>​VERZÖGERUNGEN</​b>​
 +Werden Inhalte vom Kunden später als vereinbart geliefert, verzögert sich der Projektabschluss dementsprechend. Zahlungsfristen bleiben davon unbeeinflusst.
 +...
 +</​code>​
 +
 +**Ergebnis:​**
 +
 +{{:​offer-cube:​howto:​pdf-special:​offer-cube_pdf-special_04-pagebreak2.png|Beispiel und Ergebnis dynamischer Seitenumbruch bei 80% in AGB}}
 +
 +
 +===== Details: Einfügen von Bildern aus Attachments <img> =====
 +
 +Siehe: [[offer-cube:​howto:​pdf-special-variables|Einfügen von Bildern aus Attachments]]
 +
 +
 +===== Details: Objektdaten holen und über Variablen in den Text einfügen =====
 +
 +Siehe: [[offer-cube:​howto:​pdf-special-variables|Objektdaten holen und über Variablen in den Text einfügen]]