Core functions:

• transcribe(*tokens): a generator yielding strings comprising HTML

• xtranscribe(*tokens): a generator yielding strings comprising XHTML

• attrquote(s): quote the string s for use as a tag attribute according to HTML 4.01 section 3.2.2

• nbsp(s): convert s to nonbreaking text: generator yielding tokens with whitespace converted to   entities

Convenience routines:

• transcribe_s(*tokens): convert tokens into a string containing HTML

• xtranscribe_s(*tokens): convert tokens into a string containing XHTML

Obsolete:

• tok2s: transcribe tokens to a string; trivial wrapper for puttok

• puttok: transcribe tokens to a file

• text2s: transcribe a string to an HTML-safe string; trivial wrapper for puttext

• puttext: transcribe a string as HTML-safe text to a file

Example:

from cs.html import transcribe, transcribe_s, xtranscribe, puttok
[...]
table = ['TABLE', {'width': '80%'},
         ['TR',
          ['TD', 'a truism'],
          ['TD', '1 < 2']
         ]
         ['TR',
          ['TD', 'a couple'],
          ['TD', 'A & B']
         ]
        ]
prose_with_table = [
          'Here is a line with a line break.', ['BR'],
          'Here is a trite table:',
          table,
        ]
[...]
print('Here is the table's HTML:', transcribe_s(table))
[...]
# write HTML tokens to a file
for s in transcribe(['H1', {'align': 'left'}, 'Prose'], *prose_with_table):
  fp.write(s)
[...]
# write XHTML tokens to a file
for s in xtranscribe(*prose_with_table):
  fp.write(s)