Russian Qt Forum

Qt => Qt-инструментарий => Тема начата: cya-st от Октябрь 22, 2011, 18:51



Название: Справка Qt
Отправлено: cya-st от Октябрь 22, 2011, 18:51
Всем привет...
Пробую создать справку для Qt, все компилится и запускается в ассистенте, но не открываются файлы: The page could not be found  'qthelp://help/doc/6.html'.
Файл qhp:
Код
XML
<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
  <namespace>help</namespace>
  <virtualFolder>doc</virtualFolder>
 
<filterSection>
<toc>
<section title="First" ref="1.html">
<section title="Second" ref="2.html">
<section title="3" ref="3.html"></section>
<section title="4" ref="4.html"></section>
<section title="5" ref="5.html"></section>
</section>
<section title="5" ref="6.html"></section>
</section>
</toc>
 
               ...
 
</filterSection>
</QtHelpProject>
 
Подскажите пожалуйста в чем может быть проблема. Подозреваю что неправильно задан <namespace>, но не знаю что там должно быть.


Название: Re: Справка Qt
Отправлено: panAlexey от Октябрь 23, 2011, 16:20
Подскажите пожалуйста в чем может быть проблема.
проблема в отсутствии визуалки с чекитами для создания справки а-ля Qt.
Вот с удовольствием поюзал бы в составе этой справки дополнительные хелпы.
По доксигену например.
Может есть у кого?


Название: Re: Справка Qt
Отправлено: lit-uriy от Октябрь 24, 2011, 19:20
>>и запускается в ассистенте, но не открываются файлы
как эту фразу понимать?


Название: Re: Справка Qt
Отправлено: cya-st от Октябрь 24, 2011, 21:07
>>и запускается в ассистенте, но не открываются файлы
как эту фразу понимать?
В асистенте пишет: "The page could not be found  'qthelp://help/doc/6.html'"


Название: Re: Справка Qt
Отправлено: cya-st от Октябрь 24, 2011, 21:08
Немного перефразирую вопрос, что должно быть в <namespace>?


Название: Re: Справка Qt
Отправлено: cya-st от Октябрь 25, 2011, 22:07
Всем спасибо, разобрался сам.


Название: Re: Справка Qt
Отправлено: iroln от Октябрь 25, 2011, 22:29
cya-st, вы создаёте справку для своего приложения?

Раз вы "в теме", подскажите, пожалуйста, как лучше всего создавать справочную систему для Qt приложений, чтобы она была интегрирована в само приложение (например, как в QtCreator на отдельной вкладке висела)?

Почитал про QDoc, но это вроде не совсем то, а хотелось бы что-то такое, чтобы саму справку легко могли писать люди без знания программирования, HTML, CSS и т.д. Ну что-то вроде того, чтобы просто писать plain-text с простой wiki-подобной разметкой, а потом всё это компилировалось бы в удобоваримый html (или qhp-файлы) с определённым стилем, что уже можно показывать в каком-нибудь QTextBrowser или QAssistant.

UPD:
Посмотрел в исходники Qt. Там справка сделана подобно "доксигеновской", лежит в *.qdoc файлах. Разметка, я так понял QDoc. Вот что-то такое же хотелось бы иметь с таким же стилем как в Qt.


Название: Re: Справка Qt
Отправлено: b-s-a от Октябрь 26, 2011, 16:26
Ну так кто мешает делать ее в формате qdoc?


Название: Re: Справка Qt
Отправлено: cya-st от Октябрь 26, 2011, 22:38
Цитировать
Раз вы "в теме", подскажите, пожалуйста, как лучше всего создавать справочную систему для Qt приложений, чтобы она была интегрирована в само приложение (например, как в QtCreator на отдельной вкладке висела)?
Я использую Qt Assistant как в Qt Creator.
Вот некоторые ссылки по которым я делал (разобратся не сложно было ... для меня):
http://doc.crossplatform.ru/qt/4.7.x/assistant-custom-help-viewer.html
http://doc.crossplatform.ru/qt/4.7.x/qthelp-framework.html
http://doc.crossplatform.ru/qt/4.7.x/help-simpletextviewer.html


Название: Re: Справка Qt
Отправлено: iroln от Октябрь 27, 2011, 06:59
cya-st
Благодарю за ссылки! Правда парочку я уже сам нашёл. Могу ещё добавить ссылку на документацию по QDoc:
http://doc.qt.nokia.com/qdoc/index.html