The following scenario provides a real-life example of how someone might set up a local computer and server for producing HTML5server-based output.
Here is the situation: An author is running Windows XP on her computer. She has a Flare project with a target named "Jackpot" and plans to publish the output to the company website (xyzincorporated.com), using the HTML5
- Author On her local computer, the author completes the steps for installing Microsoft Internet Information Services (IIS) and ASP.NET.
- Author In Flare, the author follows the steps for setting up the Jackpot target, which is based on the HTML5
server-basedoutput type. This includes entering "Web" as the catalog name on the Publishing tab (we're assuming the intention is to use the default value, as opposed to a custom catalog).
- Author The author generates the Jackpot target in Flare.
The author then creates a folder called "MCPreview" on her computer at C:\Inetpub\wwwroot (e.g., C:\Inetpub\wwwroot) and places a copy of the Jackpot output files in that folder.
- Author The author follows the steps for starting Microsoft Indexing Service.
- Author In order to enable the advanced HTML5
server-basedsearch features on her computer, the author opens the output folder and double-clicks the file ConfigureSearch.exe, which is located in the output's Service\Console.ConfigureSearch subfolder. In the case of this author, she finds her executable file here:
C:\Documents and Settings\AuthorName\Documents\My Projects\JackpotProject\Output\authorname\ Jackpot\Service\Console.ConfigureSearch\ConfigureSearch.exe
- Author The author generates her four "child" Flare targets (those that will be merged with the parent Jackpot target). In Flare, she selects Project > Open Output Folder and copies each output folder related to a child target. She then pastes these output folders in the following location:
The author is careful not to view the output of any of the child targets from Flare immediately after she builds them. If she were to do this, the output files for the parent Jackpot project would be overwritten in the MCPreview folder.
You can also choose specific places in the table of contents or browse sequence where child projects are merged.
See Specifying the Order of Automerged HTML5 Outputs, Specifying the Automerge Location in a TOC for HTML5, and Specifying the Automerge Location in a Browse Sequence for HTML5.In this scenario, let's assume the author simply uses the default merge order.
- Author Now the author wants to add the Word and PDF files to the output, so that they can be included in searches. However, an initial step needs to be completed first. Certain files (Microsoft Office, text, and HTML) do not need any attention because they can be included in the search just the way they are. PDF documents, however, require an IFilter. Therefore, the author downloads an IFilter from Adobe and installs it on her computer.
- Author The author copies and pastes the Word and PDF documents to:
- Author The author views the HTML5
server-basedoutput on her computer to test the merged output and the search for Word and PDF content. However, this time she does not initiate the view from within Flare. This time, she opens a browser window and types the following path into the address bar:
She does this
becauseif she had initiated the view from within Flare, the output files in the MCPreview folder would have been replaced with new files, which would have overwritten the merged child output, Word documents, and PDF files that were added manually.
- Author Let's say the author is now finished testing her output and is ready to publish the final output to the server. Therefore, in Flare she creates a publishing destination for the parent Jackpot target that points to http://www.xyzincorporated.com/help systems/Jackpot. She generates the output for the parent Jackpot target again and publishes the Jackpot HTML5
server-basedoutput to that location.
- Author/Web Administrator The author generates the four child Flare target outputs again. In Flare, she selects Project > Open Output Folder and copies each output folder related to a child target. The author can provide these folders to the web administrator or (if the author has access) directly paste them in the following location:
For example, if the author has child targets named "Child1," "Child2," "Child3," and "Child4," those output folders would be added to the website as follows:
Alternatively, the author (or web administrator) could manually create subfolders on the website that are named after each target folder; these subfolders would be contained within the AutoMerge folder. The author can then create publishing destinations that point to the appropriate subfolders and automatically publish each child target accordingly.
- Web Administrator On the server where the output files will be published, the company's web administrator completes the steps for installing Microsoft Internet Information Services (IIS) and ASP.NET.
- Web Administrator On the server where the output files will be published, the company's web administrator completes the steps for configuring IIS on the production server.
- Web Administrator On the server where the output files will be published, the company's web administrator completes the steps for starting Microsoft Indexing Service.
- Web Administrator The web administrator opens the output folder on the server to enable HTML5 search. He double-clicks the file ConfigureSearch.exe, which is located here:
- Web Administrator In order to include the PDF files in the search, the web administrator installs the appropriate IFilter on the server.
- Author/Web Administrator The author (if she has access) or web administrator copies and pastes the 20 Word documents and 15 PDF files to:
- Author To view the published output, the author opens a browser window and types the following path into the address bar:
If the author had specified a custom file name for the Jackpot target, such as "JackpotOnline," the address instead would be:
Note: If you are testing HTML5
Note: Flare's HTML5 Top Navigation skin does not support project merging.