2. BML Template Reference
For reference, here are the most commonly used BML templates in the LiveJournal repository:
Pre-configured
The following are BML templates set from configuration options
in $LJHOME/etc/ljconfig.pl.
All templates here are defined as “S” (static).
The following BML templates are defined
in $LJHOME/cgi-bin/bml/scheme/global.look
and are available in every scheme.
Global
- SECURITYPRIVATE
-
HTML image sourcing from
/img/icon_private.gif
- SECURITYPROTECTED
-
HTML image sourcing from
/img/icon_protected.gif
- HELP
- Given a URL, this provides a small link with the caption “help”
- INERR
- Displays an error message in an easily identifiable manner (bold red text)
- NEEDLOGIN
- A small blurb that's included on pages where the user is not logged in and is required to be
- BADINPUT
- An error message that displays when there is an encoding problem with the user's browser
- REQUIREPOST
- An error message explaining that certain user actions require POSTing information through an HTML form, rather than manually GETting the page
- LOAD_PAGE_INFO
- Initializes and populates a perl array that is used to create a sidebar of links along a page layout
- H1
- Top level header on a page
- H2
- Sub level header on a page
- P
- Generic HTML paragraph wrapper
- STANDOUT
- Given a block of text, this template tries grab the user's attention by using different text and background colors
- BADCONTENT
- An error message that displays when a problem (that the user can fix) has occurred during a request
- DE
- A template that de-emphasizes text
-
EMCOLOR, EMCOLORLITE, HOTCOLOR
- Various emphasis colors
- SCREENEDBARCOLOR
- A color that is used to highlight screened comments in comment threads
- CHOICE
- Given 3 arguments (a URL, a title, and an explanatory blurb), this template fashions an item to be used in a CHOICES list
- CHOICES
- Given 2 arguments, this template tries to construct a side by side list of options and appropriate links
- PAGE
-
This template is the BML template that governs the look of the entire scheme, and takes 4 arguments:
- title
- The page title
- head
- Page-specific elements that belong in a HTML head
- bodyopts
- Additional attributes for the HTML body element
- body
- The main content of the page