Help+Manual News

Archive for category CHM HTML Help

Premium Pack 4.3.0 Update: SharePoint Embedding

We have just updated Premium Pack 4 to version 4.3, with a couple of major improvements and some minor fixes and fine-tuning.

SharePoint embedding

The main change in this update is support for embedding WebHelp in SharePoint using the V3 and V4 skins. SharePoint administrators can now host WebHelp created with these skins on SharePoint site pages. This will also work on the SharePoint iOS and Android apps on tablets and smartphones. See Embedding in MS SharePoint in the Premium Pack documentation for details and instructions.

How to get the Premium Pack update

You can download and install the updated version with the download link and personal installation password you received when you purchased. If you no longer have these details please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 4 and visit our online store to purchase if you do not yet have it.

Read the rest of this entry »

No Comments

Premium Pack 4.2.1 Maintenance Update

We have just updated Premium Pack 4 to version 4.2.1. This is a minor maintenance update that adds one important new feature to the Toolbox utility, which can now edit HMXR style repository projects as well as Help+Manual projects and skins.

How to get the Premium Pack update

You can download and install the updated version with the download link and personal installation password you received when you purchased. If you no longer have these details please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 4 and visit our online store to purchase if you do not yet have it.

Main changes and new features

The main change in this otherwise minor update is the addition of the ability of Toolbox to edit style repository projects (.hmxr). This makes it possible to use the new import/export styles tool on these projects as well. You can also use the other topics tools on these projects.

In addition to this, it was found that Help+Manual continues to maintain outdated XSD schema files in some old HMXP projects. This happens when backup or other tools are used that update the XSD file timestamp to the current date, which prevents HM from identifying an outdated file. When Toolbox encounters XSD validation errors it now automatically backdates the XSD, forcing HM to update it next time the project is updated.

Toolbox changes

  • Support for editing HMXR projects
  • Check for read-only TOC and topic and files in otherwise accessible projects
  • Add/Remove prefixes: Error if a topic ID was shorter than the prefix
  • XSD validation: Force Help+Manual to update outdated XSD schema file

Skin changes

  • The variable for the “Copied!” text in the new code sample boxes was inactive in some skins.

No Comments

Premium Pack 4.2 Update

We have just updated Premium Pack 4 to version 4.2.0. This is a significant update with several new features, along with a number of minor fixes and corrections.

How to get the Premium Pack update

You can download and install the updated version with the download link and personal installation password you received when you purchased. If you no longer have these details please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 4 and visit our online store to purchase if you do not yet have it.

Main changes and new features

Version 4.2 includes a general overhaul of a lot of code, also for the update to the latest version of jQuery. Because of this, please don’t try to backport this version to older skins — use the new skins instead. It also brings three major new features:

Code Sample Box

All skins now include a Code Sample Box feature. This enables you to add programming code samples to your documentation in a box with a Copy to Clipboard link that copies the sample code directly to the Windows Clipboard. This even works in CHM files.

Import/Export Styles

The Toolbox utility has a new Import/Export Styles feature, with which you can import individual text, paragraph and table styles to Help+Manual projects from other projects and style files created with the tool. (In Help+Manual itself you can only replace an entire project stylesheet with another one.)

Validate XML against XSD

The Toolbox utility now validates XML against the XSD schema file included with every Help+Manual project. This prevents the accidental creation of invalid HM XML when working on the XML source code, for example with the search and replace tool.

jQuery Update

All skins have been updated to the latest 3.6 version of jQuery. This includes quite a lot of low-level code changes in the scripts, so please don’t try to backport the changes in these skins to older versions. Use the new skins instead.

Toolbox Utility Changes and Fixes

  • XML validation against XSD: This checks all projects and skins you open and prevents the creation of invalid XML (see above).
  • Import/Export Styles tool: Import individual styles to Help+Manual projects from other projects or style files exported with the tool.
  • Normalize Styles: Corrected an error that could incorrectly reset Bold/Underline/Italics formatting when processing some projects.
  • Edit Preferences: A message is now displayed in Edit Preferences explaining that all current projects and skins need to be closed to change some options.
  • Complex Search & Replace: On some projects the search and replace tool could only be used once if the Autosave feature was active.
  • Complex Search & Replace: An error could be generated when replacing in invalid topic files because they were not automatically excluded from searches.
  • TOC \Maps folder in uncompressed HMXP projects: Toolbox would crash silently on opening an HMXP project if there were non-TOC files or invalid secondary TOC files in the \Maps folder.
  • Plus a number of cosmetic changes, like showing a red explanation that you need to close all projects to be able to edit the disabled preferences in Edit > Preferences.

