nimforum mirror - Nimib v0.4.0

hugogranstrom (orginal) [2026-05-29T14:10:28+02:00] view original

After along slumber, Nimib is back with another update. For the average user who only use the builtin blocks (NbText, nbCode, nbImage etc) this doesn't bring any changes to your documents (fingers crossed!). But behind the scenes we have rebuilt Nimib's blocks and rendering from the ground up.

I will be hosting a talk about this update on NimConf 2026 for those that are interested.

The highlights are:

We have replaced mustache templates with normal Nim functions so you can use whatever you are most familiar with instead. For example ordinary string interpolation.

Each Nimib block is now its own subtype of the base type NbBlock and we have added a newNbBlock macro to ease the definition of new blocks. For example here is how to define nbImage where you specify the fields it should have and how to render it to HTML:


newNbBlock(NbImage):
  url: string
  caption: string
  alt: string
  toHtml:
    &"""
<figure>
  <img src="{blk.url}" alt="{blk.alt}">
  <figcaption>{blk.caption}</figcaption>
</figure>
"""

template image*(url: string, caption = "", alt = "") =
  let blk = newNbImage()
  blk.url = nb.doc.relToRoot(url)
  blk.caption = caption
  blk.alt = if alt.len == 0: caption else: alt
  nb.add blk

You can now both serialize and deserialize a nimib document to JSON. This should allow caching of documents in the case of for example static site generators.

This does mean that if you have defined a custom block with custom rendering, it will have to be rewritten using the new structures. For more details and a migration example see the release notes: https://github.com/pietroppeter/nimib/releases/tag/v0.4.0

Mirror of forum.nim-lang.org

13944 :: Nimib v0.4.0