1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
|
%% The LaTeX package tcolorbox - version 4.02 (2017/02/24)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2017 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
%% http://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2005/12/01 or later.
%%
%% This work has the LPPL maintenance status `author-maintained'.
%%
%% This work consists of all files listed in README
%%
(2006-2011): pre publication usage
version 1.00 (2011/12/08): initial public release
version 1.01 (2012/01/26):
- dates amended to \RequirePackage(s)
- provision of the tcolorbox.tds.zip file for easier installation
version 1.02 (2012/02/15)
- documentation language changed from German to English
- small correction of the theorem title line appearance
version 1.10 (2012/03/01)
- tcblatex style for listings changed (nolol added)
- improved hyperref support
- new keys parskip and noparskip
- source code of the documentation added
- new library 'documentation' to support LaTeX documentations
with several library commands, environments and keys (see documentation)
version 1.20 (2012/03/16)
- new geometry keys:
'lefttitle', 'leftupper', 'leftlower', 'righttitle', 'rightupper', 'rightlower'
and implementation changed for 'left' and 'right'
- implementation for tcolorbox changed (adaption to height options)
- new fixed height option keys:
'natural height', 'height', 'equal height group', 'minimum for equal height group',
'space', 'space to upper', 'space to lower', 'space to both', 'split',
'valign', 'valign lower',
'adjusted title'
- new bounding box option keys:
'enlarge top by', 'enlarge bottom by', 'enlarge left by', 'enlarge right by',
'toggle enlargement'
- preparations for a future skin changing option implemented
- commands \brackets and \docAuxCommand added to the documentation library
- documentation rearranged
version 1.30 (2012/04/20)
- several internal code changes to provide a 'skin' exchange mechanism
- new keys for the core package:
'frame engine', 'interior titled engine', 'interior engine', 'segmentation engine'
'skin', 'graphical environment', 'geometry nodes', 'colupper', 'collower'
- tcolorbox now defined as 'long' macro
- new keys for the library 'listings':
'comment', 'listing and comment', 'comment and listing'
- new library 'skins' with the skins
'standard', 'enhanced', 'freelance', 'bicolor', 'beamer', 'widget'
- keys for the library 'skins':
'frame style', 'interior style', 'segmentation style'
'frame code', 'interior titled code', 'interior code', 'segmentation code',
'colbacklower'
version 2.00 (2013/03/01)
- breaking news: the new library 'breakable' adds breaking support to tcolorbox.
- e-TeX now used instead of calc
- new key 'adjust text' and new implementation for 'adjusted title'
- new geometry keys:
'toprule', 'toprule at break', 'bottomrule', 'bottomrule at break',
'leftrule', 'rightrule', 'titlerule', 'outer arc', 'auto outer arc',
'toptitle', 'bottomtitle'
- new bounding box keys:
'enlarge top at break by', 'enlarge bottom at break by'
- new overlay keys:
'overlay', 'no overlay', 'overlay broken', 'overlay unbroken',
'overlay first', 'overlay middle', 'overlay last',
'overlay unbroken and first', 'overlay middle and last'
- new key: 'parbox' to change text behaviour
- new library 'breakable' for breakable boxes with the new keys:
'breakable', 'unbreakable', 'title after break', 'notitle after break',
'adjusted title after break', 'lines before break', 'shrink break goal'
- new keys for the 'skins' library
'skin first', 'skin middle', 'skin last', 'title engine', 'pathfirst',
'pathmiddle', 'pathlast', 'title style', 'title code', 'enhancedfirst',
'enhancedmiddle', 'enhancedlast', 'enhanced', 'marker', 'bicolor',
'bicolorfirst', 'bicolormiddle', 'bicolorlast', 'beamer',
'beamerfirst', 'beamermiddle', 'beamerlast', 'draft', 'freelance', 'standard'
- NOTE: skins 'beamer' and 'widget' changed
use the new style options 'beamer' and 'widget' to get the old appearance
- new watermark keys:
'watermark text', 'watermark text on', 'watermark graphics',
'watermark graphics on', 'watermark tikz', 'watermark tikz on',
'no watermark', 'watermark opacity', 'watermark color',
'watermark zoom', 'watermark stretch'
version 2.01 (2013/03/07)
- bug fix: superfluous vertical space for a breakable box which appeared after a page break
- bug fix: height computation error when a broken boxed starts with a segmentation line
- new key for the 'listings' library:
'listing inputencoding'
- new library 'listingsutf8' as variant of 'listings' with new key
'listing utf8'
- keys 'toprule at break', 'bottomrule at break',
'enlarge top at break by', 'enlarge bottom at break by'
moved from core package to 'breakable' library.
- new keys for the 'breakable' library:
'topsep at break', 'bottomsep at break', 'pad before break',
'pad after break', 'pad at break'
version 2.02 (2013/03/13)
- minor bug fix: segmentation line of 'enhanced' now matches 'standard'
- new macro '\tcbox' to draw a colorbox fitted to the content width
- new key 'autoparskip' to detect usage of package parskip automatically
- new key 'nobeforeafter'
- new macro '\tcbline' in the 'skins' library to draw 'just lines'
- new key 'colbacktitle' for the 'skins' library
version 2.10 (2013/04/09)
- bug fix: \tcbox ignored font settings
- outdated documentation in German removed from package
- new core package keys:
'oversize', 'tcbox raise', 'tcbox raise base',
'before title', 'after title', 'before upper', 'after upper', 'before lower',
'after lower', 'center title', 'center upper', 'center lower',
'tabularx*', 'tabularx', 'tikz upper', 'tikz lower',
'shrink tight', 'extrude left by', 'extrude right by', 'extrude top by',
'extrude bottom by', 'extrude by'
- the 'theorems' library now loads 'amsmath'
- new macros for the 'theorems' library:
'\tcboxmath', '\tcbhighmath'
- new keys for the 'theorems' library:
'math upper', 'math lower', 'math', 'highlight math', 'highlight math style',
'ams equation upper', 'ams equation lower', 'ams equation', 'ams equation* upper',
'ams equation* lower', 'ams equation*', 'ams align upper', 'ams align lower',
'ams align', 'ams align* upper', 'ams align* lower', 'ams align*',
'ams gather upper', 'ams gather lower', 'ams gather', 'ams gather* upper',
'ams gather* lower', 'ams gather*',
'ams nodisplayskip upper', 'ams nodisplayskip lower', 'ams nodisplayskip'
- new library 'hooks' for hook options with the new keys:
'before upper app', 'before upper pre', 'after upper app', 'after upper pre',
'before lower app', 'before lower pre', 'after lower app', 'after lower pre',
'before title app', 'before title pre', 'after title app', 'after title pre',
'before app', 'before pre', 'after app', 'after pre',
'overlay unbroken app', 'overlay unbroken pre', 'overlay first app', 'overlay first pre',
'overlay middle app', 'overlay middle pre', 'overlay last app', 'overlay last pre',
'overlay app', 'overlay pre', 'overlay broken app', 'overlay broken pre',
'overlay unbroken and first app', 'overlay unbroken and first pre',
'overlay middle and last app', 'overlay middle and last pre',
'watermark tikz app', 'watermark tikz pre', 'watermark tikz app on', 'watermark tikz pre on',
'watermark graphics app', 'watermark graphics pre', 'watermark graphics app on', 'watermark graphics pre on',
'watermark text app', 'watermark text pre', 'watermark text app on', 'watermark text pre on',
'frame code app', 'frame code pre', 'interior titled code app', 'interior titled code pre',
'interior code app', 'interior code pre', 'segmentation code app', 'segmentation code pre',
'title code app', 'title code pre'
- colorization of source code snippets in the documentation
version 2.20 (2013/04/17)
- bug fix: problem with breaking boxes after headings
- new feature: support for boxes with side by side content
- new keys:
'sidebyside', 'sidebyside align', 'sidebyside gap',
'lefthand width', 'righthand width', 'lefthand ratio', 'righthand ratio'
- key 'nofloat' documented
- new keys for the 'listings' library:
'listing side text', 'text side listing'
'listing outside text', 'text outside listing'
- new keys for the 'skins' library:
'frame hidden', 'interior hidden', 'segmentation hidden', 'title hidden'
- new environments for the 'documentation' library:
'dispExample*', 'dispListing*'
- the default style for 'highlight math' is changed to have no title
- minor change of internal width computation
- minor internal fixes
- slight overhaul of the documentation
version 2.21 (2013/04/23)
- bug fix: \tcbox and 'sidebyside' needed 'breakable' library
- bug fix: library 'tcbhooks' relied on etoolbox package
- bug fix: breaking boxes between upper part and box frame
- new macro '\newtcolorbox'
- new macro '\newtcblisting' for the 'listings' library
- new key 'code'
- documentation corrections and extensions
version 2.22 (2013/05/15)
- bug fix: text color bleeded out of the box in some cases
- bug fix: breakable boxes were too large in some cases (leading to blank pages)
- bug fix: breaking boxes produced empty boxes in some cases
- documentation forgot naming package 'colortbl' for the 'tabularx' option
- new feature: breakable boxes allow footnotes now (like minipages)
- new macro '\newtcbox'
version 2.30 (2013/06/04)
- bug fix: handling of 'before' and 'after' for \tcbox corrected
- \tcbline now also works for centered environments
- implementation for \tcbox made more efficient
- new capture mode for automated content fit by font size adjustment
with the new macros '\tcboxfit' and '\newtcboxfit'
and the new keys 'fit', 'fit to', 'fit to height', 'fit basedim', 'fit skip',
'fit maxstep'
- new keys 'baseline', 'capture', 'hbox', 'minipage'
- new stackable borderlines with the 'skins' library:
'borderline', 'no borderline'
- new keys for the 'skins' library:
'enhanced standard', 'blank'
- new key 'index format' for the 'documentation' library
version 2.31 (2013/06/18)
- several internal changes
- library loading mechanism revisited
- internal label change for '\tcbmaketheorem'
- new library options 'most' and 'all'
- \tcbline now also works for ragged environments
- new keys:
'flushleft title', 'flushleft upper', 'flushleft lower',
'flushright title', 'flushright upper', 'flushright lower'
- new key 'no listing options' for the 'listings' library
- new shadow features for the 'skins' library with the options:
'shadow', 'fuzzy shadow', 'drop shadow', 'drop fuzzy shadow', 'halo', 'fuzzy halo'
- shadows for the 'beamer' skin changed to fuzzy
- new library 'fitting' for the content fit operations.
NOTE: '\tcboxfit' and the fit options introduced in version 2.30 are moved
to this new library
- the fit algorithm is completey revisited and extended
- new macro '\tcbfontsize' ('fitting library') for relative font sizes
- new keys for the 'fitting' library:
'fit fontsize macros', 'fit height plus', 'fit width plus',
'fit width from', 'fit height from'
version 2.32 (2013/06/23)
- bug fix: 'ams nodisplayskip lower' was applied to upper.
- new option 'check odd page'
- new environments for the 'skins' library:
'tcbclipinterior', 'tcbclipframe', 'tcbcliptitle'
- new keys for the 'skins' library:
'watermark overzoom', 'clip watermark'
'clip title', 'clip upper', 'clip lower'
- NOTE: watermarks are now clipped by default.
To get the old behaviour add the option 'clip watermark=false'
version 2.33 (2013/07/04)
- new options 'phantom', 'step and label', 'nophantom',
'lower separated', 'reset', 'toggle left and right'
- 'highlight math' sets 'notitle,nophantom' automatically
- hyper anchor setting for theorems and LaTeX examples improved
- new key 'shield externalize' for externalization
- additional empty-first-box test for breakable boxes
- new key 'enlargepage' for fine-tuning breakable boxes
- parameter added to option 'oversize'
- option 'toggle enlargement' has a default value 'evenpage' now
version 2.40 (2013/07/15)
- bug fix: wrong footnote text width for breakable boxes
- bug fix: watermarks were influenced by baseline settings
- package etoolbox is now loaded by default
- 'phantom' changed to be stackable (!)
- introducing the new initialization option type for easy
numbering and list generation. New options:
'use counter', 'auto counter', 'use counter from',
'no counter', 'number within', 'number format', 'number freestyle',
'list inside', 'list type'
- '\newtcolorbox' and 'newtcbox' take initialization options now
- new macros '\tcblistof', '\tcbsetmanagedlayers'
- introducing the layered box concept for boxes in boxes improvement:
* boxes inside boxes are automatically reset to default values
* new option 'every box', 'every box on layer x', 'every box on higher layers'
* support for footnotes for boxes in boxes (default: up to layer 4)
- new options 'step', 'label', 'list entry', 'add to list'
- library 'listings':
* '\newtcblisting' takes initialization options now
* new macro '\newtcbinputlisting'
- library 'theorems':
* '\tcbmaketheorem' takes initialization options now
* new macro '\newtcbtheorem'
- library 'fitting':
* 'newtcboxfit' takes initialization options now
- library 'documentation':
* the \ref... macros suppress the page numbers now if on the same page
* new macros '\refCom*', '\refEnv*', '\refKey*'
* docCommand and docEnvironment take options now
version 2.41 (2013/07/23)
- NOTE: The deprecated macro '\tcbmaketheorem' is redefined to its signature
of v2.33 and before to ensure backward compatibility. This may break code
written with v2.40 using '\tcbmaketheorem'.
- minor internal improvements
- support for the cleveref package with
* new initialization options 'crefname', 'Crefname'
* new options 'label type', 'no label type'
- library 'theorems':
* new options: 'separator sign', 'separator sign colon', 'separator sign dash'
- library 'listings':
* capture mode can be changed for 'tcblisting' and '\tcbinputlisting'
* new option: 'listing remove caption'
version 2.50 (2013/07/29)
- first line indent corrected for 'parbox=false'
- minor internal improvements
- new option keys
'height plus', 'height from'
- new library 'minted' with support for the minted package (Pygments support)
* new options 'minted language', 'minted options', 'minted style'
- new library option 'many'
- new common listings options:
'listing engine'
- library 'documentation':
* new options 'documentation minted style', 'documentation minted options'
version 2.51 (2013/09/16)
- bug fix: processing of 'initialization option keys' fixed
for \newtcbox, \newtcbinputlisting, and \newtcboxfit
- bug fix: disturbing horizontal space in \tcboxfix removed
- new macros '\renewtcolorbox', '\renewtcbox'
- library 'skins':
* implementation for the skin families 'enhanced', 'beamer', and 'bicolor' changed
* break sequence changed for skin 'freelance'
* new skins: 'freelancefirst', 'freelancemiddle', 'freelancelast'
* new options: 'extend freelance', 'extend freelancefirst',
'extend freelancemiddle', 'extend freelancelast',
'drop midday shadow', 'drop fuzzy midday shadow'
* new environment 'tcbinvclipframe'
- library 'listings':
* new macros '\renewtcblisting', '\renewtcbinputlisting'
- library 'theorems':
* new macro '\renewtcbtheorem'
- library 'fitting':
* new macro '\renewtcboxfit'
- library 'documentation':
* new option 'documentation listing options'
version 2.60 (2013/12/17)
- new 'jigsaw' variants for the skins 'standard' and 'enhanced' for
advanced transparency and similar effects.
- new package core skin 'standard jigsaw'
- 'tabularx' and 'tabularx*' reset the arrayrulecolor to black after the table now.
- option 'colbacktitle' moved from library 'skins' to package core
- new options:
'title filled', 'opacityupper', 'opacitylower', 'opacitytitle', 'opacityframe',
'opacityback', 'opacitybacktitle', 'opacityfill', 'opacitytext','hyphenationfix',
'standard jigsaw', 'enlarge by', 'grow to left by', 'grow to right by'
- library 'skins':
* new skin: 'enhanced jigsaw', 'enhancedfirst jigsaw', 'enhancedmidle jigsaw',
'enhancedlast jigsaw'
* marker style now based on 'enhancedmiddle jigsaw'
* new options:
'enhanced jigsaw', 'tikz', 'tikz reset', 'show bounding box',
'at begin tikz', 'at begin tikz reset', 'at end tikz', 'at end tikz reset',
'rotate', 'scale', 'remember', 'remember as',
'drop shadow southeast', 'drop shadow south', 'drop shadow southwest', 'drop shadow west',
'drop shadow northwest', 'drop shadow north', 'drop shadow northeast', 'drop shadow east',
'drop fuzzy shadow southeast', 'drop fuzzy shadow south', 'drop fuzzy shadow southwest',
'drop fuzzy shadow west', 'drop fuzzy shadow northwest', 'drop fuzzy shadow north',
'drop fuzzy shadow northeast','drop fuzzy shadow east',
- library 'listings':
new options 'text above listing' and 'listing above text'
- library 'theorems':
\newtcbtheorem creates an additional starred theorem environment
- library 'fitting':
fit algorithm warning switched off by default.
new options:
'fit warning'
- library 'documentation': more values for 'index format'
- documentation extended
- major internal implementation changes and optimizations
version 2.61 (2014/01/10)
- bug fix: '@' was set as letter in some situations
- typing error corrections
- new macro \tcbsetforeverylayer
- library 'skins':
* new macros and environments:
'\tcbstartdraftmode', '\tcbstopdraftmode', '\tcbinterruptdraftmode', '\tcbcontinuedraftmode'
* new skin: 'spartan'
* new options: 'spartan', 'draftmode'
- library 'fitting':
* alternative fitting algorithms implemented (fontsize, areasize, hybrid, squeeze)
* new option: 'fit algorithm'
version 2.70 (2014/02/06)
- bug fix: global setting of 'before' or 'after' may produce errors or
side effects for layered boxes.
- compatibility issue with TikZ 3.00 solved
- new options:
'detach title', 'attach title', 'attach title to upper',
'tikznode upper', 'tikznode lower', 'tikznode'
- library 'theorems':
* new options:
'separator sign none', 'terminator sign', 'terminator sign colon',
'terminator sign dash', 'terminator sign none', 'description delimiters',
'description delimiters parenthesis', 'description delimiters none',
'theorem name and number', 'theorem number and name', 'theorem name',
'theorem style'
- library 'documentation':
* re-implementation of the documenting environments
(may alter existing documents slightly)
* new environments:
'docCommand*', 'docEnvironment*', 'docKey*'
* new commands:
'\docAuxCommand*', '\docAuxEnvironment', '\docAuxEnvironment*',
'\docValue', '\docValue*', '\docAuxKey', '\docAuxKey*',
'\docColor*', '\refAux', '\refAuxcs'
* new options:
'doc left', 'doc right', 'doc left indent', 'doc right indent',
'doc head', 'doc head command', 'doc head environment', 'doc head key',
'doc description', 'doc into index', 'value', 'values'
version 2.71 (2014/02/21)
- bug fix: sidebyside setting with empty left hand side caused false positioning
- new options:
'external', 'remake'
- library 'listings':
* new options:
'comment side listing', 'listing side comment', 'comment above listing',
'listing above comment', 'comment outside listing', 'listing outside comment',
'image comment',
- library 'documentation':
* automatic inclusion of the 'skins' library
* inclusion of 'makeidx' made dependent on the existence of '\printindex'
* new options:
'keys', 'index colorize', 'index annotate',
'color command', 'color environment', 'color key', 'color value', 'color color'
version 2.72 (2014/03/18)
- bug fix: mixing \newtcblisting with 'ams align' and similar options was not possible
- bug fix: footnotes lost for 'listing outside text' and similar options
- sidebyside and outside implementation slightly changed for beamer usage
- bicolor skin respects 'opacityback' for the upper part now
- new TikZ options:
'fill image opacity', 'fill image options',
'fill plain image', 'fill plain image*', 'fill stretch image', 'fill stretch image*',
'fill overzoom image', 'fill overzoom image*', 'fill zoom image', 'fill zoom image*',
'fill shrink image', 'fill shrink image*', 'fill tile image', 'fill tile image*'
- library 'skins':
* new options:
'frame style image', 'frame style tile', 'interior style image', 'interior style tile',
'title style image', 'title style tile'
- library 'listings':
* new options:
'every listing line', 'every listing line*'
version 2.80 (2014/03/31)
- implementation changed for all '\newtcolorbox', '\newtcbox', etc., macros.
- new option:
'float*'
- new TikZ option:
'fill image scale'
- library 'skins' new option:
'watermark shrink'
- new library 'xparse' with new commands:
'\DeclareTColorBox', '\NewTColorBox', '\RenewTColorBox', '\ProvideTColorBox',
'\DeclareTotalTColorBox', '\NewTotalTColorBox', '\RenewTotalTColorBox', '\ProvideTotalTColorBox',
'\DeclareTCBox', '\NewTCBox', '\RenewTCBox', '\ProvideTCBox',
'\DeclareTotalTCBox', '\NewTotalTCBox', '\RenewTotalTCBox', '\ProvideTotalTCBox',
'\DeclareTCBListing', '\NewTCBListing', '\RenewTCBListing', '\ProvideTCBListing',
'\DeclareTCBInputListing', '\NewTCBInputListing', '\RenewTCBInputListing', '\ProvideTCBInputListing',
'\DeclareTCBoxFit', '\NewTCBoxFit', '\RenewTCBoxFit', '\ProvideTCBoxFit',
'\DeclareTotalTCBoxFit', '\NewTotalTCBoxFit', '\RenewTotalTCBoxFit', '\ProvideTotalTCBoxFit',
'\tcboxverb'
version 3.00 (2014/05/08)
- bug fix: 'title code app', 'title code pre' changed wrong code
- documentation corrections
- implementation of graphical engines changed (!)
- note: optical backward compatibility issues with breakable 'freelance' boxes possible
- 'frame code' and similar options are moved from the 'skins' library to the core package
- 'enlarge top at break by' and 'enlarge bottom at break by' moved from 'breakable' library to the core package
- new macros:
'\tcbnewsubskin'
- new options:
'skin first is subskin of', 'skin middle is subskin of', 'skin last is subskin of',
'enlarge top initially by', 'enlarge finally last by', 'overlay unbroken and last'
'size', 'on line', 'varwidth upper',
'frame empty', 'interior empty', 'interior titled empty', 'segmentation empty', 'title empty'
- new TikZ options:
'tcb fill frame', 'tcb fill interior', 'tcb fill title'
'fill plain picture', 'fill stretch picture', 'fill overzoom picture',
'fill zoom picture', 'fill shrink picture', 'fill tile picture', 'fill tile picture*'
- library 'skins' new options (concerning 'underlay', 'finish' and 'boxed title'):
'underlay unbroken', 'underlay first', 'underlay middle', 'underlay last',
'underlay', 'underlay broken', 'underlay unbroken and first',
'underlay middle and last', 'underlay unbroken and last',
'no underlay unbroken', 'no underlay first',
'no underlay middle', 'no underlay last', 'no underlay',
'finish unbroken', 'finish first', 'finish middle', 'finish last',
'finish', 'finish broken', 'finish unbroken and first',
'finish middle and last', 'finish unbroken and last',
'no finish unbroken', 'no finish first',
'no finish middle', 'no finish last', 'no finish',
'empty', 'blanker',
'boxed title style', 'varwidth boxed title', 'varwidth boxed title*',
'minipage boxed title', 'minipage boxed title*', 'tikznode boxed title',
'hbox boxed title', 'boxtitle/xshift', 'boxtitle/yshift', 'boxtitle/yshifttext',
'boxtitle/yshift*', 'attach boxed title to top left', 'attach boxed title to top center',
'attach boxed title to top right', 'attach boxed title to bottom left',
'attach boxed title to bottom center', 'attach boxed title to bottom right',
- new engine and skin 'empty'
- implementation of 'show bounding box' changed to be a border line.
- library 'hooks' new options:
'underlay unbroken pre', 'underlay first pre', 'underlay middle pre',
'underlay last pre', 'underlay pre', 'underlay broken pre',
'underlay unbroken and first pre', 'underlay middle and last pre',
'underlay unbroken and last pre'
'finish unbroken pre', 'finish first pre', 'finish middle pre',
'finish last pre', 'finish pre', 'finish broken pre',
'finish unbroken and first pre', 'finish middle and last pre',
'finish unbroken and last pre'
'overlay unbroken and last app', 'overlay unbroken and last pre'
- library 'theorems':
* new options:
'description color', 'description font', 'description formatter'
version 3.01 (2014/05/13)
- bug fix: 'parbox=false' plus 'breakable' had an unwanted indent
- compatibility fix for tabularx 2014/04/22 v2.09
version 3.02 (2014/05/13)
- compatibility fix for tabularx 2014/04/22 v2.09 (again)
version 3.03 (2014/05/16)
- bug fix: some initialization option keys for \newtcblisting did not operate correctly
- bug fix: boxed title shape 'title' was unknown in underlays
- more boxed title example documented
version 3.04 (2014/05/18)
- compatibility fix for tabularx removed; compatible with tabularx 2014/05/13 v2.10
- boxed title improvements:
* the 'title' node is accessible now from inside 'frame code' and 'interior code'
* new keys 'underlay boxed title', 'no underlay boxed title', 'underlay boxed title pre'
* documentation example updated
version 3.05 (2014/05/28)
- compatibility fix for the upcoming version 2.0 of the package minted
- inner boxes are enforced to be unbreakable now
- library 'breakable':
new key 'enforce breakable' (for breaking inner boxed deliberately)
- library 'skins':
* new options:
'lifted shadow', 'drop small lifted shadow', 'drop lifted shadow', 'drop large lifted shadow'
version 3.10 (2014/07/23)
- box breaking algorithm revised:
* breakable boxes now always have \noindent
* distance to preceeding text corrected
* interaction with floating objects fixed
* dimensioning of partial boxes improved
* splitting of an empty closing frame can now be avoided (depending on 'pad at break*')
* The upper total height limit for breakable boxes is extended from
about 16384pt to about 65536pt
* experimental code added (breakable=unlimited) for breakable boxes
without height limit besides memory
* splitting boxes inside multicols environments supported (to a certain degree)
* limited orphan control added ('enlargepage flexible')
- library 'breakable':
* new options:
'break at', 'height fixed for', 'enlargepage flexible',
'pad before break*', 'pad at break*'
- Corners can be set individually now to be 'rounded' or 'sharp'
for all types of boxes, skins, borders, and shadows:
* new options: 'sharpish corners', 'sharp corners', and 'rounded corners'
- library 'skins':
* new macros: '\tcbline*'
* bug fix: skin families 'bicolor' and 'beamer' did not respect 'colbacktitle'
- pictures 'blueshade.png', 'crinklepaper.png', 'goldshade.png', 'pink_marble.png'
moved to package folder
version 3.11 (2014/07/25)
- regresssion: vertical space at end of breakable boxes was not removed
- example file updated with new features
version 3.12 (2014/07/29)
- text color implementation changed to circumvent xelatex color problems
- multicol vs. twocolumn detection fixed
- code for breakable boxes without height limit improved
- before box \noindent is replaced by \parindent=0pt (bidi package compatibilty)
- library 'breakable':
* new option: 'vfill before first'
version 3.20 (2014/09/22)
- bug fix: titles set with 'detach' or 'boxed title' options were not considered
for lists of tcolorboxes.
- bug fix: 'extrude left by', 'extrude right by' worked only for '\tcbox' but not for 'tcolorbox'
- bug fix: 'pad before break*' and 'pad at break*' were always setting to 0pt
- new options: 'every float', 'list text', 'overlay first and middle',
'height fill'
- new initialization options:
'use counter*', 'blend into'
- library 'skins':
* new macros: '\tcbsettowidthofnode', '\tcbsetmacrotowidthofnode',
'\tcbsettoheightofnode', '\tcbsetmacrotoheightofnode'
* new options: 'underlay first and middle', 'finish first and middle'
- library 'hooks':
* new options: 'underlay first and middle pre',
'overlay first and middle app', 'overlay first and middle pre',
'finish first and middle pre'
- library 'documentation':
* new macros: '\tcbdocmarginnote', '\tcbdocnew', '\tcbdocupdated'
* The 'docKey' and 'docKey*' environments take tcolorbox options now
* new options:
'doclang/new', 'doclang/updated',
'doc marginnote', 'doc updated', 'doc new', 'doc new and updated'
version 3.21 (2014/10/10)
- bug fix: empty key path handling inside the 'docKey' and 'docKey*' environments was faulty
- bug fix: wrong coloring for '\docAuxCommand' and '\docAuxCommand*'
- bug fix: draft mode for inner boxes deactivated in v3.20
- subtitles added
- new macros:
'\tcbsubtitle'
- new options:
'subtitle style', 'before skip', 'after skip', 'beforeafter skip',
- library 'documentation':
implementation of handling macro and key names changed to accept underscores
several internal implementation changes
version 3.22 (2014/10/31)
- new macro: '\tcolorboxenvironment'
- new options:
'text width', 'text height'
- library 'skins':
* new options: 'borderline north', 'borderline south',
'borderline east', 'borderline west', 'borderline horizontal', 'borderline vertical'
- library 'breakable':
* internal change for compatibility with the 'perpage' option of the 'footmisc' package
- library 'theorems':
* compatibility fix: The 'ams equation' options left too much vertical
space for the 'fleqn' case
- library 'fitting':
* new 'fit algorithm' settings: 'fontsize*', 'areasize*', 'hybrid*'
version 3.30 (2014/11/17)
- bug fix: compilation errors using colors like 'red!10' in some skins like 'beamer'
- '\thetcbcounter' can now be used as part of a 'listing file' name for 'tcblisting'
- implementation of 'before skip' and 'after skip' improved
- implementation of 'equal height group' improved to take arbitrary id's
- Quick Reference added
- new options:
'add to width', 'add to height',
'box align', 'left skip', 'right skip', 'leftright skip'
- library 'skins':
* new macros:
'\tcbincludegraphics', '\tcbincludepdf'
* new options:
'graphics options', 'graphics directory', 'graphics pages'
- library 'listings', 'listingsut8', 'minted':
* 'listing file' now usable inside 'tcblisting' and 'tcbinputlisting'
* new options:
'comment only', 'text above* listing', 'listing above* text',
'comment above* listing', 'listing above* comment',
'comment style', 'tcbimage comment', 'pdf extension', 'pdf comment',
'process code', 'no process', 'run system command', 'run pdflatex',
'run xelatex', 'run lualatex', 'run makeindex', 'run bibtex', 'run biber',
'run arara', 'run latex', 'run dvips', 'run ps2pdf',
'compilable listing'
- new library 'raster':
* new macros and environments:
'tcbraster', 'tcbitemize', 'tcbitem'
* new options:
'raster columns', 'raster rows', 'raster width', 'raster height', 'raster before skip',
'raster after skip', 'raster left skip', 'raster right skip', 'raster column skip',
'raster row skip', 'raster halign', 'raster valign', 'raster equal height',
'raster equal height group', 'raster force size' ,'raster reset',
'raster odd column', 'raster even column', 'raster column n', 'raster odd row',
'raster even row', 'raster row m','raster odd number', 'raster even number',
'raster row m column n', 'raster number n'
version 3.31 (2014/11/28)
- new macros: '\tcbstartrecording', '\tcbrecord', '\tcbstoprecording', '\tcbinputrecords'
- new options: 'squeezed title', 'squeezed title*', 'phantomlabel',
'record', 'no recording'
- 'savelowerto' changed to need only one run instead of two
- library 'skins':
* '\imagename' macro can be used in more situations
* '\tcbincludegraphics' made aware of 'grffile' package
- new library 'raster':
* tcbraster safeguarded against restricted horizontal mode
* new option: 'raster every box'
version 3.32 (2014/12/01)
- bug fix for 'crefname' and 'Crefname' options (cleveref support)
version 3.33 (2014/12/11)
- The nobreak settings after a heading are respected now for breakable and
unbreakable boxes. Use the new option 'ignore nobreak' to restore the old
behavior.
- vertical skip of two successive tcbraster environments fixed
version 3.34 (2014/12/16)
- 'height fill' now fills gapless and can be overruled by other height options
- 'before skip' and 'after skip' accept glue values now
- library 'breakable':
* new option 'compress page':
Use the new option 'compress page=none' to restore the old behavior.
- library 'raster':
* 'raster before skip' and 'raster after skip' accept glue values now
version 3.35 (2015/01/07)
- fix: 'tcbdocumentation.code.tex' changed to US-ASCII
- text color implementation changed to fix some color problems
- new options: 'upperbox', 'visible', 'invisible'
- documentation complemented
version 3.36 (2015/01/09)
- bug fix: dimension settings with 'em' or 'ex' units were sometimes converted to 0pt
- bug fix: 'boxed title' options and some algorithms of the 'fitting' library were not compatible
- bug fix: 'fit width from' ('fitting' library) may have updated counter too often
- new option: 'only'
- library 'fitting': fit process can now also includes the title
- library 'raster': new option 'raster equal skip'
- library 'documentation':
* new macros and environments:
'\docCounter', '\docCounter*', '\docLength', '\docLength*'
* new options:
'index command', 'index command name' (for imakeidx),
'color counter', 'color length',
'doclang/counter', 'doclang/counters', 'doclang/length', 'doclang/lengths'
version 3.40 (2015/01/14)
- bug fix: list environments had too much leading space if set as first elements in a box
- library 'skins':
* new option: 'titlerule style'
- library 'breakable':
algorithm for handling overfull boxes revised; new warnings implemented
version 3.50 (2015/03/16)
- bug fix: \tcbline was broken for \tcboxfit-boxes since 3.36
- text color implementation changed to fix some color problems
- before/after settings changed to detect special situations
- 'sidebyside align': new selections 'top seam', 'center seam', 'bottom seam'
- new options:
'force nobeforeafter', 'blend before title', 'blend before title code'
- library 'documentation':
'before example', 'after example' are deprecated; 'docexample' is changed
- new library 'external'
* new macros and environments:
'tcbexternal', '\tcbEXTERNALIZE', 'extikzpicture', 'extcolorbox',
'\tcbifexternal',
'\newtcbexternalizeenvironment', 'renewtcbexternalizeenvironment',
'newtcbexternalizetcolorbox', 'renewtcbexternalizetcolorbox'
* new options:
'runner', 'externalize', 'force remake', '!',
'name', 'externalize listing', 'externalize listing!',
'externalize example', 'externalize example!',
'prefix', 'environment', 'minipage', 'plain', 'compiler', 'runs',
'input source on error', 'safety', 'preamble'
- documentation structure revised
version 3.60 (2015/05/07)
- bug fix: dimension settings with 'em' or 'ex' units for 'enlarge .. by' converted to 0pt
- bug fix: 'bicolor' skin sometimes ignored color for lower part when broken
- new macros: '\tcbpatcharcangular', '\tcbpatcharcround'
- implementation of text alignment changed with new options:
'halign', 'halign upper', 'halign lower', 'halign title', 'valign upper'
- new options:
'saveto', 'circular arc', 'bean arc', 'arc is angular', 'arc is curved',
'square', 'tcbox width'
- library 'skins':
* new option: 'smart shadow arc'
- library 'documentation':
package 'doc' removed from list of required packages
- library 'external':
* new options:
'environment with percent', 'preamble tcbset', 'preclass', 'clear preclass',
'PassOptionsToPackage', 'PassOptionsToClass'
version 3.61 (2015/06/12)
- bug fix: nobreak settings after a heading were sometimes ignored depending
on the box content
- library 'external':
* now throws an error if the same external job name is used twice
* new option: '-'
- documentation bug fixes
version 3.70 (2015/07/16)
- bug fix: 'attach title to upper' attached also empty titles
- bug fix: library 'raster': blank line after tcbitemize or tcbraster could give an error message
- new options:
'text fill', 'valign scale bound',
'valign=scale', 'valigns=scale*', 'valign lower=scale', 'valign lower=scale*'
- library 'breakable':
* Settings for broken box parts are now shielded by TeX grouping. This may
break code which used side-effects with unproper skins.
* new options:
'extras unbroken', 'extras first', 'extras middle', 'extras last',
'extras', 'extras broken', 'extras unbroken and first',
'extras unbroken and last', 'extras middle and last',
'extras first and middle', 'no extras unbroken', 'no extras first',
'no extras middle', 'no extras last', 'no extras',
- library 'hooks':
* new options:
'extras unbroken pre', 'extras first pre', 'extras middle pre',
'extras last pre', 'extras pre', 'extras broken pre',
'extras unbroken and first pre', 'extras unbroken and last pre',
'extras middle and last pre', 'extras first and middle pre',
- new library 'magazine'
* new macros and environments:
'\newboxarray', '\boxarraygetsize', '\boxarrayreset', '\boxarrayclear',
'\boxarraygetbox', '\boxarraygetwidth', '\boxarraygetheight', '\boxarraygetdepth',
'\boxarraygettotalheight', '\useboxarray', '\usetcboxarray',
'\consumeboxarray', '\consumetcboxarray', 'boxarraystore',
* new options:
'store to box array', 'reset box array', 'do not store to box array',
'reset and store to box array'
version 3.71 (2015/07/23)
- bug fix: An error introduced in 3.70 broke all code without 'breakable' library
- bug fix: library 'external': spurious blank in source input removed
- documentation extended
version 3.72 (2015/08/12)
- bug fix: bounding box changes and boxed title additions were not considered
correctly by 'height fixed for' or 'height fill' (resulting in wrong page breaks)
- library loading made compatible with expl3
- cosmetic documentation changes
version 3.73 (2015/10/16)
- bug fix: '\tcbdocmarginnote' had a spurious blank.
- parbox=false settings adapted for embedded lists
- library 'documentation':
* new options:
'before doc body command', 'after doc body command',
'before doc body environment', 'after doc body environment',
'before doc body key', 'after doc body key',
'before doc body', 'after doc body'
version 3.80 (2015/11/27)
- superfluous and sometimes troublesome \unskip's were removed.
Note that this changed the behavior of 'after upper' and 'after lower'.
Some user code may need to apply the new 'after upper*' / 'after lower*'
options or insert an \unskip.
- even/odd page testing completely rewritten.
- some difference formulas were revised.
- new macros:
'\thetcolorboxnumber', '\thetcolorboxpage',
'\tcbifoddpage', '\tcbheightfromgroup'
- new options:
'after upper*', 'after lower*',
'center', 'flush right', 'flush left',
'if odd page', 'if odd page*',
'use height from group'
- library 'xparse':
* new macro: '\tcbsidebyside'
* new options: 'sidebyside adapt', 'sidebyside switch'
version 3.90 (2016/02/29)
- bug fix: 'height fill' after headings (nobreak) produced an error
- implementation for 'before' and 'before skip' changed to avoid spacing
problems when there is a page break before breakable/unbreakable boxes
- the 'height fill' option can be applied also for boxed inside a tcbraster
- new options:
'add to natural height', 'space to', 'use height from group' (new default)
- new macros:
'\tcbheightspace', '\tcbtextwidth', '\tcbtextheight'
- library 'skins':
* 'halign title' works with 'boxed title' now
* 'boxed title style' changed to be stackable
* better support for titles at the bottom of the box
* new skin: 'tile'
* new options:
'blankest', 'tile', 'no boxed title style', 'boxed title size',
'attach boxed title to bottom', 'attach boxed title to bottom*',
'attach boxed title to top', 'attach boxed title to top*',
'flip title'
- library 'raster':
* new environment:
'tcboxedraster'
* new options:
'raster multicolumn', 'raster multirow'
- library 'documentation':
removal of some unwanted blanks
version 3.91 (2016/04/27)
- bug fix: '\tcbline' was indented when setting '\parindent' inside a box
- bug fix: 'minimum for equal height group' changed current equal height group
and settings with 'em' or 'ex' units were converted to 0pt
- bug fix: setting '-output-directory' and 'outputdir=' for the minted package
broke \tcblisting for 'listing engine=minted'
- documentation: biber problem with latin1 encoding circumvented
- new options:
'minimum for current equal height group'
- library 'theorems':
* new option: 'label separator'
- new library 'vignette' for ornamental frames:
* new fadings: 'semi west', 'semi east', 'semi north', 'semi south'
* new macros: '\tcbvignette'
* new options:
'xmin', 'xmax', 'ymin', 'ymax',
'lower left corner', 'upper right corner', 'inside node', 'outside node',
'over node', 'over node offset', 'north size', 'south size', 'east size',
'west size', 'size', 'north style', 'south style', 'east style', 'west style',
'draw method', 'fade out', 'semi fade out', 'fade in', 'semi fade in',
'base color', 'raised color', 'lowered color',
'underlay vignette', 'underlay raised fading vignette',
'underlay raised shading vignette', 'underlay shade in vignette',
'finish vignette', 'finish raised fading vignette', 'finish fading vignette'
- library 'raster':
* new environment: 'tcboxeditemize'
version 3.92 (2016/05/28)
- bug fix: 'compilable listing' used no '.tex' extension causing problems with minted
- compatibility patch for \vsplit in luatex 0.95 causing problems with breakable boxes
- settings inside \tcbvignette are now inside a group
- library 'vignette': new option 'scope'
version 3.93 (2016/06/01)
- bug fix: compatibility patch for \vsplit in luatex 0.95 was buggy
- system commands are now accessed using the 'shellesc' package for
compatibility with luatex
version 3.94 (2016/07/14)
- bug fix: '\tcbincludegraphics' for fixed height boxes was broken since v3.90 (2016/02/29)
- new option 'nameref'
- library 'theorems':
Theorems made nameref-aware
- library 'listings':
* new options:
'freeze file', 'freeze none', 'freeze extension',
'freeze pdf', 'freeze png', 'freeze jpg'
- library 'external':
* implementation improved for lualatex and xelatex
* new macro '\tcbiffileprocess'
version 3.95 (2016/10/21)
- The behaviors of 'after upper' and 'after lower' are reverted back to
prior version 3.80 to have an automatic \unskip inserted.
Therefore, 'after upper*' and 'after lower*' are deprecated now.
- new option 'void'
- library 'skins':
'\tcbincludegraphics' made compatible with 'height fill' boxes.
- library 'minted':
now, included source files are searched for in relation to an optional
'output-directory' and also locally.
- library 'documentation':
Language settings are not longer reset to English for embedded boxes.
version 3.96 (2016/11/18)
- bug fix: unprotected definition of the 'nameref' option induced serious errors
- bug fix: nameref package was not detected if loaded after tcolorbox
- new macros:
'\tcbifoddpageoroneside'
- new options:
'if odd page or oneside', 'if odd page or oneside*',
- library 'documentation':
* Documentation options are not longer reset to default values for embedded
boxes. User code may be affected by this change.
* marginnotes adapt to twosided documents now
version 4.00 (2017/02/16)
- Code adaptions to support \parfillskip changing packages like KOMA-Script:
'parskip', 'noparskip', 'after skip', 'breakable', 'raster'
- 'toggle left and right' toggles corners now
- new options:
'left*', 'right*',
'spread inwards', 'spread outwards', 'move upwards', 'move upwards*', 'fill downwards',
'spread sidewards', 'spread upwards', 'spread upwards*', 'spread downwards', 'spread',
'hypertarget', 'bookmark', 'bookmark*'
- library 'skins':
* new macro '\tcbhypernode'
* new options:
'hyperref', 'hyperref node', 'hyperref interior', 'hyperref title',
'hyperlink', 'hyperlink node', 'hyperlink interior', 'hyperlink title',
'hyperurl', 'hyperurl node', 'hyperurl interior', 'hyperurl title',
'hyperurl*', 'hyperurl* node', 'hyperurl* interior', 'hyperurl* title'
version 4.01 (2017/02/19)
- bug fix: 'raster halign=center' was broken by 4.00 code changes
version 4.02 (2017/02/24)
- Further code adaptions to support \parfillskip changing packages like KOMA-Script
and to respect center environments
'parskip', 'noparskip', 'after skip', 'breakable', 'raster'
- new option: 'parfillskip restore'
- bug fix: 'segmentation style' was not applied correctly to breakable boxes with
'bicolor' skin
- bug fix: '/tcb/external/!' and '/tcb/external/-' were not usable inside \tcbset
- documentation optimizations
|