htmlgen

Do yourself a favor and import the module as from htmlgen import nil and then fully qualify the macros.

Note: The Karax project (nimble install karax) has a better way to achieve the same, see https://github.com/pragmagic/karax/blob/master/tests/nativehtmlgen.nim for an example.

This module implements a simple XML and HTML code generator. Each commonly used HTML tag has a corresponding macro that generates a string with its HTML representation.

MathML

MathML is supported, MathML is part of HTML5. MathML is an Standard ISO/IEC 40314 from year 2015. MathML allows you to draw advanced math on the web, visually similar to Latex math.

Examples

var nim = "Nim"
echo h1(a(href="https://nim-lang.org", nim))

Writes the string:

<h1><a href="https://nim-lang.org">Nim</a></h1>

Example:

let nim = "Nim"
assert h1(a(href = "https://nim-lang.org", nim)) ==
  """<h1><a href="https://nim-lang.org">Nim</a></h1>"""
assert form(action = "test", `accept-charset` = "Content-Type") ==
  """<form action="test" accept-charset="Content-Type"></form>"""


assert math(
  semantics(
    mrow(
      msup(
        mi("x"),
        mn("42")
      )
    )
  )
) == "<math><semantics><mrow><msup><mi>x</mi><mn>42</mn></msup></mrow></semantics></math>"

assert math(
  semantics(
    annotation(encoding = "application/x-tex", title = "Latex on Web", r"x^{2} + y")
  )
) == """<math><semantics><annotation encoding="application/x-tex" title="Latex on Web">x^{2} + y</annotation></semantics></math>"""

Consts

coreAttr = " accesskey class contenteditable dir hidden id lang spellcheck style tabindex title translate "
HTML DOM Core Attributes   Source Edit
eventAttr = "onabort onblur oncancel oncanplay oncanplaythrough onchange onclick oncuechange ondblclick ondurationchange onemptied onended onerror onfocus oninput oninvalid onkeydown onkeypress onkeyup onload onloadeddata onloadedmetadata onloadstart onmousedown onmouseenter onmouseleave onmousemove onmouseout onmouseover onmouseup onmousewheel onpause onplay onplaying onprogress onratechange onreset onresize onscroll onseeked onseeking onselect onshow onstalled onsubmit onsuspend ontimeupdate ontoggle onvolumechange onwaiting "
HTML DOM Event Attributes   Source Edit
ariaAttr = " role "
HTML DOM Aria Attributes   Source Edit
commonAttr = " accesskey class contenteditable dir hidden id lang spellcheck style tabindex title translate onabort onblur oncancel oncanplay oncanplaythrough onchange onclick oncuechange ondblclick ondurationchange onemptied onended onerror onfocus oninput oninvalid onkeydown onkeypress onkeyup onload onloadeddata onloadedmetadata onloadstart onmousedown onmouseenter onmouseleave onmousemove onmouseout onmouseover onmouseup onmousewheel onpause onplay onplaying onprogress onratechange onreset onresize onscroll onseeked onseeking onselect onshow onstalled onsubmit onsuspend ontimeupdate ontoggle onvolumechange onwaiting  role "
HTML DOM Common Attributes   Source Edit

Procs

proc xmlCheckedTag(argsList: NimNode; tag: string; optAttr = ""; reqAttr = "";
                   isLeaf = false): NimNode {...}{.compileTime, raises: [], tags: [].}
use this procedure to define a new XML tag   Source Edit

Macros

