The Multiscreen HTML5 SSL helps you generate output for screen profiles of your choice.
1)In the Single Source Layouts pod, double-click the Multiscreen HTML5 SSL.
note: If the project you have opened was created in a previous version, you will need to create a Multiscreen HTML5 layout. In the Single Source Layouts pod, click the Create Layout icon and select Multiscreen HTML5 as the output type.
2)In the General tab, set the following options:
Title Bar
Specify the title you want to display in the title bar.
Favicon
Specify an icon to associate with the output. The icon appears in the browser tab or the address bar depending on the browser being used.
Output Folder And Start Page
Specify a location and start page for the output. To choose a location for the output folder, click the browse button. To select a start page other than the default for the output, enter it using the .htm extension. The start page is the home page of the output.
3)Click the Screen Profiles tab. Notice that a set of screen profiles are mapped to screen layouts. One of these screen profiles is set as the default screen profile (by default, Desktop is set as the default screen profile).
•Change the default screen profile if required. Select the screen profile you want to set as default and click Set As Default.
note: The default screen profile is used if the resolution of the device from which the output is being launched does not match any screen profile.
•Change the order of screen profiles if required by clicking Move Up or Move Down.
note: If the resolution of the device from which the output is being launched matches two screen profiles, the order of the screen profiles in the SSL settings determines the screen profile to be used.
•Add new screen profiles that are available in your project. Click Add Screen Profile and select screen profiles from the list.
•Remove screen profiles for which you don’t need to generate output. Select the screen profiles from the Screen Profiles list and click Remove Screen Profile(s).
•Map screen profiles to screen layouts.note: Click Preview to preview a mapped screen layout.
4)Expand the Screen Profiles tab and for each screen profile, specify the following settings:
Table Of Contents
Select the TOC to be displayed in the generated output. See TOCs.
Index
Select the index to be displayed in the generated output. See Indexes.
Glossary
Select the glossary to be displayed in the generated output. See Glossaries.
Variable Set
Select a variable set to override the default variable set in the generated output. See User-defined variables.
Default Topic
Select the topic that appears when the output opens. By default, the first topic in the table of contents is the default topic.
Language
Specify the output language for the layout if the language is different from the language of the project. RoboHelp uses this language setting for the UI strings and language-related UI elements in the preview and generated output. See Change project settings.
Encoding
Specify the character encoding format if the web server to which you’re publishing has character encoding different from UTF-8.
Map Files
Specify the map files that contain topic IDs associated with map IDs to provide context-sensitive Help. See Map files and map IDs.
Browse Sequences
Select the browse sequences to display. See Browse sequences.
Conditional Build Expression
If you have conditional tags in the project, click Define to specify conditional build expressions. See Conditional build tag expressions.
Apply To All Topics
Select this option to apply master pages or CSS at the project level:
Master Page
The selected master page overrides the settings of all the individual topics with or without a master page applied to them in the project. The CSS and layout of the master page override the CSS and appearance of all the topics. If the selected master page does not have a header or footer, no topic displays a header or footer irrespective of if it had one header or footer defined.
CSS
The master pages associated with individual topics become effective. The selected CSS overrides all the topics and their CSS irrespective of whether they are associated with a master page or not.
See Applying a master page or CSS at the time of generation.
Exclude Unreferenced Topics From Output
Select this option to exclude any topic that exists in the project but is not the default topic in the layout or is not referenced from the selected TOC, index, or browse sequence, or any referenced topic.
note: RoboHelp displays the unreferenced topics that are excluded from the output in the Output View pod.
Exclude Unreferenced Baggage Files From Search
Select this option to exclude any topic that exists in the project but is not referenced from the selected TOC or any referenced topic (if Exclude Unreferenced Topics From Output is selected). If Exclude Unreferenced Topics From Output is deselected, RoboHelp excludes baggage files that are unreferenced from any topic in the project.
5)For each screen profile, specify the following settings in the Search tab:
Enable Substring Search
If you enable this feature, a search for "log" returns topics containing the words "catalog" and "logarithm." Substring search takes longer than whole-string search.
Enable External Content Search
Select to display content from identified URLs outside the project output. For information about how to specify URLs and associate them with search terms, see External content search.
Show Context In Search Results
Select to have the search results displayed along with the first few lines of the topic. You can specify the maximum number of characters to show as the context.
Exclude Baggage Files Types From Search
Select the types of baggage files to exclude from search.
Number of Results On A Page
Select the number of search results to display on a page.
6)For each screen profile, specify the following settings in the Optimization tab:
Convert Auto-sizing And Custom-sized Popups To Hyperlinks
Select this option to make sure that hyperlinks configured to display in auto-sizing or custom-sized pop-ups are converted to flat hyperlinks.
Convert Text-only Popups To Hyperlinks
Select this option to make sure that text-only pop-ups are converted to flat hyperlinks.
Convert Absolute Image Size To Relative Image Size
Select this option to convert the actual width and height of images into percentages. In this way, you can make images used in your project device-friendly and adapt to different device sizes.
Convert Absolute Table Size To Relative Table Size
Select this option to convert the actual width and height of tables into percentages. By allowing RoboHelp to optimize the tables in this way, you ensure that the tables adapt to different device sizes.
Enable Zoom On iOS Devices
Enable or disable pinch zoom on the iPad and the iPhone. When this option is enabled, users can zoom in on a RoboHelp output displayed on an iPad or iPhone by pinching the device screen.
Use Adobe Captivate HTML5 Output
Select this option to use Adobe Captivate HTML5 output instead of Adobe Captivate SWF output.
note: Adobe Captivate HTML5 output must be available for demos that are imported or inserted in the project.
Limit The Scope Of Project Styles Only To Topic Contents
Select this option to do the following:
•Prevent the styles defined in project style sheets (CSS) from overriding the styles defined in the screen layout CSS
•Prevent topic and screen layout style sheets (CSS) from overriding the CSS used by SharePoint master pages
Example: Your project CSS may contain the style:
div{
color:red;
}
If the layout CSS also contains a div style but with a different color and if this setting is not selected, the project definition could undesirably override the layout definition applying red.
7)(Optional)In the Publish tab, set the following options:
Servers
Specify a server location for the output. To publish the HTML output to a SharePoint site, click New and select SharePoint. Enter the UNC path of the folder on the SharePoint site (If the folder is mapped as a network drive, click Browse to select the drive).
Options
Specify how to handle changes to files in the output:
Check For Deleted Files
If selected, RoboHelp HTML checks for files that have been deleted from the destination location and republishes them.
Prompt Before Overwriting Files
If selected, RoboHelp prompts you before overwriting files.
Republish All
Select to republish all files to the destination target. For master projects with a copy of the subproject in the subfolder, do not select Republish All. You then avoid overwriting output files already published to the same location.
note: If you change the destination to a new host, specify the user ID and password and save the password in the registry, if necessary.
8)(Optional) In the SharePoint (Native) tab, set the following options to publish output in the native (.aspx) file format:
SharePoint Version
Select either SharePoint 2007 or SharePoint 2010+.
Publish Location:
Depending on the version you select, do one of the following:
•If you selected SharePoint 2010+, click Browse, enter the SharePoint site path and credentials in the Connection Details dialog box; and then select the SharePoint document library and the folder where the output is to be published.
•If you selected SharePoint 2007, enter the SharePoint path to which the output is to be published.
Publish To SharePoint
Files are published to SharePoint only when this option is selected. Also specify the following:
•Check For Deleted Files:If selected, RoboHelp HTML checks for files that have been deleted from the destination location and republishes them.
•Prompt Before Overwriting Files: If selected, RoboHelp prompts you before overwriting files.
•Republish All: Select to republish all files to the destination. For master projects with a copy of the subproject in the subfolder, do not select Republish All. You then avoid overwriting output files already published to the same location.
Advanced Options
Specify the following options:
•Output Folder:Local folder for saving generated SharePoint output. This option is usually populated automatically. You should need to specify the output folder only if you’re working with merged projects.
•Generate SharePoint Native Output Before Publishing:Select this option to pregenerate ASPX files. If this option is not selected, RoboHelp generates the normal HTML files and then displays a dialog box allowing you to select whether to publish them. Clicking Publish causes RoboHelp to generate the ASPX files and upload them to SharePoint.
9)(Optional, in addition to step 8)RoboHelp lets you assign a SharePoint master page to each screen profile in the Multiscreen HTML5 SSL. You can also choose not to assign a SharePoint master page. Select one of the following options for each screen profile:
Site Master Page
Enter the master page path relative to the site.
Root Site: example.com
SharePoint site: example.com/robohelp
Master page is at:example.com/robohelp/doclib/minimal.master
Specify the path as doclib/minimal.master.
System Master Page
Use the master page defined as the default master page for system pages in SharePoint.
Custom Site Master Page
Use the master page defined as the default master page for sites in SharePoint.
Site Collection Master Page
Specify the master page path relative to the Site Collection (root of the site).
For example:
Root Site: example.com
SharePoint site: example.com/robohelp
Master page is at: example.com/robohelp/doclib/minimal.master
Specify the path as /robohelp/doclib/minimal.master.
None
Do not apply a master page to SharePoint output. The output is displayed as ASPX pages without the SharePoint chrome.
Recommendation: To view Multiscreen HTML5 output optimally on SharePoint, ensure that your SharePoint master pages are HTML5-compliant. Otherwise, some HTML5 content or Multiscreen HTML5 options, such as the following, may not work for Multiscreen HTML5 output published on SharePoint:
•HTML5 videos (without a plug-in)
•The following options on the Optimization page in the Multiscreen HTML5 Settings dialog box:
•Convert Absolute Image Size To Relative Image Size
•Convert Absolute Table Size To Relative Table Size
•Use Adobe Captivate HTML5 Output
•(Only in Internet Explorer) Hint text is not removed from the search field in the published SharePoint content even when the user clicks the field to enter a search string. The user must manually delete the hint text.
•Minor layout issues