This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Configuration

How to configure PageJinn

In addition to the actual software, a configuration file config.json is written to the PageJinn home directory (by default, the user’s Documents folder) during installation:

/Users/[username]/Documents/PageJinn/PAG/config.json

The configuration file contains default settings that affect the behavior of PageJinn. You will probably need to change some of the settings, such as the path to your K4 system and user and password, before PageJinn is ready for use.

You can change the configuration file by hand. However, all important and necessary settings for operation can also be made within PageJinn.

1 - Configure PageJinn

Configuration via GUI.

If PageJinn cannot connect to the K4 system because the access data is not stored in the configuration file or is invalid, the PageJinn settings area is automatically displayed.

You can also show the window at any time by clicking on the gear icon.

prefs



Preference Meaning
API-User A K4 user with Admin rights for all publications
Password Password of the API User
K4 Server Address The URL of the K4 System
Show issues of last years: Display issues of the last n years
Write Log file A log file will be written inside a folder PageJinnLogs within the home directory of PageJinn
Allow user to zoom If activated, it is possible to zoom in and out
Show layout name with PageRange Der Seitenbereich eines Layouts wird mit in den Namen des Dokuments geschrieben



Make changes if necessary. If you click Save, the values are written to the configuration file and are permanently available, otherwise only for the current session.



2 - Template file

Creating a Template File

PageJinn requires access to an InDesign template file to display and create InDesign pages for each publication.

This template file (.indt) must be located locally in the PageJinn/PAJ directory. See directories).

However, you should keep this file in the K4 system. Check in an InDesign file as a template named PageJinn into the K4 template issue. This file should contain only one page and should contain a sample page for each section you use. Also make sure that there are no missing fonts in this document.

If PageJinn does not find a local .indt file at startup, it will try to download the PageJinn template file from the K4 system. From the information in the file (height, width, sample pages), an additional template.json file is created

If you subsequently change the K4 template file, for example to create new master pages, click Update Template in PageJinn afterwards.

3 - Configuration File

Description of the Configuration File.

A configuration file is automatically created when PageJinn is installed. The entries necessary for functionality can be made via the GUI. If you change this file manually, consider the json format.

Example of a Configuration File:

{
"PAGKEY":"U2FsdGVkX1854bQMq5zpFXrQkFabckQHKI/Z7Yv36fo=",
"DEBUG":true,
"APILog":true,
"hideAfterCheckout":false,
"advancedWorkFlow":true,
"LayoutNameWithPageRange":false,
"InDesign":"Adobe InDesign 2021",
"showLayoutNameInStatusBar":false,
"K4Version":"10",
"homeDir":"~/Documents/",
"bgColor":"#aabbcc",
"serverAddress":"http://127.0.0.1:9090/K4Server",
"apiuser":"PageJinn",
"apipw":"k4",
"apiremember":false,
"enableUserZoom":false,
"issueYearsToDisplayBeforeCurrent":"1",
"monthNames":["Januar","Februar","März","April","Mai","Juni","Juli","August","September","Oktober","November","Dezember"],
"dayNames":["Sonntag","Montag","Dienstag","Mittwoch","Donnerstag","Freitag","Sonnabend"],
"dueDateName":"Due Date",
"showDueDate":true,
"nameView":"name",
"NFR":false,
"1332490595545":
{"mdId":153,"mdType":2,"mdColor":"rgb(0,255,0)"}
}
Config name Meaning Note
PAGKEY The license key you receive when you buy PageJinn
DEBUG Set this to true to have PageJinn write a Log file
APILog Logging of the API functions
hideAfterCheckout Hides the PageJinn window after Check-Out of documents not currently active
advancedWorkFlow Is K4 Advanced Workflow for Layouts active?
LayoutNameWithPageRange The page range will be written into the Layout name
InDesign The used InDesign version
showLayoutNameInStatusBar Should the name of the Layout be displayed
K4Version The used K4 version Only needed for API functions, all version starting from K4 10 are supported
homeDir The folder with the PageJinn customer data including this config file
bgColor The background color of PageJinn
serverAddress The URL of the K4 System
apiuser A K4 user with Admin rights This User must have access rights for all publications you want to manage with PageJinn
apiremember The password for the apiuser
enableUserZoom Allow user to zoom in and out We recommend to leave this set to false
issueYearsToDisplayBeforeCurrent The number of years to go back from the current to display issues
monthNames The names of the months used in the header currently deactivated
dayNames The names of the week days used in the header currently deactivated
dueDateName The name for the dueDate currently deactivated
nameView This enty indicates which which information is displayed in the name field set automatically by PageJinn
NFR Is there a NFR key? This will bring up additional functions. You need a valid NFR key to use this
1332490595545 K4 publikation Id This entry will be written by PageJinn automatically. Do not change it!