[addon] HTMLINFO

[asmol]

Аддон формирует в корневой папке вашего дистрибутива файл ADDONS.HTM вместо ADDONS.TXT.


Импортируется CSS стиль, взят из файла README.HTM дистрибутива Windows XP;
Автоматически создается "Содержание", работают переходы к разделу и назад к содержанию;
Добавляются разделы "Введение", "OEM информация" и "Благодарности";
Добавляются все *.nfo файлы, txt формат добавляется с сохранением оригинального форматирования;
Из специально подготовленных html.nfo файлов (содержат заголовок и текст с HTML разметкой)
имя автора и название аддона добавляется в конец раздела "Благодарности";
Удаляет информацию о своем применении из файла ADDONS.LST в каталоге I386 дистрибутива,
что делает возможным его многократный запуск с помощью команды '__PATCH 0-HTMLINFO';



11.09.2007
+ Оформлен в виде аддона;
+ Аддон удаляет информацию о своем применении из файла ADDONS.LST в каталоге I386 дистрибутива,
что делает возможным его многократный запуск с помощью команды '__PATCH 0-HTMLINFO';

12.09.2007
+ Вся информация берется из файла HTML.NFO и только в случае его отсутствия из файла ADDON.NFO;
+ Добавлен файл HTML.NFO в качестве примера;
+ В случае если в файл ADDONS.HTM не добавлено ни одного описания аддона - файл не будет
скопирован в папку дистрибутива, уже существующий в дистрибутиве ADDONS.HTM не удаляется;

19.09.2007
! Исправлена некорректная работа аддона вызываемая наличием пробела в названиях папок аддонов;
+ Добавлен файл './IncHtml/LogoImage' - упрощает замену логотипа либо его удаление.

24.10.2007
+ В баннер заголовка вставляется версия сборки дистрибутива, вычисляется на основе текущей даты;
+ Добавлена возможность определения версии UpdatePack-а. Вставляется в заголовок, в "Оглавление"
и секцию "Благодарности";
- Секция "OEM информация" теперь по умолчанию скрыта. Из секций "Введение" и "Благодарности"
убран текст;
- Пример форматирования текста переехал в файл examle.nfo.

21.01.2008
! Оптимизирована функция определения версии UpdatePack-а.

13.02.2008
+ Исправление CSS. Секция PRE добавлены FONT-SIZE: 120%; FONT-FAMILY: "Courier New", Courier, monospace;
- Исправление CSS. Ссылки - убран параметр CURSOR: hand;
! Оптимизирована функция получения параметров из файлов описаний.

19.03.2008
- Убран поиск параметров в файлах Addon.nfo, что приводило к ошибке, если в одной строке
встречались символы '=' а за тем '&', '<', '>' или '|';
+ Введено ограничение на использование символов "^&|<>" при определении значений параметров.

7.05.2008
+ Добавлено формирование заголовка в зависимости от маркерных файлов дистрибутива.

10.05.2008
! Скорректирована обработка секции Thanks, сначала этот файл ищется в корне UpdatePack и только потом
в папке IncHtml аддона.

18.08.2008
! Исправление ошибок/опечаток в файлах аддона.

25.10.2008
! Исправлено. Пробел в пути к каталогу UpdatePack приводил к сбою в скрипте аддона.
+ Добавлена поддержка переменной окружения %Configure%.

22.07.2009
! Полностью переписаны скрипты с целью ускорить рыботу. Функциональность сохранена.

23.07.2009
+ Добавлена поддержка пакета обновлений UpdatePack-XPSP2-x64-enu

24.07.2009
+ Добалено копирование логотипа соответсвующего дистрибутиву.

26.07.2009
! Исправление, делает аддон менее критичным к использованию спецсимволов в именах каталогов.

[hr]
Аддон протестирован на совместимость с UpdatePack-XPSP3-Rus, UpdatePack-WINXP-SP2-X64-EN и UpdatePack-W2K3SP2-Rus.

[Ma1chik]

Спасибо, идея очень хорошая.
Было бы неплохо вложить в аддон шаблон nfo файла, со всеми нужными параметрами :)

[gora]

