Violet用户指南（翻译）

 

User Guider

用户指南

 

Sorry, the user guide is still in construction.

不好意思，用户指南还在建设中。

 

First recommendations for a better use

首先，有些关于提升使用舒适度的一些建议

First of all, somes recommendations about how to use your mouse with Violet.

首先，一些关于在Violet中使用鼠标的建议

• Note that you can use your mouse scroll button to change the current UML tool
• 你可以使用你的鼠标滑轮来改变你正在使用的UML工具。
• On the drawing area, right-click to switch to the "select" tool
• 在绘画面板区域，可以通过右击快速选择“选择”工具。
• Don't tryto drag'n'drop UML elements from the tool bar to the drawing panel. Instead, select the element that you want from the tool bar, then click on the drawing panel to insert it. Once inserted, UML elements are fully draggable on the drawing panel.
• 不要尝试去从UML工具面板拖动工具到绘画面板区域，这个没有作用，我们应该在UML工具面板中选择你需要的工具，然后在绘画面板单击以插入自己选择的工具。一旦插入了工具，工具就可以在绘画面板区域自由拖动。

 

Create a diagram and understand Violet's user interface

创建一个UML图，了解Violet的用户界面

When the program starts, pick a diagram type from the File→New menu. The following types are currently available:

当程序启动以后，可以在File-New菜单中选择一个UML图类型，以下是当前程序支持的类型：

• Use case diagrams

• 用例图

• Class diagrams

• 类图

• Object diagrams

• 对象图

• State diagrams

• 状态图

• Activity diagrams

• 活动图

• Sequence diagrams

• 顺序图

Discover your new playground

生成了一个新的绘画面板区域

[insert an image here with an exploded panel]

[在这个绘画面板区域插入图表完成作品]

Each diagram has its own panel with its own side bar on the right and its own status bar on the bottom. Panels are organized in tabs, so you can open several diagrams at the same time.

每一个UML图都有一个自己的编辑面板区域、在右边的的工具栏和在下面的状态栏，不同的编辑区域以标签形式展现，你可以在一个程序界面中同时打开多个UML图。

Let's look at the side bar (on the right). Side bar has tools ordered by category. The first category concerns 'basic" tools such as undo/redo, zoom in/zoom out and delete. The second category concerns UML tools corresponding to the current diagram. This group is different for each diagram. The first tool button (with the four “grabbers”) is the “Select” tool. The other tool buttons let you add nodes and edges to the diagram. Mouse over each node and read the tool tips to see what they do. Tools in the third group are useful to print the current diagram or export it to the clipboard. Then you can simply paste it in your favorite word processor to make illustrated documents.

看一眼在右边的侧边栏吧，里面的每个工具都有分组存放的。第一组是关于“基本” 工具的，例如撤销/取消撤销、放大/缩小以及删除等操作。第二组是和当前UML图类型相关的工具栏，他们会因为UML图的不同而不一样，第一个工具（上面有四个黑点的）是选择工具，其他的是为了添加注解以及关联注解的工具，可以把鼠标移上去根据显示的工具提示判断工具的用途。第三组的工具是专门用于打印当前UML图或将其复制到粘贴板用的，一旦复制到粘贴板以后，你就可以在自己的文字处理工具里面通过粘贴制作自己的插图文稿了，也可以将它粘贴到其他任何地方。

Your first diagram (so cool!)

创建自己的第一个UML图（实在太棒了）

Now, let's look at diagrams. A diagram is composed of nodes (for example, classes or objects) and edges (for example, inheritance arrows or call arrows). To add a node, first click on the matching UML tool on the side bar (on the right), then click anywhere on the diagram to add it. You can also use your mouse scroll button to select another UML tool. To connect two nodes with an edge, first select an edge tool. Then click on the first node and hold down the left mouse button. Drag the mouse to the second node and release the mouse button. The edge is inserted between the two nodes. There is one exception : You can insert a “note connector” edge simply by dragging from a “note” node to anywhere on the diagram.
What? Violet refuses to connect two nodes? It's probably normal. We added some rules to keep your diagram coherent. So, if Violet refuses it, it's because it considers that you are doing something not "UML friendly".

