"
)
except ET.ParseError as exc:
raise ValueError("Markdown contains malformed raw HTML; use Markdown or valid XHTML.") from exc
# Content edits belong in Markdown, never silently in a generated version.
for node in document.iter():
for attribute in ("text", "tail"):
value = getattr(node, attribute)
if value and ("\u2014" in value or "\u2013" in value):
raise ValueError("Replace long dashes in the source Markdown before generating the resume.")
nodes = list(document)
if not nodes or nodes[0].tag != "h1":
raise ValueError("Start the Markdown with a single # heading containing the name.")
name_node = nodes.pop(0)
name = "".join(name_node.itertext()).strip()
if not name or any(node.tag == "h1" for node in nodes):
raise ValueError("The resume must have exactly one nonempty # name heading.")
intro = []
while nodes and nodes[0].tag != "h2":
intro.append(nodes.pop(0))
if not nodes:
raise ValueError("Add resume sections using ## headings.")
subtitle = ""
if intro and intro[0].tag == "p" and intro[0].find("strong") is not None:
title = "".join(intro.pop(0).itertext())
primary, separator, secondary = title.partition("·")
subtitle = '
"
contact_links = []
for node in intro:
for parent in node.iter():
for child in list(parent):
if child.tag != "a":
continue
href = child.get("href", "")
label = ("Phone" if href.startswith("tel:") else
"Email" if href.startswith("mailto:") else
"Profile" if "linkedin.com/" in href else
"Code" if "github.com/" in href else "Website")
direct = ' class="direct"' if label in ("Phone", "Email") else ""
contact_links.append(
f''
f'{label}'
''
+ gradient_text("".join(child.itertext())) + ''
)
tail = (child.tail or "").strip(" ·|\n\t")
if tail:
position = list(parent).index(child)
if position:
previous = parent[position - 1]
previous.tail = (previous.tail or "") + tail
else:
parent.text = (parent.text or "") + tail
parent.remove(child)
for br in list(node):
if br.tag == "br" and not (br.tail or "").strip():
node.remove(br)
contact_details = "".join(serialize(node) for node in intro if "".join(node.itertext()).strip())
contact_grid = '' if contact_links else ""
header = (
"
" + serialize(name_node) + subtitle + '
'
+ '
' + escape(name) + "
"
+ contact_details + contact_grid + "
"
)
sections = []
for node in nodes:
if node.tag == "h2":
sections.append((node, []))
else:
sections[-1][1].append(node)
rendered = []
for heading, content in sections:
if not content:
raise ValueError(f"Section {''.join(heading.itertext())!r} has no content.")
for node in content:
# Dates follow role/project headings in the source Markdown.
if node.tag == "p" and len(node) == 1 and node[0].tag == "em" and not (node.text or "").strip() and not (node[0].tail or "").strip():
node.set("class", "dates")
# The reference lists each contact on its own line, rather than a grid.
if "".join(heading.itertext()).strip().lower() == "references":
for index, node in enumerate(content):
if node.tag != "table":
continue
rows = node.findall("./tbody/tr")
if not rows or any(len(row) != 4 for row in rows):
continue
listing = ET.Element("ul", {"class": "references"})
for row in rows:
item = ET.SubElement(listing, "li")
for column, cell in enumerate(row):
span = ET.SubElement(item, "strong" if column == 0 else "span")
span.text = cell.text
span.extend(deepcopy(list(cell)))
span.tail = " · " if column < 2 else (": " if column == 2 else "")
content[index] = listing
# Keep the label with the first content block when a section crosses pages.
start = '