macro a(e: varargs[untyped]): untyped
Generates the HTML a element.   Source Edit
macro abbr(e: varargs[untyped]): untyped
Generates the HTML abbr element.   Source Edit
macro address(e: varargs[untyped]): untyped
Generates the HTML address element.   Source Edit
macro area(e: varargs[untyped]): untyped
Generates the HTML area element.   Source Edit
macro article(e: varargs[untyped]): untyped
Generates the HTML article element.   Source Edit
macro aside(e: varargs[untyped]): untyped
Generates the HTML aside element.   Source Edit
macro audio(e: varargs[untyped]): untyped
Generates the HTML audio element.   Source Edit
macro b(e: varargs[untyped]): untyped
Generates the HTML b element.   Source Edit
macro base(e: varargs[untyped]): untyped
Generates the HTML base element.   Source Edit
macro bdi(e: varargs[untyped]): untyped
Generates the HTML bdi element.   Source Edit
macro bdo(e: varargs[untyped]): untyped
Generates the HTML bdo element.   Source Edit
macro big(e: varargs[untyped]): untyped
Generates the HTML big element.   Source Edit
macro blockquote(e: varargs[untyped]): untyped
Generates the HTML blockquote element.   Source Edit
macro body(e: varargs[untyped]): untyped
Generates the HTML body element.   Source Edit
macro br(e: varargs[untyped]): untyped
Generates the HTML br element.   Source Edit
macro button(e: varargs[untyped]): untyped
Generates the HTML button element.   Source Edit
macro canvas(e: varargs[untyped]): untyped
Generates the HTML canvas element.   Source Edit
macro caption(e: varargs[untyped]): untyped
Generates the HTML caption element.   Source Edit
macro center(e: varargs[untyped]): untyped
Generates the HTML center element.   Source Edit
macro cite(e: varargs[untyped]): untyped
Generates the HTML cite element.   Source Edit
macro code(e: varargs[untyped]): untyped
Generates the HTML code element.   Source Edit
macro col(e: varargs[untyped]): untyped
Generates the HTML col element.   Source Edit
macro colgroup(e: varargs[untyped]): untyped
Generates the HTML colgroup element.   Source Edit
macro data(e: varargs[untyped]): untyped
Generates the HTML data element.   Source Edit
macro datalist(e: varargs[untyped]): untyped
Generates the HTML datalist element.   Source Edit
macro dd(e: varargs[untyped]): untyped
Generates the HTML dd element.   Source Edit
macro del(e: varargs[untyped]): untyped
Generates the HTML del element.   Source Edit
macro details(e: varargs[untyped]): untyped
Generates the HTML details element.   Source Edit
macro dfn(e: varargs[untyped]): untyped
Generates the HTML dfn element.   Source Edit
macro dialog(e: varargs[untyped]): untyped
Generates the HTML dialog element.   Source Edit
macro `div`(e: varargs[untyped]): untyped
Generates the HTML div element.   Source Edit
macro dl(e: varargs[untyped]): untyped
Generates the HTML dl element.   Source Edit
macro dt(e: varargs[untyped]): untyped
Generates the HTML dt element.   Source Edit
macro em(e: varargs[untyped]): untyped
Generates the HTML em element.   Source Edit
macro embed(e: varargs[untyped]): untyped
Generates the HTML embed element.   Source Edit
macro fieldset(e: varargs[untyped]): untyped
Generates the HTML fieldset element.   Source Edit
macro figure(e: varargs[untyped]): untyped
Generates the HTML figure element.   Source Edit
macro figcaption(e: varargs[untyped]): untyped
Generates the HTML figcaption element.   Source Edit
macro footer(e: varargs[untyped]): untyped
Generates the HTML footer element.   Source Edit
macro form(e: varargs[untyped]): untyped
Generates the HTML form element.   Source Edit
macro h1(e: varargs[untyped]): untyped
Generates the HTML h1 element.   Source Edit
macro h2(e: varargs[untyped]): untyped
Generates the HTML h2 element.   Source Edit
macro h3(e: varargs[untyped]): untyped
Generates the HTML h3 element.   Source Edit
macro h4(e: varargs[untyped]): untyped
Generates the HTML h4 element.   Source Edit
macro h5(e: varargs[untyped]): untyped
Generates the HTML h5 element.   Source Edit
macro h6(e: varargs[untyped]): untyped
Generates the HTML h6 element.   Source Edit
macro head(e: varargs[untyped]): untyped
Generates the HTML head element.   Source Edit
macro header(e: varargs[untyped]): untyped
Generates the HTML header element.   Source Edit
macro html(e: varargs[untyped]): untyped
Generates the HTML html element.   Source Edit
macro hr(): untyped
Generates the HTML hr element.   Source Edit
macro i(e: varargs[untyped]): untyped
Generates the HTML i element.   Source Edit
macro iframe(e: varargs[untyped]): untyped
Generates the HTML iframe element.   Source Edit
macro img(e: varargs[untyped]): untyped
Generates the HTML img element.   Source Edit
macro input(e: varargs[untyped]): untyped
Generates the HTML input element.   Source Edit
macro ins(e: varargs[untyped]): untyped
Generates the HTML ins element.   Source Edit
macro kbd(e: varargs[untyped]): untyped
Generates the HTML kbd element.   Source Edit
macro keygen(e: varargs[untyped]): untyped
Generates the HTML keygen element.   Source Edit
macro label(e: varargs[untyped]): untyped
Generates the HTML label element.   Source Edit
macro legend(e: varargs[untyped]): untyped
Generates the HTML legend element.   Source Edit
macro li(e: varargs[untyped]): untyped
Generates the HTML li element.   Source Edit
macro link(e: varargs[untyped]): untyped
Generates the HTML link element.   Source Edit
macro main(e: varargs[untyped]): untyped
Generates the HTML main element.   Source Edit
macro map(e: varargs[untyped]): untyped
Generates the HTML map element.   Source Edit
macro mark(e: varargs[untyped]): untyped
Generates the HTML mark element.   Source Edit
macro marquee(e: varargs[untyped]): untyped
Generates the HTML marquee element.   Source Edit
macro meta(e: varargs[untyped]): untyped
Generates the HTML meta element.   Source Edit
macro meter(e: varargs[untyped]): untyped
Generates the HTML meter element.   Source Edit
macro nav(e: varargs[untyped]): untyped
Generates the HTML nav element.   Source Edit
macro noscript(e: varargs[untyped]): untyped
Generates the HTML noscript element.   Source Edit
macro `object`(e: varargs[untyped]): untyped
Generates the HTML object element.   Source Edit
macro ol(e: varargs[untyped]): untyped
Generates the HTML ol element.   Source Edit
macro optgroup(e: varargs[untyped]): untyped
Generates the HTML optgroup element.   Source Edit
macro option(e: varargs[untyped]): untyped
Generates the HTML option element.   Source Edit
macro output(e: varargs[untyped]): untyped
Generates the HTML output element.   Source Edit
macro p(e: varargs[untyped]): untyped
Generates the HTML p element.   Source Edit
macro param(e: varargs[untyped]): untyped
Generates the HTML param element.   Source Edit
macro picture(e: varargs[untyped]): untyped
Generates the HTML picture element.   Source Edit
macro pre(e: varargs[untyped]): untyped
Generates the HTML pre element.   Source Edit
macro progress(e: varargs[untyped]): untyped
Generates the HTML progress element.   Source Edit
macro q(e: varargs[untyped]): untyped
Generates the HTML q element.   Source Edit
macro rb(e: varargs[untyped]): untyped
Generates the HTML rb element.   Source Edit
macro rp(e: varargs[untyped]): untyped
Generates the HTML rp element.   Source Edit
macro rt(e: varargs[untyped]): untyped
Generates the HTML rt element.   Source Edit
macro rtc(e: varargs[untyped]): untyped
Generates the HTML rtc element.   Source Edit
macro ruby(e: varargs[untyped]): untyped
Generates the HTML ruby element.   Source Edit
macro s(e: varargs[untyped]): untyped
Generates the HTML s element.   Source Edit
macro samp(e: varargs[untyped]): untyped
Generates the HTML samp element.   Source Edit
macro script(e: varargs[untyped]): untyped
Generates the HTML script element.   Source Edit
macro section(e: varargs[untyped]): untyped
Generates the HTML section element.   Source Edit
macro select(e: varargs[untyped]): untyped
Generates the HTML select element.   Source Edit
macro slot(e: varargs[untyped]): untyped
Generates the HTML slot element.   Source Edit
macro small(e: varargs[untyped]): untyped
Generates the HTML small element.   Source Edit
macro source(e: varargs[untyped]): untyped
Generates the HTML source element.   Source Edit
macro span(e: varargs[untyped]): untyped
Generates the HTML span element.   Source Edit
macro strong(e: varargs[untyped]): untyped
Generates the HTML strong element.   Source Edit
macro style(e: varargs[untyped]): untyped
Generates the HTML style element.   Source Edit
macro sub(e: varargs[untyped]): untyped
Generates the HTML sub element.   Source Edit
macro summary(e: varargs[untyped]): untyped
Generates the HTML summary element.   Source Edit
macro sup(e: varargs[untyped]): untyped
Generates the HTML sup element.   Source Edit
macro table(e: varargs[untyped]): untyped
Generates the HTML table element.   Source Edit
macro tbody(e: varargs[untyped]): untyped
Generates the HTML tbody element.   Source Edit
macro td(e: varargs[untyped]): untyped
Generates the HTML td element.   Source Edit
macro `template`(e: varargs[untyped]): untyped
Generates the HTML template element.   Source Edit
macro textarea(e: varargs[untyped]): untyped
Generates the HTML textarea element.   Source Edit
macro tfoot(e: varargs[untyped]): untyped
Generates the HTML tfoot element.   Source Edit
macro th(e: varargs[untyped]): untyped
Generates the HTML th element.   Source Edit
macro thead(e: varargs[untyped]): untyped
Generates the HTML thead element.   Source Edit
macro time(e: varargs[untyped]): untyped
Generates the HTML time element.   Source Edit
macro title(e: varargs[untyped]): untyped
Generates the HTML title element.   Source Edit
macro tr(e: varargs[untyped]): untyped
Generates the HTML tr element.   Source Edit
macro track(e: varargs[untyped]): untyped
Generates the HTML track element.   Source Edit
macro tt(e: varargs[untyped]): untyped
Generates the HTML tt element.   Source Edit
macro u(e: varargs[untyped]): untyped
Generates the HTML u element.   Source Edit
macro ul(e: varargs[untyped]): untyped
Generates the HTML ul element.   Source Edit
macro `var`(e: varargs[untyped]): untyped
Generates the HTML var element.   Source Edit
macro video(e: varargs[untyped]): untyped
Generates the HTML video element.   Source Edit
macro wbr(e: varargs[untyped]): untyped
Generates the HTML wbr element.   Source Edit
macro math(e: varargs[untyped]): untyped
Generates the HTML math element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/math#Examples   Source Edit
macro maction(e: varargs[untyped]): untyped
Generates the HTML maction element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/maction   Source Edit
macro menclose(e: varargs[untyped]): untyped
Generates the HTML menclose element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/menclose   Source Edit
macro merror(e: varargs[untyped]): untyped
Generates the HTML merror element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/merror   Source Edit
macro mfenced(e: varargs[untyped]): untyped
Generates the HTML mfenced element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mfenced   Source Edit
macro mfrac(e: varargs[untyped]): untyped
Generates the HTML mfrac element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mfrac   Source Edit
macro mglyph(e: varargs[untyped]): untyped
Generates the HTML mglyph element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mglyph   Source Edit
macro mi(e: varargs[untyped]): untyped
Generates the HTML mi element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mi   Source Edit
macro mlabeledtr(e: varargs[untyped]): untyped
Generates the HTML mlabeledtr element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mlabeledtr   Source Edit
macro mmultiscripts(e: varargs[untyped]): untyped
Generates the HTML mmultiscripts element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mmultiscripts   Source Edit
macro mn(e: varargs[untyped]): untyped
Generates the HTML mn element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mn   Source Edit
macro mo(e: varargs[untyped]): untyped
Generates the HTML mo element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mo   Source Edit
macro mover(e: varargs[untyped]): untyped
Generates the HTML mover element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mover   Source Edit
macro mpadded(e: varargs[untyped]): untyped
Generates the HTML mpadded element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mpadded   Source Edit
macro mphantom(e: varargs[untyped]): untyped
Generates the HTML mphantom element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mphantom   Source Edit
macro mroot(e: varargs[untyped]): untyped
Generates the HTML mroot element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mroot   Source Edit
macro mrow(e: varargs[untyped]): untyped
Generates the HTML mrow element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mrow   Source Edit
macro ms(e: varargs[untyped]): untyped
Generates the HTML ms element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/ms   Source Edit
macro mspace(e: varargs[untyped]): untyped
Generates the HTML mspace element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mspace   Source Edit
macro msqrt(e: varargs[untyped]): untyped
Generates the HTML msqrt element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/msqrt   Source Edit
macro mstyle(e: varargs[untyped]): untyped
Generates the HTML mstyle element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mstyle   Source Edit
macro msub(e: varargs[untyped]): untyped
Generates the HTML msub element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/msub   Source Edit
macro msubsup(e: varargs[untyped]): untyped
Generates the HTML msubsup element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/msubsup   Source Edit
macro msup(e: varargs[untyped]): untyped
Generates the HTML msup element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/msup   Source Edit
macro mtable(e: varargs[untyped]): untyped
Generates the HTML mtable element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mtable   Source Edit
macro mtd(e: varargs[untyped]): untyped
Generates the HTML mtd element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mtd   Source Edit
macro mtext(e: varargs[untyped]): untyped
Generates the HTML mtext element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/mtext   Source Edit
macro munder(e: varargs[untyped]): untyped
Generates the HTML munder element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/munder   Source Edit
macro munderover(e: varargs[untyped]): untyped
Generates the HTML munderover element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/munderover   Source Edit
macro semantics(e: varargs[untyped]): untyped
Generates the HTML semantics element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/semantics   Source Edit
macro annotation(e: varargs[untyped]): untyped
Generates the HTML annotation element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/semantics   Source Edit
macro annotation-xml(e: varargs[untyped]): untyped
Generates the HTML annotation-xml element. MathML https://wikipedia.org/wiki/MathML https://developer.mozilla.org/en-US/docs/Web/MathML/Element/semantics   Source Edit