{"id":13524729,"url":"https://github.com/imatpot/typst-ascii-ipa","last_synced_at":"2026-01-07T11:14:23.046Z","repository":{"id":154457181,"uuid":"618085775","full_name":"imatpot/typst-ascii-ipa","owner":"imatpot","description":"🔄 ASCII / IPA conversion for Typst","archived":false,"fork":false,"pushed_at":"2024-05-13T23:31:35.000Z","size":749,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-03T19:03:53.945Z","etag":null,"topics":["branner","ipa","praat","sil","typst","xsampa"],"latest_commit_sha":null,"homepage":"https://typst.app/universe/package/ascii-ipa","language":"Typst","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imatpot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-23T18:11:29.000Z","updated_at":"2024-11-09T06:54:16.000Z","dependencies_parsed_at":"2024-01-13T22:25:03.555Z","dependency_job_id":"6dd9a1bc-1503-4a26-a796-b521a8fb22b5","html_url":"https://github.com/imatpot/typst-ascii-ipa","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imatpot%2Ftypst-ascii-ipa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imatpot%2Ftypst-ascii-ipa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imatpot%2Ftypst-ascii-ipa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imatpot%2Ftypst-ascii-ipa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imatpot","download_url":"https://codeload.github.com/imatpot/typst-ascii-ipa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245806439,"owners_count":20675298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["branner","ipa","praat","sil","typst","xsampa"],"created_at":"2024-08-01T06:01:12.852Z","updated_at":"2026-01-07T11:14:18.026Z","avatar_url":"https://github.com/imatpot.png","language":"Typst","funding_links":[],"categories":["Templates \u0026 Libraries"],"sub_categories":["Linguistics"],"readme":"# `ascii-ipa`\n\n🔄 ASCII / IPA conversion for Typst\n\nThis package allows you to easily convert different ASCII representations of the International Phonetic Alphabet (IPA) to and from the IPA.\nIt also offers some minor utilities to make phonetic transcriptions easier to use overall.\nThe package is being maintained [here][repo].\n\nNote: This is an extended port of the [`ipa-translate`][ipa-translate] Rust crate by [tirimid][tirimid]'s conversion features into native Typst.\nMost conversions are implemented according to [this Wikipedia article][ipa-wikipedia] which in turn relies of the official specifications of the respective ASCII representations.\n\n## Conversion\n\nThe package supports multiple ASCII representations for the IPA with one function each:\n\n| Notation | Function name   |\n|----------|-----------------|\n| Branner  | `#branner(...)` |\n| Praat    | `#praat(...)`   |\n| SIL      | `#sil(...)`     |\n| X-SAMPA  | `#xsampa(...)`  |\n\nThey all return the converted value as a [`string`][typst-str] and accept the set of same parameters:\n\n| Parameter | Type                  | Positional / Named | Default | Description                                                                                                |\n|-----------|-----------------------|--------------------|---------|------------------------------------------------------------------------------------------------------------|\n| `value`   | [`string`][typst-str] | positional         |         | Main input to the function. Usually the transcription in the corresponsing ASCII-based notation.           |\n| `reverse` | [`bool`][typst-bool]  | named              | `false` | Reverses the conversion. Pass Unicode IPA into `value` to get the corresponsing ASCII-based notation back. |\n\n### Examples\n\nAll examples use the Swiss German word [⟨Chuchichäschtli⟩ [ˈχʊχːiˌχæʃːtlɪ]][chuchichäschtli] for the conversion.\n\n```typst\n#import \"@preview/ascii-ipa:2.0.0\": *\n\n// returns \"ˈχʊχːiˌχæʃːtlɪ\"\n#branner(\"'XUX:i,Xae)S:tlI\")\n\n// returns \"'XUX:i,Xae)S:tlI\"\n#branner(\"ˈχʊχːiˌχæʃːtlɪ\", reverse: true)\n\n// returns \"ˈχʊχːiˌχæʃːtlɪ\"\n#praat(\"\\\\'1\\\\cf\\\\hs\\\\cf\\\\:f\\\\'2\\\\ae\\\\sh\\\\:ftl\\\\ic\")\n\n// returns \"\\\\'1\\\\cf\\\\hs\\\\cf\\\\:f\\\\'2\\\\ae\\\\sh\\\\:ftl\\\\ic\"\n#praat(\"ˈχʊχːiˌχæʃːtlɪ\", reverse: true)\n\n// returns \"ˈχʊχːiˌχæʃːtlɪ\"\n#sil(\"}x=u\u003cx=:i}}x=a\u003cs=:tli=\")\n\n// returns \"}x=u\u003cx=:i}}x=a\u003cs=:tli=\"\n#sil(\"ˈχʊχːiˌχæʃːtlɪ\", reverse: true)\n\n// returns \"ˈχʊχːiˌχæʃːtlɪ\"\n#xsampa(\"\\\"XUX:i%X{S:tlI\")\n\n// returns \"\\\"XUX:i%X{S:tlI\"\n#xsampa(\"ˈχʊχːiˌχæʃːtlɪ\", reverse: true)\n```\n\n### With `raw`\n\nYou can also use [`raw`][typst-raw] for the conversion.\nThis is useful if the notation uses a lot of backslashes.\n\n```typst\n#import \"@preview/ascii-ipa:2.0.0\": praat\n\n// regular string\n#praat(\"\\\\'1\\\\cf\\\\hs\\\\cf\\\\:f\\\\'2\\\\ae\\\\sh\\\\:ftl\\\\ic\")\n\n// raw\n#praat(`\\'1\\cf\\hs\\cf\\:f\\'2\\ae\\sh\\:ftl\\ic`)\n```\n\nNote: `raw` will not play nicely with notations that use ``` ` ``` a lot.\n\n## Brackets \u0026 Braces\n\nYou can easily mark your notation text as different types of brackets or braces.\n\n```typst\n#import \"@preview/ascii-ipa:2.0.0\": *\n\n#phonetic(\"prʲɪˈvʲet\") // [prʲɪˈvʲet]\n#phnt(\"prʲɪˈvʲet\")     // [prʲɪˈvʲet]\n\n#precise(\"prʲɪˈvʲet\") // ⟦prʲɪˈvʲet⟧\n#prec(\"prʲɪˈvʲet\")    // ⟦prʲɪˈvʲet⟧\n\n#phonemic(\"prɪvet\") // /prɪvet/\n#phnm(\"prɪvet\")     // /prɪvet/\n\n#morphophonemic(\"prɪvet\") // ⫽prɪvet⫽\n#mphnm(\"prɪvet\")          // ⫽prɪvet⫽\n\n#indistinguishable(\"prʲɪˈvʲet\") // (prʲɪˈvʲet)\n#idst(\"prʲɪˈvʲet\")              // (prʲɪˈvʲet)\n\n#obscured(\"prʲɪˈvʲet\") // ⸨prʲɪˈvʲet⸩\n#obsc(\"prʲɪˈvʲet\")     // ⸨prʲɪˈvʲet⸩\n\n#orthographic(\"привет\") // ⟨привет⟩\n#orth(\"привет\")         // ⟨привет⟩\n\n#transliterated(\"privyet\") // ⟪privyet⟫\n#trlt(\"privyet\")           // ⟪privyet⟫\n\n#prosodic(\"prʲɪˈvʲet\") // {prʲɪˈvʲet}\n#prsd(\"prʲɪˈvʲet\")     // {prʲɪˈvʲet}\n```\n\n[repo]: https://github.com/imatpot/typst-ascii-ipa\n[ipa-translate]: https://github.com/tirimid/ipa-translate\n[tirimid]: https://github.com/tirimid\n[ipa-wikipedia]: https://en.wikipedia.org/wiki/Comparison_of_ASCII_encodings_of_the_International_Phonetic_Alphabet\n[typst-str]: https://typst.app/docs/reference/foundations/str/\n[typst-bool]: https://typst.app/docs/reference/foundations/bool/\n[typst-raw]: https://typst.app/docs/reference/text/raw/\n[chuchichäschtli]: https://als.wikipedia.org/wiki/Chuchich%C3%A4schtli\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimatpot%2Ftypst-ascii-ipa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimatpot%2Ftypst-ascii-ipa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimatpot%2Ftypst-ascii-ipa/lists"}