Показать сообщение отдельно
Старый 28.10.2010, 13:11   #1
Андрей Аксенов
Senior Member
 
Регистрация: 12.04.2008
Адрес: Россия, Москва
Сообщений: 706
Отправить сообщение для Андрей Аксенов с помощью ICQ Отправить сообщение для Андрей Аксенов с помощью Skype™
По умолчанию Русскоязычная библиотека документации по 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 возникает ошибка - список файлов расширения пуст... Разобраться пока не смог... (может и по этому вопросу есть ответы? Буду признателен...)

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