Getting a lot of "Missing Bookmark" errors through madbuild

[Eric Lachance]

Hi,

I've started using a batch command line with madbuild.exe to generate my outputs, and though the output itself works fine, I keep seeing, in the log, a bunch of messages saying "Missing Bookmark"... messages that don't appear when I generate the same output using Flare directly.

Exact message: : C:\data\FlareProjects\PlanetPress-Workflow-Tools\Output\lachance\Temporary\7_1-PDF\26591683291510.html: Missing bookmark

I'm doing both PDF and WebHelp output and both give the same warnings. They don't prevent the output from working, indeed I see no difference between the automated or manually generated docs, but I just don't get where these errors come from and if I even need to fix them.

(edit: clarified last paragraph, didn't make sense)

[TechnicalDisaster]

Take a look at the topic just above the error message, that is where the error is occurring.

For example, in my error log I would see:

Processing topic: 1_OnlineCoverPage.htm
C:\Users\Desktop\Conversions\\Content\1_OnlineCoverPage.htm: Missing linked source file: C:\Users\Desktop\Conversions\Content\PDF\UserGuidePDF.pdf

The error is occurring in the topic above the message, in this case the 1_OnlineCoverPage.htm file.

Make sure "Show Bookmark Names" is on and then review the bookmarks in that section.

[Eric Lachance]

TechnicalDisaster,

Thanks for that tidbit, it helps me clarify the issue. All of these 100-odd errors only started with a colon (:) without a page definition and happened in rapid succession, so actually getting the page that triggered those errors wasn't easy - I had to stop the processing quickly enough for the page to still be in the command prompt queue.

As far as I can tell, it's PageIndex.html but I'm not sure because it only starts with "Linking cross-references..." and the last topic happens to be the last one it processes (I think).

Processing topic: 1667.html
Processing topic: PageIndex.html
Linking cross-references...
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\Chapter-PPDesignObjects627557786.htm: Missing bookmark
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\Chapter-SettingUpPages2834841979.htm: Missing bookmark
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\139842389893.html: Missing bookmark
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\139842389893.html: Missing bookmark
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\15303356176339.html: Missing bookmark
: C:\data\FlareProjects\PlanetPress-Design\Output\lachance\Temporary\7_1-PDF\15281145450235.html: Missing bookmark

The only thing that's present in PageIndex.html is a single H1 header and the indexProxy. This means that either this log is not showing me what page the error is from, or they're all generated by the Index Proxy. And since the index generates correctly.... I'm not sure.

[TechnicalDisaster]

Eric,
Is this content generated from a Word or Frame import?

[Eric Lachance]

It's not an "official" import, in the sense that I didn't use any of Flare's tools to create the project. What I did was use a base project with some shared resources that I needed, and then created an automated script that converted existing documentation (the "book" output from the Drupal CMS which is a sort of webhelp) by switching some of the XML tags around and generated the TOC. After a lot of tinkering this gave me a working project which I since extended and modified in a number of manners.

[NorthEast]

I got these errors too using madbuild, but they don't appear to cause any problems.

In my project, I got a missing bookmark message for every topic that contained a cross-reference; if the xref format was {paratext}.

I contacted support a few months ago and they were able to reproduce the issue, and logged it as a bug to be fixed in a future version.
They said there was no workaround/fix.

[Eric Lachance]

Alrighty then!

Thank you Dave!