]> git.lyx.org Git - features.git/commitdiff
colored-boxes.lyx: new example file for the tcolorbox.module
authorUwe Stöhr <uwestoehr@lyx.org>
Mon, 19 Oct 2015 05:10:09 +0000 (07:10 +0200)
committerUwe Stöhr <uwestoehr@lyx.org>
Mon, 19 Oct 2015 05:10:09 +0000 (07:10 +0200)
- also improve the tcolorbox.module

This is a fileformat change - only to be able to revert the new styles defined in the module.

development/FORMAT
lib/Makefile.am
lib/examples/colored-boxes.lyx [new file with mode: 0644]
lib/layouts/tcolorbox.module
lib/lyx2lyx/LyX.py
lib/lyx2lyx/lyx_2_2.py
lib/ui/stdmenus.inc
src/version.h

index 7861f6272a8018d548de09dfae0ee2d60cea113b..deb04c11ad1403a3a6e63be3ce02cd649063e6e5 100644 (file)
@@ -11,6 +11,13 @@ adjustments are made to tex2lyx and bugs are fixed in lyx2lyx.
 
 -----------------------
 
+2015-10-19 Uwe Stöhr <uwestoehr@web.de>
+       * Format incremented to 498
+         tcolorbox module improvements:
+         - 5 new custom box insets
+         - new subtitle inset
+         - new raster box inset
+
 2015-07-16 Georg Baum  <Georg.Baum@post.rwth-aachen.de>
        * Format incremented to 497
          The boundingBox parameter of InsetExternal uses units now
index 9f815f36623e9dbae8244cdb06ec84486f69ca4f..a25f0659548ec12b1b9c261245657c0eec35eb0d 100644 (file)
@@ -309,6 +309,7 @@ dist_examples_DATA = \
        examples/biblioExample.bib \
        examples/chess-article.lyx \
        examples/chessgame.lyx \
+       examples/colored-boxes.lyx \
        examples/docbook_article.lyx \
        examples/europeCV.lyx \
        examples/europassCV.lyx \
