Plone工具,用于从CSV源导入您的ATVocabularyManager词汇表(支持LinguaPlone)
项目描述
简介
这是一个帮助开发者将使用ATVocabularyManager完成的词汇表集成到使用Generic Setup Python处理程序和CSV源导入的实用工具。
它还支持(如果存在)LinguaPlone。
如何使用
只需导入createVocabulary函数并使用它
>>> portal_vocabularies = getToolByName(portal, 'portal_vocabularies') >>> from collective.csv2atvocabularymanager.csv_import import createVocabulary >>> createVocabulary(portal_vocabularies, fs_path, 'my.vocabulary.id', ... "My vocabulary", description='A vocabulary for...')
在哪里
- portal_vocabularies
是安装后创建的ATVocabularyManager工具
- fs_path
是文件夹的文件系统路径,您必须在此处放置您的CSV源。
如果代码是从setuphandlers.py脚本调用的,您可以调用如下
>>> os.path.join(os.path.dirname( __file__ ), 'vocabularies')
这样代码将在您项目内部查找“vocabularies”文件夹
- vid
是要创建的词汇表ID,并且将在fs_path文件夹内搜索具有该名称和“.csv”扩展名的文件。
- title
是词汇表的标题
- description
是词汇表的描述
此外,您还有其他可选的附加参数
- type_name
如果创建的词汇表 portal_type 名称(默认为“SimpleVocabulary”)
- sortMethod
是词汇表的排序方法
- null_values
是一个列表,包含必须用作“null”的可能值(如果您的 CSV 文件是从 SQL 数据库的原始导出中获取的,并且源中可能包含“NULL”这样的字符串,则可能很有用)。
- change_master_with_language_id
是一个布尔标志,用于更改生成的词汇表项 ID,并添加语言代码后缀。
CSV 格式示例
名为“foo.bar.vocabulary.csv”的 CSV 文件格式
"id","en" "item-1","Item one" "item-2","Item two" ...
将创建一个 ID 为“foo.bar.vocabulary”的词汇表条目,词汇表项 ID 为“item-1”和“item-2”……以及标题“Item one”,“Item two”……
需要标题行。虽然 ID 列的名称未使用,但该语言列名称用于指定词汇表项语言代码(因此:通常使用门户默认语言)。
您还可以导入不同语言的项目
"id","en","it" "item-1","Item one","Elemento 1" "item-2","Item two","Elemento 2" ...
这样,您将创建与上一个示例中相同的术语,并添加额外的词汇表项,ID 为“item-1-it”,“item-2-it”……以及标题“Elemento 1”,“Elemento 2”……
您可以通过添加更多列来提供额外的语言。只需记住,将第一个语言列保留为具有门户默认语言的列。
如果您还安装了 LinguaPlone,则语言列的实际功能将被充分利用。这样,您将创建词汇表术语的翻译。
最后注意事项
请注意,ATVocabularyManager 已经支持通用设置集成,在安装时创建词汇表。
但是,您被迫使用“IMS VDEX 词汇文件”。
请注意,ATVM 的词汇表实现已经提供了 importCSV 方法。
变更日志
0.1.1 (2012-11-13)
修复了打包错误(缺少 MANIFEST.in 文件)[keul]
0.1.0 (2012-11-12)
首次发布
项目详细信息
collective.csv2atvocabularymanager-0.1.1.zip 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ed760d8f7119f80e81fd04f25e7cf333f51e41b73cedfa5902146ec216f9fc1f |
|
MD5 | 5e1775d6486ec32e45676e11e51c8843 |
|
BLAKE2b-256 | 11277aff3a43a242d6771a69d7b8daac4d24f937f79dd76096c9323d30d18153 |