odML编辑器

odML-Editor是一个独立的图形用户界面应用程序，用于处理odML文档。Python odML库可在GitHub上获取。如果您不熟悉版本控制系统git，但仍然想使用它，请参阅git-scm网站上的文档。

重大变更

odML版本1.4相对于之前的版本引入了破坏性格式和API变更。可以通过“文件 - 导入”自动将以前格式版本的文件转换为新格式。导入将创建一个新文件，而不会覆盖原始文件。

请注意，已经删除了值数据类型binary。不建议将二进制数据纳入odML文件中，请使用URL数据类型引用原始文件。

有关引入的变更的详细信息，请查看GitHub发行说明。

发行版本

所有发行版本均通过Python包索引分发，并可以使用pip安装。

pip install odml-ui

安装后，可以通过命令行激活程序

odmlui

注意：可能需要首先安装外部GTK3依赖项。

依赖项

odML-Editor使用Gtk 3+库进行GUI，并使用python-odml库。以下依赖项需要安装以使用odML-Editor。

• Python 2.7+或Python 3.4+
• odml v1.4 (pip install odml)

对于基于Ubuntu的发行版

• sudo apt-get install libgtk-3-0
• sudo apt-get install gobject-introspection
• 对于Python 3，sudo apt-get install python3-gi
• 对于Python 2，sudo apt-get install python-gi

对于基于Fedora的发行版

• sudo dnf install gtk3
• sudo dnf install pygobject3
• 对于Python 3，sudo dnf install python3-gobject
• 对于Python 2，sudo dnf install python-gobject

Anaconda依赖项

在安装odML-Editor之前，Anaconda环境只需要以下包

• Python 2.7+或Python 3.4+

• 按以下顺序安装以下包

    conda install -c pkgw/label/superseded gtk3
    conda install -c conda-forge pygobject
    conda install -c conda-forge gdk-pixbuf
    conda install -c pkgw-forge adwaita-icon-theme
  

注意：这些包目前只能在Linux上直接使用！

这些第三方依赖项的macOS安装包含一个错误，该错误会导致打开任何选择文件的窗口时应用程序崩溃。

如果您仍然想在macOS上使用conda的odmlui，您目前需要在您的活动conda环境中手动修复会话开始时的错误，以避免这种崩溃

export GSETTINGS_SCHEMA_DIR=$CONDA_PREFIX/share/glib-2.0/schemas

您还可以将脚本添加到您的conda环境中，这些脚本在conda会话开始时自动设置所需的环境变量，如conda文档中所述。

使用homebrew的macOS

对于Python 2（Python 3）

• brew install gtk+ (gtk+3)
• brew install pygobject (pygobject3)
• brew install gnome-icon-theme
• brew install gobject-introspection

使用Anaconda的Windows

依赖项

• PyGObject for Windows（已测试3.24.1rev1）
• Python 2.7+
• odml v1.4+ (pip install odml)

安装

• 安装Anaconda
• 使用Python 2.7+创建新环境
• 为Windows安装PyGObject - 基础包和GTK+ 3.18.9包

选择便携式Python安装 -> 将路径添加到虚拟环境Python默认值：C:\Users\userName\Anacaonda\envs\nameOfEnv\

• 启动Anaconda提示符
• 安装odml (pip install odml)
• 安装odml-ui (python setup.py install)
• 运行(odmlui)

Windows警告

odml-ui的窗口不能移动（只能最大化） - 移动或调整窗口大小会导致应用程序崩溃。

从源代码安装

通过命令行获取 odML-Editor 源代码的最直接方法是使用 git，并将 GitHub 上的仓库克隆到您选择的目录中。

cd /home/usr/toolbox/
git clone https://github.com/G-Node/odml-ui.git

如果您不想使用 git，也可以下载 GitHub 上提供的 ZIP 文件到您的电脑上（例如，如上所述，在您的“工具箱”文件夹下您的个人目录中）。

要安装 odML-Editor，请进入相应的目录并运行

cd /home/usr/toolbox/odml-ui/
python setup.py install

注意：运行 pip install gi 可能会导致与所需的 GObject 检查库的命名空间冲突。

文档

有关项目以及相关项目、教程和示例的更多信息，可以在我们的 odML 项目页面 上找到。

错误 & 问题

如果您发现的行为可能是错误或觉得有缺失，只需在 GitHub 的 odML-Editor 问题跟踪器 中创建一个问题即可。