Русскоязычная библиотека документации по TYPO3

[Андрей Аксенов]

Эту тему я поднимал здесь: http://forum.typo3.biz/showthread.php?t=8871
но откликов ноль, может никто там ходит?
Поэтому дублирую здесь...

Несмотря на то, что на сайте www.typo3.ru имеется раздел Документация, хотел бы предложить его расширить/улучшить. Так как разобраться в нем и найти что-то необходимое для новичков крайне затруднительно.
Конечно существует и Википедия, но и с ее помощью все не просто...
Было бы неплохо этот раздел систематизировать (Начальные сведения, для новичков, установка, настройка базы данных, вопросы разработки расширений, настройка расширений и т.п.).
Кроме того, было бы неплохо сделать онлайн версию документации на русском языке, благо почти вся документация, которую советуют на официальном сайте мною переведена. Имеется множество переведенной документации по расширениям, которые использовал или каким-то образом касался.
К вопросу написания расширений - русскоязычный раздел документации совсем не помешал бы... Вопросов много, а ответы разбросаны по множеству документов на английском языке. К слову сказать, сейчас перевожу книгу Дулепова "Extension development", но выкладывать ее в общий доступ не этично, только если сам автор не будет против этого, а на своем блоге выложил перевод "Extbase quickstart (Первоначальные сведения об Extbase)" и т.п.
Ну и к слову об организации такой библиотеки, как я это вижу. Обычный список файлов для загрузки должен присутствовать, но хотелось бы что-то похожее на репозиторий TYPO3 – с возможностью просмотра через браузер по сети. В этом плане нравится организация документации на webempoweredchurch.org.

Хотелось бы как-то проще, и сложнее в то же время, а именно - модуль, который автоматически анализирует, скажем файл документации в формате swx (так уж сложилось, что документация по TYPO3 принята в этом стандарте и с определенным шаблоном) анализируется и преобразуется в html страницы документации...
rlmp_officeimport, rlmp_officelib, rlmp_officedocuments - не смогли ничего отобразить, выяснять причину не стал, может это использование DAM, может что-то еще, да и документация по установке скудная...
ter_doc - тоже без документации, поэтому настроить его не удалось...

Либо, а может и вместе, просмотрщик PDF...
Хотел что-то подобное организовать на своем сайте, но не нашел подходящего расширения.
Реализовать это можно при помощи flash, но нормально это сделать тоже не удалось - все подобные расширения находятся в альфа-бетта состоянии и, по-ходу, заброшены... Вообщем ничего вразумительно настроить не удалось...

Попробовал лечить зубы через заднепроходное отверстие:
расширение wk_scribd позволяет опубликовать документы на Scribd.com и просматривать их на странице. Но это уже не то: публикация на стороннем сервере, просмотр в формате этого сервера... И главное оно автоматически не позволяет формировать что-то вроде списка статей, списка документов и т.д. Конечно для этого можно использовать что-то еще... Вообщем танцы с бубном у костра...

Для катологизации хотел использовать wec_knowelegebase - но оно работает на базе старой tt_news - что уже не катит. Можно использовать саму tt_news, подточив ее... НО сами статьи - просто текстовый документ - то есть вбивать все документы вручную - это мартышкин труд...

Еще еще одна возможность катологизации - t3blog - там список и отображение статей, плюс другие виджеты можно прикрутить. Главное достоинство в том, что в статях можно использовать набор любых элементов TYPO3.

Осталось найти что-то умеющее переводить документы Open Office (фактически - xml) в код html...

Вкратце так. Кто-нибудь с этим сталкивался? Или может есть свое виденье подобной организации документации?

Да... еще одна возможность, создать свое расширение с переводом документации и опубликовать его в TER... Но почему-то лично у меня при публикации в TER возникает ошибка - список файлов расширения пуст... Разобраться пока не смог... (может и по этому вопросу есть ответы? Буду признателен...)

Реализовав этот механизм, можно будет перейти к сбору существующих переводов от других пользователей...

[-=UncleByte=-]

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

[Андрей Аксенов]

В рассылки не писал, но в ЧаВо
написано следующее:

What extension is used for displaying the manuals in the documentation section?

Manuals for TYPO3 extensions are traditionally written using Open Office Writer. An extension called ter_doc converts these manuals to DocBook and then run different XSLT sheets to produce the various output formats.

If you want to display Open Office Writer documents, use the Documents Suite - it offers a similar functionality for Open Office Writer files.

Лаконично, но ничего более не нашел...
Странно, что ни у кого более это не реализовано, хотя как знать... Но в виде готового расширения с нормальной документацией - не нашел...

[Bitzer]

Андрей Аксенов, хорошая идея. С удовольствием приму участие в этой теме, как освоюсь в TYPO3

[Андрей Аксенов]

С расширением rlmp_officedocuments разобрался - проблема была в сохранении переведенных файлов...
Если интересно, то это расширение обрабатывает файлы в формате *.sxw, но дополнительно нужно сделать некоторые настройки при сохранении...
Я пользуюсь OpenOffice от Инфра Ресурса, здесь нужно залезть в меню:
Сервис > Параметры. В диалоге Параметры перейти в пункт Загрузка/сохранение > Общие, и поставить флажок: Оптимизация по размеру для формата ODF.
После этого файлы обрабатываются указанными дополнениями...

[-=UncleByte=-]

Я подозревал что неполадки могут быть связаны с OO, хорошо что все нашлось и объяснилось.