Почему документация поддерживается только в мёртвом формате?

Обсуждение общих вопросов связанных с программой
Аватара пользователя
ZUMA
Сообщения: 6
Зарегистрирован:
27 окт 2013, 10:20
Откуда: Ставрополь

Почему документация поддерживается только в мёртвом формате?

ZUMA » 03 янв 2014, 11:47

Конечно это громкое название, но факт остаётся фактом.

А именно. Есть у Open-Server папка modules\system\docs\

Она создана для документации. Документация у каждого своя. Я например туда [s]добавляю[/s] хочу добавить книги по регулярным выражениям, документацию Bootstrap, шпоргалки по jQuery, Yii и т.п.
Но сделать этого не могу, потому как Open-Server понимает только "мёртвый" CHM, который с 2002 года не развивается. А ведь этот формат вообще не знает, что давно уже есть UTF-8, да и вообще в этом формате новую документацию делают единицы, и то порой эти единицы - некие энтузиасты.

С другой стороны PDF развивается и по сей день. DJVU тоже как не странно не стоит на месте. MHT-страницы от IE есть, да и просто сохранённые единичные страницы (html файл + автоматом создаваемая папка с ресурсами) или даже целиком скачанные сайты документации тоже составляют неоценимую поддержку и формируют свою библиотеку документации.

CHM-файлов на фоне этой библиотеки у меня всего 3. И то это документация по PHP 2007 года (наполовину не переведённая на русский и тоже похоже сделана каким-то энтузиастом) и справочники CSS и по тегам HTML с htmlbook за 2010 год, которые не открывались наверное уже года 3.

Зато новых PDF-файлов как русской, так и буржуйской документации, которыми я пользуюсь постоянно пруд-пруди. И PDF-ки время от времени пополняются. Да и сканов DJVU тоже уже набралось прилично, в которые я заглядываю.

Почему только CHM? По идее можно ведь запускать всё, что добавлено в папку docs. Для этого не нужно кучу программ. Браузеры есть у всех, а для pdf-djvu можно ту же суматру использовать. А ннннет, новая версия и снова только CHM. Почему?
Аватара пользователя
Максим
Сообщения: 5392
Зарегистрирован:
11 дек 2010, 20:29
Контактная информация:

Максим » 03 янв 2014, 18:41

Не совсем понял какая разница в каком формате Руководство? Ну было бы оно в PDF или ещё в чём-то, что бы это поменяло? Заявления о том что формат не развивается тут не катят. Черный текст на белом фоне и там и там, везде всё одинаково.

Ну а по поводу djvu, pdf и остальных, то ок, сделаю чтобы в меню добавлялись все файлы из папки.
Аватара пользователя
Dragon_Knight
Сообщения: 581
Зарегистрирован:
10 сен 2012, 02:43
Контактная информация:

Dragon_Knight » 04 янв 2014, 02:08

ZUMA, Для просмотра djvu, pdf и остальных нужен сторонний софт, для CHM нужна операционная система Windows.
Более того, инструкции в указанных вами форматах занимают в сотни раз больше, открываются дольше и постраничное пролистывание - полнейший дибилизм.....
Аватара пользователя
ZUMA
Сообщения: 6
Зарегистрирован:
27 окт 2013, 10:20
Откуда: Ставрополь

ZUMA » 04 янв 2014, 13:18

Dragon_Knight, не хочу спорить. Сторонний софт, как я указал - достаточно суматра-пдф (в гугле найти легко, заменяет многотонные акробаты и плагины, читает кучу всяких форматов, включая файлы читалок и весит всего 5 метров, да и бесплатная прога). Это по поводу софта. А что касается постраничного перелистывания, то я как-то не особо вижу проблем (см.вложение).

И самое главное, что есть новые книги, шпоргалки, мануалы и т.п..

Собственно Максим (дай бог тёзке здоровья) меня услышал, тему можно закрывать.
Вложения
2014-0104001.png
Аватара пользователя
DelphinPRO
Сообщения: 803
Зарегистрирован:
01 фев 2012, 17:27
Откуда: Самара
Контактная информация:

DelphinPRO » 04 янв 2014, 18:42

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