AIMP Forum
AIMP for PC => Вопросы / Questions => Topic started by: Rikhter on March 10, 2026, 19:44:16
-
Уважаемая администрация!
Мне бы хотелось уточнить причину по которой документация к Вашему SDK до сих пор распространяется в формате исполняемых HTML-справок? В чём проблема разместить её в виде полноценного онлайн раздела на сайте? Ибо в реалиях сегодняшнего дня такой способ распространения выглядит откровенно архаичным и создаёт ощущение, будто мы всё ещё живём во времена Windows 98. Работать с подобным форматом, мягко говоря, крайне неудобно ...
-
В реалиях сегодняшнего дня онлайн - штука нестабильная
-
Ибо в реалиях сегодняшнего дня такой способ распространения выглядит откровенно архаичным и создаёт ощущение, будто мы всё ещё живём во времена Windows 98
А если по делу? Чем CHM неудобен?
-
ИМХО, в оффлайне со справкой работать удобнее, единственная беда всех CHM - примитивный поиск.
-
единственная беда всех CHM - примитивный поиск
Это да, а современные форматы справок требуют дополнительного софта, к сожалению...
Я не стал делать онлайн справку по двум причинам:
1) скачать SDK недостаточно - нужен онлайн
2) SDK у нас несколько - с каждым из них идёт определенная версия справки. Если делать онлайн справку - может возникнуть путаница с версиями - скачали SDK для одной версии, а справку открыли для другой - и ничего не работает.
-
А я не люблю такие CHM (а PDF и подавно), где жётско прописаны bgcolor="#FFFFFF", из-за этого приходится ставить галочку в "Свойства обозревателя…" — Оформление — "Не учитывать цвета, указанные на веб-страницах" (или может в политиках каких ещё что-то), хотя и это изредка приводит к небольшим неудобствам… Особо тяжёлые случаяи, когда определённые .chm запрещают hh отображать нужные элементы окна (кнопки или какие-нибудь панели) — вроде и попался какой-то "редактор" таких "атрибутов", но что-то мне им не удалось исправить такие .chm`ки (чаще они вообще ломались), и, соответственно, выходит как у "старого доброго .hlp" — даже страницу никак не отмасштабировать! HTML (для банального просмотра в ишаке) в этом плане хотя бы предпочтительнее, но, вспоминая, как погано оно сделано у LibreOffice, то не знаю, что лучше :(
Не идеальный и .h1s (да и инструментов для их создания нет в открытом доступе — ждём слива исходиков висты/7ки, да и с их "открытием" такая же проблема, как со справкой VisualStudio 2005/2008), но этот хотя бы интереснее, да и поприятнее чтоль… MSHelp2 — наихудший сценарий :)
Я не против DOS-варианта (да даже для qh, хотя я его тоже не понимаю…), но лучше, чтоб можно было читать прямо из-под консольного FreePascal IDE :)
-
CHM
Мне как WEB разработчику привычен онлайн формат, поэтому привык использовать документацию прямо в браузере и в этом есть свои плюсы, ибо там удобнее поиск, проще ориентироваться между версиями библиотек, а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение. Кроме того, web-документация проще обновляется и лучше интегрируется с поиском и современными инструментами разработки по сравнению с CHM.
-
Мне как WEB разработчику привычен онлайн формат, поэтому привык использовать документацию прямо в браузере и в этом есть свои плюсы, ибо там удобнее поиск, проще ориентироваться между версиями библиотек, а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение. Кроме того, web-документация проще обновляется и лучше интегрируется с поиском и современными инструментами разработки по сравнению с CHM.
Это всё верно, но только оно не применимо к нашему случаю. Про обновление документации я уже сказал выше - она обновляется только с обновлением самого SDK.
-
А я не люблю такие CHM (а PDF и подавно), где жётско прописаны bgcolor="#FFFFFF", из-за этого приходится ставить галочку в "Свойства обозревателя…" — Оформление — "Не учитывать цвета, указанные на веб-страницах" (или может в политиках каких ещё что-то), хотя и это изредка приводит к небольшим неудобствам… Особо тяжёлые случаяи, когда определённые .chm запрещают hh отображать нужные элементы окна (кнопки или какие-нибудь панели) — вроде и попался какой-то "редактор" таких "атрибутов", но что-то мне им не удалось исправить такие .chm`ки (чаще они вообще ломались), и, соответственно, выходит как у "старого доброго .hlp" — даже страницу никак не отмасштабировать! HTML (для банального просмотра в ишаке) в этом плане хотя бы предпочтительнее, но, вспоминая, как погано оно сделано у LibreOffice, то не знаю, что лучше :(
Не идеальный и .h1s (да и инструментов для их создания нет в открытом доступе — ждём слива исходиков висты/7ки, да и с их "открытием" такая же проблема, как со справкой VisualStudio 2005/2008), но этот хотя бы интереснее, да и поприятнее чтоль… MSHelp2 — наихудший сценарий :)
Я не против DOS-варианта (да даже для qh, хотя я его тоже не понимаю…), но лучше, чтоб можно было читать прямо из-под консольного FreePascal IDE :)
К чему это было? 🤔
-
а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение.
кроме программирования с использованием компонентов виндовс (винапи) там и изучать ничего
+ какой вы код собираетесь запускать в песочнице это плеер а не питон там все функции симулировать придётся
-
хотел дописать но свет вырубили так и забыл
короче... я ненавижу онлайн документации и им подобным когда интернет вырубают а ты пишешь программу (да лабораторной например) а перед тобой документации нет а не каждый разработчик позволяет качать страницу для печати (обычные html разваливаются даже в браузерах не говоря об емаксе и подобных читалок) chm это дарование и дерево есть и хоть какой никакой да поиск