F05:Section Title Block Selectors

Overview

This section contains definitions and usage guidelines for all the standard Foundation Section Title Block Selectors specified by IGP:FoundationXHTML. Note that other than the template DP-Master-2012 is is unlikely and unrequired that all these Inline selectors are available in a single template.

Please note this is the Foundation list and not the complete list for all genres.

Section Group Title Blocks

.title-block-rw

Used for title-block in all sections except BookTitlePage-rw and DocTitlePage-rw. For processing purposes any section title-block is the first child title-block after a section opening element. Explicitly a processor must ignore any other title-blocks in a section.

 .title-block-rw .title-num-rw

Use this If a section contains numbering. This is a processing target and can be updated from the Document Processor option Process Part and Chapter Numbers.

If section numbers are keyed and must not be processed do not use Process Part and Chapter Numbers, or protect it with a title-num-section-rw selector.

.title-block-rw h1

A title always uses HTML <h1> (heading 1). This is reserved for title and must not be used anywhere else in a document other than in a title-block. It has no class statements. This ensures every page is created in accordance with accessibility guidelines, plus it is a valid processor target.

.title-block-rw .title-sub-rw

Use if a section has a sub-title. 

 .title-block-rw .title-author-rw

Use if a section needs an author name or statement. If you need to tag name details use the cite selectors if more name details are required.

 .title-block-rw .title-contributor-rw

Use if a section needs a contributor(s) name or statement. If you need to tag name details use the cite selectors if more name details are required. 

.title-block-rw .title-other-rw

Use if there is any free form text that applies explicitly to the title block. 

FX title blocks are designed to be easy to create and easy for processors to parse. If your document does not have a title block in print, you should still use a title block and include minimum metadata for e-book TOC generation. In this case use CSS to display:none; to remove it completely ordisplay: hidden; to reserve the defined vertical space without showing the content.

Title Block Processing Instruction Selectors

 .title-num-label-rw

This is an inline selector. When this span is applied to the label of a title number it is protected from number regeneration. Example: 

<p class="title-num-rw"><span class="title-num-label-rw">Chapter</span> 23</p>

If Section numbers are regenerated the word Chapter will remain and only the number will be updated.

 .title-num-section-rw

This allows the generation of a section number without changing any label text. When section numbers are generated the label will not be changed. Example: 

<p class="title-num-rw">Appendix
    <span class="title-num-section-rw">X</span>
</p>

When Section renumbering is applied the number will be processed and the section will not change.

Title Block Processing Alternative Content Selectors

By default title content in a section is used for the generation of tables-of-content and running heads in print.

In some cases this can be too long or for other reasons inappropriate. Alternative title text can be defined for all six standard title-block elements. If the content  exists with *-alt-rw selectors a processor should use the alternative text rather than the primary element text.

.title-num-alt-rw

Encloses text that will be used as a substitute for title-num-rw in processor generated content.

.title-title-alt-rw

Encloses text that will be used as a substitute for <h1> in processor generated content.

.title-sub-alt-rw

Encloses text that will be used as a substitute for title-sub-rw in processor generated content.

.title-author alt-rw

Encloses text that will be used as a substitute for title-author-rw in processor generated content.

.title-contributor-alt-rw

Encloses text that will be used as a substitute for title-contributor-rw in processor generated content.

.title-other-alt-rw

Encloses text that will be used as a substitute for title-other-rw in processor generated content.

Title Block Extensions for Magazines

All standard title block selectors can be used in a magazine title block.

.title-block-rw h1

The title of the article. This element is mandatory.

.title-block-rw .title-sub-rw

Sub-titles can sometimes be used but must not be confused with abstract

.title-block-rw .title-abstract-rw

A descriptive overview of the article of any length.

.title-block-rw .title-section-type-rw

Classification of whether the article is a column, feature, department or section. Various magazines use different vocabularies to describe this

.title-block-rw .title-section-name-rw

If an article is a member of a section/department, etc. this can be included here.

.title-block-rw .title-pub-nos-rw

The issue number of the articles parent publication.

.title-block-rw .title-pub-title-rw

The title of the articles parent publication.

.title-block-rw .title-pub-date-rw

The publishing date of the articles parent publication.

.title-block-rw .title-author-rw

The name of the author. If there are multiple authors this can repeat. If the author has qualification that can be added here. Eg: PhD.

.title-block-rw .title-author-info-rw

Any affiliation or biographical information. If there are multiple authors this can repeat paired with the .title-author-rw selector. A processor must understand an author-info-rw selector following a title-author-rw selector are related. Sequence matters.

.title-block-rw .title-other-rw

Other can be used if required, but it must not be used as a substitute for abstract.