V3 and V4 WebHelp Skins

  • Embedded Help: A new option enables you to leave the WebHelp header visible when opening help embedded in another web page.
  • Local without Web Server: Changes in the security features of current browsers caused a number of errors when using these skins in local mode without a web server. These errors have been corrected, along with others caused by some Google Analytics features not being disabled in local mode.

All V3 and V4 Skins

  • Image toggle close mode: The Click Inside option for closing image toggles caused an error in some skins.
  • Image toggles: Image toggles were inactive when published with Help+Manual 7.
  • Search results: Some V3 WebHelp and eWriter skins showed only the project title in the search results instead of the topic title. The incorrect topic title was sometimes shown in the search results in the Advanced skins.

All Skins

  • A potential cross-site scripting vulnerability has been corrected in the Zoom Search component. The vulnerability was only available when date range searching was activated. This is only supported the full, standalone version of Zoom, so it was not an issue in WebHelp generated with the version in Help+Manual.

No Comments

Premium Pack 4.1.0 Maintenance Update

We have just updated Premium Pack 4 to version 4.1.0. This update introduces a large number of both minor and major improvements. The most extensive change is an overhaul of the embedded and field level help system for both regular WebHelp and WordPress sites to support multiple WebHelp collections and WebHelp collections on remote servers.

How to get the Premium Pack update

You can download and install the updated version with the download link and personal installation password you received when you purchased. If you no longer have these details please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 4 and visit our online store to purchase if you do not yet have it.

Code certificate updated

The code signing certificate used for the Premium Pack installer and Toolbox utility has just been updated. Because of this you may see a dialog asking you to confirm that you want to trust the publisher before installing. This is normal with “fresh” certificates until they have re-established their trust level.

Remote and multiple domains in embedded & field-level help and WordPress:

It is now possible to use embedded and field-level help from multiple WebHelp documentation systems on the same web page. In addition to this you can also embed WebHelp hosted on other web servers, not only on the same server as the HTML pages on which you are embedding and displaying the help. These new features are supported both in regular WebHelp and in the WordPress plugin.

See the updated Embedded and Field-Level Help chapter for full details.

V3 and V4 WebHelp Skins

  • Print Topic functionality: Improvement of topic printing in local no web server mode, both with the hamburger menu function and directly via the browser’s own print function.
  • Printing only first page: In some browsers only the first page of multi-page topics would be printed.
  • Print breadcrumbs: There is now an option to include the breadcrumb trail above the topic title when the user prints topics.
  • Inline toggle icons: Inline text toggles with icons are now also supported in these skins.
  • TOC autohide in mobile mode: When the TOC is folded over the topic content on mobile devices it now automatically slides out of view when a topic is selected. This new option is configurable.
  • Buttons as popup links: These are now supported.
  • Magazine skins: Calling context IDs via the URL didn’t work in the magazine skins because of a small internal error.
  • Magazine skins: TOC width was sometimes too narrow when opening/closing.
  • Flexible skins: The icon for page header open/close in the divider between the TOC and topic panes was hidden on the first load when the help was embedded.
  • Modern Standard skins:
    These skins have been generally overhauled and tidied up for better appearance and easier editing.

    • Maximum width setting: These skins now also have a HELP_MAXWIDTH setting for limiting the width of the help window in large browser windows.
    • iPad and iPhone behavior: The TOC pane could be narrower than the tabs above it on first access on some iPhone and iPad devices.
    • Swipe to change TOC pane width: Did not work on older iPad Mini devices.
    • General layout: A large number of minor tweaks and improvements to the layout in these skins.

V3 eWriter Skins

  • Title bar display in eViewer: You can now configure the title bar display in eViewer in the same way as in WebHelp. Options: Current topic title, current project name, current project name and current topic title.
    Print breadcrumbs: There is now an option to include the breadcrumb trail above the topic title when the user prints topics.
  • Inline toggle icons: Inline text toggles with icons are now also supported in these skins.
  • Buttons as popup links: These are now supported.

