Взялся тут реализовать аля Web Qt Assistent и задумался, а откуда можно на халяву взять то, что берет Qt Assistent для формирования дерева Content?

Насчет *.dcf файлов знаю, они формата xml, но сравнив их содержимое с содержимым дерева в Qt Assistent'е понял, что как-то по другому формируется данное дерево контента, или дополнительно, что-то еще использует. В исходники пока не залезал, так как времени пока нет, если никто не ответит, полезу смотреть в исходники.

p.s. Можете на него глянуть краем глаза по адресу: doc.crossplatform.ru/qt/4.6.x/qtdoc.html Критика и пожелания принимаются, так как я хоть и знаю, что не работает пока и что нужно поправить, правда более чем уверен не все, вы наверняка натолкнетесь еще на что-нибудь, ну и разумеется подскажите, что нужно поправить...

Что нужно будет добавить, по просьбам:
1. Стили, чтобы не рябило в глазах. (сделано)
2. Подсветка кода.
3. Возможность смены и выключение стилей.
4. Показывать только переведенные документы.

тебя файл интересует или API?

а как делал?
Троли сначала мучали QWebClient, сейчас раскручивают гугловскую технологию. Пишешь прогу на Qt, только в качестве главного виджета, ставишь специальный, компилишь получаешь вебсервер (так было с QWebClient).

Файл или файлы, как с ним можно работать, и все это на JavaScript + возможно PHP.

хотелось бы со стилями увидеть

обычный Ajax

Все будет, пишите дальше пожелания, я не всегда буду отвечать...

вот тебе заархивированный qhp-файл, в нём оглавление
Нажмите для просмотра прикрепленного файла
(отреж у имени файла фиктивное расширение .zip)

П.С. тэг toc - оглавление

понял, пасиб, в выходные будет пища для ума...
а где ты взял это qhp файл?

А как впечатление, пользоваться будете?

Естесственно. Не всегда есть доступ до ассистента.

он идёт в комплекте с Qt, я его малость переделал, добавил фильтр для переведённой документации.

тормозит однако, а некоторые стараницы вообще не может загрузить, в уголку индикатор крутится не переставая.

Мне понравилось. Не обещаю, что буду пользоваться, но оценил. Хорошая вещь! Возможно, изредка.

Впечатления приятные. Пользоваться буду, если не будет мешанины. Т.е. хочется здесь видеть только полностью переведенные файлы документации. Не переведенные или недопереведенные, на мой взгляд здесь не к чему.
На мой взгляд, текущий стиль самый лучший. Глаз не режет. Единственное что можно было бы добавить, это подсветку кода.

Какие страницы? Дай url чтобы глянуть...
У меня просто скорость хорошая, потому этого не замечается, попробую через какую-нибудь проксю позже глянуть.

По моей задумке, если осилю конечно же, я хочу добавить туда перевод на лету, с последующей отправкой текста оригинала и перевода на сервер и формированием заготовки для tmx файла, потому думаю необходимо все там держать.

Насчет перевода на лету, до него нужно добраться еще, потому пока это только в планах, как доберусь буду общаться с командой перевода о формате tmx и как мне строить блоки для перевода и прочее...

те что содержат кортинки (например из руководства по дизайнеру.) Плюс, ощущение тормознутости возникает из-за того, что сначала загружается вся страница и только потом отображается. Хотя, например, наша текущая справка Оперой отображается динамически, по мере загрузки.

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

в таком случае пользователь будет постоянно получать ошибку 404 или замещающую её страницу. Это напрочь отобьёт у людей желание пользоваться этой справкой.

Стили прицепил, поже сделаю подсветку...

Получается очередная приблуда команды разработчиков. Обычного пользователя, как я, это может отпугнуть. Т.к. опять получаем мешанину из переведенной, частично переведенной, и оригинальной документации.
Хотелось бы иметь возможность видеть только полностью переведенные файлы. Т.о. знать, что доступно на Русском, а что нет.

Это просто дело вкуса. По мне, то как это выглядит сейчас - это самый лучший вариант. Все прекрасно отслеживается и читается. Мне все эти грамозкие черно-зеленые таблички/рамочки/выделения не нужны. Единственное чего не хватает - это, повторяюсь, подсветки синтаксиса.

Предусмотрите хотя бы вариант подобной фильтрации. У меня напрочь отшибает желание пользоваться переведенной документацией, когда я скачу между разноязычными файлами, при этом не зная, на каком языке окажется следующий файл. Хочу знать какая часть документации мне доступна на родном языке. А не тыкать в надежде, а вдруг повезет.

Все это лишь мое мнение. Вы спросили, я ответил )

как ты себе представляешь работу? Вот пользователь щёлкает, скажем, ссылку QWidget, а он лишь чуть-чуть переведён, что должно произойти?

igor_bogomolov, я понял, в принципе мнение обоснованное, но пока трудно реализовать то, что ты просишь, с только русской документацией. К сожалению. Потому пока будут решать более насущные вопросы, но твое пожелание тоже внесу в список и возможность смены стилей...

Как раз это и будет для обычных пользователей, по умолчанию панель для перевода будет отключена, поьзователь если захочет помочь, сможет ее включить, перевести часть текста и отправить нам, где уже кто-то из переводчиков проверив текст добавит в папку подтвеждённых переводов и при следующем объединении и обработке перевод будет доступен на сайте...

