A toki pona spellchecker and transliteration library.

See the documentation.

Features

penpo provides

• spellchecking and warnings for obscure words,
• automatic transliteration to sitelen pona (available), and other alphabets (wip),
• the ability to write text once and have it rendered in different writing systems,
• a uniform interface for punctuation symbols across alphabets.

Prerequisites

• the sitelen pona font “sitelen seli kiwen” is required, and must be downloaded manually. See an example usage in sama-ni/.

Example

The code below can be rendered in either sitelen Lasina or sitelen pona from the same markup, simply by applying a #show rule on penpo.pona.sitelen or #penpo.lasina.sitelen.

// File: toki.typ
#import "@preview/penpo:0.1.0"

#show link: set text(fill: blue.darken(20%))
#set figure(numbering: none)

// Show the error log and silence some rarity warnings
#penpo.pakala.open()
#penpo.o-oke-e-nimi("penpo", "namako", "soko", "n", "jasima", "majuna", "lanpan", "oko")

// Define transliterations of names
#penpo.nimi-ijo((Newen: "namako en weka en namako"), lili: "namako namako")
#penpo.nimi-ijo((Lasina: "linja ale sona insa ni a"), lili: "linja sona")

// Adjust punctuation style
#penpo.o-ante-e-sitelen-lili("la", (
  ".": [~#sym.dot],
  "!": [~!],
  ":": [~:],
))
#penpo.o-ante-e-sitelen-lili("sp", (
  ".": h(1cm),
  ",": h(1mm),
))

toki a!
mi jan Newen.

// `penpo.only` renders only in the corresponding writing system.
mi pali e lipu ni kepeken
#penpo.only("sp")[sitelen pona]#penpo.only("la")[sitelen Lasina]
tan ni: /sp/
mi wile pana e sona pi kepeken penpo tawa jan mute.

#penpo.nimi-ijo((Inli: "insa n li ijo"), lili: none)
#penpo.nimi-ijo((Masi: "mun alasa sinpin ijo"), lili: 1)
#penpo.nimi-ijo((Wikipesija: "wile ilo kon ilo pona esun sona ilo jan ale"), lili: 1)
#penpo.nimi-ijo(
  lili: none, (
    Sola: "suno o lukin ala",
    Mekuliju: "majuna e kule uta li insa jasima uta",
    Tela: "toki e lon ala",
    Olinpu: "o lukin insa nena pona unpa",
    Mon: "ma open nena",
    Mewika: "moku esun weka ilo kalama awen",
    Elopa: "esun lawa olin pona awen",
    Losi: "lanpan oko sewi insa",
    Nijon: "nasin ijo jan olin n",
    Loma: "lawa olin mi awen",
    Imalasi: "insa ma ala lon akesi suno ilo",
    Sonko: "soko open ni kiwen o",
    Insanjuwisi: "ilo nasin sona awen nena jo uta wile ilo sona ilo",
    Popo: "pi o pi o",
    Temo: "tawa e mi o",
  )
)

// All standard Typst elements are transliterated
== mun Masi

toki ni li tan #link("https://wikipesija.org/wiki/mun_Masi")[lipu Wikipesija]

#table(columns: (60%, 40%), stroke: none)[
  #set par(justify: true)
  suno mi la, mun Masi (toki Inli: "#penpo.esc[Mars]") /sp/
  li mun nanpa tu tu lon weka suno Sola. /sp/
  ona li lili nanpa tu. mun Masi la mun Mekuliju taso li lili. /sp/
  ma Tela la, ona li lili. ma pi mun Masi li jo e kiwen mute. /sp/
  ona li lete li jo e kon lili. /sp/
  ona li loje lukin la, nimi ante ona li "mun loje". /sp/
  telo li lon ala ma Masi. taso, kiwen telo lete li lon. /sp/
  ona li jo e nena ma suli. /sp/
  nena ma Olinpu Mon li nena ma nanpa wan lon /sp/
  ma Masi lon kulupu mun suno. /sp/
  nimi pi mun Masi li sama e jan sewi tan nasin sewi Loma. /sp/
  jan sewi ni li jan sewi utala. /sp/

  jan li tawa mun Masi ala. taso, ilo mun mute li tawa mun Masi. /sp/
  ma Mewika en ma Elopa /sp/
  en ma Losi en ma Nijon /sp/
  en ma Imalasi en ma Sonko /sp/
  li tawa e ilo tawa mun Masi. /sp/
  ilo li awen lon selo. ilo ante li ken tawa lon selo. /sp/
  ilo Insanjuwisi /sp/
  (toki Inli: "#penpo.esc[Ingenuity]") li ken tawa lon kon. /sp/
  ilo ante li tawa sike e mun Masi li pali e sitelen pi selo ona. /sp/

  mun lili tu li sike e mun Masi. /sp/
  nimi ona li mun Popo li mun Temo. /sp/
  ona li kiwen li sike lukin ala. /sp/
][
  #figure(
    {
      // Placeholder
      box(width: 5cm, height: 5cm, fill: black)[
        #place(center + horizon)[
          #circle(fill: rgb("bf4d21"), radius: 2cm)
        ]
      ]
      // Or download:
      // "https://wikipesija.org/wiki/sitelen:OSIRIS_Mars_true_color.jpg"
      /*
      image("assets/mun-Masi.jpg")
      */
    },
    caption: "sitelen pi mun Masi",
  )
  #figure(
    {
      // Placeholder
      box(width: 6cm, height: 4cm, fill: black)[
        #place(left + horizon, dx: 5mm)[
          #circle(fill: rgb("a6654c"), radius: 1.3cm)
        ]
        #place(right + horizon, dx: -5mm)[
          #circle(fill: rgb("b8701f"), radius: 0.8cm)
        ]
      ]
      // Or download:
      // https://wikipesija.org/wiki/sitelen:Phobos_and_Deimos.jpg
      /*
      image("assets/mun-Popo-en-Temo.jpg")
      */
    },
    caption: "sitelen pi mun Popo en mun Temo",
  )
]

// File: main-sl.typ
#import "@preview/penpo:0.1.0"

#show: penpo.lasina.sitelen

#include "toki.typ"

// File: main-sp.typ
#import "@preview/penpo:0.1.0"

// Requires https://www.kreativekorp.com/software/fonts/sitelenselikiwen
// downloaded to /fonts/sitelenselikiwenasuki.ttf
#show: penpo.pona.sitelen

#include "toki.typ"