因爲工作需要，我在使用LaTeX編輯文件時經常要繪製UML圖形。雖然目前LaTeX有一些宏包支持繪製UML圖形，但總有這樣那樣的小問題，使用起來不是那麼滿意，所以想自己創建一個專門的宏包來繪製UML圖形。一方面可以加深對LaTeX的瞭解，另一方面也給工作上帶來便利。
LaTeX宏包中的TikZ繪圖宏包，功能很強大，LaTeX編輯的文檔中很多都用其來繪製圖形，所以我自然也以此宏包爲基礎來編寫。本項目是從2019年1月1日在電腦上開始的，傳入騰訊雲開發者平臺是2019年1月3日開始，地址是lakeside-tikz-uml項目。有興趣的朋友可以去看看。我學習使用LaTeX的時間還很短，所以在編寫中會存在許多不足之處，請予指正。
從今天開始我將陸續在51CTO博客中記錄下開發過程中遇到的問題、解決辦法，以及一些心得體會。有興趣的朋友可以發郵件與我一起交流，
1. LaTeX宏包的編寫格式
\NeedsTeXFormat{LaTeX2e}[2007/10/19]%
\ProvidesPackage{lakeside-tikz-uml}[2019/01/01]%
% 需求的宏包
\RequirePackage{tikz}% 繪圖包
\RequirePackage{xcolor}% 色彩包
\RequirePackage{calc}% 計算包
\RequirePackage{ifthen}% 條件包
... 一開始我習慣性的在日期中使用減號，結果報錯，後面才注意到是日期分隔符的問題。宏包文件的擴展名是sty。
2. 靈活使用pgfkeys功能
通過在網上看別人寫的代碼，瞭解到pgfkeys的使用方法。目前，我就是把pgfkeys當作字符串函數來用，使用方法是先定義關鍵字（可設置默認值），然後讀取用戶輸入的字符流，再從中提取指定關鍵字的內容，示例如下：
\pgfkeys{%
/keys/.cd,%
name/.initial = #2,% 類名，默認與顯示名稱一樣
attr/.initial =,% 屬性
meth/.initial =,% 方法
...
}這個是存放需要使用的關鍵字，其中/keys/.cd這一行是默認起始代碼，並不是要使用的關鍵字，必須有，keys可以用其他名字代替。
% ------ 定義key設置命令 ------
\newcommand{\setKeys}[1]{%
\pgfkeys{/keys/.cd,#1}%
}%這裏定義一個命令（我更願意把其稱爲函數）：\setKeys。作用就是讀取用戶輸入的字符串，例如：\setKeys{name = employee}。
% ------ 定義key獲取命令 ------
\newcommand{\getKeys}[1]{%
\pgfkeysvalueof{/keys/#1}%
}% 這裏定義命令：\getKeys。實際上就是從前面讀入的字符串中提取指定的關鍵字對應的內容，例如：\getKeys{name}。結果就是把employee提取出來了。
3. 靈活使用ifthen宏包
有了這個宏包，我們就可以進行邏輯判斷了，內容請看相關參考文檔，這裏發一份示例：
\ifthenelse{\equal{}{\getKeys{above right}}}{}{\renewcommand{\relativePosion}{above right}}%
4. rectangle split形狀的最小高度問題
rectangle split形狀分爲橫排與豎排兩種方式，默認是豎排。豎排情況下，最小高度參數minimum height無效。一般情況下，我們只是在簡單類下需要設定最小高度，這種情況下圖形只有一層，所以我的處理辦法就是把排列方式設置成橫排，然後最小高度參數就有效了。
5. 默認配色方案
我選用的默認配色方案是參照Rational Rose上面的，但在使用中可以完全自己設置，例如下面示例中的代碼與效果。
現在只是寫完了類圖的繪製代碼，下面放上示例代碼與效果圖：
% 51CTO 陸巍的博客
\documentclass{article}%
\usepackage{geometry}%
% 漢字支持
\usepackage{xeCJK}%
% 我的UML繪圖宏包
\usepackage{/mydata/my_opensource/lakeside-tikz-uml/lakeside-tikz-uml}%
%
%
\begin{document}%
\begin{tikzpicture}%
\umlClass[%
draw = red,%
text color = red!50!black,%
part1 fill = red!30!white,%
part2 fill = red!20!white,%
part3 fill = red!10!white,%
name = employee,%
attr = - name\\ - age,%
meth = + setName()\\ + getName()\\ + setAge()\\ + getAge(),%
]{Development Employee}%
\umlClass[%
right = 2cm of employee,%
draw = green,%
text color = green!50!black,%
part1 fill = green!30!white,%
part2 fill = green!20!white,%
part3 fill = green!10!white,%
name = addEmployee,%
attr = - name\\ - address,%
meth = + validate()\\ + execute(),%
]{AddEmployee Transaction}%
\umlInterface[%
x = 3cm,%
y = -4cm,%
draw = blue,%
text color = blue!50!black,%
part1 fill = blue!30!white,%
part2 fill = blue!20!white,%
part3 fill = blue!10!white,%
name = addEmployee1,%
meth = + validate()\\ + execute(),%
]{AddEmployee Transaction}%
\umlClass[%
below right = 2cm of addEmployee,%
type = <<anonymous>>\\,%
name = listener,%
]{Document Listener}%
\end{tikzpicture}%
\end{document}%效果如下：
目前，\umlClass類圖繪製命令有22個參數可用，以後慢慢完善。在我的代碼託管倉庫中有說明文檔（也是用LaTeX寫的）。接下來的工作就是編寫關係表示線段的繪製命令。