1 #LyX 2.2 created this file. For more info see http://www.lyx.org/
5 \origin /systemlyxdir/examples/
12 % set fonts for nicer pdf view
13 \IfFileExists{lmodern.sty}
14 {\usepackage{lmodern}}{}
16 \fi % end if pdflatex is used
18 % increase link area for cross-references and autoname them,
19 \AtBeginDocument{\renewcommand{\ref}[1]{\mbox{\autoref{#1}}}}
20 \@ifundefined{extrasenglish}{\usepackage[english]{babel}}{}
21 \addto\extrasenglish{%
22 \renewcommand*{\equationautorefname}[1]{}%
23 \renewcommand{\sectionautorefname}{sec.\negthinspace}%
24 \renewcommand{\subsectionautorefname}{sec.\negthinspace}%
25 \renewcommand{\subsubsectionautorefname}{sec.\negthinspace}%
28 \options BCOR8mm, most, usenames, dvipsnames
29 \use_default_options false
33 \maintain_unincluded_children false
35 \language_package default
40 \font_typewriter default
42 \font_default_family default
43 \use_non_tex_fonts false
49 \default_output_format default
51 \bibtex_command bibtex
52 \index_command default
56 \pdf_title "Description of the module tcolorbox"
57 \pdf_author "Uwe Stöhr"
58 \pdf_subject "fancy colored boxes"
59 \pdf_keywords "LyX, tcolorbox, colored boxes"
61 \pdf_bookmarksnumbered true
62 \pdf_bookmarksopen true
63 \pdf_bookmarksopenlevel 3
68 \pdf_pdfusetitle false
69 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, urlbordercolor={1 0 0}"
72 \use_package amsmath 1
73 \use_package amssymb 1
76 \use_package mathdots 1
77 \use_package mathtools 1
79 \use_package stackrel 0
80 \use_package stmaryrd 0
81 \use_package undertilde 0
83 \cite_engine_type default
87 \paperorientation portrait
91 \notefontcolor #0000ff
98 \paragraph_separation skip
100 \quotes_language english
103 \paperpagestyle default
104 \tracking_changes false
105 \output_changes false
108 \html_be_strict false
114 Description of the module Fancy Colored Boxes
121 \begin_layout Standard
134 you have access to a huge variety of colored boxes.
135 They are particularly useful for presentations or educational texts where
136 you might for example highlight results or equations.
137 This document describes how these boxes are used with \SpecialChar LyX
141 \begin_layout Standard
142 The fancy boxes are generated by the \SpecialChar LaTeX
148 This package has so many features so that its manual exceeds 400
154 can therefore only provide access to its basic features.
155 For more advanced features and examples have a loot at the
160 \begin_inset CommandInset citation
169 \begin_layout Section
173 \begin_layout Standard
174 At first load the module
186 in the document settings of your file.
189 \begin_layout Standard
190 Add the following options to the document class options in the document
191 settings of your file:
194 \begin_layout Standard
197 most, usenames, dvipsnames
200 \begin_layout Standard
205 loads most of the libraries of the \SpecialChar LaTeX
215 load additional colors, see Appendix
230 \begin_layout Section
234 \begin_layout Subsection
238 \begin_layout Subsubsection
242 \begin_layout Standard
243 A static color box is inserted via the menu
245 Insert\SpecialChar menuseparator
246 Custom Insets\SpecialChar menuseparator
256 \begin_layout Standard
257 This is a static color box:
258 \begin_inset Flex Color Box
261 \begin_layout Plain Layout
270 \begin_layout Standard
271 It has by default a frame with round corners and consumes the full text
273 It can contain several paragraphs and math.
276 \begin_layout Standard
277 \begin_inset Note Greyedout
280 \begin_layout Plain Layout
285 the box can contain forced page breaks but they will be ignored.
286 To get breakable boxes, see
287 \begin_inset CommandInset ref
289 reference "sec:Beakable-boxes"
301 \begin_layout Subsubsection
305 \begin_layout Standard
306 A dynamic color box is inserted via inset via the menu
308 Insert\SpecialChar menuseparator
309 Custom Insets\SpecialChar menuseparator
323 \begin_layout Standard
324 This is a dynamic color box:
325 \begin_inset Flex Dynamic Color Box
328 \begin_layout Plain Layout
337 \begin_layout Standard
338 In contrary to static boxes dynamic boxes cannot have parts, they cannot
339 made breakable but one can set their vertical placement, see
340 \begin_inset CommandInset ref
342 reference "subsec:Vertical"
347 Their width is by default the width of the content.
350 \begin_layout Subsubsection
354 \begin_layout Standard
355 A fit color box insert is inserted via the menu
357 Insert\SpecialChar menuseparator
358 Custom Insets\SpecialChar menuseparator
372 \begin_layout Standard
373 Fit boxes are dynamic boxes but their content is automatically decreased
374 or increased to fit into the specified box width and heigh.
375 How to specify a width and height is described in
376 \begin_inset CommandInset ref
378 reference "subsec:Geometry"
383 If no width and height is specified the result is a square box consuming
384 the full available width of the page.
385 If only a width is specified, the result is a square box.
388 \begin_layout Standard
389 This is a fit color box:
392 \begin_layout Standard
393 \begin_inset Flex Fit Color Box
396 \begin_layout Plain Layout
397 \begin_inset Argument 1
400 \begin_layout Plain Layout
407 \begin_inset space \thinspace{}
410 cm wide fit color box with some text.
412 \begin_inset space \thinspace{}
415 cm wide fit color box with some text.
417 \begin_inset space \thinspace{}
420 cm wide fit color box with some text.
428 \begin_layout Standard
429 Another fit color box:
430 \begin_inset Flex Fit Color Box
433 \begin_layout Plain Layout
434 \begin_inset Argument 1
437 \begin_layout Plain Layout
438 width=5cm, height=3cm
444 \begin_inset space \thinspace{}
448 \begin_inset space \thinspace{}
451 cm high fit color box.
459 \begin_layout Standard
460 The examples show that the text will be shrinked to fit into the box but
461 it will not be increased.
464 \begin_layout Subsubsection
468 \begin_layout Standard
469 A custom color box is inserted via the menu
471 Insert\SpecialChar menuseparator
472 Custom Insets\SpecialChar menuseparator
483 where # is the number.
486 \begin_layout Standard
487 How to use and customize the custom color boxes, see
488 \begin_inset CommandInset ref
490 reference "subsec:General"
497 \begin_layout Subsection
501 \begin_layout Standard
502 To add a title to a box add an options inset via the menu Insert\SpecialChar menuseparator
516 followed by your title.
519 \begin_layout Standard
520 This is a titled box:
521 \begin_inset Flex Color Box
524 \begin_layout Plain Layout
525 \begin_inset Argument 1
528 \begin_layout Plain Layout
534 A basic box with a title.
542 \begin_layout Standard
543 A subtitle is added with the inset
549 Insert\SpecialChar menuseparator
555 \begin_layout Standard
556 \begin_inset Flex Color Box
559 \begin_layout Plain Layout
560 \begin_inset Argument 1
563 \begin_layout Plain Layout
569 A basic box with a subtitle.
571 \begin_inset Flex Subtitle
574 \begin_layout Plain Layout
580 The content below the subtitle.
588 \begin_layout Standard
589 The title and subtitle text is by default white.
590 How to change its color, see
591 \begin_inset CommandInset ref
593 reference "subsec:Title-text"
600 \begin_layout Subsection
604 \begin_layout Standard
605 The content of the box can be divided into an upper and a lower part with
606 by using the environment
611 's environment selection combobox.
612 The idea behind this is that both parts can be treated and customized separatel
614 An example would be where the upper part contains a description and the
615 lower part an equation.
618 \begin_layout Standard
619 This is a box where the content is separated:
622 \begin_layout Standard
623 \begin_inset Flex Color Box
626 \begin_layout Plain Layout
630 \begin_layout Color Box Separator
634 \begin_layout Plain Layout
643 \begin_layout Standard
644 The separation line can be customized as described in
645 \begin_inset CommandInset ref
647 reference "subsec:Lines"
654 \begin_layout Standard
655 The separation can also be made side by side with the box option
662 \begin_layout Standard
663 \begin_inset Flex Color Box
666 \begin_layout Plain Layout
667 \begin_inset Argument 1
670 \begin_layout Plain Layout
676 Upper content at the left
679 \begin_layout Color Box Separator
683 \begin_layout Plain Layout
684 Lower content at the right
692 \begin_layout Standard
693 The separation can be made invisible with the box option
695 lower separated=false
700 \begin_layout Standard
701 \begin_inset Flex Color Box
704 \begin_layout Plain Layout
705 \begin_inset Argument 1
708 \begin_layout Plain Layout
709 sidebyside, lower separated=false
714 Upper content invisibly separated
717 \begin_layout Color Box Separator
721 \begin_layout Plain Layout
722 Lower content at the right
730 \begin_layout Standard
731 There are several layout skins available for colored boxes, see
732 \begin_inset CommandInset ref
734 reference "subsec:Beamer"
738 , that affects also the layout of the box parts.
739 For example with the box option
743 the box parts are separated this way:
746 \begin_layout Standard
747 \begin_inset Flex Color Box
750 \begin_layout Plain Layout
751 \begin_inset Argument 1
754 \begin_layout Plain Layout
763 \begin_layout Color Box Separator
767 \begin_layout Plain Layout
776 \begin_layout Subsection
778 \begin_inset CommandInset label
787 \begin_layout Standard
788 To draw a line in a box use the environment
793 The line is by default dashed.
794 it is just a line and does not separate box parts.
797 \begin_layout Standard
798 This is a box where the content is divided:
801 \begin_layout Standard
802 \begin_inset Flex Color Box
805 \begin_layout Plain Layout
809 \begin_layout Color Box Line
813 \begin_layout Plain Layout
822 \begin_layout Standard
823 The line style can be changed with the box option
825 segmentation style={}
830 \begin_layout Standard
831 \begin_inset Note Greyedout
834 \begin_layout Plain Layout
839 The braces and its content must be inserted as \SpecialChar TeX
848 \begin_layout Standard
849 To be able to use this option, the option
853 needs to be added too.
854 Here is an example with a double blue line:
857 \begin_layout Standard
858 \begin_inset Flex Color Box
861 \begin_layout Plain Layout
862 \begin_inset Argument 1
865 \begin_layout Plain Layout
866 enhanced, segmentation style={double=white,draw=blue,double distance=1pt,solid}
874 \begin_layout Color Box Line
878 \begin_layout Plain Layout
887 \begin_layout Standard
888 For more details have a loot at the
893 \begin_inset CommandInset citation
902 \begin_layout Section
904 \begin_inset CommandInset label
906 name "sec:Beakable-boxes"
913 \begin_layout Standard
914 To make a box breakable the option breakable is added.
915 If a page break occurs within a box, the box will get broken this way:
918 \begin_layout Standard
919 \begin_inset Flex Color Box
922 \begin_layout Plain Layout
923 \begin_inset Argument 1
926 \begin_layout Plain Layout
927 title=A breakable box, breakable, title after break=continued...
932 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
933 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
935 At vero eos et accusam et justo duo dolores et ea rebum.
936 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
938 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
939 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
941 At vero eos et accusam et justo duo dolores et ea rebum.
942 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
944 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
945 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
947 At vero eos et accusam et justo duo dolores et ea rebum.
948 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
950 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
951 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
953 At vero eos et accusam et justo duo dolores et ea rebum.
954 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
956 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
957 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
959 At vero eos et accusam et justo duo dolores et ea rebum.
960 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
962 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
963 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
965 At vero eos et accusam et justo duo dolores et ea rebum.
966 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
968 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
969 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
971 At vero eos et accusam et justo duo dolores et ea rebum.
972 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
974 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
975 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
977 At vero eos et accusam et justo duo dolores et ea rebum.
978 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
980 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
981 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
983 At vero eos et accusam et justo duo dolores et ea rebum.
984 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
986 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
987 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
989 At vero eos et accusam et justo duo dolores et ea rebum.
990 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
999 \begin_layout Standard
1000 In the above example the special title
1005 was added for the second page of the box with the option
1012 \begin_layout Standard
1013 If boxes are inside boxes, only the outer box can be made breakable.
1016 \begin_layout Standard
1017 \begin_inset Note Greyedout
1020 \begin_layout Plain Layout
1025 Dynamic boxes and fit boxes cannot be made breakable!
1033 \begin_layout Section
1037 \begin_layout Subsection
1039 \begin_inset CommandInset label
1041 name "subsec:General"
1048 \begin_layout Standard
1049 The following subsections show many possibilities to customize boxes.
1052 \begin_layout Standard
1053 In real documents one wants only a few types of boxes and all boxes of a
1054 type should look identical.
1055 To avoid to write the box commands all the time, you can use the environment
1059 \begin_inset space ~
1063 \begin_inset space ~
1069 It is inserted via \SpecialChar LyX
1070 's style selection combobox.
1071 There you can write all options that should be applied for all boxes of
1077 For example writing there
1079 width=3cm, height=8cm
1081 forces all following boxes to have a height of 8
1082 \begin_inset space \thinspace{}
1086 \begin_inset space \thinspace{}
1092 \begin_layout Standard
1093 This is not useful if one needs several box types since the changes would
1099 Therefore the module
1102 \begin_inset space ~
1106 \begin_inset space ~
1112 \begin_inset space ~
1115 different box types which you can customize.
1116 To change their appearance use the environment
1119 \begin_inset space ~
1123 \begin_inset space ~
1127 \begin_inset space ~
1133 It is inserted via \SpecialChar LyX
1134 's style selection combobox.
1137 \begin_layout Standard
1138 If you want for example a box type that looks like the fancy colored one
1140 \begin_inset CommandInset ref
1142 reference "subsec:Enhanced"
1146 use these options in the environment:
1149 \begin_layout Standard
1152 enhanced, frame style={left color=red!75!black, right color=blue!75!black},
1153 interior style={left color=red!20!white, right color=yellow!50!white}
1156 \begin_layout Standard
1165 (cBoxA is custom box type
1166 \begin_inset space ~
1170 \begin_inset space ~
1174 Because you want to customize every box of this type (e.
1175 \begin_inset space \thinspace{}
1179 \begin_inset space \space{}
1182 every box should have its own title), you need one argument.
1187 into the Arguments inset of the environment.
1190 \begin_layout Standard
1191 \begin_inset Note Greyedout
1194 \begin_layout Plain Layout
1199 If you use an argument, the inset
1203 must also be inserted but left empty!
1211 \begin_layout New Color Box Type
1212 \begin_inset Argument 2
1215 \begin_layout Plain Layout
1222 \begin_inset Argument 3
1225 \begin_layout Plain Layout
1232 \begin_inset Argument 4
1235 \begin_layout Plain Layout
1241 enhanced, frame style={left color=red!75!black, right color=blue!75!black},
1242 interior style={left color=red!20!white, right color=yellow!50!white},
1246 \begin_layout Standard
1250 \begin_inset space ~
1254 \begin_inset space ~
1258 \begin_inset space ~
1263 will look like this:
1266 \begin_layout Standard
1267 \begin_inset Flex Custom Color Box 1
1270 \begin_layout Plain Layout
1271 \begin_inset Argument 1
1274 \begin_layout Plain Layout
1288 \begin_layout Standard
1289 \begin_inset VSpace bigskip
1293 \begin_inset Newline newline
1296 Assuming you need a box type that can be numbered, you insert
1299 \begin_layout Standard
1302 auto counter, number within=section
1305 \begin_layout Standard
1317 \begin_inset space ~
1321 \begin_inset space ~
1325 \begin_inset space ~
1348 \begin_layout Standard
1351 colback=red!5!white, colframe=red!75!black, title=Example~
1356 \begin_layout Standard
1357 into the environment.
1358 This predefines a title prefix.
1365 is hereby the counter of colored boxes.
1369 \begin_inset space ~
1373 \begin_inset space ~
1377 \begin_inset space ~
1382 you specify the title via the options inset:
1385 \begin_layout New Color Box Type
1386 \begin_inset Argument 1
1389 \begin_layout Plain Layout
1390 auto counter, number within=section
1396 \begin_inset Argument 2
1399 \begin_layout Plain Layout
1406 \begin_inset Argument 3
1409 \begin_layout Plain Layout
1416 \begin_inset Argument 4
1419 \begin_layout Plain Layout
1425 colback=red!5!white, colframe=red!75!black, title=Example~
1430 \begin_layout Standard
1432 \begin_inset Flex Custom Color Box 2
1435 \begin_layout Plain Layout
1436 \begin_inset Argument 1
1439 \begin_layout Plain Layout
1440 Custom numbered title
1453 \begin_layout Standard
1454 Note that you must not write
1458 because this is already done in the definition.
1461 \begin_layout Standard
1462 You can still customize the box by adding options
1469 \begin_layout Standard
1470 \begin_inset Flex Custom Color Box 2
1473 \begin_layout Plain Layout
1474 \begin_inset Argument 1
1477 \begin_layout Plain Layout
1478 Bold numbered title, colback=lime, fonttitle=
1493 \begin_layout Standard
1494 \begin_inset VSpace bigskip
1497 At last a more advanced example:
1498 \begin_inset Newline newline
1501 Assuming you need the type we just defined as
1504 \begin_inset space ~
1508 \begin_inset space ~
1512 \begin_inset space ~
1517 but want to add more than one option.
1518 This is for example useful for options that require another option before
1519 in the options list.
1520 \begin_inset Newline newline
1526 \begin_layout Standard
1529 auto counter, number within=section
1532 \begin_layout Standard
1544 \begin_inset space ~
1548 \begin_inset space ~
1552 \begin_inset space ~
1568 \begin_inset space ~
1571 Arguments, the Argument is therefore
1579 \begin_layout Standard
1582 nobeforeafter, width=#1, square, colframe=orange!50!black,
1583 \begin_inset Newline newline
1591 \begin_layout Standard
1592 into the environment.
1596 \begin_inset space ~
1600 \begin_inset space ~
1604 \begin_inset space ~
1609 you specify the width via the
1613 inset and the title (and further options if you like) via the
1615 More Color Box Options
1620 \begin_layout New Color Box Type
1621 \begin_inset Argument 1
1624 \begin_layout Plain Layout
1625 auto counter, number within=section
1631 \begin_inset Argument 2
1634 \begin_layout Plain Layout
1641 \begin_inset Argument 3
1644 \begin_layout Plain Layout
1651 \begin_inset Argument 4
1654 \begin_layout Plain Layout
1660 nobeforeafter, width=#1, square, colframe=orange!50!black, title=Example~
1665 \begin_layout Standard
1666 \begin_inset Flex Custom Color Box 3
1669 \begin_layout Plain Layout
1670 \begin_inset Argument 1
1673 \begin_layout Plain Layout
1680 \begin_inset Argument 2
1683 \begin_layout Plain Layout
1690 \begin_inset space \thinspace{}
1693 cm wide custom color box 3
1699 \begin_inset Flex Custom Color Box 3
1702 \begin_layout Plain Layout
1703 \begin_inset Argument 1
1706 \begin_layout Plain Layout
1713 \begin_inset Argument 2
1716 \begin_layout Plain Layout
1723 \begin_inset space \thinspace{}
1726 cm wide custom color box 3 with the
1738 \begin_layout Subsection
1742 \begin_layout Standard
1743 The \SpecialChar LaTeX
1744 package tcolorbox provides different skins.
1745 For a full list, see the tcolorbox manual, section
1748 \begin_inset space ~
1754 \begin_inset CommandInset citation
1761 Only the most important skins are listed in the following.
1764 \begin_layout Subsubsection
1766 \begin_inset CommandInset label
1768 name "subsec:Enhanced"
1775 \begin_layout Standard
1776 This skin is enabled by adding the option enhanced.
1777 Without further options it looks like the standard skin.
1778 Its advantage are some extra features like the customization of lines,
1780 \begin_inset CommandInset ref
1782 reference "subsec:Lines"
1787 Another feature is a nicer view of breakable boxes:
1790 \begin_layout Standard
1791 \begin_inset Flex Color Box
1794 \begin_layout Plain Layout
1795 \begin_inset Argument 1
1798 \begin_layout Plain Layout
1803 breakable box, breakable, enhanced
1808 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1809 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1811 At vero eos et accusam et justo duo dolores et ea rebum.
1812 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1814 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1815 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1817 At vero eos et accusam et justo duo dolores et ea rebum.
1818 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1820 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1821 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1823 At vero eos et accusam et justo duo dolores et ea rebum.
1824 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1826 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1827 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1829 At vero eos et accusam et justo duo dolores et ea rebum.
1830 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1832 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1833 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1835 At vero eos et accusam et justo duo dolores et ea rebum.
1836 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1838 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1839 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1841 At vero eos et accusam et justo duo dolores et ea rebum.
1842 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1844 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1845 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1847 At vero eos et accusam et justo duo dolores et ea rebum.
1848 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1850 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1851 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1853 At vero eos et accusam et justo duo dolores et ea rebum.
1854 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1856 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1857 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1859 At vero eos et accusam et justo duo dolores et ea rebum.
1860 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1862 Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
1863 eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
1865 At vero eos et accusam et justo duo dolores et ea rebum.
1866 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
1875 \begin_layout Standard
1876 A feature you might like is to add color gradient with the options
1887 frame style={left color=color, right color=color}
1893 is a color name or definition, see
1894 \begin_inset CommandInset ref
1896 reference "subsec:Color"
1903 \begin_layout Standard
1904 \begin_inset Flex Color Box
1907 \begin_layout Plain Layout
1908 \begin_inset Argument 1
1911 \begin_layout Plain Layout
1916 box with a color gradient, enhanced, frame style={left color=red!75!black,
1917 right color=blue!75!black}, interior style={left color=red!20!white, right
1918 color=yellow!50!white}
1926 \begin_layout Color Box Separator
1930 \begin_layout Plain Layout
1939 \begin_layout Standard
1940 Alternatively one can use a PNG image as background for boxes with the option
1943 frame style image=file name
1948 \begin_inset space ~
1953 is the file name of the image.
1956 \begin_layout Subsubsection
1960 \begin_layout Standard
1961 With this skin the lower content gets another background color than the
1965 \begin_layout Standard
1966 \begin_inset Flex Color Box
1969 \begin_layout Plain Layout
1970 \begin_inset Argument 1
1973 \begin_layout Plain Layout
1974 title=A box with the skin
1986 \begin_layout Color Box Separator
1990 \begin_layout Plain Layout
1999 \begin_layout Standard
2000 The color of the lower part can be changed with the option
2006 \begin_inset CommandInset ref
2008 reference "subsec:Color"
2012 for color customization.
2015 \begin_layout Standard
2019 \begin_layout Subsubsection
2021 \begin_inset CommandInset label
2023 name "subsec:Beamer"
2030 \begin_layout Standard
2031 This is a skin that simulates the appearance of the beamer presentation
2033 Its appearance can be changed like for the enhanced skin,
2034 \begin_inset CommandInset ref
2036 reference "subsec:Enhanced"
2043 \begin_layout Standard
2044 \begin_inset Flex Color Box
2047 \begin_layout Plain Layout
2048 \begin_inset Argument 1
2051 \begin_layout Plain Layout
2056 box with a color gradient, beamer, frame style={left color=red!75!black,
2057 right color=blue!75!black}
2065 \begin_layout Color Box Separator
2069 \begin_layout Plain Layout
2078 \begin_layout Subsubsection
2082 \begin_layout Standard
2083 This skin is like the standard skin but the background colors are automatically
2087 \begin_layout Standard
2088 \begin_inset Flex Color Box
2091 \begin_layout Plain Layout
2092 \begin_inset Argument 1
2095 \begin_layout Plain Layout
2108 \begin_layout Color Box Separator
2112 \begin_layout Plain Layout
2121 \begin_layout Subsubsection
2125 \begin_layout Standard
2126 This skin has no colors.
2127 To make the title visible (because it is by default white) you have to
2128 change its color, see
2129 \begin_inset CommandInset ref
2131 reference "subsec:Title-text"
2138 \begin_layout Standard
2139 \begin_inset Flex Color Box
2142 \begin_layout Plain Layout
2143 \begin_inset Argument 1
2146 \begin_layout Plain Layout
2147 title=A box with the
2151 skin, empty, coltitle=orange
2159 \begin_layout Color Box Separator
2163 \begin_layout Plain Layout
2172 \begin_layout Subsection
2176 \begin_layout Subsubsection
2180 \begin_layout Standard
2181 Normally the boxes are a paragraph of its own.
2182 They will therefore appear by default one upon another separated by vertical
2184 To change this behavior to place for example boxes side by side and uses
2185 the placement options
2194 By default there is a paragraph break before and after the box.
2195 By using the options
2199 nothing will be added besides the boxes so that they can be places side
2203 \begin_layout Standard
2204 \begin_inset Flex Color Box
2207 \begin_layout Plain Layout
2208 \begin_inset Argument 1
2211 \begin_layout Plain Layout
2212 width=3cm, square, valign=center, before=, after=
2218 \begin_inset space \thinspace{}
2221 cm wide, square box.
2227 \begin_inset Flex Color Box
2230 \begin_layout Plain Layout
2231 \begin_inset Argument 1
2234 \begin_layout Plain Layout
2235 width=3cm, square, valign=center, before=, after=
2241 \begin_inset space \thinspace{}
2244 cm wide, square box.
2250 \begin_inset Flex Color Box
2253 \begin_layout Plain Layout
2254 \begin_inset Argument 1
2257 \begin_layout Plain Layout
2258 width=3cm, square, valign=center, before=, after=
2264 \begin_inset space \thinspace{}
2267 cm wide, square box.
2275 \begin_layout Standard
2280 is an alternative for
2287 \begin_layout Standard
2288 To separate the boxes one can use the normal \SpecialChar LyX
2289 spacing features like a horizontal
2293 \begin_layout Standard
2294 \begin_inset space \hfill{}
2298 \begin_inset Flex Color Box
2301 \begin_layout Plain Layout
2302 \begin_inset Argument 1
2305 \begin_layout Plain Layout
2306 width=3cm, square, valign=center, nobeforeafter
2312 \begin_inset space \thinspace{}
2315 cm wide, square box.
2321 \begin_inset space \hfill{}
2325 \begin_inset Flex Color Box
2328 \begin_layout Plain Layout
2329 \begin_inset Argument 1
2332 \begin_layout Plain Layout
2333 width=3cm, square, valign=center, nobeforeafter
2339 \begin_inset space \thinspace{}
2342 cm wide, square box.
2348 \begin_inset space \hfill{}
2352 \begin_inset Flex Color Box
2355 \begin_layout Plain Layout
2356 \begin_inset Argument 1
2359 \begin_layout Plain Layout
2360 width=3cm, square, valign=center, nobeforeafter
2366 \begin_inset space \thinspace{}
2369 cm wide, square box.
2375 \begin_inset space \hfill{}
2381 \begin_layout Standard
2382 If you prefer \SpecialChar TeX
2383 code you can alternative use the option
2389 to add a a horizontal fill.
2392 \begin_layout Subsubsection
2396 \begin_layout Standard
2397 Like for tables and figures in a document it is very helpful if boxes could
2398 float in the text to be placed at the optimal position.
2399 This is achieved by the option
2407 are the optional \SpecialChar TeX
2408 floating placement options
2409 \begin_inset Quotes eld
2417 \begin_inset Quotes erd
2421 \begin_inset Quotes eld
2429 \begin_inset Quotes erd
2433 \begin_inset Quotes eld
2441 \begin_inset Quotes erd
2445 \begin_inset Quotes eld
2453 \begin_inset Quotes erd
2457 They correspond to the float placement options described in section
2460 \begin_inset space ~
2468 \begin_inset space ~
2474 The placement options can be mixed and are inserted without any separation,
2476 \begin_inset space \thinspace{}
2480 \begin_inset space \space{}
2484 \begin_inset Quotes eld
2492 \begin_inset Quotes erd
2498 \begin_layout Standard
2499 \begin_inset Flex Color Box
2502 \begin_layout Plain Layout
2503 \begin_inset Argument 1
2506 \begin_layout Plain Layout
2507 title=A floating box, float, width=5cm, valign=center
2513 \begin_inset space \thinspace{}
2516 cm wide floating box.
2524 \begin_layout Standard
2525 For floating boxes the options
2534 One can instead insert code with the command
2539 If the box is breakable the code is inserted before every part of the break
2541 A typical application is to center the floating box with
2548 \begin_layout Standard
2549 \begin_inset Flex Color Box
2552 \begin_layout Plain Layout
2553 \begin_inset Argument 1
2556 \begin_layout Plain Layout
2557 title=A floating box, float, width=5cm, valign=center, every float=
2565 \begin_inset space \thinspace{}
2568 cm wide floating box.
2576 \begin_layout Subsubsection
2578 \begin_inset CommandInset label
2580 name "subsec:Vertical"
2587 \begin_layout Standard
2588 The vertical placement of a box in respect to the surrounding text line
2589 can only be set for dynamic boxes.
2594 raises or lowers the box.
2600 The allowed units for values are listed in Appendix
2601 \begin_inset space ~
2607 \begin_inset space ~
2613 The default width is
2622 the box is lowered that the base of the box content matches the base of
2623 the surrounding line.
2626 \begin_layout Standard
2630 \begin_layout Standard
2632 \begin_inset Flex Dynamic Color Box
2635 \begin_layout Plain Layout
2636 \begin_inset Argument 1
2639 \begin_layout Plain Layout
2640 tcbox raise base, nobeforeafter
2651 \begin_inset Flex Dynamic Color Box
2654 \begin_layout Plain Layout
2655 \begin_inset Argument 1
2658 \begin_layout Plain Layout
2670 \begin_inset Flex Dynamic Color Box
2673 \begin_layout Plain Layout
2674 \begin_inset Argument 1
2677 \begin_layout Plain Layout
2678 tcbox raise=1cm, nobeforeafter
2684 \begin_inset space \thinspace{}
2695 \begin_layout Subsubsection
2699 \begin_layout Standard
2700 The easiest way to place boxes in a table-like raster is to put them into
2702 To get a raster box insert a
2705 \begin_inset space ~
2709 \begin_inset space ~
2716 Insert\SpecialChar menuseparator
2722 \begin_layout Standard
2723 The number of columns is specified with the option
2725 raster columns=number
2731 is the number of columns.
2732 All boxes inserted to the raster box will now automatically be output in
2733 a raster with 3 columns and their width is automatically adjusted.
2736 \begin_layout Standard
2737 \begin_inset Flex Raster Color Box
2740 \begin_layout Plain Layout
2741 \begin_inset Argument 1
2744 \begin_layout Plain Layout
2753 \begin_layout Plain Layout
2754 \begin_inset Flex Color Box
2757 \begin_layout Plain Layout
2758 \begin_inset Argument 1
2761 \begin_layout Plain Layout
2773 \begin_inset Flex Color Box
2776 \begin_layout Plain Layout
2777 \begin_inset Argument 1
2780 \begin_layout Plain Layout
2792 \begin_inset Flex Color Box
2795 \begin_layout Plain Layout
2796 \begin_inset Argument 1
2799 \begin_layout Plain Layout
2811 \begin_inset Flex Color Box
2814 \begin_layout Plain Layout
2815 \begin_inset Argument 1
2818 \begin_layout Plain Layout
2830 \begin_inset Flex Color Box
2833 \begin_layout Plain Layout
2834 \begin_inset Argument 1
2837 \begin_layout Plain Layout
2856 \begin_layout Standard
2857 For more info options of the raster color box, please consult the
2864 \begin_inset space ~
2870 \begin_inset CommandInset citation
2879 \begin_layout Subsection
2881 \begin_inset CommandInset label
2883 name "subsec:Geometry"
2890 \begin_layout Subsubsection
2894 \begin_layout Subsubsection*
2898 \begin_layout Standard
2899 The width of the box is changed with the option
2908 The allowed units for values are listed in Appendix
2909 \begin_inset space ~
2915 \begin_inset space ~
2921 The default width is
2930 \begin_layout Standard
2931 \begin_inset Flex Color Box
2934 \begin_layout Plain Layout
2935 \begin_inset Argument 1
2938 \begin_layout Plain Layout
2945 \begin_inset space \thinspace{}
2956 \begin_layout Standard
2957 One can also set a width only for the text of the box with the option
2962 If the width is shorter than required for the text new lines will be created
2966 \begin_layout Standard
2967 \begin_inset Flex Color Box
2970 \begin_layout Plain Layout
2971 \begin_inset Argument 1
2974 \begin_layout Plain Layout
2980 Some longer text to fill the box with a width of 4
2981 \begin_inset space \thinspace{}
2992 \begin_layout Standard
3001 because only the last given width option is taken into account.
3004 \begin_layout Standard
3005 To extend the width of the box one must use the
3009 option and can then uses the option
3016 \begin_layout Standard
3017 \begin_inset Flex Color Box
3020 \begin_layout Plain Layout
3021 \begin_inset Argument 1
3024 \begin_layout Plain Layout
3025 width=10cm, add to width=2cm
3031 \begin_inset space \thinspace{}
3034 cm wide box with additional width of 2
3035 \begin_inset space \thinspace{}
3046 \begin_layout Subsubsection*
3050 \begin_layout Standard
3051 For boxes with parts side by side one can control the width of the box parts
3075 sidebyside gap=length
3082 The allowed units for the values are listed in Appendix
3083 \begin_inset space ~
3089 \begin_inset space ~
3095 All option require of course the option sidebyside.
3098 \begin_layout Standard
3103 sets the space between the left and the right part.
3106 \begin_layout Standard
3107 \begin_inset Flex Color Box
3110 \begin_layout Plain Layout
3111 \begin_inset Argument 1
3114 \begin_layout Plain Layout
3115 sidebyside, sidebyside gap=2cm
3120 Upper content divided by 2
3121 \begin_inset space \thinspace{}
3127 \begin_layout Color Box Separator
3131 \begin_layout Plain Layout
3140 \begin_layout Standard
3149 sets the absolute width of the left and right part, respectively.
3152 \begin_layout Standard
3153 \begin_inset Flex Color Box
3156 \begin_layout Plain Layout
3157 \begin_inset Argument 1
3160 \begin_layout Plain Layout
3161 sidebyside, lefthand width=3cm
3166 Upper content with a width of 3
3167 \begin_inset space \thinspace{}
3173 \begin_layout Color Box Separator
3177 \begin_layout Plain Layout
3186 \begin_layout Standard
3195 sets the relative width of the left and right part, respectively.
3198 \begin_layout Standard
3199 \begin_inset Flex Color Box
3202 \begin_layout Plain Layout
3203 \begin_inset Argument 1
3206 \begin_layout Plain Layout
3207 sidebyside, lefthand ratio=0.3
3212 Upper content with a width of 30
3213 \begin_inset space \thinspace{}
3219 \begin_layout Color Box Separator
3223 \begin_layout Plain Layout
3232 \begin_layout Subsubsection
3234 \begin_inset CommandInset label
3236 name "subsec:Height"
3243 \begin_layout Subsubsection*
3247 \begin_layout Standard
3248 The height of the box is changed with the option
3257 The default height is the height consumed by the box content.
3260 \begin_layout Standard
3261 \begin_inset Flex Color Box
3264 \begin_layout Plain Layout
3265 \begin_inset Argument 1
3268 \begin_layout Plain Layout
3275 \begin_inset space \thinspace{}
3286 \begin_layout Standard
3287 If the specified height is smaller then the one consumed by the content,
3288 the content will be placed below the box:
3291 \begin_layout Standard
3292 \begin_inset Flex Color Box
3295 \begin_layout Plain Layout
3296 \begin_inset Argument 1
3299 \begin_layout Plain Layout
3306 \begin_inset space \thinspace{}
3317 \begin_layout Standard
3318 \begin_inset VSpace bigskip
3325 the height will automatically set to the same value than the box width.
3328 \begin_layout Standard
3329 \begin_inset Flex Color Box
3332 \begin_layout Plain Layout
3333 \begin_inset Argument 1
3336 \begin_layout Plain Layout
3350 \begin_layout Standard
3351 \begin_inset VSpace bigskip
3354 To extend the height of the box in case the content might consume more height
3355 than expected one must use the
3359 option and can then uses the option
3364 An application would be to set a maximal possible height in case you write
3365 a book where the spacing is defined and should not be overwritten by any
3369 \begin_layout Standard
3370 \begin_inset Flex Color Box
3373 \begin_layout Plain Layout
3374 \begin_inset Argument 1
3377 \begin_layout Plain Layout
3378 height=2cm, height plus=2cm
3384 \begin_inset space \thinspace{}
3387 cm high box with additional height of 2
3388 \begin_inset space \thinspace{}
3399 \begin_layout Standard
3400 \begin_inset Flex Color Box
3403 \begin_layout Plain Layout
3404 \begin_inset Argument 1
3407 \begin_layout Plain Layout
3408 height=2cm, height plus=2cm
3414 \begin_inset space \thinspace{}
3417 cm high box with additional height of 2
3418 \begin_inset space \thinspace{}
3422 Its content consumes 3
3423 \begin_inset space \thinspace{}
3426 cm therefore the box height will also be 3
3427 \begin_inset space \thinspace{}
3432 \begin_inset space \thinspace{}
3435 cm high box with additional height of 2
3436 \begin_inset space \thinspace{}
3440 Its content consumes 3
3441 \begin_inset space \thinspace{}
3444 cm therefore the box height will also be 3
3445 \begin_inset space \thinspace{}
3450 \begin_inset space \thinspace{}
3453 cm high box with additional height of 2
3454 \begin_inset space \thinspace{}
3458 Its content consumes 3
3459 \begin_inset space \thinspace{}
3462 cm therefore the box height will also be 3
3463 \begin_inset space \thinspace{}
3474 \begin_layout Standard
3475 \begin_inset VSpace bigskip
3478 In some cases it might be useful to specify an allowed range for the height
3481 height from=min to max
3492 The height will then be at least the given minimal value or the height
3493 consumed by the content.
3494 It does not exceed the maximum independent of the content:
3497 \begin_layout Standard
3498 \begin_inset Flex Color Box
3501 \begin_layout Plain Layout
3502 \begin_inset Argument 1
3505 \begin_layout Plain Layout
3506 height from=1cm to 3cm
3511 A box with minimal height of 1
3512 \begin_inset space \thinspace{}
3515 cm and maximal height of 3
3516 \begin_inset space \thinspace{}
3527 \begin_layout Standard
3528 \begin_inset Flex Color Box
3531 \begin_layout Plain Layout
3532 \begin_inset Argument 1
3535 \begin_layout Plain Layout
3536 height from=1cm to 3cm
3541 A box with minimal height of 1
3542 \begin_inset space \thinspace{}
3545 cm and maximal height of 3
3546 \begin_inset space \thinspace{}
3550 A box with minimal height of 1
3551 \begin_inset space \thinspace{}
3554 cm and maximal height of 3
3555 \begin_inset space \thinspace{}
3559 A box with minimal height of 1
3560 \begin_inset space \thinspace{}
3563 cm and maximal height of 3
3564 \begin_inset space \thinspace{}
3575 \begin_layout Standard
3576 \begin_inset VSpace bigskip
3581 add to height=length
3583 one can add defined height to the box.
3588 option must be added
3595 \begin_layout Standard
3596 \begin_inset Flex Color Box
3599 \begin_layout Plain Layout
3600 \begin_inset Argument 1
3603 \begin_layout Plain Layout
3604 height=1.5cm, add to height=1cm
3610 \begin_inset space \thinspace{}
3614 \begin_inset space \thinspace{}
3617 cm additional height.
3625 \begin_layout Standard
3626 \begin_inset VSpace bigskip
3633 one can force the box to consume the rest of the available height of the
3634 document parts where it is in.
3648 The latter works like
3652 but compresses the content of the page before the box as much as possible
3653 to maximize the box.
3654 \begin_inset Newline newline
3657 In this example the box is in the main text and therefore consumes the rest
3658 of the current page.
3661 \begin_layout Standard
3662 \begin_inset Flex Color Box
3665 \begin_layout Plain Layout
3666 \begin_inset Argument 1
3669 \begin_layout Plain Layout
3675 A box that fills the remaining height of the current page.
3683 \begin_layout Subsubsection*
3687 \begin_layout Standard
3688 One can set a height only for the text of the box with the option
3689 \begin_inset Newline newline
3699 \begin_layout Standard
3700 \begin_inset Flex Color Box
3703 \begin_layout Plain Layout
3704 \begin_inset Argument 1
3707 \begin_layout Plain Layout
3714 \begin_inset space \thinspace{}
3718 Due to the frame separation and the frame width the box height is larger
3720 \begin_inset space \thinspace{}
3731 \begin_layout Standard
3740 because only the last given width option is taken into account.
3743 \begin_layout Standard
3744 \begin_inset VSpace bigskip
3767 one can specify how the height should be divided between the upper and
3777 is the fraction of the additional height (the specified height minus the
3778 height consumed by the content).
3779 \begin_inset Newline newline
3787 \begin_inset space \thinspace{}
3790 % of the additional space to the upper part:
3793 \begin_layout Standard
3794 \begin_inset Flex Color Box
3797 \begin_layout Plain Layout
3798 \begin_inset Argument 1
3801 \begin_layout Plain Layout
3802 height=3cm, space=0.75
3808 \begin_inset space \thinspace{}
3811 cm high box where 75 % of the additional height is set to the upper content.
3814 \begin_layout Color Box Separator
3818 \begin_layout Plain Layout
3827 \begin_layout Standard
3855 \begin_layout Standard
3856 \begin_inset Flex Color Box
3859 \begin_layout Plain Layout
3860 \begin_inset Argument 1
3863 \begin_layout Plain Layout
3864 height=3cm, space to upper
3870 \begin_inset space \thinspace{}
3873 cm high box where all additional height is set to the upper content.
3876 \begin_layout Color Box Separator
3880 \begin_layout Plain Layout
3889 \begin_layout Standard
3898 is the fraction of the complete height (not the additional height).
3899 Therefore one must be careful of e.
3900 \begin_inset space \thinspace{}
3904 \begin_inset space \space{}
3907 the upper part consumes more height than one set via
3914 \begin_layout Standard
3915 \begin_inset Flex Color Box
3918 \begin_layout Plain Layout
3919 \begin_inset Argument 1
3922 \begin_layout Plain Layout
3923 height=3cm, split=0.1
3929 \begin_inset space \thinspace{}
3932 cm high box where the height is split by 10
3933 \begin_inset space \thinspace{}
3938 \begin_inset space \thinspace{}
3941 cm high box where the height is split by 10
3942 \begin_inset space \thinspace{}
3948 \begin_layout Color Box Separator
3952 \begin_layout Plain Layout
3961 \begin_layout Standard
3962 \begin_inset VSpace bigskip
3967 equal height group=id
3969 it is possible to set the same height for all boxes in a group.
3974 is a name to reference the group.
3975 This is for example useful if one has 3
3976 \begin_inset space ~
3979 boxes side by side inside a box:
3982 \begin_layout Standard
3983 \begin_inset Flex Color Box
3986 \begin_layout Plain Layout
3987 \begin_inset Flex Color Box
3990 \begin_layout Plain Layout
3991 \begin_inset Argument 1
3994 \begin_layout Plain Layout
3995 adjusted title=ice, width=0.3
3997 columnwidth, nobeforeafter, equal height group=A
4008 \begin_inset space \hfill{}
4012 \begin_inset Flex Color Box
4015 \begin_layout Plain Layout
4016 \begin_inset Argument 1
4019 \begin_layout Plain Layout
4020 adjusted title=Grapefruit, width=0.3
4022 columnwidth, space to upper, nobeforeafter, equal height group=A
4030 \begin_layout Color Box Separator
4034 \begin_layout Plain Layout
4041 \begin_inset space \hfill{}
4045 \begin_inset Flex Color Box
4048 \begin_layout Plain Layout
4049 \begin_inset Argument 1
4052 \begin_layout Plain Layout
4053 adjusted title=, width=0.3
4055 columnwidth, nobeforeafter, equal height group=A
4060 A box with longer text.
4061 A box with longer text.
4062 A box with longer text.
4063 A box with longer text.
4064 A box with longer text.
4077 \begin_layout Standard
4078 The above example was typeset by adding the option
4080 equal height group=A
4083 \begin_inset space ~
4091 is hereby the name of the group.
4094 \begin_layout Standard
4095 If you have a title that needs only a single line, it is recommended to
4104 for all boxes to assure that the title height will be the same for all
4106 Otherwise the height would be different in the above example because
4107 \begin_inset Quotes eld
4111 \begin_inset Quotes erd
4114 needs more height than
4115 \begin_inset Quotes eld
4119 \begin_inset Quotes erd
4125 \begin_layout Subsubsection
4129 \begin_layout Standard
4130 The width of the box frame can be changed with the options
4151 Each option changes the corresponding part of the frame.
4161 The allowed units for the values are listed in Appendix
4162 \begin_inset space ~
4168 \begin_inset space ~
4174 The default length for all parts is 0.5
4175 \begin_inset space \thinspace{}
4179 To set all frame parts to the same value use the option
4186 \begin_layout Standard
4187 \begin_inset Flex Color Box
4190 \begin_layout Plain Layout
4191 \begin_inset Argument 1
4194 \begin_layout Plain Layout
4195 leftrule=3mm, rightrule=4mm, toprule=2mm, bottomrule=1mm
4201 \begin_inset space \thinspace{}
4204 mm wide left rule, 4
4205 \begin_inset space \thinspace{}
4208 mm wide right rule, 2
4209 \begin_inset space \thinspace{}
4213 \begin_inset space \thinspace{}
4224 \begin_layout Standard
4225 \begin_inset Flex Color Box
4228 \begin_layout Plain Layout
4229 \begin_inset Argument 1
4232 \begin_layout Plain Layout
4239 \begin_inset space \thinspace{}
4250 \begin_layout Standard
4251 The title rule is the separation between the title and the box content.
4254 \begin_layout Standard
4255 \begin_inset Flex Color Box
4258 \begin_layout Plain Layout
4259 \begin_inset Argument 1
4262 \begin_layout Plain Layout
4263 title=A title, titlerule=8mm, colbacktitle=blue
4269 \begin_inset space \thinspace{}
4280 \begin_layout Subsubsection
4284 \begin_layout Standard
4285 By default boxes are rectangular with rounded edges.
4286 The radius of the edges can be changed with the option
4295 The allowed units for the values are listed in Appendix
4296 \begin_inset space ~
4302 \begin_inset space ~
4315 \begin_layout Standard
4316 \begin_inset Flex Color Box
4319 \begin_layout Plain Layout
4320 \begin_inset Argument 1
4323 \begin_layout Plain Layout
4332 \begin_inset space \thinspace{}
4345 \begin_layout Standard
4350 one can set the outer radius independently:
4353 \begin_layout Standard
4354 \begin_inset Flex Color Box
4357 \begin_layout Plain Layout
4358 \begin_inset Argument 1
4361 \begin_layout Plain Layout
4362 arc=5mm, outer arc=0mm
4370 \begin_inset space \thinspace{}
4378 \begin_inset space \thinspace{}
4391 \begin_layout Standard
4392 \begin_inset Flex Color Box
4395 \begin_layout Plain Layout
4396 \begin_inset Argument 1
4399 \begin_layout Plain Layout
4400 arc=0mm, outer arc=0mm
4405 A really rectangular box (
4416 \begin_inset space \thinspace{}
4422 The same can alternatively be achieved with the option
4434 \begin_layout Standard
4435 \begin_inset VSpace bigskip
4438 The general shape can be changed with the options
4453 \begin_layout Standard
4458 sets the edge radius to half of the box width.
4459 It is therefore required to specify at least the width.
4462 \begin_layout Standard
4463 \begin_inset Flex Color Box
4466 \begin_layout Plain Layout
4467 \begin_inset Argument 1
4470 \begin_layout Plain Layout
4471 width=3.5cm, circular arc
4477 \begin_inset space \thinspace{}
4480 cm wide circular box.
4488 \begin_layout Standard
4489 As you can see circular box looks ugly when the box is wider than high.
4490 It is therefore recommended to add the option
4495 \begin_inset CommandInset ref
4497 reference "subsec:Height"
4501 , to get the same width and height.
4502 The result is a perfect circle.
4503 The center the text in the box use the text alignment options described
4505 \begin_inset CommandInset ref
4507 reference "subsec:Alignment"
4514 \begin_layout Standard
4515 \begin_inset Flex Color Box
4518 \begin_layout Plain Layout
4519 \begin_inset Argument 1
4522 \begin_layout Plain Layout
4523 width=4cm, square, valign=center, circular arc
4529 \begin_inset space \thinspace{}
4532 cm wide circular box.
4540 \begin_layout Standard
4545 sets the edge radius to half of the minimum of the box width and height.
4546 The result is a semicircle.
4551 requires the options
4566 \begin_layout Standard
4567 \begin_inset Flex Color Box
4570 \begin_layout Plain Layout
4571 \begin_inset Argument 1
4574 \begin_layout Plain Layout
4575 width=3.5cm, height=5cm, bean arc, nobeforeafter, valign=center
4581 \begin_inset space \thinspace{}
4585 \begin_inset space \thinspace{}
4598 \begin_inset Flex Color Box
4601 \begin_layout Plain Layout
4602 \begin_inset Argument 1
4605 \begin_layout Plain Layout
4606 width=5cm, height=3.5cm, bean arc, nobeforeafter, valign=center
4612 \begin_inset space \thinspace{}
4616 \begin_inset space \thinspace{}
4631 \begin_layout Standard
4632 Using bean arc for a square box leads to the same result as
4639 \begin_layout Standard
4640 \begin_inset Flex Color Box
4643 \begin_layout Plain Layout
4644 \begin_inset Argument 1
4647 \begin_layout Plain Layout
4648 width=4cm, square, bean arc, valign=center
4654 \begin_inset space \thinspace{}
4657 cm wide, square box as bean arc.
4665 \begin_layout Standard
4670 is useful to get an octagon.
4671 For an octagon one needs a square box and the options
4678 \begin_layout Standard
4679 \begin_inset Flex Color Box
4682 \begin_layout Plain Layout
4683 \begin_inset Argument 1
4686 \begin_layout Plain Layout
4687 width=4cm, square, octogon arc, valign=center, arc is angular
4693 \begin_inset space \thinspace{}
4696 cm wide, square box with
4708 \begin_layout Standard
4709 \begin_inset Note Greyedout
4712 \begin_layout Plain Layout
4721 is experimental and might cause problems on some \SpecialChar LaTeX
4730 \begin_layout Standard
4731 \begin_inset VSpace bigskip
4734 It is also possible to change only some of the box edges.
4735 To make an edge a corner there is the option
4737 sharp corners=position
4743 is the position of the edge.
4760 change only the corresponding edge.
4763 \begin_layout Standard
4764 \begin_inset Flex Color Box
4767 \begin_layout Plain Layout
4768 \begin_inset Argument 1
4771 \begin_layout Plain Layout
4772 sharp corners=northeast
4777 A box with a corner at the upper right (
4789 \begin_layout Standard
4815 \begin_inset space ~
4821 \begin_layout Standard
4822 \begin_inset Flex Color Box
4825 \begin_layout Plain Layout
4826 \begin_inset Argument 1
4829 \begin_layout Plain Layout
4832 columnwidth,sharp corners=east, nobeforeafter
4838 \begin_inset space ~
4841 corners at the right (
4851 \begin_inset space \hfill{}
4855 \begin_inset Flex Color Box
4858 \begin_layout Plain Layout
4859 \begin_inset Argument 1
4862 \begin_layout Plain Layout
4865 columnwidth,sharp corners=uphill, nobeforeafter
4871 \begin_inset space ~
4874 corners, one at the lower left, one at the upper right (
4886 \begin_layout Standard
4894 \begin_layout Subsection
4896 \begin_inset CommandInset label
4898 name "subsec:Alignment"
4905 \begin_layout Subsubsection
4909 \begin_layout Standard
4914 sets the alignment for the whole box content if there are not box parts,
4915 otherwise the options
4928 is one of the following:
4931 \begin_layout Description
4932 right the content is right-aligned
4933 \begin_inset Flex Color Box
4936 \begin_layout Plain Layout
4937 \begin_inset Argument 1
4940 \begin_layout Plain Layout
4946 A right-aligned box.
4954 \begin_layout Description
4955 left the content is left-aligned
4956 \begin_inset Flex Color Box
4959 \begin_layout Plain Layout
4960 \begin_inset Argument 1
4963 \begin_layout Plain Layout
4977 \begin_layout Description
4978 center the content is centered
4979 \begin_inset Flex Color Box
4982 \begin_layout Plain Layout
4983 \begin_inset Argument 1
4986 \begin_layout Plain Layout
4992 A horizontally centered box.
5000 \begin_layout Description
5001 justify the content is justified (is the default value)
5002 \begin_inset Flex Color Box
5005 \begin_layout Plain Layout
5006 \begin_inset Argument 1
5009 \begin_layout Plain Layout
5023 \begin_layout Standard
5024 An example with box parts:
5025 \begin_inset Flex Color Box
5028 \begin_layout Plain Layout
5029 \begin_inset Argument 1
5032 \begin_layout Plain Layout
5033 halign upper=left, halign lower=center
5038 Upper content left-aligned
5041 \begin_layout Color Box Separator
5045 \begin_layout Plain Layout
5046 Lower content centered
5054 \begin_layout Standard
5055 The title alignment can be changed with the option
5062 \begin_layout Standard
5063 \begin_inset Flex Color Box
5066 \begin_layout Plain Layout
5067 \begin_inset Argument 1
5070 \begin_layout Plain Layout
5071 title=A right-aligned title, halign title=right, halign upper=left, halign
5077 Upper content left-aligned
5080 \begin_layout Color Box Separator
5084 \begin_layout Plain Layout
5085 Lower content centered
5093 \begin_layout Subsubsection
5097 \begin_layout Standard
5098 The vertical alignment can only be changed if the box height is explicitly
5099 set larger than the height consumed by the box content.
5101 \begin_inset CommandInset ref
5103 reference "subsec:Height"
5110 \begin_layout Standard
5115 sets the alignment for the whole box content if there are no box parts,
5116 otherwise the options
5129 is one of the following:
5132 \begin_layout Description
5133 top the content is top-aligned
5134 \begin_inset Flex Color Box
5137 \begin_layout Plain Layout
5138 \begin_inset Argument 1
5141 \begin_layout Plain Layout
5142 height=2cm, valign=top
5155 \begin_layout Description
5156 bottom the content is bottom-aligned
5157 \begin_inset Flex Color Box
5160 \begin_layout Plain Layout
5161 \begin_inset Argument 1
5164 \begin_layout Plain Layout
5165 height=2cm, valign=bottom
5170 A bottom-aligned box.
5178 \begin_layout Description
5179 center the content is vertically centered
5180 \begin_inset Flex Color Box
5183 \begin_layout Plain Layout
5184 \begin_inset Argument 1
5187 \begin_layout Plain Layout
5188 height=2cm, valign=center
5193 A vertically centered box.
5201 \begin_layout Description
5202 scale the content is vertically centered to fit the height
5203 \begin_inset Flex Color Box
5206 \begin_layout Plain Layout
5207 \begin_inset Argument 1
5210 \begin_layout Plain Layout
5211 height=2cm, valign=scale
5216 A box with scaled content.
5224 \begin_layout Standard
5225 An example with box parts:
5228 \begin_layout Standard
5229 \begin_inset Flex Color Box
5232 \begin_layout Plain Layout
5233 \begin_inset Argument 1
5236 \begin_layout Plain Layout
5237 height=4cm, space=0.5, valign upper=bottom, valign lower=center
5242 Upper content bottom-aligned
5245 \begin_layout Color Box Separator
5249 \begin_layout Plain Layout
5250 Lower content centered
5258 \begin_layout Subsection
5262 \begin_layout Standard
5263 The font changing options have the syntax
5271 are \SpecialChar LaTeX
5272 's font changing commands.
5273 For example the code
5274 \begin_inset Newline newline
5288 \begin_inset Newline newline
5291 makes the font sans-serif, bold and increases the font size to the level
5301 \begin_layout Subsubsection
5305 \begin_layout Standard
5306 The title font can be changed with the option
5313 \begin_layout Standard
5314 \begin_inset Flex Color Box
5317 \begin_layout Plain Layout
5318 \begin_inset Argument 1
5321 \begin_layout Plain Layout
5322 title=A title, fonttitle=
5341 \begin_layout Subsubsection
5345 \begin_layout Standard
5346 The font for the upper and lower part text can be changed with the options
5358 \begin_layout Standard
5359 \begin_inset Flex Color Box
5362 \begin_layout Plain Layout
5363 \begin_inset Argument 1
5366 \begin_layout Plain Layout
5367 title=A title, fontupper=
5369 ttfamily, fontlower=
5376 Changed upper text font
5379 \begin_layout Color Box Separator
5383 \begin_layout Plain Layout
5384 Changed lower text font
5392 \begin_layout Subsection
5394 \begin_inset CommandInset label
5403 \begin_layout Standard
5404 The color is specified in one of these schemes:
5407 \begin_layout Enumerate
5413 \begin_inset Newline newline
5417 \begin_inset Newline newline
5425 \begin_inset Newline newline
5429 \begin_inset space \thinspace{}
5433 \begin_inset Newline newline
5437 \begin_inset Flex Color Box
5440 \begin_layout Plain Layout
5441 \begin_inset Argument 1
5444 \begin_layout Plain Layout
5456 \begin_inset VSpace defskip
5462 \begin_layout Enumerate
5465 Name1!PercentOfName1
5468 \begin_inset Newline newline
5472 \begin_inset Newline newline
5480 \begin_inset Newline newline
5484 \begin_inset space \thinspace{}
5488 \begin_inset Newline newline
5492 \begin_inset space \thinspace{}
5496 \begin_inset Quotes eld
5500 \begin_inset Quotes erd
5504 \begin_inset Newline newline
5508 \begin_inset Flex Color Box
5511 \begin_layout Plain Layout
5512 \begin_inset Argument 1
5515 \begin_layout Plain Layout
5527 \begin_inset VSpace defskip
5533 \begin_layout Enumerate
5536 Name1!PercentOfName1!Name2
5539 \begin_inset Newline newline
5543 \begin_inset Newline newline
5551 \begin_inset Newline newline
5555 \begin_inset space \thinspace{}
5559 \begin_inset Newline newline
5563 \begin_inset space \thinspace{}
5567 \begin_inset Newline newline
5571 \begin_inset Flex Color Box
5574 \begin_layout Plain Layout
5575 \begin_inset Argument 1
5578 \begin_layout Plain Layout
5590 \begin_inset VSpace defskip
5596 \begin_layout Enumerate
5599 Name1!PercentName1!Name2!PercentName3!Name3
5602 \begin_inset Newline newline
5606 \begin_inset Newline newline
5611 red!71.4!green!70!blue
5614 \begin_inset Newline newline
5618 \begin_inset Formula $1-0.70=30\,$
5622 \begin_inset Newline newline
5626 \begin_inset Formula $\left(1-0.714\right)\cdot0.70=20.02\thinspace$
5630 \begin_inset Newline newline
5634 \begin_inset Formula $0.714\cdot0.70=49.98\thinspace$
5638 \begin_inset Newline newline
5642 \begin_inset Flex Color Box
5645 \begin_layout Plain Layout
5646 \begin_inset Argument 1
5649 \begin_layout Plain Layout
5650 colback=red!71.4!green!70!blue
5655 red!71.4!green!70!blue
5661 \begin_inset VSpace defskip
5667 \begin_layout Standard
5668 The possible color names are:
5671 \begin_layout Standard
5673 \begin_inset Tabular
5674 <lyxtabular version="3" rows="4" columns="5">
5675 <features tabularvalignment="middle">
5676 <column alignment="left" valignment="top" width="18col%">
5677 <column alignment="left" valignment="top" width="18col%">
5678 <column alignment="left" valignment="top" width="18col%">
5679 <column alignment="left" valignment="top" width="18col%">
5680 <column alignment="left" valignment="top" width="18col%">
5682 <cell alignment="left" valignment="top" usebox="none">
5685 \begin_layout Plain Layout
5689 \begin_layout Plain Layout
5702 \begin_layout Plain Layout
5710 \begin_inset Phantom Phantom
5713 \begin_layout Plain Layout
5723 \begin_layout Plain Layout
5735 <cell alignment="left" valignment="top" usebox="none">
5738 \begin_layout Plain Layout
5742 \begin_layout Plain Layout
5755 \begin_layout Plain Layout
5763 \begin_inset Phantom Phantom
5766 \begin_layout Plain Layout
5776 \begin_layout Plain Layout
5788 <cell alignment="left" valignment="top" usebox="none">
5791 \begin_layout Plain Layout
5795 \begin_layout Plain Layout
5808 \begin_layout Plain Layout
5816 \begin_inset Phantom Phantom
5819 \begin_layout Plain Layout
5829 \begin_layout Plain Layout
5841 <cell alignment="left" valignment="top" usebox="none">
5844 \begin_layout Plain Layout
5848 \begin_layout Plain Layout
5861 \begin_layout Plain Layout
5869 \begin_inset Phantom Phantom
5872 \begin_layout Plain Layout
5882 \begin_layout Plain Layout
5894 <cell alignment="left" valignment="top" usebox="none">
5897 \begin_layout Plain Layout
5901 \begin_layout Plain Layout
5914 \begin_layout Plain Layout
5922 \begin_inset Phantom Phantom
5925 \begin_layout Plain Layout
5935 \begin_layout Plain Layout
5949 <cell alignment="left" valignment="top" usebox="none">
5952 \begin_layout Plain Layout
5956 \begin_layout Plain Layout
5969 \begin_layout Plain Layout
5977 \begin_inset Phantom Phantom
5980 \begin_layout Plain Layout
5990 \begin_layout Plain Layout
6002 <cell alignment="left" valignment="top" usebox="none">
6005 \begin_layout Plain Layout
6009 \begin_layout Plain Layout
6022 \begin_layout Plain Layout
6030 \begin_inset Phantom Phantom
6033 \begin_layout Plain Layout
6043 \begin_layout Plain Layout
6055 <cell alignment="left" valignment="top" usebox="none">
6058 \begin_layout Plain Layout
6062 \begin_layout Plain Layout
6075 \begin_layout Plain Layout
6083 \begin_inset Phantom Phantom
6086 \begin_layout Plain Layout
6096 \begin_layout Plain Layout
6108 <cell alignment="left" valignment="top" usebox="none">
6111 \begin_layout Plain Layout
6115 \begin_layout Plain Layout
6128 \begin_layout Plain Layout
6136 \begin_inset Phantom Phantom
6139 \begin_layout Plain Layout
6149 \begin_layout Plain Layout
6161 <cell alignment="left" valignment="top" usebox="none">
6164 \begin_layout Plain Layout
6168 \begin_layout Plain Layout
6181 \begin_layout Plain Layout
6189 \begin_inset Phantom Phantom
6192 \begin_layout Plain Layout
6202 \begin_layout Plain Layout
6216 <cell alignment="left" valignment="top" usebox="none">
6219 \begin_layout Plain Layout
6223 \begin_layout Plain Layout
6236 \begin_layout Plain Layout
6244 \begin_inset Phantom Phantom
6247 \begin_layout Plain Layout
6257 \begin_layout Plain Layout
6269 <cell alignment="left" valignment="top" usebox="none">
6272 \begin_layout Plain Layout
6276 \begin_layout Plain Layout
6289 \begin_layout Plain Layout
6297 \begin_inset Phantom Phantom
6300 \begin_layout Plain Layout
6310 \begin_layout Plain Layout
6322 <cell alignment="left" valignment="top" usebox="none">
6325 \begin_layout Plain Layout
6329 \begin_layout Plain Layout
6342 \begin_layout Plain Layout
6350 \begin_inset Phantom Phantom
6353 \begin_layout Plain Layout
6363 \begin_layout Plain Layout
6375 <cell alignment="left" valignment="top" usebox="none">
6378 \begin_layout Plain Layout
6382 \begin_layout Plain Layout
6395 \begin_layout Plain Layout
6403 \begin_inset Phantom Phantom
6406 \begin_layout Plain Layout
6416 \begin_layout Plain Layout
6428 <cell alignment="left" valignment="top" usebox="none">
6431 \begin_layout Plain Layout
6435 \begin_layout Plain Layout
6448 \begin_layout Plain Layout
6456 \begin_inset Phantom Phantom
6459 \begin_layout Plain Layout
6469 \begin_layout Plain Layout
6483 <cell alignment="left" valignment="top" usebox="none">
6486 \begin_layout Plain Layout
6490 \begin_layout Plain Layout
6503 \begin_layout Plain Layout
6511 \begin_inset Phantom Phantom
6514 \begin_layout Plain Layout
6524 \begin_layout Plain Layout
6536 <cell alignment="left" valignment="top" usebox="none">
6539 \begin_layout Plain Layout
6543 \begin_layout Plain Layout
6556 \begin_layout Plain Layout
6564 \begin_inset Phantom Phantom
6567 \begin_layout Plain Layout
6577 \begin_layout Plain Layout
6589 <cell alignment="left" valignment="top" usebox="none">
6592 \begin_layout Plain Layout
6596 \begin_layout Plain Layout
6609 \begin_layout Plain Layout
6617 \begin_inset Phantom Phantom
6620 \begin_layout Plain Layout
6630 \begin_layout Plain Layout
6642 <cell alignment="left" valignment="top" usebox="none">
6645 \begin_layout Plain Layout
6649 \begin_layout Plain Layout
6662 \begin_layout Plain Layout
6670 \begin_inset Phantom Phantom
6673 \begin_layout Plain Layout
6683 \begin_layout Plain Layout
6695 <cell alignment="left" valignment="top" usebox="none">
6698 \begin_layout Plain Layout
6712 \begin_layout Standard
6713 , and the ones listed in Appendix
6714 \begin_inset space ~
6720 \begin_inset space ~
6728 \begin_layout Subsubsection
6732 \begin_layout Standard
6733 The background color is changed with the option
6740 \begin_layout Standard
6741 \begin_inset Flex Color Box
6744 \begin_layout Plain Layout
6745 \begin_inset Argument 1
6748 \begin_layout Plain Layout
6749 colback=red!66!green!70!blue
6762 \begin_layout Subsubsection
6766 \begin_layout Standard
6767 The frame color is changed with the option
6774 \begin_layout Standard
6775 \begin_inset Flex Color Box
6778 \begin_layout Plain Layout
6779 \begin_inset Argument 1
6782 \begin_layout Plain Layout
6783 colframe=red!30!blue
6796 \begin_layout Subsubsection
6800 \begin_layout Standard
6801 The title background color is changed with the option
6808 \begin_layout Standard
6809 \begin_inset Flex Color Box
6812 \begin_layout Plain Layout
6813 \begin_inset Argument 1
6816 \begin_layout Plain Layout
6817 title=A title, colbacktitle=green!30
6822 Title background color
6830 \begin_layout Subsubsection
6832 \begin_inset CommandInset label
6834 name "subsec:Title-text"
6841 \begin_layout Standard
6842 The color for the title text is changed with the option
6849 \begin_layout Standard
6850 \begin_inset Flex Color Box
6853 \begin_layout Plain Layout
6854 \begin_inset Argument 1
6857 \begin_layout Plain Layout
6858 title=A title, coltitle=orange
6871 \begin_layout Subsubsection
6875 \begin_layout Standard
6876 The color for the complete text is changed with the option
6883 \begin_layout Standard
6884 \begin_inset Flex Color Box
6887 \begin_layout Plain Layout
6888 \begin_inset Argument 1
6891 \begin_layout Plain Layout
6905 \begin_layout Subsubsection
6906 Upper and lower text
6909 \begin_layout Standard
6910 The color for the upper and lower part text is changed with the option
6921 \begin_layout Standard
6922 \begin_inset Flex Color Box
6925 \begin_layout Plain Layout
6926 \begin_inset Argument 1
6929 \begin_layout Plain Layout
6930 colupper=green!30!blue, collower=green!70!blue
6938 \begin_layout Color Box Separator
6942 \begin_layout Plain Layout
6951 \begin_layout Bibliography
6952 \begin_inset CommandInset bibitem
6953 LatexCommand bibitem
6959 \begin_inset CommandInset href
6961 name "Documentation"
6962 target "http://mirrors.ctan.org/macros/latex/contrib/tcolorbox/tcolorbox.pdf"
6966 of the \SpecialChar LaTeX