https://github.com/nsmarkop/plover_yaml_dictionary

YAML dictionary support for Plover
https://github.com/nsmarkop/plover_yaml_dictionary

plover plugin

Last synced: 3 days ago
JSON representation

YAML dictionary support for Plover

• Host: GitHub
• URL: https://github.com/nsmarkop/plover_yaml_dictionary
• Owner: nsmarkop
• License: gpl-3.0
• Created: 2018-06-02T23:03:04.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-06-08T00:45:13.000Z (over 6 years ago)
• Last Synced: 2024-09-18T01:08:18.033Z (10 days ago)
• Topics: plover, plugin
• Language: Python
• Homepage:
• Size: 16.6 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Plover YAML Dictionary

YAML dictionary support for [Plover](https://github.com/openstenoproject/plover).

## Installation

Download the latest version of Plover for your operating system from the [releases page](https://github.com/openstenoproject/plover/releases). Only versions 4.0.0.dev1 and higher are supported.

1. Open Plover

2. Navigate to the Plugin Manager tool

3. Select the "plover-yaml-dictionary" plugin entry in the list

4. Click install

5. Restart Plover

The same method can be used for updating and uninstalling the plugin.

## Dictionary Format

The YAML dictionary format used by this plugin maps translations to strokes rather than strokes to translations which differs from the default JSON dictionary format used by Plover. For a basic comparison,

JSON:

```json

{

"PHRO*EFR": "Plover",

"PHRO*FR": "plover",

"PHROFR": "Plover",

}

```

YAML:

```yaml

Plover:

- PHRO*EFR

- PHROFR

plover:

- PHRO*FR

```

Comments manually added within the YAML dictionary file are currently not preserved due to performance limitations of the YAML package being used.

## Converting JSON dictionaries to YAML

You can use the following script to take an input JSON dictionary file path and output YAML dictionary file path to convert existing Plover JSON dictionaries to the YAML format used by this plugin.

```python

import json

import ruamel.yaml

JSON_FILENAME = r''

YAML_FILENAME = r''

# Load JSON dictionary

with open(JSON_FILENAME, 'r', encoding='utf-8') as in_file:

    in_data = json.load(in_file)

# Group dictionary by value, sorted alphabetically

out_data = {}

for key, value in sorted(in_data.items(), key=lambda x: x[1].casefold()):

    out_data.setdefault(value, []).append(key)

    out_data[value] = sorted(out_data[value])

# Write dictionary to YAML

with open(YAML_FILENAME, 'w', encoding='utf-8') as out_file:

    yaml = ruamel.yaml.YAML(typ='safe')

    yaml.allow_unicode = True

    yaml.default_flow_style = False

    yaml.indent(sequence=4, offset=2)

    yaml.dump(out_data, out_file)

```