Информация, содержащаяся в этом файле, пригодится Вам для более детального изучения работы Транспозитора.
Аббревиатуры текстовых блоков
Если Вы заглядывали в HTML-код, формируемый Транспозитором, Вы могли увидеть таблицу стилей, на основе которой Ваш обозреватель "разукрашивает" текст песни. Каждый из элементов этого списка определяет вид конкретного текстового блока, например, аккордов, или комментариев.
Названия этих текстовых блоков Вы также можете увидеть в файле Transposer.ini и файлах Цветовых Схем Оформления (cs_*.ini) в каталоге INI программы. Ниже приведена "расшифровка" этих аббревиатур, которая поможет Вам сориентироваться при необходимости ручного редактирования CSS или INI-файлов:
HTML-страницы в Транспозиторе строятся на основе шаблонов HTML-страниц (которые можно посмотреть в каталоге Sbl). Если какой-нибудь из этих шаблонов открыть в любом текстовом редакторе (в том же Блокноте), Вы увидите, что они представляют собой обычные HTML-файлы. За одним исключением.
В HTML-шаблонах встречаются тэги специального вида, начинающиеся с символа # (например #AddIfMultiplySongs). Они отмечают места, в которые HTML-парсер должен подставлять реальную информацию из того текстового файла, который Вы экспортируете в HTML.
Ниже приведено описание этих тэгов. Эта информация Вам пригодится, если Вы решите самостоятельно разработать новый HTML-шаблон.
Вид тэга
Тэг заменяется на...
<#FileTitle>
Название файла, или имя исполнителя и название песни
<#Styles>
Указывает место расположения таблицы стилей (CSS)
<#TV аббрев=clBack>
Заменяется на цвет фона заданного текстового блока. Здесь аббрев - это аббревиатура текстового блока. Например:
<#TV CO=clBack>
- подставить цвет фона текстового блока содержания файла.
<#AddIfMultiplySongs
File=имя_файла>
Заменяется на содержимое файла имя_файла.htm, но только в том случае, если экспортируется одновременно больше чем одна композиция. Например:
<#AddIfMultiplySongs File=Contents>
- подставить содержимое файла contents.htm (Таблица содержания), но только в том случае, если экспортируется более одной песни.
<#SongNo>
Заменяется на номер текущей обрабатываемой песни. Часто используется как вложенный тэг с другими тэгами.
<#TitleWidth
SongNo=номер_песни>
Заменяется на число 75 или 100 - в зависимости от указанного номера песни. Например, строка:
width="<#TitleWidth SongNo=<#SongNo>>%"
будет заменена на
width="75%"
если указанная песня - первая в списке на экспорт, и на
width="100%"
в любом другом случае.
<#FileName
SongNo=номер_песни>
Заменяется на имя по-умолчанию для указанной песни. Этот параметр удобно применять для связи между получаемыми HTML-файлами, для установки перекрестных ссылок между ними. Например:
a href=<#FileName SongNo=<#SongNo>-1>
- подставить ссылку на предыдущий файл в списке.
<#Singer
SongNo=номер_песни>
Заменяется на имя исполнителя указанной песни. Например:
<#Singer SongNo=<#SongNo>-1>
- подставить имя исполнителя предыдущей композиции.
<#Title
SongNo=номер_песни>
Заменяется на название указанной песни. Например:
<#Title SongNo=<#SongNo>-1>
- подставить название предыдущей композиции.
<#IfExistParams
SongNo=номер_песни
Result="код">
Если для указанной композиции определены какие-либо параметры мелодии (такие как темп, транспозиция, стиль и др.), то вместо этого тэга подставляется указанный HTML-код "код".
<#Params
SongNo=номер_песни>
Заменяется на параметры мелодии указанной песни.
<#SongBody
SongNo=номер_песни>
Заменяется на текст указанной песни.
<#GoTop>
Заменяется на слово "К началу".
<#GoBack>
Заменяется на слово "Назад".
<#ContentTitle>
Заменяется на слово "Содержание".
<#ForEachSong
File=имя_файла>
Заменяется на содержимое файла имя_файла.htm столько раз, сколько песен экспортируется.
<#IfNewSinger
SongNo=номер_песни
Result="код">
Если исполнитель указанной песни не совпадает с исполнителем предыдущей песни, то заменяется на HTML-код "код".
<#HomePage>
Заменяется на домашнюю страничку Транспозитора
<#IfNotFirst
SongNo=номер_песни
Result="код">
Если указанная песня не первая в списке на экспорт, то тэг заменяется на HTML-код "код".
<#IfNotLast
SongNo=номер_песни
Result="код">
Если указанная песня не последняя в списке на экспорт, то тэг заменяется на HTML-код "код".
Если у Вас появились вопросы, пожелания или комментарии о "Транcпозиторе", или Вы обнаружили ошибки в нашей программе, - направляйте их Transposer Software. Сообщите нам, что бы Вы хотели увидеть в будущих релизах программы!
