Оттолкнуться от:
https://www.walletfox.com/course/qhelpengineexample.php (файлы документации можно быстро генерировать с помощью helpndoc).

Отличия:

1) можно без отрисовки фигур (достаточно сделать парочку дополнительных вкладок приложения рядом с Item и Help для разнообразия и проверки возможностей — например, Справка, Рабочая область 1, Рабочая область 2).
2) не нужно делить общее окно на рабочую и справочную половины (при запуске приложения требуется только рабочая область с вкладками по другим разделам, а справку всегда выводить в отдельном окне по нажатию на f1 или по клику на вкладку Справка).
3) добавить возможность отображения кастомной стартовой странички справки в зависимости от текущего открытого окна (Item, Help и других заданных выше).

---

Грубо говоря, в примере адрес стартовой странички документации задавался следующим образом:


HelpBrowser *textViewer = new HelpBrowser(helpEngine);

textViewer->setSource(

QUrl("qthelp://walletfox.qt.helpexample/doc/index.html"));



а после доработки “index” будет меняться в строке адреса в зависимости от контекста (рабочей области / открытой вкладки) посмотреть, что лучше подойдет для решения этой задачи, но если получится сделать несколько реализаций, еще лучше.

---

если свои варианты есть сходу, велком, а так вот идеи на подумать:

а) например, использовать setContextHelp или setUserData для присваивания идентификатора рабочей области и сопоставления его с соответствующим Help ID в справке (в helpndoc можно установить его до компиляции qhc и qch файлов) для формирования ссылки

б) либо использовать setProperty и вылавливать его значение для формирования ссылки

в) либо в коде главного окна справки пробовать что-то вроде, чтобы идентифицировать рабочую область
QAction act = qobject_cast<QAction>(sender());
int index = act->data().toInt();
но тогда нужно понимать, что index не меняется и его можно установить в файле справки для соответствующих параметров Help Context или Help ID, за счет этого сразу же линковать на нужную страничку при запуске справки

---

в коде желательно прописать комментарии