OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub
Ruby agile-developmentangularbcfboardsbug-trackerganttgantt-chartifcissue-trackerjira-alternativekanbanopenprojectproduct-managementproject-managementproject-planningroadmaprubyscrumtimelineworkflows
[#67015] Documentation: Custom font for all PDF Exports (#20173)
Andrej Sandorf00eb6eb6f1e4
diff --git a/docs/system-admin-guide/design/README.md b/docs/system-admin-guide/design/README.mdindex bfda59f151d..a41a267af4c 100644--- a/docs/system-admin-guide/design/README.md+++ b/docs/system-admin-guide/design/README.md@@ -2,18 +2,19 @@sidebar_navigation:title: Designpriority: 870-description: Custom color, theme and logo.-keywords: custom color, theme and logo+description: Custom color, theme, logo and PDF.+keywords: custom color, theme, logo, PDF---# Set custom color theme and logo (Enterprise add-on)-As an OpenProject Enterprise add-on you can replace the default OpenProject logo with your own logo. In addition, you can define your own color theme which allows you to implement your corporate identity in OpenProject.+As an OpenProject Enterprise add-on you can replace the default OpenProject logo with your own logo. In addition, you can define your own color theme which allows you to implement your corporate identity in OpenProject.-Navigate to *Administration* -> *Design* in order to customize your OpenProject theme and logo.+Navigate to *Administration* → *Design* in order to customize your OpenProject theme and logo.-The design page provides several options to customize your OpenProject Enterprise edition, grouped under three tabs, **Interface, Branding, PDF export styles**. You can [choose a color theme](#choose-a-color-theme) under any of these tabs.+The design page provides several options to customize your OpenProject Enterprise edition, grouped in four tabs, **Interface, Branding, PDF export styles and PDF export font**.+You can [choose a color theme](#choose-a-color-theme) in the first two tabs.-Under **Interface** you can also choose [custom colors](#interface-colors) for elements of the interface such as the primary button color, accent color, the background of the top navigation header and the main menu.+Under **Interface** you can also choose [custom colors](#interface-colors) for elements of the interface, such as the primary button color, accent color, the background of the top navigation header and the main menu.@@ -21,10 +22,37 @@ Under the **Branding** tab you can also [upload a custom logo](#upload-a-custom--Under **PDF export settings** you can set the preferences for [exporting work packages in a PDF format](../../user-guide/work-packages/exporting/#pdf-export).+Under **PDF export settings** you can set the preferences+for e.g. [exporting work packages in a PDF format](../../user-guide/work-packages/exporting/#pdf-export),+meetings, timesheets…++You can++* upload a logo to be used in the exported PDF header+* upload a custom background image for exports with a cover page+* adjust the text color of the text overlay at the custom background image of the cover page+* upload a design image that is placed on the left side of the footer++> [!TIP]+> You can generate a demo PDF to see a preview of your settings. Click the **Generate Demo PDF** button.++> [!IMPORTANT]+> Only PNG or JPEG images can be used in PDF exports.+Under **PDF export font** tab you can upload a font family to be used in all PDF exports (e.g. Work packages report, Gantt, Meetings, Timesheet).+The font files must be in the TrueType Font (TTF) format. Maximum font file size is 40 MB.++> [!TIP]+> You can generate a demo PDF to see a preview of your settings. Click the **Generate Demo PDF** button.+++> [!IMPORTANT]+> Only the regular style of a font family is required. Italic and bold text will be formatted in regular style of the uploaded font if these font files are omitted.+++## Choose a color themeYou can choose between the three default color themes for OpenProject:@@ -45,13 +73,11 @@ Click the *Upload* button to confirm and upload your logo.--## Set a custom favicon-To set a custom favicon to be shown in your browser’s tab, make sure you have a PNG file with the dimensions 32 by 32 pixels. Select the *Choose File* button and select the file from your hard drive to upload it.+To set a custom favicon to be shown in your browser’s tab, make sure you have a PNG file with the dimensions 32 by 32 pixels. Select the *Choose File* button and select the file from your hard drive to upload it.Then click the *Upload* button to confirm and upload your favicon.@@ -59,7 +85,7 @@ Then click the *Upload* button to confirm and upload your favicon.## Set a custom touch icon-To set a custom touch icon that appears on your smartphone’s or tablet’s homescreen when you bookmark a page, make sure you have a PNG file with the dimensions 180 by 180 pixels. Select the *Choose File* button and select the file from your hard drive to upload it.+To set a custom touch icon that appears on your smartphone’s or tablet’s homescreen when you bookmark a page, make sure you have a PNG file with the dimensions 180 by 180 pixels. Select the *Choose File* button and select the file from your hard drive to upload it.Click the *Upload* button to confirm and upload your custom touch icon.diff --git a/docs/system-admin-guide/design/openproject_system_guide_design_branding.png b/docs/system-admin-guide/design/openproject_system_guide_design_branding.pngindex 4504576dd5f..e65ea718e0d 100644Binary files a/docs/system-admin-guide/design/openproject_system_guide_design_branding.png and b/docs/system-admin-guide/design/openproject_system_guide_design_branding.png differdiff --git a/docs/system-admin-guide/design/openproject_system_guide_design_interface.png b/docs/system-admin-guide/design/openproject_system_guide_design_interface.pngindex c19fda6546f..6e36b572355 100644Binary files a/docs/system-admin-guide/design/openproject_system_guide_design_interface.png and b/docs/system-admin-guide/design/openproject_system_guide_design_interface.png differdiff --git a/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_font.png b/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_font.pngnew file mode 100644index 00000000000..476a02da581Binary files /dev/null and b/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_font.png differdiff --git a/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_styles.png b/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_styles.pngindex f70a2a6d6aa..6fe8f20e2ca 100644Binary files a/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_styles.png and b/docs/system-admin-guide/design/openproject_system_guide_design_pdf_export_styles.png differdiff --git a/docs/system-admin-guide/design/pdf-export-styles/README.md b/docs/system-admin-guide/design/pdf-export-styles/README.mdindex 480882031a7..d8075b35c19 100644--- a/docs/system-admin-guide/design/pdf-export-styles/README.md+++ b/docs/system-admin-guide/design/pdf-export-styles/README.md@@ -1,4 +1,8 @@-+---+sidebar_navigation:+ title: PDF Export Styling+keywords: pdf export styling+---# PDF Export StylingThese documents describe the style settings format for **PDF Export styling files**.diff --git a/docs/system-admin-guide/design/pdf-export-styles/attributes-and-description/README.md b/docs/system-admin-guide/design/pdf-export-styles/attributes-and-description/README.mdindex 895e60dd0f5..8aecb7dd484 100644--- a/docs/system-admin-guide/design/pdf-export-styles/attributes-and-description/README.md+++ b/docs/system-admin-guide/design/pdf-export-styles/attributes-and-description/README.md@@ -1,3 +1,7 @@+---+sidebar_navigation:+ title: Work package PDF Styling+---# Attributes and description PDFdiff --git a/docs/system-admin-guide/design/pdf-export-styles/meeting/README.md b/docs/system-admin-guide/design/pdf-export-styles/meeting/README.mdindex 3d484fdd332..bdebbd0567e 100644--- a/docs/system-admin-guide/design/pdf-export-styles/meeting/README.md+++ b/docs/system-admin-guide/design/pdf-export-styles/meeting/README.md@@ -1,3 +1,7 @@+---+sidebar_navigation:+ title: Meetings PDF Styling+---# Meetings PDFdiff --git a/docs/system-admin-guide/design/pdf-export-styles/report/README.md b/docs/system-admin-guide/design/pdf-export-styles/report/README.mdindex 9673eebe898..3ead137c6ca 100644--- a/docs/system-admin-guide/design/pdf-export-styles/report/README.md+++ b/docs/system-admin-guide/design/pdf-export-styles/report/README.md@@ -1,3 +1,7 @@+---+sidebar_navigation:+ title: Report, Gantt and Table PDF Styling+---# Report, Gantt and Table PDFdiff --git a/docs/system-admin-guide/design/pdf-export-styles/timesheet/README.md b/docs/system-admin-guide/design/pdf-export-styles/timesheet/README.mdindex 1d52d3902f0..15a85379fda 100644--- a/docs/system-admin-guide/design/pdf-export-styles/timesheet/README.md+++ b/docs/system-admin-guide/design/pdf-export-styles/timesheet/README.md@@ -1,3 +1,7 @@+---+sidebar_navigation:+ title: Timesheet PDF Styling+---# Timesheet PDF