Toolbox Utility

  • Variables without names and unregistered baggage files: Toolbox now checks for the existence of variables without names and unregistered files in the baggage section and can correct this. (This can sometimes happen when the XML of your project file is generated programmatically or edited manually.)
  • Baggage files incorrectly shown as edited: Sometimes baggage file listings would be highlighted red as edited when this was not the case.
  • RTF build option removed: This option is no longer relevant in Help+Manual 7 and 8, which now generate Word DOCX by default.
  • Context and Edit menu updating: Sometimes the right-click context menu and Edit menu for Baggage files would not update correctly after adding a Baggage file to the current skin or project.
  • Baggage file handling: General handling of Baggage files improved, including better distinction of the differences between the processing of Baggage files in projects and skins when writing back to the project.

Help update

  • The Premium Pack help has been updated and extended with more detailed information for version 4.

No Comments

Premium Pack 4.0.4 Maintenance Update

We have just updated Premium Pack 4 to version 4.0.4. This update contains a large number of basically cosmetic updates. There is no urgency to install it if everything is already working OK for you. Just read through the descriptions and decide for yourself if and when you want to update.

How to get the Premium Pack update

You can download and install the updated version with the credentials you received when you purchased. If you no longer have this please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 3 and visit our online store to purchase if you do not yet have it.

Help update

  • The Premium Pack help has been updated and extended with more detailed information for version 4.

Skin changes and fixes:

  • Image toggle close mode (V3 & V4 skins): You can now choose whether image toggles close on a click inside or outside the image. This is set with the new IMGTOGGLE_CLOSEMODE variable in the General Settings variable group in the V3 and V4 skins.
  • Image toggle closing: Image toggles will now also close on the ESC key in desktop mode and on tablets with hardware keyboards.
  • Image toggle closing on smartphones: Image toggles closed too slowly in smartphone browsers.
  • Image toggle clickable area: In some skins clicking to the right of some image toggles would also trigger the toggle. This has been corrected.
  • Image toggle positioning: In some skins image toggles with captions would position at the top of the browser window when expanded. In the Advanced Compact and Advanced TOC skins image toggles could be positioned incorrectly when fully expanded in mobile browser mode.
  • Google Analytics: When the path was included in topic references the slash between the last folder and the topic name was sometimes missing. Two slashes instead of one were sometimes shown at the beginning of the path. This was dependent on the configured settings and the number of path levels.
  • Google Analytics: Search terms entered by the user were not tracked in the V4 Advanced Compact and V4 Advanced Full TOC skins.
  • Index keywords containing special characters: Clicks on index keywords containing special characters like slashes (/) failed in some skins.
  • Social sharing in V2 WebHelp skins: The social sharing popup in the still very popular V2 WebHelp skins has been updated to the latest version used in the V3 and V4 skins. The social sharing now uses scalable SVG icons and simple hyperlinks instead of the widgets that had to be loaded with every page. This means that the social sites now only get a ping when the user actually uses the icons.
  • V2 WebHelp skins language files: The English, French, Dutch and German language files for these skins have been updated with the variable changes for social sharing.
  • Video lightbox: Videos configured to open in a lightbox played inline with the V4 Advanced Compact and V4 Advanced Full TOC skins. Videos playing in a lightbox now close when the user presses the ESC key.
  • Topic top margin setting: All V3 and V4 skins now include a TOPIC_TOPMARGIN variable with which you can adjust the margin between the top of your topics and the top of the topic window. This variable is in the Main Layout variables group in the V3 WebHelp and eWriter skins and in the General Layout variables group in the V4 skins.
  • Closing videos in V2 WebHelp and CHM skins: Videos are now effectively closed automatically when stopped without having to reload the current page, even if they are in popups or toggles. The POP_KILLVIDEO option is now on by default and does not need to be turned off.
  • Keyword index search highlights: In some V4 skins the highlight of keywords found with Search in the keyword index was not displayed. This is now set to a dashed underline in the same color as the index keyword text. This is not configurable directly, but you can change it by editing the .idxhilite class definition in the hmwebhelp_index_xxxx.css files in the skin baggage.
  • Search highlight colors in V3 skins: The options for configuring search highlighting colors in the older V3 WebHelp and eWriter skins are not color options because they use a combined setting for text and background colors. This has been made clearer by defining these settings as Layout options. See the Configuring for Use > Other Settings section in the V3 WebHelp and V3 eWriter chapters.
  • Topic and web link hotspots in CHM: Links to topics and web pages in image hotspots now function more reliably in the CHM skins.