Возможно ли действительно сделать просто фильтр для панельки с содержанием. Т.е. , к примеру, я выбрал фильтр "Переведённая документация", и дерево с содержанием у меня перестроилось, отображая только то что полностью переведено. Это не значит, что я не могу с переведенной страницы перейти на страницу еще не переведенную. Просто я могу раскрыть ветку с классами, и увидеть, что реально мне доступно на русском языке.

В принципе могу сделать анализатор кирилица или латиница, и в зависмости от него добавить свойство в XML файл из которого уже строится дерево... Но это в теории, на практике посмотрим. Соответственно пока никакой речи не идет о том, чтобы скрывать или убирать не переведенные страницы, так как читается реальная документация с сайта...

И еще не забываем, что я С\С++ программист, а не JavaScript/PHP чего-то могу не уметь или не знать.

не реально, в одном файле будет и то и другое.
Это надо просто при сборке документации учитывать, может я тебе буду какой-нибудь файл-список давать, в котором перечислены полностью переведённые файлы. Но это будет возможно только для активной документации, теперь это версия 4.6.х

Сделал, тестируем, ругаем...

• http://doc.crossplatform.ru/qt/4.4.3/qtdoc.html
• http://doc.crossplatform.ru/qt/4.5.0/qtdoc.html
• http://doc.crossplatform.ru/qt/4.6.x/qtdoc.html

Ну и на главной Qt документация сделал ссылки на него...

вот что я увидел, перейдя по ссылке Web Qt Assistent 4.5
Нажмите для просмотра прикрепленного файлаи введя в поле поиска строку "QString"

Тэкс, опера как я понял не работает.
А поиск и правда на стадии разработки! :-D

p.s. хотя под никсами опера работает, а под вяндой почему-то нет.

А у меня такая штука внизу

аналогично. хотел запостить, а тут уже есть скрин.

хыхы, забыл отладку отключить, отключил!

но у меня начало всё равно так же выглядит. Только после нажатия кнопки "Ок" теперь появляется Веб-Асистент

надо ещё вот что предусмотреть:
Возможность получить ссылку на отображаемое содержимое (где-нибудь в верху), а то куда бы я не кликал - в адресной строке всегда одна и та же ссылка, например:
http://www.doc.crossplatform.ru/qt/4.5.0/qtdoc.html

Над этим я работаю.
Еще заметил, что при переходе по ссылке подобной #intro, возникает ошибка, постараюсь исправить...

Очень не хватает кнопочек "Вперёд" "Назад" для перемещения по истории.

P.S. Почему эта тема находится в трёпе? Помоему ее следует прикрепить к Crossplatform.ru - все о нем

Логично, постараюсь сделать Tool'бар...
Обсуждаемо. Как вариант в разделе Qt, в общие вопросы...

p.s. Плюс, я не все ошибки исправил, смог поправить только ссылки вида #links, а вот docment.html#links пока нет.

у меня вский раз когда я перехожу по ссылке, со страницы документации, на WebAssistant появляется пустая страница с полем поиска. Можно ли сделать, чтобы сразу появлялся ВебАсистент?

Он грузится.
Потому и сначала поле поиска, думаю сделать тогда невидимым пока все не загрузится...

непохоже, чтобы он грузился, т.к. пока я в это поле что-нибудь не введу и не нажму "поиск", ничего не происходит
Нажмите для просмотра прикрепленного файла

Юра, я же сказал, что пока в виндовой опере не работает, работает во всем, даже в сафари и хроме, а вот в опере и именно виндовой отказывается!

а сегодня у меня Веб-асистент открылся с одного клика!

(По прежнему Вин2к, Опера 10.10)

Может опера обновилась?

точно не обновилась, хотя уже давно донимает каждый день

Хехе, и правда заработала.
Магия прям какая-то!

всё теперь не дыши на него

Хотелось бы. Еще нужно подкрутить историю и докрутить работу с внутренними ссылками там пока не все так гладко!

к слову говоря, раньше он тоже работал, но отслучая к случаю. А сейчас он просто летает, странички махом открываются.

Не уверен, что сюда. Если что - перенесите.
На странице http://doc.crossplatform.ru/qt/4.6.x/tutorials.html при попытке перейти на страницу "Адресная книга" (http://doc.crossplatform.ru/qt/4.6.x/tutorials-addressbook.html) открывается пустая страница. Сообщений об ошибках не выдается. Другие страницы открываются как обычно.
Браузер FireFox 3.5.6

подтверждаю (у меня Опера)

Поправил...

ViGOur, в двух других версиях таже история (4.4, 4.5)

Поправил...

надобы это отсюда перенести. Ну да ладно, потом.

Нашёл ещё багу: http://doc.crossplatform.ru/qt/4.5.0/sql-driver.html
Страница не умещается по ширине (браузер Опера), т.е. не переносится текст.
П.С. раньше не замечал.

у поиска на сайте в кодировке страницы что то напутано:



Uploaded with ImageShack.us

ПС Win7, Firefox3.6

спамеры снова отаке!

На спам не похоже.