How to set correct TOC option in INI file

Please post all questions and comments regarding Help & Manual 7 here.

Moderators: Alexander Halser, Tim Green

Post Reply
Mady Dady
Posts: 13
Joined: Thu Mar 20, 2008 11:47 am

How to set correct TOC option in INI file

Unread post by Mady Dady »

What is wrong with my INI or BAT file for generating documentation?

My project has several TOCs

I try to generate output with .bat file using .ini file to set options

What I want to get: HTML help site, then \beta folder within it with a beta-version of site with BANK_A include option; and then put PDF documentation inside \beta folder

Here is my .bat file:

@ECHO OFF
HELPMAN.EXE "C:\Users\user\Documents\HelpAndManual Projects\mfms\ExampleProject.hmxp" hm.ini

Here is my .ini file:

TOC=MFM Retail API
HTML=C:\Users\user\Documents\HelpAndManual Projects\mfms\HTML
I=HTML
HTML=C:\Users\user\Documents\HelpAndManual Projects\mfms\HTML\beta
I=HTML,BANK_A
PDF=C:\Users\user\Documents\HelpAndManual Projects\mfms\HTML\beta\api.pdf
I=PDF
Template=C:\Users\user\Documents\HelpAndManual Projects\mfms\PDF-Manual-Template-MC.mnl

When i run .bat file with this INI i get some HTML generated inside C:\Users\user\Documents\HelpAndManual Projects\mfms\HTML (see screenshot 1.png). But without index.html file and that's why i get 404 error


Here is my .bat file output listing below. I see that compiler finds reference error for topics - [Warning] Topic GetDeliveryStatus referenced by RequestFormat - so compiler has processed them. These are topics from my desired TOC, but i've got not this TOC at my site - and no any TOC at all.


C:\Users\user\Documents\help_generation>gen.bat
#Help & Manual command line compiler version 7.2.0 build 4035
Compiling C:\Users\user\Documents\HelpAndManual Projects\mfms\ExampleProject.hmx
p
[Info] Preparing topics
[Info] Preparing table of contents
[Info] Preparing project files
[Info] Preparing merged projects
[Info] Compilation of C:\Users\user\Documents\HelpAndManual Projects\mfms\Exampl
eProject.hmxp started 05.04.2017 17:50:11
[Info] The table of contents does not contain any items!
[Error] Error while writing top frame page!
[Info] Compilation complete
[Info] Preparing topics
[Info] Preparing table of contents
[Info] Preparing project files
[Info] Preparing merged projects
[Info] Compilation of C:\Users\user\Documents\HelpAndManual Projects\mfms\Exampl
eProject.hmxp started 05.04.2017 17:50:11
[Info] The table of contents does not contain any items!
[Warning] The following topics are referenced by other topics, but not included
in this build:
[Warning] Topic GetDeliveryStatus referenced by RequestFormat
[Info] Generating Webhelp
[Compiler Results] Generating Full-text Search Index...
[] Wrensoft Zoom Search Engine [Core Engine] Version 7.0.1022b (Build: Custom fo
r EC Software)
[] Core Engine: Version 7.0.1022b (Build: Custom for EC Software) on Windows 7 [
Professional Edition]
[] Core engine IPC ready.
[] Start indexing (offline mode) at Wed Apr 05 17:50:12 2017
[] INDEX SUMMARY
[] Files indexed: 39
[] Files skipped: 36
[] Files filtered: 0
[] Unique words found: 1816
[] Variant words found: 329
[] Total words found: 7030
[] Avg. unique words per page: 46.56
[] Avg. words per page: 180
[] Errors: 0
[] Total bytes scanned/downloaded: 216564
[] File extensions:
[] Successfully created all required files
[Info] Compilation complete
[Info] Preparing topics
[Info] Preparing table of contents
[Info] Preparing project files
[Info] Preparing merged projects
[Info] Compilation of C:\Users\user\Documents\HelpAndManual Projects\mfms\Exampl
eProject.hmxp started 05.04.2017 17:50:15
[Error] Table of contents does not contain any items! Please check the include o
ptions of your topics and chapters.
Last edited by Mady Dady on Wed Apr 05, 2017 4:30 pm, edited 1 time in total.
Mady Dady
Posts: 13
Joined: Thu Mar 20, 2008 11:47 am

Re: How to set correct TOC option in INI file

Unread post by Mady Dady »

1.jpg
You do not have the required permissions to view the files attached to this post.
Mady Dady
Posts: 13
Joined: Thu Mar 20, 2008 11:47 am

Re: How to set correct TOC option in INI file

Unread post by Mady Dady »

MFM Retail API TOC is being processed but topics didnt get into site
You do not have the required permissions to view the files attached to this post.
User avatar
julio
Posts: 118
Joined: Wed May 28, 2008 12:06 am
Location: Porto Alegre, RS - Brasil
Contact:

Re: How to set correct TOC option in INI file

Unread post by julio »

Your command line syntax is wrong. Please go to http://www.helpandmanual.com/help/ and select Publishing - Command Line Publishing. This section of the documentation explains how to create batch and INI files.
Post Reply