crossplatform.ru

Здравствуйте, гость ( Вход | Регистрация )

3 страниц V  < 1 2 3 >  
Ответить в данную темуНачать новую тему
> Как создать документацию?
SABROG
  опции профиля:
сообщение 6.7.2009, 19:02
Сообщение #11


Профессионал
*****

Группа: Участник
Сообщений: 1207
Регистрация: 8.12.2008
Из: Russia, Moscow
Пользователь №: 446

Спасибо сказали: 229 раз(а)




Репутация:   34  


Тоже нету.
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Litkevich Yuriy
  опции профиля:
сообщение 6.7.2009, 19:08
Сообщение #12


разработчик РЭА
*******

Группа: Сомодератор
Сообщений: 9669
Регистрация: 9.1.2008
Из: Тюмень
Пользователь №: 64

Спасибо сказали: 807 раз(а)




Репутация:   94  


мне сегоденя троли ответили (18 июня робот прислал уведомление о принятии заявки), по поводу этого дела, я им допинфу послал, будут разбиратся, у них такого эффекта нет.
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
kuzulis
  опции профиля:
сообщение 27.4.2011, 15:31
Сообщение #13


Активный участник
***

Группа: Участник
Сообщений: 393
Регистрация: 29.6.2009
Пользователь №: 862

Спасибо сказали: 36 раз(а)




Репутация:   7  


Доброго времени.

Подниму эту ветку.


А как собственно, используя утилиту qdoc3 сгенерировать *.qch файлы (и т.п.) для открытия в ассистенте и т.п. ?

Я взял (как написано в документации к QDoc : http://doc.qt.nokia.com/qdoc/index.html) ,
создал минимальный файлик qserialdevice.qdocconf
Цитата
# QDoc is a tool that constantly evolves to suit our needs,
# and there are some compatibility issues between old and new
# practices. For that reason, any QDoc configuration file needs to
# include compat.qdocconf.

#include(compat.qdocconf)

# The outputdir variable specifies the directory
# where QDoc will put the generated documentation.

outputdir = html

# The headerdirs variable specifies the directories
# containing the header files associated
# with the .cpp source files used in the documentation.

headerdirs = .

# The sourcedirs variable specifies the
# directories containing the .cpp or .qdoc
# files used in the documentation.

sourcedirs = .

# The exampledirs variable specifies the directories containing
# the source code of the example files.

exampledirs = .

# The imagedirs variable specifies the
# directories containing the images used in the documentation.

imagedirs = ./images

для своего проекта (правда, комменты в проекте в Doxygen стиле, но это ничего :) ),
запустил
Цитата
qdoc3.exe ./qserialdevice.qdocconf

оно мне ругнулось на кучу неправильных комментов, но в итоге создало мне *.html файлы.

Так вот, можно ли сразу генерить *.qch файлы и как вообще происходит процесс перевода документации на русский?

Сообщение отредактировал kuzulis - 27.4.2011, 15:31
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Litkevich Yuriy
  опции профиля:
сообщение 27.4.2011, 18:00
Сообщение #14


разработчик РЭА
*******

Группа: Сомодератор
Сообщений: 9669
Регистрация: 9.1.2008
Из: Тюмень
Пользователь №: 64

Спасибо сказали: 807 раз(а)




Репутация:   94  


Цитата(kuzulis @ 27.4.2011, 18:31) *
Так вот, можно ли сразу генерить *.qch файлы
нет
сжатые файлы справки делаются так:
%QTDIR%/bin/qhelpgenerator.exe html-assistant-ru\assistant.qhp -o assistant_ru.qch



Цитата(kuzulis @ 27.4.2011, 18:31) *
как вообще происходит процесс перевода документации на русский?
примерно так
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
kuzulis
  опции профиля:
сообщение 27.4.2011, 19:35
Сообщение #15


Активный участник
***

Группа: Участник
Сообщений: 393
Регистрация: 29.6.2009
Пользователь №: 862

Спасибо сказали: 36 раз(а)




Репутация:   7  


Цитата
нет
сжатые файлы справки делаются так:


1. Правильно ли я понимаю, что *.qch файлы содержат весь *.html контент только в своем определенном формате и для
ассистента достаточно только лишь этих *.qch файлов?
2. Что за файл *.qhp ?

Цитата
примерно так

спс, почитаю
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Litkevich Yuriy
  опции профиля:
сообщение 28.4.2011, 10:01
Сообщение #16


разработчик РЭА
*******

Группа: Сомодератор
Сообщений: 9669
Регистрация: 9.1.2008
Из: Тюмень
Пользователь №: 64

Спасибо сказали: 807 раз(а)




