Версия для печати темы

Автор: ViGOur 19.12.2008, 13:13

Как многие уже знают, у нас есть домен третьего уровня для документации: http://www.doc.crossplatform.ru. Пока там только Qt документация.
Что сделано:
1. Этот домен теперь основной для документации, а не как раньше было crossplatform.ru/documentation/...
2. Дополнительно выложил английскую версию документации.
3. Сделал возможность переключения с русской версии на английскую и наоборот.
4. Добавил ссылки для скачивания архивов с переведенной документацией.

Что-то еще нужно? Пишите не стесняйтесь.
Ну и разумеется критикуйте!

p.s. в эту тему будем писать все пожелания насчет документации.

Автор: trdm 19.12.2008, 16:35

Документация по бизону полетела.

Автор: ViGOur 19.12.2008, 17:00

Не понял, что ты имеешь ввиду?

Автор: Novak 19.12.2008, 17:15

Нужно придумать механизм по исправлению ошибок в переводе. По выделению и ctrl-Enter или что-то вроде этого.
Имхо, помочь перевести мало кто будет хотеть, а вот пальцем быстро тыкнуть на ошибку или опечатку - это запросто.

Автор: Litkevich Yuriy 19.12.2008, 17:17

контестно чувствительно - очень удобно

хорошая мысль.

Автор: ViGOur 19.12.2008, 17:27

Хорошая мысль, нужно будет подумать как это сделать...

А сейчас пока добавлю туда докуменнтацию по:

• ACE
• Boost
• GTK+
• wxWidgets

И думаю добавлять или нет доки по:

• Python
• Java
• Perl
• Базы данных

Автор: AD 19.12.2008, 17:38

Добавляй. Не помешает!

Автор: Litkevich Yuriy 19.12.2008, 17:50

жаль только это все не переведенным будет

П.С. Таблички не красивые получились, надо бы с их оформлением что-то сделать.

Автор: ViGOur 19.12.2008, 17:56

Пока да, но может кто-нибудь возьмется также!
Добавить хочу для того, чтобы доки были в одном месте и удобней копаться в них было...

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

Автор: Litkevich Yuriy 19.12.2008, 18:05

а что если в вики попробывать в песочнице накидать из тех блочков, что я сделал? Там эксперементировать проще. А потом посмотреть исходник HTML какой вика генерит и от туда взять фрагмент.

Автор: ViGOur 19.12.2008, 18:17

html не проблема, просто нужно до конца предатсвлять, что будет...

Автор: Novak 19.12.2008, 19:30

По PyQt можно, я всё подумываю что-то написать про пикуте, очень прикольная штука.

Автор: ViGOur 19.12.2008, 21:00

Ссылку дай откуда их взять!

В wiki песочнице, можно начать и постепенно закончить...

Автор: molchanoviv 20.12.2008, 0:32

Еще хотелось бы про ОпенГЛ. Но я не знаю какие доки можно выкладывать, а какие нет. А документации по нему масса.

Автор: Novak 20.12.2008, 12:34

http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/classes.html
Только со скачать, наверное, проблема.. Но если получится, то там всё на доках по Qt основано, с переводом будет несложно)

Автор: ViGOur 20.12.2008, 13:12

Ну нужно отбирать как я понимаю, например http://www.opengl.org/sdk/docs/man/ под SGI Free Software B License, которая вроде как не запрещает выкладывание доков у себя.
А вот полная документация собранная http://www.opengl.org/documentation/.

Усе, выложил. Ищите глазами: PyQt на главной странице доков...
Теперь дело за переводом.


Еще вот наткнулся на http://www.riverbankcomputing.com/static/Docs/sip4/sipref.html
Как считаете нужно выкладывать?

Автор: molchanoviv 20.12.2008, 13:43

Выложи.

Автор: Litkevich Yuriy 20.12.2008, 13:49

вот на http://www.riverbankcomputing.co.uk/software/pyqt/download надо скачать PyQt-win-gpl-4.4.4.zip (8 МиБ) в нем есть каталог doc там вся документация (32 МиБ)

