diff options
author | Karl Berry <karl@freefriends.org> | 2019-01-05 22:40:38 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-01-05 22:40:38 +0000 |
commit | 22536bb2b5257046d271b1eaa11b4a275d5ec041 (patch) | |
tree | 2500eaf5c26b11e00ebd33a64fccfa332cd5a66c /Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex | |
parent | cf794f0e2db6857972a9d48d4466a4f03a7057a0 (diff) |
pgf (5jan19)
git-svn-id: svn://tug.org/texlive/trunk@49607 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex | 495 |
1 files changed, 257 insertions, 238 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex index a01c56b50bc..47bc68db890 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-mindmaps.tex @@ -7,98 +7,106 @@ % % See the file doc/generic/pgf/licenses/LICENSE for more details. + \section{Mindmap Drawing Library} \begin{tikzlibrary}{mindmap} - This packages provides styles for drawing mindmap diagrams. + This packages provides styles for drawing mindmap diagrams. \end{tikzlibrary} + \subsection{Overview} -This library is intended to make the creation of mindmaps or concept -maps easier. A \emph{mindmap} is a graphical representation of a -concept together -with related concepts and annotations. Mindmaps are, essentially, -trees, possibly with a few extra edges added, but they are usually -drawn in a special way: The root concept is placed in the middle of -the page and is drawn as a huge circle, ellipse, or cloud. The related -concepts then ``leave'' this root concept via branch-like tendrils. - -The mindmap library of \tikzname\ produces mindmaps that look a bit -different from the standard mindmaps: While the big root concept is -still a circle, related concepts are also depicted as (smaller) -circles. The related concepts are linked to the root concept via -organic-looking connections. The overall effect is visually rather -pleasing, but readers may not immediately think of a mindmap when they -see a picture created with this library. - -Although it is not strictly necessary, you will usually create -mindmaps using \tikzname's tree mechanism and some of the styles and -macros of the package work best when used inside trees. However, it is -still possible and sometimes necessary to treat parts of a mindmap as -a graph with arbitrary edges and this is also possible. +This library is intended to make the creation of mindmaps or concept maps +easier. A \emph{mindmap} is a graphical representation of a concept together +with related concepts and annotations. Mindmaps are, essentially, trees, +possibly with a few extra edges added, but they are usually drawn in a special +way: The root concept is placed in the middle of the page and is drawn as a +huge circle, ellipse, or cloud. The related concepts then ``leave'' this root +concept via branch-like tendrils. + +The mindmap library of \tikzname\ produces mindmaps that look a bit different +from the standard mindmaps: While the big root concept is still a circle, +related concepts are also depicted as (smaller) circles. The related concepts +are linked to the root concept via organic-looking connections. The overall +effect is visually rather pleasing, but readers may not immediately think of a +mindmap when they see a picture created with this library. + +Although it is not strictly necessary, you will usually create mindmaps using +\tikzname's tree mechanism and some of the styles and macros of the package +work best when used inside trees. However, it is still possible and sometimes +necessary to treat parts of a mindmap as a graph with arbitrary edges and this +is also possible. \subsection{The Mindmap Style} -Every mindmap should be put in a scope or a picture where the -|mindmap| style is used. This style installs some internal settings. +Every mindmap should be put in a scope or a picture where the |mindmap| style +is used. This style installs some internal settings. \begin{stylekey}{/tikz/mindmap} - Use this style with all pictures or at least scopes that contain a - mindmap. It installs a whole bunch of settings that are useful for - drawing mindmaps. + Use this style with all pictures or at least scopes that contain a mindmap. + It installs a whole bunch of settings that are useful for drawing mindmaps. + % \begin{codeexample}[] \tikz[mindmap,concept color=red!50] \node [concept] {Root concept} child[grow=right] {node[concept] {Child concept}}; \end{codeexample} - The sizes of concepts are predefined in such a way that a - medium-size mindmap will fit on an A4 page (more or less). - \begin{stylekey}{/tikz/every mindmap} - This style is included by the |mindmap| style. Change this style to - add special settings to your mindmaps. + % + The sizes of concepts are predefined in such a way that a medium-size + mindmap will fit on an A4 page (more or less). + % + \begin{stylekey}{/tikz/every mindmap} + This style is included by the |mindmap| style. Change this style to add + special settings to your mindmaps. + % \begin{codeexample}[] \tikz[large mindmap,concept color=red!50] \node [concept] {Root concept} child[grow=right] {node[concept] {Child concept}}; \end{codeexample} - \end{stylekey} + \end{stylekey} - \paragraph{Remark:} Note that |mindmap| redefines |font| sizes and |sibling angle| depending on the current concept level (i.e. inside of |level 1 concept|, |level 2 concept| etc.). Thus, if you need to redefine these variables, use + \paragraph{Remark:} + Note that |mindmap| redefines |font| sizes and |sibling angle| depending on + the current concept level (i.e. inside of |level 1 concept|, + |level 2 concept| etc.). Thus, if you need to redefine these variables, use - |level 1 concept/.append style={font=\small}| + |level 1 concept/.append style={font=\small}| - \noindent or + \noindent or - |level 2 concept/.append style={sibling distance=90}| + |level 2 concept/.append style={sibling distance=90}| - \noindent \emph{after} the |mindmap| style. + \noindent \emph{after} the |mindmap| style. \end{stylekey} \begin{stylekey}{/tikz/small mindmap} - This style includes the |mindmap| style, but additionally changes - the default size of concepts, fonts and distances so that a medium-sized - mindmap will fit on an A5 page (A5 pages are half as large as A4 - pages). Mindmaps with |small mindmap| will also fit onto a standard frame of the |beamer| package. + This style includes the |mindmap| style, but additionally changes the + default size of concepts, fonts and distances so that a medium-sized + mindmap will fit on an A5 page (A5 pages are half as large as A4 pages). + Mindmaps with |small mindmap| will also fit onto a standard frame of the + |beamer| package. \end{stylekey} + \begin{stylekey}{/tikz/large mindmap} - This style includes the |mindmap| style, but additionally changes - the default size of concepts, fonts and distances so that a medium-sized - mindmap will fit on an A3 page (A3 pages are twice as large as A4 - pages). + This style includes the |mindmap| style, but additionally changes the + default size of concepts, fonts and distances so that a medium-sized + mindmap will fit on an A3 page (A3 pages are twice as large as A4 pages). \end{stylekey} + \begin{stylekey}{/tikz/huge mindmap} - This style causes concepts to be even bigger and it is best used with - A2 paper and above. + This style causes concepts to be even bigger and it is best used with A2 + paper and above. \end{stylekey} \subsection{Concepts Nodes} -The basic entities of mindmaps are called \emph{concepts} in -\tikzname. A concept is a node of style |concept| and it must be -circular for some of the connection macros to work. +The basic entities of mindmaps are called \emph{concepts} in \tikzname. A +concept is a node of style |concept| and it must be circular for some of the +connection macros to work. \subsubsection{Isolated Concepts} @@ -106,67 +114,67 @@ circular for some of the connection macros to work. The following styles influence how isolated concepts are rendered: \begin{stylekey}{/tikz/concept} - This style should be used with all nodes that are concepts, although - some styles like |extra concept| install this style automatically. + This style should be used with all nodes that are concepts, although some + styles like |extra concept| install this style automatically. - Basically, this style makes the concept node circular and installs a - uniform color called |concept color|, see below. Additionally, the - style |every concept| is called. + Basically, this style makes the concept node circular and installs a + uniform color called |concept color|, see below. Additionally, the style + |every concept| is called. + % \begin{codeexample}[] \tikz[mindmap,concept color=red!50] \node [concept] {Some concept}; \end{codeexample} - \begin{stylekey}{/tikz/every concept} - In order to change the appearance of concept nodes, you should - change this style. Note, however, that the color of a concept should - be uniform for some of the connection bar stuff to work, so you - should not change the color or the draw/fill state of concepts using - this option. It is mostly useful for changing the text color and - font. - \end{stylekey} - - \begin{key}{/tikz/concept color=\meta{color}} - This option tells \tikzname\ which color should be used for filling - and stroking concepts. The difference between this option and just - setting |every concept| to the desired color is that this option - allows \tikzname\ to keep track of the colors used for - concepts. This is important when you \emph{change} the color between - two connected concepts. In this case, \tikzname\ can automatically - create a shading that provides a smooth transition between the old - and the new concept color; we will come back to this in the next - section. - \end{key} + \begin{stylekey}{/tikz/every concept} + In order to change the appearance of concept nodes, you should change + this style. Note, however, that the color of a concept should be + uniform for some of the connection bar stuff to work, so you should not + change the color or the draw/fill state of concepts using this option. + It is mostly useful for changing the text color and font. + \end{stylekey} + + \begin{key}{/tikz/concept color=\meta{color}} + This option tells \tikzname\ which color should be used for filling and + stroking concepts. The difference between this option and just setting + |every concept| to the desired color is that this option allows + \tikzname\ to keep track of the colors used for concepts. This is + important when you \emph{change} the color between two connected + concepts. In this case, \tikzname\ can automatically create a shading + that provides a smooth transition between the old and the new concept + color; we will come back to this in the next section. + \end{key} \end{stylekey} \begin{stylekey}{/tikz/extra concept} - This style is intended for concepts that are not part of the - ``mindmap tree,'' but stand beside it. Typically, they will have a - subdued color or be smaller. In order to have these concepts appear - in a uniform way and in order to indicate in the code that these - concepts are additional, you can use this style. + This style is intended for concepts that are not part of the ``mindmap + tree'', but stand beside it. Typically, they will have a subdued color or + be smaller. In order to have these concepts appear in a uniform way and in + order to indicate in the code that these concepts are additional, you can + use this style. + % \begin{codeexample}[] \begin{tikzpicture}[mindmap,concept color=blue!80] \node [concept] {Root concept}; \node [extra concept] at (10,0) {extra concept}; \end{tikzpicture} \end{codeexample} - \begin{stylekey}{/tikz/every extra concept} - Change this style to change the appearance of extra concepts. - \end{stylekey} + % + \begin{stylekey}{/tikz/every extra concept} + Change this style to change the appearance of extra concepts. + \end{stylekey} \end{stylekey} \subsubsection{Concepts in Trees} -As pointed out earlier, \tikzname\ assumes that your mindmap is built -using the |child| facilities of \tikzname. There are numerous options -that influence how concepts are rendered at the different levels of a -tree. +As pointed out earlier, \tikzname\ assumes that your mindmap is built using the +|child| facilities of \tikzname. There are numerous options that influence how +concepts are rendered at the different levels of a tree. \begin{stylekey}{/tikz/root concept} - This style is used for the roots of mindmap trees. By adding - something to this, you can change how the root of a mindmap will be - rendered. + This style is used for the roots of mindmap trees. By adding something to + this, you can change how the root of a mindmap will be rendered. + % \begin{codeexample}[] \tikz [root concept/.append style={concept color=blue!80,minimum size=3.5cm}, @@ -174,14 +182,14 @@ tree. \node [concept] {Root concept}; \end{codeexample} - Note that styles like |large mindmap| redefine these styles, so you - should add something to this style only inside the picture. + Note that styles like |large mindmap| redefine these styles, so you should + add something to this style only inside the picture. \end{stylekey} \begin{stylekey}{/tikz/level 1 concept} - The |mindmap| style adds this style to the |level 1| style. This - means that the first level children of a mindmap tree will use this - style. + The |mindmap| style adds this style to the |level 1| style. This means that + the first level children of a mindmap tree will use this style. + % \begin{codeexample}[] \tikz [root concept/.append style={concept color=blue!80}, @@ -192,29 +200,31 @@ tree. child[grow=0 ] {node[concept] {child}}; \end{codeexample} \end{stylekey} + \begin{stylekey}{/tikz/level 2 concept} - Works like |level 1 concept|, only for second level children. + Works like |level 1 concept|, only for second level children. \end{stylekey} + \begin{stylekey}{/tikz/level 3 concept} - Works like |level 1 concept|. + Works like |level 1 concept|. \end{stylekey} + \begin{stylekey}{/tikz/level 4 concept} - Works like |level 1 concept|. Note that there are no fifth and - higher level styles, you need to modify |level 5| directly in such - cases. + Works like |level 1 concept|. Note that there are no fifth and higher level + styles, you need to modify |level 5| directly in such cases. \end{stylekey} \begin{key}{/tikz/concept color=\meta{color}} - We saw already that this option is used to change the color of - concepts. We now have a look at its effect when used on child nodes - of a concept. Normally, this option simply changes the color of the - children. However, when the option is given as an option to the - |child| operation (and not to the |node| operation and also not as - an option to all children via the |level 1| style), \tikzname\ will - smoothly change the concept color from the parent's color to the - color of the child concept. - - Here is an example: + We saw already that this option is used to change the color of concepts. We + now have a look at its effect when used on child nodes of a concept. + Normally, this option simply changes the color of the children. However, + when the option is given as an option to the |child| operation (and not to + the |node| operation and also not as an option to all children via the + |level 1| style), \tikzname\ will smoothly change the concept color from + the parent's color to the color of the child concept. + + Here is an example: + % \begin{codeexample}[] \tikz[mindmap,concept color=blue!80] \node [concept] {Root concept} @@ -222,9 +232,9 @@ tree. child[concept color=orange,grow=0] {node[concept] {Child concept}}; \end{codeexample} - In order to have a concept color which changes with the hierarchy level, a tiny bit of magic is needed: - % FIXME : is this a bug in the software!? The root concept is - % black!? + In order to have a concept color which changes with the hierarchy level, a + tiny bit of magic is needed: +% FIXME: is this a bug in the software!? The root concept is black!? \begin{codeexample}[] \tikz[mindmap,text=white, root concept/.style={concept color=blue}, @@ -234,27 +244,28 @@ tree. child[grow=30] {node[concept] {child}} child[grow=0 ] {node[concept] {child}}; \end{codeexample} + % \end{key} + \subsection{Connecting Concepts} \subsubsection{Simple Connections} -The easiest way to connect two concepts is to draw a line between -them. In order to give such lines a consistent appearance, it is -recommendable to use the following style when drawing such lines: +The easiest way to connect two concepts is to draw a line between them. In +order to give such lines a consistent appearance, it is recommendable to use +the following style when drawing such lines: \begin{stylekey}{/tikz/concept connection} - This style can be used for lines between two concepts. Feel free to - redefine this style. + This style can be used for lines between two concepts. Feel free to + redefine this style. \end{stylekey} -A problem arises when you need to connect concepts after the main -mindmap has been drawn. In this case you will want the connection -lines to lie \emph{behind} the main mindmap. However, you can draw the -lines only after the coordinates of the concepts have been -determined. In this case you should place the connecting lines on a -background layer as in the following example: +A problem arises when you need to connect concepts after the main mindmap has +been drawn. In this case you will want the connection lines to lie +\emph{behind} the main mindmap. However, you can draw the lines only after the +coordinates of the concepts have been determined. In this case you should place +the connecting lines on a background layer as in the following example: \begin{codeexample}[] \begin{tikzpicture} @@ -277,38 +288,43 @@ background layer as in the following example: \subsubsection{The Circle Connection Bar Decoration} -Instead of a simple line between two concepts, you can also add a bar -between the two nodes that has slightly organic ends. These bars are -also used by default as the edges from parents in the mindmap tree. +Instead of a simple line between two concepts, you can also add a bar between +the two nodes that has slightly organic ends. These bars are also used by +default as the edges from parents in the mindmap tree. -For the drawing of the bars a special decoration is used, which is defined -in the mindmap library: +For the drawing of the bars a special decoration is used, which is defined in +the mindmap library: \begin{decoration}{circle connection bar} - This decoration can be used to connect two circles. The start of the - to-be-decorated path should lie on the border of the first circle, - the end should lie on the border of the second circle. The following - two decoration keys should be initialized with the sizes of the circles: - \begin{itemize} - \item |start radius| - \item |end radius| - \end{itemize} - Furthermore, the following two decoration keys influence the decoration: - \begin{itemize} - \item |amplitude| - \item |angle| - \end{itemize} - The decoration turns a straight line into a path that starts on the border of the - first circle at the specified angle relative to the line connecting - the centers of the circles. The path then changes into a rectangle - whose thickness is given by the amplitude. Finally, the path ends - with the same angles on the second circle. - - Here is an example that should make this clearer: + This decoration can be used to connect two circles. The start of the + to-be-decorated path should lie on the border of the first circle, the end + should lie on the border of the second circle. The following two decoration + keys should be initialized with the sizes of the circles: + % + \begin{itemize} + \item |start radius| + \item |end radius| + \end{itemize} + % + Furthermore, the following two decoration keys influence the decoration: + % + \begin{itemize} + \item |amplitude| + \item |angle| + \end{itemize} + % + The decoration turns a straight line into a path that starts on the border + of the first circle at the specified angle relative to the line connecting + the centers of the circles. The path then changes into a rectangle whose + thickness is given by the amplitude. Finally, the path ends with the same + angles on the second circle. + + Here is an example that should make this clearer: + % \begin{codeexample}[] \begin{tikzpicture} [decoration={start radius=1cm,end radius=.5cm,amplitude=2mm,angle=30}] - \fill[blue!20] (0,0) circle (1cm); + \fill[blue!20] (0,0) circle (1cm); \fill[red!20] (2.5,0) circle (.5cm); \filldraw [draw=red,fill=black, @@ -316,75 +332,76 @@ in the mindmap library: \end{tikzpicture} \end{codeexample} - As can be seen, the decorated path consists of three parts and is not really - useful for drawing. However, if you fill the decorated path only, and if you - use the same color as for the circles, the result is better. + As can be seen, the decorated path consists of three parts and is not + really useful for drawing. However, if you fill the decorated path only, + and if you use the same color as for the circles, the result is better. + % \begin{codeexample}[] \begin{tikzpicture} [blue!50,decoration={start radius=1cm, end radius=.5cm,amplitude=2mm,angle=30}] - \fill (0,0) circle (1cm); - \fill (2.5,0) circle (.5cm); + \fill (0,0) circle (1cm); + \fill (2.5,0) circle (.5cm); \fill [decorate,decoration=circle connection bar] (1,0) -- (2,0); \end{tikzpicture} \end{codeexample} - In the above example you may notice the small white line between the - circles and the decorated path. This is due to rounding - errors. Unfortunately, for larger distances, the errors can - accumulate quite strongly, especially since \tikzname\ and \TeX\ are - not very good at computing square roots. For this reason, it is a - good idea to make the circles slightly larger to cover up such - problems. When using nodes of shape |circle|, you can just add the - |draw| option with a |line width| of one or two points (for very - large distances you may need line width up to 4pt). + In the above example you may notice the small white line between the + circles and the decorated path. This is due to rounding errors. + Unfortunately, for larger distances, the errors can accumulate quite + strongly, especially since \tikzname\ and \TeX\ are not very good at + computing square roots. For this reason, it is a good idea to make the + circles slightly larger to cover up such problems. When using nodes of + shape |circle|, you can just add the |draw| option with a |line width| of + one or two points (for very large distances you may need line width up to + 4pt). + % \begin{codeexample}[] \begin{tikzpicture} [blue!50,decoration={start radius=1cm, end radius=.5cm,amplitude=2mm,angle=30}] - \fill (0,0) circle (1cm+1pt); - \fill (2.4,0) circle (.5cm+1pt); + \fill (0,0) circle (1cm+1pt); + \fill (2.4,0) circle (.5cm+1pt); \fill [decorate,decoration=circle connection bar] (1,0) -- (1.9,0); \end{tikzpicture} \end{codeexample} - % FIXME : this paragraph appears to be deprecated: - %Note the slightly strange |outer sep=0pt|. This is needed so that - %the decorated path lies on the border of the filled circle, not on the - %border of the stroked circle (which is slightly larger and this - %slightly larger size is exactly what we wish to use to cover up the - %rounding errors). + % FIXME: this paragraph appears to be deprecated: + %Note the slightly strange |outer sep=0pt|. This is needed so that + %the decorated path lies on the border of the filled circle, not on the + %border of the stroked circle (which is slightly larger and this + %slightly larger size is exactly what we wish to use to cover up the + %rounding errors). \end{decoration} - \subsubsection{The Circle Connection Bar To-Path} -The |circle connection bar| decoration is a bit complicated to -use. Especially specifying the radii is quite bothersome (the -amplitude and the angle can be set once and for all). For this reason, -the mindmap library defines a special to-path that performs the -necessary computations for you. +The |circle connection bar| decoration is a bit complicated to use. Especially +specifying the radii is quite bothersome (the amplitude and the angle can be +set once and for all). For this reason, the mindmap library defines a special +to-path that performs the necessary computations for you. \begin{stylekey}{/tikz/circle connection bar} - This style installs a rather involved to-path. Unlike normal - to-paths, this path requires that the start and the target of the - to-path are named nodes of shape |circle| -- if this is not the case, - this path will produce errors. - - Assuming that the start and the target are circles, the to-path will - first compute the radii of these circles (by measuring the distance - from the |center| anchor to some anchor on the border) and will set - the |start circle| keys accordingly. Next, the |fill| option - is set to the |concept color| while |draw=none| is set. The decoration is - set to |circle connection bar|. Finally, the following style is - included: - \begin{stylekey}{/tikz/every circle connection bar} - Redefine this style to change the appearance of circle connection - bar to-paths. - \end{stylekey} + This style installs a rather involved to-path. Unlike normal to-paths, this + path requires that the start and the target of the to-path are named nodes + of shape |circle| -- if this is not the case, this path will produce + errors. + + Assuming that the start and the target are circles, the to-path will first + compute the radii of these circles (by measuring the distance from the + |center| anchor to some anchor on the border) and will set the + |start circle| keys accordingly. Next, the |fill| option is set to the + |concept color| while |draw=none| is set. The decoration is set to + |circle connection bar|. Finally, the following style is included: + % + \begin{stylekey}{/tikz/every circle connection bar} + Redefine this style to change the appearance of circle connection bar + to-paths. + \end{stylekey} + % \begin{codeexample}[] \begin{tikzpicture}[concept color=blue!50,blue!50,outer sep=0pt] \node (n1) at (0,0) [circle,minimum size=2cm,fill,draw,thick] {}; @@ -393,23 +410,24 @@ necessary computations for you. \path (n1) to[circle connection bar] (n2); \end{tikzpicture} \end{codeexample} - Note that it is not a good idea to have more than one |to| operation - together with the option |circle connection bar| in a single - |\path|. Use the |edge| operation, instead, for creating multiple - connections and this operation creates a new scope for each edge. + % + Note that it is not a good idea to have more than one |to| operation + together with the option |circle connection bar| in a single |\path|. Use + the |edge| operation, instead, for creating multiple connections and this + operation creates a new scope for each edge. \end{stylekey} -In a mindmap we sometimes want colors to change from one concept color -to another. Then, the connection bar should, ideally, consist of a -smooth transition between these two colors. Getting this right using -shadings is a bit tricky if you try this ``by hand,'' so the mindmap -library provides a special option for facilitating this procedure. - -\begin{key}{/tikz/circle connection bar switch color=|from (|\meta{first - color}|) to (|\meta{second color}|)|} - This style works similarly to the |circle connection bar|. The only - difference is that instead of filling the path with a single color a - shading is used. +In a mindmap we sometimes want colors to change from one concept color to +another. Then, the connection bar should, ideally, consist of a smooth +transition between these two colors. Getting this right using shadings is a bit +tricky if you try this ``by hand'', so the mindmap library provides a special +option for facilitating this procedure. + +\begin{key}{/tikz/circle connection bar switch color=|from (|\meta{first color}|) to (|\meta{second color}|)|} + This style works similarly to the |circle connection bar|. The only + difference is that instead of filling the path with a single color a + shading is used. + % \begin{codeexample}[] \begin{tikzpicture}[outer sep=0pt] \node (n1) at (0,0) [circle,minimum size=2cm,fill,draw,thick,red] {}; @@ -418,27 +436,29 @@ library provides a special option for facilitating this procedure. \path (n1) to[circle connection bar switch color=from (red) to (blue)] (n2); \end{tikzpicture} \end{codeexample} + % \end{key} \subsubsection{Tree Edges} -Most of the time, concepts in a mindmap are connected automatically -when the mindmap is built as a tree. The reason is that the |mindmap| -installs a |circle connection bar| path as the |edge from parent path|. Also, the |mindmap| option takes care of things like setting the -correct |draw| and |outer sep| settings and some other stuff. - -In detail, the |mindmap| option sets the |edge from parent path| to a -path that uses the to-path |circle connection bar| to connect the parent node -and the child node. The |concept color| option (locally) changes this -by using |circle connection bar switch color| instead with the -from-color set to the old (parent's) concept color and the to-color -set to the new (child's) concept color. This means that when you -provide the |concept color| option to a |child| command, the color -will change from the parent's concept color to the specified color. +Most of the time, concepts in a mindmap are connected automatically when the +mindmap is built as a tree. The reason is that the |mindmap| installs a +|circle connection bar| path as the |edge from parent path|. Also, the +|mindmap| option takes care of things like setting the correct |draw| and +|outer sep| settings and some other stuff. + +In detail, the |mindmap| option sets the |edge from parent path| to a path that +uses the to-path |circle connection bar| to connect the parent node and the +child node. The |concept color| option (locally) changes this by using +|circle connection bar switch color| instead with the from-color set to the old +(parent's) concept color and the to-color set to the new (child's) concept +color. This means that when you provide the |concept color| option to a |child| +command, the color will change from the parent's concept color to the specified +color. Here is an example of a tree built in this way: - +% \begin{codeexample}[] \begin{tikzpicture} \path[mindmap,concept color=black,text=white] @@ -466,20 +486,19 @@ Here is an example of a tree built in this way: \end{codeexample} - \subsection{Adding Annotations} -An \emph{annotation} is some text outside a mindmap that, unlike an -extra concept, simply explains something in the mindmap. The following -style is mainly intended to help readers of the code see that a node -in an annotation node. +An \emph{annotation} is some text outside a mindmap that, unlike an extra +concept, simply explains something in the mindmap. The following style is +mainly intended to help readers of the code see that a node in an annotation +node. \begin{stylekey}{/tikz/annotation} - This style indicates that a node is an annotation node. It includes - the style |every annotation|, which allows you to change this style - in a convenient fashion. + This style indicates that a node is an annotation node. It includes the + style |every annotation|, which allows you to change this style in a + convenient fashion. + % \begin{codeexample}[] - \begin{tikzpicture} [mindmap,concept color=blue!80, every annotation/.style={fill=red!20}] @@ -489,13 +508,13 @@ in an annotation node. {The root concept is, in general, the most important concept.}; \end{tikzpicture} \end{codeexample} - \begin{stylekey}{/tikz/every annotation} - This style is included by |annotation|. - \end{stylekey} + % + \begin{stylekey}{/tikz/every annotation} + This style is included by |annotation|. + \end{stylekey} \end{stylekey} - %%% Local Variables: %%% mode: latex %%% TeX-master: "pgfmanual-pdftex-version" |