上層選單 Top level menus

下面來介紹每個選單內的項目和用途。

(The menus accessible from the BOUML's window are :)

專案選單 Project menu :

這個專案選單內包含了新增、載入、儲存、另存新檔、列印目前的圖表、關閉專案或是離開bouml這些功能。而最下面的則是歷史記錄，這邊包含了之前所有開啟的專案。如果編輯過的專案，在離開前都會出現是否儲存的對話方塊來選擇是否存檔。

The Project menu allows to create a new project, load a project, save it in place or in a new location, print the current diagram, close the project, or quitbouml. The bottom of the menu contains the historic, the upper line correspond to last opened project, for instance the current one. When you try to close a modified project, perhaps to load an other one, BOUML ask for a saving.

我們可以指定一個範本當作是每次建立新專案的範本，而這個範本的路徑是設定在Miscellaneouse下的set environmen環境設定檔裡面。設定這個範本的目的其實就只是不想採取預設的設定值，所以我們可以變更整個專案的預設值之後儲存成一個範本專案，之後就利用這個範本專案來新建專案，這樣就不用每次都需要重新設定所多的設定值。說穿了，其實就只是把你這個範本另存新檔罷了XD。

You can create a project from a template project if this one is defined through the environment dialog. The goal is to get the settings from this project (probably empty) rather than to get the default settings I decide to set. In this case, when you choose create from template the specified project is load and asave-as is automatically done.

視窗選單 Windows menu :

在這個視窗選單中，可以用來選擇從左邊瀏覽器中開啟的的圖檔，選單中也提供了幾種方式，可以來排列這些開啟的圖檔。

The Windows menu allows to select an opened diagram or change the sub-windows disposition.

工具選單 Tools menu :

重點來了，這個工具選單提供了不少有用的工具，像是可以把專案輸出成HTML的文件檔，或是HTML的說明檔。也可以直接產生程式碼。當執行這些外掛工具時，會開啟一個追蹤視窗，而這些外掛會將執行的過程都顯示在這個追蹤視窗中，好方便查詢執行的結果。在專案中執行某個外掛，會根據左邊瀏覽列中目前所選擇的項目來更新。如果要增加 / 移除 / 更改已知的外掛清單，請參考 plug-out 或是載入在其它專案中所定義的外掛清單。

The Tools menu allows to (re)open the trace window where the plug-outs write their messages, to apply a plug-out on the project (independently of the browser item currently selected), to add/remove/modify the known plug-outs list (see plug-out), or to import the plug-outs list defined in an other project.

語言選單 Language menu :

這個語言清單允許詢問BOUML是否產生一個預設的定義/宣告(參考 the C++ generation, Java generation, Php generation,Python generation and Idl generation)。當左邊瀏覽器的一個項目被建立時，選擇那一個語言視窗會經由tabs來顯示。這個選單也允許在原始碼產生的期間，是否更新操作的內容(參考 the C++ generation, Java generation, Python generation and Php generation)。經由一個外部編輯器(refer to operation edition)來編輯一個操作的內容，是否產生操作的profile檔案。

(這一段很怪…沒錯…不過大爺其實是邊學邊翻…所以這個部份我也還沒看到…等之後看到了再回來修正吧 XD)

The Languages menu allows to ask BOUML to produce or not a default definition/declaration (refer to the C++ generation, Java generation, Php generation,Python generation and Idl generation) when a browser item is created, and to select for which language(s) the dialogs shown through tabs. This menu also allows to update or not the body of the operation during the code generation (refer to the C++ generation, Java generation, Python generation and Php generation), to produce or not the operation's profile when you edit an operation's body through an external editor (refer to operation edition).

其它選單 Miscellaneous menu :

其它選單可以設定stereotypes是否顯示在瀏覽器中、對話方塊中的自動完成或是搜尋相關的選擇清單、變更視窗顯示的樣式，字型的大小、圖型預設的格式，編輯快速鍵、設定stereotypes關聯圖示的根目錄和設定一些系統環境變數。

The Miscellaneous menu allows to show/hide the stereotypes in the browser, to ask for to have or not an auto completion/search in the lists of choices in the dialogs, to change the used style, to change the size of the font, to set the default diagram format, to edit the shortcuts, to a specify a root directory for the icons associated to the stereotypes or directly put indiagrams and to set some environment information.

注意，如果變更字型沒有正確顯示，就代表該字型沒辨法使用。大致上來說是因為在linux和windows的大小是不太相同，這也許會導致一些物件的相對位置和一些圖形的垂直位置有些差別。然後因為在linux和windows下的字型不太一樣，一個圖形可能會在兩個作業系統下顯示不一樣的結果。而這些大小是記錄在專案和檔案中。Bouml允許改變字型的大小，就算是唯讀檔也是，只是這些新的字型大小無法儲存下來。

Note that sometimes changing the size of the base font does nothing because the desired font is not available. I had introduced this feature mainly because the default size under Linux and Windows is not the same, this may change the relative position of the objects and a relation drawn vertically with one font will be inclined with an other. Nevertheless because the fonts under Linux and Windows are not strictly the same, a diagram can't have the same aspect under the two operating systems. This size is memorized in the file memorizing the project, but BOUML allows to change the font size even when the file is read only (the new font size can't be saved).

