Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stscoundrel/riimut-nim

Transform latin letters to runes & vice versa. Nim version.
https://github.com/stscoundrel/riimut-nim

futhark futhark-runes futhorc futhorc-runes futhork nim runes staveless-runes

Last synced: 1 day ago
JSON representation

Transform latin letters to runes & vice versa. Nim version.

Awesome Lists containing this project

README

        

# Riimut

Transform latin letters to runes & vice versa. Nim version.

Includes transformers for four main runic alphabets and some variants:

- Elder Futhark
- Younger Futhark
- Medieval Futhork
- Futhorc (Anglo-Frisian runes)
- Staveless Futhark

## Install

`nimble install https://github.com/stscoundrel/riimut-nim`

## Usage

Text to runes:
```nim
# Ships four runic dialects under riimut module.
import riimut

# From Old Groms runestone.
const content = "auk tani karþi kristna"
let youngerFuthark = riimut.youngerfuthark.lettersToRunes(content)
echo youngerFuthark) # ᛅᚢᚴ:ᛏᛅᚾᛁ:ᚴᛅᚱᚦᛁ:ᚴᚱᛁᛋᛏᚾᛅ

# From 4th century axe in Jutland
const content = "wagagastiz alu wihgu sikijaz aiþalataz"
let elderFuthark = riimut.elderfuthark.lettersToRunes(content)
echo elderFuthark # ᚹᚨᚷᚨᚷᚨᛋᛏᛁᛉ:ᚨᛚᚢ:ᚹᛁᚻᚷᚢ:ᛋᛁᚲᛁᛃᚨᛉ:ᚨᛁᚦᚨᛚᚨᛏᚨᛉ

# From Lord's Prayer, in Old Norse.
const content = "Faðer uor som ast i himlüm, halgað warðe þit nama"
let medievalFuthork = riimut.medievalfuthork.lettersToRunes(content)
echo medievalFuthork # ᚠᛆᚦᚽᚱ:ᚢᚮᚱ:ᛋᚮᛘ:ᛆᛋᛏ:ᛁ:ᚼᛁᛘᛚᚢᛘ,:ᚼᛆᛚᚵᛆᚦ:ᚠᛆᚱᚦᚽ:ᚦᛁᛏ:ᚿᛆᛘᛆ

# From 8th century Franks Casket, in late West Saxon.
const content = "fisc.flodu.ahofonferg | enberig |"
let futhorc = riimut.futhorc.lettersToRunes(content)
echo futhorc # ᚠᛁᛋᚳ.ᚠᛚᚩᛞᚢ.ᚪᚻᚩᚠᚩᚾᚠᛖᚱᚷ:|:ᛖᚾᛒᛖᚱᛁᚷ:|

# From Old Norse text in Hög runestone.
const content = "kuþniutr þru sun lit rita stin þina ak bru kirþi aftiʀ bruþr sina asbiurn ak at kuþlaf"
let staveless = riimut.stavelessfuthark.lettersToRunes(content)
echo staveless # ᛍ╮ו⸜ᛁ╮⸍◟:ו◟╮:╵╮⸜:⸌ᛁ⸍:◟ᛁ⸍⸝:╵⸍ᛁ⸜:וᛁ⸜⸝:⸝ᛍ:ˏ◟╮:ᛍᛁ◟וᛁ:⸝ᛙ⸍ᛁʀ:ˏ◟╮ו◟:╵ᛁ⸜⸝:⸝╵ˏᛁ╮◟⸜:⸝ᛍ:⸝⸍:ᛍ╮ו⸌⸝ᛙ
```

Runes to text:
```nim

# All four dialects contain runesToLetters method.
import riimut

const runicText = "ᛅᚢᚴ:ᛏᛅᚾᛁ:ᚴᛅᚱᚦᛁ:ᚴᚱᛁᛋᛏᚾᛅ"
let latinText = riimut.youngerfuthark.runesToLetters(runicText)

echo latinText # "auk tani karþi kristna"

```

Rune variants in Younger Futhark:

Younger Futhark comes with long branch (Danish) and short twig (Norwegian & Swedish) variants.
```nim
import riimut

const letters = "aábcdðeéfghiíjklmnoópqrstþuúvwxyýzåäæöøǫþ"

# Comes with named functions per style.
let longBranch = youngerfuthark.lettersToLongBranchRunes(letters)
let shortTwig = youngerfuthark.lettersToShortTwigRunes(letters)

echo longBranch # ᛅᛅᛒᛋᛏᚦᛁᛁᚠᚴᚼᛁᛁᛁᚴᛚᛘᚾᚢᚢᛒᚴᚱᛋᛏᚦᚢᚢᚢᚢᛋᚢᚢᛋᚢᛅᛅᚢᚢᚢᚦ
echo shortTwig # ᛆᛆᛒᛌᛐᚦᛁᛁᚠᚴᚽᛁᛁᛁᚴᛚᛘᚿᚢᚢᛒᚴᚱᛌᛐᚦᚢᚢᚢᚢᛌᚢᚢᛌᚢᛆᛆᚢᚢᚢᚦ

# Default function can also be called with variant enum to define the runeset.
let longBranchResult = youngerfuthark.lettersToRunes(letters, youngerfuthark.RuneVariant.longBranch)
let shortTwigResult = youngerfuthark.lettersToRunes(letters, youngerfuthark.RuneVariant.shortTwig)

```

#### What's in the name?

"Riimut" is the Finnish word for "runes".