Toolbox Utility

  • Changing filter: When you change a variables filter (Colors, Layout Settings etc.) in Toolbox the currently selected variables group is now redisplayed automatically with the filter if the group contains variables of the selected type. Otherwise the first available group is displayed. In previous versions this always switched to the first available group.
  • HM version: Projects created with HM 7 or 8 are now both identified as 7/8 in the Project Information. This is necessary because there is no identifying difference between the versions in the XML headers of version 7 and version 8 projects.
  • Baggage files: The names of Baggage files added to skins or projects by the user are now checked for strict HTML compatibility. Filenames must use only the standard ASCII characters a..zA..Z0..9_, and $, no spaces.
  • Projects with missing TOC: If the TOC of a HM project is completely missing Toolbox now reports this explicitly instead of just saying that the TOC is invalid.

No Comments

Premium Pack 4.0.3 Maintenance Update

We have just updated Premium Pack 4 to version 4.0.3. This now includes the promised V4 Modern Standard set of skins, which are similar to Modern Flexible but with a more basic appearance and functionality. In addition to this it tidies up some color variables and style settings and corrects a couple of small issues reported by users.

How to get the Premium Pack update

You can download and install the updated version with the credentials you received when you purchased. If you no longer have this please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 3 and visit our online store to purchase if you do not yet have it.

Skin Updates 

  • New skin category: The V4 Modern Standard skin category is now included. This is a simple, functional layout similar to Modern Flexible, but without width restriction (always full width), with simple drop-down user-configurable menus in the page header.
  • General: Minor corrections in color variables and layout.
  • Modern Compact skins: New settings in Skin Options to disable the logo and link buttons.
  • Flexible and Magazine skins: The MAX_PAGEWIDTH variable in the General Settings variables section now accepts both pixel (px) and percent (%) values for setting the maximum width of the help in the browser window.
  • Magazine skins: Improvement to drop-down menu behavior in phone mode (opening one submenu now closes any other submenu to save space, as in the other skins).
  • Flexible skins: Feature images did not move up with the page header in phone mode when hiding the page header, leaving a gap.
  • V3 eWriter skins: An error caused a delay on opening WebHelp, during which context calls to the skin would fail.
  • V3 eWriter skins: The Minimalist Standard skin included some double variable references that prevented saving changes.

Toolbox utility

  • New program icon
  • New language files for Dutch for V4 skins
  • Minor bug fixes

No Comments

Premium Pack 3.48 Maintenance Update

We have just released a very minor update of the Premium Pack with the following small improvements and fixes. You only need to update your skins if any of the following things are important to you.

How to Get the Premium Pack Update:

You can download and install the updated version with the credentials you received when you purchased. If you no longer have this please contact support@ec-software.com and we will help you out. See the Premium Pack product page for more details on Premium Pack 3 and visit our online store to purchase if you do not yet have it.

V3 Skins (WebHelp and eWriter versions)

  • Tooltips in ATOC menu: The ATOC_TIP variable was not set to HTML and as a result the   entity was displayed as code in the tooltips instead of as a space.
  • Disabling the ATOC: The ATOC_SHOW variable for disabling the ATOC was not connected and had no effect. This was never noticed because the ATOC menu is automatically hidden if there are no corresponding links in the current topic.
  • Top navigation button: In some configurations clicking or tapping on the Top topic navigation button would not jump to the correct higher-level topic.

CHM skins

  • Topic header components: Improved scaling on modern. high-resolution monitors and Windows devices.
  • Drop-down menu components: Improved scaling on modern. high-resolution monitors and Windows devices.
  • Topic header title text color: New variable (HD_TEXTCOLOR in the Header Components group) setting the topic header title color in the skin. This eliminates the need to set the color correctly in the Help+Manual  project.

Toolbox utility

  • Close project warning: If you open a new project or skin while one is already open a warning is now only displayed if the current project contains unsaved edits. This makes switching to a new project or skin faster.

No Comments

HelpXplain 1.1.0 and Help+Manual 7.5.3 Updates

We are glad to announce two updates for both, HelpXplain and Help+Manual. HelpXplain has full audio support and Help+Manual needs a few changes to support this, too.