編輯快速鍵 Shortcut edition

選擇「編輯快速鍵」項目之後就會看見下面這個視窗：

When you select Edit shortcuts a dialog appears :

一般來說快速鍵都是一個鍵再搭配上一些特殊鍵，像是shift, control and alt這些特殊鍵，在蘋果電腦的話會用 ()鍵來取代control。一些比較舊型的鍵盤可能會用 alt 來命名option鍵。

A shortcut is a key and the optional modifiers shift, control and alt. Under MacOS X control is replaced by the apple () and alt is named option on the old keyboards.

可以看到這個視窗分成2個tab，第一個tab，也就是Command這個tab，用來定義快鍵速，用滑鼠點選command欄位，會出現下拉式選單，裡面包含了可以設定快速鍵的一些屬性。key的欄位也是用滑鼠點一下就會出現一些選項可以選擇。也在前面的照片可以看到一些預設的快速鍵。

This first tab allows to define shortcuts to apply a command on the selected element(s). The available commands are proposed on a mouse click in the column command, their correspond to the menu entries. In the previous picture you see the default shortcuts.

第二個tab，也就是Tool這個tab，是用來定義外掛的快速鍵。

The second tab allows to define shortcuts to apply a plug-out :

外掛的快速鍵是由一些外掛的編輯器所提供。只要在tool display的欄位上面點一下，一樣會出現可以選擇的下拉式選單。

A plug-out is specified by its display specified through the plug-out editor. The available plug-outs are proposed on a mouse click in the column tool display.

而最後一個do的欄位，用滑鼠點選之後，會出現功能列，上面可以選擇複製/剪下/貼上/或插入新的一行。

As usual the last column do allows to copy/past/cut/insert line and applies on the line where you did the mouse click.

環境設定 Environment settings

如果要更改原本設定在第一欄的識別碼，需要在還沒有載入專案的時候更改，一但載入專案就無法更改此欄位的設定值。

You can't change you own identifier while a project is load, this means to change it start the modeler with loading a given project.

在下載的windows版本裡面有一個包含安裝說明檔的版本，建議是安裝這個版本，因為這個安裝說明檔會隨著版本更新而更新，而且也會安裝在doc的這個目錄下。

要手動安裝說明檔的話，直接到官方網站下載說明檔，並且解壓縮，然後在環境設定的Manual這個選項指定剛才解壓縮的那個目錄，這樣一來就能用在系統中按F1來執行說明檔。

Under Windows one setup installs Bouml with the manual and the other without. I recommend to use the setup installing the documentation each time the documentation is updated, and it is placed under the directory doc. In the other cases the documentation may depend on how the packaging is made for your distribution, but in all the cases you can directly extract the archive to install the HTML documentation then indicate where it is.

也可以安裝其它的語系檔來變更選單和視窗的語言，像是fr.lang就是法文的語系檔。有一些全域的選單是無法改變的，還有一些已經開啟的視窗的按鈕底下的描述也是無法改變的。如果要正確的顯示語系檔，就必需選擇該語系字元集才有辨法正確的顯示。在我們的例子就是要在Charater set這個欄位選擇Big5來正確的顯示繁體中文。

如果你願意幫忙翻譯新的語系的話，可以寫信告訴我，我會寄給你一隻用來翻譯的小工具並且告訴你該怎麼使用。注意：翻譯超過2000行的句字是項辛苦的工作。

To specify a translation file allows to use a language different than the English for the menus and dialogs, for instance fr.lang allows to use the modeler in French. Note : when you change the language some global menus are unchanged and the description of buttons of already opened diagram too, to follow the new language for all exist then restart the modeler. If you choose a language needing a non latin-1 character set you also have to specify the right character set. If you are volunteer to add a new translation prevent me and I will send you the small tool I made for that and how to do, remark I do not deny that it is quite laborious to translate more that 2000 sentences.

圖示列 Icons bar

這些按鈕允許你去：

*開啟專案

*儲存專案

*列印目前的圖檔。第一個選單是設定使用的印表機或是列印至檔案中，並且設定一些屬性。按下確定後，會詢問你是要列印1頁、4頁還是9頁。

*搜尋。可以輸入項目的名字、典型記號(stereotypes)和一些相關的東西。或者是搜尋在定義/宣告或是操作內容中的一個字串。

*導覽 顯示在瀏覽器中最後一個選擇的歷史項目。

*描述 點選這個按鈕後，在其它的按鈕或是選單項目上面再按一下，可以顯示該按鈕或是選單的提示說明。

These buttons allow to :

• open a project

• save the current project

• print the active diagram, a first menu appears to choose the printer or print in a file ans set properties, then a second dialog ask you to print the diagram on 1, 4 or 9 pages

• search for an elements through their names or stereotypes and may be kins, or to search for a string in the declarations/definitions or operation bodies :

• navigate in the historic of the last selected elements in the browser

• describe the behavior of a button or a menu entry, for that hit the button then the desired button or select a menu entry, a short description will be given. When you maintain the mouse on a button a very small description also appears.