summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/ditaa/ditaa.tex
blob: 9a3520c685f3c7a1a1080ebc6fc69379cbfd8562 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
\documentclass[pagesize=auto]{scrartcl}

\addtokomafont{title}{\rmfamily}

\title{The \textsf{ditaa} package}
\author{Hiroshi Ukai}
\date{2018/10/18}


\usepackage{verbatim}
\def\imagepath{./resources}
\usepackage[imagepath=\imagepath]{ditaa}
\graphicspath{ {\imagepath/} }

\begin{document}

\maketitle

\noindent
The \LaTeX\ \textsf{ditaa} package renders your ascii art inside your LaTeX files into pretty image files which you can use them in your papers.

\minisec{Usage:}
To \texttt{usepackage} \textbf{ditaa}, typically do following.
\begin{verbatim}
  \def\imagepath{./resources}
  \usepackage[imagepath=\imagepath]{ditaa}
  \graphicspath{ {\imagepath/} }
\end{verbatim}

A vaiable \texttt{\textbackslash imagepath} points a directory that your images reside.
Under it, you need to create a directory \texttt{ditaa} in advance.
In this directory, \texttt{ditaa} environment creates its working files.

\minisec{Features:}
%
This is a ditaa diagram example.
\begin{verbatim}
  \begin{ditaa}[8cm]{ditaa caption example}{ditaaexample}
    +--------+   +-------+    +-------+
    |        | --+ ditaa +--> |       |
    |  Text  |   +-------+    |diagram|
    |Document|   |!magic!|    |       |
    |     {d}|   |       |    |       |
    +---+----+   +-------+    +-------+
        :                         ^
        |       Lots of work      |
        +-------------------------+
  \end{ditaa}
\end{verbatim}

The fragment above will be rendered into following diagram.

\begin{ditaa}[8cm]{ditaa caption example}{ditaaexample}
  +--------+   +-------+    +-------+
  |        | --+ ditaa +--> |       |
  |  Text  |   +-------+    |diagram|
  |Document|   |!magic!|    |       |
  |     {d}|   |       |    |       |
  +---+----+   +-------+    +-------+
      :                         ^
      |       Lots of work      |
      +-------------------------+
\end{ditaa}
\pagebreak
And you can specify image width like this Figure.\ref{fig:ditaaexample2}.

\begin{verbatim}
  \begin{ditaa}[6cm]{ditaa caption example2}{ditaaexample2}
    +---------+
    | cBLU    |
    |         |
    |    +----+
    |    |cPNK|
    |    |    |
    +----+----+
  \end{ditaa}
\end{verbatim}

To denote your diagram, you can do

\begin{verbatim}

  Figure~\ref{fig:ditaaexample2}

\end{verbatim}

, where \texttt{ditaaexample2} is the second argument you gave to the \texttt{ditaa} environment as you see above.
The prefix \texttt{fig:} is given by \texttt{ditaa} environment automatically.

\begin{ditaa}[6cm]{ditaa caption example2}{ditaaexample2}
  +---------+
  | cBLU    |
  |         |
  |    +----+
  |    |cPNK|
  |    |    |
  +----+----+
\end{ditaa}

Enjoy!

\minisec{ChangeLog:}
%
\begin{labeling}[\hspace{\labelsep}--]{0.9}
\item[0.9] Preparation for first \textsf{ditaa} release.
\end{labeling}

\end{document}