HelpXplain 1.1.0

  • HelpXplain 1.1.0 has full audio support! Audios in Xplains work in the regular HTML output, in Help+Manual’s Webhelp, eWriter eBooks and in HTML Help (.chm) files. All player skins include audio controls.Check out the “Fun with audios” demo here:
    https://www.helpandmanual.com/help/gf_gettingstarted_audio.html

Other changes and bug fixes in version 1.1.0:

  • Publish deletes all files in data folder.
  • Original JPEG/PNG images were not exported as original but recreated, sometimes resulting in larger image files
  • Several undo/redo bugs fixed
  • Scrolling of slide list after slide deletion improved
  • When pasting slides, the pasted slides are inserted at the current position in the slide list, not at the end
  • File drag & drop on welcome page implemented
  • PDF export did not support Unicode file names

 

Help+Manual 7.5.3

Changes in Help+Manual:

  • Insert HelpXplain dialog: defaults for Xplains changed to lightbox mode (this is really important for Xplains with audio support)
  • All CHM skins have been changed to elevate the internal rendering engine to Internet Explorer 11 instead of 10 (this is important for Xplains with audio support to make the audio work inside CHM files)
  • Publishing tasks: include comments in PDF was not working

Download

Both are free updates if included in your maintenance plan! Please download the update(s) and install it over your existing version.

,

No Comments

Help+Manual 7.5 Released!

We are glad to anncounce the immediate availability of Help+Manual 7.5.0. This update ships with several improvements including:

  • Text-to-table function updated: several users asked to simplify the text-to-table function and to not apply explicit column widths. The function is now much more transparent and simply splits text by tab stops.
    When using the right-click text-to-table function, the default table style class is applied automatically and the inserted table reflects the table style.
  • Clipboard paste from OneNote implemented
  • Improved topic header synchronization: when duplicating a topic in the TOC with copy and paste, and subsequently changing the duplicated TOC heading, the automatic synchronization with the topic header did not work, because of the added “_2” text that marks the topic copy.

Bugfixes and minor changes

  • Nested snippets from repositories did not work, PDF print styles were not applied to snippets.
  • PDF/Print: If a dropdown toggle had a page break right before the toggle icon, and the icon was removed for print and the left margin of this paragraph was zero, the page break was removed and not re-applied.
  • After saving a project, a topic reload sometimes occurred, causing the cursor to jump to the beginning of a topic and losing the current selection.
  • Font preview in main window: in some rare situations, an access violation ocurred
  • Windows EXE e-books: updated viewer application, the initial ClearCache command has been removed to avoid initiation problems on some systems.
  • Webhelp export: the standard bullets have a slightly different font definition to improve the bullet display and make it larger. Table heading row background color was sometimes wrong for nested tables, if the heading row background was defined the in the table style only.

HelpXplain supported

Last, not least, Help+Manual 7.5 now fully supports HelpXplain presentations. If HelpXplain is installed, you can make full use of responsive interactive HTML5 presentations and screencasts in Webhelp, HTML Help and Windows e-books. HelpXplain will be available soon.

 

Please download the update to Help+Manual 7.5 from our download page and install over your existing installation of Help+Manual.

No Comments

Help+Manual 7.4.2 Update

We are proud to anncounce the immediate availability of Help+Manual 7.4.2. This update ships with several small improvements including:

  • Text-to-table function implemented: if you select existing tabbed text in a topic and click Insert Table, it will convert the tabbed text into a table.
  • Conditional text: if IFDEF statements were used in text, in particular in tables, a long list of IFDEF options resulted in relatively wide condition tags. The display size of the condition tags has been restricted, a mouse-over hint shows the full list of conditions.
  • Images hotspots dialog: entry field for topic ID permits editing (copy and paste)
  • Topic editor context menu: when the context menu was opened with the keyboard (e.g. SHIFT+F10), it had some glitches with tables and with the spell checker.
  • Topic editor: the scaling message for small images has been improved, it displays % only, no text.
  • High resolution displays: problems fixed for OLE objects and embedded images (PDF/HTML/DOC export)
  • Double quotation marks could be entered in topic IDs, though they are not valid for file names.
  • Task publishing: when creating eWriter eBooks with a publishing task, the specified skin was not used.
  • Insert horizontal line: when specifying a custom style, the line not use the specified line height, but rather used the default.
  • Spelling checker: support for the latest update of the Spanish OXT dictionary implemented

 

Please download the update to Help+Manual 7.4.2 from our download page and install over your existing installation of Help+Manual.

No Comments