Skip to content

treeform/taggy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Taggy - Everything to do with HTML and XML.

⚠️ This library is still in development and is NOT ready to be used. ⚠️

Both the native C backend and the JS backend is supported. Use this library both server side and client side.

nimble install taggy

Github Actions

API reference

This library has no dependencies other than the Nim standard library.

  • HTML Parser/Serializer
  • XML Parser/Serializer
  • Static HTML Generator
  • Static CSS Generator

HTML Parser

let divElement = parseHtml("<div class='foo'><span><img src='img.png'></span></div>")
echo divElement.attributes["class"]
echo divElement[0][0].attributes["src"]
foo
img.png

HTML Serializer

let divElement = newElement("div")
divElement.attributes["class"] = "foo"
let spanElement = newElement("span")
let imgElement = newElement("img")
imgElement.attributes["src"] = "img.png"
spanElement.add(imgElement)
divElement.add(spanElement)
echo $divElement
<div class="foo"><span><img src="img.png"></span></div>

XML Parser

let xmlNode = parseXml("""<tag id="123" bar="the thing"><foo>here</foo><foo2></foo2></tag>""")
echo xmlNode.attributes["id"]
echo xmlNode.attributes["bar"]
echo xmlNode[0].tagName
echo xmlNode[0][0].content
echo xmlNode[1].tagName
123
the thing
foo
here
foo2

XML Serializer

let xmlNode = newElement("tag")
xmlNode.attributes["id"] = "123"
xmlNode.attributes["bar"] = "the thing"
let fooNode = newElement("foo")
let text = Element()
text.content = "here"
fooNode.add(text)
xmlNode.add(fooNode)
let foo2Node = newElement("foo2")
xmlNode.add(foo2Node)
echo $xmlNode
<tag id="123" bar="the thing"><foo>here</foo><foo2></foo2></tag>

Static HTML Generator

x = render:
  html:
    head:
      title:
        say "simple page"
      styleSheet:
        css "body":
          backgroundColor "black"
          color "white"
    body:
      h1:
        say "This is a simple page"
      p:
        say "Taggly allows server and client site html generation"
echo x

Note some things are reserved words in nim such as div or method those have a t appended to them becomeing tdiv or tmethod.

Static CSS Generator

styleSheet:
  css "body":
    backgroundColor PureBlack
    fontFamily "IBM Plex Sans"
    fontStyle "normal"
    fontWeight 400
    fontSize 18
    lineHeight 23
    color PureWhite

  css "button.selected, .button.selected":
    backgroundColor "rgba(59, 0, 96, 1)"

You can use the regular "10em" or "100%" and "10px" but you can also omit the "px" and use the number 10 which means "10px" by default.

While making any HTML node you can generate inline style with the style keyword:

a:
  href "/manual.html"
  target "_blank"
  img ".help":
    style:
      position "absolute"
      right 6
      bottom 8
    src "/data/images/help.png"

HTML parser and pretty printer

let htmlNode = parseHtml("<div><span><img src='img.png'></span></div>")
echo $htmlNode

XML parser and pretty printer

let xmlNode = $parseXml("<tag id="123" bar="the thing"><foo>here</foo><foo2></foo2></tag>")
echo $xmlNode