Репутация:   94  


Цитата(kuzulis @ 27.4.2011, 22:35) *
для
ассистента достаточно только лишь этих *.qch файлов?
да

Цитата(kuzulis @ 27.4.2011, 22:35) *
2. Что за файл *.qhp ?
Qt Help Project - проект справки Qt
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Гость_я_*
сообщение 8.6.2011, 12:29
Сообщение #17





Гости








    


Возник такой вопрос.
Пытаюсь создать файл qch из проекта в примерах (simpletextviewer), но qhelpgenerator просто вылетает с ошибкой.
Использую QtSDK 1.1rc, ОС WinXP SP3.
Никто с подобным не встречался?
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Litkevich Yuriy
  опции профиля:
сообщение 8.6.2011, 14:10
Сообщение #18


разработчик РЭА
*******

Группа: Сомодератор
Сообщений: 9669
Регистрация: 9.1.2008
Из: Тюмень
Пользователь №: 64

Спасибо сказали: 807 раз(а)




Репутация:   94  


Цитата(Гость_я_* @ 8.6.2011, 15:29) *
но qhelpgenerator просто вылетает с ошибкой.
тут форумчанам предлагается угадать ошибку?
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Гость_я_*
сообщение 8.6.2011, 17:11
Сообщение #19





Гости








    


Litkevich Yuriy
Если это поможет, то винда в формируемом отчете упоминает
Цитата
Exception Information
Code: 0xc0000005


Пробовал запускать как из каталога bin, так и из каталога проекта:
C:\QtSDK\Desktop\Qt\4.7.3\mingw\bin>qhelpgenerator C:\QtSDK\Examples\4.7\help\simpletextviewer\documentation\simpletextv
iewer.qhp -o C:\QtSDK\Examples\4.7\help\simpletextviewer\documentation\simpletextviewer.qch

C:\QtSDK\Examples\4.7\help\simpletextviewer\documentation>C:\QtSDK\Desktop\Qt\4.7.3\mingw\bin\qhelpgenerator simpletextv
iewer.qhp -o simpletextviewer.qch



Перетаскивал каталог с документацией в bin:
C:\QtSDK\Desktop\Qt\4.7.3\mingw\bin>qhelpgenerator documentation\simpletextviewer.qhp -o documentation\simpletextviewer.
qch

C:\QtSDK\Desktop\Qt\4.7.3\mingw\bin>qhelpgenerator documentation\simpletextviewer.qhp -o simpletextviewer.qch

C:\QtSDK\Desktop\Qt\4.7.3\mingw\bin>qhelpgenerator simpletextviewer.qhp -o simpletextviewer.qch


Всё это делал, разумеется, предварительно удалив из каталога проекта сгенерированные до меня файлы qch, qhc и qhcp.
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение
Litkevich Yuriy
  опции профиля:
сообщение 8.6.2011, 17:39
Сообщение #20


разработчик РЭА
*******

Группа: Сомодератор
Сообщений: 9669
Регистрация: 9.1.2008
Из: Тюмень
Пользователь №: 64

Спасибо сказали: 807 раз(а)




Репутация:   94  


проверил на 4.7.3:
H:\Qt\4.7.3_std\examples\help\simpletextviewer\documentation>qhelpgenerator simpletextviewer.qhp -o simpletextviewer.qch
Building up file structure...
Insert custom filters...
Insert help data for filter section (1 of 1)...
Insert files...
Insert contents...
Insert indices...
Documentation successfully generated.

H:\Qt\4.7.3_std\examples\help\simpletextviewer\documentation>
Ошибок ни каких небыло файл simpletextviewer.qch создался.
Затем делаю
H:\Qt\4.7.3_std\examples\help\simpletextviewer\documentation>qcollectiongenerator simpletextviewer.qhcp -o simpletextviewer.qhc
Reading collection config file...
Generating help for simpletextviewer.qhp...
Building up file structure...
Insert custom filters...
Insert help data for filter section (1 of 1)...
Insert files...
Insert contents...
Insert indices...
Documentation successfully generated.
Creating collection file...

H:\Qt\4.7.3_std\examples\help\simpletextviewer\documentation>
файл simpletextviewer.qhc

П.С. виндовоз у тебя какой?
Перейти в начало страницы
 
Быстрая цитата+Цитировать сообщение

3 страниц V  < 1 2 3 >
Быстрый ответОтветить в данную темуНачать новую тему
Теги
Нет тегов для показа


1 чел. читают эту тему (гостей: 1, скрытых пользователей: 0)
Пользователей: 0




RSS Текстовая версия Сейчас: 28.3.2024, 23:05