Люди, кто делал справочную систему на qt??

[nata267]

Как её сделать? Плиз, помогите... Пробовала делать через QAssistantClient, как там сделать содержание?? и поиск по ключевым словам?

[Sahab]

QtHelp
+
сорцы ассистанта в QTDIR думаю найдешь...

[nata267]

Я читала документацию и по assistant и по QClientAssistant и QHelp, но как этим пользоваться примеров нет, не пойму.  как напрмер генерировать файлы содержания???

[nata267]

QtHelp
+
сорцы ассистанта в QTDIR думаю найдешь...

если вы делали справку, подскажите что нужно делать, как создать содержание, указатель и как подключить это к проекту, маленький примерчик, если не жалко

[Sahab]

http://doc.qt.nokia.com/4.6/qthelpproject.html
генерится "вручную" + qhelpgenerator + qcollectiongenerator в зависимости от Ваших потребностей.

The contents can then be retrieved via the QHelpEngine class and can be displayed in nearly any form. Showing it in a QTextBrowser is probably the most common way, but embedding it in What's This help is also perfectly possible.

Retrieving help data from the file engine does not involve a lot of code. The first step is to create an instance of the help engine. Then we ask the engine for the links assigned to the identifier, in this case "MyDialog::ChangeButton". If a link was found, meaning at least one help document exists to this topic, we get the actual help contents by calling fileData() and display the document to the user.

[igor_bogomolov]

http://doc.crossplatform.ru/qt/4.6.x/qthelpproject.html
http://doc.crossplatform.ru/qt/4.6.x/qthelp-framework.html

[lit-uriy]

>>но как этим пользоваться примеров нет
и всё таки примеры есть:
%QTDIR%\examples\help\

[nata267]

>>но как этим пользоваться примеров нет
и всё таки примеры есть:
%QTDIR%\examples\help\

в этих примерах понятно только как подключиться к процессу assistant, а как генерить файлы справки непонятна)

[Гурман]

присоединяюсь к вопросу

делать еще много надо, а экспериментировать с хелпом нет времени, нужен подробный мануал, но Шлее класс QHelp проигнорировал

[nata267]

igor_bogomolov и sahab, спасибо за помощь все получилось, только единственная проблема, у меня процесс assistant на английском языке, его гденибудь можно достать на русском??

[nata267]

присоединяюсь к вопросу

делать еще много надо, а экспериментировать с хелпом нет времени, нужен подробный мануал, но Шлее класс QHelp проигнорировал

сначала создаешь файл *.qhp, в формате XML, вида:

Код:

<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
    <namespace>com.trolltech.examples.simpletextviewer</namespace>
    <virtualFolder>doc</virtualFolder>
    <filterSection>
        <toc>
            <section title="Simple Text Viewer" ref="index.html">
                <section title="Find File" ref="./findfile.html">
                    <section title="File Dialog" ref="./filedialog.html"></section>
                    <section title="Wildcard Matching" ref="./wildcardmatching.html"></section>
                    <section title="Browse" ref="./browse.html"></section>
                    </section>
                <section title="Open File" ref="./openfile.html"></section>
                </section>
            </toc>
        <keywords>
            <keyword name="Display" ref="./index.html"/>
            <keyword name="Rich text" ref="./index.html"/>
            <keyword name="Plain text" ref="./index.html"/>
            <keyword name="Find" ref="./findfile.html"/>
            <keyword name="File menu" ref="./findfile.html"/>
            <keyword name="File name" ref="./filedialog.html"/>
            <keyword name="File dialog" ref="./filedialog.html"/>
            <keyword name="File globbing" ref="./wildcardmatching.html"/>
            <keyword name="Wildcard matching" ref="./wildcardmatching.html"/>
            <keyword name="Wildcard syntax" ref="./wildcardmatching.html"/>
            <keyword name="Browse" ref="./browse.html"/>
            <keyword name="Directory" ref="./browse.html"/>
            <keyword name="Open" ref="./openfile.html"/>
            <keyword name="Select" ref="./openfile.html"/>
            </keywords>
        <files>
            <file>browse.html</file>
            <file>filedialog.html</file>
            <file>findfile.html</file>
            <file>index.html</file>
            <file>intro.html</file>
            <file>openfile.html</file>
            <file>wildcardmatching.html</file>
            <file>images/browse.png</file>
            <file>images/fadedfilemenu.png</file>
            <file>images/filedialog.png</file>
            <file>images/handbook.png</file>
            <file>images/mainwindow.png</file>
            <file>images/open.png</file>
            <file>images/wildcard.png</file>
            </files>
        </filterSection>
    </QtHelpProject>

Если в файле есть русские слова, заменяешь кодировку на WINDOWS-1251

потом процессом qhelpgenerator(он находится в QTDIR\bin) генерируется файл *.qch, командой:

Код:

qhelpgenerator doc.qhp -o doc.qch

 потом создаешь файл *.qhcp в формате XML, вида:

Код:

<?xml version="1.0" encoding="UTF-8"?>
<QHelpCollectionProject version="1.0">
    <assistant>
        <title>Simple Text Viewer</title>
        <applicationIcon>images/handbook.png</applicationIcon>
        <cacheDirectory>Trolltech/SimpleTextViewer</cacheDirectory>
        <startPage>qthelp://com.trolltech.examples.simpletextviewer/doc/index.html</startPage>
        <aboutMenuText>
            <text>About Simple Text Viewer</text>
        </aboutMenuText>
        <aboutDialog>
            <file>about.txt</file>
            <icon>images/icon.png</icon>
        </aboutDialog>
        <enableDocumentationManager>false</enableDocumentationManager>
        <enableAddressBar>false</enableAddressBar>
        <enableFilterFunctionality>false</enableFilterFunctionality>
    </assistant>
    <docFiles>
        <generate>
            <file>
                <input>simpletextviewer.qhp</input>
                <output>simpletextviewer.qch</output>
                </file>
            </generate>
        <register>
            <file>simpletextviewer.qch</file>
            </register>
        </docFiles>
    </QHelpCollectionProject>

 и процессом qcollectiongenerator генеришь файл .qhс, так:

Код:

qcollectiongenerator mycollection.qhcp -o mycollection.qhc

далее, как в примере из папки QTDIR\examples\help\simpletextviewer, подключаешься к процессу assistant

[Гурман]

сначала создаешь файл *.qhp, в формате XML, потом процессом qhelpgenerator генерируется файл *.qch, потом создаешь файл *.qhcp в формате XML и процессом qcollectiongenerator генеришь файл .qhс, он используется процессом assistant

спасибо конечно, но подробным мануалом это назвать трудно... 

[lit-uriy]

>>у меня процесс assistant на английском языке
qm-файлы асистента нужны

[nata267]

>>у меня процесс assistant на английском языке
qm-файлы асистента нужны

понятно, то есть надо найти файл перевода на русский язык, а потом пересобрать ассистант из папки tools, но у меня прикомпиляции возникает куча ошибок)

[nata267]

сначала создаешь файл *.qhp, в формате XML, потом процессом qhelpgenerator генерируется файл *.qch, потом создаешь файл *.qhcp в формате XML и процессом qcollectiongenerator генеришь файл .qhс, он используется процессом assistant

спасибо конечно, но подробным мануалом это назвать трудно... 

я более подробно написала, см выше