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.
How to set correct TOC option in INI file
Moderators: Alexander Halser, Tim Green
How to set correct TOC option in INI file
Last edited by Mady Dady on Wed Apr 05, 2017 4:30 pm, edited 1 time in total.
Re: How to set correct TOC option in INI file
You do not have the required permissions to view the files attached to this post.
Re: How to set correct TOC option in INI file
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.
Re: How to set correct TOC option in INI file
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.