Справка QT

Как распаковать и вернуть обратно созданную в Qt Creator справку (в формате .qch и .qhc)Собрать

Оффлайн

Автор темы

NNK_RTR

Звание: Бывалый

Мастер

Сообщений: 275

Создано тем: 51

Рейтинг: 5

Репа: (61|61|0)

Баллы: 1756

Был: 2024-04-25 17:30

Лайков: 85

Как распаковать и вернуть обратно созданную в Qt Creator справку (в формате .qch и .qhc)
Собрать можно в Qt Creator, это я знаю, правда опыта нет, а вот, как разобрать. Всезнайка, не смог найти ответа на этот вопрос, хотя я спрашивал с пристрастием.
Может у кого есть опыт, поделитесь пожалуйста.

13 января 2023 - 09:45 / #1
Оффлайн

Krig

Звание: Бывалый

Знаток

Сообщений: 188

Создано тем: 7

Рейтинг: 4

Репа: (86|86|0)

Баллы: 56

Был: 2023-03-14 15:26

Лайков: 82

Цитата: NNK_RTR
Всезнайка, не смог найти ответа на этот вопрос, хотя я спрашивал с пристрастием.

Смотря что и как искать. Большинство неверно формулируют запрос для поиска.

5 сек и готово.

По второй ссылке получаем инструмент по распаковке файлов справки QT в формате .qch.
NNK_RTR нравится это сообщение.

13 января 2023 - 13:54 / #2
Оффлайн

Автор темы

NNK_RTR

Звание: Бывалый

Мастер

Сообщений: 275

Создано тем: 51

Рейтинг: 5

Репа: (61|61|0)

Баллы: 1756

Был: 2024-04-25 17:30

Лайков: 85

Все верно, правильно заданный вопрос - уже половина ответа!!
Спасибо!!!
Правда инструмент ничего не извлек - мелькнуло что-то в окошке и все, впрочем, это уже другой вопрос...
С уважением, Николай

13 января 2023 - 15:53 / #3
Оффлайн

Krig

Звание: Бывалый

Знаток

Сообщений: 188

Создано тем: 7

Рейтинг: 4

Репа: (86|86|0)

Баллы: 56

Был: 2023-03-14 15:26

Лайков: 82

Все прекрасно извлекает! Читайте внимательно справку и требования.
Это консольное приложение. Т.е. работать нужно в командной строке.

QtCompressedHelpExtractor.exe source-file target-directory

source-file - исходный файл
target-directory - папка, куда будет извлекаться содержимое

13 января 2023 - 20:07 / #4
Оффлайн

Автор темы

NNK_RTR

Звание: Бывалый

Мастер

Сообщений: 275

Создано тем: 51

Рейтинг: 5

Репа: (61|61|0)

Баллы: 1756

Был: 2024-04-25 17:30

Лайков: 85

На диске Е я создал три папки (назвал их 1,2 и 3)
В первую положил QtCompressedHelpExtractor.exe (вместе с сопутствующими файлами)
Во вторую файл UserManual.qch
В третей ожидал получить ответ.
Командная строка выглядит так:
"E:1QtCompressedHelpExtractor.exe" ["E:2UserManual.qch"] ["E:3"]
Успел сфотографировать консоль и фотку прилагаю

Возможно нужно создать эту директорию (как на рисунке и поместить инструмент в нее
С уважением, Николай

13 января 2023 - 20:59 / #5
Оффлайн

Krig

Звание: Бывалый

Знаток

Сообщений: 188

Создано тем: 7

Рейтинг: 4

Репа: (86|86|0)

Баллы: 56

Был: 2023-03-14 15:26

Лайков: 82

Ох, ёшкин кот! Походу вы в командной строке ни в зуб ногой.

1) Для начала синтаксис - читаем.

2) Смотрим хелп по инструменту qthelpextract:

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

QtCompressedHelpExtractor.exe "C:SiemensAutomationWinCC_OA3.14helpen_US.utf8WinCC_OA.qch" "C:TempWinCC-OA-Manual-3.14"

Все одной строкой! Примечание:во втором параметре последний слеш не нужен.

3) Далее, продолжаем изучать хелп:

Требования, которые необходимо выполнить, чтобы инструмент работал.
Т.е. нужно установить программу wkhtmltopdf (конвертирует HTML в PDF).
Переходим по ссылке, загружаем и устанавливаем.
Без этой программы инструмент не работает!

Примечание: если разбираетесь в кодинге .NET Framework, то можете убрать эту зависимость, чтобы преобразование извлечённых документов в PDF не выполнялось. Ведь по факту нужна только распаковка! Ну или в уже в исполняемом файле QtCompressedHelpExtractor.exe при помощи отладчика (dnSpy) убрать команды вызова wkhtmltopdf.

4) Выполняем подготовительные работы: берем объект распаковки, создаем папку для извлекаемых файлов.
Потом формируем команду с необходимыми параметрами, используя любой текстовый редактор.

Например:

Файлы инструмента находятся в папке "D:TESTQtCompressedHelpExtractor_v1.0"

Файл справки qwt-6.1.0.qch, который нужно разобрать, лежит а папке "D:TEST",
т.е. полный путь к этому файлу будет "D:TESTqwt-6.1.0.qch".

В папке "D:TEST" создадим подпапку с именем "unPack_qwt-6.1.0", куда будем вести распаковку,
т.е. путь к этой папке будет такой: "D:TESTunPack_qwt-6.1.0".

По итогу мы имеем

[source-file] = "D:TESTqwt-6.1.0.qch"

[target-directory] = "D:TESTunPack_qwt-6.1.0"

Вся команда имеет вид:

QtCompressedHelpExtractor.exe "D:TESTqwt-6.1.0.qch" "D:TESTunPack_qwt-6.1.0"

Копируем эту строку в буфер обмена.

5) Открываем командную строку и переходим в папку, где находятся файлы инструмента qthelpextract с исполняемым файлом QtCompressedHelpExtractor.exe. Согласно примера выше по пути "D:TESTQtCompressedHelpExtractor_v1.0".

Вставляем из буфера обмена (правой кнопкой мыши) команду

QtCompressedHelpExtractor.exe "D:TESTqwt-6.1.0.qch" "D:TESTunPack_qwt-6.1.0"

или вводим её вручную:

и нажимаем ENTER... пошло извлечение...

Готово.

6) Переходим в папку с извлеченными файлами и радуемся.

С Новым Годом!
NNK_RTR нравится это сообщение.
Сообщение отредактировал WYLEK 4 февраля 2023 - 11:21

14 января 2023 - 03:00 / #6
Оффлайн

Автор темы

NNK_RTR

Звание: Бывалый

Мастер

Сообщений: 275

Создано тем: 51

Рейтинг: 5

Репа: (61|61|0)

Баллы: 1756

Был: 2024-04-25 17:30

Лайков: 85

Ваш уровень намного выше моего (точнее, во много раз), это я понял при первом же общении с Вами и читая Ваши разъяснения другим пользователям.
Прежде чем задать вопрос, я пытаюсь найти ответ в Ваших сообщениях - не так просто найти - сообщения не отсортированы по темам и их много.
Я понимаю, что Вам было бы намного проще передать мне уже распакованные файлы, а не объяснять прописные истины и за "просветительскую" работу Вам ОГРОМНОЕ спасибо.
С уважением, Николай.

14 января 2023 - 10:04 / #7