gn4 adobe plug-ins...a valid gn4 plug-in licence has to be purchased for each of the relevant adobe...
TRANSCRIPT
2018
GN4 Adobe Plug-Ins UP TO PLUG-IN V5.7
REFERENCE GUIDE
APRIL 2018
PAGE 2
GN4 ADOBE PLUG-INS
Contents Installation and Database Configuration ....................................................................................................... 7 Assumed knowledge to use this document .................................................................................................. 7 About the GN4 Adobe Plug-Ins ..................................................................................................................... 7 Prerequisites.................................................................................................................................................. 7 Installation of the Plug-In .............................................................................................................................. 7 UserConfig for the Plug-In GN4 Connectivity ................................................................................................ 8 The GN4 InDesign Plug-In Palette ................................................................................................................. 9 Introduction .................................................................................................................................................. 9
Logging In ..................................................................................................................................................... 9
Disabling Tabs from Users View .................................................................................................................. 10 Editions Tab ................................................................................................................................................. 11
Opening an InDesign Document ................................................................................................................11
Checking out an InDesign Document to use Offline..................................................................................11
Add Current InDesign Document into GN4 ................................................................................................11
Creating InDesign documents from existing Fred documents and/or InDesign ......................................12
Template Editions ......................................................................................................................................12
Creating the InDesign Template for use with the InDesign Plugin ............................................................14
Copying the selected items .......................................................................................................................17
Advertising Layer ........................................................................................................................................17
Manually adjusting page numbers and number of pages in the document ............................................18
Import Selected Shape ...............................................................................................................................18
Folders Tab .................................................................................................................................................. 19 Generic Tab Tree Contents Results and Pane Views for all Tabs ...............................................................19
Grid Selection Pane Preview Display ..........................................................................................................20
Taskbar Item Command Icons ....................................................................................................................20
Generic Hide Columns in all Tabs ...............................................................................................................21
Displayable Columns in all Tabs .................................................................................................................21
Generic Moving, Resizing and Sorting Columns in all Tabs ........................................................................22
Generic Hiding or Resizing of Tree, Grid List or Preview Panes for all Tabs ..............................................23
Preview Pane extDoc JPEG Thumbnail Size ................................................................................................23
Filtering the Display within a Tree or Preview Pane for all Tabs ................................................................24
Configuring Import types for Image Mime types .......................................................................................24
Search Tab ................................................................................................................................................... 25 Assigned Tab ............................................................................................................................................... 26
Placing Articles or Stories onto Page (extDoc) Documents .......................................................................26
Replacing Page Content on Page Documents ............................................................................................26
Automated creation of Articles from Stories ............................................................................................27
PAGE 3
GN4 ADOBE PLUG-INS
Automated creation of Editorial Images from Wire Images ............................................................................27
Items Tab ..................................................................................................................................................... 28 Jumps Tab .................................................................................................................................................... 29
Placing a Pending Jump from the Jumps Tab into a Document ................................................................29
Your Tasks Tab ............................................................................................................................................. 31 Tasks Tab ..................................................................................................................................................... 32
Creating a new Task ...................................................................................................................................34
Editing an existing Task ..............................................................................................................................34
Adding Selected Page Items to an existing Task ........................................................................................35
Uploading Content to an existing Task ......................................................................................................35
Copying an existing Task ............................................................................................................................35
Displaying Task Products linked to a Task ..................................................................................................35
Web UI Tab .................................................................................................................................................. 36 The GN4 Offline InDesign Plug-In Palette ................................................................................................... 37 The GN4 InDesign Plug-In Menu Options .................................................................................................... 37 Editing Text .................................................................................................................................................. 37 Editing Pictures ........................................................................................................................................... 38 Importing Items on a Page Document into GN4 ........................................................................................ 38 Assigning Types to InDesign Boxes ............................................................................................................. 38 Setting the Document Workstate ............................................................................................................... 39 Creating PDF’s of Page Documents ............................................................................................................ 40 InDesign Box Type Labels ............................................................................................................................ 40 InDesign Folio Markers................................................................................................................................ 41 Article Mode ................................................................................................................................................ 41 Auto Checkout ............................................................................................................................................. 41 Document Complete Function ................................................................................................................... 42 Remove Content from Document .............................................................................................................. 43 Spike Content from Document .................................................................................................................... 43 Creating Titles/Editions/Zones and Pages and Importing Advertising Plans .............................................. 43 Jump Stories ................................................................................................................................................ 44
Creating a Jump ..........................................................................................................................................44
Creating a Known Page Jump .....................................................................................................................45
Reflowing a Jump .......................................................................................................................................45
Removing a Jump .......................................................................................................................................46
The Continued On/From Jump Templates and GN4 Jump Configuration ..................................................46
Sending Articles onto Other Folders ........................................................................................................... 49 Configuring the Copy Flows in GN4 ............................................................................................................49
Preflight Profiles .......................................................................................................................................... 50 Not In GN4 ..................................................................................................................................................50
Reflow Check ..............................................................................................................................................51
Utilities ........................................................................................................................................................ 52 Disabling All Boxes from GN4 Import .........................................................................................................52
PAGE 4
GN4 ADOBE PLUG-INS
Disabling Graphic Boxes from GN4 Import ................................................................................................52
Disabling Text Boxes from GN4 Import ......................................................................................................52
Select First Import ......................................................................................................................................52
Update On Open ......................................................................................................................................... 52 Check in Offline Document ............................................................................................................................ 52 The GN4 Photoshop Plug-In ......................................................................................................................... 53 Introduction ................................................................................................................................................ 53
Logging In and Out .....................................................................................................................................53
Opening an Item to Edit .............................................................................................................................53
Add Current Open Image Document into GN4 ..........................................................................................54
Photoshop Plug-In Menu Options ............................................................................................................... 54 The GN4 InCopy Plug-In ................................................................................................................................ 55
Introduction ...............................................................................................................................................55
Logging In and Out .....................................................................................................................................55
Opening an Article ......................................................................................................................................55
Creating an Article ......................................................................................................................................56
Creating an Article linked to a Task ............................................................................................................57
InCopy Plug-In Menu Options ...................................................................................................................... 57 Auto Checkout ............................................................................................................................................57
Jump Reflow ...............................................................................................................................................57
Linked Labels ..............................................................................................................................................58
Copy Flow Send to Other Folder Options ..................................................................................................58
The GN4 Premiere Plug-In ............................................................................................................................ 59 Introduction ...............................................................................................................................................59
Importing an Item into a Project ...............................................................................................................60
Premiere Plug-In Menu Options ................................................................................................................. 60 GN4XMLCommand Script Support .............................................................................................................. 61
Introduction ...............................................................................................................................................61
Formats ....................................................................................................................................................... 61 Input XML format .......................................................................................................................................61
Result XML format......................................................................................................................................61
Commands .................................................................................................................................................. 61 CreatePagesInEdition .................................................................................................................................61
CreatePage .................................................................................................................................................61
UpdatePage ................................................................................................................................................61
OpenPage ...................................................................................................................................................61
Login ...........................................................................................................................................................62
PAGE 5
GN4 ADOBE PLUG-INS
PlaceURI .....................................................................................................................................................62
GetURI ........................................................................................................................................................62
DocumentComplete ...................................................................................................................................62
Support for InDesign Server ........................................................................................................................ 63 Triggers ........................................................................................................................................................ 63 Desktop version of InDesign ....................................................................................................................... 63 GN4InDesignServer.dll functions ................................................................................................................. 63
UpdateExtDoc ............................................................................................................................................63
CreatePageWithTemplate ..........................................................................................................................64
CreateEditionWithTemplate ......................................................................................................................64
CreatePage .................................................................................................................................................64
CreateEdition..............................................................................................................................................64
RunServerCommand ..................................................................................................................................64
UpdateExtDocLocal ....................................................................................................................................64
CreatePageWithTemplateLocal .................................................................................................................64
CreateEditionWithTemplateLocal ..............................................................................................................64
CreatePageLocal.........................................................................................................................................64
CreateEditionLocal .....................................................................................................................................64
RunLocalCommand ....................................................................................................................................64
The Fitting Palette Plug-In ........................................................................................................................... 65 Introduction ...............................................................................................................................................65
Configuring the Adjustments .....................................................................................................................65
The Back-End Plug-In ..................................................................................................................................66
Palette Buttons and Adjustment Value ...................................................................................................... 66 Fit Text to Box ............................................................................................................................................66
Undo Fit Text to Box ..................................................................................................................................66
Retrieve Fitting Descriptions ......................................................................................................................67
The Right Click Menu ................................................................................................................................... 67 Fitting Palette Plug-In Caveats .................................................................................................................... 67
The Descenders of the Last Line of Text ...................................................................................................67
Deciding Whether Adjustments are Necessary and if a Box is Full ...........................................................67
Editing the Configuration File ....................................................................................................................67
Moving Between Adobe Applications .........................................................................................................67
The InDesign Rule Palette Plug-In ............................................................................................................... 68 Introduction ...............................................................................................................................................68
Palette Rule Buttons and Configuration Parameters ................................................................................. 68 Palette Buttons ...........................................................................................................................................68
PAGE 6
GN4 ADOBE PLUG-INS
Palette Configuration Parameters ..............................................................................................................68
PAGE 7
GN4 ADOBE PLUG-INS
Installation and Database Configuration Assumed knowledge to use this document This document assumes that the reader already has knowledge of Tera GN4, its various applications such as Ted4, Fred4, Shell4, EdAdmin4 and Admin4 and the various browser-based user and configuration applications software.
It is also assumed that the reader already has knowledge of the Adobe software products that the Plug-In functions within. Reference to Miles 33 FutureProof Editorial Module qScribe Tools User Guide may assist with the Fit Text and Rules palettes. About the GN4 Adobe Plug-Ins The GN4 Plug-In adds a menu panel and palette to Adobe InDesign, InCopy and Photoshop for versions CS6, CC2014, CC2015, CC2017 and CC2018. Premiere Pro CS6, CC, CC 2015.3, CC 2017 and CC 2018. Illustrator CC2014 and above. No other versions of Adobe software are catered for currently. To see the Plug-Ins version number go to Help>About Plug-Ins>GN4. All CC2014 and above is supported with a different interface, this uses the I4 interface. Prerequisites A valid GN4 Plug-In licence has to be purchased for each of the relevant Adobe applications. For further details contact your Account Manager or Distributor. Installation of the Plug-In There is a single installer com.Miles33.GN4.zxp (version 5.1) for the plug in which installs into all supported products.
First, uninstall any existing GN4 Plug-In’s with the Adobe Extension Manager.
PAGE 8
GN4 ADOBE PLUG-INS
The Plug-In is in a .ZXP file which is installed with the Adobe Extension Manager. Select File>Install Extension and select the .ZXP file. You will need to restart the Adobe application(s) if they were already running.
If the extension manager CC has been updated with the release of CC2015 the install of the plugin will need to use the 'ExMan Command Line Tool' to install the plugin for InDesign CC, CC2014.
More info on the 'ExMan Command Line Tool' and the download link at the https://www.adobeexchange.com/resources/28 Run the following command to install com.Miles33.GN4.zxp
[mac] ./Contents/MacOS/ExManCmd –-install com.Miles33.GN4.zxp [win] ExManCmd.exe /install com.Miles33.GN4.zxp Server install for CC2014 and above. On the server the following web apps need to be created under the I4 installed web app in IIS. These sub web apps need to point to the same folder as I4.
The config will also need to be added for each web app in the form I4<webname>Config.xml.i.e. I4PHXSConfig.xml
Web apps: • AICY • IDSN • ILST • PHXS • PPRO
UserConfig for the Plug-In GN4 Connectivity The UserConfig file establishes which Tera GN4 systems the Plug-Ins can connect to. UserConfig file is an .XML file residing in C:\Documents and Settings\username\Application Data\TeraDP\GN4\UserConfig.xml on Windows XP or C:\users\username\AppData\roaming\TeraDP\GN4\UserConfig.xml on Vista and Windows 7. The Macintosh path is Users:username:Library:Preferences:TeraDP:GN4:UserConfig.xml for CS6 and CC, for CC2014 and above the path is Users:username:Library:Application Support:TeraDP:GN4:UserConfig.xml Please note the connection for CC2014 and above must use I4 and for CS6 and CC the connection has to be GNPortal(old web interface) The .XML file lists the system names and the path to the server to connect to and the username to connect as. An example .XML file contents are: <?xml version="1.0"?> <UserConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" SchemaSourceDirectory="C:\temp" ClientSpecId="0" SaveUserPwd="true" xmlns="http://www.teradp.com/schemas/GN4/1/UserConfig.xsd"> <Connections> <Connection Name="local" Url="http://localhost/I4" UserName="" Domain="" RequireLogin="true" /> <Connection Name="sqlwin64" Url="http://sqlwin64/I4" UserName="" Domain="" RequireLogin="true” /> </Connections> </UserConfig> This sample has two GN4 system connections: local and sqlwin64.
PAGE 9
GN4 ADOBE PLUG-INS
The GN4 InDesign Plug-In Palette Introduction Logging In To login to GN4 the palette needs to be opened from the Windows>Extensions>GN4 menu. If you are not already logged in a drop down server choice (from the GN4 UserConfig file), user name and password and a login button are displayed. If you are already logged in and you open the panel the last state is recovered.
When you login a check of the version of the server is made and if the server version is too low for the Plug-In software to connect with an error is displayed. The minimum server version of GN4 required will alter as features are added to the Plug-Ins (see Tera website for current minimum server version). If your username and/or password are not valid then an appropriate error dialog will be displayed. If the login times out due to no or slow inaccessibility the error dialog below will be displayed:
If this occurs then the user can select OK and try again. If the login attempt(s) continue to time out you will need to consult with your System Manager.
PAGE 10
GN4 ADOBE PLUG-INS
Disabling Tabs from Users View There is a GN4 configurable User/User Group Parameter Tab with named option adobePlugInDisabledTabs. This lists the tabs which are to be hidden from the user or user group. The Tab names are:
• editionsTab – Editions Tab • foldersTab – Folders Tab • searchTab – Search Tab • assignedTab – Assigned Tab • itemsOnPageTab – Items Tab • pendingJumpsTab – Jumps Tab • yourTasksTab – Your Tasks Tab • tasksCalendarTab – All Tasks Tab • fullWebUITab - Web UI Tab
Add all the tabs you want to hide to the parameter separated with ';' i.e. to hide the Web UI and the search tabs enter fullWebUITab;searchTab. Whichever tabs are disabled, they apply to the Plug-In for all Adobe applications (i.e. InDesign, Photoshop, InCopy and Premiere).
PAGE 11
GN4 ADOBE PLUG-INS
Editions Tab
Tabs
Tabs tree/palette dialog pane
Tree contents results grid pane
Grid selection preview pane
Taskbar Item Command Icons This tab shows the extDocs (InDesign and Fred documents). The titles and editions are listed in a tree. Select the edition from the tree and the list of extDocs in that title/edition are shown. When an extDoc is selected its preview is shown.
To limit the number of editions shown in the title there are two user/group parameters called 'inDesignPlugInEditionLastDays' and 'inDesignPlugInEditionNextDays'. If both are unset then all editions are shown. If either is set then the tree limits the editions to the last and next days. So if one is set the other defaults to 0. Also if either of these is set the option to show editions and template editions together is removed.
From GN4 2.3 there is a new option to set at title level if the text and/or graphic boxes are marked as disabled for import when the document is saved. To set at title level the user will need the user/group option ‘inDesignPlugInOptions’ set to true.
The Edition tab preview panel can also show the audit trail of the selected items. The panel has two tabs, one for the preview and the other for the audit trail.
Opening an InDesign Document To open an extDoc double-click on its row or select it and press enter. If the extDoc is locked it will ask if you want to open the page in Article Mode. A progress bar will run whilst the document is opening. There is an edit properties button to edit the selected items properties.
Checking out an InDesign Document to use Offline Select the InDesign documents to be used offline, and then press the ‘check out for off line editing’ icon . This will check out the document and open the checked out version. These files are downloaded to the user documents folder in a folder typically called ‘Miles_33_GN4’. Note: The user will need a client specification setup for them, otherwise it will not work.
Add Current InDesign Document into GN4 To add an InDesign document into GN4 from InDesign, select the edition tab and choose the edition you would like the document to be placed in and press the import active document button at the bottom of the edition tree.
PAGE 12
GN4 ADOBE PLUG-INS
This will open a window which will allow the choice of section, zone and booklet (Booklet is only for GN4 2.4 and above). Only InDesign documents that have been saved can be uploaded; attempting to upload a new unsaved document will generate an appropriate error message.
When the document has been added it will close the current document and open the one that was added to GN4. The name of the extDoc defaults to the page number. The ability to add pages is disabled by default. To enable this feature set the GN4 user/group parameter called inDesignPlugInEnabledImport to TRUE.
If the document being uploaded to the system contains text boxes with content in, they will by default be set to a box type of Disable Import so that once the document has been added it can be opened and closed without the user being forced mark the types of text boxes throughout the document (and then having to import content into the GN4 system if the box type is not set to Disable Import). This enables a template document containing standing matter text boxes to be uploaded to the GN4 system and used without excessive initial manual user intervention.
To alter the default state of setting text boxes with content to disable import alter the AutoMarkNonEmptyTextBoxes parameter in the \Global\GN4\InDesignConfig.xml configuration file to false.
<InDesignConfig LinkPing="10000" ArchivePDFVariantName="PDF_[Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" SendToNewsroomFolderPath="/Wires" AutoMarkNonEmptyTextBoxes="true">
</InDesignConfig>
The false setting will force the user to have to label the box types for all boxes containing content once the document has been uploaded to the GN4 System.
Boxes containing content marked with a type other than Disable Import must always have the content imported into the GN4 system regardless of the AutoMarkNonEmptyTextBoxes setting being set to true or false. Creating InDesign documents from existing Fred documents and/or InDesign Template Editions InDesign extDoc’s can be generated from existing Fred documents and/or InDesign Template Editions. Either a single page document or a whole Edition of page documents can be created. To enable this feature set the GN4 user/group parameter called inDesignPlugInEnabledImport to TRUE.
PAGE 13
GN4 ADOBE PLUG-INS
To create a whole Edition of InDesign page documents from an Edition of Fred documents or an extDoc Template Edition, select an Edition in the Editions Tab tree and click on the Create all InDesign Pages
from the pages in the selected edition icon . A dialog box requesting which Template Edition to use is displayed:
Select the required Template in the drop-down list. Selecting Cancel will cease the operation; selecting OK will create InDesign documents. If an InDesign document already exists in the Edition for that page folio, running this function will NOT recreate or overwrite the document again. If the document is required to be re-created then the existing InDesign document must be deleted first. If there are existing Template Edition documents (of extDoc format) for the Title you must choose which one you want to utilise. If there aren’t any Template Edition documents available for the Title then an extDoc is created using the Fred Pages Master page. Both Editorial and Advertising Layers are created from this document. If the chosen Template Edition document contains a page name folio matching that of the Fred page folio (i.e. Page 6) then the Template Edition document (extDoc) is used to create the page documents dimensions and Editorial Layer but the Advertising Layer is created from the Fred page. If the chosen Template Edition document doesn’t contain a page name matching that of the Fred page (i.e. Page 6) but does have a Master page name matching that of the Fred pages Master page name (i.e. LEFT), then the two matching Master page(s) are used to create the Editorial Layer (from the Template Edition Master extDoc) and Advertising Layer (from the Fred Page Master page) respectively. If there are no matching Master page names between the Template Edition document and the Fred page then the Fred pages Master page is used to create the Advertising and Editorial Layers. If any Fred document used to create an extDoc page has Editorial or standing material on it, this content is not transferred onto the created InDesign document. Only the Advertising Layer content can be inserted from a Fred page when an InDesign document is created.
PAGE 14
GN4 ADOBE PLUG-INS
The logic used for the creation function is below:
Request to create extDoc
Are there extDoc Template No Editions for this Title?
Yes
Use the matching FRED Page Master
name page to create the extDoc’s
Advertising Layer content but use
the matching name Template Edition
extDoc Master page for the extDoc’s dimensions and
standing Editorial content
Yes
Select one of the extDoc Template Editions from the drop down list
Does the Selected extDoc Template Edition for the Title have the requested folio in it?
No
Does the Selected extDoc Template Edition
for the Title have a Master page name matching the corresponding FRED Pages
Master name?
No
Use the corresponding FRED Master page to create the extDoc’s dimensions and import
its Advertising Layer content
Yes
Use the corresponding folio
FRED page to create the extDoc’s Advertising Layer
content but use the Template Edition
extDoc folio for the extDoc’s
dimensions and standing Editorial
cont
Creating the InDesign Template for use with the InDesign Plugin The InDesign Template only needs to match the Master Pages of the equivalent Fred Template. Therefore for a basic template only a Left, Right, Frontpage and Double are required that matches the master Fred Masters. An example of such a template is shown in the screen shot below.
To create this template we need to create an InDesign document that contains the relevant master pages configured with any required layouts/grid, page furniture and folios.
PAGE 15
GN4 ADOBE PLUG-INS
The screen shot above shows an example of such a document where all the required master pages have been set up. To upload this for use with the InDesign Plugin we start by creating a basic Fred Template Edition. This can have only one page as per the example in the following screen shot.
When we are ready to upload the master pages for our InDesign Template we must make sure that only the relevant page(s) are present for the specific Master Page. We must also make sure that the document has been saved. In the following example you can see that the page to be uploaded is a ‘Left’ hand side page.
To upload the Left Master Page click the upload icon and the window on the left will appear.
As the Master Page we wish to upload is a ‘Left’, key in ‘Left’ into the Name field as shown above. Select the ‘Section’ if applicable and also the ‘Zone’, in our case this is ‘Life etc.’ and then click the ‘OK’ button. This process needs to be repeated for each Master Page you wish to upload.
PAGE 16
GN4 ADOBE PLUG-INS
Please note that it is important to remember to save the source InDesign Document prior to each upload. It is also a good idea to insure that the ‘Section Prefix’ and ‘Section Marker’ fields under ‘Numbering & Section Options...’ for the InDesign Master Page are blank. See the following screen shot which shows how the ‘Numbering & Section Options...’ window should look.
When an extDoc created in this way is subsequently opened the Advertising Layer will be always be updated to that of the corresponding Fred page. Double clicking on a single Fred page document in the Tree contents results grid pane listing can optionally allow the creation of a corresponding single InDesign extDoc page document. A dialog box will be displayed to select the Template Edition to be used:
Select the required Template in the drop-down list. Selecting Cancel will cease the operation; selecting OK will create a single InDesign document in InDesign using the same logic as the option to create the entire Edition. As only a single page document is created, this function will additionally open the document in InDesign once it has been generated.
PAGE 17
GN4 ADOBE PLUG-INS
Copying the selected items Using the copy the selected item icon the user can highlight a list of InDesign pages (extDoc) in the Grid Pane and copy them to be another page document. The Copy Document dialog will be presented for the user to enter the required Edition, Section, Zone, Booklet (Booklet is only shown for GN4 2.4 and above), Page number (only shown if a single item is selected) and Copy Articles of the new document that will be generated from the original. The Copy Articles allows the articles in the document to be copied adding a prefix to their new article names. If an article of the name exists it is over written. Also, if there are any jumps on the page the jump part is only used.
Advertising Layer
When an extDoc is opened via the Plug-In, the latest saved Advertising Layer Layout is always uploaded with the document, even if this overlays page document content that was already present before the advertising layer layout change.
PAGE 18
GN4 ADOBE PLUG-INS
The Advertising Layer is locked and the default colour for advert blocks to display is magenta. The default colour can be altered by editing the config element ColourForMissingAdverts parameter in the InDesignConfig.xml file: <InDesignConfig LinkPing="10000" ArchivePDFVariantName="PDF_ [Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" /> The number following the parameter is the RGB colour code as an integer and not hexadecimal. Manually adjusting page numbers and number of pages in the document
If the folio is manually altered using the InDesign function (Layout>Numbering & Section options…) or the number of pages in the document is added to via the InDesign Pages Palette, the manual alterations are honoured and saved providing the user has the InDesignPlugInEnabledImport option set to true. If this option is set to false then an error will result on saving the document:
In the example above, page 2 had its folio altered by a user with the false setting and attempted to save the document. Import Selected Shape To import the selected shape to be used in Fred, select the title of the library where the shape will be added to. Select the shape on the page, pages does not have to be open from GN4. Then press the import library icon, this will show a dialog to select the library and the name of the shape to import.
Please note that the text boxes need to be marked before import.
PAGE 19
GN4 ADOBE PLUG-INS
Folders Tab This has the folder tree. Select a folder and the contents of the folder are displayed.
Generic Tab Tree Contents Results and Pane Views for all Tabs Result views are used in the Folders tab, Search tab, Jumps tab and the Assigned tab. There are multiple views dependent on what object types are in GN4 and which tab is selected. Only one view is shown at a time. The view is chosen with the icons at the bottom of the panel; one view for articles, imgs, articles and imgs, img thumbnails grid, images or images thumbnails grid. The currently selected view is highlighted by the icon being surrounded by a yellow background. All the content of the appropriate type in the folder is displayed. It might take considerable time to display or refresh the list if the number of items in the folder is extremely large
When the item is selected the contents preview is shown in the Grid Selection Preview Pane. The Thumbnail grids do not have a preview as the preview is displayed in the Tree Contents Results Grid Pane. Hovering the cursor over content in the Tree Contents Results Grid Pane for all content types will produce a tell-tale of the contents meta-data.
PAGE 20
GN4 ADOBE PLUG-INS
Grid Selection Pane Preview Display The Grid Selection Pane Preview Display configuration can be altered by altering the relevant GN4 feed XML configuration files. The display can be configured differently for both the InDesign and Photoshop palettes. The PhotoshopConfig.xml and InDesignConfig.xml configuration files contain pointers to which GN4 Preview feed files to utilise. An example of the relevant part of an InDesignConfig.xml file is show below: <InDesignConfig LinkPing="10000" ArchivePDFVariantName="PDF_[Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" SendToNewsroomFolderPath="/Wires" AutoMarkNonEmptyTextBoxes="true" KeepAlivePing="120000" ThumbnailHeight="96.0" EditionPreview="EditionElements" ItemPreview="Display" TaskPreview="DisplayPlanning"> In the example, the preview definition for the grid content in the Edition Tab is configured in the EditionElements.xml file; the preview definition for the grid content in the Item Tab is configured in the Display.xml file and the preview definition for the grid content in the Task Tab is configured in the DisplayPlanning.xml file. Taskbar Item Command Icons Commands for the selected item vary depending on the tab and/or the application the Plug-In is being utilised in, but include:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
1 - Articles List 2 – Editorial Images List 3 - Articles and Editorial Images List 4 - Editorial Images Thumbnail Grid View 5 - Images List 6 - Images Thumbnail Grid View 7 - Story List (not Articles) 8 - Refresh 9 - Place selected item into the current selected boxes (in InDesign only) 10 - Start the copy flow for the selected items 11 - Send back selected items to previous copy flow 12 - Send on selected items to next copy flow 13 – Edit the properties of the selected item 14 - Assign the selected item to a page, edition, zone, booklet (Booklet is only for GN4 2.4 and above)
or title 15 - Move selected item 16 - Delete the selected item 17 - Unlock the selected item 18 - Publish the selected item 19 - Republish the selected item 20 - Un-publish the selected item 21 - Show More 22 - Display GN4 Editions only 23 - Display GN4 Templates only 24 - Display GN4 Editions and Templates 25 – Import Active Document into selected Edition (InDesign extDocs only) 26 – Create all InDesign Pages from the pages in the selected edition (InDesign only) 27 – Edit the document complete options for this title 28 – Display extDoc’s (InDesign documents) only
PAGE 21
GN4 ADOBE PLUG-INS
29 – Display documents (GN4 Fred documents) only 30 – Display both extDocs and documents (InDesign and GN4 Fred documents) 31 – Copy the selected Item 32 – Check out the document for offline editing 33 - Create a new task 34 – Copy selected task 35 - Add selected items to the selected task 36 – Upload content to selected task 37 – Create a new GN4 article in the selected folder (in InCopy only) 38 - Open all the Jump sequences into one Article for editing (in InCopy only) Some of these features are GN4 functions and appear in the GN4 documentation. Generic Hide Columns in all Tabs To hide a column, select RIGHT+CLICK+SHIFT on the column heading. To show columns (this will show all columns) RIGHT+CLICK+ALT on the grid.
Displayable Columns in all Tabs The columns available to display vary depending on the tab and/or the application the Plug-In is being utilised in, but include:
• Document, Image and Article Name • Document, Image and Article Workstate • Document, Image and Article Modified Date • Document, Image and Article Link Status (Adobe Link feature status) • Document, Image and Article Last Modifier (Username) • Documents Section • Documents Zone • Documents Booklet (Booklet is only shown for GN4 2.4 and above) • Document, Image and Article Checkout Status (Username of user who has object checked
out) • Documents First Page (Folio) Number • Documents Number of Pages (multi-page document) • Document, Image and Article Type and Filters • Document, Image and Article Path (path to folder the content resides in) • Document Linked to • Article Body Words and Characters Count • Article and Image Types Checked out (which username has which object checked out) • Article Author • Article and Image Width and Height • Jump Part Sequence Number • Jump Part Words Estimate • Jump Part Characters Estimate • Jump Part Known Destination Pending Jump Page Number • Jump Part Linked to Page • Jump Part Last Modified Date and Modifier • Jump Part Check Out Status • Jump Part Article Title
PAGE 22
GN4 ADOBE PLUG-INS
• Jump Part Article Author • Image’s Thumbnail • Image’s Article Title • Task Title • Task Due Date • Task Workstate • Task Assignee • Task Kind • Task Calendar Path • Copied To (Story to Article automated object copy data)
Generic Moving, Resizing and Sorting Columns in all Tabs Columns in the Tree Contents Results Grid Pane can be moved, re-sized and sorted to produce the desired display. To move columns either left or right, click on the column header and hold the left mouse button down whilst you move the mouse left or right. Whilst you are in this mode the column to be moved will be greyed out and a blue line will indicate where you will be moving the selected column to. When you release the mouse button the column will drop into the appropriate position.
To re-size a column width, move the mouse to the column header edge until the double line with arrows symbol appears. Now you can click and hold the left mouse button down and move the mouse either left or right to shorten or lengthen the column width as appropriate.
To sort on a column, click the left mouse button on the column header. This column now becomes the active sort column. There is only one active sort column at a time. Clicking on the column header once produces either an ascending or descending sort on that column (the last sort state that was used on that column) and clicking a second time on the same column header will reverse the sort. The ascending or descending nature of the sort is designated by the direction of a black triangle that appears in the column header. The example below shows a sort on the Modified Date column, with the latest time and dates appearing to the top of the sorted listing. Clicking on another column header will now make this column the active sort column.
Note that sorting on the Name field within the Edition tab will actually sort on the section name, then zone name then page number field to achieve its sort rather than alphabetically on the page name itself. This will enable more sensible ordering of pages based on their position within the product.
PAGE 23
GN4 ADOBE PLUG-INS
Generic Hiding or Resizing of Tree, Grid List or Preview Panes for all Tabs To resize the tree view pane, grid list pane or the preview pane just click on the divider bar between the tree/grid panes or grid/preview panes and the bar can be moved to the left or right (or up and down if it is a vertical split) to resize.
If you double-click on the bar between the tree/grid panes the bar will move to the extreme left (or up) and remove the tree pane. To show the tree pane again, click on the dividing bar and the tree pane will return. If you double-click on the bar between the grid/preview panes the bar will move to the extreme right (or down) and remove the preview pane. To show the preview pane again, click on the dividing bar and it will return. Preview Pane extDoc JPEG Thumbnail Size The size of the extDoc JPEG Thumbnail in the Preview Pane defaults to 96 pixels in height, but it can be altered by editing the ThumbnailHeight value in the InDesignConfig.xml file which is located, generally, in the fileservers tera\gn4\main\config\global\gn4 folder.
An example of this section of an InDesignConfig.xml file is:
ThumbnailHeight The height of the thumbnails, if 0 then it is the same size as the page. default 96.0
--> <InDesignConfig LinkPing="10000"
ArchivePDFVariantName="PDF_ [Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" SendToNewsroomFolderPath="/Wires" AutoMarkNonEmptyTextBoxes="true" KeepAlivePing="120000"
InDesignConfig> ThumbnailHeight="96.0">
Note the feature for setting the Thumbnail of the extDoc JPEG to the exact size of the document. The definition details the height of the Thumbnail produced; the width of it will be generated proportionally in the ratio of that of the extDoc itself. The control is only for generated JPEG Thumbnails of the extDoc, it does not control the Thumbnail size of images or PDF’s of extDocs.
PAGE 24
GN4 ADOBE PLUG-INS
Filtering the Display within a Tree or Preview Pane for all Tabs Some of the Taskbar Command Icons act as filters, displaying only the selected item type.
Examples and options exist in editions, page document and story components.
Where the icons act as filters (such as the example below) the active viewing filter is highlighted with a yellow background.
Configuring Import types for Image Mime types Some image mime types may require to be a file-based import and some require a stream-based import, other types can be either. By default the system uses a stream- based import but the InDesignConfig.xml file contains configuration to determine which image mime types should be processed using a file-based import routine.
<InDesignConfig LinkPing="10000" ArchivePDFVariantName="PDF_ [Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" SendToNewsroomFolderPath="/Wires" AutoMarkNonEmptyTextBoxes="true" KeepAlivePing="120000" ThumbnailHeight="96.0"> <ImageFileMimeTypes>
<ImageFileMimeType>image/pdf</ImageFileMimeType> </ImageFileMimeTypes>
</InDesignConfig> The file extension types listed between the <ImageFileMimeType> </ImageFileMimeType> tags determine which image types are processed by the file- based routines. PDF files need to be configured for this option.
PAGE 25
GN4 ADOBE PLUG-INS
Search Tab This is used to search for objects in GN4. You can search for the object name, folder and sub folders, the folder workstate and the modified date.
The modified date has a list of options. The Last “n” options will search back that number of hours, days, weeks, months or years.
Example of the search if the number is 2 and the current date/time is 11/03/2011 11:30
• Last Year will search from 11/03/2009 11:30 • Last Month will search from 11/01/2011 11:30 • Last Day will search from 09/03/2011 11:30 • Last Week will search from 25/02/2011 11:30 • Last Hours will search form 11/03/2011 09:30
PAGE 26
GN4 ADOBE PLUG-INS
Assigned Tab This shows images (.img files) and articles in GN4 that are assigned to the currently open extDoc. It will show items assigned to the extDoc, zone, edition and section.
Placing Articles or Stories onto Page (extDoc) Documents There are two ways to place Articles and Stories into the InDesign document:
• Double-click the items row and it adds it to the place gun which can then be placed into the document. Please note Articles and Stories can add more than one element onto the place gun.
• Select the box(es) in which you would like the items to go and press the place Article button in the bottom taskbar (if it is an Article), the place Story button (if it is a Story) or
press return. Any known types will be placed in the appropriate selected boxes. If there is a choice of box for the txt types or more than one type to be placed into a box you will be given a choice to select the item to put into the box. The feature will cycle through the boxes which are selected and you have the option to skip or place an item. It will only ask once per box. If it is left with a single match then the item is automatically placed.
The reference objects .img link to the photo caption. The img is only added when the photo caption needs to be placed. Articles can only be placed in one extDoc, if the article is already linked to an extDoc double-clicking will do nothing. If the article is linked to an extDoc it will open the extDoc in Article Mode (see later in this reference guide).
Replacing Page Content on Page Documents To replace content already on an extDoc (InDesign document) select the box with the content in on the page, select the content you want to replace it with in the grid and press the place button. A dialog box will appear:
PAGE 27
GN4 ADOBE PLUG-INS
If you select Cancel or No, the operation will be aborted and the existing content in the box on the page document will remain. If you click on Yes, the page content will be removed from the page box and the selected grid content will replace it. If the content you are replacing is the first part of a jump story, the content will then need to be reflowed so that any subsequent jump parts already on a page will be removed too. Automated creation of Articles from Stories If a Story is selected in the grid and inserted onto a Page Document (extDoc) it will automatically be copied to an Article and placed in the default folder configured in the global\gn4\InDesignConfig.xml configuration file. A Story cannot itself be added to a Page Document so on request to insert it into one the Story will be automatically copied and an Article generated and it is the Article that is inserted into the Page Document. The folder that the Article is generated in is configured in the InDesignConfig.xml file as the SendToNewsroomFolderPath parameter and is a global system location. The InDesignConfig.xml example below is configured for all Story to Article generated files to reside in the /Wires folder: ArchivePDFVariantName="PDF_ [Press quality]" PrintPDFName="[Press quality]" PageCompleteWorkstate="Page Closed" PrintQueueName="PDF file" PrintSinglePages="false" port="5679" ColourForMissingAdverts="16711935" SendToNewsroomFolderPath="/Wires" AutoMarkNonEmptyTextBoxes="true"> </InDesignConfig> The Article that is created will be named using the original Story Name plus a unique GUID that is generated on-the-fly so that the overall Article name cannot be a duplicate of an existing Article name. If a used Story is inserted into a Page Document a second time the GUID will be different and therefore the overall Article Name will be unique. The original Stories Copied To column in the Story List Grid shows details of the stories last conversion to an Article. It displays the Article Name, the time and date of when it was converted and the user who initiated the conversion.
Automated creation of Editorial Images from Wire Images If a Wire image is selected in the grid and inserted onto a Page Document (extDoc) it will automatically be copied to an editorial image and placed in the default folder configured in the global\gn4\InDesignConfig.xml configuration file. Using the same settings as the automated creation of articles from stories.
PAGE 28
GN4 ADOBE PLUG-INS
Items Tab The Items Tab lists the .imgs and article types that are on/in the currently active open extDoc (InDesign) document or documents.
PAGE 29
GN4 ADOBE PLUG-INS
Jumps Tab The Jumps Tab lists the jumped and pending jump article components available in context to the extDoc(s) open.
The Sequence Number column indicates the order of the jump parts. The original story content that the create jump was performed on is sequence number 1 and the remaining content not shown on the original extDoc at that point is sequence number 2. Both parts of the jump are listed in the Jumps tab of the palette. Words Estimate and Chars Estimate show the estimated number of words or characters for each of the jump parts. The sum total of the jump parts may not necessarily add up to the same value displayed in the Folders Tab article total word/character count. This may be due to two issues: individual single words may be broken over a jump and the calculated value of the words/characters in the Jump parts is carried out by InDesign whereas the Folders Tab article counts are carried out by Tera GN4. It is known that some single characters (hyphen, en/em rules) are counted as a word in GN4 but not by InDesign. Placing a Pending Jump from the Jumps Tab into a Document To place a pending jump, select the correct sequence number item in the list (sequence2 or above) and double-click its row to load it onto the place cursor or use the Place Item Command Icon on the taskbar. Placing jump text operates in the same way as placing general text content (see Placing Items onto Page Documents in this reference guide). Once the jumped text has been inserted into the target text box, or a text box is drawn with place cursor, the continued on template will be used to create the continued from text box. The continued from text box will be placed to the top of the continued text content box, drawn to the width of the text box or left-hand column if it is a box split into more than one column. It will overlap the target text content box. The page number inserted will be that of the source (sequence 1) jump content page.
If required, the story content can be jumped again by creating another pending jump. The source jump page continued on text page number can now be updated by opening the page document and updating the links. The Linked column on the Jumps Tab of the GN4 palette shows which documents the various jump parts are contained in.
PAGE 30
GN4 ADOBE PLUG-INS
Text can only be jumped onto extDocs in the same Edition, Section, Zone and Booklet (Booklet is only for GN4 2.4 and above) but cannot be jumped onto the same extDoc (so can’t, for example, be jumped onto another page in a multiple page extDoc or onto both pages of a double-page spread if it is produced as a single document). A Known Page pending jump has its intended destination page folio listed in the Jumps tab under the Known Pending Jump Page Number column but this is only for guidance purposes; no restriction is placed on the user overriding the intended pending jump destination by placing it on another page but the Known Pending Jump Page Number column row does signify this by displaying a red background colour. The continued on and from text boxes are anchored to the content text box. Moving either the context or continued on/from boxes will force the other box to go with it. Similarly, if you resize one box you will resize both or moving one box will force the other to move with it. In the event that it is desirable to unlock the continued on/from text box from the content text box then the padlock should be clicked with the InDesign Selection tool active. If you adjust the number of columns of the content box or move or resize the box it will force the jump continued on/from box to be re-composed to size to the current single column measure. The re-composition function will only run if a column measure change has not taken place for more than a second so altering the number of columns through two or three changes rapidly by clicking on the InDesign ribbon bar function arrows may not force the re-composition to run. The re-composition event is also triggered by text content alterations.
PAGE 31
GN4 ADOBE PLUG-INS
Your Tasks Tab The Your Tasks Tab displays only the tasks in GN4 that have been assigned to your user.
The features are the same as the Tasks Tab (see next section for details) with the exception of the Calendar Tree Pane functions as the Calendar Tree Pane is not displayed in the Your Tasks Tab.
PAGE 32
GN4 ADOBE PLUG-INS
Tasks Tab The Tasks Tab displays all the Tasks available in the GN4 system. A task has a number of properties (defined in the GN4 XML schema), where the most important ones are:
• A task is defined within a parent calendar, from which the task inherits a workstate. • You can move (send) a task from one calendar to another using a predefined copyflow. • You can assign a task to a GN4 user (to only one user). • You can assign to a task one or more products (articles, dummy images). • A task has a number of date/time related properties, e.g. start date and time, duration, due
date, completion date, kind, quantity, position and also percentage of completion, you can use to track down tasks and to manage them precisely.
• You can assign to a task a number of descriptive properties, such as description, who to contact, location, priority, notes, URL, keywords, categories etc.
Tasks can be created, copied and edited from this tab. Article product content items (such as text and images) can be attached/uploaded to a task. The Tasks Tab window is split into 5 Panes and has a Calendar Tree Pane, a Task Grid View, a Task Item Preview, a Task Product Grid View and a Task Product Preview. The Calendar Tree Pane (left) displays the list of Calendars available in the system:
PAGE 33
GN4 ADOBE PLUG-INS
The Task Grid View Pane (top centre) lists the tasks available that are associated to the selected Calendar:
The Task Grid Preview Pane (top right) shows a preview of the selection in the Task Grid View Pane:
The Task Product Grid View Pane (bottom centre) displays the products associated to the selected task in the Task Grid View Pane (top centre):
The Task Product Preview Pane (bottom right) previews the Task Product selected in the Task Product Grid View Pane (bottom centre):
PAGE 34
GN4 ADOBE PLUG-INS
Creating a new Task Clicking on the Create a new task icon in the Tabs Calendar Tree Pane will display the New Task dialog box:
A Calendar must be associated to the task and additional optional meta data content can be configured before selecting the Finish button to save the task. Editing an existing Task Selecting a task in the Task Grid View pane and clicking on the Edit properties of the selected item icon allows the editing of an existing task:
Selecting the OK Button will save the alterations made.
PAGE 35
GN4 ADOBE PLUG-INS
Adding Selected Page Items to an existing Task Clicking on the Add selected items to the selected task icon in the Task Grid View Pane will allow the currently selected extDoc box(es) to be added to the task selected in the Task Grid View Pane. Uploading Content to an existing Task
Clicking on the Upload content to the selected task icon in the Task Grid View Pane enables content to be attached to the task selected in the Task Grid View Pane. A dialog box will be displayed for you to browse to the file or files you want to attach to the task. Copying an existing Task
Clicking on the Copy selected task icon in the Task Grid View Pane will duplicate the currently selected task in the same Calendar. A dialog box will be displayed to allow editing of the duplicated task. By default, the task meta data is duplicated with the source task Title (task name) having an additional “- Copy” added to it ensure the target task has a unique name. The copy source task mandatory Calendar field is also removed to force a calendar to be linked in for the target task (the same Calendar as the source task can be selected) and all attached files (products) are removed. Displaying Task Products linked to a Task Valid extDoc (Page) content components linked to a task are called Task Products. Any products that are linked to the selected task in the Task Grid View Pane (top) are displayed in the Task Product Grid View Pane (bottom). Selecting an individual Product in the Grid View Pane will display it in the Task Product Preview Pane (bottom left). For further information on tasks see the GN4 documentation.
PAGE 36
GN4 ADOBE PLUG-INS
Web UI Tab The Web UI Tab in the palette enables a browser window with the full features and functionality of the GN4 Browser available to be displayed and utilised.
For more information see the Tera GN4 Browser documentation.
PAGE 37
GN4 ADOBE PLUG-INS
The GN4 Offline InDesign Plug-In Palette This panel opens with the menu ‘Windows>Extensions>GN4 Offline’ is to show the offline documents that are checked out for the current user. This lists all the InDesign documents in the folder (C:\Users\{username}\Documents\Miles_33_GN4). To open just double click on the filename you would like to open.
The GN4 InDesign Plug-In Menu Options
Editing Text To edit text in InDesign that has been placed from GN4 it must be checked out. Attempting to edit in the box will ask if you want to check out for editing or you can use the menu Edit>InCopy>Check Out or context menu InCopy>Check Out) to check out the item.
When you have finished editing the item needs to be checked in. This is done with a menu (Edit>InCopy>Check In or context menu InCopy>Check In) or you are asked when you close the document. To save text when the item is checked out and not check it back in use the menu (Edit>InCopy>Save Content or context menu InCopy>Save Content). Please note when you logout (i.e. close InDesign) all items are automatically checked In.
If the text is linked to the extDoc more than once (content is copied and pasted) then the last edited text box content when saved will update (or require the links to be updated) all the other text boxes containing the same article.
PAGE 38
GN4 ADOBE PLUG-INS
Editing Pictures To edit pictures you need to open them in Photoshop. Photoshop needs to be running and you must be logged in to GN4. Select the pictures you want to edit and choose the menu Plug-Ins>GN4>Edit or context menu GN4>Edit. This will open the pictures in Photoshop. Please note the software will only share data between InDesign and Photoshop in the same version, i.e. works between CS5 versions or CS5.5 versions but does not work if InDesign is CS5.5 and Photoshop is CS5. Importing Items on a Page Document into GN4 Importing items from the page into GN4 can take place via a menu (Plug-Ins>GN4>Create New Article /Img) or context menu (GN4>Create New Article /Img). A dialog is displayed which lets you enter the name (title) and folder for the imported content. It will automatically default to the last folder you used. It will import the items that are selected in the document. To edit metadata of the article please select the Edit Advance Details in Web Browser check box and when the OK is pressed the edit form is opened to allow metadata editing of the article.
To add to an existing article use the menu Plug-Ins>GN4>Add to Article or context menu GN4>Add to Article. This brings up a dialog that lists all the articles on the current page. Select the article you want to add the items to. Images use the file name as the name of the img in GN4, and will ask if the img exists and give you the option to overwrite it. Assigning Types to InDesign Boxes
Boxes in InDesign need to be marked with the text type of an article. Select the box to be marked and choose a text type from Plug-Ins>GN4>Type or GN4 context menu. The type is shown on the box in a red label. When all boxes are marked, select all the boxes for an article and choose import from Plug-Ins>GN4>Create New Article /Img. You can only import one article at a time. You cannot overwrite an existing article. The available Types are defined in GN4’s configuration.
PAGE 39
GN4 ADOBE PLUG-INS
When the document is saved it will check to see if any items need to be imported into GN4. If there are items to import then the document save will not be allowed and an error dialog is shown. To import a text part that has a reference (i.e. Photo caption) to another object the box needs to have a link to another box which is the reference object. There are two ways to achieve this: • Group the two boxes together using the standard InDesign group (CTRL+G) when the boxes are
selected.
• Select the two boxes and select Plug-Ins>GN4>Link. The best way to link boxes is the former option as the group box can be used in library shapes. To disable the import of boxes content use the menu Plug-Ins>GN4>Type>Disable Import or context menu GN4>Disable Import. This will not allow the contents to be imported into GN4 but will disallow the box from being checked for updates (therefore it can be used for standing matter). The Jump functionality will work on any text type that the GN4 articleschema.xml defines its link type as multi. Setting the Document Workstate To set the workstate of the document from InDesign select the menu Plug-Ins>GN4>Workstate or context menu GN4 and choose the workstate. If the document needs to be saved it will be force saved.
PAGE 40
GN4 ADOBE PLUG-INS
Creating PDF’s of Page Documents
To create a PDF variant of the Document select Plug-Ins>GN4>Create PDF. A dialog is shown with a choice of variants (if more than one in the system). The variant name needs to map to the InDesign PDF export styles. The name can have 'PDF_' in front of it as this is removed when looking for the PDF export style. There is a mapping of the Adobe PDF presets in InDesign to export the document as a PDF variant in GN4. The presets need to be added as Doc variant types in GN4. They can have 'PDF_' put in front of the name as then it will display in the Create PDF dialog.
InDesign Box Type Labels There are two types of labels that can be displayed in the InDesign Normal Screen Mode only (View>Screen Mode>Normal):
• Red – show the type of box that needs to be imported into GN4. The Menu to toggle the label on/off is Plug-Ins>GN4>Labels>Type.
• Blue – shows the type of content that it is linked to (body, head etc.). The Menu to toggle the label on/off is Plug-Ins>GN4>Labels>Linked.
PAGE 41
GN4 ADOBE PLUG-INS
InDesign Folio Markers There are markings for page number, section, zone and edition number and they are updated when the page is opened. Below is the list of context menus to add to each marker:
• Page: Insert Special Character>Markers>Current Page Number • Section: Insert Special Character>Markers>Section Marker • Zone: Insert Variable>Zone • Booklet: Insert Variable>Booklet (Booklet is only for GN4 2.4 and above) • Edition Number: Insert Variable>Edition Number
Below is the list of menus to add to each marker:
• Page: Type>Insert Special Character>Markers>Current Page Number • Section: Type>Insert Special Character>Markers>Section Marker • Zone: Type>Text Variables>Insert Variable>Zone • Booklet: Type>Text Variables>Insert Variable>Booklet (Booklet is only for GN4 2.4 and above) • Edition Number: Type>Text Variables>Insert Variable>Edition Number
There are multi markers for edition date. All are found under Type>Text Variables>Insert Variable or context menu Insert Variable.
• Edition Date – Long date representation dependent on your system and system's settings • Edition Date (Short) – Short date representation dependent on your system and
system's settings • Edition Weekday – Full weekday name • Edition Weekday (Short) – Abbreviated weekday name • Edition Month Name – Full month name • Edition Month Name (Short) – Abbreviated month name • Edition Day – Day of month as decimal number (1-31) • Edition Day (01) – Day of month as decimal number (01 – 31) • Edition Month – Month as decimal number (1 – 12) • Edition Month (01) – Month as decimal number (01 - 12) • Edition Year – Year with century, as decimal number • Edition Year (Short) – Year without century, as decimal number (00 – 99) • Edition Day of Year – Day of year as decimal number (1 - 366) • Edition Day of Year (001) – Day of year as decimal number (001 – 366)
Article Mode This is a mode that allows an extDoc (InDesign document) to be opened but not checked out so that text items can be edited. Please note any changes to the extDoc are not saved back to the server, i.e. if you move/delete/add a box or alter the number of text columns the change is not saved to the server, only text edits are saved. To open an extDoc in this mode double-click on an article that is linked to an extDoc. This will open the extDoc if it is not already open. It will also select the text items that are in the article and check out the body if it is not locked. If the article is on multiple extDocs (a jumped article) then all the relevant extDoc’s will be opened. If you attempt to open an extDoc that is locked (open currently by another user) you are asked if you would like to open it in Article Mode for a read-only view. Auto Checkout This is on by default. Auto Checkout an item to be edited if it is selected with the text tool. When Auto Checkout is on it will unlock the items when the document is closed. To toggle this on/off use the menu Plug-Ins>GN4>Auto Checkout. If auto checkout is on and you are editing an item and select to check in the item it will re-check out the item.
PAGE 42
GN4 ADOBE PLUG-INS
Document Complete Function This function will:
• Check all items in • Save the page • Create print PDF and send it to the print queue • Create PDF for archive and store it in a variant on the ExtDoc • Set the workstate • Close the document
• The config for the print queue, workstate and PDF is in the file InDesignConfig.xml and will need to be imported with cmd4 config -in InDesignConfig.xml.
• ArchivePDFVariantName – is the variant to store the PDF. It is also the Adobe PDF preset for the creation of the PDF, same rules as the create PDF function.
• PrintPDFName – is the Adobe PDF preset for the creation of the print PDF. • PrintQueueName – is the name of the print queue to send the print PDF. • PageCompleteWorkstate – is the workstate to set the extDoc to. • PrintSinglePages – will create a print PDF of each page if this is set to true otherwise it will
create one print PDF for the document. • PDFFileNameOption – is the name option for the pdf print file. Supported options. • DescName – used the extDocs descriptive name. So file name will be '{descName}_{pageNo}.pdf • ShortName – used the extDocs short name. So file name will be '{shortName}_{pageNo}.pdf • Ask – Ask the user for the print file name. If the file name does not have the extension '.pdf' it
is added. The name of the print pdf is the description of the extDoc and the page name. The first page name is used if there are multiple pages in one PDF.
When using the InDesign Plug-In there may be a need for the user to use a different Job Options file to the configured ‘Default’ one when they wish to execute the ‘Document Complete’ function via the GN4 Plug-In. This functionality is missing currently and needs to be added. Examples of the type of things needed would be the ability to have a Job Options for Spreads, one for No Spreads, one for Crops, etc.
The options can be set per Title in 2.2 or greater only. To set this please choose the Title in the editions tab of the Plug-In and choose the ‘Document Complete’ options, the user parameter ‘inDesignPlugInCompleteOptions’ needs to be set to ‘True’ for this to be shown. The PDFFileNameOption option can only be set at title level from 2.3 or greater.
If the user has ‘inDesignPlugInCompleteOptions’ set to ‘True’, then they can set their own document complete options in the menu ‘GN4>Options>Set Document Complete’. See the following screen shot for configuration details which can be carried out at a User or Group Level.
PAGE 43
GN4 ADOBE PLUG-INS
They can also set an option to be asked for the ‘Document Complete’ options for each extDoc in the menu ‘GN4>Options>Ask Document Complete’, this will use and set the user options for this. There is also a way to delete the user options in the menu ‘GN4>Options>Delete Document Complete’. The way the Document Complete options are got.
If one level is not set then it will use the high level in the order from Asked for, user, title, system from the InDesign Config.xml. If the PDFFileNameOption is set to ‘Ask’ a dialog is shown that the user has to enter a name for the pdf file, to get the system to enter the page number as displayed on the page add the text ’{p}’ and this is replaced with the page number.
Issue Description The InDesign Plug-In is Printing a Spread twice when Spreads selected in the PDF Preset File and configuration for Single Pages is set to True. When Spreads are selected and Single Pages set to True Spread should be identified by the Left Hand Page of the pair only and the Right Hand Page of the pair should not result in the Spread being printed again.
Steps to Reproduce this Issue 1. Have the Job Options file configured for Spreads. 2. Have Print Single Pages settings in the configuration set to True. 3. With a Spread selected for output click the Document Complete selection in the GN4 Plugin. 4. Spread pair PDF created and named for the even (left) page with the right hand page and a second one created and named using the page number of the right hand (odd) page.
Release Notes: When the printSinglePages setting is set to ‘True’ the PDF created for the print, will look at the PDF preset and will print single spreads if spreads are selected and singles pages if pages is set.
Remove Content from Document
To remove content from boxes select the boxes the content is to be removed from and then select Plug-Ins>GN4>Remove Content or context menu GN4>Remove Content. This will remove all pictures and empty all text from the selected shape. Note that Remove Content will also remove content that is not in GN4 from the document. Remove Content performed on a jumped text box will remove both the text content and the jump continued on/from box and content. If all parts of a jump have been removed then the Jump story will be delisted from the Jumps Tab.
Spike Content from Document
This works the same as Remove Content from the document, but it can only be used on text and images that are in GN4. It will run the remove content from the page, save the page, then it will spike the items from GN4.
Creating Titles/Editions/Zones and Pages and Importing Advertising Plans
The InDesign Page documents and Title, Edition, Booklet (only for GN4 2.4 and above), Zone and Section database structure are all configured using the Tera GN4 software, such as the browser-based configuration tools or Fred. Adverts are imported into an advert layer utilising GN4 Fred functionality. This occurs when the document is opened and there is a matching Fred page which has an advert layer. The adverts layers are locked. Do not add any manual alterations to the adverts layer as when updates occur the layer is removed and recreated. For further information see the online Fred documentation. InDesign extDoc’s can also be created from Fred page documents and their Advertising Layer Layouts are retained in the extDoc. For further information on creating InDesign extDoc documents from Fred pages see the Creating InDesign documents from existing Fred documents section.
PAGE 44
GN4 ADOBE PLUG-INS
Jump Stories Jump stories are stories where the text content can be split over two or more page documents or extDocs. The system text types are configured in the articleschema.xml file. Text types that have a link=”Multi” are types that are eligible to be jumped. A sample articleschema.xml file is listed below:
<? xml version="1.0” encoding="utf-8"?> <article order="Seq">
<head minOccurs="0” maxOccurs="1” link="Single” /> <webHead minOccurs="0” maxOccurs="1” link="No” /> <blogPost minOccurs="0” maxOccurs="1” link="No” /> <jumpHead minOccurs="0” maxOccurs="1” link="Multi” /> <subhead minOccurs="0” maxOccurs="1” link="Single” /> <kicker minOccurs="0” maxOccurs="1” link="Single” /> <intro minOccurs="0” maxOccurs="1” link="Single” /> <body minOccurs="0” maxOccurs="1” link="Multi” /> <web Body minOccurs="0” maxOccurs="unbounded” link="No” /> <smsBody minOccurs="0” maxOccurs="unbounded” link="No” /> <pullquote minOccurs="0” maxOccurs="unbounded” link="Single” /> <photoCaption minOccurs="0” maxOccurs="unbounded” link="Single” reference="img” /> <urlCaption minOccurs="0” maxOccurs="unbounded” link="No” reference="url” /> <audioCaption minOccurs="0” maxOccurs="unbounded” link="No” reference="audio” /> <videoCaption minOccurs="0” maxOccurs="unbounded” link="No” reference="video” />
</article> In this example file, text types labelled jumpHead and body can have their content jumped from one extDoc (document page) to another. Creating a Jump To create a pending jump, select Plug-Ins>GN4>Jump>Create. This will create a pending jump into the GN4 Palette Jumps tab that can be placed onto any other extDoc (document page) in the same edition providing it is in the same section and zone as the jumped from document. Pending jumps cannot be placed on the same target extDoc as the source extDoc. A jump text box and continued on text will automatically be generated on the document utilising the continued on template. Continued on text boxes are drawn to the width of the source jumped text box (or width of the last column if a box is split into multiple columns) and will be placed at the bottom of the existing source text box, overlapping (on top) of the source boxes content. The page number inserted will, by default, be 0. This will be updated later once the pending jump content has been placed onto another extDoc (document page).
The continued on and from text boxes are anchored to the content text box. Moving either the context or continued on/from boxes will force the other box to go with it. Similarly, if you resize one box you will resize both or moving one box will force the other to move with it. If you adjust the number of columns of the content box, moving or resizing the box will force the jump continued on/from box to be recalculated and it will then resize the box to the appropriate single column measure. In the event that it is desirable to unlock the continued on/from text box from the content text box then the padlock should be clicked with the InDesign Selection tool active.
PAGE 45
GN4 ADOBE PLUG-INS
Creating a Known Page Jump To create a Known Page pending jump, that is a jump that you already know which page it will jump to, select Plug-Ins>GN4>Jump>Create Known Page. A dialog box will be displayed:
The dialog box enables you to select which page number the pending jump will be located on. In the example above, the jump is from page 10 so it is removed from the list of available pages that can be jumped to, but all other known folios are listed in a drop- down. A Known Page jump will insert the intended folio number in the continued on text box if the [n] variable character is utilised in the template. It will not automatically place the pending jump content onto the Known Page document, nor will it stop the pending jump being placed on another page document other than the one specified. In this situation the jumped from page would need its links updated so that the actual destination page folio number can be inserted into the continued from text box. A pending jump with a Known Page number has the intended folio number displayed in the grid of the Jumps tab content under the Known Pending Jump Page Number header. This number is not altered in the grid if the pending jump is placed onto another page folio but the grid row is highlighted in red.
Reflowing a Jump To reflow an existing jump after text content editing, select Plug-Ins>GN4>Jump>Reflow. Please note that all the jump parts will need their links updated in each of the document pages to enable the ripple effect of edited text to flow backwards/forwards as appropriate. If a Reflow will cause the text content to fit the current box and therefore a jump part and the continued on text box are no longer necessary, a dialog box will be displayed:
PAGE 46
GN4 ADOBE PLUG-INS
If No or Cancel are selected, the jump part(s) will remain available and the continued on text box will be retained, but if Yes is selected, providing subsequent jumps parts are not already on pages, the jump part(s) will be removed from the Jumps tab listing grid and the continued on text box will be deleted. If the subsequent jump parts are on a page a message dialog will appear (below) and no Reflow will take place.
Removing a Jump To remove an existing jump, select Plug-Ins>GN4>Jump>Remove. This will remove all pending jumps if they are not already on a document page/extDoc. Removing a jump will also remove the jumps continued from/to text box originated by the create jump feature. If all parts of a jump are removed, the article is delisted from the Jumps Tab. The Continued On/From Jump Templates and GN4 Jump Configuration The continued on/from text content automatically placed when creating a jump or placing a pending jump is read from a template which has been uploaded into the GN4 database. To undertake this, first you must generate an InDesign document, create text boxes and enter content for the continued on/from text. The InDesign document generated can be called and be stored in any folder accessible by the user utilising the CMD4 prompt.
The text box content and font attributes (font, point size, justification etc.) for the various titles and sections will be used as they are set but the text box width and height are arbitrary as they are automatically set by the Create Jump and insert pending jump processes. The width of the text box will be created to that of the source or target text box or single column measure if it is a multi-column box. The depth of the box is generated to accommodate the height of the continued on/from text. The [n] marker will insert the relevant folio number of the source or target jump component part providing the extDoc (document page) is correctly page numbered in InDesign. Other variable markers can be entered (see InDesign Folio Markers section of this reference guide). Once the boxes have been created, they must be exported individually to .ICML files. To do this, click on one of the boxes with the selection tool, click right and select the InCopy>Export Selection….
PAGE 47
GN4 ADOBE PLUG-INS
Alter the Save as type to drop-down option InCopy Document and give the export a name. You will need to undertake this for all the continued from and continued on text boxes. Again, the individual files can be named as any file name providing the extension is .ICML and saved anywhere accessible by the GN4 CMD4 feature. The .ICML files now need to be referenced in an .XML file that can be uploaded to GN4. A sample .XML files contents are listed below:
<objects xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance“ xmlns="urn:schemas-teradp- com:gn4tera"> <continueTemplate name="continuetexttemplate” >
<sectionRef> <keyRef objectType="title">
<keyVal>Times</keyVal> </keyRef>
<keyVal>News</keyVal> </sectionRef> <continueOn mime="application/xml">
<url>C:\tera\Gn4\Main\indesigncontinuetext\contontext.icml</url> </continueOn>
<continueFrom mime="application/xml"> <url>C:\tera\Gn4\Main\indesigncontinuetext\contfromtext.icml</url>
</continueFrom> </continueTemplate > <continueTemplate name="continuetexttemplate2"
<sectionRef> <keyRef objectType="title">
<keyVal>Globe</keyVal> </keyRef> <keyVal>News</keyVal>
</sectionRef> <continueOn mime="application/xml">
<url>C:\tera\Gn4\Main\indesigncontinuetext\globecontontext.icml</url> </continueOn>
<continueFrom mime="application/xml"> <url>C:\tera\Gn4\Main\indesigncontinuetext\globecontfromtext.icml</url>
</continueFrom> </continueTemplate> </objects>
PAGE 48
GN4 ADOBE PLUG-INS
The continueOn and continueFrom tags have the URL definition of the exported .ICML files. In the example above, the definitions were generated on an InDesign document continuedtextdocument.indd which was stored in folder C:\tera\Gn4\Main\indesigncontinuetext. The continued on text for title Times section News was exported to file C:\tera\Gn4\Main\indesigncontinuetext/contontext.icml and the continued from text exported to file C:\tera\Gn4\Main\indesigncontinuetext/contfromtext.icml. The continued on text for tile Globe section News was exported to file C:\tera\Gn4\Main\indesigncontinuetext/globecontontext.icml and the continued from text exported to file C:\tera\Gn4\Main\indesigncontinuetext/globecontfromtext.icml. The .XML file above was stored in C:\tera\Gn4\Main\indesigncontinuetext and is named continuetext.xml. The .XML file also contains information relating to the Title and Section that the definition is effective for as it is possible to using differing content and/or font attributes for different sections or titles. In the example above, the Sections reference a keyval of News and the titles are listed as Times and Globe. All the definitions for various sections or titles can be set in a single .XML file i.e. different parameters for sections News and Sport in title Times and sections News, Sport and Leisure in title Globe. The .XML file is now ready to be imported into GN4. This needs to be undertaken by a system manager with relevant privileges and in the relevant folder but can be done from the cmd prompt as follows:
In the example above the GN4 CMD4 binary file is located in c:\tera\gn4\main\bin so the process is run from this directory and the cmd4 import process is run on the filename with its UNC path (in this case c:\tera\gn4\main\indesigncontinuetext\continuetext.xml) into the database named sqlwin64 using the user stevet whose password is stevetp:
cmd4 import –in c:\tera\gn4\main\indesigncontinuetext\continuetext.xml –svrname sqlwin64 – username stevet –password stevetp
Once the .XML definition has been successfully uploaded to GN4 you will need to re-login to the GN4 # Once this process has been run once, if the continued text context or font attributes need to be altered, the original InDesign document can be edited and saved and the CMD4 import process re-run. Saving the InDesign document will automatically update the linked .ICML files and providing the .XML file definition contents don’t need to be altered the file can simply be re-imported into GN4 again to force an update of the .ICML files into the database.
PAGE 49
GN4 ADOBE PLUG-INS
Sending Articles onto Other Folders Articles can be moved from one folder to another utilising GN4 configured Folder Copy Flows and the Plug-Ins>GN4>Send menu items in the same way that they can be moved using the Status Bar Command Icons.
Plug-Ins>GN4>Send>Start will commence a copy flow on the selected content item. Plug-Ins>GN4>Send>Back will move the selected content item back to the previous stage folder setup in the copy flow and Plug-Ins>GN4>Send>On will send the selected content item onto the next phase folder of the configured copy flow. Where appropriate, dialogs will be displayed showing the fixed, or choice, of folders available for the Start, Back or On function.
The appropriate folder must be selected and the Next>> button clicked on to perform the flow task. Configuring the Copy Flows in GN4 Copy Flows are configured in the Tera GN4 system. There is a GN4 configurable User/User group tab named Copy Flows. This lists the available folder movement for content when the appropriate button is accessed.
In the screen shot example above, the Start copy flow function will move the content from its current location folder to the /Editorial/For Subbing folder. The Send Back copy flow function will move the content from the /editorial for subbing folder to the /Editorial/Returned back from Subbing folder and the Send On function will move the content from the /Editorial/Returned back from Subbing folder to the /Editorial/For Subbing folder. For additional detail on Copy Flow configuration see the on-line GN4 documentation.
PAGE 50
GN4 ADOBE PLUG-INS
Preflight Profiles The InDesign Preflight option (Window>Output>Preflight) has a pre-configured GN4 Profile Category installed into the Basic Profile and by default all options are switched on.
To remove the GN4 Rule Category (all the GN4 Prefight options) another Profile (other than Basic) will need to be created (within the Define Profiles dialog) and the tick removed from the GN4 Rule Category level. To remove an individual Preflight option, create another profile and remove the tick against the appropriate Preflight option row. Depending on the actual functionality, Preflight options can be invoked and run when a document is edited, updated, saved or closed. For detailed information on the Preflight feature refer to the InDesign documentation. Not In GN4 The Not In GN4 profile is invoked when a text box has content entered into it and the box is not known by the GN4 system. If the Preflight panel dialog box is open (by either double-clicking on the Status Bar error section or opening from Window>Output>Preflight) the display will show the Not In GN4 list of Text Frames. Highlighting one of the Text Frames in the list will display the Problem text information in the Info area.
PAGE 51
GN4 ADOBE PLUG-INS
Double-clicking on the Text Frame in the list will force the offending Text Frame in the InDesign document to be selected and brought into view. A Text Frame failing this Preflight option must either be added into GN4 or marked as Disabled for Import. This profile is also run by the File>Save document function. Reflow Check The GN4 Reflow profile is invoked when a jump text box requires a Plug-Ins>Jump>Reflow as the content or text frame have been adjusted. If the Preflight panel dialog box is open (by either double-clicking on the Status Bar error section or opening from Window>Output>Preflight) the display will show the GN4 Reflow list of Text Frames. Highlighting one of the Text Frames in the list will display the Problem text information in the Info area.
Double-clicking on the Text Frame in the list will force the offending Text Frame in the InDesign document to be selected and brought into view. This profile is also run by the Plug-Ins>GN4>Document Complete function.
PAGE 52
GN4 ADOBE PLUG-INS
Utilities Utilities menu options (Plug-Ins>GN4>Utilities) are ‘Disable All Boxes Import’, ‘Disable All Graphic Boxes Import’, ‘Disable All Text Boxes Import’ and ‘Select First Import’.
Disabling All Boxes from GN4 Import
The menu option Plug-Ins>GN4>Utilities>Disable All Boxes Import will run the commands of ‘Disable All Graphic Boxes Import’ and ‘Disable All Text Boxes Import’.
Disabling Graphic Boxes from GN4 Import
The menu option Plug-Ins>GN4>Utilities>Disable All Graphic Boxes Import will scan all current Graphic boxes on the extDoc Page Document and mark all those not currently linked to GN4 editorial images as being disabled for import into the GN4 system (option Plug-Ins>GN4>Type is ticked as Disable Import).
This feature enables the end user to easily disable for import all graphic boxes on the extDoc that are not GN4 editorial images but enable the extDoc document to be saved.
This command can be run on document save if the option ‘DisableGraphicImport’ is set to true at the title level, if not set at title level then it checks the ‘DisableGraphicImport’ setting in the config InDesignConfig.
Disabling Text Boxes from GN4 Import
The menu option Plug-Ins>GN4>Utilities>Disable All Text Boxes Import will scan all current text boxes containing text on the extDoc Page Document and mark all those not currently linked to GN4 articles as being disabled for import into the GN4 system (option Plug-Ins>GN4>Type is ticked as Disable Import).
This feature enables the end user to easily disable for import all populated text boxes on the extDoc that are not GN4 articles but enable the extDoc document to be saved.
This command can be run on document save if the option ‘DisableTextImport’ is set to true at the title level, if not set at title level then it checks the ‘DisableTextImport’ setting in the config InDesignConfig.
Select First Import
Selecting menu item Plug-Ins>GN4>Utilities>Select First Import will scan all current boxes on the extDoc Page Document in the order drawn and select and bring into the window focus the first found box that is marked as a valid GN4 box type (options from Plug-Ins>GN4>Type other than Disable Import) that is not currently in the GN4 system. This feature enables the end user to easily find unlinked items on extDocs and then import them into GN4 via the Plug-Ins>GN4 options of Add to Article or Create New Article/Img.
Update On Open
If the Update On Open menu option (Plug-Ins>GN4>Update On Open) is ticked (on) it will enable all the content Links within an extDoc being opened to be updated during the opening extDoc process and thus ensure all the content displayed is the latest known version. By default, the option is ticked (on). If the option is not ticked (off) then on opening an extDoc the Links within it to the containing content will not be updated and some of the content may be out of date. A manual Links update can be performed by the operator when desired.
Check in Offline Document To check in a document that is offline. Open the offline document and then select the menu check in Document (Plug-Ins>GN4>Offline>Check In Document). This will save the changes of the document to the server and check in the document. If there are any items that are not in GN4 then these need to be added before the document can be checked in.
PAGE 53
GN4 ADOBE PLUG-INS
The GN4 Photoshop Plug-In Introduction The palette is used to list the images and imgs if GN4 has these types configured. Logging In and Out To login to GN4, the panel needs to be opened from Windows>Extensions>GN4. If you are not already logged in a drop down server choice (from the GN4 UserConfig file), user name and password and a login button are displayed. If you are already logged in and you open the panel the last state is recovered. When you login a check of the version of the server is made and if the server version is too low for the Plug-In software to connect with an error is displayed. The minimum server version of GN4 required will alter as features are added to the Plug-In. If you close Photoshop without using the menu logout and exit you will not be logged out. If you close Photoshop with documents open and unsaved these will not be saved into GN4. For more information on logging in refer to The GN4 InDesign Plug-In Palette section. Opening an Item to Edit To open an item in Photoshop CC and below, double-click on the item row in the tabs grid.
To open an item in Photoshop CC2014 and above, use the context menu and select open, or select all images to be opened and use the actions menu and open.
PAGE 54
GN4 ADOBE PLUG-INS
Add Current Open Image Document into GN4 To add an image into GN4 from Photoshop CC and below select the folders tab, select the folder you would like the image to be placed in and press the import active document button in the taskbar of the folder tree. This will open a window which will allow the choice of object type (img or image) and a title. When the image has been added it will close the current document and open the one that was added to GN4. The currently open document can also be added to the currently selected Task in the Task Tab Task Grid View Pane. To add an image into GN4 from Photoshop CC2014 and above, run open of the command ‘Import image’ or ‘Import Editorial Image’ and then fill in the metadata details. Photoshop Plug-In Menu Options There are no Photoshop Plug-In menu options.
PAGE 55
GN4 ADOBE PLUG-INS
The GN4 InCopy Plug-In Introduction The InCopy palette is used to list the content in GN4 that can be opened in InCopy. Logging In and Out To login to GN4 the panel needs to be opened from Windows>Extensions>GN4. If you are not already logged in a drop down server choice (from the GN4 UserConfig file), user name and password and a login button are displayed. If you are already logged in and you open the panel the last state is recovered. When you login a check of the version of the server is made and if the server version is too low for the Plug-In software to connect with an error is displayed. The minimum server version of GN4 required will alter as features are added to the Plug-In. For more information on logging in refer to The GN4 InDesign Plug-In Palette section. Opening an Article To open an existing article, double-click on the items row in the palette grid list. The selected content can be presented to edit in galley, story or layout mode as appropriate. A progress bar may be displayed whilst the content is opening.
Both individual articles and all articles on an extDoc (InDesign page document) can be opened from the appropriate palette tabs for editing in InCopy. Galley and story modes will display the content with “header bars” above the relevant article component parts. The header bar shows the article and component type(s). When an extDoc is displayed the articles components are “grouped” together in the galley and story display modes. Opening an article from the Folders tab that has been placed on more than one extDoc (a jumped article) will open all the relevant content on all the extDoc’s involved. Opening an article from the Jumps tab by double clicking in the grid row will open just that jump sequence part. Opening an article from the Jumps tab by selecting a row and clicking on the command
line icon will open all the jump sequence parts.
PAGE 56
GN4 ADOBE PLUG-INS
To save text edits back to the GN4 database the extDoc must be open and the links updated. Only content that has already been placed on an InDesign document (linked to a page) will display with a true page layout in layout mode; an article that has not been linked to a page will utilise a plain template in layout mode. Changes made to jump articles sequences that require to be cascaded through further sequences in the chain need to be reflowed (Plug-Ins>GN4>Jump>Reflow). Creating an Article A new GN4 article can be originated from InCopy utilising the Command Item Taskbar option Create a
new article in the selected folder available on the Plug-In palette. Clicking on the icon will open the Create a new article in the selected folder dialog box:
The article must be given a Title (article name) and multiple article component types can be selected from the list set-up in the GN4 system. In the above example, the article will have the highlighted (in blue) head, jumphead, subhead, kicker and body components created. The components of the last article created are selected by default when the Create a new article in the selected folder function is accessed.
PAGE 57
GN4 ADOBE PLUG-INS
If the Edit Advanced Details in Web Browser box is ticked it will open up the GN4 Edit Objects metadata form for editing. The article is created in the currently selected Folder of the InCopy Folders tab, providing it has suitable permissions. Creating an Article linked to a Task
The icon in the Tasks Tab functions as Create a new article and add to selected task. It enables a new article to be created using InCopy into the folder designated by filling in the new article dialog box (see Creating an article section) and for it to be linked automatically to the current task selected in the Task Grid View Pane. See Tasks Tab for additional information on tasks.
InCopy Plug-In Menu Options InCopy menu options are Plug-Ins>GN4>Auto Checkout, Plug-Ins>GN4>Jump>Reflow, Plug-Ins>GN4>Labels>Linked and Plug-Ins>GN4>Send>Start/Plug-Ins>GN4>Send>Back/Plug-ins>GN4>Send/On. Auto Checkout Auto Checkout is on by default. It will check out component parts of an item to be edited if it is selected with the text tool. When Auto Checkout is on it will unlock the items when the document is closed. To toggle this on/off use the menu Plug-Ins>GN4>Auto Checkout. If auto checkout is on and you are editing an item and select to check in the item it will re-check out the item. With Auto Checkout off, the body component will still be automatically checked out for editing but other component parts will have to be manually checked out if editing is required. Jump Reflow To reflow an existing jump after text content editing, select Plug- Ins>GN4>Jump>Reflow. Please note that all the jump parts will need their links updated in each of the document pages to enable the ripple effect of edited text to flow backwards/forwards as appropriate.
PAGE 58
GN4 ADOBE PLUG-INS
Linked Labels Toggles the blue content type (body, head etc.) labels on/off in the InCopy Layout tab only providing the InCopy Screen Mode is set to Normal (View>Screen Mode>Normal). Copy Flow Send to Other Folder Options The Plug-Ins>GN4>Send series of options – Start, Back and On – relate to available copy flow options. Articles can be moved from one folder to another utilising GN4 configured workflows and the menu items in the same way that they can be moved using the Status Bar Command Icons. Plug-Ins>GN4>Send>Start will commence a copy flow on the selected content item. Plug-Ins>GN4>Send>Back will send the selected content item back to the previous stage setup in the copy flow and Plug-Ins>GN4>Send>On will send the selected content item onto the next phase of the configured copy flow. The Copy Flow features can be used in both InDesign and InCopy to enable a workflow, for instance, whereby page content is designed within an InDesign document but sub- edited within InCopy. For more information see Sending Articles onto Other Folders.
PAGE 59
GN4 ADOBE PLUG-INS
The GN4 Premiere Plug-In Introduction The palette is used to import GN4 items into a Premiere project. To logout use the menu on the panel logout and exit this will log you out of GN4 and exit Premiere. When you login a check of the server version is made and if the server version is too low for the Plug-In software to connect with an error is displayed. For more information on logging in refer to The GN4 InDesign Plug-In Palette section. To Import an item into the project, double-click it and it will be imported. It will put the file in a sub directory of the same name as the project in the same folder.
The Premiere Plug-in enables the user to add audio or video files stored in the GN4 database into a Premiere project. There are two additional command listing filter icons at the bottom of the palette to enable the appropriate content for display. These are:
• Listing Video files • Listing Audio files
The active filter is highlighted with a yellow background to the command icon. An additional column, a thumbnail preview of the file, is available to be displayed in the grid (if available).
The Preview Pane additionally allows the audio or video file to be played. For this function, the Preview Pane is split into two; one pane showing the file metadata and the other a player for audio or video as appropriate.
PAGE 60
GN4 ADOBE PLUG-INS
Importing an Item into a Project To import into a project, double-click on the item name in the palette grid list. The selected content will be presented in Premiere as appropriate.
In CC 2015.3 and above, select the menu item Import. Listing Items in the project In CC 2015.3 and above there is the option to list the GN4 object in the open project in the search ‘Items in the current project’.
Update items in Project In CC 2015.3 and above there is the option to update the items that have been imported into the project from the current GN4 system, new global menu ‘update items in current project’
Premiere Plug-In Menu Options There are no Premiere Plug-In menu options.
PAGE 61
GN4 ADOBE PLUG-INS
GN4XMLCommand Script Support Introduction GN4XMLCommand support has been added to InDesign scripting. It can be used to automate InDesign and the GN4 plug-ins. GN4XMLCommand is added to the InDesign.Application object and can take and return an XML string. Formats Input XML format
<command name=”commandname”> <param name=”paramName”>data</param>
<param name=”paramName2”>data</param> </command>
Result XML format
<result name=”commandname” errorCode=”0” errorMessage=”success”> </ result>
Commands CreatePagesInEdition This command creates the InDesign pages documents in an edition from the Fred pages in that edition. Parameters:
• editionId – edition id to create the InDesign documents • templateId – the id of the template edition to use for the InDesign documents
CreatePage This command creates the InDesign page document from the Fred page. Parameters:
• pageId – page id to create the InDesign document from • templateId – the id of the template edition to use for the InDesign document
UpdatePage This command updates the InDesign page document, it opens the page which updates all links, then saves and closes the page which updates GN4. Parameters:
• extDocId – extDoc id of the page to update OpenPage This command opens the InDesign page document. Parameters:
• extDocId – extDoc id of the page to open • checkOut – set to true to check out the item, otherwise it does not check out the item. • UpdateLinks – set to true to update the links • UpgradeDocument – set to true to upgrade the document to this version of InDesign.
PAGE 62
GN4 ADOBE PLUG-INS
Login This command logs in a user to GN4. Parameters:
• server – server to use i.e. 'http://localhost/gn4/' • name – user name • pwd – password for the user • language – language to use • Tzofs – time off set
PlaceURI This places the URI in the selected box. Parameters:
• uri – URI of item to place GetURI This gets the URI for the given id if it is an article then gets all the URI’s of the items in the article. Parameters:
• id – id of item to get the URI for result
<result name=”GetURI” errorCode=”0” errorMessage=”success”> <uri id=”123”>gn4://txt/1234</uri> </ result>
DocumentComplete This runs the document complete function on the current document. Parameters:
• checkPreflight – Will check the preflight for errors • PDFFileName - Will set the pdf file name.
PAGE 63
GN4 ADOBE PLUG-INS
Support for InDesign Server The creation of InDesign pages documents when the GN4 edition has pages added can be automated via the functions for InDesign Server.
1. Install the login script to the InDesign server start-up script folder. Edit to set the right username and password.
2. Edit wf_InDesignServerCreateExtDoc.xml, wf_InDesignServerUpdateExtDoc.xml and change the InDesign server location to your install location.
3. Import the config files wf_InDesignServerCreateExtDoc.xml and InDesignServerUpdateExtDoc.xml
4. Place the GN4InDesignServer.dll in the same folder as back4. 5. Create a Referencing trigger on the adding pages to the edition with the workflow
InDesignServerCreateExtDoc 6. Create a Referencing trigger on adding extDoc to the edition with the workflow
nDesignServerUpdateExtDoc – this puts the adverts on the page. Triggers One page document is created at a time so referencing triggers are used:
• triggerwf -attr page.editionRef -name InDesignServerCreateExtDoc -mode Referencing.
To update the adverts when extDoc added to edition: • triggerwf -attr extDoc.editionRef -name InDesignServerUpdateExtDoc -mode
Referencing. Desktop version of InDesign To use a desktop version of InDesign use the command CreateExtDocLocal or UpdateExtDocLocal. GN4InDesignHost must be installed on the same workstation as InDesign. The server parameter is http://localhost:8732/GN4InDesignHost/InDesignHost, this is configured in the GN4InDesignHost.exe.config file. For the JavaScript on the server to read this new function it needs to be rebuilt with Regenerating the Adobe InDesign server Java API To update the ExtDoc when a linked item is changed you can use the workflow InDesignServerUpdateExtDocFromLinked with triggers: triggerwf -attr linkedObject.* -name InDesignServerUpdateExtDocFromLinked GN4InDesignServer.dll functions UpdateExtDoc updates the given extDoc. Parameters:
• server – location of the server • extDocId – the id of the extDocId
PAGE 64
GN4 ADOBE PLUG-INS
CreatePageWithTemplate
• create the extDoc from the page. Parameters: • server – location of the server • pageId – the id of the pageId • templateId – the id of the template to use to create the extDoc from
CreateEditionWithTemplate create all the extDoc’s in the edition from the page. Parameters:
• server – location of the server • pageId – the id of the pageId • templateId – the id of the template to use to create the extDoc from
CreatePage create the extDoc from the page. Parameters:
• server – location of the server • pageId – the id of the pageId
CreateEdition create all the extDoc’s in the edition from the page. Parameters:
• server – location of the server • pageId – the id of the pageId
RunServerCommand Runs the XML for GN4XMLCommand on the given server
• server – location of the server • command – the XML command
UpdateExtDocLocal version of UpdateExtDoc that uses InDesign and not InDesign Server CreatePageWithTemplateLocal version of CreatePageWithTemplate that uses InDesign and not InDesign Server CreateEditionWithTemplateLocal version of CreateEditionWithTemplate that uses InDesign and not InDesign Server CreatePageLocal version of CreatePage that uses InDesign and not InDesign Server CreateEditionLocal version of CreateEdition that uses InDesign and not InDesign Server RunLocalCommand version of RunServerCommand that uses InDesign and not InDesign Server
PAGE 65
GN4 ADOBE PLUG-INS
The Fitting Palette Plug-In Introduction Although InDesign and InCopy provide a command to resize a text box to its content there is no command to stretch or squeeze the text to fit the box nicely. An editorial system needs this function. For this project the Adobe guidelines that the working and user interface code should live in separate plug-ins has been obeyed.
Configuring the Adjustments The allowed adjustments are configured in an .XML file. The file lives in a Miles 33 subfolder of the Windows Application Data folder and has a hard-coded name. Example full path of the .XML file is C:\Documents and Settings\johnc\Application Data\Miles 33\Miles 33 Fitting.xml for Windows and Users:username:Library:Preferences:Miles 33:Miles 33 Fitting.xml for Macintosh. An example .XML file:
<changes> <expand>
<change name="point size” class="6915" max_percent="8” order="1" /> <change name="space before" class="6950" para="1" max_absolute="2” order="2" /> <change name="space after" class="6951" para="1" max_absolute="2” order="2" />
</expand> <shrink>
<change name="point size” class="6915" max_percent="8” /> <change name="space before" class="6950" para="1" max_percent="20” order="2" /> <change name="space after" class="6951" para="1" max_percent="20” order="2" />
</shrink> </changes>
The names are not used in the code, but may make the file easier to understand. The class numbers are magic numbers from the API – see TextAttrID.h. Note that kTextAttrPrefix = 0x1B00 = 6912. These numbers allow the adjustments code to modify the text and paragraph attributes without knowing anything about typography. The para tag allows the code to distinguish paragraph attributes from character attributes. The default for para is zero, meaning not a paragraph attribute. The max_percent figure is the maximum allowed percentage change – in the first example here, the point size can be increased by up to 8%. The default is zero. The max_absolute figure is the maximum allowed change in a numeric or distance attribute. If the attribute is a distance, then this is a number of points. In the example here, the space before and after each paragraph can be expanded by up to 2 points. The default is zero. The order figure groups the adjustments into sets. All the adjustments with order equal to 1 will be made before any of the adjustments with “order” equal to 2; and so on. In this example, the point size will be expanded by up to 8% and only then will it start to expand the paragraph space. The default is 1.
PAGE 66
GN4 ADOBE PLUG-INS
The Back-End Plug-In The back-end plug-in provides three commands as an API extension suite, acting on the current selection. It also provides the first two functions to be called as Adobe commands targeted to a particular box, selected or not. Palette Buttons and Adjustment Value
There are two buttons on the palette and an adjustment value box. The Buttons are for: • Fit text to box – perform the balancing (fit text to box) function utilising the methods
described to adjust space evenly between minimum and maximum processing values • Undo fit text to box – undo any balance (fit text to box) adjustments that have been applied
To the right of these buttons is the % of adjustment parameters utilised, either positive (additional space) or negative (removal of space), to achieve the current balance. For full documentation on the Miles 33 Fitting Palette see the Miles 33 FutureProof Editorial Module qScribe Tools User Guide. Fit Text to Box The algorithm goes like this:
• If the text has previously been adjusted, remove last time’s adjustments. • If the text is currently overset:
Try the maximum allowed amount of shrink. If the text is still overset Give up – there is too much text
Choose the minimum amount of shrink that fixes the overset • Otherwise
Try the maximum allowed amount of stretch If the text is now overset
Choose the minimum stretch that does not overset Otherwise, if the box still has plenty of spare space
Give up – there is too little text Otherwise
Retain this maximum stretch The adjustments are then saved as a box slug. Undo Fit Text to Box If the current box has a slug encoding last time’s adjustments, then this command undoes the adjustments. Example: If the adjustment changed 12-point text to 12.567- point text, then this command will find any 12.567-point text and change it to 12-point. This is independent of the usual undo mechanism. For example, a user can fit the text to the box, then fix a couple of typos, and then ask for the fitting to be undone. This will undo the fitting without losing the typo fixes.
PAGE 67
GN4 ADOBE PLUG-INS
Retrieve Fitting Descriptions If the current box has a slug encoding last time’s adjustments, then this command retrieves the adjustments. The Right Click Menu The user interface plug-in adds commands to the right-click menu, Miles 33 Fit text to box and Miles 33 Undo fit text to box, just below the built-in Text frame options command. The extra commands will only be present when they are relevant. The user interface plug-in also adds Miles 33 Fitting to the Window menu; this command shows a small palette with two buttons and a feedback area. The feedback is a single percentage, for example, -33% to show that the text had to be shrunk, and that 33% of the permitted adjustments were used. Fitting Palette Plug-In Caveats The Descenders of the Last Line of Text If the bottom text inset is too small, the descenders of the last line may dangle past the end of the box. This is standard Adobe behaviour, but is different from the corresponding QuarkXPress behaviour. As a special case, the final line of text may become unreadable if the box has a frame and the descender’s overlap the frame. Deciding Whether Adjustments are Necessary and if a Box is Full Testing for overset text is clear-cut, but it is difficult to work out whether a box is full. Suppose the only allowed expansion is to the inter-character and inter-word spacing; and that using 20% of the limits gains one line and that using 80% of the limits gains another line causing an overset. The current algorithm will choose to use 79% of the allowed expansion. It can see that 80% is too much, but will assume that the box is filled more neatly by using 79% of the limits than at any lower percentage. In this case a human would have chosen 20% of the allowed expansion, knowing that the 20-79% range merely damages text without filling the box any further.
Editing the Configuration File For now the adjustments and limits will be agreed when the software is installed so that the configuration file can be set up by hand and then left alone. Moving Between Adobe Applications Fitting instructions carried out in InDesign cannot be undone in InCopy and vice versa.
PAGE 68
GN4 ADOBE PLUG-INS
The InDesign Rule Palette Plug-In Introduction The code has been ported from the equivalent QuarkXPress XTension, with the functionality basically the same for drawing vertical, horizontal and rule around rules.
Palette Rule Buttons and Configuration Parameters Palette Buttons Rule buttons are displayed for:
• Gutter Rule – adds continuous gutter rules to a box, page or spread avoiding all other items on the page.
• Horizontal Rule – adds a continuous horizontal rule to a page avoiding other items on the page.
• Rule Off – adds continuous rules to rule off any advertising placed on a page by tracing around the advertising shapes.
• Rule Around – adds rules to rule around a single shape or multiply selected shapes by tracing around the selected items.
• Extend Selection - If you select a rule and then click the Extend Selection button, the other related rules will be added to the selection. You can then delete them all, or perhaps use other InDesign tools to re-colour them, etc.
Palette Configuration Parameters The rules adhere to parameters specified on the palette, including:
• W – Weight – The rule weight to draw the rule • M – Minimum length of rule – minimum rule length that can be drawn by the function, if it
would draw a rule of less length than this the rule is not drawn • T – Top Space – white space left at the top when a rule meets another item • B – Bottom Space – white space left at the bottom when a rule meets another item • A – Around Space – white space left all around the shape when drawing a Rule
Around. For full documentation on the Miles 33 Rule Palette see the Miles 33 FutureProof Editorial Module qScribe Tools User Guide.