Part 3

NEWS & TIPS

  • Site Access Keys
  • Top: Alt+t
    Previous: Alt+,
    Next: Alt+.
    Up: Alt+;
    (Note: use Ctrl on the Mac)

Set up PDF, Printer Friendly, and XML Configurations

With the simple demo site integrated, you can take advantage of more system functionality and set up a PDF, printer friendly, and XML version of the pages. First, you need to set up the publishing targets. New targets are needed to specify a new type of page output. The target used in the previous two technical documents was an HTML target, and the pages associated used a HTML output. Now, you need to setup targets that have different output types.

Tech intro 3 image 1
First, you will create a PDF target.

A. Create a PDF Target

To set up a PDF target:

  1. Go to the Administration area, and select Targets & Destinations from the left navigation bar.
  2. Click on the web target, and then click New Target.
  3. For the Name field, type pdf.
  4. For the Base Folder field, select the top-level folder of the specific site being managed. In our case, we will use /web.
  5. For the Output File Extension field, type .pdf.
  6. For the Type of Data field, select PDF from the drop down.
  7. For the Internal Links option, check the box for Include Target Path. This field lets the system know that the path of the target should be part of the publishing output folder and that the links should have this path taken into account.
  8. Click Submit to save the new target.

Tech intro 3 image 2

Now with the new target in place, you need to set up a destination to have the PDF content published.

To set up a destination:

  1. Click on the new target located in the asset tree. In our case, we will select /web/pdf.
  2. Click New Destination.
  3. For the Name field, type in Local.
  4. For the Transport field, select an existing transport. We will select Filesystem followed by Server Hard Drive.
  5. Select all groups in the Applicable for Groups field, and click the green arrow to have the selected items moved to the box on the right.
  6. Now click the Submit button to save the new destination.

Tech intro 3 image 3

B. Create a Printer Friendly Target

With the PDF target and destination in place, you can up a similar set for printer friendly.

To set up a printer friendly target:

  1. While still in the Administration area under Targets & Destinations, click on the web target, and then click New Target.
  2. For the Name field, type printer.
  3. For the Base Folder field, select the browse icon and choose the main asset folder for the site. In our case, we will select /web.
  4. For the Output File Extension field, type in .html.
  5. Check the Internal Links box for Include Target Path.
  6. Click the Submit button to save the new target.

Now set up a new local destination for the printer target in the same way it was completed previously for the pdf target. With a printer friendly target and destination in place, you can set up the final XML target.

C. Create an XML Target

To set up an XML target: 

  1. While still in the Administration area under Targets & Destinations, click on the web target, and then click New Target.
  2. For the Name field, type xml.
  3. For the Base Folder field, click the browse icon, and select the main asset folder for the site. In our case, we will select /web.
  4. For the Output File Extension field, type .xml.
  5. For the Type of Data field, select XML from the drop down.
  6. Check the Include Target Path box for Internal Links.
  7. Click the Submit button to save the target.

Now set up a new local destination for the xml target in the same way it was completed previously for the pdf target.

D. Create a PDF Template

With the three targets in place, you are ready to set up the new templates. The first template you will create is for PDF generation.

To set up the PDF template:

  1. Go to the Home area, and browse to your templates folder. In our case, we will use /web/templates.
  2. Click New -> Default -> Template in the top navigation menu.
  3. For the XML field, please type the following:
  4. Check the box Convert HTML to XHTML. This automatically creates XHTML blocks for the PDF-HEADER and PDF-FOOTER regions and adds additional fields in the portion of the template.
  5. Now select the System pane. For the System Name field, enter pdf.
  6. For the Target field, select your new PDF target. In our case, we will select /web/pdf.
  7. Now select the Regions pane. For the Stylesheet field, click the browse icon and select /common/stylesheets/output/xhtml2fo2pdf. For this example PDF template, you’re actually just producing HTML and having the HTML converted to XSL:FO and then transformed into PDF. You can generate PDFs directly from XML without going through HTML, but for the purposes of this example, it is easier to first use HTML. Please see Google for more information about XSL:FO and the powerful capabilities it provides.
  8. Click the Submit button to save the new template.
