Penelope是一款用于创建、编辑和转换词典的多功能工具,尤其适用于电子阅读器设备。
使用当前版本,您可以:
bookeen
输出格式)打开控制台并输入:
$ [sudo] pip install penelope
就是这样!只需不带参数运行(或使用-h
或--help
)即可获取手册:
$ penelope
此过程将安装lxml
和marisa-trie
。您可能需要单独安装dictzip
(StarDict 输出)和kindlegen
(MOBI 输出),请参见下文。
获取源代码:
使用git
克隆此存储库:
$ git clone https://github.com/pettarin/penelope.git
或者下载最新版本并将其解压缩到某处,
或者下载当前的主 ZIP 并将其解压缩到某处。
打开控制台并进入penelope
(克隆)目录:
$ cd /path/to/penelope
就是这样!只需不带参数运行(或使用-h
或--help
)即可获取手册:
$ python -m penelope
此过程不会安装任何依赖项:您需要手动执行此操作,请参见下文。
Python,版本 2.7.x 或 3.4.x(或更高版本)
编写 StarDict 词典: dictzip
可执行文件,可在$PATH
中使用或使用--dictzip-path
指定:
$ [sudo] apt-get install dictzip
读/写 Kobo 词典:Python 模块marisa-trie
:
$ [sudo] pip install marisa-trie
或$PATH
中可用的或用--marisa-bin-path
指定的 MARISA 可执行文件
编写 MOBI Kindle 词典:kindlegen 可执行文件,可在$PATH
中使用或使用--kindlegen-path
指定
读/写 XML 字典:Python 模块lxml
:
$ [sudo] pip install lxml
usage:
$ penelope -h
$ penelope -i INPUT_FILE -j INPUT_FORMAT -f LANGUAGE_FROM -t LANGUAGE_TO -p OUTPUT_FORMAT -o OUTPUT_FILE [OPTIONS]
$ penelope -i IN1,IN2[,IN3...] -j INPUT_FORMAT -f LANGUAGE_FROM -t LANGUAGE_TO -p OUTPUT_FORMAT -o OUTPUT_FILE [OPTIONS]
description:
Convert dictionary file(s) with file name prefix INPUT_FILE from format INPUT_FORMAT to format OUTPUT_FORMAT, saving it as OUTPUT_FILE.
The dictionary is from LANGUAGE_FROM to LANGUAGE_TO, possibly the same.
You can merge several dictionaries (with the same format), by providing a list of comma-separated prefixes, as shown by the third synopsis above.
optional arguments:
-h, --help show this help message and exit
-d, --debug enable debug mode (default: False)
-f LANGUAGE_FROM, --language-from LANGUAGE_FROM
from language (ISO 639-1 code)
-i INPUT_FILE, --input-file INPUT_FILE
input file name prefix(es). Multiple prefixes must be
comma-separated.
-j INPUT_FORMAT, --input-format INPUT_FORMAT
from format (values: bookeen|csv|kobo|stardict|xml)
-k, --keep keep temporary files (default: False)
-o OUTPUT_FILE, --output-file OUTPUT_FILE
output file name
-p OUTPUT_FORMAT, --output-format OUTPUT_FORMAT
to format (values:
bookeen|csv|epub|kobo|mobi|stardict|xml)
-t LANGUAGE_TO, --language-to LANGUAGE_TO
to language (ISO 639-1 code)
-v, --version print version and exit
--author AUTHOR author string
--copyright COPYRIGHT
copyright string
--cover-path COVER_PATH
path of the cover image file
--description DESCRIPTION
description string
--email EMAIL email string
--identifier IDENTIFIER
identifier string
--license LICENSE license string
--title TITLE title string
--website WEBSITE website string
--year YEAR year string
--apply-css APPLY_CSS
apply the given CSS file (epub and mobi output only)
--bookeen-collation-function BOOKEEN_COLLATION_FUNCTION
use the specified collation function
--bookeen-install-file
create *.install file (default: False)
--csv-fs CSV_FS CSV field separator (default: ',')
--csv-ignore-first-line
ignore the first line of the input CSV file(s)
(default: False)
--csv-ls CSV_LS CSV line separator (default: 'n')
--dictzip-path DICTZIP_PATH
path to dictzip executable
--epub-no-compress do not create the compressed container (epub output
only, default: False)
--escape-strings escape HTML strings (default: False)
--flatten-synonyms flatten synonyms, creating a new entry with
headword=synonym and using the definition of the
original headword (default: False)
--group-by-prefix-function GROUP_BY_PREFIX_FUNCTION
compute the prefix of headwords using the given prefix
function file
--group-by-prefix-length GROUP_BY_PREFIX_LENGTH
group headwords by prefix of given length (default: 2)
--group-by-prefix-merge-across-first
merge headword groups even when the first character
changes (default: False)
--group-by-prefix-merge-min-size GROUP_BY_PREFIX_MERGE_MIN_SIZE
merge headword groups until the given minimum number
of headwords is reached (default: 0, meaning no merge
will take place)
--ignore-case ignore headword case, all headwords will be lowercased
(default: False)
--ignore-synonyms ignore synonyms, not reading/writing them if present
(default: False)
--include-index-page include an index page (epub and mobi output only,
default: False)
--input-file-encoding INPUT_FILE_ENCODING
use the specified encoding for reading the raw
contents of input file(s) (default: 'utf-8')
--input-parser INPUT_PARSER
use the specified parser function after reading the
raw contents of input file(s)
--kindlegen-path KINDLEGEN_PATH
path to kindlegen executable
--marisa-bin-path MARISA_BIN_PATH
path to MARISA bin directory
--marisa-index-size MARISA_INDEX_SIZE
maximum size of the MARISA index (default: 1000000)
--merge-definitions merge definitions for the same headword (default:
False)
--merge-separator MERGE_SEPARATOR
add this string between merged definitions (default: '
| ')
--mobi-no-kindlegen do not run kindlegen, keep .opf and .html files
(default: False)
--no-definitions do not output definitions for EPUB and MOBI formats
(default: False)
--sd-ignore-sametypesequence
ignore the value of sametypesequence in StarDict .ifo
files (default: False)
--sd-no-dictzip do not compress the .dict file in StarDict files
(default: False)
--sort-after sort after merging/flattening (default: False)
--sort-before sort before merging/flattening (default: False)
--sort-by-definition sort by definition (default: False)
--sort-by-headword sort by headword (default: False)
--sort-ignore-case ignore case when sorting (default: False)
--sort-reverse reverse the sort order (default: False)
examples:
$ penelope -i dict.csv -j csv -f en -t it -p stardict -o output.zip
Convert en->it dictionary dict.csv (in CSV format) into output.zip (in StarDict format)
$ penelope -i dict.csv -j csv -f en -t it -p stardict -o output.zip --merge-definitions
As above, but also merge definitions
$ penelope -i d1,d2,d3 -j csv -f en -t it -p csv -o output.csv --sort-after --sort-by-headword
Merge CSV dictionaries d1, d2, and d3 into output.csv, sorting by headword
$ penelope -i d1,d2,d3 -j csv -f en -t it -p csv -o output.csv --sort-after --sort-by-headword --sort-ignore-case
As above, but ignore case for sorting
$ penelope -i d1,d2,d3 -j csv -f en -t it -p csv -o output.csv --sort-after --sort-by-headword --sort-reverse
As above, but reverse the order
$ penelope -i dict.zip -j stardict -f en -t it -p csv -o output.csv
Convert en->it dictionary dict.zip (in StarDict format) into output.csv (in CSV format)
$ penelope -i dict.zip -j stardict -f en -t it -p csv -o output.csv --ignore-synonyms
As above, but do not read the .syn synonym file if present
$ penelope -i dict.zip -j stardict -f en -t it -p csv -o output.csv --flatten-synonyms
As above, but flatten synonyms
$ penelope -i dict.zip -j stardict -f en -t it -p bookeen -o output
Convert dict.zip into output.dict.idx and output.dict for Bookeen devices
$ penelope -i dict.zip -j stardict -f en -t it -p kobo -o dicthtml-en-it
Convert dict.zip into dicthtml-en-it.zip for Kobo devices
$ penelope -i dict.csv -j csv -f en -t it -p mobi -o output.mobi --cover-path mycover.png --title "My English->Italian Dictionary"
Convert dict.csv into a MOBI (Kindle) dictionary, using the specified cover image and title
$ penelope -i dict.xml -j xml -f en -t it -p mobi -o output.epub
Convert dict.xml into an EPUB dictionary
$ penelope -i dict.xml -j xml -f en -t it -p mobi -o output.epub --epub-output-definitions
As above, but also output definitions
您可以在此处找到 ISO 639-1 语言代码。
例如,假设您想使用 IT -> EN 字典。
it-en.dict
和it-en.dict.idx
。it-en.dict
和it-en.dict.idx
这两个文件从 PC 复制到 Odyssey 设备上的Dictionaries/
目录中。请注意,Bookeen 词典软件将通过读取电子书的dc:language
元数据来选择要使用的词典。确保您的电子书具有正确的dc:language
元数据,否则可能无法加载正确的词典。
在撰写本文时(2016-02-16),只有当文件具有官方 Kobo 词典的文件名时,Kobo 设备才会加载词典,即:
dicthtml.zip
(EN)dicthtml-de.zip
(德语), dicthtml-de-en.zip
(德语 -> EN), dicthtml-en-de.zip
(EN -> 德语),dicthtml-es.zip
(ES), dicthtml-es-en.zip
(ES -> EN), dicthtml-en-es.zip
(EN -> ES),dicthtml-fr.zip
(法语), dicthtml-fr-en.zip
(法语 -> EN), dicthtml-en-fr.zip
(EN -> 法语),dicthtml-it.zip
(IT), dicthtml-it-en.zip
(IT -> EN), dicthtml-en-it.zip
(EN -> IT),dicthtml-nl.zip
(NL)dicthtml-ja.zip
(JA), dicthtml-en-ja.zip
(EN -> JA),dicthtml-pt.zip
(PT)、 dicthtml-pt-en.zip
(PT -> EN)、 dicthtml-en-pt.zip
(EN -> PT)(请参阅此 MobileRead 线程)
因此,如果您想安装由 Penelope 制作的自定义词典,您必须选择覆盖其中一本官方 Kobo 词典,从而实际上失去了使用后者的可能性。
例如,假设您想使用波兰语词典 ( dicthtml-pl.zip
),而您对使用官方葡萄牙语词典 ( dicthtml-pt.zip
) 不感兴趣。
dicthtml-pl.zip
。dicthtml-pl.zip
从 PC 复制到 Kobo 设备上的.kobo/dict/
目录中。 (请注意, .kobo
是一个隐藏目录:您可能需要启用文件管理器的“显示隐藏文件/目录”设置。)dicthtml-pl.zip
重命名为dicthtml-pt.zip
。请注意,如果您更新 Kobo 的固件,自定义词典可能会被官方词典覆盖。因此,请将自定义词典的备份副本保存在安全的地方,例如您的 PC 或 SD 卡。
您可以在此 MobileRead 线程中找到自定义词典列表,其中大部分是由 Penelope 完成的。
Penelope自 2.0.0 版 (2014-06-30) 起在 MIT 许可证下发布。
以前的版本由 Google Code 托管,根据 GNU GPL 3 许可证发布。
format_stardict.py
中的注释)非常感谢:
dict()
而不是 set dict()
;-l
切换到MARISA_BUILD
;& < >
;.syn
文件的 StarDict 字典用于测试。