{"id":14964428,"url":"https://github.com/nsmarkop/plover_korean","last_synced_at":"2025-10-25T07:30:53.197Z","repository":{"id":45359670,"uuid":"112556131","full_name":"nsmarkop/plover_korean","owner":"nsmarkop","description":"Korean plugin for Plover","archived":false,"fork":false,"pushed_at":"2021-12-18T07:22:12.000Z","size":388,"stargazers_count":12,"open_issues_count":5,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T06:11:40.985Z","etag":null,"topics":["korean","plover","plugin","stenography"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nsmarkop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-30T02:48:40.000Z","updated_at":"2024-09-16T23:02:41.000Z","dependencies_parsed_at":"2022-08-30T03:40:38.172Z","dependency_job_id":null,"html_url":"https://github.com/nsmarkop/plover_korean","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsmarkop%2Fplover_korean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsmarkop%2Fplover_korean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsmarkop%2Fplover_korean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nsmarkop%2Fplover_korean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nsmarkop","download_url":"https://codeload.github.com/nsmarkop/plover_korean/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238096372,"owners_count":19415788,"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":["korean","plover","plugin","stenography"],"created_at":"2024-09-24T13:33:10.100Z","updated_at":"2025-10-25T07:30:46.707Z","avatar_url":"https://github.com/nsmarkop.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plover Korean\n\nKorean stenography for [Plover](https://github.com/openstenoproject/plover).\n\n- [Korean Modern C - CAS-based System](#korean-modern-c)\n- [Korean Modern S - Sorizava-based System](#korean-modern-s)\n- [Meta Plugins](#meta-plugins)\n\n## Installation\n\n*This plugin has not been released on PyPI yet, so locally installing from source is currently the only option*\n\nIf you have issues with character misalignment in places like the Paper Tape in the Plover GUI try installing [Nanum Gothic Coding](https://fonts.google.com/earlyaccess#Nanum+Gothic+Coding), a monospaced sans-serif Korean font, and setting Plover's font to that where possible. The majority of monospaced fonts do not have CJK language support which is why this issue comes up for things relying on monospaced plain text display.\n\n## Korean Modern C\n\n![CAS Layout](https://i.imgur.com/T9Kfc07.png)\n\nKorean Modern C is a Korean stenography system based on the system used by Korean CAS machines. See the reference guide for this system [here](/plover_korean/system/cas/docs/README.md).\n\n## Korean Modern S\n\n![Sorizava Layout](https://i.imgur.com/kpEL3mE.png)\n\nKorean Modern S is a Korean stenography system based on the system used by Sorizava machines. See the reference guide for this system [here](/plover_korean/system/sorizava/docs/README.md).\n\n## Meta Plugins\n\nIn order to use these meta plugins you need to add them with a dictionary entry like the example below:\n\n``` json\n{\n    \"ㄴㅣㄱ\": \"{:meta_plugin_name:meta_plugin_argument1,meta_plugin_argument2,...}\"\n}\n```\n\nIf there are no arguments for the meta plugin, just `{:meta_plugin_name}` is sufficient.\n\n### Particles\n\nRegex support for Korean syllable blocks does not work well so various meta plugins have been created for contextually determining what particle to attach to a word.\n\nWhile many particles are always the same when attached to words, some change their form depending on if the word they are attached to ends with a vowel or consonant. The following table lists the current plugins with that support that can be used:\n\nMeta Plugin Name | Concept\n---------------- | ----------\nko_particle_neun | ~는/은\nko_particle_ga   | ~가/이\nko_particle_reul | ~를/을\nko_particle_da   | ~다/이다\nko_particle_ra   | ~라/이라\nko_particle_ya   | ~야/아\nko_particle_wa   | ~와/과\nko_particle_rang | ~랑/이랑\nko_particle_na   | ~나/이나\nko_particle_ro   | ~로/으로\nko_particle_myeo | ~며/이며\n\nIf support for a particular variable particle is not currently implemented, [**please open an issue on GitHub for support to be added**](https://github.com/nsmarkop/plover_korean/issues). However, there is one additional meta plugin that can be used for when this occurs: \"ko_particle_generic\". It has three plugin arguments:\n\n1. The particle to be used for words ending in vowels.\n2. The particle to be used for words ending in consonants.\n3. (optional) The final consonant of words where the consonant case should be treated as the vowel case.\n\nFor example, an entry that replicates the \"ko_particle_neun\" functionality would be:\n\n``` json\n{\n    \"ㄴㅣㄱ\": \"{:ko_particle_generic:는,은}\"\n}\n```\n\nAn entry that replicates the \"ko_particle_ro\" functionality would be:\n\n``` json\n{\n    \"ㄴㅣㄱ\": \"{:ko_particle_generic:로,으로,ㄹ}\"\n}\n```\n\nIf you attempt to use these plugins to attach particles to non-Korean words they cannot accurately determine how to display and will fall back to a default case.\n\n## License\n\nGPLv3+.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsmarkop%2Fplover_korean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnsmarkop%2Fplover_korean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsmarkop%2Fplover_korean/lists"}