2 Getting Started 入门

2.1 The mxGraph Package mxGraph 软件包

2.1.1 Obtaining mxGraph 获取 mxGraph

[翻译]
mxGraph 可从 GitHub 项目获取。发布版本标记为“va.b.c”，其中 a、b 和 c 是遵循语义版本控制的版本号部分。

[原文]
mxGraph is available from the GitHub project. Released versions are tagged "va.b.c", where a, b and c are version number parts following semantic versioning.

https://github.com/jgraph/mxgraph

• available /'velbl/ 可用的
• tagged /taeɡd/ 标记的
• semantic /s'maentk/ 语义的
• versioning /'vrn/ 版本控制

[翻译]
每个正式发布版本还以 .zip 或 .tar.gz 格式在 mxGraph 发布页面上提供。

[原文]
Each formal release is also available as .zip or .tar.gz on the mxGraph releases page.

• formal /'frml/ 正式的
• release /r'lis/ 发布

https://github.com/jgraph/mxgraph/releases

2.1.2 Project structure and build options 项目结构与构建选项

[翻译]
解压后，您将在安装根目录中看到多个文件和目录。

[原文]
Once unzipped you will be presented with a number of files and directories in the installation root.

• unzipped /n'zpt/ 解压的
• directories /d'rektriz/ 目录
• installation /nst'len/ 安装

/doc
文档根目录，包括本用户手册

/dotnet
.NET 服务器端类

/java
Java 服务器端类

/javascript
JavaScript 客户端功能

/javascript/examples
展示 mxGraph 使用的 HTML 示例

ChangeLog
版本之间的更改详情

index.html
库的基本介绍

license.txt
您必须遵守的许可条款

Table: Project Directory Structure
表格：项目目录结构

2.1.3 npm npm

[翻译]
mxGraph 也可通过 npm 包管理器获取。要将 mxGraph 用作依赖项，请使用 npm 安装：

[原文]
mxGraph is also available via the npm package manager. To use mxGraph as a depedency, use npm install:

• available /'velbl/ 可用的
• dependency /d'pendnsi/ 依赖项
• install /n'stl/ 安装

npm install mxgraph --save

[翻译]
该模块可使用 require() 加载。这将返回一个接受选项对象的工厂函数。必须向工厂函数提供选项（如 mxBasePath），而不是作为全局变量指定。

[原文]
The module can be loaded using require(). This returns a factory function that accepts an object of options. Options such as mxBasePath must be provided to the factory function, rather than specified as global variables.

• module /'mɑdul/ 模块
• require /r'kwar/ 要求
• factory /'faektri/ 工厂
• options /'ɑpnz/ 选项
• global /'ɡlobl/ 全局的

var mxgraph = require("mxgraph")({  
mxImageBasePath: "./src/images",  
mxBasePath: "./src"  
})  

[翻译]
工厂函数返回一个“命名空间对象”，提供对 mxGraph 包中所有对象的访问。例如，mxEvent 对象可在 mxgraph.mxEvent 处访问。

[原文]
The factory function returns a 'namespace object' that provides access to all objects of the mxGraph package. For example, the mxEvent object is available at mxgraph.mxEvent.

• namespace /'nemspes/ 命名空间
• access /'aekses/ 访问
• package /'paekd/ 包

var mxEvent = mxgraph.mxEvent;  
mxEvent.disableContextMenu(container);