hamnosys-includer:1.0.0 (#3068)

Author: TestTimothy

packages/preview/hamnosys-includer/1.0.0/LICENSE

@@ -0,0 +1,51 @@
+# HamNoSys (Hamburg Notation System)
+
+HamNoSys is a system for the phonetic transcription of signed languages. The HamNoSysUnicode font uses the Unicode Private Use Area for the HamNoSys symbols.
+
+The font (and the symbol names) are taken from the TeX package [_hamnosys_](https://ctan.org/pkg/hamnosys?lang=en), maintained by Thomas Hanke & Marc Schulder. You will first need to download the TeX package and find the HamNoSysUnicode font.
+
+If you're working locally, install the font (or pass its location to Typst with the `--font-path` argument). If you're using the [Typst web service](https://typst.app), you just need to include the font among your uploaded files. Without the font, this package is useless.
+
+Second, include the line
+
+```Typst
+#import "@preview/hamnosys-includer:1.0.0": ham, hamnosys, hamnosys-text
+```
+
+in your document.
+
+## Direct Entry
+
+You can enter the symbols directly into your Typst document. There's no way to actually type most of them, as they're mostly in the Unicode Private Use Area, but this is handy if you want to copy and paste from elsewhere. If you do this, you should wrap them in the `#hamnosys-text` function.
+
+This is demonstrated in [`README.pdf`](https://github.com/TestTimothy/Typst-HamNoSys/blob/main/docs/README.pdf).
+
+If you don't use the function, it might work anyway, but you may have some other font which uses the same Unicode code points for other purposes. (And some of the symbols, such as `hamquery` and `hamexclaim`, are not in the Private Use Area, and are certainly defined by other fonts.) Using `#hamnosys-text` ensures that the HamNoSysUnicode font is used, which is what you want.
+
+## Entry by Symbol Name
+
+If you're typing yourself, it's much easier to use the names of the symbols. There are two ways to do this.
+
+### Use the `#hamnosys` function
+
+```Typst
+You can sign "Hamburg" as #hamnosys("hamceeall,hamthumbopenmod,hamfingerstraightmod,
+hamextfingerul,hampalmdl,hamforehead,hamlrat,hamclose,hamparbegin,
+hammover,hamreplace,hampinchall,hamfingerstraightmod,hamparend")
+```
+
+In the input string, symbol names should be separated with commas. You may optionally additionally use whitespace. All symbol names begin with `ham`, and you can leave that off, so the above could just as easily be given as
+
+```Typst
+You can sign "Hamburg" as #hamnosys("ceeall, thumbopenmod, fingerstraightmod,
+ extfingerul, palmdl, forehead, lrat, close, parbegin, mover, replace, pinchall, fingerstraightmod, parend")
+```
+
+### Use the `#ham` variable
+
+For shorter blocks of text, it may be easier to use a variable rather than a function call. So instead of `#hamnosys("close")`, you can write `#ham.close`, which is less typing.
+
+### Symbol Names
+
+HamNoSys symbol names occasionally include digits. The TeX package changed these to words, so for example `hampinch12open` was changed to `hampinchonetwoopen`, because that's necessary in TeX. For this Typst package, both sets of names work.
+

packages/preview/hamnosys-includer/1.0.0/LPPL.typ

@@ -0,0 +1,74 @@
+#set page(margin: (top: 1.5cm))
+#show raw: set text(font: ("HamNoSysUnicode", "DejaVu Sans Mono"))
+
+#import "hamnosys.typ": ham, hamnosys, hamnosys-text
+
+= HamNoSys (Hamburg Notation System)
+
+HamNoSys is a system for the phonetic transcription of signed languages. The HamNoSysUnicode font uses the Unicode Private Use Area for the HamNoSys symbols.
+
+The font (and the symbol names) are taken from the TeX package #link("https://ctan.org/pkg/hamnosys?lang=en")[_hamnosys_], maintained by Thomas Hanke & Marc Schulder. You will first need to download the TeX package and find the HamNoSysUnicode font.
+
+If you're working locally, install the font (or pass its location to Typst with the `--font-path` argument). If you're using the #link("https://typst.app")[Typst web service], you just need to include the font among your uploaded files. Without the font, this package is useless.
+
+Second, include the line
+
+```Typst
+#import "hamnosys.typ": ham, hamnosys, hamnosys-text
+```
+
+in your document.
+
+== Direct Entry
+
+You can enter the symbols directly into your Typst document. There's no way to actually type most of them, as they're mostly in the Unicode Private Use Area, but this is handy if you want to copy and paste from elsewhere. If you do this, you should wrap them in the `#hamnosys-text` function.
+
+This input:
+```Typst
+#hamnosys-text("")
+```
+
+Gives this output: \
+#hamnosys-text("")
+
+If you don't use the function, it might work anyway, but you may have some other font which uses the same Unicode code points for other purposes. (And some of the symbols, such as `hamquery` and `hamexclaim`, are not in the Private Use Area, and are certainly defined by other fonts.) Using `#hamnosys-text` ensures that the HamNoSysUnicode font is used, which is what you want.
+
+== Entry by Symbol Name
+
+If you're typing yourself, it's much easier to use the names of the symbols. There are two ways to do this.
+
+=== Use the `#hamnosys` function
+
+This input:
+```Typst
+You can sign "Hamburg" as #hamnosys("hamceeall,hamthumbopenmod,hamfingerstraightmod,
+hamextfingerul,hampalmdl,hamforehead,hamlrat,hamclose,hamparbegin,
+hammover,hamreplace,hampinchall,hamfingerstraightmod,hamparend")
+```
+
+Gives this output: \
+You can sign "Hamburg" as  #hamnosys("hamceeall,hamthumbopenmod,hamfingerstraightmod,
+hamextfingerul,hampalmdl,hamforehead,hamlrat,hamclose,hamparbegin,
+hammover,hamreplace,hampinchall,hamfingerstraightmod,hamparend")
+
+In the input string, symbol names should be separated with commas. You may optionally additionally use whitespace. All symbol names begin with `ham`, and you can leave that off, so the above could just as easily be given as
+
+```Typst
+You can sign "Hamburg" as #hamnosys("ceeall, thumbopenmod, fingerstraightmod,
+ extfingerul, palmdl, forehead, lrat, close, parbegin, mover, replace, pinchall, fingerstraightmod, parend")
+```
+
+=== Use the `#ham` variable
+
+For shorter blocks of text, it may be easier to use a variable rather than a function call. So instead of `#hamnosys("close")`, you can write `#ham.close`, which is less typing.
+
+=== Symbol Names
+
+HamNoSys symbol names occasionally include digits. The TeX package changed these to words, so for example `hampinch12open` was changed to `hampinchonetwoopen`, because that's necessary in TeX. For this Typst package, both sets of names work.
+
+= Licence
+
+Since the TeX package which inspired this (and, importantly, the font which this also uses) are under the LPPL, I suppose it's necessary that this is too, though that does feel a bit odd for a Typst package.
+
+#sym.copyright Timothy Green, 2025.
+

packages/preview/hamnosys-includer/1.0.0/README.md

@@ -0,0 +1,219 @@
+{
+    "hamfist": 57344,
+    "hamflathand": 57345,
+    "hamfingertwo": 57346,
+    "hamfinger2": 57346,
+    "hamfingertwothree": 57347,
+    "hamfinger23": 57347,
+    "hamfingertwothreespread": 57348,
+    "hamfinger23spread": 57348,
+    "hamfingertwothreefourfive": 57349,
+    "hamfinger2345": 57349,
+    "hampinchonetwo": 57350,
+    "hampinch12": 57350,
+    "hampinchall": 57351,
+    "hampinchonetwoopen": 57352,
+    "hampinch12open": 57352,
+    "hamceeonetwo": 57353,
+    "hamcee12": 57353,
+    "hamceeall": 57354,
+    "hamceeopen": 57355,
+    "hamthumboutmod": 57356,
+    "hamthumbacrossmod": 57357,
+    "hamthumbopenmod": 57358,
+    "hamfingerstraightmod": 57360,
+    "hamfingerbendmod": 57361,
+    "hamfingerhookmod": 57362,
+    "hamdoublebent": 57363,
+    "hamdoublehooked": 57364,
+    "hamextfingeru": 57376,
+    "hamextfingerur": 57377,
+    "hamextfingerr": 57378,
+    "hamextfingerdr": 57379,
+    "hamextfingerd": 57380,
+    "hamextfingerdl": 57381,
+    "hamextfingerl": 57382,
+    "hamextfingerul": 57383,
+    "hamextfingerol": 57384,
+    "hamextfingero": 57385,
+    "hamextfingeror": 57386,
+    "hamextfingeril": 57387,
+    "hamextfingeri": 57388,
+    "hamextfingerir": 57389,
+    "hamextfingerui": 57390,
+    "hamextfingerdi": 57391,
+    "hamextfingerdo": 57392,
+    "hamextfingeruo": 57393,
+    "hampalmu": 57400,
+    "hampalmur": 57401,
+    "hampalmr": 57402,
+    "hampalmdr": 57403,
+    "hampalmd": 57404,
+    "hampalmdl": 57405,
+    "hampalml": 57406,
+    "hampalmul": 57407,
+    "hamhead": 57408,
+    "hamheadtop": 57409,
+    "hamforehead": 57410,
+    "hameyebrows": 57411,
+    "hameyes": 57412,
+    "hamnose": 57413,
+    "hamnostrils": 57414,
+    "hamear": 57415,
+    "hamearlobe": 57416,
+    "hamcheek": 57417,
+    "hamlips": 57418,
+    "hamtongue": 57419,
+    "hamteeth": 57420,
+    "hamchin": 57421,
+    "hamunderchin": 57422,
+    "hamneck": 57423,
+    "hamshouldertop": 57424,
+    "hamshoulders": 57425,
+    "hamchest": 57426,
+    "hamstomach": 57427,
+    "hambelowstomach": 57428,
+    "hamneutralspace": 57439,
+    "hamupperarm": 57440,
+    "hamelbow": 57441,
+    "hamelbowinside": 57442,
+    "hamlowerarm": 57443,
+    "hamwristback": 57444,
+    "hamwristpulse": 57445,
+    "hamthumbball": 57446,
+    "hampalm": 57447,
+    "hamhandback": 57448,
+    "hamthumbside": 57449,
+    "hampinkyside": 57450,
+    "hamthumb": 57456,
+    "hamindexfinger": 57457,
+    "hammiddlefinger": 57458,
+    "hamringfinger": 57459,
+    "hampinky": 57460,
+    "hamfingertip": 57461,
+    "hamfingernail": 57462,
+    "hamfingerpad": 57463,
+    "hamfingermidjoint": 57464,
+    "hamfingerbase": 57465,
+    "hamfingerside": 57466,
+    "hamlrbeside": 57432,
+    "hamlrat": 57433,
+    "hamcoreftag": 57434,
+    "hamcorefref": 57435,
+    "hammoveu": 57472,
+    "hammoveur": 57473,
+    "hammover": 57474,
+    "hammovedr": 57475,
+    "hammoved": 57476,
+    "hammovedl": 57477,
+    "hammovel": 57478,
+    "hammoveul": 57479,
+    "hammoveol": 57480,
+    "hammoveo": 57481,
+    "hammoveor": 57482,
+    "hammoveil": 57483,
+    "hammovei": 57484,
+    "hammoveir": 57485,
+    "hammoveui": 57486,
+    "hammovedi": 57487,
+    "hammovedo": 57488,
+    "hammoveuo": 57489,
+    "hamcircleo": 57490,
+    "hamcirclei": 57491,
+    "hamcircled": 57492,
+    "hamcircleu": 57493,
+    "hamcirclel": 57494,
+    "hamcircler": 57495,
+    "hamcircleul": 57496,
+    "hamcircledr": 57497,
+    "hamcircleur": 57498,
+    "hamcircledl": 57499,
+    "hamcircleol": 57500,
+    "hamcircleir": 57501,
+    "hamcircleor": 57502,
+    "hamcircleil": 57503,
+    "hamcircleui": 57504,
+    "hamcircledo": 57505,
+    "hamcircleuo": 57506,
+    "hamcircledi": 57507,
+    "hamfingerplay": 57508,
+    "hamnodding": 57509,
+    "hamswinging": 57510,
+    "hamtwisting": 57511,
+    "hamstircw": 57512,
+    "hamstirccw": 57513,
+    "hamreplace": 57514,
+    "hamnomotion": 57519,
+    "hamclocku": 57520,
+    "hamclockul": 57521,
+    "hamclockl": 57522,
+    "hamclockdl": 57523,
+    "hamclockd": 57524,
+    "hamclockdr": 57525,
+    "hamclockr": 57526,
+    "hamclockur": 57527,
+    "hamclockfull": 57528,
+    "hamarcl": 57529,
+    "hamarcu": 57530,
+    "hamarcr": 57531,
+    "hamarcd": 57532,
+    "hamwavy": 57533,
+    "hamzigzag": 57534,
+    "hamellipseh": 57536,
+    "hamellipseur": 57537,
+    "hamellipsev": 57538,
+    "hamellipseul": 57539,
+    "hamincreasing": 57540,
+    "hamdecreasing": 57541,
+    "hamfast": 57544,
+    "hamslow": 57545,
+    "hamtense": 57546,
+    "hamrest": 57547,
+    "hamhalt": 57548,
+    "hamclose": 57552,
+    "hamtouch": 57553,
+    "haminterlock": 57554,
+    "hamcross": 57555,
+    "hamarmextended": 57556,
+    "hambehind": 57557,
+    "hambrushing": 57558,
+    "hamsmallmod": 57542,
+    "hamlargemod": 57543,
+    "hamrepeatfromstart": 57560,
+    "hamrepeatfromstartseveral": 57561,
+    "hamrepeatcontinue": 57562,
+    "hamrepeatcontinueseveral": 57563,
+    "hamrepeatreverse": 57564,
+    "hamalternatingmotion": 57565,
+    "hamseqbegin": 57568,
+    "hamseqend": 57569,
+    "hamparbegin": 57570,
+    "hamparend": 57571,
+    "hamfusionbegin": 57572,
+    "hamfusionend": 57573,
+    "hambetween": 57574,
+    "hamplus": 57575,
+    "hamsymmpar": 57576,
+    "hamsymmlr": 57577,
+    "hamnondominant": 57578,
+    "hamnonipsi": 57579,
+    "hametc": 57580,
+    "hamorirelative": 57581,
+    "hammime": 57584,
+    "hamversionfourzero": 57585,
+    "hamversion40": 57585,
+    "hamspace": 32,
+    "hamexclaim": 33,
+    "hamcomma": 44,
+    "hamfullstop": 46,
+    "hamquery": 63,
+    "hamaltbegin": 123,
+    "hammetaalt": 124,
+    "hamaltend": 125,
+    "hamwristtopulse": 57468,
+    "hamwristtoback": 57469,
+    "hamwristtothumb": 57470,
+    "hamwristtopinky": 57471,
+    "hammovecross": 57517,
+    "hammoveX": 57518
+}

packages/preview/hamnosys-includer/1.0.0/docs/README.pdf

@@ -0,0 +1,34 @@
+#let hamnosys-translations = json("hamnosys.json")
+
+#let hamnosys(it) = {
+  set text(font: "HamNoSysUnicode")
+  let s = it.split(",");
+  for sym in s {
+    sym = sym.trim()
+    if (sym != "") {
+      let start = sym.slice(0, 3)
+      if (start != "ham") {
+        sym = "ham" + sym
+      }
+      str.from-unicode(hamnosys-translations.at(sym))
+    }
+  }
+}
+
+#let hamnosys-text(it) = {
+  set text(font: "HamNoSysUnicode")
+  it
+}
+
+#let ham = (:)
+#for (n, u) in hamnosys-translations {
+  let nn = n.slice(3)
+  // This is perhaps not the most efficient way to do it: we already have the Unicode
+  // code point available, and we're passing to the hamnosys() function which has
+  // to look it up again. But it makes the code simpler. Also, this loop happens
+  // only once, on document initiation.
+  let output = hamnosys(n)
+  ham.insert(n, output)
+  ham.insert(nn, output)
+}
+

packages/preview/hamnosys-includer/1.0.0/docs/README.typ

@@ -0,0 +1,12 @@
+[package]
+name = "hamnosys-includer"
+version = "1.0.0"
+entrypoint = "hamnosys.typ"
+authors = ["Timothy Green"]
+license = "LPPL-1.3c"
+description = "For using HamNoSys in Typst"
+keywords = ["HamNoSys", "Deaf", "Sign Language", "linguistics"]
+categories = ["text", "languages"]
+disciplines = ["linguistics"]
+exclude = ["docs", "LPPL.typ"]
+repository = "https://github.com/TestTimothy/Typst-HamNoSys"