< TodoInternals >

FAQ

  1. PDF output looks strange and really ugly. Characters are unreadable.

    You took the “Computer Modern” fonts and PDFLaTeX had no PostScript-based version of these fonts available. Therefore, you are stuck with the bitmap versions. Use the “Times/Helvetica/Courier” font settings in the project's settings on the LaTeX/PDF settings page.

  2. My pictures appear on totally different pages than the referring text in the LaTeX/PDF output.

    Page composition is up to LaTeX for the printed output. Pictures are exported as “figures” and may therefore be moved until there is space somewhere. If pictures and text get totally out of sync, try to increase the font size or decrease the picture size by

    in the project's LaTeX/PDF settings.

  3. Search index creation for HelpSet output does not work, I get an error.

    There might be a JavaHelp package somewhere in the CLASSPATH, especially in the lib/ext directory of the Java Runtime Environment. Look for a jh.jar or jhall.jar file. If search index creation does not work, that file must be removed from the lib/ext directory.

  4. How can I do context-sensitive help with the HelpSet output?

    Give all pages, which should be targets of certain context-sensitive help, a “:label” definition. You can reference these labels when invoking the online help from within the program.

  5. It seems as if I cannot start some markup in a macro and end it outside (or vice versa). Is this an error?

    No. Macros are entities on their own. So are markup portions. Opening an entity (e.g. italic) within another (e.g. :macro or ((macro-call))) and then closing the outer entity automatically closes the inner entity, also. Actually, macros do not work at the syntactic level as preprocessing macros in the “C” programming language. Instead, they (and calls to them) are semantic constructs on their own. Better compare them to functions in a programming language than to such a “macro”.

  6. What's that fish?

    Hey, that's Sharky. He makes working with HelpSetMaker much more fun than it would be with out him. Well, I mean... Other people have penguins as mascot, we have Sharky...

< TodoInternals >