Автор: ViGOur 20.12.2008, 13:52

Я уже ее выложил...

Автор: Litkevich Yuriy 20.12.2008, 14:29

а-а-а я не посмотрел.
Я вот вижу есть документация на русском по GTK+ (http://www.crossplatform.ru/documentation/gtk2.10/index.php) может ее тоже перенести в поддомен документации?

Автор: ViGOur 20.12.2008, 15:21

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

Автор: ViGOur 23.12.2008, 11:38

Добавил документацию: ACE, Boost, GTK+.
Добавил навигационное меню чтобы видеть в какой части документации находишься и перейти уровнем ниже...

Автор: ViGOur 26.12.2008, 10:03

Выложил Qt документацию версии 4.5.0 бета в снапшетах, как русскую там и английскую версии...

Автор: Litkevich Yuriy 26.12.2008, 10:48

ViGOur, а может не писать версию снапшота, а то неровно стало. Да и потом будет другой снапшот, а в самой документации написаноа версия внизу.

Автор: ViGOur 26.12.2008, 12:03

Даже и не знаю, мне кажется чтобы не вводить в заблежение народ думаю всеже нужно указывать что это снепшет. К тому же он лежит в директории, которую я запретил индексировать поисковикам.

Автор: Litkevich Yuriy 26.12.2008, 12:05

я как раз предлагаю писать так: Snapshot и все, без указания версии

Автор: Litkevich Yuriy 26.12.2008, 17:09

еще навигацию надо поправить:

Автор: Litkevich Yuriy 26.12.2008, 17:47

есть проблема с переключением языка в снапшоте, вываливает Error404

Автор: ViGOur 26.12.2008, 18:12

Поправил.

Автор: ViGOur 30.12.2008, 16:22

Добавил:

• Perl документацию
• wxWidgets документацию

на очереди базы данных и gtk+ русские доки...

Автор: ViGOur 20.1.2009, 12:36

Добавил PyGTK к документации Python.

Автор: trdm 25.1.2009, 13:24

Напал на коллекцию RFC на русском: http://www.protocols.ru/
тока нужна авторизация. (может будет полезно.)

Автор: ViGOur 26.1.2009, 10:28

trdm, там слабенькая подборка RFC да и думали мы уже о том, чтобы сделать у себя колекцию, но пока ничего не надумали.

Народ, нужно думать как бы устроить расположение документации на главной, идеи есть?

Автор: trdm 26.1.2009, 14:48

Я знаю. По этому и написал.
ПС. Курочка по зернышку клюет.

Автор: ViGOur 26.1.2009, 20:33

Не в обиду, но пока мы еще не решили, как поступить с RFC. Я пока подумываю может в WIKI засунуть, но пока вика не особо идет, к сожалению.

Автор: Litkevich Yuriy 8.2.2009, 15:51

http://doc.crossplatform.ru/

П.С. что-то я стал терятся куда такую новость помещать, толи сюда, толи в http://www.forum.crossplatform.ru/index.php?showtopic=635

Автор: ViGOur 8.2.2009, 16:30

Думаю можно и в новости на сайте...
Сайт то читают.

А мне казалось http://doc.crossplatform.ru/qt/4.4.3/i18n.html переведено, или ...

Автор: Litkevich Yuriy 8.2.2009, 16:31

перевод пришел перед самым объединением ПП и я не успел ни проверить ни добавить в свою ПП.

к следующему обновлению будет.
У меня еще лежат переводы Анны.

Автор: ViGOur 8.2.2009, 18:35

Добавил в http://doc.crossplatform.ru/qt/_interpreters.php - http://www.forum.crossplatform.ru/index.php?showuser=523.

Автор: Litkevich Yuriy 4.3.2009, 16:26

Залил английскую версию, должна появится минут через 10, изменений на 11,3 МиБ.

Автор: ViGOur 4.3.2009, 17:56

На почту мне пришли ее точные координаты настрою на сайте "автоподхват"...

Автор: Litkevich Yuriy 4.3.2009, 18:04

я обновил файлы снимка (http://svn.assembla.com/svn/qt4rtt/qt-snapshot/.....)
а не создавал еще одну версию, чтобы места несъедать лишний раз, поидее само должно на сайте обновится

Автор: Litkevich Yuriy 4.3.2009, 18:34

ViGOur, что-то не обновляется дока на сайте

Автор: ViGOur 4.3.2009, 19:06

Усе обновляется. Может у тебя кэш сохраняется непостижимым способом?
Просто для doc.crosspltform.ru я запретил кэширование...

Автор: Litkevich Yuriy 4.3.2009, 19:17

вроде все вычищал, сейчас еще проверю.

Полез через ФФ, где-то находу обновлятся стали странички. Такое ощущение, что период обновления очень большой.
А вот английская так и не обновилась.

Автор: ViGOur 4.3.2009, 19:38

А они и не обновляется!

Автор: Litkevich Yuriy 4.3.2009, 19:40

тогда надо ручками, а то там бетта везде светится

Автор: ViGOur 4.3.2009, 20:21

ok

Автор: ViGOur 16.6.2009, 12:35

В связи с реструктуризацией доков, хочу посоветоваться с вами как лучше сделать.

Сейчас на сайте лежат доки:

• Qt 4.3.2
• Qt 4.3.5
• Qt 4.4.3
• Qt 4.5.0

4.3.2 и 4.3.5 относятся к одной линейке и в документации видимые изменения если и есть, то незначительные.

Если сделать именование вроде:

• Qt 4.3.x
• Qt 4.4.x
• Qt 4.5.x
• Qt 4.6.x
• ...
• Qt 4.N.x

а при обновлении доков из какой-либо линейки обновлять их до последней версии.

Что скажите?
Или можете предлагать свои варианты.

Автор: Litkevich Yuriy 16.6.2009, 12:50

лучше просто
Qt 4.3
Qt 4.4
Qt 4.5
Qt 4.x

По аналогии как в самой документации, там только мажорная да минорная цифры.

Только в низу страницы для конкретности указана полная версия.

Автор: alex977 18.1.2010, 18:03

Нельзя ли выложить рядом со ссылками на оригинальную документацию по Qt архивы со всеми файлами, как это сделано для переводов?

Автор: ViGOur 18.1.2010, 18:11

Можно, но зачем?

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

Автор: Litkevich Yuriy 18.1.2010, 18:39

угу, зачем?

Автор: alex977 19.1.2010, 0:05

Для сверки. Оригиналы нужны, но лучше скачать 3-5 архивов по 3 мб, чем по одному файлу.
Если можно - то скиньте мне на почту (alex_977СОБАКУСmail.ru).
Ну жаба давит скачивать по 30 мб для каждой версии...

Автор: Litkevich Yuriy 19.1.2010, 8:16

alex977, тебе html'ьники нужны или сжатые файлы справки (qch)?

Автор: alex977 19.1.2010, 12:41

Нужны html. Желательно с картинками - иногда помогает понять о чем речь.

Автор: Litkevich Yuriy 19.1.2010, 12:56

Qt_4.5_html_en.7z - 3331кБ
Qt_4.5_html_ru.7z - 3481кБ
Qt_4.5_images.7z - 20292кБ

точно картинки тебе отправлять?

Автор: alex977 20.1.2010, 0:05

Нет, только html-en...
Заранее спасибо!

Автор: alex977 6.6.2010, 12:20

Небольшое замечание.

По адресу http://doc.crossplatform.ru/qt/ открывается страница, в заголовке которой (где кнопки свернуть, развернуть, закрыть) написано "Qt 4.3: Qt Документация | Документация".

"Qt 4.3: " - лишние буквы и цифры ;-)

Автор: ViGOur 6.6.2010, 20:40

Поправил.
Оставил "Qt Документация | Документация", для поисковых машин...