asmol
'__PATCH 0-HTMLINFO »
1 Пропал закрывающий апостроф
2 Присоединяюсь к Ma1chik по поводу примера заполнения nfo файла по второму варианту. Да и свой аддон надо бы снабдить именно таким файлом (как образцовому аддонописателю).
ADDON_BUILD = "Версия или дата"
вставляется в банер после заголовка и добавляется в секцию благодарностей3 А зачем версию и дату добавлять в секцию благодарностей.
Хоть бы увидеть как будет выглядеть ваш Addons.htm при втором варианте оформления nfo файла ;) .
4 Информацию о вашем аддоне нужно закинуть и сюда (http://forum.oszone.net/thread-60631.html). Авторы аддонов обрадуются и быстренько переделают свои nfo файлы. :)
ADDON_URL = "ссылка на сайт"5 А на какой сайт? Разработчика ПО или ветку аддона. Ссылка вылезает под авторами аддона, а где же ссылка на сайт разработчика ПО?

[jameszero]

Есть небольшой нюанс, предположим, авторы аддонов сопроводят свои addon.nfo необходимыми параметрами, причём это будет не сразу, и возможно не все станут над этим заморачиваться. Что получим в результате - если человек не использует 0-HTMLINFO, то его ADDONS.TXT, наряду с обычным описанием аддонов, будет содержать малоинформативные для текстового документа параметры и примет не очень читабельный вид

Может есть смысл включать в аддоны два файла с описанием - addon.nfo в классическом стиле и addonhtm.nfo c параметрами, или вынести параметры в отдельный файл, Update Pack будет по прежнему обрабатывать addon.nfo, а скрипт 0-HTMLINFO немного подкорректировать, чтобы он определял наличие файла с параметрами и брал его, а если такового не обнаружено, включал в описание классический addon.nfo

Ну и конечно, желательно выработать единый шаблон, оговорить ограничения, чтобы результат выглядел более менее презентабельно.

asmol,
наверно стоит добавить в help, что ссылку в параметре ADDON_URL необходимо приводить с указанием http://
иначе, при указании просто www.site.ru получаем переход на file:///C:/www.site.ru
либо реализовать проверку http:// в скрипте 0-HTMLINFO.

[asmol]

1 Пропал закрывающий апостроф » Спасибо, не заметил

добавте в начало нескольких сушествующих nfo файлов такую шапку


<!--
ADDON_AUTHOR = "Вася Пупкин"
ADDON_TITLE = "Название аддона"
ADDON_BUILD = "1.2.3"
ADDON_URL = "http://www.internet.ru"
NO_HYPERTEXT = 1
-->


Может есть смысл включать в аддоны два файла с описанием - addon.nfo в классическом стиле и addonhtm.nfo c параметрами, или вынести параметры в отдельный файл, Update Pack будет по прежнему обрабатывать addon.nfo »
согласен, уже думал над этим и скоро сделаюпри указании просто www.site.ru получаем переход на file:///C:/www.site.ru »
проще добавить в Help.txt, не заметил, спасибо

[asmol]

Обновиление аддона

Добавлено:
+ Вся информация берется из файла HTML.NFO и только в случае его отсутсвия из файла ADDON.NFO
+ Добавлен файл HTML.NFO в качестве примера
+ В случае если в файл ADDONS.HTM не добавлено ни одного описания аддона - файл не будет
скопировн в папку дистрибутива, уже существующий в дистрибутиве ADDONS.HTM не удаляется

Ссылка вылезает под авторами аддона, а где же ссылка на сайт разработчика ПО? »
можно в файле Addons/0-HTMLINFO/IncHtml/OemInfo

Хоть бы увидеть как будет выглядеть ваш Addons.htm при втором варианте оформления nfo файла »
не только увидеть, но и собрать похожий, пример прикреплен

Ну и конечно, желательно выработать единый шаблон, оговорить ограничения, чтобы результат выглядел более менее презентабельно. »
использовать по возможности простую разметку, а общий стиль обеспечит общий css файл

Забирать с этого поста. В первом не могу изменить прикрепленные файлы. Либо не достаточно прав, либо я не автор того сообщения. Возможно что-то делаю не так - советы в PM.

[ya158]

Заметил небольшой глюк:
Если в названии папки, в которой лежит аддон, присутствует круглые скобки (например папка называется MYADDON(test) ), при работе аддона 0-HTMLINFO скрипт __PATCH.CMD вылетает с ошибкой.

[jameszero]

asmol
В первом не могу изменить прикрепленные файлы. Либо не достаточно прав, либо я не автор того сообщения.Попробуйте снова, должно получится. Blast пофиксил. Если не получится, отпишитесь здесь (http://forum.oszone.net/thread-86773-24.html)

[ya158]

asmol,
В правом верхнем углу файла ADDONS.HTM должен быть какое-то изображение, но его там нет. Видимо это логотип. Как его туда поместить?

[Boa Soft]

ya158,

Если диск был оригинальный и не укоцаный, то \DOCS\WINXP_LOGO_HORIZ_SM.GIF
Это логотипчик винды, как в оригинальном описпнии от MS.
Можно логотип oszone или свой прикрутить, только теги размеров скорректировать.

[ya158]

Boa Soft,
Понял. Спасибо.

[asmol]

Заметил небольшой глюк:
Если в названии папки, в которой лежит аддон, присутствует круглые скобки (например папка называется MYADDON(test) ), при работе аддона 0-HTMLINFO скрипт __PATCH.CMD вылетает с ошибкой. »

этот небольшой глюк я исправил, ссылка в шапке.

круглые скобки являются служебными символами и их использование в именах каталогов может привести (а может и не привести) к непредсказуемым последствиям.

[IDDQDesnik]

asmol,
1. по поводу постов
В правом верхнем углу файла ADDONS.HTM должен быть какое-то изображение, но его там нет. Видимо это логотип. Как его туда поместить? »
Если диск был оригинальный и не укоцаный, то \DOCS\WINXP_LOGO_HORIZ_SM.GIF
Это логотипчик винды, как в оригинальном описпнии от MS.
Можно логотип oszone или свой прикрутить, только теги размеров скорректировать. »

IMHO, может стоит откорректировать аддон, что бы картинка бралась него самого, так как папку DOCS, а так же прочие VALUEADD я и многие другие удаляют за ненадобностью.

2. аддон некоректно отрабатывает, если в названиях папок аддонов присутствуют пробелы

[IDDQDesnik]

asmol,
и еще, добавь пожалуйста в стиль PRE
FONT-SIZE: 14;
а то в FireFox описания аддонов слишком мелкие

[asmol]

аддон некоректно отрабатывает, если в названиях папок аддонов присутствуют пробелы »
исправлено.

IDDQDesnik, если удалить папку DOCS логотип пропадет и в файлах README.HTM и SETUPXP.HTM или вы их тоже удаляете?
в описание секции PRE добавил
font-size: 110%;
если этого не достаточто отпишитесь

Можно логотип oszone или свой прикрутить, только теги размеров скорректировать. »
чтобы проще было это сделать добавил файл './IncHtml/LogoImage' в котором содержится одна строка <IMG SRC="./Docs/winXP_logo_horiz_sm.gif" WIDTH="314" HEIGHT="68" BORDER="0" ALT="Microsoft Windows&nbsp;XP">
если его отредактировать/переименовать/удалить можно изменить или совсем убрать логотип

[IDDQDesnik]

asmol,
если удалить папку DOCS логотип пропадет и в файлах README.HTM и SETUPXP.HTM или вы их тоже удаляете? »
Да, удаляю, так как еще никого не видел, кому бы они были нужны.

В общем, переписал я немного аддон под себя, для изменения генерируемой станицы ADDONS.HTM . Формат файлов html.nfo не изменен. Добавлена пара фиx типа автоматичесгого определения версии пака и вынесения благодарности Пете.

Для изменения автора сборки, в файле start в строке Set Autor=IDDQDesnik после знака = пишите свой ник.

аддон в аттаче

[asmol]

В банер заголовка вставляется версия сборки дистрибутива, вычисляется на основе текущей даты;

Добавлена возможность определения версии UpdatePack-а. Вставляется в заголовок, в "Оглавление" и секцию "Благодарности"; Спасибо за идею IDDQDesnik.

Секция "OEM информация" теперь по умолчанию скрыта. Из секций "Ведение" и "Благодарности" убран текст;

Пример форматирования текста переехал в файл examle.nfo;

В общем старался сделать, чтобы требовалась минимальная доводка под себя.

[Progopis]

а то в FireFox описания аддонов слишком мелкие »
Стиль не корректный, от этого и пробемы со шрифтами. Консоле ошибок FireFox не нравятся строчки вида
CURSOR:hand;
Думаю проще удалить...

в описание секции PRE добавил »
???? В версии HTMLINFO-7.10.24.7Z ничего такого не вижу...

Короче, кому надо, вот корректный (с моей и FireFox`а точек зрения) стиль для данного аддона (проверен на IE 6, Opera, FireFox)

Есть проблемы с некоторыми аддонами. В частности Nero Burning ROM 6.6.1.15 портит границу в html-файле. Но эта проблема не из-за меня. Она проявится если использовать обычный addons.css. Вообщем, не спешите скачивать мой исправленный вариант, он еще подлежит правке...

P.S. Я конечно понимаю что на конференции собралось много поклонников технологий Microsoft, но все же, надеюсь со мной многие согласятся, в Microsoft работает не малое количество любителей нарушать стандарты. Яркий пример тому, различное отображение страниц в браузерах IE vs Opera, FireFox, Konqueror (и прочие)...

Замечание автору аддона - использование HTML в аддоне автоматически обязывает вас проверить его на, хотя бы, нескольких браузерах (вы же не только для себя его сделали, не так ли?). Этот факт, тем не менее, не уменьшает степень моей благодарности автору за идею и реализацию этого аддона...

[asmol]

Исправление addons.css.
+ Секция PRE добавлены FONT-SIZE: 120%; FONT-FAMILY: "Courier New", Courier, monospace;
- Исправление CSS. Ссылки - убран параметр CURSOR: hand;
Проверял на FireFox 2.0.0.12 - размер шрифта нормальный. У кого были проблемы - пробуем.

Progopis,
Если добавлять FONT-SIZE: 14;, как у вас, в IE6 перетает работать маштабирование для секции PRE (Вид > Размер шрифта > ...). В IE7, Opera 9.25 и FireFox 2 такого глюка не заметил.

В частности Nero Burning ROM 6.6.1.15 портит границу в html-файле. »

Скорее всего в файле addon.nfo, этого аддона, текст набран без переводов строк в абзацах.

[asmol]

Только сегодня заметил ошибку в формировании имени якоря для OemInfo. Перезалил по новой.