Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/outloudvi/mw2fcitx
Fcitx 5 pinyin dictionary generator for MediaWiki instances. (Releases for dict of zh.moegirl.org.cn / Check release list for latest releases)
https://github.com/outloudvi/mw2fcitx
fcitx5 mediawiki pinyin rime
Last synced: 2 days ago
JSON representation
Fcitx 5 pinyin dictionary generator for MediaWiki instances. (Releases for dict of zh.moegirl.org.cn / Check release list for latest releases)
- Host: GitHub
- URL: https://github.com/outloudvi/mw2fcitx
- Owner: outloudvi
- License: unlicense
- Fork: true (felixonmars/fcitx5-pinyin-zhwiki)
- Created: 2020-05-26T06:44:34.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-01-22T14:47:06.000Z (4 days ago)
- Last Synced: 2025-01-22T15:32:54.243Z (4 days ago)
- Topics: fcitx5, mediawiki, pinyin, rime
- Language: Python
- Homepage:
- Size: 5 MB
- Stars: 292
- Watchers: 5
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!NOTE]
> 如果您需要下载**萌娘百科 (zh.moegirl.org.cn) 词库**，请[参见此页](https://github.com/outloudvi/mw2fcitx/wiki/fcitx5-pinyin-moegirl)。
>
> For the **pre-built dictionary for Moegirlpedia** (zh.moegirl.org.cn), see [the wiki](https://github.com/outloudvi/mw2fcitx/wiki/fcitx5-pinyin-moegirl#extra-dictionaries).
---
# mw2fcitx
Build fcitx5/RIME dictionaries from MediaWiki sites.
[](https://pypi.org/project/mw2fcitx/)
[](https://github.com/outloudvi/mw2fcitx/actions/workflows/test.yml)
[](https://codecov.io/gh/outloudvi/mw2fcitx)
```sh
pip install mw2fcitx
# or if you want to just install for current user
pip install mw2fcitx --user
# or if you want to just run it (needs Pipx)
pipx run mw2fcitx
```
## CLI Usage
```
mw2fcitx -c config_script.py
```
## Configuration Script Format
```python
# By default we assume the configuration is located at a variable
# called "exports".
# You can change this with `-n any_name` in the CLI.
exports = {
# Source configurations.
"source": {
# MediaWiki api.php path, if to fetch titles from online.
"api_path": "https://zh.moegirl.org.cn/api.php",
# Title file path, if to fetch titles from local file. (optional)
# Can be a path or a list of paths.
"file_path": ["titles.txt"],
"kwargs": {
# Title number limit for fetching. (optional)
"title_limit": 120,
# Title number limit for fetching via API. (optional)
# Overrides title_limit.
"api_title_limit": 120,
# Title number limit for each fetch via file. (optional)
# Overrides title_limit.
"file_title_limit": 60,
# Partial session file on exception (optional)
"partial": "partial.json",
# Title list export path. (optional)
"output": "titles.txt",
# Delay between MediaWiki API requests in seconds. (optional)
"request_delay": 2,
# Results per API request; same as `aplimit` in MediaWiki docs. (optional)
"aplimit": "max"
}
},
# Tweaks configurations as an list.
# Every tweak function accepts a list of titles and return
# a list of title.
"tweaks":
tweaks,
# Converter configurations.
"converter": {
# opencc is a built-in converter.
# For custom converter functions, just give the function itself.
"use": "opencc",
"kwargs": {
# Replace "m" to "mu" and "n" to "en". Default: False.
# See more in https://github.com/outloudvi/mw2fcitx/issues/29 .
"disable_instinct_pinyin": False,
# Pinyin results to replace. (optional)
# Format: { "汉字": "pin'yin" }
"fixfile": "fixfile.json"
}
},
# Generator configurations.
"generator": [{
# rime is a built-in generator.
# For custom generator functions, just give the function itself.
"use": "rime",
"kwargs": {
# Destination dictionary filename. (optional)
"output": "moegirl.dict.yml"
}
}, {
# pinyin is a built-in generator.
# This generator depends on `libime`.
"use": "pinyin",
"kwargs": {
# Destination dictionary filename. (mandatory)
"output": "moegirl.dict"
}
}]
}
```
A sample config file is here: [`sample_config.py`](https://github.com/outloudvi/mw2fcitx/blob/master/mw2fcitx/sample_config.py)
## Breaking changes across versions
Read [BREAKING_CHANGES.md](./BREAKING_CHANGES.md) for details.
## License
[The Unlicense](https://github.com/outloudvi/mw2fcitx/blob/master/LICENSE)