Страница 1 из 1

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

Добавлено: 03 янв 2014, 11:47
ZUMA
Конечно это громкое название, но факт остаётся фактом.

А именно. Есть у 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. Почему?

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

Ну а по поводу djvu, pdf и остальных, то ок, сделаю чтобы в меню добавлялись все файлы из папки.

Добавлено: 04 янв 2014, 02:08
Dragon_Knight
ZUMA, Для просмотра djvu, pdf и остальных нужен сторонний софт, для CHM нужна операционная система Windows.
Более того, инструкции в указанных вами форматах занимают в сотни раз больше, открываются дольше и постраничное пролистывание - полнейший дибилизм.....

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

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

Собственно Максим (дай бог тёзке здоровья) меня услышал, тему можно закрывать.

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