Tech intro 3 image 4

E. Create a Printer Friendly Template

With the PDF template in place, you need to create the printer friendly template.

Tech intro 3 image 5

To create the printer friendly template:
  1. Browse to the templates folder for the site, /web/templates.
  2. Select New -> Default -> Template from the top navigation menu.
  3. For the XML field, type:
  4. Check the box that says Convert HTML to template XHTML.
  5. Now select the System pane. For the Name field, type printer.
  6. For the Target field, select the new printer friendly target created earlier. In our case, we will select /web/printer.
  7. Click the Submit button to save the template.

Now with the PDF and printer friendly templates in place, you need to create the final XML template.

F. Create an XML Template

To create an XML template:
  1. Select the templates folder for the specific site. In our case, we will select /web/templates.
  2. Click on New -> Default -> Template in the top navigation menu.
  3. For the XML field, type:
  4. Now select the System pane. For the System Name field, type xml.
  5. For the Target field, choose your XML target created previously. In our case, we will choose /web/xml.
  6. Now click the Submit button to save the new template.

With the three templates and targets in place, you only need to add the templates to the page configuration set to see the new content formats.

G. Attach Templates to a Configuration Set

To add new configurations to a configuration set:
  1. Go to the Administration area, and select Configuration Sets from the left navigation bar.
  2. Select the specific configuration set for the site. In our case, we will choose the Web Standard configuration set.
  3. Click the Edit tab, and select the Configurations pane.
  4. Scroll down past the default configuration to the section labeled Add.
  5. For the Template field, click on the browse icon to choose your new PDF template. In our case, we will choose /web/templates/pdf.
  6. For the Name field, type PDF.
  7. Click Add this new configuration.
  8. You will be forwarded to the properties for the new configuration (located under the Configurations pane, in the Edit tab), which includes the regions it has inherited from the template. Click Submit to save the changes.
  9. Repeat this process two more times creating the Printer Friendly and XML configurations with corresponding templates.

Tech intro 3 image 6
With the configuration set updated, you can go to your pages and preview the repurposed content for the new output formats. Your final task is to make the different page formats available as links on the standard HTML configuration.

H. Configuration Hyperlinks from a Template

When a page has multiple configurations, you need a way to navigate between them. A simple system-page-output attribute can be placed inside of conventional HTML anchor tags to enable end users to switch between different configurations for a page via standard hyperlinks. These hyperlinks will be accessible both within the system and on published page(s).

To link other configurations within a configuration set from a template (or any other XML/XHTML):

  1. Go to the Home area, and browse to the standard HTML template used for the pages. In our case, we will select /web/templates/standard.
  2. Click the Edit tab.
  3. Create a standard HTML anchor tag without any attributes for your desired configuration. In order for the system to find the desired configuration, use the system-page-output attribute with the name of your target matching the target used in the designated configuration. After the tag in the XML field, find the place you want the links to appear and insert the following code:

    This code represents three link tags, each with a special system attribute that points to a unique target used by the chosen configuration set. The system will automatically remove this attribute and insert a correct href attribute in its place. The value of the attribute is the name of the target and should not be confused with the name of the particular configuration. In the “XML” output, even though the configuration is named “XML,” the system looks for the unique name of the target, which has also been named “xml.” The special system-page-output attribute is only valid for page configurations that are contained within the same configuration set (i.e. an XML configuration from another configuration set has to be linked in a different manner).
    Note: If you don’t know where the code should go, just put it after the opening tag. Additionally, these link values can also go into a block or stylesheet in a template region so that only certain pages make them available (e.g. press releases).

  4. Click the Submit button to save the template.

Now, your pages are ready to go with links to the available formats.

Tech intro 3 image 7

Videos

Last modified on Mon, 14 Jan 2008 13:04:47 -0500

Comments

Top / Previous / Next / Up / Table of Contents