User Tools

Site Tools


design:finalizer

This is an old revision of the document!


List of things that a v3 finalizer will need to do

  • Replace or remove all deprecated features. Generate warnings or errors as needed.
  • After replacing, ensure full compliance to v3 schema
    • Elements that are deprecated cause error
    • Attributes that are deprecated cause error
  • Process x:include's
  • Fill in document date and expires date, if applicable
  • Remove current boilerplate text
  • Fill in any default values for non-deprecated attributes on non-deprecated elements, except t/@keepWith* and section/@toc
  • If the <workgroup> item doesn't end with Group, add (Working|Research) Group to the end
  • After removing, fill in boilerplate text with current values
  • Add slugifiedName to each <name> that does not contain a valid one (only valid HTML id's)
  • Remove any existing pn attributes
  • Add pn attributes for all parts. Parts are:
    • section: pn='s-1.4.2'
      • except <abstract>, which gets pn='s-abstract'
      • except <note>, which gets pn='s-note-[counter]'
    • table: pn='t-3'
    • figure: pn='f-4'
    • (abstract, note, t, aside, blockquote, li, dt, artwork, sourcecode, references): pn='p-[section]-[counter]'
  • Resolve all <xref> elements
    • Ensure the target is valid
    • Invent text for each element that doesn't have it
  • Process <artwork>
    • if type='svg'
      • If src attribute, inline and remove src, insert xml:base
      • Check SVG schema against our TinySVG profile
    • else if src != data:, turn into data:, insert xml:base
  • Remove comments
  • Pretty-format the XML output. Note: Dentin now does an adequate job.
    • This step might be controversial
design/finalizer.1429989537.txt.gz · Last modified: 2015/04/25 12:18 by jhildebr