FX 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.

F5: Section Title Blocks

.title-block-rw

Used for title-block in all sections. For processing purposes any section title-block is the first child title-block after a section opening element. 

 .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. 

 .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. 

.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.

SECTION GROUP TITLE BLOCKS    

Always the document section group selector with the title-bock for frontmatter, backmatter and Specials, or use 

.frontmatter-rw .title-block-rw

.backmatter-rw .title-block-rw

.specials-rw .title-block-rw

.Part-rw .title-block-rw

.Unit-rw .title-block-rw

Section Title Blocks  

FX always uses the explicit section selector with a title-block in the body. The first occurence of a title-block-rw in a Section is the processor title for the target block.

.Article-rw .title-block-rw

.Chapter-rw .title-block-rw

.Lesson-rw .title-block-rw

.Section-rw .title-block-rw

.Topic-rw .title-block-rw

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 be updated.

 .title-num-section-rw

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

.title-title-alt-rw

.title-sub-alt-rw

.title-author alt-rw

.title-contributor-alt-rw

.title-other-alt-rw