This information is useful for detailed studying of the Transposer.
If you look into a HTML code generated by the Transposer, you will see the CSS style table. Using this table your browser "decorates" the text of a song. Each element of this table defines a view of the corresponding text block, for example, chord or comment block.
Also you can see names of these text blocks in "Transposer.ini" and Color Schemes files (cs_*.ini) placed in "INI" folder. If you decide to manually edit CSS tables or HTML templates of the Transposer then you need this abbreviation expansions:
Transposer constructs HTML pages on the basis of HTML templates. You can find these templates in Sbl folder. If you open any of the templates in a text editor (for ex. Notepad), you will see usual HTML file. With one exception.
There are the special tags beginning with # character (for example #AddIfMultiplySongs). They mark places for inserting blocks from the text file which you export to HTML.
Below the description of these tags is given. If you decide to develop a new HTML templates independently this information will useful for you.
Tag |
is replaced with... |
<#FileTitle> |
File name, or singer's name and song title |
<#Styles> |
Specifies the location of the table of styles (CSS) |
<#TV abbrev=clBack> |
Background color of the text block. Here abbrev is an abbreviation of the block (see table above). For example:
<#TV Co=clBack>
is replaced with background color of the Table of content. |
<#AddIfMultiplySongs
File=file_name> |
Contents of a file_name.htm file but only when it is exported more than one composition simultaneously. For example:
<#AddIfMultiplySongs File=Contents>
is replaced with Contents.htm (which contains the Table of content) but only when it is exported more than one song. |
<#SongNo> |
Current song number. It is often used as the enclosed tag inside of an other tag. |
<#TitleWidth
SongNo=song_no> |
75 or 100 - depending on specified song number song_no. For example, a line:
width="<#TitleWidth SongNo=<#SongNo>>%"
If the specified song is the first in the export list then it will be replaced with
width="75%"
else will be replaced with
width="100%" |
<#FileName
SongNo=song_no> |
Default name of song #song_no. This parameter is convenient to establish connections between resulted HTML files, to make crossreference links between these files. For example:
a href=<#FileName SongNo=<#SongNo>-1>
is replaced with the link to the previous processed HTML file. |
<#Singer
SongNo=song_no> |
Singer's name of the specified song #song_no. For example:
<#Singer SongNo=<#SongNo>-1>
is replaced with a name of the singer of the previous processed composition. |
<#Title
SongNo=song_no> |
Song title of the specified song #song_no. For example:
<#Title SongNo=<#SongNo>-1>
is replaced with a title of the previous processed song. |
<#IfExistParams
SongNo=song_no
Result="code"> |
If the composition #song_no has any parameters (such as tempo, transposition, style, etc.) then this tag is replaced with the HTML code "code". |
<#Params
SongNo=song_no> |
Parameters of the composition #song_no |
<#SongBody
SongNo=song_no> |
Text of the composition #song_no |
<#GoTop>
|
is replaced with "Go top" (adjusted for current language) |
<#GoBack>
|
is replaced with "Back" (adjusted for current language) |
<#ContentTitle>
|
is replaced with "Contents" (adjusted for current language) |
<#ForEachSong
File=file_name> |
Ñontents of a file_name.htm file repeated N times, where N - count of exported songs. |
<#IfNewSinger
SongNo=song_no
Result="code"> |
If the performer of the song #song_no differs from the performer of the previous song it is replaced with a HTML code "code". |
<#HomePage>
|
The Transposer's homepage |
<#IfNotFirst
SongNo=song_no
Result="code"> |
If the specified song #song_no is not the first in the export list then the tag is replaced with a HTML code "code". |
<#IfNotLast
SongNo=song_no
Result="code"> |
If the specified song #song_no is not the last in the export list then the tag is replaced with a HTML code "code". |
