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
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
|
%% The LaTeX package tcolorbox - version 4.51 (2021/06/14)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2021 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
version 4.03 (2017/04/25)
- Implementation of 'raster equal height' changed to be more robust e.g. for loops
- Implementation of several fill options like 'fill stretch image' changed
to be more efficient and to be independent from TikZ node positioning options.
- Bug fix: 'fill plain image' and 'fill plain picture' ignored 'fill image opacity'.
- new macro: '\tcbsegmentstate'
- library 'breakable':
* new option: 'segmentation at break'
- library 'documentation':
* new options: 'documentation minted language', 'keywords bold'
- Creation of leaflets documented
version 4.10 (2017/07/05)
- new options:
'inherit height', 'verbatim ignore percent'
- library 'skins'
* new style 'enhanced standard jigsaw'
- library 'magazine':
* new macro: '\ifboxarrayempty'
- library 'breakable':
* option 'break at' allows negative values now.
* the algorithm for breaks inside a multicolumn environment was improved
(user code may be affected by this change).
* new macro: '\tcbbreak'
- library 'minted':
* the default settings for 'minted options'
are supplemented by 'breaklines,autogobble'
- new library 'poster'
* new macros and environments:
'tcbposter', '\tcbposterset', '\posterbox', 'posterboxenv',
'tcbposterwidth', 'tcbposterheight', 'tcbpostercolspacing', 'tcbposterrowspacing',
'tcbpostercolumns', 'tcbposterrows', 'tcbpostercolwidth', 'tcbposterrowheight'
* new options:
'poster', 'columns', 'rows', 'colspacing', 'rowspacing', 'spacing',
'showframe', 'width', 'height', 'prefix', 'coverage', 'no coverage',
'boxes', 'fontsize', 'name', 'column', 'column*', 'span', 'row', 'rowspan',
'fixed height', 'below', 'above', 'at', 'between', 'sequence',
'placeholder', 'xshift', 'yshift'
- New example file 'tcolorbox-example-poster'
- New tutorial 'tcolorbox-tutorial-poster' for poster creation
version 4.11 (2017/09/14)
- Standard internal minipage settings changed from 'c' to 'b' which should
fix some glitches
version 4.12 (2018/01/12)
- color implementation changed to fix problems with expl3 (thanks to Ulrike Fischer)
- Documentation typo corrected ('tcbsetmanagedlayers' instead of 'tcbsetmanagedlayer')
- Bug fix: 'borderline south' and 'borderline north' created 'Missing character'
messages for breakable boxes
- library 'theorems':
* new options 'theorem label supplement', 'theorem full label supplement'
version 4.13 (2018/03/22)
- typos in 'tcolorbox-tutorial-poster' corrected
- new options:
'grow sidewards by'
- library 'breakable':
* Warning for discarded zero height box content added
- library 'listings':
* Documentation for 'text side listing', 'listing side text',
'comment side listing', 'listing side comment' supplemented with notes.
- library 'skins':
* Options given by '/tcb/graphics options' and '/tikz/fill image options'
are now fully expanded while applied to underlying '\includegraphics'
* new option:
'graphics orientation'
version 4.14 (2018/07/26)
- bug fix (#40): 'tikz lower' and 'tikz upper' failed to take more than one parameter
- '\tcblistof' issues a warning if tocdepth is lower than 1 (#42)
- macro definition of \tcolorbox@label removed from aux file (#47)
- documentation adapted to the changed argument collection of the xparse package (#43)
- new options: 'index', 'index*'
- library 'breakable':
* (#41) 'title after break' inherits the title alignment now
(may change output of existing documents!)
* new options 'extras title after break', 'no extras title after break'
version 4.15 (2018/12/07)
- bug fix (#40): 'tikz upper', 'tikz lower' failed to take more than one parameter (again)
- bug fix: 'tcboxedraster' could not be set to be 'breakable'
- library 'breakable': Implementation of 'pad after break' changed to be
consistent with a boxed title.
- library 'raster':
* dimension settings changed to be more robust
* new options (#52) 'raster width center', 'raster width flush left', 'raster width flush right'
- Example source code of 'tcolorbox-example-poster' and 'tcolorbox-tutorial-poster'
adapted to be compatible with lipsum package version 2.0
version 4.20 (2019/03/02)
- bug fix (#60): \multicolumn could not be used for first cell with option 'tabularx'
- internal colors names renamend and offially documented (Section 9.5 Color Names):
'tcbcolframe', 'tcbcolback', 'tcbcolbacktitle', 'tcbcolbacklower',
'tcbcolupper', 'tcbcollower', 'tcbcoltitle'
- listingsutf8 compatability better documented (#58)
- semantic changed for options: 'after upper*', 'after lower*'
- new options: 'before upper*', 'before lower*', 'titlebox', 'nirvana'
- library 'skins':
* new options: 'beamer hidden', 'beamer alerted', 'hide', 'alert'
* option 'only' moved from package to skins library
- new documentation section '13 Beamer Support'
version 4.21 (2019/09/19)
- bug fix (#71): 'shield externalize' should be effective on all tcolorbox layers
- bug fix (#76): 'spread inwards', 'spread outwards', 'spread sidewards' gave
wrong results for some document geometry settings
- new options (#75): 'tabulars', 'tabulars*'
- library 'extras':
* bug fix: all 'extras ...' options from library 'hooks' took code instead of options
* new options (#73): 'minted options app', 'minted options pre',
'listing options app', 'listing options pre'
- library 'xparse':
* bug fix: options 'IfNoValueTF', 'IfValueTF', 'IfBooleanTF' failed
to recognize arguments in some code line breaks situations
- library 'documentation':
TikZ path operation documentation (#65):
* new color name: 'Fade'
* new macros and environments: '\colFade', 'docPathOperation',
'\refPathOperation', '\refPathOperation*'
* new options: 'color fade', 'color path', 'doc label', 'doc head path',
'before doc body path', 'after doc body path'
* new language string: 'path', 'paths'
- documentation: checkerbox for opacity examples was too dark
version 4.22 (2019/11/15)
- bug fix (#79) in library 'xparse':
'sidebyside adapt' did not respect color, font, and other options.
- bug fix (#85) in library 'raster':
'raster before skip' and 'raster after skip' did not accept glue anymore.
- new initialization option (#80): 'reset counter on overlays'
version 4.30 (2020/04/28)
- bug fix (#88): 'parskip' and 'noparskip' had side-effects for the box content
in combination with 'height fill' and 'parbox=false'
- bug fix (#90) in library 'documentation':
initialize 'doc description' for every docXXX to be empty
- Internal box counter renamed to remove warnings when using \includeonly
- library 'documentation':
* major code overhaul to support simultaneous documentation of
similar commands, environments, keys, path operations (#89).
* Note that the new code reserves a small additional amount of vertical space
for documented macros which may result in changed page breaks.
* Note that documentation heads are now embedded inside a 'raster'
which requires other customizations for vertical space (if needed)
* new macros and environments: 'docCommands', 'docEnvironments',
'docKeys', '\tcbmakedocSubKeys', 'docPathOperations'
* new options: 'doc index' (#91), 'doc name', 'doc parameter',
'doc keypath', 'doc sort index', 'doc no index',
'doc raster command', 'doc raster environment', 'doc raster key',
'doc raster path', 'doc raster'
* additional option setting for: '\docAuxCommand', '\docAuxEnvironment',
'\docAuxKey', '\docValue', '\docColor', '\docCounter', '\docLength'
* superfluous and undocumented opton 'color frame' removed (#94)
* '\refAux' and '\refAuxcs' are not longer colored, if colorlinks=false (#95)
- library 'listingsutf8':
safeguard against compiling with other engines than pdf(la)tex (#92)
- library 'fitting':
'\tcbfitdim' is described in more detail (#96)
- library 'poster':
poster width and height caveats described in more detail (#98)
version 4.31 (2020/07/31)
- bug fix (#101): \tcbincludepdf did not work for lualatex
- bug fix (#103): Several tests had a missing \relax
- bug fix (#106): Breakable tcolorbox may overlap with following the text
- bug fix: 'space to' did not result in a stable value
- Internal change: all 'code 2 args' replaced by 'code n args={2}'
- documentation typo corrections (#102)
- library 'documentation':
* indention of <environment content> changed to \ttfamily (#100)
version 4.32 (2020/09/17)
- documentation typo corrections (#108) and enhancements (#109)
- bug fix (#112): 'index format=doc' caused redefinition of '\_'
among other errors.
- bug fix: 'valign=scale*' was erroneous.
- enhancement (#110): color stack support for breakable boxes (pdflatex and lualatex)
to let colors survive a break to the next partial box.
- library 'xparse':
* new options (#111): 'IfNoValueT', 'IfNoValueF', 'IfValueT', 'IfValueF',
'IfBooleanT', 'IfBooleanF'
version 4.40 (2020/09/25)
- bug fix (#114): 'IfBooleanT', 'IfBooleanF'
- bug fix (#117): 'widget' set 'toprule at break' and needed the breakable library
- (bug) fix: style 'marker' set 'breakable' and needed the breakable library
- (#113) 'capture=hbox' applies '\@parboxrestore' now to allow e.g. hbox style
listings inside indented environments like itemize
- (#2) support 'hbox' for 'minted' listings
- (#115) New default vertical space options
'before skip balanced', 'after skip balanced', 'beforeafter skip balanced'
NOTE: These options replace the current default options
'parskip', 'noparskip', 'autoparskip'
WARNING: Old documents may need adapted manual page breaks where used.
Otherwise: Use \tcbsetforeverylayer{autoparskip}
to restore the old behavior!
- 'before skip' and 'before skip balanced' do not insert glue now, if
the tcolorbox is the first element in a minipage (or sourrounding tcolorbox)
version 4.41 (2020/09/29)
- bug fix (#120): color bleeding for xelatex and breakable boxes (since 4.32)
version 4.42 (2020/10/09)
- due to several problems with the color algorithm introduced with version 4.32,
essentially reversion to the proven pre 4.32 method.
* support of luacolor persists (since 4.32)
* color stacks (by pdfcol) are not mandatory any more,
but are optional now with 'use color stack'. Note that effects of whatsits
on the vertical space have to be expected.
version 4.50 (2021/05/21)
- bug fix (#128): 'tcbincludepdf' ignored some raster options
- bug fix (#138): visible seam for 'bicolor' and 'tile' in 'sidebyside' mode
around the lower (i.e. rightward) part
- (#125) Using group around arguments for title in the examples
- (#134) Allocate write registers \tcb@out and \tcb@record@out only when needed
- (#135) Documentation: recommend to use initialization options after loading hyperref
- (#118) Documentation: warn user about white title color becoming invisible
for the skin 'empty'
- documentation correction (#127)
- documentation of library skins is split into a general part and the catalog of skins
- (#124) '\tcblistof' enhanced to take an optional short title and mimic
'\listoffigures' where applicable
- library 'skins':
* new option 'opacitybacklower'
* new jigsaw variant of 'bicolor':
'bicolor jigsaw', 'bicolorfirst jigsaw', 'bicolormiddle jigsaw', 'bicolorlast jigsaw'
* implementation of bicolor overhauled
* skin documentation complemented with sidebyside examples.
- library 'theorems':
* (#126) new option 'theorem hanging indent'
- library 'vignette':
* (#133) documentation examples for fading styles for every side added
- library 'raster':
* (#119) '\thetcbrasternum' changed output the content of a counter.
LaTeX counter 'tcbrasterrow', 'tcbrastercolumn', 'tcbrasternum' documented.
version 4.51 (2021/06/14)
- bug fix: allocation error for write registers
- (#139) library 'documentation': package loading of 'marvosym' and 'pifont'
removed. Symbols are accessed directly now by 'documentation'.
|