Back to Contents Previous Next
Example of use
The Example folder in the application directory has a DDL document (called DDLMan) prepared from an OvationPro version of this Manual.
Firstly, note that the document has seven ‘chapters’ (Impression/Ovation-speak) four ‘embedded’ pictures, and has a Footer showing the page number.
Test A
Open the Example folder to find DDLMan plus an empty folder called OutputDir.
The DDL document file was obtained by converting this Impression Publisher version to OvationPro and thence saved as a DDL document file, as described in the Introduction. No other changes have been made.
Run !meDDLe
and - as Step 1) - drag DDLMan to the iconbar icon. This opens the main window.
Drag OutputDir to the window to complete Step 3).
Click on the Show mapping... button to bring up the Mapping window. Then click on the top right menu button in this new window and select mapping1 to load a pre-saved set of mappings - which will be in Red. Click Confirm mapping and the list changes to Black to show that the mappings are confirmed by the user. Note that the Start processing button is now enabled. This completes Step 2) and the Mapping window can now be closed if required.
The source document has a Footer in the form Page {pageno }
, so click on Show ‘ignores’... to bring up the Ignore window - and then click on the menu icon at its top right and select ignore1, a pre-saved ignore file with just one item in it, namely “Page ” (note trailing space).
Leave all other settings in their default state.
Now click on Start processing. The red prompt text will change to show the stage being processed and an hourglass will appear with its percentage value showing the progress of the processing of the stage.
Wait for the hourglass to disappear and the Red text to show “Finished. (OK to re-process)”. The Start processing button stays enabled.
Open up the OutputDir folder which should now contain eight HTML documents - one for each ‘chapter’ of this document plus a Contents file. Double click on any of them to confirm that they give a reasonable representation of this Manual and confirm that the links in Contents lead directly to the other files. (But note that the HTML URLs in the Contacts section do not appear as live links.) Check the contents of Pics also: it should have four PNG files called pic001/png to pic004/png.
Note also that each HTML ‘page’ has links to the next/previous pages (as appropriate), to return the user to the top of the page and back to the Contents page.
Test B
Delete all the above HTML pages (but not the Pics folder) and return to the main window. Choose the New page at Key Style option, and then use the associated right-hand menu button to show a list of the Styles used in the loaded DDL document file. Select Heading1.
Now move to the Html markers at Style icons and use the menu icon to select Heading2.
Then move to the Html links at Style icons and use the menu icon to select Link.
Finally, select the Insert refs, but don’t process pics choice.
Now click on Start processing again - and OutputDir will eventually contain eleven HTML files. Double-click on them to confirm that this time the Manual has been split into ‘pages’ based on Heading1 rather than ‘chapters’ - although this will result in the same first ‘page’.
Also confirm that the Contents page now has indented sub-links within the first, third and fifth main section links - and that clicking on these loads the correct ‘page’ as well as scrolling it to the appropriate place marked by Heading2.
Further, note that the URLs and email addresses in the Contacts section are now live links.
The Pics folder should be the same as before.
Test C
Delete all the output HTML files (but not the Pics folder) and repeat the exercise with the Single page option chosen, just to confirm the different result.
Test D
Check the sizes of the the picture files in Pics - then delete the pictures.
Repeat Test A but with the Medium sprite compression choice selected.
Confirm that the new output picture files in Pics are now much smaller and load more quickly when their HTML pages are viewed in a browser.
With these examples as a basis it is easy to explore all options and different mappings etc. in detail to gain familiarity.
Note in particular the use of the Style DummyHead1, which is identical to Heading1 and similarly mapped. It is used solely on the word “Introduction” at the first section heading after the title (instead of the Heading1 Style used for all other main section headings). This is to ensure that - in Test B above - a new page is not generated immediately after the title.
Top of page Back to Contents Previous Next