Re: ver 4.0 docs
- Posted by jcmarsh Aug 29, 2008
- 1340 views
ne1uno:
I created another test file, this one splits the topics into subtopics, about 3000 of them.
I saw your version of 1086 the other day which has a mostly working CHM toc, not perfect because I think that htmlhelp is getting confused by the [1234] creolehtml markers for the name= sections and unable to make links out of them. seems obvious now. thats why there are no #links in the toc.hhc, just links to pages. it may even be a known bug, maybe instead of brackets it should be a selectable pair in creolehtml and can try paren or braces?
or you will have to go back and manually fixup the toc.hhc or generate the whole thing manually or convert from the html toc. splitting up into 3000+ files is how many CHM are organized. I didn't decompile the test.chm but sub dirs would be the way to go. previous euphoria CHM had larger single section pages. it's really an independent question from the bad links & topics. the best solution may be a plugin to eudoc to generate the html then index.hhk and toc.hhc directly. reworking the html too much will be high maintenance as time goes by. and as eudoc could be used by other libraries and projects that may want to generate chm versions as well as html and pdf, a plugin is worth perusing. line endings and trailing space should be options too at some point.
I believe there will be an index in the html version, modulo someone putting in the time to index and link a good cross section of words. just all the keywords and builtins could be thousands of links. maybe preferring section links with those words in them would be enough. I hope the links will be sufficiently differentiated so the alternate format programs can pickout the section links from the indexed links.
I made a program to automatically generate the index source toc.hhc today. It beats fixing the links by hand. Full links can be scanned from the html files created by eudoc. Currently only uses the first file generated by the eudoc package. Source included in the zip:
http://sites.google.com/site/runintrack/uploads/eu4chm/test.zip?attredirects=0
Are you creating the index.hhk file manually right now or having HTML Help Workshop generate it?