现在让我们自己创建一个UML图，每个UML图都是由一些节点（例如类和对象）和一些关系箭头（例如继承箭头和调用箭头）组成。要增加一个节点，首先在右边的侧边栏选择自己需要的UML工具，让后再绘画面板上的任意地点单击，这样就可以添加一个节点了。你还可以利用鼠标滑轮在UML工具之间来回切换，选择自己需要的工具。要连接两个节点以明确他们的关系，首先得在右边的侧边栏里面选择自己需要的UML工具，你可以通过在两个节点间的拖动鼠标轻松的实现节点之间的关联。有时候这个动作会发生意外——Violet拒绝连接两个节点，这种情况还是比较常见的，因为我们在程序里面添加了一些机制来确保UML图之间的相干性。如果你不幸碰到了Violet拒绝操作的情况，这是因为Violet认为你正在做一些不恰当的操作。

[insert a video here to show how to insert nodes and edges]

在这里插入一段视频解说如何添加节点和关系箭头。

Playing with nodes and edges (selecting / editing  / moving / deleting)

动手操作节点和关系箭头（选择/编辑/移动/删除）

You use the select tool (with the four “grabbers”) whenever you want to select an existing object (node or edge) There are three reasons why you would want to do that:

任何时候，你都可以利用选择工具（带有四个黑点的）选择已经画在绘画面板上面的对象（包括节点与关系箭头），这样做有三个目的：

• to move a node (by dragging it to the new position)

• 移动一个节点（通过按住节点移动到新的地方）

• to delete a node or edge (by hitting DELETE, selecting Edit→Delete from the menu, or using the convenient icon on the side bar)

• 删除一个节点或者一个关系箭头（通过选择一个对象，让后选择"Edit –Delete”删除对象，或者直接点击侧边栏的删除图标）

• to change the properties of a node or edge (by right-clicking or double-clicking on it, or by hitting CTRL+ENTER or by selecting Edit→Preferences from the menu or by using the convenient icon on the side bar).

• 改变一个节点或者关系箭头的属性（通过右击或者双击一个对象，或者选择对象后按CTRL+ENTER组合键，或者选择对象以后选择"Edit—Preference “，或者之间点击侧边栏的快捷图标）

When you edit the properties of a node or edge, a property popup appears. It lists the properties of the objects in a table. Each property has a name and a value. For example, the Note node has a property whose name is “color” and whose value is a color value. When you edit the value field, the value in the diagram is instantly updated.

当你试图编辑一个节点或者关系箭头的属性的时候会弹出一个对话框，这个对话框列出了这个对象的所有属性值，每一个属性都是一个键值对。例如，Note节点拥有一个属性叫做 "Color”，他的值是一个可以选择的颜色值。当你改变了对象的键值对，在UML图里面的对象也会同时更新。

Yes, we encourage you to save your diagrams!

我们提倡你去保存自己的UML图

When you are done with a diagram, save it with the "File→Save", "File→Save as" menu option or even by hitting CTRL+S. You can give it any name you like, but we recommend you keep an extension .violet. Each diagram file has it's own file extension. This allows you to recognize which kind of diagram corresponds to which file. So, we have :

当你编辑好自己的UML图以后，可以通过"File—Save”或"File—Save as”或按"CTRL+S“保存，你可以给他取任何名字，但是我们建议你保证扩展名为.violet并且给每个文件加一个自己的文件后缀，这个可以让你以后方便的识别每个文件是什么类型的文件。我们的保存文件名应该像这样：

 

• .ucase.violet 后缀的文件是用例图；
• .class.violet 后缀的文件是类图；
• .object.violet后缀的文件是对象图；
• .state.violet 后缀的文件是状态图；
• .activity.violet 后缀的文件是活动图；
• .seq.violet 后缀的文件是顺序图；

 

Export diagrams to your favorite word processor

导出已经制作完毕的UML图到你最喜欢的文字处理软件里面

To include a diagram in a document, export to the clipboard with the "File→To clipboard" menu or by using the camera tool on the side bar. You can also export your diagrams to PNG or JPEG format with the "File→Export Image" menu.

要在一个文档中包含UML图，可以通过"File—To clipboard”或者点击侧边栏的照相图标先把UML图复制到粘贴板，然后再在文档中粘贴。你还可以通过"File—Export”将UML图导出问 PNG 或 JPEG 格式的图片。

Tips

提示：

Tip 01 : If you use Violet in a classroom setting, you may want to use the View→Zoom menu option. You can zoom in or out of the diagram. Zooming only affects the diagram display, not the size of saved images.

提示1：如果你是在教室里面使用Violet作教学用途的话，你可以通过"View--Zoom”放大或者缩小UML图。放大或缩小仅仅对UML图的显示有影响，不影响导出文件的大小。

Tip 02 : There's no tip here. This is just to thank you for having spending a few minutes on this user guide.

提示2：提示2不是提示，仅仅是对你花费好几分钟阅读这个用户指南表示感谢，谢谢。

---EOF---

View original user guider by click here.