Content Services ES2: Improving performance

Thumbnail image for livecycle.jpg

You can disable content indexing to improve Content Services ES2 performance. However, keep in mind that disabling indexing will also disable text-based search within new content. To disable indexing:
  1. In the adobe-contentservices.ear file, navigate to
    LiveCycle Content Services.ear/contentservices.war/WEB-INF/classes/alfresco/model and open the contentModel.xml file for editing.
  2. Locate the following line:
    <type name=”cm:content”>
  3. Set the index enabled and tokenized properties to false.
  • Change <index enabled=”true”> to <index enabled=”false”>.
  • Change <tokenized>true </tokenised> to <tokenized>false </tokenised>.
For additional performance improvements, you can disable the conversions required for indexing. To disable conversions:
  1. In adobe-contentservices.ear, browse to
    contentservices.war\WEB-INF\classes\alfresco\extension.
  2. Preserve a backup of the custom-metadata-extractors-context file.
  3. Delete this file from the EAR.

RoboHelp tips article in Indus

RH-icon.jpgNandini Gupta and I recently contributed an article on our favorite RoboHelp tips to Indus, the newsletter of the India chapter of STC. Check out the article here!

The May issue of Indus carried an article on my favorite FrameMaker tips. Check that one out here!

FrameMaker tips article in Indus

FrameMaker iconI recently contributed an article on my favorite FrameMaker tips to Indus, the newsletter of the India chapter of STC. Check out the article here!

Embed a TOC in a FrameMaker document

FrameMaker iconLet’s discuss an easy way to embed a file-level TOC in a FrameMaker document. We’ll generate a standalone TOC for the document and then import it by reference into the same document.

Here’s how:

  1. Open the FrameMaker document.
  2. Click Special > Table of Contents. When FrameMaker prompts if you want to create a standalone TOC, say Yes.
  3. In the Set Up Table of Contents dialog, select the paragraph tags that you want to include in the TOC. Click Set. FrameMaker creates a separate TOC file and stores it in the directory where your FrameMaker document is stored.
  4. Open the new TOC and format it as necessary. You may want to change the font styles/sizes for the TOC paragraphs and set tab stops/leaders.
  5. 1.jpg

  6. Now, open the parent FrameMaker document, place the cursor at the intended insertion point (usually the beginning of the file), and then click File > Import > File. Select the external TOC file and click Import.
  7. Retain the default settings in the Import Text Flow by Reference dialog box and click Import. FramaMaker imports the TOC by reference into the parent document.
  8. 2.jpg

Now, whenever you update the external TOC, simply select the embedded text inset in the parent document and click Update in the Text Inset Properties pod.

3.jpg

Here’s some further suggested reading:

Top ten FrameMaker conversion tips

Simon Bate has posted his top ten FrameMaker conversion tips over at the Scriptorium blog. Pretty interesting stuff! Do take a look.

As for our FrameMaker tips that he refers to in his post, you can download the PDF from this link.

Enjoy!

RoboHelp: Printed documentation error

The Word VBA macro version registered is incorrect. Please reinstall printed documentation.

If you encounter the above error message while trying to generate printed documentation from a RoboHTML project, change the macro security settings in Microsoft Word.

Follow these steps to change the macro security settings in Word 2007:
  1. Click the Office button > Word options > Trust Center > Trust Center Settings.
  2. Change Macro Settings to Enable all macros and then click OK.
  3. Generate printed documentation output from RoboHTML.
Peter Grainge has a useful page on his website summarizing RoboHelp print issues. Do take a look!

Find: Much beyond text…

FrameMaker iconYou can use the Find/Change feature in FrameMaker to look for many different kinds of objects across a book or in a document.

Find.jpg

In particular, Find Unresolved Cross Reference saves me grueling hours of troubleshooting when I’m generating PDFs.

Read more about the search functionality in FrameMaker in this Help article. For tips and best practices on creating PDFs from FrameMaker documents, see this handbook.

PDF watermarks: Settings that work for me

When you add watermarks to a PDF document, you want them to be visible unobtrusively. The following settings for the Watermark tool in Acrobat (Document > Watermark > Add) work best for me:

Font: Arial
Size: Varies. For shorter watermarks like the word Draft, 72 pt works well.
Color: Pure red (R: 255, G: 0, B:0)
Rotation: 45°
Opacity: One notch above zero on the slider (12%)
Location: Appear on top of page

Watermark.jpg

If required, you can specify different watermarks for different sets of pages. Click Page range options in the Add Watermark dialog box to do this.


To understand how you can work with watermarks in Acrobat 9, see this Help article.

Enable PDF text edits for text embedded in a screenshot

Acrobat icon.jpgConsider you have to complete a UI content review for the product you work on. Wouldn’t things be easier if you could use Acrobat text-edit-markup features to highlight the relevant content embedded in images? Of course, you can always add a sticky note in an approximate location, but that isn’t quite as effective!

So how do you enable PDF text edits for embedded text? Here’s how:
  1. Paste the screenshot in your favorite word-processing or layout tool. For example, FrameMaker.
  2. Generate a PDF of the page containing the screenshot.
  3. Open the PDF in Acrobat and select Document > OCR Text Recognition > Recognize Text Using OCR.
  4. Once the text recognition process is over, you’ll be able to select the embedded text and use the Acrobat text edit tools on it.
Screenshot for blog post.jpg
This Help article discusses Acrobat text edit features in greater detail. For more information about the OCR features in Acrobat 9, refer to this Help article.

Automating conference registration using LiveCycle Designer

livecycle.jpgLast year, I had an opportunity to help automate the registration process for the STC India Conference 2009. I created a PDF form using LiveCycle Designer and designed a simple workflow around it.

The presentation at this link discusses this workflow, together with guidelines for both form authors and end users. A snapshot of the workflow is captured in the schematic below.

workflow.jpg

Some 475 delegates registered using the form without any glitches.

Conference registration is, of course, just one of the examples of the numerous processes that you can automate using LiveCycle Designer. The tool is easy-to-use and provides templates and boilerplate forms that you can customize for your requirements. Through custom JavaScript/FormCalc scripting, you can easily fine-tune any aspect of the PDF form. For example, in the form in question, I used JavaScript to allow “conditional access” to fields. Thus, “field A” accepts input only when “field B” has a certain value, and so on.

If you are looking for the right learning resources to get started with LiveCycle Designer, refer to Adobe LiveCycle Designer ES2 Help (HTML). If you are looking for more information about the product or want to download a free trial copy, visit this page.