jueves, 5 de septiembre de 2013

Authoring Tools for Sharepoint – Adobe Robohelp 10

 

Introduction

What ‘s Robohelp?

Adobe Robohelp is a tool which allows us to create help pages with different types of output formats  as Html5, Flash, Epad (Ebooks) or a standard creation Webhelp among others.

On this occasion we built a project using version 10, where one of the main innovations compared to previous versions is the possibility of a solution in HTML 5 with multi-display support for viewing on different devices.

Another of the best features was the compatibility with SharePoint 2010. Although you can also do it with SharePoint 2007 to synchronize with the site with some extra settings not mentioned by adobe and explained below.

RoboHelp 10 allows us to import documents in various formats and develop a fast solution including tables of contents (TOC), Indexes, Glossaries, Links between documents, help personalize our website and search the content.

Although the Web Help customization is limited in regard to the design of the created page, but allows to include buttons for the navigation table and the contents, which gives the choice of adding custom JavaScript functions.

It ‘s also available the creation of the page using HTML 5 which allows customization of a Skin for each device by using a code editor within the application and the ability to define the output size for each screen viewing the site on the fly.

Basic use on this sample

image

Purpose

The aim of this paper is to analyze the pros and cons of Adobe RoboHelp.

For these comparisons will be made against other programs Authoring Tools and identifying problems and constraints found in the implementation and possible resolutions for them.

Advantages

  • Creating Html5 sites (Multiscreen)
  • Customizing Site Skin we believe (Creating new buttons, incorporating JavaScript functions).
  • Creating Toc (Table of Contents) simply, in different languages
  • Support SharePoint 2007 and 2010.
  • Pdf file support.
  • Customization of the various output screens HTML 5 (Desktop, # iPhone, # iPad, Kindle Fire)
  • Adobe Online Support (Chat Online and Remote Control for troubleshooting.)

 

Disadvantages

  • It ‘s needed additional configurations on SharePoint 2007 , unspecified on documentation.
  • While it has compatibility with Word in some cases does not keep the format of the text of the document.
  • It supports Word Graphics or aggregates.
  • Search function does not support external metadata.
 

Comparative with similar applications

 

 

Adobe Robo Help 10

Mad Cap Flare V9

HelpServer

Author-it

Backup

X

X

X

 

Supports Html 5

X

X

   

Html5 Edition

X

     

Multi-screen Display HTML5 with different devices

X

     

supports Microsoft Word 365

 

X

   

Css Editor

X

X

X

X

Supports Windows 8

 

X

   

Vectors

 

X

 

X

Imports PDF

X

     

Generates app for Android and iOS

X

     

Native output for SharePoint publishing

X

     

HTML: on editor

X

     

DITA Output

 

X

X

X

FlashHelp

X

     

Ebook

X

X

X

 

FrameMaker (.book)

 

X

   

DocBook

X

     

Hyperlinks

X

X

 

X

Bookmarks

X

X

   

Skin on different languages

X

X

   
         

 

Solving some Problems with robohelp

Configuring SharePoint 2007 and RH 10

Here is a series of steps to be done  so as to publish our WebHelp on a SharePoint library previously created.

1. Add network location and add the URL of the site

Example

http://bfdev22:1988/sites/LegalCases (server name + port + Name Site Collection)

2. Steps in RoboHelp

Within our WebHelp settings add or modify a Server to publish.

You must enter the following path considering the route used previously

\\bfdev22@1988\DavWWWRoot\sites\LegalCases\Info\English (server name + port + DavWWWRoot + + Library Collection Site Name + Folder)

 

Some Problems importing from Word

Although RoboHelp has support for importing Word documents often happens that you do not keep the original document format.

That's why here it’s mentioned some patterns which must be followed.

1. Among the titles and subtitles must have spaces not display the symbol "-". This is automatically generated by RoboHelp to generate Webhelp.

You have to avoid grouping the texts and images inserted so as to avoid it to happen.

2. The images displayed in the manuals should be. Jpg or. Gif, since other graphic (arrows text boxes etc..) created in Word are not displayed correctly by the application. That is, if you incorporate graphics, arrows or other elements to an image, you must group all together and save them as a single image in. Jpg or. Gif.

3. For A4 pages paragraphs width 21 cm should be applied to all texts. Because that is the size of documents created in Word to respect the space mainly in the indexes.

4. Indices: indices should be used with links (hyperlinks) to different parts of the document, otherwise Robohelp recognize us and we will have a way to move around the document.

Especificaciones Técnicas

· Intel® Pentium® 4

· Microsoft® Windows® 7, Windows Vista® with Service Pack 2, or Windows XP with Service Pack 3

· 1GB of RAM

· 3.1GB of available hard-disk space for installation; additional free space required during installation (cannot install on a volume that uses a case-sensitive file system or on removable flash storage devices)

· DVD-ROM drive

· 1024x768 display (1280x800 recommended) with 16-bit video card

· This software will not operate without activation. Broadband Internet connection and registration are required for software activation, validation of subscriptions, and access to online services.^ Phone activation is not available.

While technical specifications recommended by Adobe are those mentioned, with the use of the application we realized that they are not sufficient for heavy documents containing many images and number of pages. In these cases the program to open the document in edit mode takes longer than normal and used a high consumption of resources.

We recommend using a computer with more memory and better rendering processing documents.

 

Screen of a published content on Sharepoint

Captura RH

Thanks to Nicolas Salafrica for this article contribution.