Posts Tagged ‘howto’

Including content managed in External Sources

January 16, 2015

In an ideal world, all of the content for your documentation or help system would be included directly within the Document! X or HelpStudio project in order to get maximum value from the built in Project Tools such as Find and Replace, Spell Check and Link Check.

However, in the real world we know that isn’t always practical. There is often some isolated content that is managed as part of an existing web site (perhaps a privacy policy or support information) or as part of some other authoring workflow.

There might also be users who own certain parts of the content who don’t want to use Document! X or HelpStudio, or to whom you don’t want to give access to the project using the Source Control Integration features (which would otherwise be a great solution for team working and multiple authors).

For those scenarios we have introduced new functionality for including content from External Sources in our 2015.1 release. Rather than manually trying to manually import content from a source external to the project (i.e. by downloading as HTML and importing), you are now able to add Topics to your project that automatically obtain the content as a seamless part of the build, or when previewing in the editor. You can also use the new external content Widgets to include external content directly within an existing Topic or in the Document! X Content File Editor.

In the initial release we support Web Pages (or rather any url that can be called to return HTML) and Quip Documents as external content sources. If you have content in other kinds of external sources that would like to see supported in a future update, please let us know.

(Click above to view a demonstration movie)

Using existing content from Web Pages

Including content from a Web Page rather than importing it is a good option when the content in the Web Page is managed outside of Document! X and HelpStudio and may be updated in future; the up to date content will be downloaded and included whenever you Preview a Topic or build the documentation.

Using a Web Page as the source for a Topic in your help system allows you to re-use existing content that is managed externally without having to re-import each time the external content is updated.

Using Quip Documents for collaborative editing

One of the external content sources we support is Quip; a simple web and mobile document editor. Because Quip is quick and easy to use and supports collaboration and change tracking it can be a great solution for users that only require very basic authoring functionality and won’t be hyperlinking to other parts of the project content or working on other project content.

Multiple users can collaborate, discuss and revise documents in Quip and the latest content will always be used whenever you Preview or Build the generated output.


Publishing to a web site, ftp server or network location

January 16, 2015

Our 2015.1 release of Document! X and HelpStudio includes new Publishing functionality that makes it really easy to automatically publish you generated documentation or help system to a web server, ftp server or local network location.

You can define one or more Publishing Targets in the Build Profile Editor and then either publish automatically as part of the build process, or manually at some point after building using the Publish command on the Ribbon.

Publishing is able to determine which files have changed since you last published, minimizing the amount of time and bandwidth required to publish your content.

If you are using Azure to host your content, you can download and directly import a publishsettings.xml file from Azure to automatically configure a Publishing Target. All of the publishing targets are quick and easy to create and can be configured in a Build Configuration for automatic publishing when building either in the UI or using the Command Line build.

(Click above to view demonstration movie)