Multi-lingual help files

Perdrix

The windows .chm help for my project is generated from like named html files in multiple language folders. The .chm files have unique names for each language (e.g. "DeepSkyStacker Help.chm", "DeepSkyStacker Ajuda.chm")

If I follow the same approach for using Qt help, I might have (for English) "DeepSkyStacker Help.qchp"

<?xml version="1.0" encoding="UTF-8"?>
<QHelpCollectionProject version="1.0">
  <assistant>
    <title>DeepSkyStacker Help</title>
    <applicationIcon>..\DeepSkyStacker\res\logo.png</applicationIcon>
	<cacheDirectory>DeepSkyStacker/DeepSkyStacker5</cacheDirectory>
    <startPage>qthelp://DeepSkyStacker.Help/doc/english/userguide.htm</startPage>
    <homePage>qthelp://DeepSkyStacker.Help/doc/english/userguide.htm</homePage>
    <enableDocumentationManager>true</enableDocumentationManager>
    <enableAddressBar>true</enableAddressBar>
    <enableFilterFunctionality>true</enableFilterFunctionality>
    <enableFullTextSearchFallback>true</enableFullTextSearchFallback>
  </assistant>
  <docFiles>
    <register>
      <file>DeepSkyStacker Help.qch</file>
    </register>
  </docFiles>
</QHelpCollectionProject>

and "DeepSkyStacker Help.qhp"

<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
  <namespace>DeepSkyStacker.Help</namespace>
  <virtualFolder>doc</virtualFolder>
  <customFilter name="DeepSkyStacker Help">
    <filterAttribute>deepskystacker help</filterAttribute>
  </customFilter>
  <filterSection>
    <filterAttribute>deepskystacker help</filterAttribute>
    <toc>
      <section ref="english/userguide.htm" title="DeepSkyStacker Help">
        <section ref="english/userguide.htm" title="User&apos;s Manual"/>
        <section ref="english/technical.htm" title="Technical Info"/>
        <section ref="english/live.htm" title="DeepSkyStacker Live"/>
        <section ref="english/commandline.htm" title="Command Line User&apos;s Manual"/>
        <section ref="english/faq.htm" title="FAQ"/>
        <section ref="english/theory.htm" title="How to create better images"/>
      </section>
    </toc>
    <keywords/>
    <files>
      <file>dss editing.mp4</file>
      <file>english/commandline.htm</file>
      <file>english/faq.htm</file>
      <file>english/live.htm</file>
      <file>english/technical.htm</file>
      <file>english/theory.htm</file>
      <file>english/userguide.htm</file>
      <file>images/bayerdrizzle.jpg</file>
      <file>images/bayerinterpolation.jpg</file>
      :
      :
    </files>
  </filterSection>
</QtHelpProject>

Is it possible to have a single pair of qhcp and qhp files to create a multi-lingual Qt help file set (.qch, .qhc)? Or do I need to keep separate projects for each language?

kkoehne

I'm not aware of any special support for localizing documentation, except for a feature to localize the ' About My Application' info box. So, your approach to completely splitting the Qt Help project sounds like the right approach.

Perdrix

Thank you.