Customizing the Export to Digital Publishing Suite

Customizing the Export to Digital Publishing Suite
Customizing the Export to Digital Publishing
Suite
Overview / Adobe Experience Manager / Adobe Experience Manager 6.0 / Developing / Extending AEM Features / Extending
Publications /
Publications installs a default Content Sync configuration template that generates the files that are uploaded
to Digital Publishing Suite.
You can customize this template so that it supports your Publications applications. The template is located in
the folder:
/etc/contentsync/templates/dps-default
NOTE
The Geometrixx Unlimited sample installs the following template that you can use as a learning
tool:
/etc/contentsync/templates/dps-geometrixx-unlimited template
COPYING THE DEFAULT CONTENT SYNC TEMPLATE
Create a copy of the default Content Sync template that is provided for pushing publications to Digital
Publishing Suite. After you create the copy, you can make changes as required.
NOTE
After you copy the node, configure the dps-exportTemplate property of your issue page template
accordingly.
1.
2.
3.
Open CRXDE Lite in your web browser. (http://localhost:4502/crx/de)
Right-click the /etc/contentsync/templates/dps-default node and click Copy.
Right-click the /etc/contentsync/templates node and click Paste.
4.
The name of the copied node is Copy of dps-default.
Right-click the Copy of dps-default node, click Rename, and type a new name.
INCLUDING HTML RESOURCES
When your Experience Manager application includes custom Client Library Folder defintions, you need
to include the generated CSS and JS files in the ZIP file that is uploaded to Digital Publishing Suite. The
dps-default template includes the dps-HTMLResources node where configuration nodes of type clientlib
are saved. The clientlib configuration type is a standard type that Content Sync provides for caching these
generated library files.
1.
2.
3.
4.
Right-click the dps-HTMLResources node in your configuration template and click Create, then Create
Node, provide the following values, and click OK:
• Name: A descriptive name that is unique from sibling nodes. Typically, the name ends with the
same file name extension as the targeted file.
• Type: nt:unstructured
Add the type property to the node:
• Name: type
• Type: String
• Value: clientlib
Add the following property to specify the location of the client library file:
• Name: path
• Type: String
• Value: The path to the cq:ClientLibraryFolder node.
Specify the type of generated file to include:
• Name: extension
© 2012 Adobe Systems Incorporated.
All rights reserved.
Page 1
Created on 2015-01-21
Customizing the Export to Digital Publishing Suite
•
•
5.
Type: String
Value: Use:
• css to include the generated CSS file
• js to include the generated JS file
Click Save All.
INCLUDING HTML PAGES
When your Publication articles include separate HTML pages as content (HTML pages that are not articles),
you need to add the HTML pages to the resources ZIP file that is uploaded to Digital Publishing Suite. The
following configurations cause the HTML file to be included:
• The HTML file is represented as a cq:Page resource and is a child of the article node.
• The dps-HTMLResources node of your copy of the dps-default template has the dpsincludeSubPages property set to true.
NOTE
To incorporate the content of an HTML file into an article, you can create a custom component.
For example, the component JSP can read the content of the file and insert it into the article
HTML code.
How to create such a component is beyond the scope of this topic.
1.
2.
3.
Use CRXDE Lite to select the dps-HTMLResources node of your Content Sync template, for example:
/etc/contentsync/templates/dps-geometrixx-unlimited/dps-HTMLResources
Add the following property to the node:
• Name: dps-includeSubPages
• Type: Boolean
• Value: true
Click Save All.
TESTING HTML RESOURCES
You can generate the the HTML resources for your folio. and save them to your file system, so that you
can verify that they are complete. To generate the HTML resources, you must have already configured a
connection to Digital Publishing Suite.
Testing HTML Resources - Touch-Optimized UI
1.
2.
3.
In the Publications console, navigate to and select (using selection mode) the folio or a page(article) of
the folio.
Using the Publish icon:
Select Export HTML Resources.
Save the HTMLResources.zip file to your file system. You can now expand the archive and verify the
contents.
Testing HTML Resources - Classic UI
1.
2.
3.
4.
5.
Open the Publications console in the classic UI:
http://localhost:4502/publishingadmin#/content/publications
In the publications tree, select the folder that contains the folio.
On the right-hand pane of the Publications console, double-click the folio.
Click Folio Actions, then Export HTML Resources.
Save the HTMLResources.zip file to your file system. You can now expand the archive and verify the
contents.
© 2012 Adobe Systems Incorporated.
All rights reserved.
Page 2
Created on 2015-01-21