Информация об изменениях

Сообщение Re[3]: Как нынче принято делать хелп? от 21.03.2023 7:31

Изменено 21.03.2023 7:33 qaz77

Re[3]: Как нынче принято делать хелп?
Здравствуйте, kov_serg, Вы писали:

_>В offline версии милионый html файлов справки как у java это прото кошмар. А если еще и учесть около нулевую информативность и жуть при попытке распечатать, то вариант так себе.

_>Другая крайность это документация по автомобилям сотни тысяч html которые ссылаются на лежащие неподалёку pdf-ки где собственно основное жир и лежит, причем желательно сканированный.

Чисто на html — да, кошмар. Приходилось мне ковыряться в документации SDK OpenOffice...

В нашем варианте пользователь и не знает, что у него где-то эти тысячи html лежат.
Он не работает с ними напрямую, а через окно наподобие HtmlHelp.
Например, нажимает F1 — открывается окно справки с нужной страничкой.

_>Все эти толпы файлов для offline очень удобно копируются на флешку (примерно вечность).

Нет такой необходимости.
Эти файлы один раз инсталлятор пишет на комп пользователя при установке продукта.

_>...

Q>>Затем питон работает с этим XML, генерирует все, что нужно.
Q>>И в итоге заливается на сайт.
_>Если пользователь хочет offline вариант, то выкачивать весь сайт, править скриптами и складывать в chm?

Нет, это не про пользователя.
Это я описал внутренний технологический этап преобразования оффлайн версии доков в онлайн.

Есть репозиторий с html и картинками. Сначала на него натравливается программа, которая строит модель:
содержание, алфавитный указатель и проч.
Далее эта модель записывается с XML.
Этот XML читает питоновский скрипт и генерирует онлайн-сецифик вещи, которых нет в исходном репозитории.
И его выхлоп уже заливается на сайт.

_>Короче ужас со всех направлений.

Не согласен.
10 лет полет нормальный.
Удобнее, чем было с CHM.
Re[3]: Как нынче принято делать хелп?
Здравствуйте, kov_serg, Вы писали:

_>В offline версии милионый html файлов справки как у java это прото кошмар. А если еще и учесть около нулевую информативность и жуть при попытке распечатать, то вариант так себе.

_>Другая крайность это документация по автомобилям сотни тысяч html которые ссылаются на лежащие неподалёку pdf-ки где собственно основное жир и лежит, причем желательно сканированный.

Чисто на html — да, кошмар. Приходилось мне ковыряться в документации SDK OpenOffice...

В нашем варианте пользователь и не знает, что у него где-то эти тысячи html лежат.
Он не работает с ними напрямую, а через окно наподобие HtmlHelp.
Например, нажимает F1 — открывается окно справки с нужной страничкой.

_>Все эти толпы файлов для offline очень удобно копируются на флешку (примерно вечность).

Нет такой необходимости.
Эти файлы один раз инсталлятор пишет на комп пользователя при установке продукта.

_>...

Q>>Затем питон работает с этим XML, генерирует все, что нужно.
Q>>И в итоге заливается на сайт.
_>Если пользователь хочет offline вариант, то выкачивать весь сайт, править скриптами и складывать в chm?

Нет, это не про пользователя.
Это я описал внутренний технологический этап преобразования оффлайн версии доков в онлайн.

Есть репозиторий с html и картинками. Сначала на него натравливается программа, которая строит модель:
содержание, алфавитный указатель и проч.
Далее эта модель записывается с XML.
Этот XML читает питоновский скрипт и генерирует онлайн-специфик вещи, которых нет в исходном репозитории.
И его выхлоп уже заливается на сайт.

_>Короче ужас со всех направлений.

Не согласен.
10 лет полет нормальный.
Удобнее, чем было с CHM.