diff --git a/lib/examples/colored-boxes.lyx b/lib/examples/colored-boxes.lyx
new file mode 100644 (file)
index 0000000..2993ef6
--- /dev/null
@@ -0,0 +1,6973 @@
+#LyX 2.2 created this file. For more info see http://www.lyx.org/
+\lyxformat 497
+\begin_document
+\begin_header
+\origin /systemlyxdir/examples/
+\textclass scrartcl
+\begin_preamble
+% if pdflatex is used
+\usepackage{ifpdf}
+\ifpdf
+
+% set fonts for nicer pdf view
+\IfFileExists{lmodern.sty}
+ {\usepackage{lmodern}}{}
+
+\fi % end if pdflatex is used
+
+% increase link area for cross-references and autoname them,
+\AtBeginDocument{\renewcommand{\ref}[1]{\mbox{\autoref{#1}}}}
+\@ifundefined{extrasenglish}{\usepackage[english]{babel}}{}
+\addto\extrasenglish{%
+ \renewcommand*{\equationautorefname}[1]{}%
+ \renewcommand{\sectionautorefname}{sec.\negthinspace}%
+ \renewcommand{\subsectionautorefname}{sec.\negthinspace}%
+ \renewcommand{\subsubsectionautorefname}{sec.\negthinspace}%
+}
+\end_preamble
+\options BCOR8mm, most, usenames, dvipsnames
+\use_default_options false
+\begin_modules
+tcolorbox
+\end_modules
+\maintain_unincluded_children false
+\language english
+\language_package default
+\inputencoding auto
+\fontencoding global
+\font_roman default
+\font_sans default
+\font_typewriter default
+\font_math auto
+\font_default_family default
+\use_non_tex_fonts false
+\font_sc false
+\font_osf false
+\font_sf_scale 100
+\font_tt_scale 100
+\graphics default
+\default_output_format default
+\output_sync 0
+\bibtex_command bibtex
+\index_command default
+\paperfontsize 12
+\spacing single
+\use_hyperref true
+\pdf_title "Description of the module tcolorbox"
+\pdf_author "Uwe Stöhr"
+\pdf_subject "fancy colored boxes"
+\pdf_keywords "LyX, tcolorbox, colored boxes"
+\pdf_bookmarks true
+\pdf_bookmarksnumbered true
+\pdf_bookmarksopen true
+\pdf_bookmarksopenlevel 3
+\pdf_breaklinks false
+\pdf_pdfborder true
+\pdf_colorlinks true
+\pdf_backref false
+\pdf_pdfusetitle false
+\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, urlbordercolor={1 0 0}"
+\papersize a4paper
+\use_geometry false
+\use_package amsmath 1
+\use_package amssymb 1
+\use_package cancel 0
+\use_package esint 1
+\use_package mathdots 1
+\use_package mathtools 1
+\use_package mhchem 1
+\use_package stackrel 0
+\use_package stmaryrd 0
+\use_package undertilde 0
+\cite_engine basic
+\cite_engine_type default
+\biblio_style plain
+\use_bibtopic false
+\use_indices false
+\paperorientation portrait
+\suppress_date true
+\justification true
+\use_refstyle 0
+\notefontcolor #0000ff
+\index Index
+\shortcut idx
+\color #008000
+\end_index
+\secnumdepth 3
+\tocdepth 3
+\paragraph_separation skip
+\defskip medskip
+\quotes_language english
+\papercolumns 1
+\papersides 1
+\paperpagestyle default
+\tracking_changes false
+\output_changes false
+\html_math_output 0
+\html_css_as_file 0
+\html_be_strict false
+\end_header
+
+\begin_body
+
+\begin_layout Title
+Description of the module Fancy Colored Boxes
+\end_layout
+
+\begin_layout Author
+Uwe Stöhr
+\end_layout
+
+\begin_layout Standard
+With the module 
+\emph on
+Fancy
+\begin_inset space ~
+\end_inset
+
+Colored
+\begin_inset space ~
+\end_inset
+
+Boxes
+\emph default
+ you have access to a huge variety of colored boxes.
+ They are particularly useful for presentations or educational texts where
+ you might for example highlight results or equations.
+ This document describes how these boxes are used with \SpecialChar LyX
+.
+\end_layout
+
+\begin_layout Standard
+The fancy boxes are generated by the \SpecialChar LaTeX
+ package 
+\series bold
+tcolorbox
+\series default
+.
+ This package has so many features so that its manual exceeds 400
+\begin_inset space ~
+\end_inset
+
+pages.
+ \SpecialChar LyX
+ can therefore only provide access to its basic features.
+ For more advanced features and examples have a loot at the 
+\series bold
+tcolorbox
+\series default
+ manual, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "tcolorbox"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Section
+Preparation
+\end_layout
+
+\begin_layout Standard
+At first load the module 
+\family sans
+Fancy
+\begin_inset space ~
+\end_inset
+
+Colored
+\begin_inset space ~
+\end_inset
+
+Boxes
+\family default
+ in the document settings of your file.
+\end_layout
+
+\begin_layout Standard
+Add the following options to the document class options in the document
+ settings of your file:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+most, usenames, dvipsnames
+\end_layout
+
+\begin_layout Standard
+The option 
+\series bold
+most
+\series default
+ loads most of the libraries of the \SpecialChar LaTeX
+ package 
+\series bold
+tcolorbox
+\series default
+.
+ The options 
+\series bold
+usenames, dvipsnames
+\series default
+ load additional colors, see Appendix
+\begin_inset space ~
+\end_inset
+
+C of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual for a list.
+\end_layout
+
+\begin_layout Section
+Basics
+\end_layout
+
+\begin_layout Subsection
+Box types
+\end_layout
+
+\begin_layout Subsubsection
+Static (Standard)
+\end_layout
+
+\begin_layout Standard
+A static color box is inserted via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets\SpecialChar menuseparator
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+This is a static color box: 
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+A basic color box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+It has by default a frame with round corners and consumes the full text
+ width.
+ It can contain several paragraphs and math.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ the box can contain forced page breaks but they will be ignored.
+ To get breakable boxes, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Beakable-boxes"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Dynamic
+\end_layout
+
+\begin_layout Standard
+A dynamic color box is inserted via inset via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets\SpecialChar menuseparator
+Dynamic
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+This is a dynamic color box: 
+\begin_inset Flex Dynamic Color Box
+status open
+
+\begin_layout Plain Layout
+A dynamic color box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+In contrary to static boxes dynamic boxes cannot have parts, they cannot
+ made breakable but one can set their vertical placement, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Vertical"
+
+\end_inset
+
+.
+ Their width is by default the width of the content.
+\end_layout
+
+\begin_layout Subsubsection
+Fit
+\end_layout
+
+\begin_layout Standard
+A fit color box insert is inserted via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets\SpecialChar menuseparator
+Fit
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+Fit boxes are dynamic boxes but their content is automatically decreased
+ or increased to fit into the specified box width and heigh.
+ How to specify a width and height is described in 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Geometry"
+
+\end_inset
+
+.
+ If no width and height is specified the result is a square box consuming
+ the full available width of the page.
+ If only a width is specified, the result is a square box.
+\end_layout
+
+\begin_layout Standard
+This is a fit color box:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Fit Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide fit color box with some text.
+ A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide fit color box with some text.
+ A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide fit color box with some text.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Another fit color box: 
+\begin_inset Flex Fit Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=5cm, height=3cm
+\end_layout
+
+\end_inset
+
+A 5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide and 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high fit color box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The examples show that the text will be shrinked to fit into the box but
+ it will not be increased.
+\end_layout
+
+\begin_layout Subsubsection
+Custom
+\end_layout
+
+\begin_layout Standard
+A custom color box is inserted via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets\SpecialChar menuseparator
+Custom Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+#
+\family default
+ where # is the number.
+\end_layout
+
+\begin_layout Standard
+How to use and customize the custom color boxes, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:General"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection
+Titles
+\end_layout
+
+\begin_layout Standard
+To add a title to a box add an options inset via the menu Insert\SpecialChar menuseparator
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+Options.
+ There write 
+\series bold
+title=
+\series default
+ followed by your title.
+\end_layout
+
+\begin_layout Standard
+This is a titled box: 
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title
+\end_layout
+
+\end_inset
+
+A basic box with a title.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+A subtitle is added with the inset 
+\family sans
+Subtitle
+\family default
+ via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets
+\family default
+:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=The title
+\end_layout
+
+\end_inset
+
+A basic box with a subtitle.
+\begin_inset Flex Subtitle
+status open
+
+\begin_layout Plain Layout
+The subtitle
+\end_layout
+
+\end_inset
+
+ The content below the subtitle.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The title and subtitle text is by default white.
+ How to change its color, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Title-text"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection
+Box parts
+\end_layout
+
+\begin_layout Standard
+The content of the box can be divided into an upper and a lower part with
+ by using the environment 
+\family sans
+Color Box Separator
+\family default
+ in \SpecialChar LyX
+'s environment selection combobox.
+ The idea behind this is that both parts can be treated and customized separatel
+y.
+ An example would be where the upper part contains a description and the
+ lower part an equation.
+\end_layout
+
+\begin_layout Standard
+This is a box where the content is separated:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The separation line can be customized as described in 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Lines"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+The separation can also be made side by side with the box option 
+\series bold
+sidebyside
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sidebyside
+\end_layout
+
+\end_inset
+
+Upper content at the left
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content at the right
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The separation can be made invisible with the box option 
+\series bold
+lower separated=false
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sidebyside, lower separated=false
+\end_layout
+
+\end_inset
+
+Upper content invisibly separated
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content at the right
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+There are several layout skins available for colored boxes, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Beamer"
+
+\end_inset
+
+, that affects also the layout of the box parts.
+ For example with the box option 
+\series bold
+beamer
+\series default
+ the box parts are separated this way:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+beamer
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Lines
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Lines"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To draw a line in a box use the environment 
+\family sans
+Color Box Line
+\family default
+.
+ The line is by default dashed.
+ it is just a line and does not separate box parts.
+\end_layout
+
+\begin_layout Standard
+This is a box where the content is divided:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+Some text
+\end_layout
+
+\begin_layout Color Box Line
+
+\end_layout
+
+\begin_layout Plain Layout
+Some text
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The line style can be changed with the box option 
+\series bold
+segmentation style={}
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ The braces and its content must be inserted as \SpecialChar TeX
+ code.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To be able to use this option, the option 
+\series bold
+enhanced
+\series default
+ needs to be added too.
+ Here is an example with a double blue line:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+enhanced, segmentation style={double=white,draw=blue,double distance=1pt,solid}
+\end_layout
+
+\end_inset
+
+Some text
+\end_layout
+
+\begin_layout Color Box Line
+
+\end_layout
+
+\begin_layout Plain Layout
+Some text
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+For more details have a loot at the 
+\series bold
+tcolorbox
+\series default
+ manual, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "tcolorbox"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Section
+Breakable boxes
+\begin_inset CommandInset label
+LatexCommand label
+name "sec:Beakable-boxes"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To make a box breakable the option breakable is added.
+ If a page break occurs within a box, the box will get broken this way:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A breakable box, breakable, title after break=continued...
+\end_layout
+
+\end_inset
+
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+In the above example the special title 
+\emph on
+continued...
+
+\emph default
+ was added for the second page of the box with the option 
+\series bold
+title after break
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+If boxes are inside boxes, only the outer box can be made breakable.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ Dynamic boxes and fit boxes cannot be made breakable!
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Section
+Customization
+\end_layout
+
+\begin_layout Subsection
+General
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:General"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The following subsections show many possibilities to customize boxes.
+\end_layout
+
+\begin_layout Standard
+In real documents one wants only a few types of boxes and all boxes of a
+ type should look identical.
+ To avoid to write the box commands all the time, you can use the environment
+\family sans
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+Setup
+\family default
+.
+ It is inserted via \SpecialChar LyX
+'s style selection combobox.
+ There you can write all options that should be applied for all boxes of
+ the document 
+\emph on
+following
+\emph default
+ the environment.
+ For example writing there 
+\series bold
+width=3cm, height=8cm
+\series default
+ forces all following boxes to have a height of 8
+\begin_inset space \thinspace{}
+\end_inset
+
+cm and a width of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\begin_layout Standard
+This is not useful if one needs several box types since the changes would
+ affect 
+\emph on
+all
+\emph default
+ boxes.
+ Therefore the module 
+\emph on
+Fancy
+\begin_inset space ~
+\end_inset
+
+Colored
+\begin_inset space ~
+\end_inset
+
+Boxes
+\emph default
+ predefines 5
+\begin_inset space ~
+\end_inset
+
+different box types which you can customize.
+ To change their appearance use the environment 
+\family sans
+New
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+Type
+\family default
+.
+ It is inserted via \SpecialChar LyX
+'s style selection combobox.
+\end_layout
+
+\begin_layout Standard
+If you want for example a box type that looks like the fancy colored one
+ in 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Enhanced"
+
+\end_inset
+
+ use these options in the environment:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+enhanced, frame style={left color=red!75!black, right color=blue!75!black},
+ interior style={left color=red!20!white, right color=yellow!50!white}
+\end_layout
+
+\begin_layout Standard
+Into the 
+\family sans
+Name
+\family default
+ inset write 
+\series bold
+cBoxA
+\series default
+ (cBoxA is custom box type
+\begin_inset space ~
+\end_inset
+
+1, cBoxB type
+\begin_inset space ~
+\end_inset
+
+2 etc.).
+ Because you want to customize every box of this type (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+every box should have its own title), you need one argument.
+ Therefore add 
+\series bold
+1
+\series default
+ into the Arguments inset of the environment.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ If you use an argument, the inset 
+\family sans
+Default Value
+\family default
+ must also be inserted but left empty!
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout New Color Box Type
+\begin_inset Argument 2
+status open
+
+\begin_layout Plain Layout
+cBoxA
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 3
+status open
+
+\begin_layout Plain Layout
+1
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 4
+status open
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+
+enhanced, frame style={left color=red!75!black, right color=blue!75!black},
+ interior style={left color=red!20!white, right color=yellow!50!white},
+ #1
+\end_layout
+
+\begin_layout Standard
+Now every 
+\family sans
+Custom
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+1
+\family default
+ will look like this:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Custom Color Box 1
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=Custom box
+\end_layout
+
+\end_inset
+
+Custom color box 1
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+Another example:
+\begin_inset Newline newline
+\end_inset
+
+Assuming you need a box type that can be numbered, you insert
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+auto counter, number within=section
+\end_layout
+
+\begin_layout Standard
+into the 
+\family sans
+New
+\series bold
+\series default
+Box Options
+\family default
+ inset of the 
+\family sans
+New
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+Type
+\family default
+ environment.
+ The 
+\family sans
+Name
+\family default
+ is 
+\series bold
+cBoxB
+\series default
+.
+ The Argument is 
+\series bold
+1
+\series default
+.
+ Now write
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+colback=red!5!white, colframe=red!75!black, title=Example~
+\backslash
+thetcbcounter : #1
+\end_layout
+
+\begin_layout Standard
+into the environment.
+ This predefines a title prefix.
+\series bold
+
+\backslash
+tcbcounter
+\series default
+ is hereby the counter of colored boxes.
+ In your 
+\family sans
+Custom
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+2
+\family default
+ you specify the title via the options inset:
+\end_layout
+
+\begin_layout New Color Box Type
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+auto counter, number within=section
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 2
+status open
+
+\begin_layout Plain Layout
+cBoxB
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 3
+status open
+
+\begin_layout Plain Layout
+1
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 4
+status open
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+
+colback=red!5!white, colframe=red!75!black, title=Example~
+\backslash
+thetcbcounter : #1
+\end_layout
+
+\begin_layout Standard
+a
+\begin_inset Flex Custom Color Box 2
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Custom numbered title
+\end_layout
+
+\end_inset
+
+Custom color box 2
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Note that you must not write 
+\series bold
+title=
+\series default
+ because this is already done in the definition.
+\end_layout
+
+\begin_layout Standard
+You can still customize the box by adding options 
+\emph on
+behind
+\emph default
+ the title:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Custom Color Box 2
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+Bold numbered title, colback=lime, fonttitle=
+\backslash
+bfseries
+\end_layout
+
+\end_inset
+
+Custom color box 2
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+At last a more advanced example:
+\begin_inset Newline newline
+\end_inset
+
+Assuming you need the type we just defined as 
+\family sans
+Custom
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+2
+\family default
+ but want to add more than one option.
+ This is for example useful for options that require another option before
+ in the options list.
+\begin_inset Newline newline
+\end_inset
+
+Like before, add 
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+auto counter, number within=section
+\end_layout
+
+\begin_layout Standard
+into the 
+\family sans
+New
+\series bold
+\series default
+Box Options
+\family default
+ inset of the 
+\family sans
+New
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+Type
+\family default
+ environment.
+ The 
+\family sans
+Name
+\family default
+ is 
+\series bold
+cBoxC
+\series default
+.
+ Now we need 2
+\begin_inset space ~
+\end_inset
+
+Arguments, the Argument is therefore 
+\series bold
+2
+\series default
+.
+ Now write
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+nobeforeafter, width=#1, square, colframe=orange!50!black, 
+\begin_inset Newline newline
+\end_inset
+
+title=Example~
+\backslash
+thetcbcounter : #2
+\end_layout
+
+\begin_layout Standard
+into the environment.
+ In your 
+\family sans
+Custom
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\begin_inset space ~
+\end_inset
+
+3
+\family default
+ you specify the width via the 
+\family sans
+Color Box Options
+\family default
+ inset and the title (and further options if you like) via the 
+\family sans
+More Color Box Options
+\family default
+ inset:
+\end_layout
+
+\begin_layout New Color Box Type
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+auto counter, number within=section
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 2
+status open
+
+\begin_layout Plain Layout
+cBoxC
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 3
+status open
+
+\begin_layout Plain Layout
+2
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 4
+status open
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+
+nobeforeafter, width=#1, square, colframe=orange!50!black, title=Example~
+\backslash
+thetcbcounter : #2
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Custom Color Box 3
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+4cm
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 2
+status open
+
+\begin_layout Plain Layout
+The title
+\end_layout
+
+\end_inset
+
+4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide custom color box 3
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Custom Color Box 3
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+4cm
+\end_layout
+
+\end_inset
+
+
+\begin_inset Argument 2
+status open
+
+\begin_layout Plain Layout
+The title, beamer
+\end_layout
+
+\end_inset
+
+4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide custom color box 3 with the 
+\emph on
+beamer
+\emph default
+ skin
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Skins
+\end_layout
+
+\begin_layout Standard
+The \SpecialChar LaTeX
+ package tcolorbox provides different skins.
+ For a full list, see the tcolorbox manual, section 
+\family sans
+Library
+\begin_inset space ~
+\end_inset
+
+skins
+\family default
+, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "tcolorbox"
+
+\end_inset
+
+.
+ Only the most important skins are listed in the following.
+\end_layout
+
+\begin_layout Subsubsection
+Enhanced
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Enhanced"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+This skin is enabled by adding the option enhanced.
+ Without further options it looks like the standard skin.
+ Its advantage are some extra features like the customization of lines,
+ see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Lines"
+
+\end_inset
+
+.
+ Another feature is a nicer view of breakable boxes:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=An 
+\emph on
+enhanced
+\emph default
+ breakable box, breakable, enhanced
+\end_layout
+
+\end_inset
+
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+ eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+ voluptua.
+ At vero eos et accusam et justo duo dolores et ea rebum.
+ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
+ sit amet.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+A feature you might like is to add color gradient with the options 
+\series bold
+frame style
+\series default
+ and 
+\series bold
+interior style
+\series default
+.
+ Its syntax is 
+\series bold
+frame style={left color=color, right color=color}
+\series default
+ where 
+\series bold
+color
+\series default
+ is a color name or definition, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Color"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=An 
+\emph on
+enhanced
+\emph default
+ box with a color gradient, enhanced, frame style={left color=red!75!black,
+ right color=blue!75!black}, interior style={left color=red!20!white, right
+ color=yellow!50!white}
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Alternatively one can use a PNG image as background for boxes with the option
+\series bold
+frame style image=file name
+\series default
+ where 
+\series bold
+file
+\begin_inset space ~
+\end_inset
+
+name
+\series default
+ is the file name of the image.
+\end_layout
+
+\begin_layout Subsubsection
+Bicolor
+\end_layout
+
+\begin_layout Standard
+With this skin the lower content gets another background color than the
+ upper part.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box with the skin 
+\emph on
+bicolor
+\emph default
+, bicolor
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The color of the lower part can be changed with the option 
+\series bold
+colbacklower
+\series default
+.
+ See also 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Color"
+
+\end_inset
+
+ for color customization.
+\end_layout
+
+\begin_layout Standard
+Shadow drop shadow
+\end_layout
+
+\begin_layout Subsubsection
+Beamer
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Beamer"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+This is a skin that simulates the appearance of the beamer presentation
+ document class.
+ Its appearance can be changed like for the enhanced skin, 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Enhanced"
+
+\end_inset
+
+:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A 
+\emph on
+beamer
+\emph default
+ box with a color gradient, beamer, frame style={left color=red!75!black,
+ right color=blue!75!black}
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Widget
+\end_layout
+
+\begin_layout Standard
+This skin is like the standard skin but the background colors are automatically
+ shaded:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A 
+\emph on
+widget
+\emph default
+ box, widget
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Empty
+\end_layout
+
+\begin_layout Standard
+This skin has no colors.
+ To make the title visible (because it is by default white) you have to
+ change its color, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Title-text"
+
+\end_inset
+
+:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box with the 
+\emph on
+empty
+\emph default
+ skin, empty, coltitle=orange
+\end_layout
+
+\end_inset
+
+Upper content
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Placement
+\end_layout
+
+\begin_layout Subsubsection
+Side by side
+\end_layout
+
+\begin_layout Standard
+Normally the boxes are a paragraph of its own.
+ They will therefore appear by default one upon another separated by vertical
+ space.
+ To change this behavior to place for example boxes side by side and uses
+ the placement options 
+\series bold
+before=code
+\series default
+ and 
+\series bold
+after=code
+\series default
+.
+ By default there is a paragraph break before and after the box.
+ By using the options 
+\series bold
+before=, after=
+\series default
+ nothing will be added besides the boxes so that they can be places side
+ by side:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, before=, after=
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, before=, after=
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, before=, after=
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The option 
+\series bold
+nobeforeafter
+\series default
+ is an alternative for 
+\series bold
+before=, after=
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+To separate the boxes one can use the normal \SpecialChar LyX
+ spacing features like a horizontal
+ fill:
+\end_layout
+
+\begin_layout Standard
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, nobeforeafter
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, nobeforeafter
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square, valign=center, nobeforeafter
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+If you prefer \SpecialChar TeX
+ code you can alternative use the option 
+\series bold
+after=
+\backslash
+hfill
+\series default
+ to add a a horizontal fill.
+\end_layout
+
+\begin_layout Subsubsection
+Floating
+\end_layout
+
+\begin_layout Standard
+Like for tables and figures in a document it is very helpful if boxes could
+ float in the text to be placed at the optimal position.
+ This is achieved by the option 
+\series bold
+float=options
+\series default
+ where 
+\series bold
+options
+\series default
+ are the optional \SpecialChar TeX
+ floating placement options 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+h
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+t
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+b
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+, and 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+p
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ They correspond to the float placement options described in section 
+\family sans
+Float
+\begin_inset space ~
+\end_inset
+
+Placement
+\family default
+ of the of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ The placement options can be mixed and are inserted without any separation,
+ e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+htbp
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A floating box, float, width=5cm, valign=center
+\end_layout
+
+\end_inset
+
+A 5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide floating box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+For floating boxes the options 
+\series bold
+before=code
+\series default
+ and 
+\series bold
+after=code 
+\series default
+are ignored.
+ One can instead insert code with the command 
+\series bold
+every float=code
+\series default
+ before the box.
+ If the box is breakable the code is inserted before every part of the break
+ sequence.
+ A typical application is to center the floating box with 
+\series bold
+every float=
+\backslash
+centering:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A floating box, float, width=5cm, valign=center, every float=
+\backslash
+centering
+\end_layout
+
+\end_inset
+
+A 5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide floating box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Vertical
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Vertical"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The vertical placement of a box in respect to the surrounding text line
+ can only be set for dynamic boxes.
+ The option 
+\series bold
+tcbox raise=length
+\series default
+ raises or lowers the box.
+\series bold
+length
+\series default
+ is a value.
+ The allowed units for values are listed in Appendix
+\begin_inset space ~
+\end_inset
+
+A of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ The default width is 
+\series bold
+tcbox raise=0pt
+\series default
+.
+ With the option 
+\series bold
+tcbox raise base
+\series default
+ the box is lowered that the base of the box content matches the base of
+ the surrounding line.
+\end_layout
+
+\begin_layout Standard
+An example:
+\end_layout
+
+\begin_layout Standard
+A line......
+\begin_inset Flex Dynamic Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+tcbox raise base, nobeforeafter
+\end_layout
+
+\end_inset
+
+Lowered to base
+\end_layout
+
+\end_inset
+
+......
+\begin_inset Flex Dynamic Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+nobeforeafter
+\end_layout
+
+\end_inset
+
+Default placement
+\end_layout
+
+\end_inset
+
+......
+\begin_inset Flex Dynamic Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+tcbox raise=1cm, nobeforeafter
+\end_layout
+
+\end_inset
+
+Raised 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm
+\end_layout
+
+\end_inset
+
+...
+\end_layout
+
+\begin_layout Subsubsection
+Raster
+\end_layout
+
+\begin_layout Standard
+The easiest way to place boxes in a table-like raster is to put them into
+ a raster box.
+ To get a raster box insert a 
+\family sans
+Raster
+\begin_inset space ~
+\end_inset
+
+Color
+\begin_inset space ~
+\end_inset
+
+Box
+\family default
+ inset via the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Custom Insets
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+The number of columns is specified with the option 
+\series bold
+raster columns=number
+\series default
+ where 
+\series bold
+number
+\series default
+ is the number of columns.
+ All boxes inserted to the raster box will now automatically be output in
+ a raster with 3 columns and their width is automatically adjusted.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Raster Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+raster columns=3
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Plain Layout
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box
+\end_layout
+
+\end_inset
+
+A simple box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box
+\end_layout
+
+\end_inset
+
+A simple box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box
+\end_layout
+
+\end_inset
+
+A simple box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box
+\end_layout
+
+\end_inset
+
+A simple box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A box
+\end_layout
+
+\end_inset
+
+A simple box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+For more info options of the raster color box, please consult the 
+\series bold
+tcolorbox
+\series default
+ manual, section 
+\family sans
+Library
+\begin_inset space ~
+\end_inset
+
+raster
+\family default
+, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "tcolorbox"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection
+Geometry
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Geometry"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Width
+\end_layout
+
+\begin_layout Subsubsection*
+Complete box
+\end_layout
+
+\begin_layout Standard
+The width of the box is changed with the option 
+\series bold
+width=length
+\series default
+ where 
+\series bold
+length
+\series default
+ is a value.
+ The allowed units for values are listed in Appendix
+\begin_inset space ~
+\end_inset
+
+A of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ The default width is 
+\series bold
+width=1
+\backslash
+linewidth
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=6cm
+\end_layout
+
+\end_inset
+
+A 6
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+One can also set a width only for the text of the box with the option 
+\series bold
+text width=length
+\series default
+.
+ If the width is shorter than required for the text new lines will be created
+ automatically.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+text width=4cm
+\end_layout
+
+\end_inset
+
+Some longer text to fill the box with a width of 4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+One cannot combine 
+\series bold
+width
+\series default
+ and 
+\series bold
+text width
+\series default
+ because only the last given width option is taken into account.
+\end_layout
+
+\begin_layout Standard
+To extend the width of the box one must use the 
+\series bold
+width
+\series default
+ option and can then uses the option 
+\series bold
+add to width=length
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=10cm, add to width=2cm
+\end_layout
+
+\end_inset
+
+A 10
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide box with additional width of 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection*
+Content
+\end_layout
+
+\begin_layout Standard
+For boxes with parts side by side one can control the width of the box parts
+ with the options 
+\series bold
+sidebyside gap
+\series default
+, 
+\series bold
+lefthand width
+\series default
+, 
+\series bold
+righthand width
+\series default
+, 
+\series bold
+lefthand ratio
+\series default
+ and 
+\series bold
+righthand ratio
+\series default
+.
+ The syntax is 
+\series bold
+sidebyside gap=length
+\series default
+ where 
+\series bold
+length
+\series default
+ is a value.
+ The allowed units for the values are listed in Appendix
+\begin_inset space ~
+\end_inset
+
+A of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ All option require of course the option sidebyside.
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+sidebyside gap
+\series default
+ sets the space between the left and the right part.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sidebyside, sidebyside gap=2cm
+\end_layout
+
+\end_inset
+
+Upper content divided by 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+lefthand width
+\series default
+ and 
+\series bold
+righthand width
+\series default
+ sets the absolute width of the left and right part, respectively.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sidebyside, lefthand width=3cm
+\end_layout
+
+\end_inset
+
+Upper content with a width of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+lefthand ratio
+\series default
+ and 
+\series bold
+righthand ratio
+\series default
+ sets the relative width of the left and right part, respectively.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sidebyside, lefthand ratio=0.3
+\end_layout
+
+\end_inset
+
+Upper content with a width of 30
+\begin_inset space \thinspace{}
+\end_inset
+
+% of the box width.
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Height
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Height"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection*
+Complete box
+\end_layout
+
+\begin_layout Standard
+The height of the box is changed with the option 
+\series bold
+height=length
+\series default
+ where 
+\series bold
+length
+\series default
+ is a value.
+ The default height is the height consumed by the box content.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm
+\end_layout
+
+\end_inset
+
+A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+If the specified height is smaller then the one consumed by the content,
+ the content will be placed below the box:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2mm
+\end_layout
+
+\end_inset
+
+A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+mm high box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+With the option 
+\series bold
+square
+\series default
+ the height will automatically set to the same value than the box width.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3cm, square
+\end_layout
+
+\end_inset
+
+A squared box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+To extend the height of the box in case the content might consume more height
+ than expected one must use the 
+\series bold
+height
+\series default
+ option and can then uses the option 
+\series bold
+height plus=length
+\series default
+.
+ An application would be to set a maximal possible height in case you write
+ a book where the spacing is defined and should not be overwritten by any
+ value.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, height plus=2cm
+\end_layout
+
+\end_inset
+
+A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with additional height of 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, height plus=2cm
+\end_layout
+
+\end_inset
+
+A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with additional height of 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ Its content consumes 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm therefore the box height will also be 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with additional height of 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ Its content consumes 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm therefore the box height will also be 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ A 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with additional height of 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ Its content consumes 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm therefore the box height will also be 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+In some cases it might be useful to specify an allowed range for the height
+ with the option 
+\series bold
+height from=min to max
+\series default
+ where 
+\series bold
+min
+\series default
+ and 
+\series bold
+max
+\series default
+ are values.
+ The height will then be at least the given minimal value or the height
+ consumed by the content.
+ It does not exceed the maximum independent of the content:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height from=1cm to 3cm
+\end_layout
+
+\end_inset
+
+A box with minimal height of 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm and maximal height of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height from=1cm to 3cm
+\end_layout
+
+\end_inset
+
+A box with minimal height of 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm and maximal height of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ A box with minimal height of 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm and maximal height of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+ A box with minimal height of 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm and maximal height of 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+With the option 
+\series bold
+add to height=length
+\series default
+ one can add defined height to the box.
+ To use this the 
+\series bold
+height
+\series default
+ option must be added 
+\emph on
+before
+\emph default
+ it.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=1.5cm, add to height=1cm
+\end_layout
+
+\end_inset
+
+A 1.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm additional height.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+With the option 
+\series bold
+height fill=value
+\series default
+ one can force the box to consume the rest of the available height of the
+ document parts where it is in.
+\series bold
+value
+\series default
+ can either be 
+\series bold
+true
+\series default
+ or 
+\series bold
+maximum
+\series default
+.
+ The latter works like 
+\series bold
+true
+\series default
+ but compresses the content of the page before the box as much as possible
+ to maximize the box.
+\begin_inset Newline newline
+\end_inset
+
+In this example the box is in the main text and therefore consumes the rest
+ of the current page.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height fill=true
+\end_layout
+
+\end_inset
+
+A box that fills the remaining height of the current page.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection*
+Content
+\end_layout
+
+\begin_layout Standard
+One can set a height only for the text of the box with the option
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+text height=length
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+text height=1.5cm
+\end_layout
+
+\end_inset
+
+A box with 1.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high content.
+ Due to the frame separation and the frame width the box height is larger
+ than 1.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+One cannot combine 
+\series bold
+height
+\series default
+ and 
+\series bold
+text height
+\series default
+ because only the last given width option is taken into account.
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+With the options 
+\series bold
+space=fraction
+\series default
+, 
+\series bold
+space to upper
+\series default
+, 
+\series bold
+space to lower
+\series default
+, 
+\series bold
+space to both
+\series default
+ and 
+\series bold
+split=fraction
+\series default
+ one can specify how the height should be divided between the upper and
+ the lower part.
+ For the 
+\series bold
+space
+\series default
+ option 
+\series bold
+fraction
+\series default
+ is the fraction of the additional height (the specified height minus the
+ height consumed by the content).
+\begin_inset Newline newline
+\end_inset
+
+For example 
+\series bold
+space=0.75
+\series default
+ adds 75
+\begin_inset space \thinspace{}
+\end_inset
+
+% of the additional space to the upper part:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=3cm, space=0.75
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box where 75 % of the additional height is set to the upper content.
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+space to upper
+\series default
+ is equal to 
+\series bold
+space=1
+\series default
+, 
+\series bold
+space to lower
+\series default
+ is equal to 
+\series bold
+space=0
+\series default
+, 
+\series bold
+space to both
+\series default
+ is equal to 
+\series bold
+space=0
+\series default
+.5.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=3cm, space to upper
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box where all additional height is set to the upper content.
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+For the 
+\series bold
+split
+\series default
+ option 
+\series bold
+fraction
+\series default
+ is the fraction of the complete height (not the additional height).
+ Therefore one must be careful of e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+the upper part consumes more height than one set via 
+\series bold
+split
+\series default
+:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=3cm, split=0.1
+\end_layout
+
+\end_inset
+
+A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box where the height is split by 10
+\begin_inset space \thinspace{}
+\end_inset
+
+%.
+ A 3
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box where the height is split by 10
+\begin_inset space \thinspace{}
+\end_inset
+
+%.
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+With the option 
+\series bold
+equal height group=id
+\series default
+ it is possible to set the same height for all boxes in a group.
+\series bold
+id
+\series default
+ is a name to reference the group.
+ This is for example useful if one has 3
+\begin_inset space ~
+\end_inset
+
+boxes side by side inside a box:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+adjusted title=ice, width=0.3
+\backslash
+columnwidth, nobeforeafter, equal height group=A
+\end_layout
+
+\end_inset
+
+A box.
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+adjusted title=Grapefruit, width=0.3
+\backslash
+columnwidth, space to upper, nobeforeafter, equal height group=A
+\end_layout
+
+\end_inset
+
+A box with parts.
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+adjusted title=, width=0.3
+\backslash
+columnwidth, nobeforeafter, equal height group=A
+\end_layout
+
+\end_inset
+
+A box with longer text.
+ A box with longer text.
+ A box with longer text.
+ A box with longer text.
+ A box with longer text.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The above example was typeset by adding the option 
+\series bold
+equal height group=A
+\series default
+ to all 3
+\begin_inset space ~
+\end_inset
+
+boxes.
+\series bold
+A
+\series default
+ is hereby the name of the group.
+\end_layout
+
+\begin_layout Standard
+If you have a title that needs only a single line, it is recommended to
+ use the option 
+\series bold
+adjusted title
+\series default
+ instead of 
+\series bold
+title
+\series default
+ for all boxes to assure that the title height will be the same for all
+ boxes.
+ Otherwise the height would be different in the above example because 
+\begin_inset Quotes eld
+\end_inset
+
+Grapefruit
+\begin_inset Quotes erd
+\end_inset
+
+ needs more height than 
+\begin_inset Quotes eld
+\end_inset
+
+ice
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsubsection
+Frame
+\end_layout
+
+\begin_layout Standard
+The width of the box frame can be changed with the options 
+\series bold
+toprule
+\series default
+, 
+\series bold
+bottomrule
+\series default
+, 
+\series bold
+leftrule
+\series default
+, 
+\series bold
+rightrule
+\series default
+ and 
+\series bold
+titlerule
+\series default
+.
+ Each option changes the corresponding part of the frame.
+ The syntax is 
+\series bold
+toprule=length
+\series default
+ where 
+\series bold
+length
+\series default
+ is a value.
+ The allowed units for the values are listed in Appendix
+\begin_inset space ~
+\end_inset
+
+A of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ The default length for all parts is 0.5
+\begin_inset space \thinspace{}
+\end_inset
+
+mm.
+ To set all frame parts to the same value use the option 
+\series bold
+boxrule
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+leftrule=3mm, rightrule=4mm, toprule=2mm, bottomrule=1mm
+\end_layout
+
+\end_inset
+
+3
+\begin_inset space \thinspace{}
+\end_inset
+
+mm wide left rule, 4
+\begin_inset space \thinspace{}
+\end_inset
+
+mm wide right rule, 2
+\begin_inset space \thinspace{}
+\end_inset
+
+mm top rule and 1
+\begin_inset space \thinspace{}
+\end_inset
+
+mm bottom rule.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+boxrule=6mm
+\end_layout
+
+\end_inset
+
+A box with a 6
+\begin_inset space \thinspace{}
+\end_inset
+
+mm wide frame line.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The title rule is the separation between the title and the box content.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title, titlerule=8mm, colbacktitle=blue
+\end_layout
+
+\end_inset
+
+A box with a 8
+\begin_inset space \thinspace{}
+\end_inset
+
+mm wide title rule.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Shape
+\end_layout
+
+\begin_layout Standard
+By default boxes are rectangular with rounded edges.
+ The radius of the edges can be changed with the option 
+\series bold
+arc=length
+\series default
+ where 
+\series bold
+length
+\series default
+ is a value.
+ The allowed units for the values are listed in Appendix
+\begin_inset space ~
+\end_inset
+
+A of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+ The default is 
+\series bold
+arc=1mm
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+arc=0mm
+\end_layout
+
+\end_inset
+
+A rectangular box (
+\series bold
+arc=0
+\begin_inset space \thinspace{}
+\end_inset
+
+mm
+\series default
+).
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+With the option 
+\series bold
+outer arc=length
+\series default
+ one can set the outer radius independently:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+arc=5mm, outer arc=0mm
+\end_layout
+
+\end_inset
+
+A box with 
+\series bold
+arc=5
+\begin_inset space \thinspace{}
+\end_inset
+
+mm
+\series default
+\series bold
+outer arc=0
+\begin_inset space \thinspace{}
+\end_inset
+
+mm
+\series default
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+arc=0mm, outer arc=0mm
+\end_layout
+
+\end_inset
+
+A really rectangular box (
+\series bold
+arc
+\series default
+\emph on
+and
+\emph default
+\series bold
+outer arc=0
+\begin_inset space \thinspace{}
+\end_inset
+
+mm
+\series default
+).
+ The same can alternatively be achieved with the option 
+\series bold
+sharp corners=all
+\series default
+, see below.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+The general shape can be changed with the options 
+\series bold
+circular arc
+\series default
+, 
+\series bold
+bean arc
+\series default
+ and 
+\series bold
+octogon arc
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+The option 
+\series bold
+circular arc
+\series default
+ sets the edge radius to half of the box width.
+ It is therefore required to specify at least the width.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3.5cm, circular arc
+\end_layout
+
+\end_inset
+
+A 3.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide circular box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+As you can see circular box looks ugly when the box is wider than high.
+ It is therefore recommended to add the option 
+\series bold
+square
+\series default
+, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Height"
+
+\end_inset
+
+, to get the same width and height.
+ The result is a perfect circle.
+ The center the text in the box use the text alignment options described
+ in 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Alignment"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=4cm, square, valign=center, circular arc
+\end_layout
+
+\end_inset
+
+A 4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide circular box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The option 
+\series bold
+bean arc
+\series default
+ sets the edge radius to half of the minimum of the box width and height.
+ The result is a semicircle.
+\series bold
+bean arc
+\series default
+ requires the options 
+\series bold
+width
+\series default
+ and 
+\series bold
+height
+\series default
+ or 
+\series bold
+square
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=3.5cm, height=5cm, bean arc, nobeforeafter, valign=center
+\end_layout
+
+\end_inset
+
+A 3.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, 5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with 
+\series bold
+bean arc
+\series default
+.
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=5cm, height=3.5cm, bean arc, nobeforeafter, valign=center
+\end_layout
+
+\end_inset
+
+A 5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, 3.5
+\begin_inset space \thinspace{}
+\end_inset
+
+cm high box with 
+\series bold
+bean arc
+\series default
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Using bean arc for a square box leads to the same result as 
+\series bold
+circular arc
+\series default
+:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=4cm, square, bean arc, valign=center
+\end_layout
+
+\end_inset
+
+A 4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box as bean arc.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The option 
+\series bold
+octogon arc
+\series default
+ is useful to get an octagon.
+ For an octagon one needs a square box and the options 
+\series bold
+arc is angular
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=4cm, square, octogon arc, valign=center, arc is angular
+\end_layout
+
+\end_inset
+
+A 4
+\begin_inset space \thinspace{}
+\end_inset
+
+cm wide, square box with 
+\series bold
+octogon arc
+\series default
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ The option 
+\series bold
+arc is angular
+\series default
+ is experimental and might cause problems on some \SpecialChar LaTeX
+ systems.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace bigskip
+\end_inset
+
+It is also possible to change only some of the box edges.
+ To make an edge a corner there is the option 
+\series bold
+sharp corners=position
+\series default
+ where 
+\series bold
+position
+\series default
+ is the position of the edge.
+ The positions 
+\series bold
+northwest
+\series default
+, 
+\series bold
+northeast
+\series default
+, 
+\series bold
+southwest
+\series default
+ and 
+\series bold
+southeast
+\series default
+ change only the corresponding edge.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+sharp corners=northeast
+\end_layout
+
+\end_inset
+
+A box with a corner at the upper right (
+\series bold
+northeast
+\series default
+).
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The positions 
+\series bold
+north
+\series default
+, 
+\series bold
+south
+\series default
+, 
+\series bold
+east
+\series default
+, 
+\series bold
+west
+\series default
+, 
+\series bold
+downhill
+\series default
+ and 
+\series bold
+uphill
+\series default
+ change 2
+\begin_inset space ~
+\end_inset
+
+edges.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=0.4
+\backslash
+columnwidth,sharp corners=east, nobeforeafter
+\end_layout
+
+\end_inset
+
+A box with 2
+\begin_inset space ~
+\end_inset
+
+corners at the right (
+\series bold
+east
+\series default
+).
+\end_layout
+
+\end_inset
+
+
+\begin_inset space \hfill{}
+\end_inset
+
+
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+width=0.4
+\backslash
+columnwidth,sharp corners=uphill, nobeforeafter
+\end_layout
+
+\end_inset
+
+A box with 2
+\begin_inset space ~
+\end_inset
+
+corners, one at the lower left, one at the upper right (
+\series bold
+uphill
+\series default
+).
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The position 
+\series bold
+all
+\series default
+ change all edges.
+\end_layout
+
+\begin_layout Subsection
+Alignment
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Alignment"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Horizontal
+\end_layout
+
+\begin_layout Standard
+The option
+\series bold
+ halign=alignment
+\series default
+ sets the alignment for the whole box content if there are not box parts,
+ otherwise the options 
+\series bold
+halign upper
+\series default
+ and 
+\series bold
+halign lower
+\series default
+ can be used.
+ The 
+\series bold
+alignment
+\series default
+ is one of the following:
+\end_layout
+
+\begin_layout Description
+right the content is right-aligned
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+halign=right
+\end_layout
+
+\end_inset
+
+A right-aligned box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+left the content is left-aligned
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+halign=left
+\end_layout
+
+\end_inset
+
+A left-aligned box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+center the content is centered
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+halign=center
+\end_layout
+
+\end_inset
+
+A horizontally centered box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+justify the content is justified (is the default value)
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+halign=justify
+\end_layout
+
+\end_inset
+
+A justified box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+An example with box parts:
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+halign upper=left, halign lower=center
+\end_layout
+
+\end_inset
+
+Upper content left-aligned
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content centered
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The title alignment can be changed with the option 
+\series bold
+halign title
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A right-aligned title, halign title=right, halign upper=left, halign
+ lower=center
+\end_layout
+
+\end_inset
+
+Upper content left-aligned
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content centered
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Vertical
+\end_layout
+
+\begin_layout Standard
+The vertical alignment can only be changed if the box height is explicitly
+ set larger than the height consumed by the box content.
+ See 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Height"
+
+\end_inset
+
+ how this is done.
+\end_layout
+
+\begin_layout Standard
+The option
+\series bold
+ valign=alignment
+\series default
+ sets the alignment for the whole box content if there are no box parts,
+ otherwise the options 
+\series bold
+valign upper
+\series default
+ and 
+\series bold
+valign lower
+\series default
+ can be used.
+ The 
+\series bold
+alignment
+\series default
+ is one of the following:
+\end_layout
+
+\begin_layout Description
+top the content is top-aligned
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, valign=top
+\end_layout
+
+\end_inset
+
+A top-aligned box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+bottom the content is bottom-aligned
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, valign=bottom
+\end_layout
+
+\end_inset
+
+A bottom-aligned box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+center the content is vertically centered
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, valign=center
+\end_layout
+
+\end_inset
+
+A vertically centered box.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+scale the content is vertically centered to fit the height
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=2cm, valign=scale
+\end_layout
+
+\end_inset
+
+A box with scaled content.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+An example with box parts:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+height=4cm, space=0.5, valign upper=bottom, valign lower=center
+\end_layout
+
+\end_inset
+
+Upper content bottom-aligned
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower content centered
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Fonts
+\end_layout
+
+\begin_layout Standard
+The font changing options have the syntax 
+\series bold
+option=code
+\series default
+ where 
+\series bold
+code
+\series default
+ are \SpecialChar LaTeX
+'s font changing commands.
+ For example the code
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+sffamily
+\backslash
+bfseries
+\backslash
+large
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+makes the font sans-serif, bold and increases the font size to the level
+\series bold
+
+\backslash
+large
+\series default
+.
+\end_layout
+
+\begin_layout Subsubsection
+Title 
+\end_layout
+
+\begin_layout Standard
+The title font can be changed with the option 
+\series bold
+fonttitle
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title, fonttitle=
+\backslash
+sffamily
+\backslash
+bfseries
+\backslash
+large
+\end_layout
+
+\end_inset
+
+Changed title font
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Text
+\end_layout
+
+\begin_layout Standard
+The font for the upper and lower part text can be changed with the options
+\series bold
+fontupper
+\series default
+ and 
+\series bold
+fontlower
+\series default
+, respectively.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title, fontupper=
+\backslash
+ttfamily, fontlower=
+\backslash
+small
+\end_layout
+
+\end_inset
+
+Changed upper text font
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Changed lower text font
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Color
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Color"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The color is specified in one of these schemes:
+\end_layout
+
+\begin_layout Enumerate
+
+\series bold
+Name
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+For example 
+\series bold
+red
+\series default
+ means
+\begin_inset Newline newline
+\end_inset
+
+100
+\begin_inset space \thinspace{}
+\end_inset
+
+% red
+\begin_inset Newline newline
+\end_inset
+
+An example:
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colback=red
+\end_layout
+
+\end_inset
+
+red
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+
+\series bold
+Name1!PercentOfName1
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+For example 
+\series bold
+geen!30
+\series default
+ means
+\begin_inset Newline newline
+\end_inset
+
+30
+\begin_inset space \thinspace{}
+\end_inset
+
+% red
+\begin_inset Newline newline
+\end_inset
+
+70
+\begin_inset space \thinspace{}
+\end_inset
+
+% white (or 
+\begin_inset Quotes eld
+\end_inset
+
+transparent
+\begin_inset Quotes erd
+\end_inset
+
+)
+\begin_inset Newline newline
+\end_inset
+
+An example:
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colback=green!30
+\end_layout
+
+\end_inset
+
+green!30
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+
+\series bold
+Name1!PercentOfName1!Name2
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+For example 
+\series bold
+red!30!blue
+\series default
+ means
+\begin_inset Newline newline
+\end_inset
+
+30
+\begin_inset space \thinspace{}
+\end_inset
+
+% red
+\begin_inset Newline newline
+\end_inset
+
+70
+\begin_inset space \thinspace{}
+\end_inset
+
+% blue
+\begin_inset Newline newline
+\end_inset
+
+An example:
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colback=red!30!blue
+\end_layout
+
+\end_inset
+
+red!30!blue
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+
+\series bold
+Name1!PercentName1!Name2!PercentName3!Name3
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+For example 
+\series bold
+red!71.4!green!70!blue
+\series default
+ means
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Formula $1-0.70=30\,$
+\end_inset
+
+% blue
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Formula $\left(1-0.714\right)\cdot0.70=20.02\thinspace$
+\end_inset
+
+% green
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Formula $0.714\cdot0.70=49.98\thinspace$
+\end_inset
+
+% red
+\begin_inset Newline newline
+\end_inset
+
+An example:
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colback=red!71.4!green!70!blue
+\end_layout
+
+\end_inset
+
+red!71.4!green!70!blue
+\end_layout
+
+\end_inset
+
+
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The possible color names are:
+\end_layout
+
+\begin_layout Standard
+\noindent
+\begin_inset Tabular
+<lyxtabular version="3" rows="4" columns="5">
+<features tabularvalignment="middle">
+<column alignment="left" valignment="top" width="18col%">
+<column alignment="left" valignment="top" width="18col%">
+<column alignment="left" valignment="top" width="18col%">
+<column alignment="left" valignment="top" width="18col%">
+<column alignment="left" valignment="top" width="18col%">
+<row>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+red
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ red
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+green
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ green
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+blue
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ blue
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+cyan
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ cyan
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+magenta
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ magenta
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+yellow
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ yellow
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+black
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ black
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+gray
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ gray
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+white
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ white
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+darkgray
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ darkgray
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+lightgray
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ lightgray
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+brown
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ brown
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+lime
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ lime
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+olive
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ olive
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+orange
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ orange
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+pink
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ pink
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+purple
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ purple
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+teal
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ teal
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{black}{
+\end_layout
+
+\end_inset
+
+violet
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Phantom Phantom
+status open
+
+\begin_layout Plain Layout
+W
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ violet
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="left" valignment="top" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\end_inset
+</cell>
+</row>
+</lyxtabular>
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+, and the ones listed in Appendix
+\begin_inset space ~
+\end_inset
+
+C of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+\end_layout
+
+\begin_layout Subsubsection
+Background
+\end_layout
+
+\begin_layout Standard
+The background color is changed with the option 
+\series bold
+colback
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colback=red!66!green!70!blue
+\end_layout
+
+\end_inset
+
+Background color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Frame
+\end_layout
+
+\begin_layout Standard
+The frame color is changed with the option 
+\series bold
+colframe
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colframe=red!30!blue
+\end_layout
+
+\end_inset
+
+Frame color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Title background
+\end_layout
+
+\begin_layout Standard
+The title background color is changed with the option 
+\series bold
+colbacktitle
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title, colbacktitle=green!30
+\end_layout
+
+\end_inset
+
+Title background color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Title text
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Title-text"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The color for the title text is changed with the option 
+\series bold
+coltitle
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+title=A title, coltitle=orange
+\end_layout
+
+\end_inset
+
+Title text color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Complete text
+\end_layout
+
+\begin_layout Standard
+The color for the complete text is changed with the option 
+\series bold
+coltext
+\series default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+coltext=red
+\end_layout
+
+\end_inset
+
+Text color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Upper and lower text
+\end_layout
+
+\begin_layout Standard
+The color for the upper and lower part text is changed with the option 
+\series bold
+colupper
+\series default
+ and 
+\series bold
+collower
+\series default
+, respectively.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Color Box
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+colupper=green!30!blue, collower=green!70!blue
+\end_layout
+
+\end_inset
+
+Upper text color
+\end_layout
+
+\begin_layout Color Box Separator
+
+\end_layout
+
+\begin_layout Plain Layout
+Lower text color
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Bibliography
+\begin_inset CommandInset bibitem
+LatexCommand bibitem
+key "tcolorbox"
+
+\end_inset
+
+
+\begin_inset CommandInset href
+LatexCommand href
+name "Documentation"
+target "http://mirrors.ctan.org/macros/latex/contrib/tcolorbox/tcolorbox.pdf"
+
+\end_inset
+
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+tcolorbox
+\end_layout
+
+\end_body
+\end_document
index c27a6b40eade570f83da1d361d5a1bb2e380d165..4dfed77ede7182c98a68cbe9fa6826e3cfda1cd2 100644 (file)
@@ -1,9 +1,10 @@
-#\DeclareLyXModule[tcolorbox.sty]{Fancy Colored Boxes}
+#\DeclareLyXModule[tcolorbox.sty,environ.sty,etoolbox.sty,pgf.sty]{Fancy Colored Boxes}
 #DescriptionBegin
 #Adds custom insets that support colored boxes via the tcolorbox package.
 #See the tcolorbox documentation for details.
 #DescriptionEnd
-#Authors: Jürgen Spitzmüller
+#Author: Jürgen Spitzmüller
+#        Uwe Stöhr <uwestoehr@lyx.org>
 
 Format 54
 
@@ -17,36 +18,39 @@ InsetLayout Flex:Color_Box
   Argument 1
     LabelString         "Color Box Options"
     Tooltip             "Insert the color box options here (see tcolorbox manual)"
+    PassThruChars              "\[]{}"
   EndArgument
   ResetsFont            true
 End
 
 InsetLayout Flex:Dynamic_Color_Box
-  LyXType               custom
-  Decoration            classic
-  LabelString           "Color Box (Dynamic)"
+  CopyStyle                        Flex:Color_Box
   LatexType             command
+  LabelString           "Color Box (Dynamic)"
   LatexName             tcbox
-  Requires              tcolorbox
-  Argument 1
-    LabelString         "Color Box Options"
-    Tooltip             "Insert the color box options here (see tcolorbox manual)"
-  EndArgument
-  ResetsFont            true
 End
 
 InsetLayout Flex:Fit_Color_Box
-  LyXType               custom
-  Decoration            classic
+  CopyStyle                        Flex:Dynamic_Color_Box
   LabelString           "Color Box (Fit Contents)"
-  LatexType             command
   LatexName             tcboxfit
-  Requires              tcolorbox
+End
+
+InsetLayout Flex:Raster_Color_Box
+  CopyStyle                        Flex:Color_Box
+  LabelString           "Raster Color Box"
+  LatexName             tcbraster
+End
+
+InsetLayout Flex:Subtitle
+  CopyStyle                    Flex:Dynamic_Color_Box
+  LatexName                    tcbsubtitle
+  LabelString          "Subtitle"
   Argument 1
-    LabelString         "Color Box Options"
-    Tooltip             "Insert the color box options here (see tcolorbox manual)"
+    LabelString                "Subtitle Options"
+    ToolTip                    "Insert the options here"
+    PassThruChars      "\[]{}"
   EndArgument
-  ResetsFont            true
 End
 
 Style Color_Box_Separator
@@ -111,3 +115,72 @@ Style Color_Box_Setup
   Spellcheck       0
 End
 
+Style New_Color_Box_Type
+  CopyStyle           Color_Box_Setup
+  LatexName        newtcolorbox
+  LabelString      "New Color Box Type"
+  Font
+    Family         roman
+  EndFont
+  LabelFont
+    Color          green
+  EndFont
+  Argument 1
+    LabelString    "New Box Options"
+    Tooltip        "Options for the new box type (optional)"
+    PassThruChars  "\[]{}"
+  EndArgument
+  Argument 2
+    LabelString    "Name"
+    Tooltip        "Name of the new box type"
+    Mandatory      1
+    AutoInsert     1    
+  EndArgument
+  Argument 3
+    LabelString    "Arguments"
+    Tooltip        "Number of arguments (remove this inset if none!)"
+    Requires       4
+  EndArgument
+  Argument 4
+    LabelString    "Default Value"
+    Tooltip        "Default value for argument (keep empty!)"
+    Requires       3
+  EndArgument
+End
+
+# define 5 different box environments that can be customized by the user
+
+InsetLayout Flex:Custom_Color_Box_1
+  CopyStyle        Flex:Color_Box
+  LabelString      "Custom Color Box 1"
+  LatexName        cBoxA
+  Argument 2
+    LabelString    "More Color Box Options"
+    Tooltip        "Insert more color box options here"
+    Mandatory      1
+  EndArgument
+End
+
+InsetLayout Flex:Custom_Color_Box_2
+  CopyStyle        Flex:Custom_Color_Box_1
+  LabelString      "Custom Color Box 2"
+  LatexName        cBoxB
+End
+
+InsetLayout Flex:Custom_Color_Box_3
+  CopyStyle        Flex:Custom_Color_Box_1
+  LabelString      "Custom Color Box 3"
+  LatexName        cBoxC
+End
+
+InsetLayout Flex:Custom_Color_Box_4
+  CopyStyle        Flex:Custom_Color_Box_1
+  LabelString      "Custom Color Box 4"
+  LatexName        cBoxD
+End
+
+InsetLayout Flex:Custom_Color_Box_5
+  CopyStyle        Flex:Custom_Color_Box_1
+  LabelString      "Custom Color Box 5"
+  LatexName        cBoxE
+End
index 0855a4fbc0d35775b025dba23d03c2ffcbd1b352..74ac72e8ee19b0025b262b5088725a11f3abc5fe 100644 (file)
@@ -85,7 +85,7 @@ format_relation = [("0_06",    [200], minor_versions("0.6" , 4)),
                    ("1_6", list(range(277,346)), minor_versions("1.6" , 10)),
                    ("2_0", list(range(346,414)), minor_versions("2.0" , 8)),
                    ("2_1", list(range(414,475)), minor_versions("2.1" , 0)),
-                   ("2_2", list(range(475,498)), minor_versions("2.2" , 0))
+                   ("2_2", list(range(475,499)), minor_versions("2.2" , 0))
                   ]
 
 ####################################################################
index a09ad2234044fef2b4325d7e5994582e6d287c01..ad06400e14e0510235341183086d29b11e3e720e 100644 (file)
@@ -39,6 +39,65 @@ from parser_tools import find_token, find_token_backwards, find_re, \
      find_end_of_inset, find_end_of_layout, find_nonempty_line, \
      get_containing_layout, get_value, check_token
 
+####################################################################
+# Private helper functions
+
+def revert_Argument_to_TeX_brace(document, line, endline, n, nmax, environment, opt, nolastopt):
+    '''
+    Reverts an InsetArgument to TeX-code
+    usage:
+    revert_Argument_to_TeX_brace(document, LineOfBegin, LineOfEnd, StartArgument, EndArgument, isEnvironment, isOpt, notLastOpt)
+    LineOfBegin is the line  of the \begin_layout or \begin_inset statement
+    LineOfEnd is the line  of the \end_layout or \end_inset statement, if "0" is given, the end of the file is used instead
+    StartArgument is the number of the first argument that needs to be converted
+    EndArgument is the number of the last argument that needs to be converted or the last defined one
+    isEnvironment must be true, if the layout is for a LaTeX environment
+    isOpt must be true, if the argument is an optional one
+    notLastOpt must be true if the argument is mandatory and followed by optional ones
+    '''
+    lineArg = 0
+    wasOpt = False
+    while lineArg != -1 and n < nmax + 1:
+      lineArg = find_token(document.body, "\\begin_inset Argument " + str(n), line)
+      if lineArg > endline and endline != 0:
+        return wasOpt
+      if lineArg != -1:
+        beginPlain = find_token(document.body, "\\begin_layout Plain Layout", lineArg)
+        # we have to assure that no other inset is in the Argument
+        beginInset = find_token(document.body, "\\begin_inset", beginPlain)
+        endInset = find_token(document.body, "\\end_inset", beginPlain)
+        k = beginPlain + 1
+        l = k
+        while beginInset < endInset and beginInset != -1:
+          beginInset = find_token(document.body, "\\begin_inset", k)
+          endInset = find_token(document.body, "\\end_inset", l)
+          k = beginInset + 1
+          l = endInset + 1
+        if environment == False:
+          if opt == False:
+            if nolastopt == False:
+              document.body[endInset - 2 : endInset + 1] = put_cmd_in_ert("}{")
+            else:
+              document.body[endInset - 2 : endInset + 1] = put_cmd_in_ert("}") 
+            del(document.body[lineArg : beginPlain + 1])
+            wasOpt = False
+          else:
+            document.body[endInset - 2 : endInset + 1] = put_cmd_in_ert("]")
+            document.body[lineArg : beginPlain + 1] = put_cmd_in_ert("[")
+            wasOpt = True
+        else:
+          if opt == False:
+            document.body[endInset - 2 : endInset + 1] = put_cmd_in_ert("}")
+            document.body[lineArg : beginPlain + 1] = put_cmd_in_ert("{")
+            wasOpt = False
+          else:
+            document.body[endInset - 2 : endInset + 1] = put_cmd_in_ert("]")
+            document.body[lineArg : beginPlain + 1] = put_cmd_in_ert("[")
+            wasOpt = True
+        n += 1
+    return wasOpt
+
+
 ###############################################################################
 ###
 ### Conversion and reversion routines
@@ -1566,6 +1625,193 @@ def revert_external_bbox(document):
     convert_revert_external_bbox(document, False)
 
 
+def revert_tcolorbox_1(document):
+  " Reverts the Flex:Subtitle inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Subtitle", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      wasOpt = revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, False, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, False, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      if wasOpt == True:
+        document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\tcbsubtitle")
+      else:
+        document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\tcbsubtitle{")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("}")
+      flex += 1
+
+
+def revert_tcolorbox_2(document):
+  " Reverts the Flex:Raster_Color_Box inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Raster Color Box", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{tcbraster}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("\\end{tcbraster}")
+      flex += 1
+
+
+def revert_tcolorbox_3(document):
+  " Reverts the Flex:Custom_Color_Box_1 inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Custom Color Box 1", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, True, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{cBoxA}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("{}\\end{cBoxA}")
+      flex += 1
+
+
+def revert_tcolorbox_4(document):
+  " Reverts the Flex:Custom_Color_Box_2 inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Custom Color Box 2", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, True, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{cBoxB}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("{}\\end{cBoxB}")
+      flex += 1
+
+
+def revert_tcolorbox_5(document):
+  " Reverts the Flex:Custom_Color_Box_3 inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Custom Color Box 3", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, True, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{cBoxC}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("{}\\end{cBoxC}")
+      flex += 1
+
+
+def revert_tcolorbox_6(document):
+  " Reverts the Flex:Custom_Color_Box_4 inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Custom Color Box 4", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, True, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{cBoxD}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("{}\\end{cBoxD}")
+      flex += 1
+
+
+def revert_tcolorbox_7(document):
+  " Reverts the Flex:Custom_Color_Box_5 inset of tcolorbox to TeX-code "
+  i = -1
+  while True:
+    i = find_token(document.header, "tcolorbox", i)
+    if i == -1:
+      break
+    else:    
+      flex = 0
+      flexEnd = -1
+      flex = find_token(document.body, "\\begin_inset Flex Custom Color Box 5", flex)
+      if flex == -1:
+        return flexEnd
+      flexEnd = find_end_of_inset(document.body, flex)
+      revert_Argument_to_TeX_brace(document, flex, flexEnd, 1, 1, True, True, False)
+      revert_Argument_to_TeX_brace(document, flex, 0, 2, 2, True, False, False)
+      flexEnd = find_end_of_inset(document.body, flex)
+      document.body[flex + 0 : flex + 4] = put_cmd_in_ert("\\begin{cBoxE}")
+      document.body[flexEnd + 4 : flexEnd + 7] = put_cmd_in_ert("{}\\end{cBoxE}")
+      flex += 1
+
+
+def revert_tcolorbox_8(document):
+  " Reverts the layout New Color Box Type of tcolorbox to TeX-code "
+  i = 0
+  j = 0
+  k = 0
+  while True:
+    if i != -1:
+      i = find_token(document.body, "\\begin_layout New Color Box Type", i)
+    if i != -1:
+      j = find_end_of_layout(document.body, i)
+      wasOpt = revert_Argument_to_TeX_brace(document, i, j, 1, 1, False, True, False)
+      revert_Argument_to_TeX_brace(document, i, 0, 2, 2, False, False, True)
+      revert_Argument_to_TeX_brace(document, i, 0, 3, 4, False, True, False)
+      document.body[i] = document.body[i].replace("\\begin_layout New Color Box Type", "\\begin_layout Standard")
+      if wasOpt == True:
+        document.body[i + 1 : i + 1] = put_cmd_in_ert("\\newtcolorbox")
+      else:
+        document.body[i + 1 : i + 1] = put_cmd_in_ert("\\newtcolorbox{")
+      k = find_end_of_inset(document.body, j)
+      k = find_token(document.body, "\\end_inset", k + 1)
+      k = find_token(document.body, "\\end_inset", k + 1)
+      if wasOpt == True:
+        k = find_token(document.body, "\\end_inset", k + 1)
+      document.body[k + 2 : j + 2] = put_cmd_in_ert("{")
+      j = find_token(document.body, "\\begin_layout Standard", j + 1)
+      document.body[j - 2 : j - 2] = put_cmd_in_ert("}")
+      i += 1
+    if i == -1:
+      return
+
+
 ##
 # Conversion hub
 #
@@ -1597,10 +1843,14 @@ convert = [
            [494, []],
            [495, [convert_subref]],
            [496, [convert_nounzip]],
-           [497, [convert_external_bbox]]
+           [497, [convert_external_bbox]],
+           [498, []]
           ]
 
 revert =  [
+           [497, [revert_tcolorbox_1, revert_tcolorbox_2,
+                  revert_tcolorbox_3, revert_tcolorbox_4, revert_tcolorbox_5,
+                  revert_tcolorbox_6, revert_tcolorbox_7, revert_tcolorbox_8]],
            [496, [revert_external_bbox]],
            [495, []], # nothing to do since the noUnzip parameter was optional
            [494, [revert_subref]],
index 5ac98797bd3c3c7ddb131b8f92619e7e5f0f67c9..978aa0864eba694b9875b6245722d0a39130b092 100644 (file)
@@ -606,6 +606,7 @@ Menuset
        Menu "examples"
                Item "Beamer Presentations|B" "help-open beamer"
                Item "Braille|a" "help-open Braille"
+               Item "Colored boxes|C" "help-open colored-boxes"
                Item "Feynman-diagram|F" "help-open FeynmanDiagrams"
                Item "Knitr|K" "help-open knitr"
                Item "LilyPond|P" "help-open lilypond"
index ab1a00ee07b0de40e62941ccfb55c332bc5c88be..d647224770c25dc3a9bdd52b2272cf185550c355 100644 (file)
@@ -32,8 +32,8 @@ extern char const * const lyx_version_info;
 
 // Do not remove the comment below, so we get merge conflict in
 // independent branches. Instead add your own.
-#define LYX_FORMAT_LYX 497 // gb: bounding box of external insets supports units
-#define LYX_FORMAT_TEX2LYX 497
+#define LYX_FORMAT_LYX 498 // uwestoehr: tcolorbox module improvements
+#define LYX_FORMAT_TEX2LYX 498
 
 #if LYX_FORMAT_TEX2LYX != LYX_FORMAT_LYX
 #ifndef _MSC_VER