Debian Codegraph @

texmf-dist/source/latex/chronos/chronos.dtx

raw
1 % \iffalse meta-comment
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % Copyright 2023-2026 Clea F. Rees
4 %
5 % This work may be distributed and/or modified under the
6 % conditions of the LaTeX Project Public License, either version 1.3c
7 % of this license or (at your option) any later version.
8 % The latest version of this license is in
9 % https://www.latex-project.org/lppl.txt
10 % and version 1.3c or later is part of all distributions of LaTeX
11 % version 2008-05-04 or later.
12 %
13 % This work has the LPPL maintenance status `maintained'.
14 %
15 % The Current Maintainer of this work is Clea F. Rees.
16 %
17 % This file may only be distributed together with a copy of the package
18 % chronos. You may however distribute the package chronos without
19 % such generated files.
20 %
21 % This work consists of all files listed in manifest.txt.
22 %
23 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
24 % \fi
25 %
26 % \iffalse
27 %<*driver>
28 \pdfminorversion=7
29 \RequirePackage{svn-prov}
30 %^^A ref. ateb Max Chernoff: https://tex.stackexchange.com/a/723294/
31 \def\MyMakePrivateLetters{\makeatletter\ExplSyntaxOn\endlinechar13}
32 \ExplSyntaxOff
33 \ProvidesFileSVN{$Id: chronos.dtx 11797 2026-03-21 16:01:38Z cfrees $}[v0.9.4 \revinfo][\filebase\ DTX]
34 \DefineFileInfoSVN[chronosdoc]
35 \GetFileInfoSVN*
36 \let\chronosdocversion\fileversion
37 \let\chronosdocrev\filerev
38 \let\chronosdocbase\filebase
39 \let\chronosdocinfo\fileinfo
40 \let\chronosdocdate\filedate
41 \let\chronosdocfilename\filename
42 %^^A BEGIN preamble <<<
43 \documentclass[10pt,british,a4paper]{ltxdoc}
44 % ltnews42 / ateb David Carlisle: https://tex.stackexchange.com/a/754799/ (sylwad Ulrike Fischer rhywle ond alla i ddim canfod o hyd iddo fe)
45 \partokencontext=0
46 \usepackage[extract=python]{memoize}
47 \mmzset{%
48 prefix=memos/,
49 auto=\cref{multiref},
50 auto=\Cref{multiref},
51 auto=\labelcref{multiref},
52 auto=\cpageref{multiref},
53 auto=\labelcpageref{multiref},
54 auto=\namecref{ref},
55 auto=\nameCref{ref},
56 auto=\namecrefs{ref},
57 auto=\nameCrefs{ref},
58 auto=\lcnamecrefs{ref},
59 auto=\lcnamecrefs{ref},
60 auto=\crefrange{refrange},
61 auto=\cpagerefrange{refrange},
62 auto=\Cpagerefrange{refrange},
63 % deactivate csname=pgfsys@getposition,
64 }
65 \usepackage{chronos}
66 \GetFileInfoSVN{chronos}
67 \let\chronosfileversion\fileversion
68 \let\chronosfilerev\filerev
69 \let\chronosfilebase\filebase
70 \let\chronosfileinfo\fileinfo
71 \let\chronosfiledate\filedate
72 \let\chronosfilename\filename
73 \EnableCrossrefs
74 \CodelineIndex
75 \RecordChanges
76 %^^A \PageIndex
77 \usetikzlibrary{arrows.meta,ext.paths.ortho,tikzmark,decorations.pathreplacing}
78 \usepackage{babel}
79 \usepackage{geometry}
80 \usepackage{fancyhdr}
81 \usepackage[inline]{enumitem}
82 \usepackage{calc}
83 \usepackage{rotating}
84 \usepackage{floatpag}
85 \usepackage{etoolbox}
86 \usepackage{verbatim}
87 \usepackage{parskip}
88 \usepackage{changepage}
89 ^^A\usepackage{titling}% GWALL!!
90 \usepackage{makeidx}
91 \usepackage{pifont}
92 \usepackage{amstext}
93 \usepackage{amssymb}
94 \usepackage{booktabs}
95 \usepackage{tabularx}
96 \usepackage{array}
97 \usepackage{subcaption}
98 \usepackage{csquotes}
99 \MakeAutoQuote{‘}{’}
100 \MakeAutoQuote*{“}{”}
101 \usepackage[rm={lining},sf={lining},tt={tabular,lining,monowidth}]{cfr-lm}
102 \usepackage{microtype}
103 %^^A caption manual 21
104 \DeclareCaptionLabelFormat{continued}{Continued #1 #2}
105 \captionsetup[ContinuedFloat]{labelformat=continued}
106 \newcommand*{\cywir}{\marginpar{\raggedleft\mbox{ }\bigskip\par\textcolor{green}{\ding{52}}}}
107 \newcommand*{\anghywir}{\marginpar{\raggedleft\mbox{ }\bigskip\par\textcolor{red}{\ding{56}~}}}
108 \newcommand*{\fycheck}{\checkmark}
109 \newcommand*{\fycross}{--}
110 \newcommand* \sqarrow {\reflectbox{\Pisymbol{psy}{191}}}
111 \let\chronosdocmacrocode\macrocode
112 \let\endchronosdocmacrocode\endmacrocode
113 \let\chronosdocenvironment\environment
114 \let\endchronosdocenvironment\endenvironment
115 \usepackage[%
116 loadHyperref=true,
117 createIndexEntries=false,
118 ]{doctools}
119 %^^A sicrhau hyperindex=false: llwytho CYN bookmark
120 \usepackage{hypdoc}% ateb Ulrike Fischer: https://tex.stackexchange.com/a/695555/
121 \usepackage{bookmark}
122 \hypersetup{%
123 colorlinks=true,
124 citecolor={moss},
125 extension=pdf,
126 linkcolor={strawberry},
127 linktocpage=true,
128 pdfcreator={TeX},
129 pdfproducer={pdfeTeX},
130 urlcolor={blueberry}%
131 }
132 \usepackage{cleveref}
133 \crefname{paragraph}{note}{notes}
134 \crefname{subparagraph}{note}{notes}
135 \makeatletter
136 \ExplSyntaxOn
137 %^^A BEGIN booleans <<<
138 \bool_new:N \g__chronosdoc_describe_bool
139 \bool_gset_false:N \g__chronosdoc_describe_bool
140 \bool_new:N \l__chronosdoc_vfit_bool
141 \bool_new:N \l__chronosdoc_hfit_bool
142 \bool_set_true:N \l__chronosdoc_vfit_bool
143 \bool_set_true:N \l__chronosdoc_hfit_bool
144 \bool_new:N \l__chronosdoc_show_targets_bool
145 %^^A \bool_set_true:N \l__chronosdoc_show_targets_bool
146 \bool_set_false:N \l__chronosdoc_show_targets_bool
147 \bool_new:N \l__chronosdoc_show_links_bool
148 \bool_set_false:N \l__chronosdoc_show_links_bool
149 \bool_new:N \l__chronosdoc_uc_bool
150 \bool_set_false:N \l__chronosdoc_uc_bool
151 %^^A END booleans >>>
152 %^^A BEGIN boxes <<<
153 \box_new:N \l__chronosdoc_bocs_box
154 %^^A END boxes >>>
155 %^^A BEGIN clists <<<
156 \clist_new:N \l__chronosdoc_vals_clist
157 %^^A END clists >>>
158 %^^A BEGIN dims <<<
159 \dim_new:N \l__chronosdoc_width_dim
160 %^^A END dims >>>
161 %^^A BEGIN fps <<<
162 \fp_new:N \l__chronosdoc_troibocs_fp
163 %^^A END fps >>>
164 %^^A BEGIN regexes <<<
165 \regex_const:Nn \c__chronosdoc_cs_regex { \c{cs} \s* \cB\{ ([^\}]*) \cE\} }
166 \regex_const:Nn \c__chronosdoc_idx_regex { [^A-Za-z0-9\c{textquotesingle}\/\:\-+\s\<\>] }
167 \regex_const:Nn \c__chronosdoc_meta_regex { \c{meta} \s* \cB\{ ([^\}]*) \cE\} }
168 \regex_const:Nn \c__chronosdoc_prime_regex { \c{textquotesingle} }
169 \regex_const:Nn \c__chronosdoc_all_regex { ^( .* )\Z }
170 \regex_const:Nn \c__chronosdoc_commaspace_regex { ,\s* }
171 %^^A END regexes >>>
172 %^^A BEGIN sequences <<<
173 \seq_new:N \l__chronosdoc_enwau_seq
174 \seq_new:N \l__chronosdoc_tmpa_seq
175 \seq_new:N \l__chronosdoc_tmpb_seq
176 %^^A END sequences >>>
177 %^^A BEGIN token lists <<<
178 \tl_new:N \g__chronosdoc_fn_tl
179 \tl_new:N \l__chronosdoc_tmpa_tl
180 \tl_new:N \l__chronosdoc_tmpb_tl
181 \tl_new:N \l__chronosdoc_tmpc_tl
182 %^^A END token lists >>>
183 %^^A BEGIN keys <<<
184 \keys_define:nn { chronos doc / name }
185 {
186 bagpuss .bool_set:N = \l__chronosdoc_bagpuss_bool,
187 bagpuss .default:n = true,
188 bagpuss .initial:n = false,
189 conj .tl_set:N = \l__chronosdoc_conj_tl,
190 conj .initial:n = and,
191 first ~ only .bool_set:N = \l__chronosdoc_firstonly_bool,
192 first ~ only .default:n = true,
193 first ~ only .initial:n = false,
194 font .tl_set:N = \l__chronosdoc_font_tl,
195 font .initial:n = \KeyFont,
196 idx .bool_set:N = \l__chronosdoc_idx_bool,
197 idx .default:n = true,
198 idx .initial:n = true,
199 idx ~ as .clist_set:N = \l__chronosdoc_idx_as_clist,
200 idx ~ font ~ post .tl_set:N = \l__chronosdoc_idx_font_post_tl,
201 idx ~ font ~ post .value_required:n = true,
202 idx ~ font ~ post .initial:n = {\normalfont},
203 idx ~ font ~ pre .tl_set:N = \l__chronosdoc_idx_font_pre_tl,
204 idx ~ font ~ pre .value_required:n = true,
205 idx ~ font ~ pre .initial:n = {\normalfont},
206 idx ~ pre .tl_set:N = \l__chronosdoc_idx_pre_tl,
207 idx ~ pre .initial:V = \c_empty_tl,
208 idx ~ prefix .tl_set:N = \l__chronosdoc_idx_pre_tl,
209 idx ~ post .tl_set:N = \l__chronosdoc_idx_post_tl,
210 idx ~ post .initial:V = \c_empty_tl,
211 %^^A idx ~ sort .tl_set:N = \l__chronosdoc_idx_sort_tl,
212 %^^A idx ~ sort .initial:V = \c_empty_tl,
213 link .bool_set:N = \l__chronosdoc_link_bool,
214 link .default:n = true,
215 link .initial:n = false,
216 link ~ pre .tl_set:N = \l__chronosdoc_link_pre_tl,
217 link ~ prefix .tl_set:N = \l__chronosdoc_link_pre_tl,
218 link ~ prefix .initial:V = \c_empty_tl,
219 link ~ to .tl_set:N = \l__chronosdoc_link_to_tl,
220 link ~ to .initial:V = \c_empty_tl,
221 lluosog .bool_gset:N = \g__chronosdoc_enwau_ll_bool,
222 lluosog .default:n = true,
223 lluosog .initial:n = false,
224 pre .meta:n = { idx ~ pre = #1, link ~ prefix = #1, target ~ prefix = #1 },
225 prefix .meta:n = { idx ~ pre = #1, link ~ prefix = #1, target ~ prefix = #1 },
226 names .clist_set:N = \l__chronosdoc_names_clist,
227 names .initial:V = \c_empty_clist,
228 no ~ idx .bool_set_inverse:N = \l__chronosdoc_idx_bool,
229 no ~ idx .default:n = true,
230 no ~ link .bool_set_inverse:N = \l__chronosdoc_link_bool,
231 no ~ link .default:n = true,
232 no ~ target .bool_set_inverse:N = \l__chronosdoc_target_bool,
233 no ~ target .default:n = true,
234 symbol .tl_set:N = \l__chronosdoc_symbol_tl,
235 symbol .initial:V = \c_empty_tl,
236 target .bool_set:N = \l__chronosdoc_target_bool,
237 target .default:n = true,
238 target .initial:n = false,
239 target ~ as .tl_set:N = \l__chronosdoc_target_as_tl,
240 target ~ as .initial:V = \c_empty_tl,
241 target ~ pre .tl_set:N = \l__chronosdoc_target_pre_tl,
242 target ~ prefix .tl_set:N = \l__chronosdoc_target_pre_tl,
243 target ~ prefix .initial:V = \c_empty_tl,
244 type .tl_set:N = \l__chronosdoc_type_tl,
245 type .initial:n = key,
246 unknown .code:n = {
247 \tl_set:No \l__chronosdoc_tmpc_tl { \l_keys_key_str }
248 \keys_set:nn { chronos doc / name }{ type=\l__chronosdoc_tmpc_tl }
249 },
250 }
251 %^^A END keys >>>
252 %^^A BEGIN fns <<<
253 \cs_new_protected_nopar:Nn \__chronosdoc_arg_spacer:
254 {
255 \bool_if:NT \g__chronosdoc_describe_bool
256 {
257 \c_space_tl
258 }
259 \bool_gset_false:N \g__chronosdoc_describe_bool
260 }
261 \cs_generate_variant:Nn \text_titlecase:n { o,v,V }
262 \cs_new_protected_nopar:Nn \__chronosdoc_NewDocElement_aux:nn
263 {
264 \NewDocElement[%
265 macrolike = false,
266 toplevel = false,
267 idxtype = #2,
268 idxgroup = #2 s\actualchar\textsc{ \text_titlecase:o {#2 s} },
269 printtype = #2
270 ]{\text_titlecase:n { #1 } }{ #1 }
271 }
272 \cs_generate_variant:Nn \__chronosdoc_NewDocElement_aux:nn { VV }
273 \cs_new_protected_nopar:Nn \__chronosdoc_PrintDescribe_renew:nn %^^A <<<
274 {% addaswyd o doctools t18
275 \strut \MacroFont
276 \color{doctools@ColorCodeNames}
277 \tl_set:Nv \l__chronosdoc_tmpa_tl { #1 labelname }
278 \clist_map_inline:nn { #2 }
279 {
280 \tl_set:Nn \l_tmpa_tl { #1 : ##1 }
281 \regex_match:NnF \c__chronosdoc_cs_regex { ##1 }
282 {
283 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
284 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
285 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
286 }
287 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { ##1 }
288 \bool_if:NT \l__chronosdoc_show_targets_bool
289 {
290 \par
291 \textcolor{chronosWildStrawberry}{\l_tmpa_tl}
292 }
293 \par
294 }
295 \PrintLabelName[\macrolabelfont] { \cs:w #1 labelname\cs_end:} % = \csname / \endcsname ? (o \Usename)
296 \bool_gset_true:N \g__chronosdoc_describe_bool
297 }
298 \cs_new_protected_nopar:Nn \__chronosdoc_PrintDescribe_aux:n
299 {
300 %%^^A gweler ateb David Carlisle: https://tex.stackexchange.com/a/659828/ i gwestiwn rhywun arall am rhywbeth arall
301 \ExpandArgs {c} \RenewDocumentCommand { PrintDescribe \text_titlecase:n {#1} } { m }
302 {
303 \__chronosdoc_PrintDescribe_renew:nn { #1 } { ##1 }
304 }
305 }
306 \cs_generate_variant:Nn \__chronosdoc_PrintDescribe_aux:n { V }
307 %^^A >>>
308 \cs_new_protected_nopar:Nn \__chronosdoc_PrintName_aux:n %^^A <<<
309 {
310 \exp_args:Nc \RenewDocumentCommand { Print \text_titlecase:n {#1} Name } { m }
311 {
312 \strut \MacroFont
313 \color{doctools@ColorCodeNames}
314 \string ##1
315 }
316 }
317 \cs_generate_variant:Nn \__chronosdoc_PrintName_aux:n { V }
318 %^^A >>>
319 \cs_new_nopar:Nn \__chronosdoc_hypertarget:nn %^^A <<<
320 {
321 \bool_if:NTF \g__chronosdoc_enwau_ll_bool
322 {
323 \hypertarget { #1 }{ #2 s }
324 }{
325 \hypertarget { #1 }{ #2 }
326 }
327 \PackageInfo{chronosdoc}{Hypertarget ~ #1 ~ set}
328 }
329 \cs_generate_variant:Nn \__chronosdoc_hypertarget:nn { Vn }
330 % ^^A >>>
331 \cs_new_nopar:Nn \__chronosdoc_hyperlink:nn %^^A <<<
332 {
333 \bool_if:NTF \g__chronosdoc_enwau_ll_bool
334 {
335 \hyperlink { #1 }{ #2 s }
336 }{
337 \hyperlink { #1 }{ #2 }
338 }
339 \PackageInfo{chronosdoc}{Hyperlinking ~ #2 ~ to ~ #1}
340 }
341 \cs_generate_variant:Nn \__chronosdoc_hyperlink:nn { Vn }
342 %^^A >>>
343 \cs_new_protected_nopar:Nn \__chronosdoc_hyperlink:n %^^A <<<
344 {
345 \group_begin:
346 \tl_set:Nn \l__chronosdoc_tmpa_tl { #1 }
347 \regex_replace_all:nnN { \s+ } { \- } \l__chronosdoc_tmpa_tl
348 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l__chronosdoc_tmpa_tl
349 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l__chronosdoc_tmpa_tl
350 \__chronosdoc_hyperlink:Vn \l__chronosdoc_tmpa_tl { #1 }
351 \group_end:
352 }
353 %^^A >>>
354 \cs_new_protected_nopar:Nn \__chronosdoc_hypertargets:nnnN %^^A <<<
355 {%^^A #1 type #2 list of prefixes (possibly empty) #3 list of key names #4 text font command
356 \group_begin:
357 \bool_set_false:N \l_tmpb_bool
358 \bool_if:NTF \g__chronosdoc_enwau_ll_bool
359 {
360 \tl_set:Ne \l__chronosdoc_tmpc_tl { s }
361 }{
362 \tl_clear:N \l__chronosdoc_tmpc_tl
363 }
364 \clist_if_empty:nTF { #2 }
365 {
366 \clist_map_inline:nn { #3 }
367 {
368 \tl_if_empty:nTF { #1 }
369 {
370 \tl_set:Nn \l_tmpa_tl { ##1 }
371 }{
372 \tl_set:Nn \l_tmpa_tl { #1 : ##1 }
373 }
374 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
375 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
376 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
377 \bool_if:NTF \l_tmpb_bool {
378 \bool_if:NTF \l__chronosdoc_firstonly_bool
379 {
380 \__chronosdoc_hypertarget:Vn \l_tmpa_tl {}
381 }{
382 , ~
383 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { #4 {##1} \l__chronosdoc_tmpc_tl }
384 }
385 }{
386 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { #4 {##1} \l__chronosdoc_tmpc_tl }
387 \bool_set_true:N \l_tmpb_bool
388 }
389 }
390 }{
391 \clist_map_inline:nn { #2 }
392 {
393 \clist_map_inline:nn { #3 }
394 {
395 \tl_if_empty:nTF { #1 }
396 {
397 \tl_set:Nn \l_tmpa_tl { ##1 / ####1 }
398 }{
399 \tl_set:Nn \l_tmpa_tl { #1 : ##1 / ####1 }
400 }
401 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
402 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
403 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
404 \bool_if:NTF \l_tmpb_bool
405 {
406 \bool_if:NTF \l__chronosdoc_firstonly_bool
407 {
408 \__chronosdoc_hypertarget:Vn \l_tmpa_tl {}
409 }{
410 , ~
411 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { #4 {####1} \l__chronosdoc_tmpc_tl }
412 }
413 }{
414 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { #4 {####1} \l__chronosdoc_tmpc_tl }
415 \bool_set_true:N \l_tmpb_bool
416 }
417 }
418 }
419 }
420 \bool_gset_false:N \g__chronosdoc_enwau_ll_bool
421 \group_end:
422 }
423 %^^A >>>
424 \cs_new_protected_nopar:Nn \__chronosdoc_hypertargets:nnn %^^A <<<
425 {%^^A #1 type #2 list of prefixes (possibly empty) #3 list of key names
426 \group_begin:
427 \clist_if_empty:nTF { #2 }
428 {
429 \clist_map_inline:nn { #3 }
430 {
431 \tl_if_empty:nTF { #1 }
432 {
433 \tl_set:Nn \l_tmpa_tl { ##1 }
434 }{
435 \tl_set:Nn \l_tmpa_tl { #1 : ##1 }
436 }
437 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
438 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
439 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
440 \__chronosdoc_hypertarget:Vn \l_tmpa_tl {}
441 }
442 }{
443 \clist_map_inline:nn { #2 }
444 {
445 \clist_map_inline:nn { #3 }
446 {
447 \tl_if_empty:nTF { #1 }
448 {
449 \tl_set:Nn \l_tmpa_tl { ##1 / ####1 }
450 }{
451 \tl_set:Nn \l_tmpa_tl { #1 : ##1 / ####1 }
452 }
453 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
454 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
455 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
456 \__chronosdoc_hypertarget:Vn \l_tmpa_tl {}
457 }
458 }
459 }
460 \group_end:
461 }
462 \cs_generate_variant:Nn \__chronosdoc_hypertargets:nnn { VVV , VnV }
463 %^^A >>>
464 \cs_generate_variant:Nn \text_titlecase:n { V }
465 \cs_new_protected_nopar:Nn \__chronosdoc_enwau_typeset:n %^^A <<<
466 {%^^A #1 conjunction
467 \seq_use:Nnnn \l__chronosdoc_enwau_seq { ~ #1 ~ } { , ~ } { ~ #1 ~ }
468 \bool_gset_false:N \g__chronosdoc_enwau_ll_bool
469 }
470 %^^A >>>
471 \cs_new_protected_nopar:Nn \__chronosdoc_enwau_aux:nn %^^A <<<
472 {%^^A #1 rhestr allweddau/cydsyniadau #2 conjunction
473 \seq_set_from_clist:Nn \l_tmpa_seq { #1 }
474 \__chronosdoc_seq_titlecase:N \l_tmpa_seq
475 \bool_if:NTF \g__chronosdoc_enwau_ll_bool
476 {
477 \seq_set_map:NNn \l__chronosdoc_enwau_seq \l_tmpa_seq
478 {
479 { \l__chronosdoc_font_tl ##1 s }
480 }
481 }{
482 \seq_set_map:NNn \l__chronosdoc_enwau_seq \l_tmpa_seq
483 {
484 { \l__chronosdoc_font_tl ##1 }
485 }
486 }
487 \bool_gset_false:N \g__chronosdoc_enwau_ll_bool
488 \__chronosdoc_enwau_typeset:n { #2 }
489 }
490 %^^A >>>
491 \cs_new_protected:Nn \__chronosdoc_seq_titlecase:N
492 {
493 \bool_if:NT \l__chronosdoc_uc_bool
494 {
495 \seq_pop_left:NN #1 \l_tmpa_tl
496 \tl_set:Nn \l_tmpb_tl { \text_titlecase:V \l_tmpa_tl }
497 \seq_put_left:NV #1 \l_tmpb_tl
498 }
499 }
500 \cs_new_protected_nopar:Nn \__chronosdoc_enwau_hyperlink:nnnn %^^A <<<
501 {%^^A #1 rhestr allweddau/cydsyniadau #2 conjunction #3 label e.e. boolkey #4 prefix e.e. empty
502 \seq_set_from_clist:Nn \l_tmpa_seq { #1 }
503 \bool_set_true:N \l_tmpb_bool
504 \seq_set_map:NNn \l__chronosdoc_enwau_seq \l_tmpa_seq {
505 \regex_match:NnTF \c__chronosdoc_cs_regex { ##1 }
506 {
507 \tl_set:Nn \l_tmpa_tl { #3 : #4 ##1 }
508 \regex_replace_all:NnN \c__chronosdoc_cs_regex { \c{string} \c{\1} } \l_tmpa_tl
509 }{
510 \tl_if_empty:NTF \l__chronosdoc_link_to_tl
511 {
512 \tl_set:Nn \l_tmpa_tl { #3 : #4 ##1 }
513 }{
514 \regex_replace_all:nnN { \s+ } { \- } \l__chronosdoc_link_to_tl
515 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l__chronosdoc_link_to_tl
516 \regex_replace_all:NnN \c__chronosdoc_idx_regex { } \l__chronosdoc_link_to_tl
517 \tl_set:Ne \l_tmpa_tl { #3 : #4 \l__chronosdoc_link_to_tl }
518 }
519 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
520 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
521 \regex_replace_all:NnN \c__chronosdoc_idx_regex { } \l_tmpa_tl
522 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
523 }
524 \bool_lazy_and:nnTF { \l__chronosdoc_uc_bool } { \l_tmpb_bool }
525 {
526 \__chronosdoc_hyperlink:Vn \l_tmpa_tl { \l__chronosdoc_font_tl \text_titlecase:n { ##1 } }
527 }{
528 \__chronosdoc_hyperlink:Vn \l_tmpa_tl { \l__chronosdoc_font_tl ##1 }
529 }
530 \bool_set_false:N \l_tmpb_bool
531 \bool_if:NT \l__chronosdoc_show_links_bool
532 {
533 \textcolor{ForestGreen}{\l_tmpa_tl}
534 }
535 }
536 \__chronosdoc_enwau_typeset:n { #2 }
537 }
538 %^^A >>>
539 \cs_new_protected_nopar:Nn \__chronosdoc_enwau_hypertarget:nnnn %^^A <<<
540 {%^^A #1 rhestr allweddau/cydsyniadau #2 conjunction #3 label e.e. boolkey #4 prefix e.e. empty
541 \seq_set_from_clist:Nn \l_tmpa_seq { #1 }
542 \bool_if:NTF \l__chronosdoc_uc_bool
543 {
544 \bool_set_true:N \l_tmpb_bool
545 }{
546 \bool_set_false:N \l_tmpb_bool
547 }
548 \seq_set_map:NNn \l__chronosdoc_enwau_seq \l_tmpa_seq {
549 \tl_if_empty:nTF { #3 }
550 {
551 \tl_set:Nn \l_tmpa_tl { #4 ##1 }
552 }{
553 \tl_set:Nn \l_tmpa_tl { #3 : #4 ##1 }
554 }
555 \regex_match:NnTF \c__chronosdoc_cs_regex { ##1 }
556 {
557 \regex_replace_all:NnN \c__chronosdoc_cs_regex { \c{string} \c{\1} } \l_tmpa_tl
558 }{
559 \regex_replace_all:nnN { \s+ } { \- } \l_tmpa_tl
560 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpa_tl
561 \regex_replace_all:NnN \c__chronosdoc_idx_regex { } \l_tmpa_tl
562 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpa_tl
563 }
564 \bool_if:NTF \l_tmpb_bool
565 {
566 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { \l__chronosdoc_font_tl \text_titlecase:n { ##1 } }
567 }{
568 \__chronosdoc_hypertarget:Vn \l_tmpa_tl { \l__chronosdoc_font_tl ##1 }
569 }
570 }
571 \__chronosdoc_enwau_typeset:n { #2 }
572 }
573 %^^A >>>
574 \cs_new_protected_nopar:Nn \__chronosdoc_enwau_idx_aux:Nn %^^A <<<
575 {
576 \tl_set:Nx \l_tmpa_tl { \text_titlecase:v { #2slabelname } }
577 \tl_set:Nv \l_tmpb_tl { #2slabelname }
578 \bool_set_true:N \l_tmpa_bool
579 \tl_if_empty:NF \l__chronosdoc_idx_pre_tl
580 {
581 \regex_replace_all:NnN \c__chronosdoc_commaspace_regex { , \c{space} } \l__chronosdoc_idx_pre_tl
582 \regex_replace_once:NnN \c__chronosdoc_all_regex { \1 \c{actualchar} \cB\{ \c{string} \u{l\_\_chronosdoc\_idx\_font\_pre\_tl} \c{space} \1 \cE\} } \l__chronosdoc_idx_pre_tl
583 \bool_set_false:N \l_tmpa_bool
584 }
585 \tl_if_empty:NF \l__chronosdoc_idx_post_tl
586 {
587 %% makeindex only supports subsubentries; this may be the second so don't go further
588 %% dyw y rheol ddim yn lot o gymorth o gwbl ar ôl i mi fod yn llwyddianias gosod y pethau tu mewn yn y lle cyntaf!
589 \regex_replace_all:NnN \c__chronosdoc_commaspace_regex { , \c{space} } \l__chronosdoc_idx_post_tl
590 \regex_replace_once:NnN \c__chronosdoc_all_regex { \c{levelchar} \1 \c{actualchar} \cB\{ \c{string} \u{l\_\_chronosdoc\_idx\_font\_post\_tl} \c{space} \1 \cE\} } \l__chronosdoc_idx_post_tl
591 \bool_if:NF \l_tmpa_bool { \PackageWarning{chronosdoc}{You ~ cannot ~ use ~ idx ~ pre ~ and ~ idx ~ post. ~ Prioritising ~ post ~ } }
592 \bool_set_true:N \l_tmpa_bool
593 }
594 \tl_if_empty:NF \l__chronosdoc_symbol_tl
595 {
596 \regex_replace_once:NnN \c__chronosdoc_all_regex { \c{string} \c{ idx \1 } } \l__chronosdoc_symbol_tl
597 }
598 \seq_map_inline:Nn #1
599 {
600 \tl_set:Nn \l__chronosdoc_tmpa_tl { ##1 }
601 \regex_replace_all:NnN \c__chronosdoc_idx_regex { } \l__chronosdoc_tmpa_tl
602 \regex_match:NnTF \c__chronosdoc_cs_regex { ##1 }
603 {
604 \tl_set:Nn \l__chronosdoc_tmpb_tl { ##1 }
605 \regex_replace_all:NnN \c__chronosdoc_cs_regex { \c{string} \c{verb} \! \* \+ \c{string} \c{\1} \+ } \l__chronosdoc_tmpb_tl
606 \bool_if:NTF \l_tmpa_bool
607 {
608 \__chronosdoc_index_post_macro:VVVVV \l_tmpb_tl \l_tmpa_tl \l__chronosdoc_tmpa_tl \l__chronosdoc_tmpb_tl \l__chronosdoc_idx_post_tl
609 }{
610 \__chronosdoc_index_pre_macro:VVVVVV \l_tmpb_tl \l_tmpa_tl \l__chronosdoc_tmpa_tl \l__chronosdoc_font_tl \l__chronosdoc_tmpb_tl \l__chronosdoc_idx_pre_tl
611 }
612 }{
613 \bool_if:NTF \l_tmpa_bool
614 {
615 \__chronosdoc_index_post:VVVVnV \l_tmpb_tl \l_tmpa_tl \l__chronosdoc_tmpa_tl \l__chronosdoc_font_tl { ##1 \l__chronosdoc_symbol_tl } \l__chronosdoc_idx_post_tl
616 }{
617 \__chronosdoc_index_pre:VVVVnV \l_tmpb_tl \l_tmpa_tl \l__chronosdoc_tmpa_tl \l__chronosdoc_font_tl { ##1 \l__chronosdoc_symbol_tl } \l__chronosdoc_idx_pre_tl
618 }
619 }
620 }
621 }
622 %^^A >>>
623 %^^A based on code courtesy of egreg: http://tex.stackexchange.com/a/240687/
624 %^^A mangling is my own... (addaswyd - bron copïo-gludo - o cfr-coursepacket.cls)
625 %^^A like trying to crochet with a chainsaw, but only needed a couple of times
626 \cs_new_protected:Npn \__chronosdoc_troibocs:nnnn #1 #2 #3 #4 %^^A angle % h dim % v dim % cynnwys y bocs %^^A <<<
627 {
628 \fp_set:Nn \l__chronosdoc_troibocs_fp { #1 }
629 \hbox_set:Nn \l__chronosdoc_bocs_box { #4 }
630 \fp_compare:nF { \l__chronosdoc_troibocs_fp = \c_zero_fp }
631 {
632 \box_rotate:Nn \l__chronosdoc_bocs_box { \l__chronosdoc_troibocs_fp }
633 }
634 \hbox_set:Nn \l__chronosdoc_bocs_box
635 {
636 \box_move_up:nn { \box_dp:N \l__chronosdoc_bocs_box } { \box_use:N \l__chronosdoc_bocs_box }
637 }
638 \bool_if:NT \l__chronosdoc_hfit_bool
639 {
640 \hbox_set_to_wd:Nnn \l__chronosdoc_bocs_box { #2 }
641 {
642 \hss \box_use:N \l__chronosdoc_bocs_box \hss
643 }
644 }
645 \tl_set:Nx \l_tmpa_tl {*}
646 \tl_set:Nx \l_tmpb_tl {#3}
647 \tl_if_eq:NNF \l_tmpa_tl \l_tmpb_tl
648 {
649 \bool_if:NT \l__chronosdoc_vfit_bool
650 {
651 \dim_set:Nn \l__chronosdoc_width_dim { \box_ht:N \l__chronosdoc_bocs_box }
652 \dim_sub:Nn \l__chronosdoc_width_dim { #3 }
653 \dim_compare:nNnT {0pt} < \l__chronosdoc_width_dim
654 {
655 \vbox_set_to_ht:Nnn \l__chronosdoc_bocs_box { #3 + .5\l__chronosdoc_width_dim }
656 {
657 \vss \box_use:N \l__chronosdoc_bocs_box \vss
658 }
659 }
660 }
661 }
662 \leavevmode\box_use:N \l__chronosdoc_bocs_box
663 }
664 \cs_new_eq:NN \chronosdoctroibocs \__chronosdoc_troibocs:nnnn
665 %^^A >>>
666 %^^A <<< indexing
667 \cs_new_protected_nopar:Nn \__chronosdoc_index_post_macro:nnnnn
668 {%^^A #1 idxtype #2 idxgroup #3 sanitised entry #4 idx entry #6 additional sub-level (with \levelchar) or empty
669 \mbox{}%
670 \doc@providetarget
671 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
672 \@bsphack
673 \begingroup
674 \@sanitize
675 \@wrindex{#1\actualchar\doctools@indexHeadFont{#2}:\levelchar#3\actualchar#4#5\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
676 }
677 \cs_new_protected_nopar:Nn \__chronosdoc_index_pre_macro:nnnnnn
678 {%^^A #1 idxtype #2 idxgroup #3 sanitised entry #4 ffont #5 idx entry #6 intermediate level
679 \mbox{}%
680 \doc@providetarget
681 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
682 \@bsphack
683 \begingroup
684 \@sanitize
685 \@wrindex{#1\actualchar\doctools@indexHeadFont{#2}:\levelchar#6\levelchar#3\actualchar{\string#4\space #5}\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
686 }
687 \cs_new_protected_nopar:Nn \__chronosdoc_index_pre:nnnnnn
688 {%^^A #1 idxtype #2 idxgroup #3 sanitised entry #4 ffont #5 idx entry #6 intermediate level
689 \mbox{}%
690 \doc@providetarget
691 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
692 \@bsphack
693 \begingroup
694 \@sanitize
695 \@wrindex{#1\actualchar\doctools@indexHeadFont{#2}:\levelchar#6\levelchar#3\actualchar{\string#4\space #5}\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
696 }
697 \cs_new_protected_nopar:Nn \__chronosdoc_index_post:nnnnnn
698 {%^^A #1 idxtype #2 idxgroup #3 sanitised entry #4 ffont #5 idx entry #6 additional sub-level (with \levelchar) or empty
699 \mbox{}%
700 \doc@providetarget
701 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
702 \@bsphack
703 \begingroup
704 \@sanitize
705 \@wrindex{#1\actualchar\doctools@indexHeadFont{#2}:\levelchar#3\actualchar{\string#4\space #5}#6\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
706 }
707 \cs_new_protected_nopar:Nn \__chronosdoc_index:nnnnn
708 {%^^A #1 idxtype #2 idxgroup #3 entry
709 \doc@providetarget
710 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
711 \@bsphack
712 \begingroup
713 \@sanitize
714 \@wrindex{#1\actualchar\doctools@indexHeadFont{#2}:\levelchar#3\actualchar{\string#4\space #5}\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
715 }
716 \cs_new_protected_nopar:Nn \__chronosdoc_index:nn
717 {%^^A #1 idxtype #2 idxgroup #3 entry
718 \doc@providetarget
719 %%^^A ateb Heiko Oberdiek https://tex.stackexchange.com/a/412521/
720 \@bsphack
721 \begingroup
722 \@sanitize
723 \@wrindex{#2\actualchar{\string#1\space #2}\doc@handleencap{discussion}}%^^A sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
724 }
725 \cs_generate_variant:Nn \__chronosdoc_index:nn { Vn }
726 \cs_generate_variant:Nn \__chronosdoc_index:nnnnn { VVVVn }
727 \cs_generate_variant:Nn \__chronosdoc_index_pre:nnnnnn { VVVVnV }
728 \cs_generate_variant:Nn \__chronosdoc_index_pre_macro:nnnnnn { VVVVVV }
729 \cs_generate_variant:Nn \__chronosdoc_index_post_macro:nnnnn { VVVVV }
730 \cs_generate_variant:Nn \__chronosdoc_index_post:nnnnnn { VVVVnV }
731 \cs_generate_variant:Nn \__chronosdoc_enwau_hyperlink:nnnn { nVVV }
732 \cs_generate_variant:Nn \__chronosdoc_enwau_hypertarget:nnnn { nVVV }
733 \cs_generate_variant:Nn \__chronosdoc_enwau_aux:nn { nV }
734 \cs_generate_variant:Nn \__chronosdoc_enwau_idx_aux:Nn { NV }
735 %^^A >>>
736 \cs_generate_variant:Nn \text_titlecase:n { V }
737 \cs_generate_variant:Nn \seq_set_from_clist:Nn { NV }
738 \cs_new_protected_nopar:Nn \__chronosdoc_name:nn %^^A <<<
739 {
740 \keys_set:nn { chronos doc / name } { #1 }
741 \clist_if_empty:NT \l__chronosdoc_idx_as_clist { \clist_set:Nn \l__chronosdoc_idx_as_clist { #2 } }
742 \bool_if:NTF \l__chronosdoc_link_bool
743 {
744 \__chronosdoc_enwau_hyperlink:nVVV { #2 } \l__chronosdoc_conj_tl \l__chronosdoc_type_tl \l__chronosdoc_link_pre_tl
745 }{
746 \bool_if:NTF \l__chronosdoc_target_bool
747 {
748 \tl_if_empty:NTF \l__chronosdoc_target_as_tl
749 {
750 \__chronosdoc_enwau_hypertarget:nVVV { #2 } \l__chronosdoc_conj_tl \l__chronosdoc_type_tl \l__chronosdoc_target_pre_tl
751 }{
752 \__chronosdoc_enwau_aux:nV { #2 } \l__chronosdoc_conj_tl
753 %% #1 type #2 list of prefixes (possibly empty) # list of key names
754 \__chronosdoc_hypertargets:VVV \l__chronosdoc_type_tl \l__chronosdoc_target_pre_tl \l__chronosdoc_target_as_tl
755 }
756 }{
757 \__chronosdoc_enwau_aux:nV { #2 } \l__chronosdoc_conj_tl
758 }
759 }
760 \bool_if:NT \l__chronosdoc_idx_bool
761 {
762 \seq_set_from_clist:NN \l__chronosdoc_enwau_seq \l__chronosdoc_idx_as_clist
763 \__chronosdoc_enwau_idx_aux:NV \l__chronosdoc_enwau_seq \l__chronosdoc_type_tl
764 }
765 }%^^A >>>
766 \NewDocumentCommand \chronosdocidxfn { m }
767 {
768 \footnotemark
769 \tl_gset:No \g__chronosdoc_fn_tl { #1 }
770 }
771 \NewDocumentCommand \chronosdocrestorefn {}
772 {
773 \footnotetext{\g__chronosdoc_fn_tl}
774 }
775 %^^A END fns >>>
776 %^^A BEGIN document fns <<<
777 \NewDocumentCommand \vals { m }
778 {
779 \group_begin:
780 \clist_set:Nn \l__chronosdoc_vals_clist { #1 }
781 \ttfamily = \__chronosdoc_arg_spacer:
782 \clist_use:Nn \l__chronosdoc_vals_clist { \textbar }
783 \group_end:
784 }
785 \NewDocumentCommand \opts { O {and} m }
786 {
787 \group_begin:
788 \seq_set_from_clist:Nn \l_tmpa_seq { #2 }
789 \seq_set_map:NNn \l_tmpb_seq \l_tmpa_seq { \option{ ##1} }
790 \seq_use:Nnnn \l_tmpb_seq { ~ #1 ~ } { ,~ } { ~ #1 ~}
791 \group_end:
792 }
793 \NewDocumentCommand \cvals { m }
794 {
795 \group_begin:
796 \seq_set_from_clist:Nn \l_tmpa_seq { #1 }
797 \seq_pop_left:NN \l_tmpa_seq \l_tmpa_tl
798 \seq_set_map:NNn \l_tmpb_seq \l_tmpa_seq { \meta{ ##1} }
799 \seq_put_left:Nn \l_tmpb_seq { \val { \l_tmpa_tl} }
800 \seq_use:Nn \l_tmpb_seq { \texttt{:} }
801 \group_end:
802 }
803 \NewDocumentCommand \cvalsmarg { m }
804 {
805 \group_begin:
806 \seq_set_from_clist:Nn \l_tmpa_seq { #1 }
807 \seq_pop_left:NN \l_tmpa_seq \l_tmpa_tl
808 \seq_set_map:NNn \l_tmpb_seq \l_tmpa_seq { \marg{ ##1} }
809 \seq_put_left:Nn \l_tmpb_seq { \valmarg { \l_tmpa_tl} }
810 \seq_use:Nn \l_tmpb_seq { \texttt{:} }
811 \group_end:
812 }
813 \NewDocumentCommand \tuplelistvalsmarg { O { / } m } % ee 1a/1b/1c,2a2b/2c,... -> {<1a>/<1b><1c>,...}
814 {
815 \group_begin:
816 \seq_set_from_clist:Nn \l_tmpa_seq { #2 }
817 \seq_clear:N \l__chronosdoc_tmpb_seq
818 \seq_map_inline:Nn \l_tmpa_seq
819 {
820 \seq_set_split:Nnn \l_tmpb_seq { #1 } { ##1 }
821 \int_compare:nNnTF { \seq_count:N \l_tmpb_seq } = { 1 }
822 {
823 \seq_put_right:No \l__chronosdoc_tmpb_seq { ##1 }
824 }{
825 \seq_set_map:NNn \l__chronosdoc_tmpa_seq \l_tmpb_seq { \meta{####1} }
826 \seq_put_right:Nx \l__chronosdoc_tmpb_seq { \seq_use:Nn \l__chronosdoc_tmpa_seq { \texttt {#1} } }
827 }
828 }
829 \texttt{= \__chronosdoc_arg_spacer: \{ } { \seq_use:Nn \l__chronosdoc_tmpb_seq { \texttt{ , } } } \texttt { \} }
830 \group_end:
831 }
832 \NewDocumentCommand \NewDocElements { s m } {
833 \clist_set:Nn \l__chronosdoc_vals_clist { #2 }
834 \clist_map_inline:Nn \l__chronosdoc_vals_clist
835 {
836 \seq_set_split:Nnn \l_tmpa_seq { | } { ##1 }
837 \seq_pop_left:NN \l_tmpa_seq \l_tmpa_tl
838 \seq_pop_left:NNF \l_tmpa_seq \l_tmpb_tl { \tl_set_eq:NN \l_tmpb_tl \l_tmpa_tl }
839 \__chronosdoc_NewDocElement_aux:VV \l_tmpa_tl \l_tmpb_tl
840 \IfBooleanF { #1 }
841 {
842 \cs_if_free:cTF { \l_tmpa_tl labelname }
843 {
844 \expandafter\xdef\csname \l_tmpa_tl labelname \endcsname{ \l_tmpb_tl }
845 }{
846 \edef\tempa{Label~already~defined~for~\l_tmpa_tl}\PackageError{chronos}{\tempa}%
847 }
848 \cs_if_free:cTF { \l_tmpa_tl slabelname }
849 {
850 \expandafter\xdef\csname \l_tmpa_tl slabelname \endcsname{ \l_tmpb_tl s}
851 }{
852 \edef\tempa{Label~already~defined~for~\l_tmpa_tl s}\PackageError{chronos}{\tempa}%
853 }
854 \tl_set:Nx \l__chronosdoc_tmpa_tl { \text_titlecase:n { \l_tmpa_tl } }
855 \tl_set:Nx \l__chronosdoc_tmpb_tl { \text_titlecase:n { \l_tmpb_tl } }
856 \cs_if_free:cTF { \l__chronosdoc_tmpa_tl labelname }
857 {
858 \expandafter\xdef\csname \l__chronosdoc_tmpa_tl labelname \endcsname{ \l__chronosdoc_tmpb_tl }
859 }{
860 \edef\tempa{Label~already~defined~for~\l__chronosdoc_tmpa_tl}\PackageError{chronos}{\tempa}%
861 }
862 \cs_if_free:cTF { \l__chronosdoc_tmpa_tl slabelname }
863 {
864 \expandafter\xdef\csname \l__chronosdoc_tmpa_tl slabelname \endcsname{ \l__chronosdoc_tmpb_tl s}
865 }{
866 \edef\tempa{Label~already~defined~for~\l__chronosdoc_tmpa_tl s}\PackageError{chronos}{\tempa}%
867 }
868 }
869 \__chronosdoc_PrintDescribe_aux:V \l_tmpa_tl
870 \__chronosdoc_PrintName_aux:V \l_tmpa_tl
871 }
872 }
873 \NewDocumentCommand \chronosdocidx { O {} m } % XXX
874 {% idx as gets used for everything inc target
875 \group_begin:
876 \clist_set:Nn \l__chronosdoc_idx_as_clist { #2 }
877 \keys_set:nn { chronos doc / name } { type=, #1 }
878 \seq_set_from_clist:NN \l__chronosdoc_enwau_seq \l__chronosdoc_idx_as_clist
879 \tl_if_empty:NTF \l__chronosdoc_type_tl
880 {
881 \seq_map_inline:Nn \l__chronosdoc_enwau_seq
882 {
883 \__chronosdoc_index:Vn \l__chronosdoc_font_tl { ##1 }
884 }
885 }{
886 \__chronosdoc_enwau_idx_aux:NV \l__chronosdoc_enwau_seq \l__chronosdoc_type_tl
887 }
888 \bool_if:NT \l__chronosdoc_target_bool
889 {
890 \seq_map_inline:Nn \l__chronosdoc_enwau_seq
891 {
892 \tl_set:Nn \l_tmpb_tl { ##1 }
893 \tl_put_left:NV \l_tmpb_tl \l__chronosdoc_target_pre_tl
894 \tl_if_empty:NF \l__chronosdoc_type_tl
895 {
896 \tl_put_left:Nn \l_tmpb_tl { : }
897 \tl_put_left:NV \l_tmpb_tl \l__chronosdoc_type_tl
898 }
899 \regex_replace_all:nnN { \s+ } { \- } \l_tmpb_tl
900 \regex_replace_all:NnN \c__chronosdoc_meta_regex { \<\1\> } \l_tmpb_tl
901 \regex_replace_all:NnN \c__chronosdoc_idx_regex { } \l_tmpb_tl
902 \regex_replace_all:NnN \c__chronosdoc_prime_regex { ' } \l_tmpb_tl
903 \__chronosdoc_hypertarget:Vn \l_tmpb_tl {}
904 }
905 }
906 \group_end:
907 }
908 %^^A from doctools (t18)
909 % \hook_gput_code:nnn {begindocument/before} {chronosdoc}
910 \AtBeginDocument
911 {
912 %% doctools overwirtes doc's definitions of the environment/macros for documenting environments
913 %% \env dim ond shorthand -> \environment
914 %% cadw \environment -> \enviro CYN eu ail-ysgrifennu nhw unwaith eto isod
915 \IfFreeTF \enviro {\let\enviro\environment}{\PackageError{chronosdoc}{\bslash enviro already taken!}}%
916 \RenewDocElement[% doc.pdf v3 t15
917 macrolike = true ,
918 toplevel = false,
919 idxtype = macro,
920 idxgroup = macros\actualchar\textsc{Macros},
921 printtype = \macrolabelname{}
922 ]{Macro}{macro}%
923 \RenewDocElement[% doc.pdf v3 t15
924 macrolike = false,
925 toplevel = false,
926 idxtype = environment,
927 idxgroup = environments\actualchar\textsc{Environments},
928 printtype = \envlabelname{}
929 ]{Env}{environment}%
930 \RenewDocumentCommand \PrintDescribeMacro { m }
931 {%^^A addaswyd o doctools t18
932 \__chronosdoc_PrintDescribe_renew:nn { macro } { \string #1 }
933 }
934 \__chronosdoc_PrintDescribe_aux:n { env }
935 \__chronosdoc_PrintName_aux:n { env }
936 \__chronosdoc_PrintName_aux:n { macro }
937 }
938 \NewDocumentCommand \chronosdoccreulabel { s O {#3} m }% creu lluosog ; enw llawn ; tag
939 {%
940 \ifcsundef {#3labelname}
941 {%
942 \expandafter\edef\csname #3labelname\endcsname {#2}%
943 }{%
944 \edef\tempa{\cs{#3labelname}}\PackageError{chronosdoc}{\tempa{} ~ already ~ defined.}%
945 }%
946 \IfBooleanF {#1}
947 {%
948 \ifcsundef {#3slabelname}
949 {%
950 \expandafter\edef\csname #3slabelname\endcsname {#2s}%
951 }{%
952 \edef\tempa{\cs{#3slabelname}}\PackageError{chronosdoc}{\tempa{} ~ already ~ defined.}%
953 }%
954 }%
955 }
956 \NewDocumentCommand \keyname { O {} m }
957 {
958 \group_begin:
959 \bool_set_false:N \l__chronosdoc_uc_bool
960 \__chronosdoc_name:nn { font=\KeyFont, link, #1 } { #2 }
961 \group_end:
962 }
963 \NewDocumentCommand \keysname { O {} m }
964 {
965 \group_begin:
966 \bool_set_false:N \l__chronosdoc_uc_bool
967 \__chronosdoc_name:nn { font=\KeyFont, lluosog, link, #1 } { #2 }
968 \group_end:
969 }
970 \NewDocumentCommand \conceptname { O {} m }
971 {
972 \group_begin:
973 \bool_set_false:N \l__chronosdoc_uc_bool
974 \__chronosdoc_name:nn { font=\ConceptFont, type=element, #1 } { #2 }
975 \group_end:
976 }
977 \NewDocumentCommand \conceptsname { O {} m }
978 {
979 \group_begin:
980 \bool_set_false:N \l__chronosdoc_uc_bool
981 \__chronosdoc_name:nn { font=\ConceptFont, type=element, lluosog, #1 } { #2 }
982 \group_end:
983 }
984 \NewDocumentCommand \pkgname { O {} m }
985 {
986 \group_begin:
987 \bool_set_false:N \l__chronosdoc_uc_bool
988 \__chronosdoc_name:nn { font=\PkgFont, no link, type=pkg, #1 } { #2 }
989 \group_end:
990 }
991 \NewDocumentCommand \Keyname { O {} m }
992 {
993 \group_begin:
994 \bool_set_true:N \l__chronosdoc_uc_bool
995 \__chronosdoc_name:nn { font=\KeyFont, link, #1 } { #2 }
996 \group_end:
997 }
998 \NewDocumentCommand \Conceptsname { O {} m } % { s t {+} O {element} D () { and } D <> {#6} m }
999 {
1000 \group_begin:
1001 \bool_set_true:N \l__chronosdoc_uc_bool
1002 \__chronosdoc_name:nn { font=\ConceptFont, type=element, lluosog, #1 } { #2 }
1003 \group_end:
1004 }
1005 \NewDocumentCommand \Keysname { O {} m }
1006 {
1007 \group_begin:
1008 \bool_set_true:N \l__chronosdoc_uc_bool
1009 \__chronosdoc_name:nn { font=\KeyFont, link, lluosog, link, #1 } { #2 }
1010 \group_end:
1011 }
1012 \NewDocumentCommand \Conceptname { O {} m } % { s t {+} O {element} D () { and } D <> {#6} m }
1013 {
1014 \group_begin:
1015 \bool_set_true:N \l__chronosdoc_uc_bool
1016 \__chronosdoc_name:nn { font=\ConceptFont, type=element, #1 } { #2 }
1017 \group_end:
1018 }
1019 \NewDocumentCommand \Pkgname { O {} m } % { s t {+} O {element} D () { and } D <> {#6} m }
1020 {
1021 \group_begin:
1022 \bool_set_true:N \l__chronosdoc_uc_bool
1023 \__chronosdoc_name:nn { font=\PkgFont, no link, type=pkg, #1 } { #2 }
1024 \group_end:
1025 }
1026 \NewDocumentCommand \fortags { s o m }{
1027 \group_begin:
1028 \hfill ~ { \macrolabelfont \clist_use:nn { #3 } { , ~ } }
1029 \IfBooleanT { #1 }
1030 {
1031 \clist_map_inline:nn { #3 }
1032 {
1033 \@nameuse{Special\Taglabelname Index}{\string\sffamily\space ##1}%
1034 }
1035 }
1036 \IfValueT { #2 }
1037 {% #1 type #2 list of prefixes (possibly empty) #3 list of key names
1038 \keys_set:nn { chronos doc / name }{ #2 }
1039 \__chronosdoc_hypertargets:VnV \l__chronosdoc_type_tl { #3 } \l__chronosdoc_names_clist
1040 }
1041 \group_end:
1042 }
1043 \NewDocumentCommand \chronosdocindex { m }
1044 {
1045 \doc@providetarget{\HD@target}
1046 \@bsphack
1047 \begingroup
1048 \@sanitize
1049 \@wrindex{#1\doc@handleencap{discussion}}% sylwad Ulrike Fischer: https://tex.stackexchange.com/questions/695800/how-can-i-get-exactly-one-space-in-idx-i-know-how-to-get-two-or-none-but-not?noredirect=1#comment1727576_695800
1050 }
1051 %^^A addaswyd o doc.sty - usage
1052 \@ifundefined{discussion}{\def\discussion#1{\textup{#1}}}{}
1053 \def\usage#1{\textit{\textbf{#1}}}
1054 \patchcmd{\@doc@describe}{\@nameuse{Special#1Index}{#2}}{
1055 \clist_map_inline:nn { #2 }
1056 {
1057 \@nameuse{Special#1Index}{##1}
1058 }
1059 }{\PackageInfo{chronosdoc}{Patched ~ \textbackslash @doc@describe.}}{\PackageWarning{chronosdoc}{Patching ~ \textbackslash doc@describe ~ failed ~ on }}
1060 \NewDocumentCommand \keysx { O {Keys} m}{\par #1:~ {\raggedright #2\par}}
1061 \NewDocumentCommand \loadlist { O {Packages} +m }
1062 {
1063 \group_begin:
1064 \par
1065 \noindent
1066 \seq_set_from_clist:Nn \l_tmpa_seq { #2 }
1067 #1:
1068 \begin {itemize} \item \seq_use:Nn \l_tmpa_seq { \item } \end{itemize}
1069 \group_end:
1070 }
1071 \newcommand*\val[1]{{\ttfamily = \__chronosdoc_arg_spacer: \meta{#1}}}
1072 %^^A \newcommand*\valcy[1]{{\ttfamily = \meta{\cymraeg{#1}}}}
1073 \newcommand*\valmarg[1]{{\ttfamily = \__chronosdoc_arg_spacer: \marg{#1}}}
1074 \newcommand*\valsmarg[1]{{\ttfamily = \__chronosdoc_arg_spacer: \marg{\vals{#1}}}}
1075 \newcommand*\valmargcy[1]{{\ttfamily =\marg{\cymraeg{#1}}}}
1076 \NewDocumentCommand \chronosdochyperlink { m }
1077 {
1078 \group_begin:
1079 \__chronosdoc_hyperlink:n { #1 }
1080 \group_end:
1081 }
1082 \NewDocumentCommand \chronosdochypertargets { s t{+} O { \texttt } mmm }
1083 {
1084 %% #1 - for 'invisible' target or * for typeset
1085 %% #2 + typeset all targets (if *) or - typeset only the first (if *)
1086 %% #3 text font command
1087 %% #4 type e.g. key (empty OK)
1088 %% #5 list of prefixes (empty OK) e.g. life,event,period
1089 %% #6 list of key names e.g. at,place below,tag anchor
1090 \group_begin:
1091 \IfBooleanTF { #2 }
1092 {
1093 \bool_set_false:N \l__chronosdoc_firstonly_bool
1094 }{
1095 \bool_set_true:N \l__chronosdoc_firstonly_bool
1096 }
1097 \IfBooleanTF { #1 }
1098 {% #1 type #2 list of prefixes (possibly empty) # list of key names #4 text font command
1099 \__chronosdoc_hypertargets:nnnN { #4 } { #5 } { #6 } #3
1100 }{
1101 \__chronosdoc_hypertargets:nnn { #4 } { #5 } { #6 }
1102 }
1103 \group_end:
1104 }
1105 \NewDocumentCommand \idxeg { } {\textrm{\textdagger}}% \string\textrm{(e.g.)
1106 \cs_new_eq:NN \IfTLEqualF \tl_if_eq:eeF
1107 \ExplSyntaxOff
1108 \DeclareRobustCommand \ConceptFont {%
1109 \not@math@alphabet\ConceptFont\relax
1110 \normalfont\sffamily\normalcolor}
1111 \DeclareRobustCommand \PkgFont {%
1112 \not@math@alphabet\PkgFont\relax
1113 \normalfont\sffamily\normalcolor}
1114 \DeclareRobustCommand \KeyFont {%
1115 \not@math@alphabet\KeyFont\relax
1116 \normalfont\ttfamily\normalcolor}
1117 \DeclareRobustCommand \macrolabelfont{\not@math@alphabet\macrolabelfont\relax\normalfont\footnotesize\em\normalcolor}
1118 \DeclareTextFontCommand \textconcept {\ConceptFont}
1119 \DeclareTextFontCommand \textpkg {\PkgFont}
1120 \DeclareTextFontCommand \textkey {\KeyFont}
1121 \DeclareTextFontCommand \textmacrolabel{\macrolabelfont}
1122 \newcommand*\pkg[1]{\textpkg{#1}}
1123 \newcommand*\Pkg[1]{\textpkg{\MakeUppercase#1}}
1124 \newcommand*\lib[1]{\textpkg{#1}}%\expandafter\chronos@index{\liblabelname a}{\liblabelname}{#1}}
1125 %^^A END document fns >>>
1126 \chronosdoccreulabel{macro}
1127 \chronosdoccreulabel[environment]{env}
1128 \chronosdoccreulabel[package]{pkg}
1129 \chronosdoccreulabel[package option]{pkgopt}
1130 \chronosdoccreulabel[dimension]{dimen}
1131 \chronosdoccreulabel*[class]{cls}
1132 \chronosdoccreulabel*[classes]{clss}
1133 \chronosdoccreulabel[colour list]{collist}
1134 \chronosdoccreulabel[colour scheme key]{colschemekey}
1135 \chronosdoccreulabel{concept}
1136 \chronosdoccreulabel[bool]{boolean}
1137 \chronosdoccreulabel{label}
1138 \newcommand*\PrintLabelName[2][\normalfont\normalsize\normalcolor]{#1#2}
1139 \newcommand*\liblabelname{pgf/ti\string\emph{k}z library}
1140 \newcommand*\libslabelname{pgf/ti\string\emph{k}z libraries}
1141 \newcommand*\pgfkeylabelname{pgf/ti\string\emph{k}z key}
1142 \newcommand*\keyval[1]{\texttt{#1}}
1143 \NewDocElements{%
1144 boolkey|boolean key,%
1145 choice|choice key,chronosstyle|chronos style,colour,clistkey|comma-separated list key,colkey|colour key,collistkey|colour list key,colscheme|colour scheme,coord|coordinate,%
1146 datekey|date key,dateformat|date format key,dimkey|dimension key,%
1147 element,%
1148 key,keyhandler|key handler,keytype|key type,%
1149 layer,%
1150 node,
1151 prog|programme,%
1152 style,%
1153 tag%
1154 }
1155 \renewenvironment{theindex}
1156 {%
1157 \twocolumn[\section*{\indexname}
1158 \addcontentsline{toc}{section}{\indexname}%
1159 \emph{%
1160 Features are sorted by kind.
1161 Numbers written in bold italics refer to the pages containing the main descriptions of the corresponding entries.
1162 Numbers underlined refer to the code lines where the entries are defined.
1163 Upright numbers refer to pages containing additional comments, discussion or examples of usage or to line numbers for usage in the code\texsethanks*[help with indexing]{David Carlisle and Ulrike Fischer}{695555}.
1164 \textup{\textdagger} indicates an example of usage.%
1165 }\bigskip
1166 ]\chronosdocrestorefn
1167 \markboth{\indexname}{}%
1168 %^^A {\indexname}%
1169 \pagestyle{fancy}%
1170 \thispagestyle{fancy}%
1171 \parindent\z@
1172 \parskip\z@ \@plus .3\p@\relax
1173 \let\item\@idxitem}
1174 {}
1175 \renewcommand\glossary@prologue{%
1176 \section *{{\changehistoryname}}\markboth {{\changehistoryname}}{}%
1177 }
1178 \lstdefinestyle{lstchronos}{% modified from style used by doctools.sty for the latexcode environment
1179 style=lstDemoStyleLaTeXCode,%lstDemoStyleLaTeXCode,%lstDocStyleBase,
1180 gobble=2,
1181 texcsstyle=\color{doc@keywordcolor},
1182 moretexcs={chronoslife,chronosevent,chronosperiod,chronostheory,chronostheorycircle,chronosinfo,chronosmaintitle,chronosset,chronosnewcolourscheme,chronosnewcolorscheme,draw,chronosshowpreset,chronosshowcolour,chronosshowcolor,chronosshowfeatures},
1183 %^^A morekeywords={%
1184 %^^A timeline,border,
1185 %^^A colours,colour,color,colors,
1186 %^^A levels,
1187 %^^A major,minor,step,
1188 %^^A date,dates,year,years,era,eras,
1189 %^^A mark,marks,bare,
1190 %^^A frame,
1191 %^^A foreground,overlay,background,main,
1192 %^^A life,event,period,theory,info,
1193 %^^A connect,connection,connections,connectors,connector,
1194 %^^A line,lines,
1195 %^^A tag,
1196 %^^A name,
1197 %^^A at,
1198 %^^A birth,death,start,%end,
1199 %^^A sizes,
1200 %^^A labels,
1201 %^^A placeholder,
1202 %^^A placeholders,
1203 %^^A },
1204 %^^A morekeywords={text tag,text tags,tag anchor,as is,{place above},place below,connections on,lines on,middle ground,border on,timeline on,timeline width,timeline height,timeline margin,timeline inner margin,frame,only years,no connections,event years on line,event year on line,step major year,step minor year,step year,step from year,bce year label,bce label,ce label,ce year label,step divisions,step minor years,step major years,step years,outer colour,outer color,inner colour,inner color,middle colour,middle color,dates content,name content,text content,circle texts,colour rotation,color rotation,no colour rotation,no color rotation,rotate all colours,rotate all colors,colours above,colours below,colors above,colors below,without eras,full dates,only years,only text,default colour,default color},
1205 numbers=none,
1206 stringstyle=\color{doc@stringcolor},
1207 keywordstyle=\color{chronosWildStrawberry}\bfseries,%\color{doc@keywordcolor}
1208 commentstyle=\color{doc@commentcolor},
1209 backgroundcolor=\color{doc@demo@backcolor},
1210 rulecolor=\color{doc@rulecolor},
1211 frame=none,
1212 }
1213 \lstdefinestyle{lstchronosframe}{% modified from style used by doctools.sty for the latexcode environment
1214 style=lstchronos,%lstDemoStyleLaTeXCode,%lstDocStyleBase,
1215 frame=single, % none, leftline, topline, bottomline, lines
1216 %% single, shadowbox
1217 framesep=3pt,
1218 rulesep=2pt, % control the space between frame and listing
1219 %% and between double rules.
1220 framerule=0.4pt, % controls the width of the rules.
1221 }
1222 \lstloadlanguages{[LaTeX]TeX}
1223 \lstnewenvironment{chronoscode}[1][]{\lstset{style=lstchronosframe,morekeywords={#1}}}{}
1224 \lstnewenvironment{codchronos}[1][]{\lstset{style=lstchronos,morekeywords={#1}}}{}
1225 \lstnewenvironment{codlatex}[1][]{\lstset{style=lstDemoStyleLaTeXCode,gobble=2,frame=none,morekeywords={#1}}}{}
1226 \lstnewenvironment{latexcode}[1][]{\lstset{style=lstDemoStyleLaTeXCode,gobble=2,morekeywords={#1}}}{}%
1227 \RenewDocumentCommand \lstnewenvironment { moomm }{\relax}
1228 \IfFreeT \chronosdocidxheadfont {\let\chronosdocidxheadfont\doctools@indexHeadFont}%
1229 %^^A GWALL!!
1230 %^^A\newif\ifchronosdoctemp
1231 %^^A\chronosdoctempfalse
1232 \AtBeginDocument{%
1233 \RenewDocumentCommand {\Default} { s o g }{% addaswyd o doctools.sty
1234 \IfValueTF {#2} {%
1235 \edef\tempa{empty}\edef\tempb{#2}% byddai'n well i brofi #3 ond dw i ddim yn sicr sut i wneud felly
1236 \ifx\tempa\tempb\def\tempc{empty}\let\tempd\@empty\else\def\tempd{ (#2)}\def\tempc{dependent on other options}\fi
1237 }{\def\tempc{dependent on other options}\def\tempd{}}%
1238 \par Default: %
1239 \IfValueTF {#3} {%
1240 \texttt{#3}%
1241 }{%
1242 \tempc
1243 }%
1244 \tempd
1245 \IfBooleanF {#1} {\par}%
1246 }%
1247 }
1248 \NewDocumentCommand {\Initial} { s o g }{% addaswyd o doctools.sty
1249 \IfValueTF {#2} {%
1250 \edef\tempa{empty}\edef\tempb{#2}% byddai'n well i brofi #3 ond dw i ddim yn sicr sut i wneud felly
1251 \ifx\tempa\tempb\def\tempc{empty}\let\tempd\@empty\else\def\tempd{ (#2)}\def\tempc{dependent on other options}\fi
1252 }{\def\tempc{dependent on other options}\def\tempd{}}%
1253 \par Initially: %
1254 \IfValueTF {#3} {%
1255 \texttt{#3}%
1256 }{%
1257 \tempc
1258 }%
1259 \tempd
1260 \IfBooleanF {#1} {\par}%
1261 }
1262 \NewDocumentCommand \texsethanks { s +O {providing the code implementing this} m m } {%
1263 \begingroup
1264 \IfBooleanTF { #1 }{%
1265 \chronosdocidxfn{I am grateful to #3 for #2 at \protect\href{https://tex.stackexchange.com/a/#4/}{\protect\TeX{} StackExchange: #4}.}%
1266 }{%
1267 \footnote{I am grateful to #3 for #2 at \href{https://tex.stackexchange.com/a/#4/}{\TeX{} StackExchange: #4}.}%
1268 }%
1269 \endgroup
1270 }
1271 \NewDocumentCommand \texseans { s +O {Based on} +D () {my} m } {%
1272 \IfBooleanTF {#1}
1273 {%
1274 \href{https://tex.stackexchange.com/a/#4/}{\TeX{} SE: #4}%
1275 }{%
1276 \footnote{#2 #3 answer at \href{https://tex.stackexchange.com/a/#4/}{\TeX{} StackExchange: #4}.}%
1277 }%
1278 }
1279 \geometry{headheight=12pt,marginparwidth=45mm,hmarginratio=4:1,vscale=.8,hscale=.7,verbose}
1280 \newlength\tewadjust
1281 \setlength\tewadjust{\marginparwidth+\marginparsep-\paperwidth+\textwidth+\oddsidemargin+1in}
1282 \newlength\chronosdoctemplgth
1283 \setlength\chronosdoctemplgth{0pt}
1284 \newcommand*\TikZ{Ti\emph{k}Z}
1285 \newcommand*\PGF{PGF}
1286 \newcommand*\pgf{PGF}
1287 \fancypagestyle{fancy}{%
1288 \fancyhf{}%
1289 \fancyhf[lh]{\textit{\leftmark}}%
1290 \fancyhf[rh]{%
1291 %^^A \IfTLEqualF { \leftmark } { \rightmark } {\textit{\rightmark}}%
1292 \ifx\leftmark\rightmark\relax
1293 \else
1294 \textit{\rightmark}%
1295 \fi
1296 }%
1297 \fancyhf[cf]{\textit{--- \thepage{} of \lastpage{} ---}}%
1298 \let\headrulewidth\chronosdocheadrulewidth
1299 }
1300 \fancypagestyle{fancyplain}{%
1301 \fancyhf{}%
1302 \fancyhf[lh]{\textit{\leftmark}}%
1303 \fancyhf[rh]{\textit{\rightmark}}%
1304 %^^A \renewcommand*\headrulewidth{0pt}%
1305 \let\headrulewidth\chronosdocheadrulewidth
1306 \fancyhf[cf]{\textit{--- \thepage{} of \lastpage{} ---}}}
1307 \fancypagestyle{plain}{%
1308 \fancyhf{}%
1309 \renewcommand*\headrulewidth{0pt}%
1310 \fancyhf[cf]{\textit{--- \thepage{} of \lastpage{} ---}}}
1311 \fancypagestyle{fancyempty}{%
1312 \fancyhf{}%
1313 \renewcommand*\headrulewidth{0pt}}
1314 \AddToHookNext{begindocument/end}
1315 {%
1316 \let\chronosdocheadrulewidth\headrulewidth
1317 \pagestyle{fancy}%
1318 \thispagestyle{plain}%
1319 }
1320 \setcounter{secnumdepth}{5}
1321 \patchcmd{\sectionmark}{\MakeUppercase}{}{\typeout{sectionmark patched OK!}}{\typeout{sectionmark patch failed!}}
1322 \patchcmd{\HDorg@tableofcontents}{\MakeUppercase}{}{\typeout{sectionmark patched OK!}}{\typeout{sectionmark patch failed!}}
1323 \patchcmd{\HDorg@tableofcontents}{\MakeUppercase\contentsname}{}{\typeout{sectionmark patched OK!}}{\typeout{sectionmark patch failed!}}
1324 %^^A addaswyd o pethau-cfr.sty, cleveref.cfg
1325 \newlist{chronosmethod}{enumerate}{2}
1326 \setlist[chronosmethod,1]{label=\textbf{Method \arabic*:},ref=\arabic*,wide}
1327 \setlist[chronosmethod,2]{label=\textbf{(\alph*)},ref=\thechronosmethodi(\alph*),wide}
1328 \crefname{chronosmethodi}{method}{methods}
1329 \crefname{chronosmethodii}{method}{methods}
1330 %^^A why does floatpag insist on doing this?
1331 \floatpagestyle{fancy}
1332 \rotfloatpagestyle{fancy}
1333 \ExplSyntaxOn
1334 \hook_gput_code:nnn {shipout/lastpage} {.}
1335 {
1336 \property_record:nn {t:lastpage}{abspage,page,pagenum}
1337 }
1338 \cs_new_protected_nopar:Npn \lastpage
1339 {
1340 \property_ref:nn {t:lastpage}{page}
1341 }
1342 \keys_define:nn { chronos / doc }
1343 {
1344 unknown .code:n = {
1345 \cs_if_free:cT { \l_keys_key_str }
1346 {
1347 \tl_gset:cn { \l_keys_key_str } { #1 }
1348 }
1349 },
1350 }
1351 \NewDocumentCommand \chronosdocset { +m }
1352 {
1353 \keys_set:nn { chronos / doc } { #1 }
1354 }
1355 %^^A PAID â defnyddio \pkg yma!!
1356 %^^A neu \let\lpack\textsf neu ...
1357 \hook_gput_code:nnn { begindocument/end } { chronosdoc }
1358 {%^^A
1359 \ExplSyntaxOn
1360 \NewCommandCopy \lpack \textsf
1361 \text_declare_purify_equivalent:Nn \lpack { \use:n }
1362 \pdfstringdefDisableCommands{
1363 \let\lpack\@firstofone
1364 }
1365 \ExplSyntaxOff
1366 }
1367 \ExplSyntaxOff
1368 \chronosdocset{%
1369 bug={\href{https://codeberg.org/cfr/chronos/issues}{\textsc{bugtracker}}},
1370 codeberg={\href{https://codeberg.org/cfr/chronos}{\textsc{codeberg}}},
1371 github={\href{https://github.com/cfr42/chronos}{\textsc{github}}},
1372 ctan={\href{https://ctan.org/}{\textsc{ctan}}},
1373 }
1374 \definecolor{strawberry}{rgb}{1.000,0.000,0.502}
1375 \definecolor{blueberry}{rgb}{0.000,0.000,1.000}
1376 \definecolor{moss}{rgb}{0.000,0.502,0.251}
1377 \def\@xobeysp{\leavevmode\penalty100\ }
1378 \makeatother
1379 \errorcontextlines=10
1380 %^^A END preamble >>>
1381 \begin{document}
1382 %^^A paid â defnyddio'r llinell nesaf - lladdu gwagiau mewn enwau pethau yn \PrintDescribe pan i'r macro wedi cael ei greu gyda \NwwDocElements yn lle \NewDocElement ...
1383 %^^A \let\MakePrivateLetters\MyMakePrivateLetters
1384 \DocInput{\chronosdocfilename}
1385 %^^A\DocInput{\chronosdocbase-code.dtx}
1386 \ifchronoscodetoo
1387 %^^A \def\mybasename#1.#2\nil{#1}%
1388 %^^A \ExpandArgs {e} \DocInput{\expandafter\mybasename\filename.a\nil-code.dtx}
1389 \DocInput{\chronosfilebase-code.dtx}
1390 \fi
1391 \end{document}
1392 %</driver>
1393 % \fi
1394 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1395 % \newgeometry{headheight=12pt,scale=.8,marginparwidth=0pt,marginparsep=0pt}%
1396 % \savegeometry{safonol}%
1397 % \setlength\tewadjust{\marginparwidth+\marginparsep}%
1398 % \fancyheadoffset[lh]{0pt}%^^A REQUIRED - do NOT remove this line!!
1399 % \pagenumbering{arabic}%
1400 % \title{\lpack{\chronosfilebase}}
1401 % \author{Clea F. Rees\thanks{%
1402 % Bug tracker:
1403 % \href{https://codeberg.org/cfr/chronos/issues}{\url{codeberg.org/cfr/chronos/issues}}
1404 % \textbar{} Code:
1405 % \href{https://codeberg.org/cfr/chronos}{\url{codeberg.org/cfr/chronos}}
1406 % \textbar{} Mirror:
1407 % \href{https://github.com/cfr42/chronos}{\url{github.com/cfr42/chronos}}%
1408 % }}
1409 % \date{\chronosfileversion\ (\textsc{svn} \chronosfilerev)}%
1410 %^^A \title{\chronosdocbase}%
1411 % \maketitle
1412 % \bigskip
1413 % \IfFreeT\bce{\let\bce\bceyearlabel}%
1414 % \IfFreeT\ce{\let\ce\ceyearlabel}%
1415 %
1416 % \begin{abstract}
1417 % \noindent \pkgname[link=false]{chronos} is a \LaTeXe{} package, based on \keyname[type=pkg,idx as=PGF,no link]{\PGF{}}/\keyname[type=pkg,idx as=TikZ,no link]{\TikZ{}}, for typesetting timelines or chronologies.
1418 % Externalisation is supported out-of-the-box with \pkg{memoize}.
1419 % The package developed from two sources: first, the creation of a timeline for use in teaching\footnote{See \href{https://tex.stackexchange.com/a/215082/}{this answer on \TeX{} StackExchange} or \href{https://cfrees.files.wordpress.com/2014/10/timeline-orig.pdf}{view the PDF}.} and, second, questions on \href{https://tex.stackexchange.com/}{tex.stackexchange.com} concerning obstacles encountered in using existing packages.
1420 % This package might be considered an attempt to use the former to partially remedy the latter.
1421 % It also means both the code and the user-interface contain strange and tangled regions where the wild errors may grow.
1422 % \end{abstract}
1423 % \bigskip
1424 %
1425 %^^A \iffalse
1426 % \begin{figure}[!b] %^^A <<<
1427 % \edef\tempa{0000/00/00}\edef\tempb{\chronosdocdate}
1428 % \ifx\tempa\tempb\relax
1429 % \else
1430 % \setlength\chronosdoctemplgth{\textwidth}%^^A
1431 % \def\tempa#1/#2/#3\nil{#1}%^^A
1432 % \edef\chronosdocyear{\expandafter\tempa\chronosdocdate\nil}%^^A
1433 % \def\tempa#1/#2/#3\nil{#2}%^^A
1434 % \edef\chronosdocmonth{\expandafter\tempa\chronosdocdate\nil}%^^A
1435 % \def\tempa#1/#2/#3\nil{#3}%^^A
1436 % \edef\chronosdocday{\expandafter\tempa\chronosdocdate\nil}%^^A
1437 % \begin{adjustwidth}{-3em}{-3em}
1438 % \centering
1439 % \hypersetup{urlcolor=chronos current tag colour!75!black}%^^A
1440 % \mmzset{disable}%^^A galluogi hyperlinks
1441 % \begin{chronos}
1442 % [
1443 % blues below,
1444 % timeline={%^^A
1445 % dates={2014-07-01}:{\year-\month-\day},
1446 % width=\chronosdoctemplgth+35pt,
1447 % step major years=1,
1448 % step minor years=0,
1449 % step divisions=4,
1450 % },
1451 % text tags+={align=left,font=\sffamily},
1452 % every text tag connectors+={fill=##1,circle,minimum size=2.5pt,inner sep=0pt,anchor=center},
1453 % every main text tag connectors+={yshift=-\chronosbaselineskip},
1454 % levels=0:11,
1455 % tag right/.chronos key maker={tag right}{style 2 args}{%^^A
1456 % at/.expand once=level -##1.south -| ##2,
1457 % tag anchor=north west,
1458 % anchor=south west,
1459 % xshift=5pt,
1460 % connectors=east,
1461 % },
1462 % tag left/.chronos key maker={tag left}{style 2 args}{%^^A
1463 % at/.expand once=level -##1.south -| ##2,
1464 % tag anchor=north east,
1465 % anchor=south east,
1466 % xshift=-5pt,
1467 % text tag+={align=right},
1468 % },
1469 % tag post/.chronos key maker={tag post}{style}{%^^A
1470 % at=level -##1.south -| chronos end,
1471 % tag anchor=north west,
1472 % anchor=south east,
1473 % connect=false,
1474 % connectors=east,
1475 % },
1476 % without eras,
1477 % event/full dates,
1478 % ]
1479 % \chronosevent{%^^A
1480 % date={2014-07-13},
1481 % name=wphilcommit,
1482 % name content={Begin Philosophy Timeline},
1483 % tag right={11}{wphilcommit},
1484 % }
1485 % \chronosperiod{%^^A
1486 % dates={2014-07-13}:{2014-11-16},
1487 % name=wphildev,
1488 % name content={Western Philosophy Timeline Development},
1489 % tag right={10}{wphildev},
1490 % }
1491 % \chronosevent{%^^A
1492 % tag right={9}{wphil},
1493 % date={2014-11-16},
1494 % name=wphil,
1495 % name content={\href{https://cfrees.files.wordpress.com/2014/10/timeline-orig.pdf}{Western Philosophy} \href{https://cfrees.files.wordpress.com/2014/10/timeline-orig.pdf}{Timeline} Finalised: \texseans*{215082}},
1496 % }
1497 % \chronosevent{
1498 % date={2016-03-26},
1499 % name=first,
1500 % name content={Not-\pkgname[no link]{chronosys}: \texseans*{300910}},
1501 % tag right={8}{first}
1502 % }
1503 % \chronosevent{
1504 % date={2016-06-02},
1505 % name=second,
1506 % name content={Second not-\pkgname[no link,no idx]{chronosys}: \texseans*{312735}},
1507 % tag right={7}{second},
1508 % }
1509 % \chronosevent{
1510 % date={2016-08-10},
1511 % name=siml,
1512 % name content={\keyname[type=chronosstyle,idx post=development]{off line simple}: \texseans*{324106}},
1513 % tag right={6}{siml},
1514 % }
1515 % \chronosevent{
1516 % name content={\keyname[type=chronosstyle,idx post=development]{date centric}: \texseans*{324448}},
1517 % date={2016-08-12},
1518 % name=dcentric,
1519 % tag right={5}{dcentric},
1520 % }
1521 % \chronosevent{
1522 % name content={\keyname[type=chronosstyle,idx post=development]{lines on line}: \texseans*{324453}},
1523 % name=lol,
1524 % date={2016-08-12},
1525 % tag right={4}{lol},
1526 % }
1527 % \chronosevent{
1528 % date={2016-08-12},
1529 % name=dformats,
1530 % name content={Date Formats: \texseans*{324454}},
1531 % tag right={3}{dformats},
1532 % }
1533 % \chronosevent{
1534 % date={2016-08-15},
1535 % name=zero,
1536 % name content={No Year Zero: \texseans*{324857}},
1537 % tag right={2}{zero},
1538 % }
1539 % \chronosevent{
1540 % date={2016-08-21},
1541 % name=split,
1542 % name content={\keyname[type=chronosstyle,idx post=development]{event splitter}: \texseans*{325890}},
1543 % tag post=10,
1544 % }
1545 % \chronosevent{
1546 % date={2016-12-06},
1547 % name=dformats2,
1548 % name content={Date Formats: \texseans*{342699}},
1549 % tag post=9,
1550 % xshift=-5pt,
1551 % }
1552 % \chronosevent{
1553 % date={2016-12-16},
1554 % name=noeth,
1555 % name content={Bare Marks: \texseans*{349236}},
1556 % tag anchor=north west,
1557 % at=text tag dformats2.west |- i8.south,
1558 % anchor=south west,
1559 % connect=false,
1560 % connectors=east,
1561 % xshift=5pt,
1562 % }
1563 % \chronosevent{
1564 % date={2016-12-26},
1565 % name=hol,
1566 % name content={\keyname[type=cls,no link]{\cls{happyholidays.cls}}:\\\texseans*{345673}\\\texseans*{345674}},
1567 % tag anchor=north west,
1568 % at=text tag dformats2.west |- i7.south,
1569 % anchor=south west,
1570 % connect=false,
1571 % connectors=east,
1572 % xshift=10pt,
1573 % }
1574 % \foreach \i/\j/\k in {split/27.5pt/5pt,dformats2/32.5pt/10pt,noeth/37.5pt/15pt,hol/42.5pt/20pt}
1575 % {
1576 % \coordinate (a) at ([xshift=\j]chronos year 2020);
1577 % \coordinate (b) at ([yshift=\k]level -1.south);
1578 % \draw [chronos connect=event:\i] (chronos connector \i) |- (b -| a) |- (text tag connector \i);
1579 % }
1580 % \chronosevent{
1581 % date={{\chronosdocyear}-{\chronosdocmonth}-{\chronosdocday}},
1582 % name content={First CTAN Release},
1583 % name=ctan,
1584 % tag left={1}{ctan},
1585 % font=\sffamily\bfseries,
1586 % connectors={west,south},
1587 % }
1588 % \draw [chronos connect=event:hol] (connector hol1) -| ([xshift=5pt,yshift=5pt]tag hol.north east) coordinate (g) -| ([xshift=-5pt]tag hol.west |- connector ctan1.90) coordinate [midway] (h) -- (connector ctan1);
1589 % \foreach \i/\j/\n in {%^^A
1590 % noeth/5pt/112,%^^A
1591 % dformats2/5pt/135,
1592 % split/2.5pt/157%^^A
1593 % } {%^^A
1594 % \draw [chronos connect=event:\i] (connector \i1) -- ++(\j,0pt) |- ([xshift=2.5pt,yshift=2.5pt]h) coordinate [midway] (g) coordinate (h) -- (h |- connector ctan1.\n) -- (connector ctan1);
1595 % }
1596 % \foreach \i/\j/\k/\l/\m in {%^^A
1597 % zero/20pt/5pt/5pt/180,%^^A
1598 % dformats/18pt/7.5pt/7pt/202,
1599 % lol/16pt/10pt/9pt/225,
1600 % dcentric/14pt/12.5pt/11pt/247,
1601 % siml/12pt/15pt/13pt/270%^^A
1602 % }
1603 % {
1604 % \coordinate (a) at ([xshift=\j]chronos year 2020);
1605 % \coordinate (b) at ([yshift=-\k]level -11.north);
1606 % \coordinate (c) at ([xshift=\l]chronos end);
1607 % \draw [chronos connect=event:\i] (connector \i1) -| (a |- b) -| ([yshift=2.5pt]h -| c) -- ([xshift=2.5pt,yshift=2.5pt]h) coordinate (h) -- (h |- connector ctan1.\m) -- (connector ctan1);
1608 % }
1609 % \foreach \i/\j/\k/\l in {%^^A
1610 % second/10pt/17.5pt/west,
1611 % first/8pt/20pt/south west,
1612 % wphil/6pt/22.5pt/south,
1613 % wphildev/4pt/25pt/south east,
1614 % wphilcommit/2pt/27.5pt/east%^^A
1615 % }
1616 % {
1617 % \coordinate (a) at ([xshift=\j]chronos year 2020);
1618 % \coordinate (b) at ([yshift=-\k]level -11.north);
1619 % \draw [chronos connect=event:\i] (connector \i1) -| (a |- b) -| ([yshift=2.5pt,xshift=2pt]c |- h) coordinate (c) coordinate (h) -- (h -| connector ctan2.\l) -- (connector ctan2);
1620 % }
1621 % \coordinate (a) at ($(first)!.5!(wphil)$);
1622 % \chronosmaintitle{%^^A
1623 % name=chronos main title,
1624 % name content=C\\H\\R\\O\\N\\O\\S,
1625 % at=a |- i1,
1626 % anchor=north,
1627 % font=\LARGE\bfseries,
1628 % draw=chronos timeline foreground colour,
1629 % double=chronos timeline background colour,
1630 % }
1631 % \chronoscopyright{%^^A
1632 % at=current bounding box.south west,
1633 % tag anchor=north west,
1634 % }
1635 % \end{chronos}
1636 % \caption{\Pkg{chronos} development: a \pkg{chronos} \conceptname{timeline} (\cref{sec:anatomy,subsec:llinell-amser}) with \chronosstylelabelname{} \keyname[type=chronosstyle,no link,idx post=example of]{blues below} (\cref{subsubsec:chronos-styles-off-line}) and custom \styleslabelname{} \keyname[type=style,no link,idx pre=custom,symbol=eg]{tag left,tag post,tag right} (\cref{subsec:element-style-creation}).}\label{fig:chronos-dev}
1637 % \end{adjustwidth}
1638 % \fi
1639 % \end{figure}%^^A >>>
1640 %^^A \fi
1641 % \clearpage
1642 %
1643 % \tableofcontents
1644 %
1645 % \section{Raison d'être}\label{sec:raisondetre}
1646 %^^A BEGIN raisondetre
1647 %
1648 % \Pkg{chronos} aims to make it easy
1649 % \begin{itemize}
1650 % \item to specify \conceptname[idx as=timeline,idx post=types drawn by \string\pkg{chronos}]{timelines} covering from days to centuries;
1651 % \item to customise a \conceptname[no idx]{timeline}'s appearance using the standard key-value syntax familiar to users of \TikZ{};
1652 % \item to define new \conceptname[no idx]{timeline} styles in a straightforward manner;
1653 % \item to utilise a range of \conceptname[no idx]{timeline} styles provided out-of-the-box, including some based on those offered by other packages and/or featured on \url{tex.stackexchange.com}.
1654 % \end{itemize}
1655 %
1656 %^^A END sec:raisondetre
1657 %^^A \clearpage
1658 %
1659 % \section{Caveats, Assumptions \& Limitations}\label{sec:ass}
1660 %^^A BEGIN sec:ass
1661 %
1662 % \subparagraph*{First,} the caveats \dots{}
1663 %
1664 % \Pkg{chronos} is \emph{experimental}.
1665 % Future releases will not make significant backwards-incompatible changes to documented features of the user interface without good reason.
1666 % If such changes are made, a compatibility option will be offered, unless there is extremely good reason not to do so.
1667 % \emph{This applies \emph{only} to documented features.
1668 % It applies to \emph{neither} undocumented features \emph{nor} the implementation details of those documented.}
1669 %
1670 % \Pkg{chronos} makes some use of undocumented internal \pgf{}/\TikZ{} commands.
1671 %
1672 % \Pkg{chronos} uses \pkg{etoolbox} to patch certain internal \pgf{}/\TikZ{} commands.
1673 % While some of these changes, such as modifications to \texttt{rectangle}\texsethanks{Symbol 1}{385953} are applied only locally, others, including changes to the \enviro{tikzpicture} initialisation code\texsethanks[for this]{Martin Scharrer}{56405}, are made globally.
1674 %
1675 % \Pkg{chronos} has known incompatibilities with certain standard \pgf{}/\TikZ{} libraries (\cref{sec:compat}).
1676 %
1677 % \Pkg{chronos} has unknown incompatibilities with other standard and non-standard \pgf{}/\TikZ{} libraries and packages.
1678 % These will be documented when discovered.
1679 %
1680 % \Pkg{chronos} differs substantially from code previously published as \pkg{chronos} on \href{https://tex.stackexchange.com}{\TeX{} StackExchange}.
1681 % In particular, the user interface has changed: \pkg{chronos} now uses a key-value interface rather than multiple arguments when adding things to the \conceptname[no idx]{timeline} and the \conceptname[idx post=construction]{timeline} itself is now created by the environment \keyname[type=env,link,idx post=cf.~code posted on \string\TeX ~SE]{chronos}\footnote{Early versions on \TeX{} SE actually used an \envlabelname{}, so this difference applies only to some \pkg{chronos}-based answers there.}.
1682 % See \cref{subsec:compat-texse} for guidance on converting existing \conceptname[idx as=timeline,no idx]{timelines}.
1683 %
1684 % \textbf{\textui{Caveat emptor \dots{}}}
1685 %
1686 %
1687 % \subparagraph*{Second,} (some of) the assumptions \dots{}
1688 %
1689 % Within the \enviro{chronos} \envlabelname{}, \pkg{chronos} assumes control over \pgf{}/\TikZ{} \conceptname[type=layer,idx as=control over,font=\normalfont]{layers}, disregarding any configuration setup by the user or other packages (\cref{subsec:haenau}).
1690 % This means you cannot use additional, custom \conceptname[type=layer,idx as=layer,no idx]{layers} in \enviro{chronos} environments unless you integrate them appropriately with \pkg{chronos}'s changes.
1691 % These changes are made locally and do not affect the use of whatever \conceptname[type=layer,idx as=layer,no idx]{layers} you please in a non-\pkg{chronos} environment, such as a regular \enviro{tikzpicture}.
1692 %
1693 % \textbf{\textui{Caveat emptor \dots{}}}
1694 %
1695 % \subparagraph*{Third,} (some of) the limitations \dots{}
1696 %
1697 % The most serious limitation, given \pkg{chronos}'s aims (\cref{sec:raisondetre}), is that you cannot define \styleslabelname{} involving \pkg{chronos} \keyslabelname{} using the standard \pgf{}/\TikZ{} interface, if you want to use them to configure individual additional \elementslabelname{} (\cref{sec:anatomy,sec:macros-add-elements}).
1698 % Moreover, the alternative mechanism provided has serious shortcomings (\cref{subsec:element-style-creation}).
1699 %
1700 % \Pkg{chronos} cannot produce \conceptname[idx as=timeline,idx post=limitations of \string\pkg{chronos}]{timelines} covering hundreds of thousands of years or which need to distinguish temporal units less than a day.
1701 % It does days, months, years and centuries; it does not do (many) millennia, hours, minutes or seconds.
1702 %
1703 % In particular, \pkg{chronos} is not designed to deal with dates outside the current Julian period.
1704 % In theory, this means any date from 24\textsuperscript{th} November, 4714\,\bce{} should be permissible, but in fact, 24\textsuperscript{th} November, 4713\,\bce{} is the first date for which the package's behaviour should be relatively well-defined\footnote{%^^A
1705 % \pkg{pgfcalendar} says it uses the Wikipedia method, but appears to return dates 1 year later than some Wikipedia specifies e.g.~day 0 gives a date in 4713 exactly a year after Wikipedia's one in 4714.
1706 % But Wikipedia itself seems inconsistent, sometimes suggesting a date in 4713 and sometimes the previous year.
1707 % For current purposes, the right answer doesn't matter: what matters is that \pkg{pgfcalendar}'s answer is consistent.
1708 % This means quibbles about the start date are unimportant (unless you're drawing a \conceptname[no idx]{timeline} starting with Winter Solstice 4714\,\bce{}, of course.
1709 % If you are, you might want to look into the matter.)}.
1710 % Matters are a little different when it comes to dates in the \emph{next} Julian period.
1711 % The cut off date for these is sometime in 3268\,\ce{}, according to Wikipedia, but \pkg{pgfcalendar} appears to be unaware of this.
1712 % This means you may be able to get away with later dates, even though they are officially beyond the scope of this package\footnote{That is, it may work, but it isn't a bug if it doesn't.}.
1713 %
1714 % \Pkg{chronos} draws horizontal \conceptname[idx as=timeline,idx post=chronos\string\textnormal{ draws horizontal},idx font post=\KeyFont]{timelines}.
1715 % It does not support alternative orientations.
1716 % In particular, vertical \conceptname[idx as=timeline,idx post=chronos\string\textnormal{ does not draw vertical},idx font post=\KeyFont]{timelines} are not currently supported.
1717 %
1718 % \textbf{\textui{Caveat emptor \dots{}}}
1719 %
1720 % \subparagraph*{Finally,} the code lacks both the virtues of sophistication and simplicity, while the user interface is characterised by confusion and complexity, the documentation is spotted with lacunae and unclarities, and the index is a conglomeration of misdirection and bull shit\footnote{In what sense ‘bull shit’? Take your pick from any of several technical philosophical senses.}.
1721 %
1722 % \textbf{\textui{Caveat emptor \dots{}}}
1723 %
1724 %^^A END sec:ass
1725 %
1726 %
1727 % \section{Typesetting a Timeline}\label{sec:ee}
1728 %^^A BEGIN sec:ee
1729 %
1730 % Further details concerning loading and invocation are explained in \cref{sec:llwytho,sec:invoke}.
1731 % The overall structure \pkg{chronos} provides is outlined in \cref{sec:anatomy,subsec:haenau}.
1732 % \Cref{sec:schemes-styles} covers simple customisation using \conceptname[idx as={colour scheme,chronos style},no idx]{\colschemeslabelname,\chronosstyleslabelname}.
1733 % Detailed configuration of the \conceptname[idx pre={documentation}]{timeline} is explained in \cref{sec:config}.
1734 % \Cref{sec:macros-add-elements} covers the addition of \conceptname[idx as=element,type=concept,no idx]{\elementslabelname} such as \conceptname[idx as={life,event,period,theory,info,main title},no idx]{lives,events,periods,theories,info boxes,titles} to \conceptname[idx as=timeline,no idx]{timelines}.
1735 % In this \namecref{sec:ee}, we begin by looking at a simple example.
1736 %
1737 % After loading \pkgname[no link,idx post=typesetting a \string\textconcept{timeline}\string\idxeg]{chronos} in the document preamble:
1738 % \begin{chronoscode}[chronos]
1739 % % in document's preamble
1740 % \usepackage{chronos}
1741 % \end{chronoscode}
1742 % the \keyname[type=env,idx post=introduction to]{chronos} \envlabelname{} is available for typesetting \conceptname[idx as=timeline,no idx]{timelines}.
1743 % \begin{chronoscode}[chronos]
1744 % \begin{chronos}
1745 % []
1746 % \end{chronos}
1747 % \end{chronoscode}
1748 % This takes an optional argument used to configure the \conceptname[link,idx post=introduction to]{timeline}.
1749 % This determines the size, appearance and duration of the \conceptname[no idx,link]{timeline}, as well as the use of \conceptname[link,idx post=introduction to]{headings,subheadings,frame}.
1750 % The body of the \envlabelname{} should consist of material to be added to the \conceptname[no idx,link]{timeline} itself, typically using \pkg{chronos}'s commands for adding \conceptname[conj=and/or,idx as={life,event,period,theory,theory circle,info,main title},idx post=introduction to]{lives,events,periods,theories,theory circles,info boxes,main titles}.
1751 % It is also possible to include arbitrary \TikZ{} code in the body of the \envlabelname{}, but commands need to be added to the appropriate \pkg{chronos} \conceptname[type=layer,idx as={adding to appropriate},font=\normalfont]{layer} if they are to have their intended effects.
1752 %
1753 %
1754 % Suppose that we wish to typeset a \conceptname[idx post=history of writing and printing\string\idxeg,link]{timeline} illustrating developments in the history of writing and printing.
1755 % Having done exhaustive research utilising a single Wikipedia page, we decide our \conceptname[no idx,link]{timeline} should begin around 3,100\bceyearlabel{} and end in the present.
1756 % We're going to use the \chronosstylelabelname{} \keyname[type=chronosstyle,idx post=in example \string\textconcept{timeline}\string\idxeg]{cronoleg}, which puts year markers on the \conceptname[link,no idx]{timeline} itself.
1757 % We decide we'd like large markers every 500 years and a smaller marker halfway between each pair of larger ones.
1758 % We might, therefore, try
1759 % \changes{v0.9.4}{2025-08-14}{Update key names in example.}
1760 % \begin{chronoscode}
1761 % \begin{chronos}
1762 % [
1763 % cronoleg,% load chronos style
1764 % timeline={% configure the timeline 'line' itself
1765 % start date={-3100},
1766 % end date=2100,
1767 % step minor year=250,
1768 % step major year=500,
1769 % },
1770 % levels=10:10,
1771 % ]
1772 % \end{chronoscode}
1773 % This will result in ‘major’ markers (\conceptname[link,idx post=in example \string\textconcept{timeline}\string\idxeg]{marks,years}) at 3,000\bceyearlabel{}, 2,500 \bceyearlabel{} etc.\ and ‘minor’ at 2,750\bceyearlabel{}, 2,250\bceyearlabel{} and so on.
1774 % Note that \pkg{chronos} starts the \conceptname[no idx,link]{timeline} at 3,100\bceyearlabel{}, but assumes we'd like the first marker at 3,000\bceyearlabel{}.
1775 % \texttt{levels=10:10} will create a series of invisible nodes above and below the \conceptname[no idx,link]{timeline} named \texttt{level 1},\dots{},\texttt{level 10} and \texttt{level -1},\dots{},\texttt{level -10} respectively.
1776 % The nodes are constructed so they take the same space as a ‘standard’ \conceptname[link,idx as=\meta{tag}/text tag,link,idx post=in \string\textconcept{timeline}\string\idxeg]{text tag} of ‘\taglabelname{}’ type \conceptname[type=tag,idx post=as basis for \string\textconcept{levels}]{life} created with \keyname[type=macro,idx post=in example \string\textconcept{timeline}\string\idxeg]{\cs{chronoslife}}.
1777 % We can refer to these nodes when placing items to facilitate stacking, spacing and packing.
1778 %
1779 % Based on our exhaustive seconds-long research, we now want to add some items of interest onto our \conceptname[no idx,link]{timeline}.
1780 % We decide we'd like to note the lives of significant figures in the development of contemporary typography, most notably Donald Knuth, as well as a few luminaries from the modern era\footnote{%^^A
1781 % In my discipline, ‘modern’ means roughly the sixteenth to nineteenth centuries.}.
1782 % We'd also like to note certain specific events, such as key publication dates, and processes of longer duration.
1783 % \begin{chronoscode}
1784 % \chronosevent{%
1785 % name=\emph{jikji},
1786 % date=1377
1787 % }
1788 % \end{chronoscode}
1789 % This will create an \conceptname[type=tag,link,idx font post=\itshape,idx post=Jikji\string\idxeg]{event} in the default style in the default location, just off the \conceptname[no idx,link]{timeline}.
1790 % Note that the text displayed in the \conceptname[type=tag,link,no idx]{event}'s node is ‘\emph{Jikji}’.
1791 % The coordinate \texttt{jikji} is placed at the point the \conceptname[link,type=concept,idx post=placement of coordinate \string\textkey{jikji}\string\idxeg]{element} is added on the border of the \conceptname[no idx]{timeline}.
1792 % The circular \conceptname[link,idx post=chronos connector jikji\string\idxeg,idx font post=\KeyFont]{connector} created at this point is the node \texttt{chronos connector jikji}.
1793 % The circular \conceptname[link,no idx]{connector} on the \conceptname[type=tag,no idx,link]{event}'s \conceptname[link,idx pre=event,idx font pre=\ConceptFont,link to=event/text tag,symbol=eg]{text tag} is the node \texttt{main connector jikji}.
1794 % The \conceptname[link,link to=event/text tag,idx pre=event,idx font pre=\ConceptFont,no idx]{text tag} itself is the node \texttt{tag jikji}.
1795 % As it stands, we may not be able to actually see all these \elementslabelname{} if the \conceptname[link,no idx]{event}'s \conceptname[link,link to=event/text tag,no idx]{text tag} is placed right on the border of the \conceptname[no idx,link]{timeline}.
1796 % If \keyname[link,idx=false,type=dimkey]{text tag yshift} is non-zero, \pkg{chronos} will shift the node but, in general, it is necessary to tell \pkg{chronos} where to place the \conceptname[no idx,link,link to=event/text tag]{text tag}.
1797 % This doesn't affect the placement of the \conceptname[type=tag,no idx,link]{event} on the \conceptname[no idx,link]{timeline} itself.
1798 % \begin{chronoscode}
1799 % \chronosevent{%
1800 % name=\emph{jikji},
1801 % date=1377,
1802 % yshift=20pt,
1803 % }
1804 % \end{chronoscode}
1805 % This will place the \conceptname[link,link to=event/text tag,idx pre=event,idx font pre=\ConceptFont,no idx]{text tag} node due north of the circular \conceptname[link,no idx]{connector} on the \conceptname[link,idx post=placement of \string\textkey{jikji}'s \string\textconcept{connector} relative to\string\idxeg]{timeline} with a straight line connecting the circular \conceptname[idx post=main connector jikji\string\idxeg,idx font post=\KeyFont,link]{connector} nodes \texttt{main connector jikji} and \texttt{chronos connector jikji}.
1806 % However, we might also want to shift the \conceptname[link,link to=event/text tag,no idx]{text tag} node horizontally and have the connection drawn to the west or east of the \conceptname[no idx,link,link to=event/text tag]{text tag}.
1807 % \begin{chronoscode}
1808 % \chronosevent{%
1809 % name=\emph{jikji},
1810 % date=1377,
1811 % yshift=20pt,
1812 % xshift=-5pt,
1813 % anchor=east,
1814 % }
1815 % \end{chronoscode}
1816 % will shift the \conceptname[no idx,link,link to=event/text tag]{text tag} \texttt{5pt} to the left and draw the \conceptname[link,idx post=up and left in \string\textkey{jikji}\string\idxeg]{connection} up and left from the \conceptname[no idx,link]{timeline} to \texttt{main connector jikji} which is now drawn \texttt{east} rather than the default \texttt{south}.
1817 %
1818 % We decide to place a second \conceptname[type=tag,link,idx font post=\itshape,idx post=Diamond Sutra\string\idxeg]{event}, for which we have a precise date.
1819 % This time, we use \keyname[link,idx=false,type=boolkey]{as is} to tell \pkg{chronos} not to attempt to capitalise the text.
1820 % This is necessary because we have an \cs{emph}\texttt{\{}\meta{word} \meta{word}\texttt{\}} and \pkg{chronos}'s capitalisation command can't cope with this.
1821 % This also means we need to add appropriate capitalisation ourselves.
1822 % \begin{chronoscode}[as,is]
1823 % \chronosevent{%
1824 % date={868-05-11},
1825 % name={Publication of \emph{Diamond Sutra}},
1826 % yshift=-40pt,
1827 % xshift=20pt,
1828 % anchor=west,
1829 % as is,
1830 % connectors={east,south},
1831 % }
1832 % \end{chronoscode}
1833 % Note that this \conceptname[idx post=Publication of \string\emph{Diamond Sutra}\string\idxeg,link,type=tag]{event} is placed below the \conceptname[link,idx post=placement of \string\textconcept{event}\string\idxeg]{timeline}.
1834 %
1835 % We decide to add some notable figures next.
1836 % For this, we create \elementslabelname{} of \taglabelname{} type \conceptname[type=tag,idx post=Bi Sheng\string\idxeg]{life}, beginning with the inventor of movable type, Bi Sheng.
1837 % \begin{chronoscode}[at]
1838 % \chronoslife{%
1839 % name=bi sheng,
1840 % birth=972,
1841 % death=1051,
1842 % at=tag jikji.north -| bi sheng,
1843 % connectors={east,north},
1844 % }
1845 % \end{chronoscode}
1846 % Note the use of \keyname[idx=false,link]{at} to place the \conceptname[no idx,type=key,link,link to=event/text tag]{text tag} detailing the name and dates.
1847 % Since this node is placed above the \conceptname[link,idx post=placement of \string\textkey{bi sheng}\string\idxeg]{timeline}, its anchor is \texttt{south} by default.
1848 % \verb+at=tag jikji.north -| bi sheng+ aligns this anchor directly above the relevant point on the \conceptname[no idx,link]{timeline} (\texttt{bi sheng}) and just on top of \texttt{tag jikji}.
1849 % If you want to fit many items onto your \conceptname[no idx,link]{timeline}, fitting them closely together is useful but you could, of course, lift the box higher if you want a bit more space.
1850 %
1851 % Leaping ahead, we now want to add Donald Knuth\chronosdocidx[type=tag,font=\ConceptFont,idx post=Donald Knuth\string\idxeg]{life}.
1852 % \begin{chronoscode}
1853 % \chronoslife{%
1854 % name=donald knuth,
1855 % birth={1938-01-10},
1856 % text tag yshift=40pt,
1857 % connectors={west,north},
1858 % }
1859 % \end{chronoscode}
1860 % Note the omission of \keyname[type=datekey,idx post=omission for living]{death} for a living person.
1861 % \Pkg{chronos} assigns today's date internally for placement purposes, but will not typeset it when constructing the \conceptname[link,link to=life/text tag,idx pre=life,idx font pre=\ConceptFont]{text tag}\footnote{\pkg{chronos} is not the most optimistic of packages.}
1862 % This works reasonably, but the \conceptname[idx post=crossing nodes]{connection} from the \conceptname[link,idx post=Donald Knuth\string\idxeg]{timeline} crosses the text node for the publication of the \emph{Diamond Sutra} because \pkg{chronos} has placed this item below the \conceptname[no idx,link]{timeline}, even though there is plenty of space above.
1863 % This is because, by default, \pkg{chronos} alternates between placement above and below the line.
1864 % In this case, we decide to override the default choice.
1865 % \begin{chronoscode}[place,above]
1866 % \chronoslife{%
1867 % name=donald knuth,
1868 % birth={1938-01-10},
1869 % text tag yshift=40pt,
1870 % connectors={west,north},
1871 % place above,
1872 % }
1873 % \end{chronoscode}
1874 % Note that the \keyname[type=chronosstyle,idx post=colour rotation,idx font post=\ConceptFont]{cronoleg} rotates the colours used for \elementslabelname{} belonging to \taglabelname{} types \conceptname[type=tag,no idx,link]{life,event,period}, but not \conceptname[type=tag,idx post=cronoleg,idx font post=\KeyFont]{theory}, but \collistslabelname{} are rather subdued for \conceptname[type=tag,idx as={event,period},no idx]{events,periods}.
1875 % For each type of \elementslabelname{}, one set of colours is used below and another above the \conceptname[no idx,link]{timeline}.
1876 % These colours can be accessed later as \texttt{colour }\meta{name}\footnote{%^^A
1877 % In most cases, you can also access items using American spelling.
1878 % So \texttt{color} would work here.
1879 % So would \texttt{lliw}.}.
1880 %
1881 % \Conceptname[type=concept,link,idx post=Donald Knuth\string\idxeg]{colour rotation} can be switched on or off for particular kinds of \elementslabelname{}, overridden for individual \elementslabelname{} and configured by altering the \collistslabelname{} \pkg{chronos} cycles through.
1882 % These colours are tracked by copying them to new names for each \elementlabelname{} created and may be accessed using these names later.
1883 % This means you can draw something in the colour assigned to Donald Knuth, say, without knowing which colour that is.
1884 % If you add an \elementlabelname{} to the \conceptname[link,no idx]{timeline} or change the \collistslabelname{} later, the drawing will use the appropriate colour.
1885 % For example,
1886 % \begin{chronoscode}[colour,donald,knuth,tag]
1887 % \node (pi) [colour donald knuth, font=\Huge, right=5pt of tag donald knuth.base east, anchor=base west] {$\pi$};
1888 % \end{chronoscode}
1889 % will add a large $\pi$ in the colour (automatically or otherwise) assigned to Knuth.
1890 % \begin{chronoscode}[colour,tag,donald,knuth]
1891 % \draw [colour donald knuth] (tag donald knuth.north) ++(0pt,20pt) circle (10pt);
1892 % \end{chronoscode}
1893 % would draw a circle above Donald Knuth's \conceptname[link,idx post=Donald Knuth\string\idxeg]{text tag} in the colour automatically assigned to Donald Knuth.
1894 %
1895 % We next decide to indicate the \conceptname[type=tag,idx post=Woodblock Printing\string\idxeg]{period} when woodblock printing was used to produce books.
1896 % This is a \emph{circa} date, so we can't use \pkg{chronos}'s automatic production of the date information, though we still need to specify dates for placement on the \conceptname[link,no idx]{timeline}.
1897 % We'd still like \pkg{chronos} to format the name of the \conceptname[link,link to=period/text tag,idx as=period/text tag]{text tag}, though, so we use \keyname[link,link to=period/dates content,idx as=period/dates content]{dates content} to override the automatic production of date labels.
1898 % \begin{chronoscode}[dates,content]
1899 % \chronosperiod{%
1900 % name=woodblock printing,
1901 % start=600,
1902 % end=1450,
1903 % yshift=-20pt,
1904 % xshift=10pt,
1905 % anchor=west,
1906 % dates content={c600--1450\ceyearlabel},
1907 % place below,
1908 % }
1909 % \end{chronoscode}
1910 % If we wanted to override the formatting of the name rather than the dates, we could use\chronosdocidx[type=tag,font=\ConceptFont,idx post=WoOdBlOcK pRiNtInG\string\idxeg]{period}
1911 % \begin{chronoscode}[name,content]
1912 % name=woodblock printing,
1913 % name content={WoOdBlOcK pRiNtInG},
1914 % \end{chronoscode}
1915 % If we wanted something completely different in place of the name and date information, we could instead use
1916 % \begin{chronoscode}[text,content]
1917 % text content={something entirely different\\--- not even about woodblocks!},
1918 % \end{chronoscode}
1919 %
1920 % \bceyearlabel{} dates require special consideration.
1921 % In general, a minus\chronosdocindex{- (minus)\actualchar\texttt{-} (minus)} indicates \bceyearlabel{}, but \pkg{chronos} needs to be able to distinguish this from the hyphen between years and months or months and days in standard date specifications (\cref{subsec:dyddiadau}).
1922 % This means either providing a full date of the form \texttt{{-YYYY}-MM-DD}, for example, or ensuring \pkg{chronos} expects only a partial date such as a year.
1923 % \begin{chronoscode}[-3100,-2700]
1924 % \chronosperiod{%
1925 % name=proto-Elamite use of cylinder seals,
1926 % start={{-3100}-01-01},
1927 % end={{-2700}-12-31},
1928 % dates content={c3000\,\bceyearlabel},
1929 % yshift=20pt,
1930 % connectors=north,
1931 % connectors=east,
1932 % }
1933 % \end{chronoscode}
1934 % Here, we protect the \bceyearlabel{} year with curly brackets, specify a default month and day.
1935 % If we specified only a year, \pkg{chronos} would assign a month and day; if we assigned only a year and month, \pkg{chronos} would assign a day.
1936 % (The outer set of curly brackets is standard and cannot be omitted for full date specifications, regardless of era.)
1937 %
1938 % We've now added examples of each of the three basic types \pkg{chronos} supports connecting to our \conceptname[link,idx post=complementary \string\textconcept{elements}\string\idxeg]{timeline}.
1939 % However, the package also offers some complementary \elementslabelname{}.
1940 % These are not connected to the \conceptname[no idx,link]{timeline}, though \conceptname[type=tag,idx as=theory,link,link to=theory,idx post=\string\TeX{}\string\idxeg]{theories} are designed to be connected to the types which are.
1941 % \begin{chronoscode}
1942 % \chronostheory {%
1943 % name=TeX,
1944 % text content=\TeX,
1945 % at=donald knuth-text.north west,
1946 % xshift=-10pt,
1947 % anchor=south east,
1948 % connectors={east},
1949 % }
1950 % \end{chronoscode}
1951 % We also want to indicate Knuth's connection with \TeX{}, so we join the \conceptname[idx post=created for Knuth\string\idxeg]{connector} we made when creating the \conceptname[link,link to=life/text tag,idx pre=life,idx font pre=\ConceptFont]{text tag} for Knuth to the \conceptname[idx post=connecting Knuth and \string\TeX\string\idxeg]{connector} we've just created for \TeX{}.
1952 % \Pkg{chronos} supports the addition of such \conceptname[idx as=connector,link,link to=connector,idx post=\string\pkg{chronos} support for]{connectors} on most \conceptname[link,link to=text tag,idx as=text tag,idx post=addition of \string\textconcept{connectors} in Donald Knuth\string\idxeg]{text tags} created with its commands and the drawing of \conceptname[idx as=connection,idx post=\string\pkg{chronos} support for]{connections} between \conceptname[idx as=connector,no idx,link,link to=connector,idx post=as supporting \string\textconcept{connections}]{connectors}.
1953 % \begin{chronoscode}[chronos,life,connect]
1954 % \draw [chronos connect=life:donald knuth] (connector donald knuth) -- ++(-5pt,0pt) |- (connector TeX);
1955 % \end{chronoscode}
1956 % This makes it possible to connect multiple people to the same \conceptname[link,type=tag,idx post=connecting multiple people to]{theory}, for example, as well as connecting a single person to multiple \conceptname[idx as=theory,idx post=connecting individual to multiple]{theories}.
1957 % In a more complete chronology, several different font designers or book publishers, for example, might be connected with a particular approach to typography.
1958 % \Elementslabelname{} which support \conceptname[idx as=connector,link,link to=connector,idx post=elements \string\textnormal{which support},idx font post=\ConceptFont]{connectors} out-of-the-box are those belonging to \conceptname[type=concept,idx as=tag,link,link to=tag,idx post=support for \string\textconcept{connectors}]{tags} of types \conceptname[type=tag,link,idx post=as supporting \string\textconcept{connectors}]{life,event,period,theory}.
1959 %
1960 % When \keyname[link,idx=false,type=chronosstyle,idx post=style of \string\textconcept{connectors}]{cronoleg} is used, \conceptname[idx as=connector,link,link to=connector,idx post=style in \textkey{cronoleg}]{connectors} are small circular nodes on the \conceptname[link,no idx]{timeline}'s \conceptname[link]{border} and the borders of \conceptname[idx as=text tag,link,link to=text tag,idx post=purpose]{text tags} i.e.~the nodes containing information about the \pkg{chronos} \elementslabelname{} presented in the chronology illustrated.
1961 %
1962 % In contrast, \conceptname[type=tag,idx as=theory circle,link,link to=theory circle,idx post=as lacking \string\textconcept{connectors}]{theory circles}, \conceptname[type=tag,link,idx post=as lacking \string\textconcept{connectors}]{info} (information boxes), \conceptname[type=tag,conj=or,link,idx post=as lacking \string\textconcept{connectors}]{copyleft,copyright} notices and \conceptname[idx as=main title,link,link to=main/main title,idx pre=main,idx font pre=\ConceptFont,idx as=main title \string\textrm{as lacking} connectors]{main titles} are freestanding objects without ready-made \conceptname[idx as=connector,link,link to=connector,idx font post=\ConceptFont,idx post=tags \string\textrm{lacking support for}]{connectors}.
1963 %
1964 % \Conceptname[link,idx post=purpose]{headings,subheadings} are designed to label stretches of time and are placed in relation to the \conceptname[link,no idx]{timeline}, though no connecting lines are drawn.
1965 %
1966 % When we've finished adding material to the \conceptname[no idx,link]{timeline}, of course, we need to complete it.
1967 % \begin{chronoscode}
1968 % \end{chronos}
1969 % \end{chronoscode}
1970 %
1971 %^^A END sec:ee
1972 %
1973 % \restoregeometry
1974 % \setlength\tewadjust{\marginparwidth+\marginparsep-\paperwidth+\textwidth+\oddsidemargin+1in}%
1975 % \fancyheadoffset[lh]{\tewadjust}%
1976 % \section{Loading the Package}\label{sec:llwytho}
1977 %^^A BEGIN sec:llwytho
1978 %
1979 % \Pkg{chronos} requires a \LaTeXe{} format no older than 2021--11--15.
1980 % To load the package simply add the following to your document's preamble.
1981 % \begin{chronoscode}
1982 % \usepackage{chronos}
1983 % \end{chronoscode}
1984 % \Pkgname[no link,idx post=dependencies]{chronos} will load the following packages and libraries automatically:
1985 % \loadlist[Packages]{%
1986 % {\pkgname[no link]{calc}},
1987 % {\pkgname[no link]{chronos-lib-colschemes} (part of \pkgname[idx post=chronos-lib-colschemes,idx font post=\PkgFont]{chronos})},
1988 % {\pkgname[no link]{chronos-lib-styles} (part of \pkgname[idx post=chronos-lib-styles,idx font post=\PkgFont]{chronos})},
1989 % {\pkgname[no link]{etoolbox}},
1990 % {\pkgname[no link]{expl3} (if required)},
1991 % {\pkgname[no link]{fp}},
1992 % {\pkgname[no link]{pgfcalendar}},
1993 % {\pkgname[no link]{svn-prov}},
1994 % {\pkgname[no link]{tikz}},
1995 % {\pkgname[no link]{xcolor}},
1996 % {\pkgname[no link]{xparse} (for \LaTeXe{} formats prior to 2020--10--01)}%
1997 % }
1998 % \loadlist[\PGF/\TikZ{} libraries]{%
1999 % {\pkgname[type=lib,no link]{arrows.meta}},
2000 % {\pkgname[type=lib,no link]{backgrounds}},
2001 % {\pkgname[type=lib,no link]{calc}},
2002 % {\pkgname[type=lib,no link]{decorations.text}},
2003 % {\pkgname[type=lib,no link]{fit}},
2004 % {\pkgname[type=lib,no link]{fixedpointarithmetic}},
2005 % {\pkgname[type=lib,no link]{positioning}},
2006 % {\pkgname[type=lib,no link]{shadows}}}
2007 %
2008 %^^A \hypersetup{next-anchor=boolkey:simple-colour-names}%
2009 % \DescribeBoolkey{simple colour names,no simple colour names,simple color names,no simple color names}\vals{true,false}\AfterLastParam
2010 %^^A \ExpandArgs {e} \DescribeBoolkey{simple colour names,no simple colour names,simple color names,no simple color names}\vals{true,false}\AfterLastParam
2011 % The only two options currently supported are \keyname[type=pkgopt,conj=or,no link]{\option{simple colour names},\option{simple color names}} and its complement \keyname[type=pkgopt,conj=or,no link]{\option{no simple colour names},\option{no simple color names}}.
2012 % The following are equivalent:
2013 % \begin{chronoscode}
2014 % \usepackage{chronos}
2015 % \usepackage[simple colour names]{chronos}
2016 % \usepackage[simple colour names=true]{chronos}
2017 % \usepackage[no simple colour names=false]{chronos}
2018 % \end{chronoscode}
2019 % In these cases, \pkg{chronos} will create an additional \conceptname[type=colour,idx as=with \string\texttt{simple colour names}, font=\normalfont]{colour} for each \conceptname[type=concept,idx pre=element,idx as=additional,font=\normalfont,idx font pre=\ConceptFont]{additional element} of \conceptname[type=concept,no idx,link]{tag}-type \conceptname[type=tag,conj=or,idx post=effect of \string\textkey{simple colour names} on]{life,event,period,theory,info} named \meta{name}, where \meta{name} is the value given to \keyname[idx=false,link]{name} when creating the \elementlabelname{}.
2020 %
2021 % Since \pkg{chronos} creates these \keyname[type=colour,idx as=simple colour names,idx post=disabling,no link]{colours} globally, this is potentially problematic.
2022 % To disable it use any of the following
2023 % \begin{chronoscode}
2024 % \usepackage[no simple colour names]{chronos}
2025 % \usepackage[no simple colour names=true]{chronos}
2026 % \usepackage[simple colour names=false]{chronos}
2027 % \end{chronoscode}
2028 %
2029 % If you want to disable such names later, perhaps for specific \conceptname[idx as=timeline,link,link to=timeline,no idx]{timelines}, see \cref{subsec:lliwiau}.
2030 %
2031 %^^A END sec:llwytho
2032 %
2033 % \section{Invocation}\label{sec:invoke}
2034 %^^A BEGIN sec:invoke
2035 % \DescribeEnv{chronos}\oarg{chronos preamble}\AfterLastParam
2036 % The \conceptname[type=concept,no link,target]{\meta{chronos preamble}} is a \meta{key-value list} setting any non-default options which should be applied to the \conceptname[type=concept,target]{timeline} and any other macro-level elements of the picture to be constructed.
2037 % At a minimum, most users will want to specify start and end dates, but the majority will likely want to customise the \conceptname[no idx,link]{timeline} further.
2038 % (If you do not much care about customisation, there are simpler packages to typeset \conceptname[idx as=timeline,no idx]{timelines}!)
2039 %
2040 % Some options can be given only \emph{in or before} the \conceptname[type=concept,no link,target]{\meta{timeline specification}} in the optional \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}.
2041 % Others will have no effect or unwanted effects at this point and must be specified later.
2042 %
2043 % {\em
2044 % {\bfseries
2045 % The environment \keyname[link,idx=false,type=env]{chronos} is a wrapper for a \keyname[type=env,no link]{tikzpicture}.
2046 % It can neither include, nor be included in, another \enviro{tikzpicture}.
2047 % Additional drawing commands must, therefore, be included in \enviro{chronos} itself.%
2048 % }%
2049 % }
2050 %
2051 %^^A END sec:invoke
2052 %
2053 % \loadgeometry{safonol}
2054 % \setlength\tewadjust{\marginparwidth+\marginparsep}%
2055 % \fancyheadoffset[lh]{0pt}%^^A REQUIRED - do NOT remove this line!!
2056 %
2057 % \section{Chronos Anatomy}\label{sec:anatomy}
2058 %^^A BEGIN sec:anatomy
2059 % \Cref{fig:anatomi} provides an overview of the configuration and anatomy of a \pkg{chronos} \conceptname[link,idx post=anatomy]{timeline}.
2060 %
2061 % As explained in \cref{sec:invoke}, the \conceptname[link,no idx]{timeline} itself is constructed by the \keyname[link,type=env,idx post=as constructing \string\textconcept{timeline}]{chronos} \envlabelname{}, as determined by the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}, any prior use of \keyname[type=macro,idx post=effect on \string\textconcept{timeline}]{\cs{chronosset}} and fallback defaults.
2062 %
2063 % In addition to configuring the \conceptname[no idx,link]{timeline} itself, the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} and any prior use of \keyname[type=macro,no idx]{\cs{chronosset}} determine the use and configuration of any \conceptname[link,idx post=determinants of configuration]{frame,headings,subheadings}, as well as the default configuration of any \conceptname[no idx]{additional elements}.
2064 %
2065 % The body of the \keyname[link,idx=false,type=env]{chronos} \envlabelname{} is the \conceptname[type=concept,no link,target]{\meta{timeline additions specification}}.
2066 % The \conceptname[type=concept,no idx,link]{\meta{timeline additions specification}} specifies what should be added to the \keyname[type=env,no link,idx post=adding to]{tikzpicture} besides the \conceptname[idx post=\string\meta{timeline additions specification}]{timeline} itself and any \conceptname[conj=or,link,no idx]{frame,headings,subheadings}.
2067 % It will typically consist of a series of \pkg{chronos} commands specifying the items to be connected to the \conceptname[no idx,link]{timeline} and any non-connected \elementslabelname{} (\cref{sec:macros-add-elements}).
2068 % However, it may include any code valid in a \keyname[type=env,no link,idx post={content of \string\meta{timeline additions specification}}]{tikzpicture} \envlabelname{} or be entirely empty.
2069 %
2070 % \Cref{subsec:anatomi-llinell-amser} provides a breakdown of the various \conceptname[idx as=element,type=concept,target,target as=element]{elements} of which the \conceptname[no idx,link]{timeline} is composed.
2071 % \Cref{subsec:mathau} provides an overview of the \conceptname[idx as=additional,idx pre=element,type=concept,font=\normalfont,idx font pre=\ConceptFont]{additional elements} which may be added in the \conceptname[type=concept,no idx,link]{\meta{timeline additions specification}}.
2072 %
2073 % If your \conceptname[no idx,link]{timeline} uses non-\pkg{chronos} commands, you will need to read \cref{subsec:haenau,sec:haenau-llunio}, which explains the \conceptname[type=layer,font=\normalfont,idx as=choosing appropriate]{layers} \pkg{chronos} uses.
2074 % If your commands are not having their usual effects, you should first check whether they are simply hidden by another layer.
2075 %
2076 %^^A \iffalse
2077 % \begin{sidewaysfigure}
2078 % \centering
2079 % \thisfloatpagestyle{empty}%
2080 % \makebox[0pt]{%
2081 % \begin{chronos}
2082 % [
2083 % cronoleg,
2084 % timeline={%
2085 % width=180mm,
2086 % dates={-500}:1500,
2087 % timeline bare marks=false,
2088 % },
2089 % levels=8:7,
2090 % chronos coords={-500,-450,...,1500},
2091 % headings={heading/chronos year 800/chronos year 1500,another heading/chronos year -450/chronos year 1,a third heading/chronos year 100/chronos year 800},
2092 % subheadings={subheading on upper level/chronos year -250/chronos year 500/chronos upper subheadings,subheading on lower level/chronos start/chronos year -100/chronos lower subheadings,another subheading/chronos year 1000/chronos year 1500/chronos upper subheadings,yet another subheading/chronos year 500/chronos year 1000/chronos lower subheadings},
2093 % century subheadings={12,13,...,15}{th},
2094 % century subheading={1}{st},
2095 % levels at=chronos year -200,
2096 % chronos opacity=.4,
2097 % /tikz/deco/.style={decoration={brace,amplitude=#1},red,decorate},
2098 % tikz outside bb+={%^^A only works in preamble
2099 % \begin{scope}[on chronos overlay layer,red,draw=red,every node/.append style={font=\sffamily}]
2100 % \begin{scope}[every node/.append style={inner sep=0pt}]
2101 % \foreach \i/\j in {chronos margin top/,chronos main headings/headings,chronos lower subheadings/lower subheadings,chronos upper subheadings/upper subheadings,chronos bottom/,u8.north/,i1.north/,chronos head/,chronos foot/,chronos base/,chronos top/} \draw [help lines,dashed] (chronos frame.west |- \i) -- node [above,pos=.8,anchor=base west, red] {\j} (chronos frame.east |- \i) ;
2102 % \foreach \i in {1,...,8} {
2103 % \draw [help lines,dashed] (chronos frame.west |- u\i.south) -- (chronos frame.east |- u\i.south) coordinate [pos=.05] (a) ;
2104 % \node (n) at ($(a |- u\i.south)!.5!(a |- u\i.north)$) {level \i};
2105 % \draw [-Latex,red] (n.north -| a) -- (a |- u\i.north);
2106 % \draw [-Latex,red] (n.south -| a) -- (a |- u\i.south);
2107 % }
2108 % \foreach \i in {1,...,7} {
2109 % \draw [help lines,dashed] (chronos frame.west |- i\i.south) -- (chronos frame.east |- i\i.south) ;
2110 % \node [anchor=west] (m) at ($(n.west |- i\i.south)!.5!(n.west |- i\i.north)$) {level -\i};
2111 % \draw [-Latex,red] (m.north -| a) -- (a |- i\i.north);
2112 % \draw [-Latex,red] (m.south -| a) -- (a |- i\i.south);
2113 % }
2114 % \node [anchor=west] (m) at ($(n.west |- u8.north)!.5!(n.west |- chronos margin top)$) {headings border + top border};
2115 % \draw [-Latex,red] (m.south -| a) -- (a |- u8.north);
2116 % \draw [-Latex,red] (m.north -| a) -- (a |- chronos margin top);
2117 % \coordinate [left=5pt of n.west] (c) ;
2118 % \foreach \i/\j/\k in {chronos lower subheadings/chronos upper subheadings/lower subheadings drop,chronos upper subheadings/chronos main headings/upper subheadings drop,chronos bottom/i7.south/bottom border} {
2119 % \draw [red, Latex-Latex] (\i -| c) -- (c |- \j) coordinate [midway] (b);
2120 % \draw [red] (b) -- (b -| chronos frame.west) -- ++(-5pt,0pt) node [anchor=east] {\k};
2121 % }
2122 % \draw [red, Latex-Latex] (chronos main headings -| c) -- (c |- chronos margin top) coordinate [midway] (b);
2123 % \draw [red] (b) -- (b -| chronos frame.west) -| ++(-10pt,40pt) node [fill=white,fill opacity=.75,text opacity=1,anchor=south] {headings drop + top border};
2124 % \draw [red, Latex-Latex] (chronos pre) -- (chronos frame.west |- chronos pre) coordinate [midway] (b);
2125 % \node [xshift=-20pt,yshift=-30pt,anchor=east] (m) at (b) {left border};
2126 % %^^A dyw |-| ddim yn gweithio yn y fan hon ond wn i ddim pam ...
2127 % \draw [red] (b) |- (m.east);
2128 % \node (m) at ($(chronos post-head |- u1)!.5!(chronos frame.east |- u1)$) {right border};
2129 % \draw [red, -Latex] (m.east |- u1) -- (chronos frame.east |- u1) ;
2130 % \draw [red, -Latex] (m.west |- u1) -- (chronos post-head |- u1);
2131 % \node (m) at (chronos year -400 |- u2) {timeline};
2132 % \node (ub) at (chronos year 1 |- u1) {timeline border};
2133 % \node (lb) at (chronos year 1 |- i1) {timeline border};
2134 % \draw [red, -Latex, thick] (m.south) -- (m |- chronos pre);
2135 % \draw [red, -Latex] (ub.south) -- (ub |- {$(chronos head)!.5!(chronos top)$});
2136 % \draw [red, -Latex] (lb.north) -- (lb |- {$(chronos foot)!.5!(chronos base)$});
2137 % \end{scope}
2138 % \begin{scope}[every node/.append style={fill=white,fill opacity=.75,text opacity=1}]
2139 % \draw [{Latex[]}-,red] (chronos post-head) ++(-20pt,1pt) -- ++(0pt,20pt) node {2pt};
2140 % \draw [{Latex[]}-,red] (chronos post-foot) ++(-20pt,-1pt) -- ++(0pt,-20pt) node {2pt};
2141 % \draw [deco=3] (chronos post-top) -- node [right, anchor=west, xshift=2.5pt] {timeline height} (chronos post-base);
2142 % \draw [deco=1.5] (chronos post-head) -- node [right, anchor=west, xshift=2.5pt] {timeline border height} (chronos post-top);
2143 % \draw [deco=1.5] (chronos post-base) -- node [right, anchor=west,xshift=2.5pt] {timeline border height} (chronos post-foot);
2144 % \foreach \i in {a period,an event,an information box} \draw [deco=3] (tag \i.north west) ++(0,2.5pt) coordinate (a) -- node [above, anchor=south,yshift=2.5pt] {\i} (tag \i.east |- a);
2145 % \draw [deco=5,thick] (lives.west |- theories.north) ++(0pt,2.5pt) coordinate (a) -- node [anchor=south,yshift=7.5pt] {2 \texttimes{} theory} (theories.east |- a);
2146 % \draw [deco=5,thick] (tag a life.south west) ++(-10pt,0pt) coordinate (a) -- node [anchor=east,xshift=-7.5pt] {6 \texttimes{} life} (chronos base -| a);
2147 % \draw [deco=5,thick] (main title.north west) ++(0pt,2.5pt) coordinate (a) -- node [anchor=south, yshift=7.5pt] {main title} (main title.east |- a);
2148 % \draw [deco=3] (theory circle.north west) -- node [anchor=south,yshift=2.5pt] {theory circle} (theory circle.north east);
2149 % \draw [deco=5,thick] (chronos frame.north west) ++(0pt,2.5pt) coordinate (a) -- node [anchor=south,yshift=7.5pt] {frame} (chronos frame.east |- a);
2150 % \end{scope}
2151 % \end{scope}
2152 % },
2153 % outer border=2.5pt,
2154 % frame uses bb=false,
2155 %^^A debug,
2156 % ]
2157 % \chronoslife {%
2158 % name=a life,
2159 % dates=820:850,
2160 % at=i6 -| a life,
2161 % connectors={east,south},
2162 % tag anchor=west,
2163 % xshift=5pt,
2164 % }
2165 % \chronosevent {%
2166 % name=an event,
2167 % date=756,
2168 % at=u1 -| an event,
2169 % xshift=-10pt,
2170 % tag anchor=east,
2171 % connectors=west,
2172 % }
2173 % \chronostheory {%
2174 % name content=Text Tags of\\Type `Life',
2175 % name=lives,
2176 % at=tag a life.east |- i7.south,
2177 % xshift=10pt,
2178 % tag anchor=west,
2179 % anchor=south west,
2180 % connectors={north,east,south}
2181 % }
2182 % \chronostheory {%
2183 % name content=A Theory Text Tag\\Connected to Another\\Theory Text Tag,
2184 % name=theories,
2185 % at=tag lives.south east,
2186 % xshift=30pt,
2187 % connectors={south,north},
2188 % anchor=south west,
2189 % }
2190 % \draw [chronos connect=theory:lives] (connector lives4) -- ++(0pt,-10pt) -| (connector theories);
2191 % \chronosperiod {%
2192 % name=a period,
2193 % start=189,
2194 % end=191,
2195 % at=a period,
2196 % yshift=50pt,
2197 % xshift=10pt,
2198 % tag anchor=west,
2199 % connectors={east,north},
2200 % }
2201 % \draw [chronos connect=life:a life] (connector a life) -|- (connector lives);
2202 % \chronosinfo{%
2203 % name=an information box,
2204 % text content={A box\\[-.25em]\hspace*{1.5em}for\\Information.},
2205 % anchor=south,
2206 % at=chronos year 1000 |- u3,
2207 % yshift=-2.5pt,
2208 % }
2209 % \chronostheorycircle{
2210 % name=theory circle,
2211 % at={$(tag an information box |- i4.center)!1/2!(u4 |- i4.center)$},
2212 % sizes=15pt:9pt,
2213 % circle texts=Theory:Circle,
2214 % labels=Upper Label:Lower Label,
2215 % }
2216 % \chronoslife {%
2217 % name=some one,
2218 % dates=842:910,
2219 % at=i5 -| some one,
2220 % xshift=5pt,
2221 % tag anchor=west,
2222 % connectors={east},
2223 % }
2224 % \chronoslife {%
2225 % name=an other,
2226 % dates=882:920,
2227 % at=i4 -| an other,
2228 % xshift=5pt,
2229 % tag anchor=west,
2230 % connectors={east},
2231 % }
2232 % \chronoslife {%
2233 % name=the other,
2234 % dates=912:987,
2235 % at=i3 -| the other,
2236 % xshift=5pt,
2237 % tag anchor=west,
2238 % connectors={east},
2239 % }
2240 % \chronoslife {%
2241 % name=the stranger,
2242 % dates=999:1011,
2243 % at=i2 -| the stranger,
2244 % xshift=5pt,
2245 % tag anchor=west,
2246 % connectors={east},
2247 % }
2248 % \chronoslife {%
2249 % name=the outsider,
2250 % dates=1002:1051,
2251 % at=i1 -| the outsider,
2252 % xshift=5pt,
2253 % tag anchor=west,
2254 % connectors={east},
2255 % }
2256 % \chronosmaintitle{%
2257 % name content={Chronos Timeline Anatomy},
2258 % at=chronos year 200 |- u7,
2259 % anchor=west,
2260 % name=main title,
2261 % }
2262 % \end{chronos}%
2263 % }
2264 % \caption{\pkg{chronos} anatomy\label{fig:anatomi}}
2265 % \end{sidewaysfigure}
2266 %^^A \fi
2267 %^^A \thispagestyle{fancyempty}%
2268 %
2269 % \subsection{Chronos Timeline}\label{subsec:anatomi-llinell-amser}
2270 %^^A BEGIN subsec:anatomi-llinell-amser
2271 %
2272 % The \conceptname[target,idx post=components of]{timeline} itself is a horizontal line consisting of some or all of the following elements
2273 % \begin{itemize}
2274 % \item \Conceptname[target]{timeline line}\chronosdochypertargets{element}{timeline}{timeline line} refers to the main line, which is drawn or filled by default depending on height and configuration.
2275 % The \keyname[link,idx=false,type=dimkey,link prefix=timeline/]{height,width,timeline border height} are responsible for the total size of the \conceptname[idx post=dimensions responsible for total size]{timeline}.
2276 % \item \Conceptname[idx as=timeline border,target,target as={timeline border,border},idx post=introduction to]{borders}\chronosdochypertargets{element}{timeline}{timeline border} are (potentially) filled with a gradient above and below the main line.
2277 % By default, borders are added when marks are placed on the \conceptname[idx post=borders,idx font post=\ConceptFont]{timeline} itself, which necessitates a taller \conceptname[idx post={effect of \string\textconcept{borders} on dimensions}]{timeline}.
2278 % \item \Conceptsname[target,idx post=location]{era label} are (potentially) placed at each end of the line, depending on the time period covered.
2279 % \item Timeline \conceptname[target,idx post=placement]{years,minor years,marks,minor marks,bare marks} may be placed above, below or on the main \conceptname[no idx,link]{timeline line}.
2280 % \end{itemize}
2281 %
2282 % Some \conceptname[idx as=element,type=concept,idx post=specified in \string\meta{chronos preamble}]{\elementslabelname} must be specified in the \conceptname[no idx,link,type=concept]{\meta{chronos preamble}}, but are constructed only at the end of the \conceptname[type=env,no idx]{\enviro{chronos}} \envlabelname.
2283 % These include optional \conceptname[no idx,link]{headings,subheadings} to be placed at the top of the \keyname[type=env,no idx]{\enviro{chronos}} \envlabelname{} and an optional \conceptname[no idx,link,link pre=main/]{frame}.
2284 %
2285 % \Conceptname[no idx]{headings,subheadings} are constructed after and above most other \elementslabelname{} \keyname[type=style]{on chronos foreground layer}.
2286 % As explained in \cref{subsec:headings}, \conceptname[no idx]{headings,subheadings} may be used to roughly indicate named stretches of time such as ‘Tudors’ or ‘Bronze Age’.
2287 % \begin{itemize}
2288 % \item \Conceptname[target,idx post=location]{headings}\chronosdochypertargets{element}{}{heading} are placed in a single row at the top.
2289 % \item \Conceptname[target,idx post=placement relative to \string\textconcept{headings}]{subheadings}\chronosdochypertargets{element}{}{century subheadings,century subheading,subheading} are placed just below the \conceptname[no idx]{headings} in two rows:
2290 % \begin{itemize}
2291 % \item The \conceptname[target,idx post=placement relative to \string\textconcept{headings}]{upper subheadings} are placed in a single row just beneath the \conceptname[no idx]{headings}.
2292 % \item The \conceptname[target,idx post=placement relative to \string\textconcept{upper subheadings}]{lower subheadings} are placed in a single row just beneath the \conceptname[no idx]{upper subheadings}.
2293 % \end{itemize}
2294 % \end{itemize}
2295 %
2296 % The \conceptname[link,link pre=main/,idx pre=main,idx font pre=\ConceptFont]{frame} is constructed even later, but drawn behind most other \elementslabelname{} \keyname[type=style]{on chronos background layer}.
2297 %
2298 %^^A END subsec:anatomi-llinell-amser
2299 %
2300 % \subsection{Chronos Additional Element Types}\label{subsec:mathau}\chronosdocidx[target,font=\ConceptFont,type=element,idx pre=additional,idx font pre=\ConceptFont]{timeline-connectable,connectable,non-connectable}\vspace{-\baselineskip}
2301 %^^A BEGIN subsec:mathau
2302 %
2303 % Aside from the \conceptname[no idx,link]{timeline} itself, its \conceptname[no idx,link]{headings,subheadings} and \conceptname[no idx,link,link to=main/frame]{frame}, \pkg{chronos} provides six primary types of \elementlabelname{} which may be added to the \conceptname[no idx,link]{timeline}: \conceptname[type=tag,target,idx post=as primary \string\textconcept{element}]{life,event,period,theory,info,theory circle}.
2304 % In this documentation, these are referred to as ‘\conceptname[type=concept,idx as=tag,target,target as=tag]{tags}’ or ‘\conceptname[type=concept,no idx]{\taglabelname} types’.
2305 % Three further \conceptname[link,link to=tag,type=concept,no idx]{tags} encompass one-off \elementslabelname{}: \conceptname[type=tag,target,idx post=elements\string\textnormal{ belonging to},idx font post=\ConceptFont]{main} covers the \conceptname[idx pre=main,idx font pre=\ConceptFont,idx post=as secondary\string\idxeg]{main title,frame}, while \conceptname[target,type=tag,target,idx post=elements\string\textnormal{ belonging to},idx font post=\ConceptFont]{copyleft,copyright} account for any declaration of \conceptname[no idx,link,link pre=copyleft/]{copyleft} or \conceptname[no idx,link,link pre=copyright/]{copyright}.
2306 %
2307 % For example, all \elementslabelname{} created using \keyname[type=macro]{\cs{chronoslife}} are said to belong to \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,no idx,link]{life}.
2308 %
2309 % \subsubsection{Primary Types}\label{subsubsec:primary}\chronosdocidx[target,font=\ConceptFont,type=element,idx post=primary]{additional}\vspace{-\baselineskip}
2310 %^^A BEGIN subsec:mathau
2311 %^^A BEGIN subsubsec:primary
2312 %
2313 % \paragraph{Timeline-Connectable Elements}\label{par:anatomi-add-timeline-connectable}\chronosdocidx[type=concept,idx pre=element,target pre=element/,target,font=\ConceptFont,idx font pre=\ConceptFont]{timeline-connectable}\chronosdocidx[type=element,target,font=\ConceptFont]{life,event,period}
2314 %^^A BEGIN par:anatomi-add-timeline-connectable
2315 % \Elementslabelname{} belonging to the first three \conceptname[type=concept,no idx,link,link to=tag]{tags} (\conceptname[type=tag,no idx,link,conj={,}]{life,event,period}) are (potentially) connected to the \conceptname[type=concept,idx post={elements, \string\textrm{additional}, timeline-connectable},link,idx font post=\ConceptFont]{timeline} and are placed according to date of occurrence.
2316 %
2317 % \begin{itemize}
2318 % \item These \elementslabelname{} are assigned colours and colour names are created so they may easily be reused.
2319 % These colours may (and, by default, are) used to create \conceptname[idx as=connection,no idx,link,link to=connection]{connections}, \conceptname[idx as=connector,no idx,link,link to=connector]{connectors}, \conceptname[idx as=line,no idx,link,link to=line]{lines} and \conceptname[idx as=text tags,no idx,link,link to=text tag]{text tags}.
2320 % \item These \elementslabelname{} are connected to the \conceptname[type=concept,idx post={elements, \string\textrm{additional}, timeline-connectable},link,idx font post=\ConceptFont]{timeline} by default using \conceptname[idx as=connection,idx post=between \string\textconcept{chronos connectors} and \string\textconcept{text tag connectors},target,target as=connection]{connections} which join \conceptname[idx as=chronos connector,target,target as=chronos connector]{chronos connectors} to \conceptname[idx as=text tag connector,target,target as={connector,text tag connector}]{text tag connectors} on the \elementslabelname{}' \conceptname[idx as=text tag,no idx]{text tags}.
2321 % \item Dates/periods are (potentially) drawn or filled on, above or below the \conceptname[no idx,link]{timeline} using \conceptname[idx as=line,target,target as=line,idx post=as representation of time]{lines}.
2322 % \item \Conceptname[idx as=text tag,idx post=introduction,link,link to=text tag]{text tags} are created for the \elementslabelname{}\texsethanks[enabling \conceptname[idx as=text tag connector,no idx]{connectors} to be centred correctly on the borders of \conceptname[idx as=text tag,no idx]{text tags}]{Symbol 1}{385953}.
2323 % By default, these typically include a name and date or date-range, though arbitrary content is permissible.
2324 % The location of \conceptname[no idx]{text tags} is configurable, though it usually makes sense to place them in relation to their \conceptname[idx as=chronos connector,no idx,link,link to=chronos connector]{chronos connectors}.
2325 % \item \chronosdochypertargets{element}{timeline-connectable}{life,period}\Conceptname[type=tag,link,idx post=use of two dates for placement]{life,period} use two dates for placement.
2326 % A \conceptname[link,idx post=representation of time in \string\textconcept{life}/\string\textconcept{period}]{line} is (potentially) drawn and/or filled on, above or below the \conceptname[idx post=lines,idx font post=\ConceptFont]{timeline}, by default in the element's associated colour.
2327 % \item \chronosdochypertargets{element}{timeline-connectable}{event}\Conceptname[type=tag,link,idx post=use of single date for placement]{event} uses a single date for placement.
2328 % A \conceptname[idx pre=event,idx font pre=\ConceptFont]{line} is (potentially) drawn on the \conceptname[idx post=connections,idx font post=\ConceptFont]{timeline}, by default in the element's associated colour.
2329 % \end{itemize}
2330 % \Conceptname[bagpuss,no idx,type=concept,link,link pre=element/]{timeline-connectable} elements are also \conceptname[link,type=concept,link pre=element/,no idx]{connectable} (\cref{par:anatomi-add-connectable}).
2331 %^^A END par:anatomi-add-timeline-connectable
2332 %
2333 % \paragraph{Connectable Elements}\label{par:anatomi-add-connectable}\chronosdocidx[type=concept,idx pre=element,target pre=element/,target,font=\ConceptFont,idx font pre=\ConceptFont]{connectable}\chronosdocidx[type=element,target]{theory}
2334 %^^A BEGIN par:anatomi-add-connectable
2335 % \Elementslabelname{} belonging to the first four \conceptname[type=concept,no idx,link,link to=tag]{tags} (\conceptname[type=tag,no idx,link,conj={,}]{life,event,period,theory}) are (potentially) \conceptname[link,type=concept,link pre=element/,no idx]{connectable} to each other.
2336 %
2337 % \begin{itemize}
2338 % \item These \elementslabelname{} (potentially) feature \conceptname[idx as=text tag connector,no idx,link,link to=text tag connector]{connectors} which may be used to connect \elementslabelname{} together.
2339 % When the first three are connected to the \conceptname[type=concept,idx post=connectors,idx font post=\ConceptFont,link]{timeline}, one such connector is created by default\footnote{Connectors may be customised to ‘disappear’, but even invisible connectors can be used in connections.}.
2340 % \item \Elementslabelname{} belonging to the \conceptname[type=tag,target,no idx]{theory} \conceptname[type=concept,no idx,link]{tag} are \conceptname[no idx,type=concept,link,link pre=element/]{connectable}, but not \conceptname[no idx,type=concept,link,link pre=element/]{timeline-connectable}.
2341 % Unlike \conceptname[no idx,type=concept,link,link pre=element/]{timeline-connectable} \elementslabelname{} (\cref{par:anatomi-add-timeline-connectable}), they cannot be connected to the \conceptname[type=concept,idx post={elements, \string\textrm{additional}, non-timeline-connectable},link,idx font post=\ConceptFont]{timeline} and may be freely placed; unlike \conceptname[no idx,type=concept,link,link pre=element/]{non-connectable} \elementslabelname{} (\cref{par:anatomi-add-non-connectable}), they may be connected to each other and/or \conceptname[no idx,type=concept,link,link pre=element/]{timeline-connectable} \elementslabelname{}.
2342 % \end{itemize}
2343 %^^A END par:anatomi-add-connectable
2344 %
2345 % \paragraph{Non-Connectable Elements}\label{par:anatomi-add-non-connectable}\chronosdocidx[type=concept,idx pre=element,idx font pre=\ConceptFont,target pre=element/,target,font=\ConceptFont]{non-connectable}\chronosdocidx[type=element,target,font=\ConceptFont]{info,theory circle}\chronosdocidx[type=element,target,idx pre=main,idx font pre=\ConceptFont,font=\ConceptFont,target pre=main/]{main title,frame}\chronosdochypertargets{element}{}{frame}\chronosdocidx[type=element,target,font=\ConceptFont,idx pre=copyleft,target pre=copyleft/,idx font pre=\ConceptFont]{copyleft,copyright}
2346 % \chronosdocidx[type=element,target,font=\ConceptFont,idx pre=copyright,idx font pre=\ConceptFont,target pre=copyright/]{copyleft,copyright}%
2347 %^^A BEGIN par:anatomi-add-non-connectable
2348 %
2349 % \Elementslabelname{} belonging to the remaining \conceptname[type=concept,no idx,link,link to=tag]{tags} (\conceptname[type=tag,no idx,link]{info,theory circle,main,copyleft,copyright}) are \conceptname[link,type=concept,link pre=element/,idx font pre=\ConceptFont,no idx]{non-connectable} and, with the exception of \conceptname[link,no idx,link to=main/frame]{frame} may be located according to user preference.
2350 %
2351 % \begin{itemize}
2352 % \item Like \conceptname[no idx,type=concept,link,link pre=element/]{connectable}-but-not-\conceptname[no idx,type=concept,link,link pre=element/]{timeline-connectable} \elementslabelname{}, \conceptname[no idx,type=concept,link,link pre=element/]{non-connectable} \elementslabelname{} are not connected to the \conceptname[type=concept,idx post={elements, \string\textrm{additional}, non-timeline-connectable},idx font post=\ConceptFont,link]{timeline} and may involve no date information at all, but unlike \chronosdochypertargets{element}{connectable}{theory}\conceptname[type=tag,idx as=theory,idx post=cf.~\string\textconcept{non-connectable elements}]{theories}\chronosdocidx[type=concept,font=\ConceptFont,idx post={elements, \string\textrm{additional}, connectable},link,idx font post=\ConceptFont]{timeline} they do not feature \conceptname[idx as=text tag connector,idx post=not feature of \string\textconcept{non-connectable elements}]{connectors} so may not easily be connected to other \elementslabelname{}.
2353 % \item \Conceptname[type=tag,link,idx post=as standalone]{info}\chronosdochypertargets{element}{non-connectable}{info} and \conceptname[type=tag,link,idx post=as standalone]{theory circle}\chronosdochypertargets{element}{non-connectable}{theory circle} \elementslabelname{} are standalone items for providing content.
2354 % The former (potentially) have \conceptname[idx as=caption]{captions} below; the latter (potentially) have \conceptname{labels} above and/or below.
2355 % The first are basically just text nodes with arbitrary content; the second can display two small chunks of text arranged in semicircles with a hole in the middle for a letter or symbol.
2356 % \item \Conceptname[type=tag,idx as=theory circle,idx post=slowness]{theory circles} are \emph{slow} and their use should be limited to avoid excessive compilation times.
2357 % They are also arguably the most difficult to read and should be used only for items of minor or secondary importance.
2358 % \item The standalone \elementslabelname{} are best created last and are most useful for filling in ‘holes’ in a \conceptname[no idx]{timeline} which would otherwise look unbalanced.
2359 % If chiropody didn't develop much in the twelfth century or not much is known about the finer points of tortoise-raising in the second, these \elementslabelname{} may be used to plug the unsightly gaps left by inconvenient histories.
2360 % \end{itemize}
2361 %
2362 %^^A END par:anatomi-add-non-connectable
2363 %
2364 %^^A END subsubsec:primary
2365 %
2366 % \subsubsection{Secondary (Sub-)Elements}\label{subsubsec:secondary}\chronosdocidx[target,font=\ConceptFont,type=element,idx post=secondary (sub-)]{additional}
2367 %^^A BEGIN subsubsec:secondary
2368 % Orthogonal to the primary \elementslabelname{} explained above, \pkg{chronos} uses the following (sub-)\elementslabelname{}:
2369 % \begin{itemize}
2370 % \item \Conceptname[idx as=\meta{tag}/connector,target,target as=\meta{tag}/connector]{connectors} are small \elementslabelname{} drawn on the boundaries of \conceptname[idx as=text tag]{text tags} and the \conceptname[idx post=connectors,idx font post=\ConceptFont]{timeline} which can be used as connection points.
2371 % By default, they are small and circular, but they may be rendered invisibly or otherwise according to preference.
2372 % \item \Conceptname[idx as=\meta{tag}/connection,target,target as=\meta{tag}/connection]{connections} are drawn between \conceptname[no idx,link to=\meta{tag}/connector,]{connectors}.
2373 % The package draws a connection between the \conceptname[idx post=connections]{timeline} and date-placed \elementslabelname{} by default, but occasionally you may prefer to specify this connection manually.
2374 % Other connections can be added to link \elementslabelname{}.
2375 % \item \Conceptsname[idx as=\meta{tag}/text tag,target,target as=text tag]{text tag}\chronosdochypertargets{element}{life,event,period,\meta{tag}}{text tag} hold information associated with all \elementslabelname{} except \conceptname[idx as=theory circle,idx post=lack of \string\textconcept{text tag}]{theory circles}.
2376 % \item \Conceptname[idx as=\meta{tag}/line,target,target as=\meta{tag}/line]{lines} are marked on the \conceptname[idx post=lines,idx font post=\ConceptFont]{timeline} to indicate the date and/or duration of dated \elementslabelname{}.
2377 % \end{itemize}
2378 %
2379 %^^A END subsubsec:secondary
2380 %
2381 %^^A END subsec:mathau
2382 %
2383 % \subsection{Chronos Coordinate and Node Names}\label{subsec:coords-nodes}
2384 %^^A BEGIN subsec:coords-nodes
2385 %
2386 % \Cref{fig:anatomi-coords} shows key coordinate and node names.
2387 % Those available by default can be shown on any \conceptname[no idx]{timeline} using the option \keyname[link,idx=false]{debug}.
2388 % Examples of different \conceptname[type=concept,idx as=tag,idx post=coordinate names]{tags}\chronosdocidx[type=concept,idx post=node names,font=\ConceptFont]{tag} have been added with labels to illustrate how \pkg{chronos} names their coordinates and nodes.
2389 % Detailed documentation is provided in \cref{sec:config,sec:macros-add-elements}.
2390 %^^A \iffalse
2391 % \begin{sidewaysfigure}
2392 %^^A \def\bagpuss{Bagpuss}%
2393 % \thisfloatpagestyle{empty}%
2394 % \centering
2395 % \makebox[0pt]{%^^A
2396 % \begin{chronos}
2397 % [
2398 % cronoleg,
2399 % timeline={%
2400 % width=180mm,
2401 % dates={-500}:1500,
2402 % timeline bare marks=false,
2403 % },
2404 % levels=8:7,
2405 % chronos coords={-500,-450,...,1500},
2406 % headings={heading/chronos year 800/chronos year 1500,another heading/chronos year -450/chronos year 1,a third heading/chronos year 100/chronos year 800},
2407 % subheadings={subheading on upper level/chronos year -250/chronos year 500/chronos upper subheadings,subheading on lower level/chronos start/chronos year -100/chronos lower subheadings,another subheading/chronos year 1000/chronos year 1500/chronos upper subheadings,yet another subheading/chronos year 500/chronos year 1000/chronos lower subheadings},
2408 % century subheadings={12,13,...,15}{th},
2409 % century subheading={1}{st},
2410 % levels at=chronos year -200,
2411 % chronos opacity=.4,
2412 % debug,
2413 % tikz outside bb+={%^^A only works in preamble
2414 % \begin{scope}[on chronos overlay layer]
2415 % \foreach \i/\j/\k in {heading/90/north,another heading/90/north,a third heading/90/north,subheading on upper level/180/west,subheading on lower level/180/west,another subheading/180/west} \node [/chronos/show coordinate={chronos show node colour}{\j}{\i}{15pt}{}] at (\i.\k) {};
2416 % \foreach \i in {1st,12th,13th,14th,15th,yet another subheading} \node [/chronos/show coordinate={chronos show node colour}{-90}{\i}{5pt}{}] at (\i.south) {};
2417 % \end{scope}
2418 % },
2419 % outer border=2.5pt,
2420 % ]
2421 % \chronoslife {%
2422 % name=a life,
2423 % dates=820:850,
2424 % at=i6 -| a life,
2425 % connectors={east,south},
2426 % tag anchor=west,
2427 % xshift=5pt,
2428 % }
2429 %
2430 % \chronosevent {%
2431 % name=an event,
2432 % date=756,
2433 % at=u1 -| an event,
2434 % xshift=10pt,
2435 % tag anchor=west,
2436 % connectors=east,
2437 % }
2438 % \chronostheory {%
2439 % name content=Text Tags of\\Type `Life',
2440 % name=lives,
2441 % at=tag a life.east |- i7.south,
2442 % xshift=10pt,
2443 % tag anchor=west,
2444 % anchor=south west,
2445 % connectors={north,east,south}
2446 % }
2447 % \chronostheory {%
2448 % name content=A Theory Text Tag\\Connected to Another\\Theory Text Tag,
2449 % name=theories,
2450 % at=tag lives.south east,
2451 % xshift=30pt,
2452 % connectors={south,north},
2453 % anchor=south west,
2454 % }
2455 % \draw [chronos connect=theory:lives] (connector lives4) -- ++(0pt,-10pt) -| (connector theories);
2456 % \chronosperiod {%
2457 % name=a period,
2458 % start=189,
2459 % end=191,
2460 % at=a period,
2461 % yshift=50pt,
2462 % xshift=10pt,
2463 % tag anchor=west,
2464 % connectors={east,north},
2465 % }
2466 % \draw [chronos connect=life:a life] (connector a life) -|- (connector lives);
2467 %
2468 % \chronosinfo{%
2469 % name=an information box,
2470 % text content={A box\\[-.25em]\hspace*{1.5em}for\\Information.},
2471 % anchor=south,
2472 % at=chronos year 1300 |- u4,
2473 % yshift=-2.5pt,
2474 % }
2475 %
2476 % \chronostheorycircle{
2477 % name=theory circle,
2478 % at={$(chronos year 1000 |- i4.center)!1/2!(u4 |- i4.center)$},
2479 % sizes=15pt:9pt,
2480 % circle texts=Theory:Circle,
2481 % labels=Upper Label:Lower Label,
2482 % }
2483 % \chronoslife {%
2484 % name=some one,
2485 % dates=842:910,
2486 % at=i5 -| some one,
2487 % xshift=5pt,
2488 % tag anchor=west,
2489 % connectors={east},
2490 % }
2491 % \chronoslife {%
2492 % name=an other,
2493 % dates=882:920,
2494 % at=i4 -| an other,
2495 % xshift=5pt,
2496 % tag anchor=west,
2497 % connectors={east},
2498 % }
2499 % \chronoslife {%
2500 % name=the other,
2501 % dates=912:987,
2502 % at=i3 -| the other,
2503 % xshift=5pt,
2504 % tag anchor=west,
2505 % connectors={east},
2506 % }
2507 % \chronoslife {%
2508 % name=the stranger,
2509 % dates=999:1011,
2510 % at=i2 -| the stranger,
2511 % xshift=5pt,
2512 % tag anchor=west,
2513 % connectors={east},
2514 % }
2515 % \chronoslife {%
2516 % name=the outsider,
2517 % dates=1002:1051,
2518 % at=i1 -| the outsider,
2519 % xshift=5pt,
2520 % tag anchor=west,
2521 % connectors={east},
2522 % }
2523 % \foreach \i/\j in {some one/north west,an other/north,the other/north east} \draw [chronos connect=life:\i] (connector \i) -| (connector lives2.\j);
2524 % \foreach \i/\j/\k in {the stranger/north east/5pt,the outsider/south east/10pt} \draw [chronos connect=life:\i] (connector \i) -- (connector \i -| connector lives3) -- ++(\k,0pt) |- (connector lives3.\j);
2525 %
2526 % \chronosmaintitle{%
2527 % name content={Chronos Timeline Anatomy},
2528 % at=chronos year 200 |- u7,
2529 % anchor=west,
2530 % name=main title,
2531 % }
2532 % \begin{scope}[on chronos overlay layer]
2533 % \foreach \i/\j in {theory circle1/0,theory circle2/160,theory circle3/180,theory circle4/0,theory circle5/180} \node [/chronos/show coordinate={chronos show coordinate colour}{\j}{\i}{20pt}{fill=white,fill opacity=.5,text opacity=1}] at (\i) {};
2534 % \foreach \i/\j/\k in {a period/2/90,an event/1/0,a life/2/-90,theories/2/90} \node [/chronos/show coordinate={chronos show node colour}{\k}{connector\\\i\j}{15pt}{align=center}] at (connector \i\j) {};
2535 % \foreach \i/\j/\k in {theory circle/north west/180,label above theory circle/north/90,label below theory circle/south/-90,an information box/east/0,label an information box/east/0,u8/west/180,i5/west/180,theories/north west/90} \node [/chronos/show coordinate={chronos show node colour}{\k}{\i}{15pt}{align=center}] at (\i.\j) {};
2536 % \foreach \i/\j/\k in {a life/south west/-135,a period/north east/45,an event/north/90} \node [/chronos/show coordinate={chronos show node colour}{\k}{tag\\\i}{15pt}{align=center}] at (tag \i.\j) {};
2537 % \foreach \i in {theory circle, label above theory circle, label below theory circle, tag a life, tag a period, tag an event, theories, an information box, label an information box} \draw [help lines, draw=chronos@lliw@node, dashed] (\i.north east) -| (\i.south west) -| cycle;
2538 % \end{scope}
2539 % \end{chronos}%^^A
2540 % }%^^A
2541 % \mbox{\phantom{F}}\medskip\par
2542 % \caption{\pkg{chronos} anatomy: key coordinate and node names\label{fig:anatomi-coords}}
2543 %^^A \Undefine\bagpuss
2544 % \end{sidewaysfigure}
2545 %^^A \fi
2546 %
2547 %^^A END subsec:coords-nodes
2548 %
2549 % \subsection{Chronos Layers}\label{subsec:haenau}
2550 %^^A BEGIN subsec:haenau
2551 %
2552 % In addition to loading the \keyname[type=lib,no link]{\lib{backgrounds}} library, which defines the layer \keyname[type=layer,no link]{background}, and the default layer \keyname[type=layer,no link]{main}, \pkg{chronos} defines another four layers, for a total of six: \keyname[type=layer]{chronos background} and \keyname[type=layer]{chronos middle ground}, which are layered between \keyname[type=layer,no link,no idx]{background} and \keyname[type=layer,no link,no idx]{main}, and \keyname[type=layer]{chronos foreground} and \keyname[type=layer]{chronos overlay}, which are layered above \keyname[type=layer,no link,no idx]{main}.
2553 % From top to bottom:
2554 % \begin{itemize}[label=]
2555 % \item \chronosdochypertargets*{layer}{}{chronos overlay}
2556 % \item \chronosdochypertargets*{layer}{}{chronos foreground}
2557 % \item \keyname[type=layer,no link,no idx]{main}
2558 % \item \chronosdochypertargets*{layer}{}{chronos middle ground}
2559 % \item \chronosdochypertargets*{layer}{}{chronos background}
2560 % \item \keyname[type=layer,no link,no idx]{background}
2561 % \end{itemize}
2562 %
2563 % \Cref{sec:haenau-llunio} explains how to draw directly on different \layerslabelname{}.
2564 % You may wish to do this if you are using non-\pkg{chronos} code in the \conceptname[type=concept,no idx,link]{\meta{timeline additions specification}} or the facilities explained in \cref{sec:defer} for deferring code.
2565 %
2566 %^^A END subsec:haenau
2567 %
2568 %^^A END sec:anatomy
2569 %
2570 % \restoregeometry
2571 % \setlength\tewadjust{\marginparwidth+\marginparsep-\paperwidth+\textwidth+\oddsidemargin+1in}%
2572 % \fancyheadoffset[lh]{\tewadjust}%
2573 %^^A pam bo angen??!!
2574 % \pagestyle{fancy}
2575 % \thispagestyle{fancy}
2576 %
2577 % \section{Chronos Schemes and Styles}\label{sec:schemes-styles}
2578 %^^A BEGIN sec:schemes-styles
2579 %
2580 % Two simple methods for applying, defining and reusing \chronosstyleslabelname{} are provided: \chronosstyleslabelname{} and \colschemeslabelname{}.
2581 % If using both, load the \chronosstylelabelname{} first, since it may already load a \colschemeslabelname{}.
2582 %
2583 % \subsection{Chronos Styles}\label{subsec:chronos-styles}
2584 %^^A BEGIN subsec:chronos-styles
2585 %
2586 % By far the easiest way to customise a \conceptname[idx post=customisation]{timeline} is simply to load a \conceptname[type=concept]{chronos style} in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}.
2587 % This \namecref{subsec:chronos-styles} illustrates a basic \conceptname[no idx,no idx,link,link to=timeline]{timeline} typeset with each of \pkg{chronos}'s standard styles.
2588 %
2589 % \emph{Note that you will typically need to set \keyname[link,idx=false,type=datekey,link prefix=timeline/]{start date,end date} and perhaps adjust how often \conceptname[idx post=adjusting \string\textconcept{chronos style} defaults]{years,marks} appear on your \conceptname[no idx,no idx,link,link to=timeline]{timeline}.
2590 % \Chronosstyleslabelname{} such as \keylabelname[chronosstyle]{event splitter} set highly idiosyncratic dates by default, simply by way of example.
2591 % \pkg{chronos} will not warn you if you don't override options set by a \chronosstylelabelname{}.}
2592 %
2593 % In selecting a \chronosstylelabelname{}, bear in mind that some things are easy to change, while others are harder.
2594 % At a minimum, you should pick an ‘on line’ \chronosstylelabelname{} if you want \keyname[link,idx=false,type=choice,link prefix=timeline/]{timeline years} \texttt{on line} and an ‘off line’ one if you want them \texttt{above} or \texttt{below}.
2595 % \keyname[idx=false,link]{event years on line} requires an ‘on line’ \chronosstylelabelname; \keyname[idx=false,link,type=boolkey]{event dates split} is designed for an ‘off line’ one.
2596 %
2597 % You should also think about how much information you need to display.
2598 % \keyname[link,idx=false,type=chronosstyle]{date centric} won't work for a densely packed \conceptname[no idx,no idx,link,link to=timeline]{timeline}, so if you have a lot of things to pack in, don't choose this unless you're drawing an extremely long \conceptname[no idx,no idx,link,link to=timeline]{timeline}.
2599 % Likewise, \keyname[link,idx=false,type=chronosstyle]{cronoleg} will look rather silly if you only want to represent the lives of Socrates and Plato.
2600 %
2601 % \subsubsection{‘On Line’ Styles}\label{subsubsec:chronos-styles-on-line}\chronosdocidx[font=\normalfont,type=chronosstyle]{on line}
2602 %^^A BEGIN subsubsec:chronos-styles-on-line
2603 %
2604 % All ‘on line’ \styleslabelname{} are designed to support adding \elementslabelname{} both above and below the \conceptname[no idx,link,link to=timeline]{timeline}.
2605 % This includes the default settings.
2606 % See \cref{tab:chronosstyles,fig:rhag}.
2607 % \begin{figure}
2608 % \begin{adjustwidth}{-\tewadjust}{0pt}
2609 % \centering
2610 % \begin{chronos}%^^A = rhag ar ôl gwall
2611 % [
2612 % dates={1800-01-01}:{2050-12-31},
2613 % heading={heading}{chronos year 1800}{chronos year 1900},
2614 % heading={default with levels but no style}{chronos year 1950}{chronos year 2000},
2615 % subheading={upper subheading}{chronos year 1800}{chronos year 1900}{chronos upper subheadings},
2616 % subheading={lower subheading}{chronos year 1800}{chronos year 1900}{chronos lower subheadings},
2617 % levels=4:3,
2618 % ]
2619 % \chronoslife{dates={1810}:{1870},name=life above,at=u2 -| life above,}
2620 % \chronoslife{dates={1810}:{1870},name=life below,at=i2 -| life below,}
2621 % \chronoslife{dates={1975}:{2000},name=person above,at=u2 -| person above,}
2622 % \chronoslife{dates={1975}:{2000},name=person below,at=i2 -| person below,}
2623 % \chronosperiod{dates={1925}:{1950},name=period above,at=u2 -| period above,xshift=-10pt,tag anchor=east}
2624 % \chronosperiod{dates={1925}:{1950},name=period below,at=i2 -| period below,}
2625 % \chronosevent{date={2025},name=event above,at=u4 -| event above,xshift=-10pt,tag anchor=east}
2626 % \chronosevent{date={2025},name=event below,at=i3 -| event below,}
2627 % \end{chronos}
2628 % \caption{\Chronosstylelabelname{}: none.}\label{fig:rhag}
2629 % \end{adjustwidth}
2630 % \end{figure}
2631 %
2632 % \DescribeChronosstyle{cronoleg}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{cronoleg}The most developed and best tested, if somewhat idiosyncratic, \chronosstylelabelname{}, based on the code used to construct my Western Philosophy Timeline.
2633 % It constructs a 235mm \conceptname[no idx,link,link to=timeline]{timeline} and uses a \colschemelabelname{} highlighting \elementslabelname{} of type \conceptname[type=tag,idx post=highlighted by \string\textconcept{colour scheme} in \string\textkey{chronoleg}\string\idxeg]{life}, but the colours may be adjusted or the same colour scheme applied to \conceptname[type=tag,idx post=effect of \string\textconcept{colour scheme} in \string\textkey{chronoleg}\string\idxeg]{event,period} as well.
2634 % By default, it is designed to produce a picture occupying an entire A4 page and has a wide right-hand margin for additional \elementslabelname{}, in addition to ten \conceptname[idx post=cronoleg\string\idxeg,idx font post=\KeyFont]{levels} above and below the \conceptname[no idx,link,link to=timeline]{timeline}.
2635 % See \cref{tab:chronosstyles,fig:cronoleg}.
2636 % \begin{figure}
2637 % \thisfloatpagestyle{empty}%
2638 % \begin{adjustwidth}{-\tewadjust}{0pt}
2639 % \centering
2640 % \thispagestyle{empty}%
2641 % \chronosdoctroibocs{-90}{0pt}{.9\textheight}{%^^A
2642 % \begin{chronos}
2643 % [
2644 % cronoleg,
2645 % rotate all colours,
2646 % heading={heading}{chronos year 400}{chronos year 500},
2647 % subheading={upper subheading}{chronos year 400}{chronos year 500}{chronos upper subheadings},
2648 % subheading={lower subheading}{chronos year 400}{chronos year 500}{chronos lower subheadings},
2649 % ]
2650 % \chronoslife{dates={-400}:{-325},name=life above,at=u2 -| life above,xshift=10pt,tag anchor=west}
2651 % \chronoslife{dates={-400}:{-325},name=life below,at=i2 -| life below,xshift=10pt,tag anchor=west}
2652 % \chronoslife{dates={-500}:{-425},name=person above,at=u3 -| person above,xshift=10pt,tag anchor=west}
2653 % \chronoslife{dates={-500}:{-425},name=person below,at=i3 -| person below,xshift=10pt,tag anchor=west}
2654 % \chronosperiod{dates={-100}:{125},name=period above,at=u1 -| period above,xshift=-10pt,tag anchor=east}
2655 % \chronosperiod{dates={-100}:{125},name=period below,at=i1 -| period below,xshift=-10pt,tag anchor=east}
2656 % \chronosevent{date={250},name=event above,at=u2 -| event above,xshift=-10pt,tag anchor=east}
2657 % \chronosevent{date={250},name=event below,at=i2 -| event below,xshift=-10pt,tag anchor=east}
2658 % \chronosmaintitle{name=cronoleg,at=u8 -| chronos year -200}
2659 % \end{chronos}}
2660 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{cronoleg}.}\label{fig:cronoleg}
2661 % \end{adjustwidth}
2662 % \end{figure}
2663 % By default, this \chronosstylelabelname{} does \emph{not} use the bounding box for the \conceptname[link,link to=main/frame,idx post=cronoleg \string\textnormal{as not using bounding box for}\string\idxeg,idx font post=\KeyFont]{frame}.
2664 %
2665 % \newcolumntype{H}{>{\raggedright}X}
2666 % \begin{table}
2667 % \begin{adjustwidth}{-\tewadjust}{0pt}
2668 % \centering
2669 % \caption{Summary of \chronosstyleslabelname.}\label{tab:chronosstyles}
2670 % \chronosdocidx[type=chronosstyle,font=\normalfont]{list of}
2671 % \begin{tabularx}\linewidth{>{\ttfamily}l>{\ttfamily}H>{\ttfamily}lHlcc}
2672 % \toprule
2673 % & & \multicolumn{4}{c}{\sffamily Defaults} \\\cmidrule(lr){3-7}
2674 % \sffamily Name & \sffamily Timeline Year Style & \textsf{Levels} & \textsf{Dates} & \textsf{Colour Scheme} & \sffamily Rotation & \sffamily Arrow \\ \toprule
2675 % -- & on line & 0:0 & 1800--2050\,\ce{} & default & \fycheck{} & \fycross{} \\
2676 % \keyname[type=chronosstyle,idx post=features (summary)]{cronoleg} & on line & 10:10 & 500\,\bce{}--2050\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{cronoleg}]{cronoleg} & \fycheck{} & \fycross{} \\
2677 % \keyname[type=chronosstyle,idx post=features (summary)]{date centric} & [on line] & \fycross{} & 1935--2010\,\ce{} & default & \fycross{} & \fycross{} \\
2678 % \keyname[type=chronosstyle,idx post=features (summary)]{lavender menace} & on line & 3:3 & 1500--1900\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{lavender menace}]{lavender}+\texttt{chronosSilver} & \fycheck{} & \fycross{} \\
2679 % \keyname[type=chronosstyle,idx post=features (summary)]{modern} & on line & 3:3 & 1500--1900\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{modern}]{modern} & \fycross{} & \fycross{} \\
2680 % \keyname[type=chronosstyle,idx post=features (summary)]{rainbow serif} & on line & 3:3 & 1500--2100\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{rainbow serif}]{xcolseries} & \fycheck{} & \fycross{} \\
2681 % \keyname[type=chronosstyle,idx post=features (summary)]{serif on line} & on line & 3:3 & 1800--1900\,\ce{} & default & \fycross{} & \fycross{} \\
2682 % \keyname[type=chronosstyle,idx post=features (summary)]{sober judge} & on line & 3:3 & 1/10/1001--14/6/1003\,\ce{} & default & \fycross{} & \fycross{} \\
2683 % \cmidrule(lr){1-7}
2684 % \keyname[type=chronosstyle,idx post=features (summary)]{blues below} & off line, below & 0:3 & 1550--2050\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{blues below}]{blues} & \fycheck{} & \fycheck{} \\
2685 % \keyname[type=chronosstyle,idx post=features (summary)]{flipping blues} & off line, above & 3:0 & 1550--2050\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{flipping blues}]{blues} & \fycheck{} & \fycheck{} \\
2686 % \keyname[type=chronosstyle,idx post=features (summary)]{contemporary 90} & off line, above & 0:3 & 2002-2016\,\ce{} & \keyname[type=colscheme,idx post=use by \string\texttt{contemporary 90}]{contninety} & \fycross{} & \fycheck{} \\
2687 % \keyname[type=chronosstyle,idx post=features (summary)]{off line colour} & off line, below & \fycross{} & 3000--2000\,\bce{} & \keyname[type=colscheme,idx post=use by \string\texttt{off line colour}]{offlinebasic} & \fycheck{} & \fycheck{} \\
2688 % \keyname[type=chronosstyle,idx post=features (summary)]{off line colour alt} & off line, below & \fycross{} & 3000--2000\,\bce{} & \keyname[type=colscheme,idx post=use by \string\texttt{off line colour alt}]{offlinealt} & \fycheck & \fycheck \\
2689 % \keyname[type=chronosstyle,idx post=features (summary)]{off line simple} & off line, below & \fycross{} & 3000--2000\,\bce{} & \keyname[type=colscheme,idx post=use by \string\texttt{off line simple}]{offlinebasic} & \fycross{} & \fycheck{} \\
2690 % \keyname[type=chronosstyle,idx post=features (summary)]{rotated 45} & off line, above & \fycross{} & 25\,\bce{}--20\,\ce{} & default & \fycross & \fycross \\
2691 % \keyname[type=chronosstyle,idx post=features (summary)]{simple arrow} & off line, above & \fycross{} & 1--2000\,\ce{} & default & \fycross{} & \fycheck{} \\
2692 % \keyname[type=chronosstyle,idx post=features (summary)]{somewhat plain} & off line, above & 0:3 & 500\,\bce{}--2050\,\ce{} & default & \fycross & \fycross{} \\
2693 % \cmidrule(lr){1-7}
2694 % \keyname[type=chronosstyle,idx post=features (summary)]{event splitter} & [above] & \fycross{} & 01/13--02/22/2014\,\ce{} & default & \fycross{} & \fycross{} \\
2695 % \keyname[type=chronosstyle,idx post=features (summary)]{lines on line} & none & \fycross{} & 1--2016\,\ce{} & default & \fycheck{} & \fycheck{} \\
2696 % \keyname[type=chronosstyle,idx post=features (summary)]{plain arrow} & none & \fycross{} & 1--2016\,\ce{} & default & \fycheck{} & \fycheck{} \\
2697 % \bottomrule
2698 % \end{tabularx}
2699 % \end{adjustwidth}
2700 % \end{table}
2701 %
2702 % \DescribeChronosstyle{date centric}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{date centric}A \chronosstylelabelname{} with a monochrome appearance and sans-serif fonts of 150mm\texseans{324448}.
2703 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} highlighting relatively few dates.
2704 % See \cref{tab:chronosstyles,fig:date-centric}.
2705 % \begin{figure}
2706 % \begin{adjustwidth}{-\tewadjust}{0pt}
2707 % \centering
2708 % \captionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{date centric}.\label{fig:date-centric}}{%^^A ateb: https://tex.stackexchange.com/a/324448/
2709 % \begin{chronos}
2710 % [
2711 % date centric,
2712 % ]
2713 % \chronosevent {date={2001},name=The \emph{Mr.~Men}\\Celebrate their 30\textsuperscript{th}\\Anniversary,as is,yshift=10pt,event year on line skip}
2714 % \chronosevent {date={2000},name=vouchers replace\\cash support for\\asylum seekers}
2715 % \chronosevent {date={1988},name=section 28 prevents state\\schools `promoting homosexuality',yshift=55pt}
2716 % \chronosevent {date={1984},name=miners' strike ends}
2717 % \chronosevent {date={1979},name=labour government\\falls \& thatcher\\wins power,yshift=10pt}
2718 % \chronosevent {date={1942},special date=WWII,name=people discover\\some stuff\\\& lots of people\\get killed}
2719 % \chronosmaintitle {name=date centric, at=current bounding box.north west,anchor=north west}
2720 % \end{chronos}}
2721 % \end{adjustwidth}
2722 % \end{figure}
2723 % This \stylelabelname{} demonstrates the use of \keyname[idx=false,link]{event years on line,special date}.
2724 %
2725 % \DescribeChronosstyle{lavender menace}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{lavender menace}A variant of \keyname[link,idx=false,type=chronosstyle]{modern} with a muted colour scheme and sans-serif fonts.
2726 % By default, it produces a \conceptname[no idx,link,link to=timeline]{timeline} covering the modern era (1500--1900\,\ce{}).
2727 % See \cref{tab:chronosstyles,subfig:lavender-menace}.
2728 % \begin{figure}
2729 % \begin{adjustwidth}{-\tewadjust}{0pt}
2730 % \centering
2731 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{lavender menace}\label{subfig:lavender-menace}}{\begin{chronos}
2732 % [
2733 % lavender menace,
2734 % heading={heading}{chronos year 1800}{chronos year 1900},
2735 % subheading={upper subheading}{chronos year 1700}{chronos year 1900}{chronos upper subheadings},
2736 % subheading={lower subheading}{chronos year 1700}{chronos year 1900}{chronos lower subheadings},
2737 % ]
2738 % \chronoslife{dates={1750}:{1800},name=life above,at=u2 -| life above}
2739 % \chronoslife{dates={1750}:{1800},name=life below,at=i2 -| life below,}
2740 % \chronoslife{dates={1650}:{1700},name=person above,at=u2 -| person above,}
2741 % \chronoslife{dates={1650}:{1700},name=person below,at=i2 -| person below,}
2742 % \chronosperiod{dates={1850}:{1900},name=period above,at=u3 -| period above,}
2743 % \chronosperiod{dates={1850}:{1900},name=period below,at=i3 -| period below,}
2744 % \chronosevent{date={1550},name=event above,at=u1 -| event above,}
2745 % \chronosevent{date={1550},name=event below,at=i1 -| event below,}
2746 % \chronosmaintitle{name=lavender menace,at=chronos pre |- current bounding box.north, anchor=west}
2747 % \end{chronos}}
2748 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{modern}\label{subfig:modern}}{%^^A
2749 % \begin{chronos}
2750 % [
2751 % modern,
2752 % heading={heading}{chronos year 1500}{chronos year 1900},
2753 % subheading={upper subheading}{chronos year 1500}{chronos year 1900}{chronos upper subheadings},
2754 % subheading={lower subheading}{chronos year 1500}{chronos year 1900}{chronos lower subheadings},
2755 % ]
2756 % \chronoslife{dates={1750}:{1800},name=life above,at=u2 -| life above,}
2757 % \chronoslife{dates={1750}:{1800},name=life below,at=i2 -| life below,}
2758 % \chronoslife{dates={1650}:{1700},name=person above,at=u2 -| person above,}
2759 % \chronoslife{dates={1650}:{1700},name=person below,at=i2 -| person below,}
2760 % \chronosperiod{dates={1850}:{1900},name=period above,at=u3 -| period above,}
2761 % \chronosperiod{dates={1850}:{1900},name=period below,at=i3 -| period below,}
2762 % \chronosevent{date={1550},name=event above,at=u1 -| event above,}
2763 % \chronosevent{date={1550},name=event below,at=i1 -| event below,}
2764 % \chronosmaintitle{name=modern,at=chronos year 1550 |- current bounding box.north}
2765 % \end{chronos}}
2766 % \caption{\Cref{subfig:lavender-menace} is a variant of \cref{subfig:modern}.}\label{fig:modern-lavender-menace}
2767 % \end{adjustwidth}
2768 % \end{figure}
2769 % \DescribeChronosstyle{modern}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{modern}A \chronosstylelabelname{} with a monochrome appearance and sans-serif fonts.
2770 % By default, it produces a \conceptname[no idx,link,link to=timeline]{timeline} covering the modern era (1500--1900\,\ce{}).
2771 % See \cref{tab:chronosstyles,subfig:modern}.
2772 %
2773 %
2774 % \DescribeChronosstyle{rainbow serif}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{rainbow serif}A colourful variant of \keyname[link,idx=false,type=chronosstyle]{serif on line} utilising \pkg{xcolor} colour series and serif fonts.
2775 % See \cref{tab:chronosstyles,subfig:rainbow-serif}.
2776 % \begin{figure}
2777 % \begin{adjustwidth}{-\tewadjust}{0pt}
2778 % \centering
2779 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{rainbow serif}.\label{subfig:rainbow-serif}}
2780 % {\begin{chronos}
2781 % [
2782 % rainbow serif,
2783 % heading={heading}{chronos year 1800}{chronos year 1900},
2784 % subheading={upper subheading}{chronos year 1800}{chronos year 1900}{chronos upper subheadings},
2785 % subheading={lower subheading}{chronos year 1800}{chronos year 1900}{chronos lower subheadings},
2786 % ]
2787 % \chronoslife{dates={1850}:{1870},name=life above,at=u2 -| life above,xshift=10pt,tag anchor=west}
2788 % \chronoslife{dates={1850}:{1870},name=life below,at=i2 -| life below,xshift=10pt, tag anchor=west}
2789 % \chronoslife{dates={1875}:{1900},name=person above,at=u1 -| person above,xshift=10pt,tag anchor=west}
2790 % \chronoslife{dates={1875}:{1900},name=person below,at=i1 -| person below,xshift=10pt,tag anchor=west}
2791 % \chronosperiod{dates={1825}:{1850},name=period above,at=u2 -| period above,xshift=-10pt,tag anchor=east}
2792 % \chronosperiod{dates={1825}:{1850},name=period below,at=i2 -| period below,xshift=-10pt,tag anchor=east}
2793 % \chronosevent{date={1800},name=event above,at=u1 -| event above,xshift=-10pt,tag anchor=east}
2794 % \chronosevent{date={1800},name=event below,at=i1 -| event below,xshift=-10pt,tag anchor=east}
2795 % \chronosmaintitle{name=rainbow serif,name content={\color{xcolor g2!!+}R\color{xcolor g2!!+}A\color{xcolor g2!!+}I\color{xcolor g2!!+}N\color{xcolor g2!!+}B\color{xcolor g2!!+}O\color{xcolor g2!!+}W \color{xcolor g2!!+}S\color{xcolor g2!!+}E\color{xcolor g2!!+}R\color{xcolor g2!!+}I\color{xcolor g2!!+}F},at=current bounding box.north west,anchor=south west}
2796 % \end{chronos}}
2797 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{serif on line}.\label{subfig:serif-on-line}}
2798 % {\begin{chronos}
2799 % [
2800 % serif on line,
2801 % heading={heading}{chronos year 1800}{chronos year 1900},
2802 % subheading={upper subheading}{chronos year 1800}{chronos year 1900}{chronos upper subheadings},
2803 % subheading={lower subheading}{chronos year 1800}{chronos year 1900}{chronos lower subheadings},
2804 % ]
2805 % \chronoslife{dates={1850}:{1870},name=life above,at=u2 -| life above,xshift=10pt,tag anchor=west}
2806 % \chronoslife{dates={1850}:{1870},name=life below,at=i2 -| life below}
2807 % \chronoslife{dates={1875}:{1900},name=person above,at=u3 -| person above,xshift=-10pt,tag anchor=east}
2808 % \chronoslife{dates={1875}:{1900},name=person below,at=i2 -| person below}
2809 % \chronosperiod{dates={1825}:{1850},name=period above,at=u2 -| period above,xshift=-10pt,tag anchor=east}
2810 % \chronosperiod{dates={1825}:{1850},name=period below,at=i2 -| period below}
2811 % \chronosevent{date={1800},name=event above,at=u3 -| event above,xshift=10pt,tag anchor=west}
2812 % \chronosevent{date={1800},name=event below,at=i2 -| event below}
2813 % \chronosmaintitle{name=serif On line,at=current bounding box.north west,anchor=south west}
2814 % \end{chronos}}
2815 % \caption{\Cref{subfig:rainbow-serif} is a variant of \cref{subfig:serif-on-line}.}\label{fig:rainbow-serif-on-line}
2816 % \end{adjustwidth}
2817 % \end{figure}
2818 %
2819 % \DescribeChronosstyle{serif on line}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{serif on line}A \chronosstylelabelname{} with a monochrome appearance and serif fonts.
2820 % See \cref{tab:chronosstyles,subfig:serif-on-line}.
2821 %
2822 % \DescribeChronosstyle{sober judge}\chronosdocidx[symbol=eg,idx pre=on line,type=chronosstyle]{sober judge}A somewhat subdued \chronosstylelabelname{} with a monochrome appearance, sans-serif fonts and boxed \conceptname[idx as=text tag,idx post=sober judge\string\idxeg,idx font post=\KeyFont]{text tags}.
2823 % See \cref{tab:chronosstyles,fig:sober-judge}.
2824 % \begin{figure}
2825 % \centering
2826 % \begin{chronos}
2827 % [
2828 % sober judge,
2829 % heading={heading}{chronos year 1002}{chronos year 1003},
2830 % subheading={upper subheading}{chronos year 1002}{chronos year 1003}{chronos upper subheadings},
2831 % subheading={lower subheading}{chronos year 1002}{chronos year 1003}{chronos lower subheadings},
2832 % ]
2833 % \chronoslife{dates={1002}:{1003-06-01},name=life above,at=u1 -| life above}
2834 % \chronoslife{dates={1002}:{1003-06-01},name=life below,at=i2 -| life below}
2835 % \chronoslife{dates={1002-02-03}:{1003-02-01},name=person above,at=u2 -| person above}
2836 % \chronoslife{dates={1002-04-05}:{1003-01-01},name=person below,at=i3 -| person below}
2837 % \chronosperiod{dates={1003}:{1003-05-01},name=period above,at=u1 -| period above}
2838 % \chronosperiod{dates={1003-02-12}:{1003-03-01},name=period below,at=i1 -| period below}
2839 % \chronosevent{date={1002-01-15},name=event above,at=u2 -| event above}
2840 % \chronosevent{date={1001-12-24},name=event below,at=i2 -| event below}
2841 % \chronosmaintitle{name=sober judge,at=current bounding box.north west,anchor=south west}
2842 % \end{chronos}
2843 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{sober judge}.}\label{fig:sober-judge}
2844 % \end{figure}
2845 %
2846 %^^A END subsubsec:chronos-styles-on-line
2847 %
2848 % \subsubsection{‘Off Line’ Styles}\label{subsubsec:chronos-styles-off-line}\chronosdocidx[font=\normalfont,type=chronosstyle]{off line}
2849 %^^A BEGIN subsubsec:chronos-styles-off-line
2850 %
2851 % \DescribeChronosstyle{blues below}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{blues below}A \chronosstylelabelname{} featuring the \keyname[link,idx=false,type=colscheme]{blues} \colschemelabelname{}, off-set \conceptname[idx as=line,idx post=blues below\string\idxeg,idx font post=\KeyFont]{lines} and \conceptname[idx post=blues below\string\idxeg,idx font post=\KeyFont]{year} labels rotated through 45\textdegree{}.
2852 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} below.
2853 % See \cref{tab:chronosstyles,subfig:blues-below}.
2854 % \begin{figure}
2855 % \begin{adjustwidth}{-\tewadjust}{0pt}
2856 % \centering
2857 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{blues below}.\label{subfig:blues-below}}
2858 % {\begin{chronos}
2859 % [
2860 % blues below,
2861 % heading={heading}{chronos year 1600}{chronos year 1700},
2862 % subheading={upper subheading}{chronos year 1600}{chronos year 1700}{chronos upper subheadings},
2863 % subheading={lower subheading}{chronos year 1600}{chronos year 1700}{chronos lower subheadings},
2864 % ]
2865 % \chronoslife{dates={1750}:{1800},name=life below,at=i2 -| life below,}
2866 % \chronoslife{dates={1650}:{1700},name=person below,at=i3 -| person below,}
2867 % \chronosperiod{dates={1950}:{2000},name=period below,at=i1 -| period below,}
2868 % \chronosevent{date={1550},name=event below,at=i2 -| event below,}
2869 % \chronosmaintitle{name=blues below,at=current bounding box.south east,anchor=south east}
2870 % \end{chronos}}
2871 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{flipping blues}.\label{subfig:flipping-blues}}
2872 % {\begin{chronos}
2873 % [
2874 % flipping blues,
2875 % heading={heading}{chronos year 1600}{chronos year 1700},
2876 % subheading={upper subheading}{chronos year 1600}{chronos year 1700}{chronos upper subheadings},
2877 % subheading={lower subheading}{chronos year 1600}{chronos year 1700}{chronos lower subheadings},
2878 % ]
2879 % \chronoslife{dates={1750}:{1800},name=life above,at=u2 -| life above,}
2880 % \chronoslife{dates={1650}:{1700},name=person above,at=u3 -| person above,}
2881 % \chronosperiod{dates={1950}:{2000},name=period above,at=u1 -| period above,}
2882 % \chronosevent{date={1550},name=event above,at=u2 -| event above,}
2883 % \chronosmaintitle{name=flipping blues, at=u3 -| chronos post,anchor=south east}
2884 % \end{chronos}}
2885 % \caption{\Cref{subfig:flipping-blues} is a variant of \cref{subfig:blues-below}.}\label{fig:blues}
2886 % \end{adjustwidth}
2887 % \end{figure}
2888 % This \stylelabelname{} demonstrates how to rotate \conceptname[idx post={labels, rotated\string\idxeg}]{year} labels.
2889 %
2890 % \DescribeChronosstyle{contemporary 90}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{contemporary 90}A \chronosstylelabelname{} with a monochrome appearance, sans-serif fonts and rotated year labels, which produces a relatively short \conceptname[no idx,link,link to=timeline]{timeline} of 90mm by default.
2891 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} below.
2892 % See \cref{tab:chronosstyles,fig:contemporary90}.
2893 % \begin{figure}
2894 % \begin{adjustwidth}{-\tewadjust}{0pt}
2895 % \centering
2896 % \begin{chronos}
2897 % [
2898 % contemporary 90,
2899 % heading={heading}{chronos year 2004}{chronos year 2010},
2900 % subheading={upper subheading}{chronos year 2004}{chronos year 2010}{chronos upper subheadings},
2901 % subheading={lower subheading}{chronos year 2004}{chronos year 2010}{chronos lower subheadings},
2902 % ]
2903 % \chronoslife{dates={2002}:{2008},name=life below,at=i2 -| life below,}
2904 % \chronoslife{dates={2010}:{2014},name=person below,at=i2 -| person below,}
2905 % \chronosperiod{dates={2015}:{2016},name=period below,at=i1 -| period below,}
2906 % \chronosevent{date={2009},name=event below,at=i1 -| event below,}
2907 % \chronosmaintitle{name=contemporary 90,at=current bounding box.south west,anchor=north west},
2908 % \end{chronos}
2909 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{contemporary 90}.}\label{fig:contemporary90}
2910 % \end{adjustwidth}
2911 % \end{figure}
2912 %
2913 % \DescribeChronosstyle{flipping blues}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{flipping blues}A variation of \keyname[link,idx=false,type=chronosstyle]{blues below} featuring \conceptname[idx post={labels, rotated\string\idxeg}]{year} labels rotated through -45\textdegree{}.
2914 % Intended for \conceptname[idx as=timeline,,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} above.
2915 % See \cref{tab:chronosstyles,subfig:flipping-blues}.
2916 % This \stylelabelname{} demonstrates how to utilise an existing \chronosstylelabelname{} to produce a variant.
2917 %
2918 % \DescribeChronosstyle{off line colour}\val{length}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{off line colour}\AfterLastParam
2919 % A straightforward style utilising scientific dates in which the \conceptname[no idx,link,link to=timeline/timeline line]{line} tapers to form an arrow.
2920 % Intended for \conceptname[idx as=timeline,,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} above and/or below.
2921 % The optional \meta{length} specifies the length of the tapering.
2922 % \Default{20mm}
2923 % See \cref{tab:chronosstyles,subfig:off-line-col}.
2924 % \begin{figure}
2925 % \begin{adjustwidth}{-\tewadjust}{0pt}
2926 % \centering
2927 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{off line colour}.\label{subfig:off-line-col}}
2928 % {%^^A
2929 % \begin{chronos}
2930 % [
2931 % off line colour,
2932 % ]
2933 % \chronosevent {date={-2080},name=im15 (c),yshift=60pt}
2934 % \chronosevent {date={-2115},name=im13 (c),yshift=-80pt}
2935 % \chronosevent {date={-2115},name=im26 (b),yshift=20pt}
2936 % \chronosevent {date={-2170},name=im20 (b),yshift=100pt}
2937 % \chronosevent {date={-2190},name=iiim76 (e),yshift=-120pt}
2938 % \chronosevent {date={-2200},name=iiim353 (c),yshift=70pt}
2939 % \chronosevent {date={-2245},name=iim69 (c),yshift=30pt}
2940 % \chronosevent {date={-2250},name=iim281 (c),yshift=-70pt}
2941 % \chronosevent {date={-2145},name=im10 (b),yshift=-50pt}
2942 % \chronosevent {date={-2240},name=iim163 (c),yshift=-30pt}
2943 % \chronosevent {date={-2475},name=im90 (c),yshift=-70pt}
2944 % \chronosevent {date={-2480},name=im90 (b),yshift=20pt}
2945 % \chronosevent {date={-2500},name=iim63 (c),yshift=-20pt}
2946 % \chronosevent {date={-2550},name=im21 (a),yshift=70pt}
2947 % \chronosevent {date={-2570},name=im163 (b),yshift=-50pt}
2948 % \chronosevent {date={-2620},name=iim13 (c),yshift=30pt}
2949 % \chronosevent {date={-2690},name=im5 (b),yshift=-40pt}
2950 % \chronosevent {date={-2760},name=im130 (b),yshift=40pt}
2951 % \chronosevent {date={-2770},name=im65 (c),yshift=-15pt}
2952 % \chronosevent {date={-2935},name=im157 (r)}
2953 % \chronosmaintitle{name=off line colour,at=current bounding box.north west,anchor=north west}
2954 % \end{chronos}%^^A
2955 % }
2956 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{off line colour alt}.\label{subfig:off-line-col-alt}}
2957 % {%^^A
2958 % \begin{chronos}
2959 % [
2960 % off line colour alt,
2961 % ]
2962 % \chronosevent {date={-2080},name=im15 (c),yshift=60pt}
2963 % \chronosevent {date={-2115},name=im13 (c),yshift=-80pt}
2964 % \chronosevent {date={-2115},name=im26 (b),yshift=20pt}
2965 % \chronosevent {date={-2170},name=im20 (b),yshift=100pt}
2966 % \chronosevent {date={-2190},name=iiim76 (e),yshift=-120pt}
2967 % \chronosevent {date={-2200},name=iiim353 (c),yshift=70pt}
2968 % \chronosevent {date={-2245},name=iim69 (c),yshift=30pt}
2969 % \chronosevent {date={-2250},name=iim281 (c),yshift=-70pt}
2970 % \chronosevent {date={-2145},name=im10 (b),yshift=-50pt}
2971 % \chronosevent {date={-2240},name=iim163 (c),yshift=-30pt}
2972 % \chronosevent {date={-2475},name=im90 (c),yshift=-70pt}
2973 % \chronosevent {date={-2480},name=im90 (b),yshift=20pt}
2974 % \chronosevent {date={-2500},name=iim63 (c),yshift=-20pt}
2975 % \chronosevent {date={-2550},name=im21 (a),yshift=70pt}
2976 % \chronosevent {date={-2570},name=im163 (b),yshift=-50pt}
2977 % \chronosevent {date={-2620},name=iim13 (c),yshift=30pt}
2978 % \chronosevent {date={-2690},name=im5 (b),yshift=-40pt}
2979 % \chronosevent {date={-2760},name=im130 (b),yshift=40pt}
2980 % \chronosevent {date={-2770},name=im65 (c),yshift=-15pt}
2981 % \chronosevent {date={-2935},name=im157 (r)}
2982 % \chronosmaintitle{name=off line colour alt,at=current bounding box.north west,anchor=north west}
2983 % \end{chronos}%^^A
2984 % }
2985 % \caption{\Cref{subfig:off-line-col-alt,subfig:off-line-simple} are variants of \cref{subfig:off-line-col}.}\label{fig:off-line-3}
2986 % \end{adjustwidth}
2987 % \end{figure}
2988 % \begin{figure}
2989 % \ContinuedFloat
2990 % \begin{adjustwidth}{-\tewadjust}{0pt}
2991 % \centering
2992 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{off line simple}.\label{subfig:off-line-simple}}
2993 % {%^^A
2994 % \begin{chronos}
2995 % [
2996 % off line simple,
2997 % ]
2998 % \chronosevent {date={-2080},name=im15 (c),yshift=60pt}
2999 % \chronosevent {date={-2115},name=im13 (c),yshift=-80pt}
3000 % \chronosevent {date={-2115},name=im26 (b),yshift=20pt}
3001 % \chronosevent {date={-2170},name=im20 (b),yshift=100pt}
3002 % \chronosevent {date={-2190},name=iiim76 (e),yshift=-120pt}
3003 % \chronosevent {date={-2200},name=iiim353 (c),yshift=70pt}
3004 % \chronosevent {date={-2245},name=iim69 (c),yshift=30pt}
3005 % \chronosevent {date={-2250},name=iim281 (c),yshift=-70pt}
3006 % \chronosevent {date={-2145},name=im10 (b),yshift=-50pt}
3007 % \chronosevent {date={-2240},name=iim163 (c),yshift=-30pt}
3008 % \chronosevent {date={-2475},name=im90 (c),yshift=-70pt}
3009 % \chronosevent {date={-2480},name=im90 (b),yshift=20pt}
3010 % \chronosevent {date={-2500},name=iim63 (c),yshift=-20pt}
3011 % \chronosevent {date={-2550},name=im21 (a),yshift=70pt}
3012 % \chronosevent {date={-2570},name=im163 (b),yshift=-50pt}
3013 % \chronosevent {date={-2620},name=iim13 (c),yshift=30pt}
3014 % \chronosevent {date={-2690},name=im5 (b),yshift=-40pt}
3015 % \chronosevent {date={-2760},name=im130 (b),yshift=40pt}
3016 % \chronosevent {date={-2770},name=im65 (c),yshift=-15pt}
3017 % \chronosevent {date={-2935},name=im157 (r)}
3018 % \chronosmaintitle{name=off line simple,at=current bounding box.north west,anchor=north west}
3019 % \end{chronos}%^^A
3020 % }
3021 % \caption{\Cref{subfig:off-line-col,subfig:off-line-simple} are variants of \cref{subfig:off-line-col-alt}.}
3022 % \end{adjustwidth}
3023 % \end{figure}
3024 % This \stylelabelname{} demonstrates the use of \keyname[type=layer,link to=chronos middle ground]{chronos middle ground layer} to reduce visual clutter where \conceptname[idx as=connection,idx post=reducing visual clutter]{connections} cross \conceptname[idx post=in \string\textkey{off line colour}\string\idxeg]{timeline marks}.
3025 % Although the \conceptname[idx as=connection,idx post=on \string\textkey{chronos middle ground layer}]{connections} are drawn after the \conceptname[no idx,link,link to=timeline]{timeline}, they are placed on a lower \layerlabelname{}, with a partially transparent rectangle in between.
3026 %
3027 % \DescribeChronosstyle{off line colour alt}\val{length}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{off line colour alt}\AfterLastParam
3028 % A variant of \keyname[link,idx=false,type=chronosstyle]{off line colour} which uses a different \colschemelabelname{}.
3029 % \Default{20mm}
3030 % See \cref{tab:chronosstyles,subfig:off-line-col-alt}.
3031 %
3032 % \DescribeChronosstyle{off line simple}\val{length}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{off line simple}\AfterLastParam
3033 % A less colourful variant of \keyname[link,idx=false,type=chronosstyle]{off line colour} utilising only two colours\texseans[%^^A
3034 % In fact, this version is closest to the original.
3035 % See]{324106}.
3036 % \Default{20mm}
3037 % See \cref{tab:chronosstyles,subfig:off-line-simple}.
3038 %
3039 % \DescribeChronosstyle{rotated 45}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{rotated 45}A \chronosstylelabelname{} featuring the off-set \conceptname[idx as=line,idx post=rotated 45\string\idxeg,idx font post=\KeyFont]{lines} and \conceptname[idx as=\meta{tag}/text tag,idx post=rotated]{text tags} rotated through 45\textdegree{}.
3040 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} below.
3041 % See \cref{tab:chronosstyles,fig:rotated45}.
3042 % \begin{figure}
3043 % \begin{adjustwidth}{-\tewadjust}{0pt}
3044 % \centering
3045 % \begin{chronos}
3046 % [
3047 % rotated 45,
3048 % heading={heading}{chronos year -20}{chronos year 15},
3049 % subheading={upper subheading}{chronos year -20}{chronos year 15}{chronos upper subheadings},
3050 % subheading={lower subheading}{chronos year -20}{chronos year 15}{chronos lower subheadings},
3051 % ]
3052 % \chronoslife{dates={-25}:{3},name=life below,}
3053 % \chronoslife{dates={-5}:{10},name=person below,}
3054 % \chronosperiod{dates={-1}:{11},name=period below,}
3055 % \chronosevent{date={18},name=event below,}
3056 % \chronosmaintitle{name=rotated 45, at=current bounding box.south west,anchor=base west}
3057 % \end{chronos}
3058 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{rotated 45}.}\label{fig:rotated45}
3059 % \end{adjustwidth}
3060 % \end{figure}
3061 % This \stylelabelname{} demonstrates how to rotate \conceptname[idx as=\meta{tag}/text tag,idx post=rotated\string\idxeg]{text tags}.
3062 %
3063 % \DescribeChronosstyle{simple arrow}\val{length}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{simple arrow}\AfterLastParam
3064 % A monochrome appearance with a plain 200mm arrow \conceptname[no idx,link]{timeline} and \conceptname[idx post=in \string\textkey{simple arrow}\string\idxeg]{years,marks} above\texseans{342699}.
3065 % \meta{length} determines the length of the taper comprising the arrow.
3066 % \Default{10mm}
3067 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} below.
3068 % See \cref{tab:chronosstyles,fig:simple-arrow}.
3069 % \begin{figure}
3070 % \begin{adjustwidth}{-\tewadjust}{0pt}
3071 % \centering \chronosdoctroibocs{0}{0pt}{*}{%^^A
3072 % \begin{chronos}
3073 % [%^^A ateb: https://tex.stackexchange.com/a/342699/
3074 % simple arrow,
3075 % heading={heading}{chronos year 1}{chronos year 1000},
3076 % subheading={upper subheading}{chronos year 1}{chronos year 500}{chronos upper subheadings},
3077 % subheading={lower subheading}{chronos year 1}{chronos year 750}{chronos lower subheadings},
3078 % ]
3079 % \chronosperiod {dates={476-01-01}:{476-10-31},name=period,line+={draw=gray}}
3080 % \chronosevent {date={1492-10-11},name=event}
3081 % \chronoslife {dates={1969-07-21}:{2010-08-24},name=life}
3082 % \chronosmaintitle{name=simple\\arrow, at=current bounding box.south west,anchor=south west}
3083 % \end{chronos}
3084 % }%
3085 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{simple arrow}.}\label{fig:simple-arrow}
3086 % \end{adjustwidth}
3087 % \end{figure}
3088 %
3089 % \DescribeChronosstyle{somewhat plain}\chronosdocidx[symbol=eg,idx pre=off line,type=chronosstyle]{somewhat plain}A \chronosstylelabelname{} with a monochrome appearance and sans-serif fonts which produces a relatively short \conceptname[no idx,link]{timeline} of 100mm by default.
3090 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} below.
3091 % See \cref{tab:chronosstyles,fig:somewhat-plain}.
3092 % \begin{figure}
3093 % \begin{adjustwidth}{-\tewadjust}{0pt}
3094 % \centering
3095 % \begin{chronos}
3096 % [
3097 % somewhat plain,
3098 % heading={heading}{chronos year 400}{chronos year 500},
3099 % subheading={upper subheading}{chronos year 400}{chronos year 500}{chronos upper subheadings},
3100 % subheading={lower subheading}{chronos year 400}{chronos year 500}{chronos lower subheadings},
3101 % ]
3102 % \chronoslife{dates={400-12-22}:{425-12-22},name=life below,at=i2 -| life below,}
3103 % \chronoslife{dates={{-500}-01-01}:{{-425}-01-01},name=person below,at=i3 -| person below,}
3104 % \chronosperiod{dates={600}:{1025},name=period below,at=i1 -| period below,}
3105 % \chronosevent{date={2000},name=event below,at=i2 -| event below,}
3106 % \chronosmaintitle{name=somewhat plain,at=current bounding box.north east,anchor=south east,yshift=15pt}
3107 % \end{chronos}
3108 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{somewhat plain}.}\label{fig:somewhat-plain}
3109 % \end{adjustwidth}
3110 % \end{figure}
3111 % This \stylelabelname{} demonstrates how to create a \stylelabelname{} to draw lines above and below the \conceptname[idx post=somewhat plain\string\idxeg,idx font post=\KeyFont]{main title} node, without drawing the left and right sides of the node.
3112 %
3113 %
3114 %
3115 %^^A END subsubsec:chronos-styles-off-line
3116 %
3117 % \subsubsection{‘No Year’ Styles}\label{subsubsec:chronos-styles-no-years}\chronosdocidx[type=chronosstyle,font=\normalfont]{no-year}
3118 %^^A BEGIN subsubsec:chronos-styles-no-years
3119 %
3120 % \DescribeChronosstyle{event splitter}\chronosdocidx[symbol=eg,idx pre=no-year,type=chronosstyle]{event splitter}A 150mm \conceptname[no idx,link]{timeline} with no \conceptname[no idx]{year} labels which demonstrates the use of \keyname[link,idx=false,type=boolkey]{event dates split}\texseans{325890}.
3121 % \emph{Intended for \conceptname[idx as=timeline,no idx]{timelines} with \conceptname[idx as=connected element]{connected elements} solely of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,idx post=style for \string\textconcept{elements} of type]{event}.}
3122 % See \cref{tab:chronosstyles,fig:event-splitter}.
3123 % \begin{figure}
3124 % \begin{adjustwidth}{-\tewadjust}{0pt}
3125 % \centering
3126 % \begin{chronos}
3127 % [%^^A ateb: https://tex.stackexchange.com/a/325890/
3128 % event splitter,
3129 % ]
3130 % \chronosevent {date={2014-01-13},name=event 1}
3131 % \chronosevent {date={2014-01-20},name=event 2}
3132 % \chronosevent {date={2014-01-27},name=event 3}
3133 % \chronosevent {date={2014-02-03},name=event 4}
3134 % \chronosevent {date={2014-02-10},name=event 5}
3135 % \chronosevent {date={2014-02-17},name=event 6\\\& intervention}
3136 % \chronosevent {date={2014-02-22},name=the end}
3137 % \chronosmaintitle {name=event splitter,at=current bounding box.north,anchor=south}
3138 % \end{chronos}
3139 % \caption{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{event splitter}.}\label{fig:event-splitter}
3140 % \end{adjustwidth}
3141 % \end{figure}
3142 %
3143 % \DescribeChronosstyle{lines on line}\val{dimension}\chronosdocidx[symbol=eg,idx pre=no-year,type=chronosstyle]{lines on line}\AfterLastParam
3144 % A 120mm \conceptname[no idx,link]{timeline} arrow, \meta{dimension} high, with no \conceptname[no idx]{year} labels and \conceptname[type=tag,no idx,link]{life,event,period} \conceptname[idx as=line,idx post=lines on line\string\idxeg,idx font post=\KeyFont]{lines} drawn on the \conceptname[no idx,link]{timeline} itself\texseans{324453}.
3145 % Date information is confined to \conceptname[idx as=text tag,idx post=lines on line\string\idxeg,idx font post=\KeyFont]{text tags}.
3146 % Out-of-the-box, this \chronosstylelabelname{} adds \elementslabelname{} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,idx post=default placement (\string\textkey{lines on line})]{event} above and those of type \conceptname[type=tag,idx post=default placement (\string\textkey{lines on line})]{life,period} below.
3147 % \Default{5mm}
3148 % See \cref{tab:chronosstyles,fig:lines-on-line}.
3149 % \AdviceTracingOn
3150 % \mmzTracingOn
3151 % \begin{figure}
3152 % \begin{adjustwidth}{-\tewadjust}{0pt}
3153 % \centering
3154 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{lines on line}.\label{subfig:lines-on-line}}
3155 % {%^^A
3156 % %^^A ateb: https://tex.stackexchange.com/a/324453/
3157 % \begin{chronos}
3158 % [
3159 % lines on line,
3160 % chronos coords={1,500,750,1000},
3161 % heading={heading}{chronos year 1}{chronos year 1000},
3162 % subheading={upper subheading}{chronos year 1}{chronos year 500}{chronos upper subheadings},
3163 % subheading={lower subheading}{chronos year 1}{chronos year 750}{chronos lower subheadings},
3164 % ]
3165 % \chronosperiod{dates=1000:1999,name=period below}
3166 % \chronoslife{dates=192:476,name=long-lived person below}
3167 % \chronosevent {date={1969},name=event above,place above}
3168 % \chronosmaintitle{name=lines on line,at=current bounding box.north west,anchor=north west}
3169 % \end{chronos}%^^A
3170 % }
3171 % \subcaptionbox{\Chronosstylelabelname{}: \keyname[type=chronosstyle,idx post=sample output\string\idxeg]{plain arrow}.\label{subfig:plain-arrow}}
3172 % {%^^A
3173 % \begin{chronos}
3174 % [%^^A ateb: https://tex.stackexchange.com/a/324453/
3175 % plain arrow,
3176 % chronos coords={1,500,750,1000},
3177 % heading={heading}{chronos year 1}{chronos year 1000},
3178 % subheading={upper subheading}{chronos year 1}{chronos year 500}{chronos upper subheadings},
3179 % subheading={lower subheading}{chronos year 1}{chronos year 750}{chronos lower subheadings},
3180 % ]
3181 % \chronosperiod{dates=1000:1999,name=period below}
3182 % \chronoslife{dates=192:476,name=long-lived person below}
3183 % \chronosevent {date={1969},name=event above,place above}
3184 % \chronosmaintitle{name=plain arrow,at=current bounding box.north west,anchor=north west}
3185 % \end{chronos}
3186 % }%
3187 % \caption{\Cref{subfig:plain-arrow} is a variant of \cref{subfig:lines-on-line}.}\label{fig:lines-on-line}
3188 % \end{adjustwidth}
3189 % \end{figure}
3190 % \mmzTracingOff
3191 % \AdviceTracingOff
3192 %
3193 % \DescribeChronosstyle{plain arrow}\val{dimension}\chronosdocidx[symbol=eg,idx pre=no-year,type=chronosstyle]{plain arrow}\AfterLastParam
3194 % A variant of \keyname[link,idx=false,type=chronosstyle]{lines on line} (\cref{fig:lines-on-line}) which draws a 120mm \conceptname[no idx,link]{timeline} arrow with no \conceptname[no idx]{year} labels and \conceptname[type=tag,no idx,link]{life,event,period} \conceptname[idx as=line,idx post=plain arrow\string\idxeg,idx font post=\KeyFont]{lines} drawn on the \conceptname[no idx,link]{timeline} itself\texseans{324453}.
3195 % Date information is confined to \conceptname[idx as=text tag,idx post=plain arrow\string\idxeg,idx font post=\KeyFont]{text tags}.
3196 % \Default{5mm}
3197 % Intended for \conceptname[idx as=timeline,no idx,link,link to=timeline]{timelines} which add \elementslabelname{} of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,idx post=plain arrow\string\idxeg,idx font post=\KeyFont]{event} above and those of type \conceptname[type=tag,idx post=plain arrow\string\idxeg,idx font post=\KeyFont]{life,period} below.
3198 % See \cref{tab:chronosstyles,subfig:plain-arrow}.
3199 %
3200 %^^A END subsubsec:chronos-styles-no-years
3201 %
3202 %^^A END subsec:chronos-styles
3203 %
3204 % \subsection{Chronos Colour Schemes}\label{subsec:chronos-schemes}\chronosdocidx[type=concept,target,font=\ConceptFont,idx post=using]{colour scheme}\vspace{-\baselineskip}
3205 %^^A BEGIN subsec:chronos-schemes
3206 %
3207 % As explained in \cref{subsec:lliwiau}, \pkg{chronos} utilises a somewhat complex system for colour customisation.
3208 % In many cases, however, you will not need to delve into the mechanisms used.
3209 % Instead, you can simply load an existing \conceptname[type=concept,idx post=load existing]{colour scheme}.
3210 % If none of the provided schemes meet your needs, see \cref{subsec:chronos-scheme-creation}.
3211 %
3212 % To load a \colschemeslabelname{}, you just write
3213 % \begin{chronoscode}[colour,scheme,blues]
3214 % \begin{chronos}
3215 % [
3216 % modern,
3217 % colour scheme=blues,
3218 % ]
3219 % \end{chronos}
3220 % \end{chronoscode}
3221 % which would load the \chronosstylelabelname{} \keyname[link,idx=false,type=chronosstyle]{modern} followed by the \colschemeslabelname{} \keyname[link,idx=false,type=colscheme]{blues}.
3222 % Since \chronosstyleslabelname{} may legitimately load \colschemeslabelname{}, but \colschemeslabelname{} may not load \chronosstyleslabelname{}, always load any \chronosstylelabelname{} \emph{before} any \colschemelabelname{}.
3223 % Then make any further modifications you wish.
3224 % \begin{chronoscode}
3225 % \begin{chronos}
3226 % [
3227 % modern,
3228 % colour scheme=blues,
3229 % timeline={%
3230 % dates=1066:1946,
3231 % },
3232 % event/default colour=ForestGreen,
3233 % every text tags+={draw=##1},
3234 % ]
3235 % \end{chronos}
3236 % \end{chronoscode}
3237 %
3238 % \DescribeKey{colour scheme,color scheme}\valmarg{name}\AfterLastParam
3239 % \meta{name} should be the name of a \conceptname[type=concept]{colour scheme}.
3240 % A small number of \colschemeslabelname{} are provided by \pkg{chronos} (\cref{subsec:chronos-schemes}); others may be defined using the method explained in \cref{subsec:chronos-scheme-creation}.
3241 % \Default*{}the default set of colours.
3242 % \Example{colour scheme=cronoleg}
3243 % \chronosstyleslabelname{} may load \colschemeslabelname{} and typically should if they wish to make significant changes.
3244 %
3245 % In addition to the default colours, \pkg{chronos} currently provides \keyname[type=colscheme]{blues,contninety,cronoleg,lavender,modern,offlinebasic,offlinealt,sobriety,xcolseries} (\cref{tab:colschemes}).
3246 % \begin{table}
3247 % \begin{adjustwidth}{-\tewadjust}{0pt}
3248 % \centering
3249 % \caption{\Pkg{chronos} \Colschemeslabelname{}.}\label{tab:colschemes}
3250 % \chronosdocidx[type=colscheme,font=\normalfont]{list of}
3251 % \begin{tabular}{>{\ttfamily}l>{\ttfamily}l>{\ttfamily}ll}
3252 % \toprule
3253 % \sffamily \Colschemelabelname{} & \sffamily Variant Of & \sffamily Default For & \sffamily Examples \\\midrule
3254 % \fycross{} \normalfont (default) & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{default} \string\textsf{colour scheme}]{rotated 45,serif on line,somewhat plain} & \cref{fig:rotated45,fig:rhag,fig:somewhat-plain,subfig:serif-on-line} \\
3255 % \hypertarget{colscheme:blues}{blues} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{blues} \string\textsf{colour scheme}]{blues below,flipping blues} & \cref{fig:chronos-dev,subfig:blues-below,subfig:flipping-blues} \\
3256 % \hypertarget{colscheme:contninety}{contninety} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{contninety} \string\textsf{colour scheme}]{contemporary 90} & \cref{fig:contemporary90} \\
3257 % \hypertarget{colscheme:cronoleg}{cronoleg} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{cronoleg} \string\textsf{colour scheme}]{cronoleg} & \cref{fig:cronoleg} \\
3258 % \hypertarget{colscheme:lavender}{lavender} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{lavender} \string\textsf{colour scheme}]{lavender menace} & \cref{subfig:lavender-menace} \\
3259 % \hypertarget{colscheme:modern}{modern} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{modern} \string\textsf{colour scheme}]{modern} & \cref{subfig:modern} \\
3260 % \hypertarget{colscheme:offlinebasic}{offlinebasic} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{offlinebasic} \string\textsf{colour scheme}]{off line colour,off line simple} & \cref{subfig:off-line-col,subfig:off-line-simple} \\
3261 % \hypertarget{colscheme:offlinealt}{offlinealt} & cronoleg & \keyname[type=chronosstyle,idx post=use of \string\texttt{offlinealt} \string\textsf{colour scheme}]{off line colour alt} & \cref{subfig:off-line-col-alt}\\
3262 % \hypertarget{colscheme:sobriety}{sobriety} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{sobriety} \string\textsf{colour scheme}]{sober judge} & \cref{fig:sober-judge} \\
3263 % \hypertarget{colscheme:xcolseries}{xcolseries} & \fycross{} & \keyname[type=chronosstyle,idx post=use of \string\texttt{xcolseries} \string\textsf{colour scheme}]{rainbow serif} & \cref{subfig:rainbow-serif} \\
3264 % \bottomrule
3265 % \end{tabular}
3266 % \end{adjustwidth}
3267 % \end{table}
3268 % New \colschemeslabelname{} may be created using the interface explained in \cref{subsec:chronos-scheme-creation}.
3269 %
3270 %^^A END subsec:chronos-schemes
3271 %
3272 %^^A END sec:schemes-styles
3273 %
3274 %^^A \restoregeometry
3275 %^^A \setlength\tewadjust{\marginparwidth+\marginparsep-\paperwidth+\textwidth+\oddsidemargin+1in}%
3276 %^^A \fancyheadoffset[lh]{\tewadjust}%
3277 %
3278 %
3279 %
3280 %
3281 % \section{Configuration}\label{sec:config}
3282 %^^A BEGIN sec:config
3283 %
3284 % \Pkg{chronos} was designed to be highly configurable.
3285 % However, by far the \emph{easiest} way to customise a \conceptname[idx post=customisation]{timeline} is to load a \conceptname[type=chronosstyle,idx as=using,font=\normalfont]{chronos style}.
3286 % See \cref{subsec:chronos-styles}.
3287 %
3288 % Most configuration uses the standard key/value interface provided by \TikZ{}.
3289 % In addition, a \keyname[type=macro,idx post=purpose]{\cs{chronosset}} is provided for configuring defaults.
3290 %
3291 % Most \pkg{chronos} options have local scope.
3292 % That is, changes do not survive the current group.
3293 %
3294 % However, a small number of options are set \emph{globally}.
3295 % In these cases, \pkg{chronos} keeps track of a list of defaults, as well as the current options, and restores the defaults at the beginning and end of each \enviro{chronos} \envlabelname{}.
3296 % By default, \keyname[no idx,type=macro]{\cs{chronosset}} changes the default values of globalised options, whereas the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} does not.
3297 %
3298 % Globalised options saved as default are stored in \pkgname[no link]{expl3} variables named with a \pkglabelname{}-specific prefix.
3299 % A similar prefix is used for globalised \colourslabelname{}.
3300 %
3301 % \DescribeMacro{\chronosset}\marg{key-value list}\AfterLastParam
3302 % \DescribeMacro{\chronosset*}\marg{key-value list}\AfterLastParam
3303 % This should be used to configure \pkg{chronos} \emph{outside} the \keyname[link,idx=false,type=env]{chronos} environment.
3304 % It should \emph{not} be used within that environment.
3305 % The starred version does \emph{not} make any global changes.
3306 % In general, there is no reason to use the starred version as altering these variables non-globally will have no effect and other variables are not set globally in any case.
3307 % It is provided ‘just in case’, even though I can't think of a use-case for it.
3308 %
3309 % \Pkg{chronos} sets the following options globally.
3310 % At the end of the preamble, the active values are saved.
3311 % These are then restored at the end of each \keyname[link,idx=false,type=env]{chronos} environment.
3312 % This means the results of typesetting a \conceptname[idx post=independent of earlier]{timeline} should not depend on earlier \conceptname[idx as=timeline,no idx]{timelines} in the same document, a phenomenon which may otherwise result in changes of position and colour, for example.
3313 % Options set globally:
3314 % \begin{itemize}
3315 % \item the list of \keyname[idx=false,link,type=clistkey]{century subheadings} (but neither other subheadings nor headings are globalised);
3316 % \item most colours and lists of colours;
3317 % \item whether the last \keyname[idx=false,link,prefix=\meta{tag}/]{text tag} of a particular kind (\conceptname[type=tag,idx post=last position set globally,conj=or]{event,period}) was placed above or below the \conceptname[no idx]{timeline}.
3318 % \end{itemize}
3319 % All other settings should behave as usual for \pgf{}/\TikZ{} as they are not handled specially and all other \latex3 variables are declared locally.
3320 %
3321 % This approach is intended to ensure that things behave as I expect you to expect, but it is obviously not unlikely you may expect something I don't expect you to expect.
3322 % For this reason, it is strongly recommended that document-wide settings be configured in the preamble of your document.
3323 % \keyname[type=macro,idx post=when (not) to use in document body]{\cs{chronosset}} should be used in the document body \emph{only} when you wish to change the document defaults partway through your document.
3324 % If at all possible, I recommend the use of styles, configured in the preamble, instead, but there will be cases where such an approach may be sub-optimal.
3325 % \cs{chronosset} may be used later in such cases.
3326 %
3327 % In particular, you are urged to configure default \conceptname[type=colour,idx as=default,font=\normalfont]{colours} and \conceptname[type=collist,idx as=when to configure,font=\normalfont]{colour lists}, in your preamble.
3328 % See \cref{subsec:lliwiau,subsec:lliwiau-basic,subsec:add-elements-gconfig}.
3329 % If you get unexpected colours, please remember that \pkg{chronos} defines most colours \emph{globally}.
3330 % They are \emph{not} limited to the current \keyname[link,idx=false,type=env]{chronos} environment.
3331 % That is, \pkg{chronos} lets you customise the colours in many different ways, including many you might wish it did not.
3332 %
3333 % \subsection{Documentation Notes}\label{subsec:subsec:nodau}
3334 %^^A BEGIN subsec:subsec:nodau
3335 %
3336 % The following notes apply throughout this document.
3337 %
3338 % \subsubsection{Font Conventions}\label{subsubsec:fonts-conv}
3339 %^^A BEGIN subsubsec:fonts-conv
3340 %
3341 % This document uses the following typographic conventions.
3342 % \begin{description}[font=\normalfont]
3343 % \item[\textbf{Bold}/\textbf{\textit{Bold Italics}}] are used to emphasise important points, especially ones which might be overlooked.
3344 % \item[\textit{Italics}] are used with \textit{<} and \textit{>} for \marg{mandatory arguments}, \oarg{optional arguments} and \meta{parameterised values}.
3345 % When used in the text without delimiters, they are used for emphasis in accordance with standard typographic conventions for English language texts.
3346 % \item[\texttt{Monowidth Typewriter}] is used for \cs{macros} (e.g.~\cs{commands}), \enviro{\envslabelname}. \keyname[no idx,no link]{key names} and \texttt{code}.
3347 % \item[\textsf{Sans Serif}] is used for \conceptname[no idx,type=concept]{\conceptslabelname}, \conceptname[no idx]{\elementslabelname}, \pkg{package names} and \cls{class names}.
3348 % \end{description}
3349 %
3350 % The distinction between a ‘concept’, an ‘element’ and a ‘key’ is not always obvious.
3351 % Where discussion meanders through the borderlands of fuzzy concepts\footnote{%^^A
3352 % A ‘fuzzy concept’ is one whose extension cannot be precisely defined without arbitrariness.
3353 % For example, there are clear cases where ‘bald’ applies and equally clear cases where it does not, but there is no non-arbitrary point at which non-baldness becomes baldness.
3354 % ‘Bald’ is clear in the middle and clear well beyond its scope, but decidedly fuzzy at its edges.%^^A
3355 % }, the font in which a word appears is sometimes arbitrary and the choice should not be taken too seriously.
3356 % Moreover, some words, such as ‘timeline’, are used for all three.
3357 %
3358 %^^A END subsubsec:fonts-conv
3359 %
3360 % \subsubsection{Keys and Values\label{subsubsec:keys-values}}
3361 %^^A BEGIN subsubsec:keys-values
3362 %
3363 % \Pkg{chronos} provides a user interface for customisation based almost exclusively on \pkgname[no link]{pgfkeys}.
3364 %
3365 %
3366 % \paragraph{Keys}\label{nod:keys}
3367 % In case you have somehow come across this package shortly after landing in contemporary \TeX{}land, the basic idea is that the package provides a set of \conceptname[type=key,idx as=key]{keys} which you use selectively to customise the output.
3368 % Some of these keys are simple keywords.
3369 % \Example{no connections,}
3370 %
3371 % \paragraph{Values}\label{nod:values}
3372 % When \keyslabelname{} permit or require arguments, the arguments are called \parameter{values}.
3373 % A given \keylabelname{} will generally require a \meta{value} of some particular sort, as explained for each \keylabelname{} below.
3374 %
3375 % Some \pkg{chronos} \keyslabelname{} permit an argument, but don't require it.
3376 % \Example{frame,}
3377 % \Example{frame=true,}
3378 % \Example{frame=false,}
3379 % The above are all valid (with the first two being equivalent).
3380 %
3381 % Other \pkg{chronos} \keyslabelname{} require one or more arguments.
3382 % \Example{colour=Cerulean,}
3383 % \Example{heading=\{chronos year -150\}\{chronos year 250\}\{past\},}
3384 % \Pkg{chronos} frequently requires multiple arguments to be separated by colons, because this often seemed less error-prone than multiplying curly brackets in complex cases.
3385 % \Example{dates=\{\{-100\}-01-12\}:\{900-12-24\},}
3386 % In some instances, where a proliferation of colons seemed no less an invitation to error than one of curly brackets, the colon cases are convenience \keyslabelname{}, which you can avoid through the use of two or more alternate \keyslabelname{} to specify items separately.
3387 %
3388 % \paragraph{Key-Value Lists\label{nod:rhestrau-kv}}
3389 % \meta{key-value list}s are comma-separated lists of items, each of which is either a simple \meta{key-name} or a \meta{key-name}\valmarg{comma-separated list of values}.
3390 % In general, the \meta{comma-separated list of values} will be a \TikZ{} \meta{key-value list}, though it may sometimes be appropriate to include further \pkg{chronos} \keyslabelname{}.
3391 % \Example{event/line=\{draw=blue,draw opacity=.75\}}
3392 %
3393 %^^A END subsubsec:keys-values
3394 %
3395 % \subsubsection{Key Specifications}\label{subsubsec:key-spec}\chronosdocidx[type=key,font=\normalfont]{documentation,specification}
3396 %^^A BEGIN subsubsec:key-spec
3397 %
3398 % Key specifications in this document look like this:
3399 %
3400 % \DescribeKeytype[noindex]{key name}\val{argument specification} \fortags{tag1,tag2,tag3,\dots{}}\AfterLastParam
3401 % \meta{Description of key and explanation of usage.}
3402 % \Default*{}\meta{key's default value}\par
3403 % \Initial*{}\meta{key's initial value}\par
3404 % \Example{\meta{example of usage}}\par
3405 % \meta{Commentary.}\par
3406 % Here, {\MacroFont\makeatletter\color{doctools@ColorCodeNames}\makeatother key name} is the name of the \keylabelname{}, {\macrolabelfont key type} is the type of \keylabelname{}, \meta{argument specification} specifies the number, kind and format of the value or values the \keylabelname{} expects and {\macrolabelfont tag1, tag2, tag3, \dots{}} indicates to \elementslabelname{} of which \conceptname[type=concept,idx as=tag,conj=or,idx post=in \string\textkey{key} specifications]{tag,tags} the \keylabelname{} applies.
3407 % See \cref{tab:key-types} for an explanation of the types of \keylabelname{} \pkg{chronos} uses.
3408 % See \cref{sec:anatomy,subsec:mathau} for information about \conceptname[type=concept,idx as=tag,link,link to=tag,no idx]{tags}.
3409 % \begin{table}
3410 % \begin{adjustwidth}{-\tewadjust}{0pt}
3411 % \centering
3412 % \caption{\pkg{chronos} \keylabelname{} types.}\label{tab:key-types}
3413 % \begin{tabular}{>{\macrolabelfont}ll>{\ttfamily}l}
3414 % \toprule
3415 % \normalfont\sffamily Key type & \sffamily Description & \sffamily Example \\ \midrule
3416 % \boolkeylabelname & Controls a boolean or toggle i.e.~a conditional. & \\
3417 % \choicelabelname & Selects from a list of possible options. & \\
3418 % \clistkeylabelname & Processes or stores a comma-separated list of things. & \\
3419 % \colkeylabelname & Specifies a colour. & \\
3420 % \collistkeylabelname & Special kind of \clistkeylabelname{} which stores a list of colours. & \\
3421 % \datekeylabelname & Specifies a date or dates. & \\
3422 % \dateformatlabelname & Specifies one or more date output formats. & \\
3423 % \dimkeylabelname & Specifies a \TeX{} dimension. & \\
3424 % \keylabelname & Some other kind of \keylabelname. & \\
3425 %^^A \lgthkeylabelname & Specifies a \LaTeX{} length. & \\
3426 % \stylelabelname & A \pgf/\TikZ{} \stylelabelname{}. & \\
3427 % \bottomrule
3428 % \end{tabular}
3429 % \end{adjustwidth}
3430 % \end{table}
3431 %
3432 %
3433 %
3434 % \emph{If no initial value is specified, the default value is also the initial value.}
3435 % Where both an initial and a default value are specified, the default is the value used if the \meta{key name} is given without an argument and the initial value is the value used if \meta{key name} is not used at all.
3436 % This terminology follows the usage in \pkg{pgfkeys} and is especially prevalent in the handling of \boolkeyslabelname{}, where it is common for the initial value to be \texttt{false}, but the default value to be \texttt{true}.
3437 %
3438 % Schematically,
3439 % \begin{chronoscode}[key,name]
3440 % \begin{chronos}% ^^A initial value used
3441 % [
3442 % % ^^A other keys
3443 % ]
3444 % \end{chronos}
3445 % \begin{chronos}%^^A default value used
3446 % [
3447 % %^^A other keys
3448 % key name,
3449 % ]
3450 % \end{chronos}
3451 % \begin{chronos}%^^A new value used
3452 % [
3453 % %^^A other keys
3454 % key name=new value,
3455 % ]
3456 % \end{chronos}
3457 % \end{chronoscode}
3458 %
3459 %^^A END subsubsec:key-spec
3460 %
3461 % \subsubsection{Syntax Notes\label{subsubsec:nodiadau-syntax}}
3462 %^^A BEGIN subsubsec:syntax
3463 %
3464 % \emph{See \cref{subsubsec:nodiadau-dims} for the syntax of \dimkeyslabelname{}, where plus and prime have different meanings.}
3465 %
3466 % \paragraph{Slash (\texttt{/})\label{nod:slash}}\chronosdocindex{/ (forward slash)\actualchar\texttt{/} (forward slash)}
3467 % Where a forward slash (\texttt{/}) occurs in a \keylabelname{}, it indicates a context-specific \keylabelname{}.
3468 % For those familiar with \pgf{} keys, this corresponds to a path under \texttt{/chronos}.
3469 % \Example{life/connection} indicates a key affecting \conceptname[type=element,idx as=connection,idx post=documentation\string\idxeg]{connection(s)} belonging to \elementslabelname{} of type \conceptname[type=tag,idx post=as prefix\string\idxeg]{life}.
3470 %
3471 % \paragraph{Plus (\texttt{+})\label{nod:plus}}\chronosdocindex{+ (plus)\actualchar\texttt{+} (plus)}
3472 % A plus sign (\texttt{+}) at the end of a \keylabelname{} indicates that the \keylabelname{} \emph{adds} to any pre-existing list.
3473 % This form is generally available when the base key replaces, rather than adding to, any pre-existing list.
3474 % \begin{chronoscode}
3475 % timeline line={draw=black,fill=green},
3476 % timeline line+={opacity=.8},
3477 % \end{chronoscode}
3478 % is equivalent to
3479 % \begin{chronoscode}
3480 % timeline line={draw=black,fill=green,opacity=.8},
3481 % \end{chronoscode}
3482 % A plus at the end of a \dimkeylabelname{} indicates that the \dimkeylabelname{} \emph{adds} the value given to the current value of the dimension.
3483 %
3484 % \paragraph{Prime (\texttt{\textquotesingle})\label{nod:prime}}\chronosdocindex{' (prime)\actualchar\texttt{\textquotesingle} (prime)}
3485 % A prime (\texttt{\textquotesingle}) at the end of a \keylabelname{} indicates that the \keylabelname{} \emph{replaces} any pre-existing list.
3486 % This form is generally available when the base key adds to, rather than replacing, any pre-existing list.
3487 % \begin{chronoscode}
3488 % century subheadings={15,17,19}{th},
3489 % century subheadings'={13,14}{th},
3490 % century subheading={21}{st},
3491 % \end{chronoscode}
3492 % is equivalent to
3493 % \begin{chronoscode}
3494 % century subheadings'={13,14}{th},
3495 % century subheading={21}{st},
3496 % \end{chronoscode}
3497 % and will result in \conceptname[type=element]{subheadings} being created for the 13\textsuperscript{th}, 14\textsuperscript{th} and 21\textsuperscript{st} centuries (assuming the \conceptname[no idx]{timeline} covers these time periods and the relevant coordinates exist).
3498 %
3499 % A prime at the end of a \dimkeylabelname{}, or at the end except for a plus (\texttt{\textquotesingle+}), indicates that the \dimkeylabelname{} expects a \TeX{} dimension, as opposed to an expression to be evaluated by \pkgname[no link]{pgfmath}.
3500 %
3501 %^^A END subsubsec:syntax
3502 %
3503 % \subsubsection{Dimension Notes}\label{subsubsec:nodiadau-dims}\chronosdocindex{dimensions}
3504 %^^A BEGIN subsubsec:nodiadau-dims
3505 %
3506 % \paragraph{Dimensions\label{nod:dims}}
3507 % Each \keylabelname{} described as a \dimkeyslabelname{} is available in six forms\footnote{%^^A
3508 % Occasionally, a convenience \keylabelname{} may only support the prime, prime-plus and prime-minus forms.
3509 % Where this applies, the limitation is noted in the description.%^^A
3510 % }:
3511 %
3512 % \DescribeDimkey{\meta{\dimkeylabelname{}}}\valmarg{pgfmath-parsable dimension}\AfterLastParam
3513 % The \dimkeylabelname{} parses the \meta{specified value} using \pkgname[no link,idx post=\string\meta{value} parsed by]{pgfmath} and assigns the result in points as the dimension.
3514 % This base form, which is typically the only form explicitly listed in this documentation, is slow but flexible.
3515 % Unless otherwise noted, the existence of the base form implies the availability of all six variants.
3516 %
3517 % \DescribeDimkey{\meta{\dimkeylabelname{}}\texttt{\textquotesingle}}\valmarg{dimension}\AfterLastParam
3518 % The \dimkeylabelname{} expects a \TeX{} \meta{dimension}, complete with units, which it assigns directly.
3519 % This is faster but less flexible.\chronosdocidx[type=pkg,idx post=\string\meta{value}\string\texttt{\string\textquotesingle} not parsed by]{pgfmath}
3520 %
3521 % \DescribeDimkey{\meta{\dimkeylabelname{}}\texttt{+}}\valmarg{pgfmath-parsable dimension}\AfterLastParam
3522 % The \dimkeylabelname{} parses the expression $( \meta{specified value} + \meta{existing value} )$ with \pkgname[no link,idx post=\string\meta{value}\string\texttt{+} parsed by]{pgfmath} and assigns the result in points.
3523 % This is slower but more flexible.
3524 %
3525 % \DescribeDimkey{\meta{\dimkeylabelname{}}\texttt{\textquotesingle+}}\valmarg{dimension}\AfterLastParam
3526 % The \dimkeylabelname{} expects a \TeX{} \meta{dimension}, complete with units, which it adds to the \meta{existing dimension value} directly.\chronosdocidx[type=pkg,idx post=\string\meta{value}\string\texttt{\string\textquotesingle+} not parsed by]{pgfmath}
3527 % This is faster but less flexible.
3528 %
3529 % \DescribeDimkey{\meta{\dimkeylabelname{}}\texttt{-}}\valmarg{pgfmath-parsable dimension}\AfterLastParam
3530 % The \dimkeylabelname{} parses the expression $( \meta{specified value} - \meta{existing value} )$ with \pkgname[no link,idx post=\string\meta{value}\string\texttt{-} parsed by]{pgfmath} and assigns the result in points.
3531 % This is slower but more flexible.
3532 %
3533 % \DescribeDimkey{\meta{\dimkeylabelname{}}\texttt{\textquotesingle-}}\valmarg{dimension}\AfterLastParam
3534 % The \dimkeylabelname{} expects a \TeX{} \meta{dimension}, complete with units, which it subtracts from the \meta{existing dimension value} directly.\chronosdocidx[type=pkg,idx post=\string\meta{value}\string\texttt{\string\textquotesingle-} not parsed by]{pgfmath}
3535 % This is faster but less flexible.
3536 %
3537 % When \dimkeyslabelname{} end in prime\chronosdocindex{' (prime)\actualchar\texttt{\textquotesingle} (prime)}, prime-plus\chronosdocindex{'+ (prime-plus)\actualchar\texttt{\textquotesingle+} (prime-plus)} or prime-minus\chronosdocindex{'- (prime-minus)\actualchar\texttt{\textquotesingle-} (prime-minus)}, \meta{dimension}s must be given as \TeX{} dimensions complete with units and may not require calculation.
3538 % \Example{timeline height\textquotesingle=10mm}
3539 % \Example{timeline border height\textquotesingle+=20pt}
3540 % \Example{timeline width\textquotesingle-=2em}
3541 %
3542 % When \dimkeyslabelname{} do not include prime, any value which can be parsed by \pkgname[no link,no idx]{pgfmath} is valid.
3543 % \Example{timeline height=.01\bs textheight}
3544 % \Example{timeline border height+=1.5\bs headrulewidth}
3545 % \Example{timeline width-=0.05\bs linewidth+1.5pt}
3546 %
3547 %^^A END subsubsec:nodiadau-dimsnodiadau-dims
3548 %
3549 % \subsubsection{Date Specification Notes}\label{subsubsec:nodiadau-dyddiadau}
3550 %^^A BEGIN subsubsec:nodiadau-dyddiadau
3551 %
3552 % \paragraph{Date Format Specifications\label{nod:fformatiau-dyddiadau}}
3553 % A \meta{date format specification} (\meta{date format spec.}) is an expression using the syntax explained in \cref{subsubsec:dyddiad-output}.
3554 % \Example{date format=\{!d !B !Y !E\}}
3555 %
3556 % \paragraph{Dates\label{nod:dyddiadau}}
3557 % \meta{date}s must be specified using the syntax explained in \cref{subsubsec:dyddiad-input}.
3558 % \Example{dates=\{\{-200\}-04-05\}:\{200-12-31\}}
3559 %
3560 %^^A END subsubsec:nodiadau-dyddiadaunodiadau-dyddiadau
3561 %
3562 %
3563 % \subsubsection{Colour Notes}\label{subsubsec:nodiadau-lliwiau}
3564 %^^A BEGIN subsubsec:nodiadau-lliwiau
3565 %
3566 % \paragraph{Colours\label{nod:lliwiau}}
3567 % \meta{colour}s should be colour names or mixtures supported by \pkg{xcolor}.
3568 % \Example{colour=WildStrawberry}
3569 % \Example{foreground=WildStrawberry!50!black}
3570 %
3571 % \paragraph{Colour Lists\label{nod:rhestrau-lliwiau}}
3572 % \meta{colour list}s are comma-separated lists of colour names or mixtures supported by \pkg{xcolor}.
3573 % \Example{life/colours above=\{blue,green,blue!50!green\}}
3574 %
3575 % \paragraph{Colour\label{nod:colour}}
3576 % \texttt{colour} and \texttt{color} are synonyms in key names.
3577 % \Example{colours below=\{black,gray\}}
3578 % \Example{colors below=\{black,gray\}}
3579 %
3580 %^^A END subsubsec:nodiadau-lliwiaunodiadau-lliwiau
3581 %
3582 %
3583 %
3584 %^^A END subsec:nodau
3585 %
3586 %^^A END sec:config
3587 %
3588 % \subsection{Dates}\label{subsec:dyddiadau}
3589 %^^A BEGIN subsec:dyddiadau
3590 %
3591 % \Pkg{chronos} uses a fixed format for date input and offers a flexible format for date output.
3592 %
3593 % \subsubsection{Input}\label{subsubsec:dyddiad-input}
3594 %^^A BEGIN subsubsec:dyddiad-input
3595 %
3596 % All date keys expect one or two arguments specifying a date or dates in the format \texttt{\{\{Y\}-M-D\}}.
3597 % \texttt{Y}, \texttt{M} and \texttt{D} must be integers.
3598 % If \texttt{Y} is negative, the date is interpreted as BCE; otherwise CE is assumed.
3599 % The additional curly brackets around \texttt{Y} are \emph{mandatory} for negative values.
3600 % \begin{chronoscode}
3601 % start date={{-3000}-05-23},
3602 % end date={1500-12-04},
3603 % \end{chronoscode}
3604 % It is also permissible to specify only a year, in which case \pkg{chronos} will specify values for the month and day.
3605 % Hence,
3606 % \begin{chronoscode}
3607 % dates={-245}:789,
3608 % \end{chronoscode}
3609 % is also valid.
3610 % Where two dates are required, \keyname[link,idx=false,type=datekey]{dates} offers a more concise syntax, but dates may always be specified singly if this is preferred.
3611 %
3612 %^^A END subsubsec:dyddiad-input
3613 %
3614 % \subsubsection{Output}\label{subsubsec:dyddiad-output}
3615 %^^A BEGIN subsubsec:dyddiad-output
3616 %
3617 % All date format keys expect one or three arguments using the syntax specified in \cref{tab:dyddiadau}.
3618 % \Example{date format=\{ B d, Y\}}
3619 % This would result in a full month name followed by the day of the month, then a comma and finally the year.
3620 %
3621 % Each character in the format is either translated into an element of the date format or passed through as is.
3622 % This includes punctuation and spaces.
3623 % (Note that macros etc.\ won't work here because the macro will be broken down and ‘translated’ token-by-token.)
3624 %
3625 % The format codes, listed in \cref{tab:dyddiadau}, are mostly a subset of the format codes provided by GNU's date command, with a few extras not relevant to GNU\texsethanks{Joseph Wright}{327642}.
3626 %
3627 % \begin{table}
3628 % \begin{adjustwidth}{-\tewadjust}{0pt}
3629 % \centering
3630 % \caption{Date and year format specification codes.}\label{tab:dyddiadau}
3631 % \begin{tabular}{>{\ttfamily}cllcc}
3632 % \toprule
3633 % \sffamily code & \sffamily meaning & \sffamily example output & \sffamily date format specifier? & \sffamily year format specifier? \\\midrule
3634 % !a & short weekday name & Mon & \fycheck & \fycross \\
3635 % !A & full weekday name & Monday & \fycheck & \fycross \\
3636 % !b & short month name & Jan & \fycheck & \fycross \\
3637 % !B & full month name & January & \fycheck & \fycross \\
3638 % !c & semi-shortened year & 900 & \fycheck & \fycheck \\
3639 % !d & day of the month & 23 & \fycheck & \fycross \\
3640 % !E & era & \bceyearlabel{} or \ceyearlabel{} label & \fycheck & \fycheck \\
3641 % !m & month number & 01 & \fycheck & \fycross \\
3642 % !q & minus if year is \bceyearlabel{} & - & \fycheck & \fycheck \\
3643 % !Q & minus if year is \bceyearlabel{}; plus for \ceyearlabel{} & + & \fycheck & \fycheck \\
3644 % !y & last two digits of year & 66 & \fycheck & \fycheck \\
3645 % !Y & year & 1066 & \fycheck & \fycheck \\
3646 % \bottomrule
3647 % \end{tabular}
3648 % \end{adjustwidth}
3649 % \end{table}
3650 %
3651 % A subset of the date-specification codes (as indicated in \cref{tab:dyddiadau}) is available to customise the formatting of years on the \conceptname[idx post=customisation]{timeline} itself.
3652 % In the case of the \conceptname[idx post=era labels,idx font post=\ConceptFont]{timeline}, era labels may instead be added at each end to avoid the clutter of including \bceyearlabel{} or \ceyearlabel{} with every year.
3653 %
3654 % \DescribeDateformat{date format}\valmarg{date format specification}\AfterLastParam
3655 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format for dates.
3656 % \Default[with eras]{!d/!m/!Y\bs thinspace !E}
3657 % \Default[without eras]{!d/!m/!Y}
3658 %
3659 % \DescribeDateformat{event/date format}\valmarg{date format specification} \fortags{event}\AfterLastParam
3660 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format for \conceptname[type=tag,link,idx post=date formatting]{event} dates.
3661 % \emph{This \keylabelname{} overrides \keyname[idx=false,link]{show eras,without eras,full dates,only years} for \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,link,no idx]{event}.}
3662 % \Default[with eras]{!d/!m/!Y\bs thinspace !E}
3663 % \Default[without eras]{!d/!m/!Y}
3664 %
3665 % The following keys set \keyname[type=dateformat,link,no idx]{event/date format} conditionally.
3666 % This may be used to switch between formats showing eras or only years and no eras or full dates while ensuring uniformity of all formats with or without eras, for example.
3667 % For instance, it may make little sense to use full dates for events where only the year is known or which occurred when different calendars were used, but you might still want full dates for other cases.
3668 % \emph{These \keyslabelname{} override \keyname[idx=false,link]{show eras,without eras,full dates,only years} for \elementslabelname{} of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,link,no idx]{event}.}
3669 %
3670 % \DescribeDateformat{event/show eras/full}\valmarg{date format specification} \fortags[names=show eras/full]{event}\AfterLastParam
3671 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format to use for \conceptname[type=tag,link,no idx]{event} when showing full dates with eras.
3672 % \Default{{!d/!m/!Y\bs thinspace !E}}
3673 %
3674 % \DescribeDateformat{event/show eras/only years}\valmarg{date format specification} \fortags{event}\AfterLastParam
3675 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format to use for \conceptname[type=tag,link,no idx]{event} when showing only years with eras.
3676 % \Default{{!Y\bs thinspace !E}}
3677 %
3678 % \DescribeDateformat{event/without eras/full}\valmarg{date format specification} \fortags{event}\AfterLastParam
3679 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format to use for \conceptname[type=tag,link,no idx]{event} when showing full dates without eras.
3680 % \Default{{!d/!m/!Y}}
3681 %
3682 % \DescribeDateformat{event/without eras/only years}\valmarg{date format specification} \fortags{event}\AfterLastParam
3683 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format to use for \conceptname[type=tag,link,no idx]{event} when showing only years without eras.
3684 % \Default{{!Y}}
3685 %
3686 % \conceptname[type=tag,idx post={date ranges}]{life,period} are more complex as date ranges are involved, but the basic structure works in the same way.
3687 %
3688 % \DescribeDateformat{life/date formats,period/date formats}\cvalsmarg{date format spec.,date format spec.,date format spec.} \fortags{life,period}\AfterLastParam
3689 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default formats for \conceptname[type=tag,link,idx post=date formatting]{life} or \conceptname[type=tag,link,idx post=date formatting]{period} dates.
3690 % In these cases, we have two dates --- either a birth and death or a start and end.
3691 % You might want different formats for the two and you might want different formats when the first date is \bceyearlabel{} and the second \ceyearlabel{}.
3692 % Hence, we need to specify three formats.
3693 % The first argument specifies the format to use for the birth or start date when the death or end date occurs in the same era.
3694 % The second specifies the format to use for the first date when the eras differ.
3695 % The third specifies the format to use for the death or end date.
3696 % \emph{These \keyslabelname{} override \keyname[idx=false,link]{show eras,without eras,full dates,only years} for \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} types \conceptname[type=tag,link,no idx]{life,period} respectively.}
3697 % \Default[with eras]{\{!d/!m/!Y\}:\{!d/!m/!Y\bs thinspace !E\}:\{!d/!m/!Y\bs thinspace !E\}}
3698 % \Default[without eras]{\{!d/!m/!Y\}:\{!d/!m/!Y\}:\{!d/!m/!Y\}}
3699 %
3700 % \emph{The following \keyslabelname{} override \keyname[link,idx=false,type=dateformat,link prefix=life/]{date formats} for \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} types \conceptname[type=tag,link,no idx]{life,period} respectively.}
3701 % They work in the same way as those explained above for \conceptname[type=dateformat,link,link to=event/show eras/full,no idx]{event}.
3702 %
3703 % \DescribeDateformat{life/show eras/full,period/show eras/full}\cvalsmarg{date format spec.,date format spec.,date format spec.} \fortags{life,period}\AfterLastParam
3704 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default formats to use for \conceptname[type=tag,link,no idx]{life} or \conceptname[type=tag,link,no idx]{period} when showing full dates with eras.
3705 % \Default{\{!d/!m/!Y\}:\{!d/!m/!Y\bs thinspace !E\}:\{!d/!m/!Y\bs thinspace !E\}}
3706 %
3707 % \DescribeDateformat{life/show eras/only years,period/show eras/only years}\cvalsmarg{date format spec.,date format spec.,date format spec.} \fortags{life,period}\AfterLastParam
3708 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default formats to use for \conceptname[type=tag,link,no idx]{life} or \conceptname[type=tag,link,no idx]{period} when showing only years with eras.
3709 % \Default{\{!Y\}:\{!Y\bs thinspace !E\}:\{!Y\bs thinspace !E\}}
3710 %
3711 % \DescribeDateformat{life/without eras/full,period/without eras/full}\cvalsmarg{date format spec.,date format spec.,date format spec.} \fortags{life,period}\AfterLastParam
3712 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default formats to use for \conceptname[type=tag,link,no idx]{life} or \conceptname[type=tag,link,no idx]{period} when showing full dates without eras.
3713 % \Default{\{!d/!m/!Y\}:\{!d/!m/!Y\}:\{!d/!m/!Y\}}
3714 %
3715 % \DescribeDateformat{life/without eras/only years,period/without eras/only years}\cvalsmarg{date format spec.,date format spec.,date format spec.} \fortags{life,period}\AfterLastParam
3716 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default formats to use for \conceptname[type=tag,link,no idx]{life} or \conceptname[type=tag,link,no idx]{period} when showing only years without eras.
3717 % \Default{\{!Y\}:\{!Y\}:\{!Y\}}
3718 %
3719 % \DescribeDateformat{every date format}\valmarg{date format specification}\AfterLastParam
3720 % Sets \emph{all} date formats for \emph{all} \conceptname[type=concept,idx as=tag,link,link to=tag,no idx]{tags} and the default format to \meta{date format specification}.
3721 % This \keylabelname{} does not affect the formatting of \conceptname[conj=or,no idx]{years,minor years,eras} on the \conceptname[link,no idx]{timeline} itself.
3722 % \Default*{}none\par
3723 % \Initial*{}none\par
3724 %
3725 % \DescribeKey{bce year label}\val{text}\AfterLastParam
3726 % The label to use if showing the \bceyearlabel{} era in \conceptname[type=element,idx as=text tag,link,link to=text tag,idx post=text tag \string\textnormal{date formatting},idx font post=\ConceptFont]{text tags}.
3727 % Note this is not the label used if marking eras on the \conceptname[link,no idx]{timeline}, unless including them as part of year labels.
3728 % \Default{\bs textsc\{bce\}}
3729 % \begin{chronoscode}
3730 % \begin{chronos}
3731 % [
3732 % bce year label=BCE,
3733 % ]
3734 % \end{chronos}
3735 % \end{chronoscode}
3736 % The label is available as \keyname[type=macro]{\cs{bceyearlabel}} inside the \envlabelname{} \keyname[type=env,no idx]{\enviro{chronos}}.
3737 % In addition, it is made available at the end of the preamble if the command is not otherwise defined.
3738 %
3739 % \DescribeKey{ce year label}\val{text}\AfterLastParam
3740 % The label to use if showing the \ceyearlabel{} era in \conceptname[type=element,idx as=text tag,link,link to=text tag,idx post=text tag \string\textnormal{date formatting},idx font post=\ConceptFont]{text tags}.
3741 % Note this is not the label used if marking eras on the \conceptname[link,no idx]{timeline}, unless including them as part of year labels.
3742 % \Default{\bs textsc\{ce\}}
3743 % \begin{chronoscode}
3744 % \begin{chronos}
3745 % [
3746 % ce year label=\textsc{ad},
3747 % ]
3748 % \end{chronos}
3749 % \end{chronoscode}
3750 % The label is available as \keyname[type=macro]{\cs{ceyearlabel}} inside the \enviro{chronos} environment.
3751 % In addition, it is made available at the end of the preamble if the command is not otherwise defined.
3752 %
3753 % The \conceptname[no idx,link]{timeline} itself features only years (but see \keyname[idx=false,link]{event years on line} for a limited exception).
3754 %
3755 % \DescribeDateformat{year format}\valmarg{year format specification}\AfterLastParam
3756 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format for years.
3757 % This is the format used to format ‘major’ years on the \conceptname[idx post={years\string\textrm{,} major\string\textrm{, format}},idx font post=\ConceptFont]{timeline}.
3758 % \Default[with eras]{!Y\bs thinspace !E}
3759 % \Default[without eras]{!Y}
3760 %
3761 % \DescribeDateformat{minor year format}\valmarg{year format specification}\AfterLastParam
3762 % When used in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default format for ‘minor’ years.
3763 % \Default{!c}
3764 % The idea is that you might want, say, four-digit years every half century and three-digit years every hundred years in between.
3765 %
3766 % \DescribeBoolkey{timeline/timeline mark eras}\vals{true,false}\AfterLastParam
3767 % Should era labels be included at the end(s) of the \conceptname[idx post=era labels,idx font post=\ConceptFont]{timeline}?
3768 % Note that a label will only be shown if the dates the \conceptname[no idx]{timeline} covers include some in the relevant era.
3769 % So if your \conceptname[no idx,link]{timeline} starts at 500 \ceyearlabel, the \bceyearlabel{} will be omitted and if it ends at 200 \bceyearlabel, the \ceyearlabel{} will be omitted.
3770 % \Default{true}
3771 % \Initial{false}
3772 %
3773 % \DescribeKey{timeline bce label}\val{text}\AfterLastParam
3774 % The label to use if marking the \bceyearlabel{} era on the \conceptname[idx post=\bceyearlabel\ label,link]{timeline}.
3775 % Note this is not the label used if showing eras in \conceptname[type=element,idx as=text tag,link to=text tag,link,no idx]{text tags}.
3776 % \Default{BCE}
3777 % \begin{chronoscode}
3778 % \begin{chronos}
3779 % [
3780 % timeline bce label=BC,
3781 % ]
3782 % \end{chronos}
3783 % \end{chronoscode}
3784 % The label is available as \keyname[type=macro]{\cs{celabel}} inside the \keyname[type=env,no idx]{\enviro{chronos}} \envlabelname{}.
3785 % In addition, it is made available at the end of the document preamble for general use if the command is not otherwise defined.
3786 %
3787 % \DescribeKey{timeline ce label}\val{text}\AfterLastParam
3788 % The label to use if marking the \ceyearlabel{} era on the \conceptname[idx post=\ceyearlabel\ label,link]{timeline}.
3789 % Note this is not the label used if showing eras in \conceptname[type=element,idx as=text tag,link,link to=text tag,no idx]{text tags}.
3790 % \Default{CE}
3791 % \begin{chronoscode}
3792 % \begin{chronos}
3793 % [
3794 % timeline ce label=AD,
3795 % ]
3796 % \end{chronos}
3797 % \end{chronoscode}
3798 % The label is available as \keyname[type=macro]{\cs{bcelabel}} inside the \keyname[type=env,no idx]{\enviro{chronos}} \envlabelname{}.
3799 % In addition, it is made available for general use at the end of the document preamble if the command is not otherwise defined.
3800 %
3801 %^^A END subsubsec:dyddiad-output
3802 %
3803 % \subsubsection{The Problem of the Non-Existent Year}\label{subsubsec:subsec:blwyddyn-sero}
3804 %^^A BEGIN subsubsec:subsec:blwyddyn-sero
3805 %
3806 % \Pkg{chronos} uses \conceptname[type=pkg]{pgfcalendar} to calculate Julian day numbers from dates when constructing the \conceptname[idx post=problem of non-existent year,link]{timeline}.
3807 % Generally, this works well, but an issue occurs if your \conceptname[idx post=spanning eras,link,idx font post=\ConceptFont]{timeline} spans the two eras (\bceyearlabel{} and \ceyearlabel{}).
3808 % \Pkg{pgfcalendar} assumes there was a year zero (\cref{subfig:sero}), which historians will assure you there was not.
3809 % \begin{figure}
3810 % \begin{adjustwidth}{-\tewadjust}{0pt}
3811 % \centering
3812 % \subcaptionbox{\pkg{pgfcalendar} default.\label{subfig:sero}}{%^^A
3813 % \begin{chronos}
3814 % [
3815 % timeline={%
3816 % start date={-1}-12-01,
3817 % end date=1-01-31,
3818 % mark at era switch=true,
3819 % width=.495\linewidth,
3820 % timeline mark eras,
3821 % year zero,
3822 % },
3823 % no colour rotation,
3824 % outer border=0pt,
3825 % ]
3826 % \chronosevent {date={{-1}-12-31},name=new year's eve,yshift=20pt}
3827 % \chronosevent {date={1-01-01},name=new year's day,yshift=-20pt}
3828 % \chronosperiod {dates={0-01-01}:{0-12-31},name=non-existent year,colour=chronosWildStrawberry}
3829 % \end{chronos}%^^A
3830 % }%
3831 % \subcaptionbox{\pkg{chronos} adjustment.\label{subfig:heb-sero}}{%^^A
3832 % \begin{chronos}
3833 % [
3834 % timeline={%
3835 % start date={-1}-12-01,
3836 % end date=1-01-31,
3837 % width=.495\linewidth,
3838 % timeline mark eras,
3839 % },
3840 % no colour rotation,
3841 % outer border=0pt,
3842 % ]
3843 % \chronosevent {date={{-1}-12-31},name=new year's eve,yshift=20pt}
3844 % \chronosevent {date={1-01-01},name=new year's day,yshift=-20pt}
3845 % \end{chronos}
3846 % }%
3847 % \caption{The problem of the non-existent year.\label{fig:sero}}
3848 % \end{adjustwidth}
3849 % \end{figure}
3850 %
3851 % By default, \pkg{chronos} corrects for this (\cref{subfig:heb-sero}), but the correction can be switched off if desired (\cref{subfig:sero}).
3852 %
3853 % \DescribeBoolkey{timeline/year zero}\vals{true,false}\AfterLastParam
3854 % Whether to tolerate the year zero.
3855 % \Default{true}
3856 % \Initial{false}
3857 %
3858 % If there is no year zero, certain complications arise.
3859 % First, what should be marked on the \conceptname[idx post=if no year zero,link,idx font post=\ConceptFont]{timeline} at the ‘era switch’?
3860 % Second, if you ask \pkg{chronos} to mark every hundredth year, say, you probably do not expect it to mark 200 \bceyearlabel{}, 100 \bceyearlabel{}, 1 \ceyearlabel{}, 101 \ceyearlabel{} and so on.
3861 % Moreover, you might want to do something such as this
3862 % \begin{chronoscode}
3863 % \foreach \i in {-100,-50,...,300} \node [red,inner sep=2.5pt] at (chronos year \i) {};
3864 % \end{chronoscode}
3865 % This seems reasonable, but will fail if \texttt{chronos year 0} doesn't exist.
3866 %
3867 % \Pkg{chronos} attempts to solve these problems by handling the ‘era switch’ as a special case.
3868 % First, if there is no year zero, it will create \emph{two} coordinates at the switch, provided you have asked it to mark something at this point.
3869 % \texttt{chronos year 0} will exist, as far as \pkg{chronos} is concerned, at the same point as \texttt{chronos year 1}.
3870 % This means you can loop over the era switch in the normal way and expect sensible output, but you can \emph{also} refer to \texttt{chronos year 1}, even if you only asked every hundredth year to be marked from 100 \bceyearlabel{}.
3871 %
3872 % Second, \pkg{chronos} provides a special option for configuring what is marked on the \conceptname[idx post=era switch,link,idx font post=\ConceptFont,no idx]{timeline} at the switch of eras.
3873 %
3874 % \DescribeBoolkey{timeline/mark at era switch}\vals{true,false}\AfterLastParam
3875 % Whether to use a mark rather than a year at the era switch.
3876 % If false, the year (e.g.~‘1’) is used; if true, a mark is used instead (illustrated in \cref{subfig:heb-sero}, though the format will depend on how the \conceptname[idx post=era switch,link,idx font post=\ConceptFont]{timeline} is configured).
3877 % \Default{true}
3878 % \Initial[if showing every year]{false}
3879 % \Initial[otherwise]{true}
3880 % Note that this option only configures what is marked if something is.
3881 % If you ask \pkg{chronos} to mark every hundredth year from 150 \bceyearlabel{} to 400 \ceyearlabel{}, nothing will be marked at the era switch (but \pkg{chronos} will write a warning to the log).
3882 % \Pkg{chronos} won't do that by default, but, if you insist, it will take you at your word.
3883 %
3884 % \DescribeBoolkey{timeline/year at era switch}\vals{true,false}\AfterLastParam
3885 % Whether to use a year rather than a mark at the era switch.
3886 % This is simply a convenience key which does the opposite of \keyname[link,idx=false,type=boolkey,link prefix=timeline/]{mark at era switch}.
3887 % \Default{true}
3888 % \Initial*{}see \keyname[link,idx=false,type=boolkey,link prefix=timeline/]{mark at era switch}.
3889 %
3890 %^^A END subsubsec:subsec:blwyddyn-serosubsec:blwyddyn-sero
3891 %
3892 %^^A END subsec:dyddiadau
3893 %
3894 % \subsection{Basic Colours}\label{subsec:lliwiau-basic}
3895 %^^A BEGIN subsec:lliwiau-basic
3896 %
3897 % \Pkg{chronos} uses (or may use) two basic colours: one for foreground and one for background \elementslabelname{}.
3898 %
3899 % \DescribeColkey{background}\val{colour name}\AfterLastParam
3900 % This is the ‘main background colour’ for the picture as a whole.
3901 % This colour is accessible within the \enviro{chronos} environment as \keyname[type=colour,conj=or]{chronos main background colour,chronos main background color}.
3902 % Whether it is used and, if so, how, depends on other settings.
3903 % By default, it is used to determine the colours for the \conceptname[idx post=colours,link,idx font post=\ConceptFont]{timeline} itself and is the basis for the colours used in some \tagslabelname.
3904 % It is also used in some standard \conceptname[type=colour,idx as=chronos main background colour,font=\KeyFont,idx post=use in \string\textsf{chronos styles}]{chronos styles}.
3905 % \Default{white}
3906 % \begin{chronoscode}
3907 % \begin{chronos}
3908 % [
3909 % background=magenta,
3910 % ]
3911 % \end{chronos}
3912 % \end{chronoscode}
3913 %
3914 % \DescribeColkey{foreground}\val{colour name}\AfterLastParam
3915 % This is the ‘main foreground colour’ for the picture as a whole.
3916 % This colour is accessible within the \enviro{chronos} environment as \keyname[type=colour,conj=or]{chronos main colour,chronos main color}.
3917 % Whether it is used and, if so, how, depends on other settings.
3918 % By default, it is used to determine the colours for the \conceptname[idx post=colours,link,idx font post=\ConceptFont,no idx]{timeline} itself and is the basis for the colours used in some \tagslabelname.
3919 % It is also used as the \keyname[link,idx=false,type=colkey,link prefix=\meta{tag}/,idx as=\meta{tag}/default colour]{default colour} for \conceptname[idx as={connection,line,text tag},idx post=default use of \string\textkey{chronos main colour} in]{connections,lines,text tags} and in some standard \conceptname[type=colour,idx as=chronos main colour,font=\KeyFont,idx post=use in \string\textsf{chronos styles}]{chronos styles}.
3920 % \Default{black}
3921 % \begin{chronoscode}
3922 % \begin{chronos}
3923 % [
3924 % foreground=red,
3925 % ]
3926 % \end{chronos}
3927 % \end{chronoscode}
3928 %
3929 % For other colours, see \cref{subsubsec:timeline-lliwiau,subsec:lliwiau}.
3930 %
3931 %^^A END subsec:lliwiau-basic
3932 %
3933 % \subsection{Timeline}\label{subsec:llinell-amser}
3934 %^^A BEGIN subsec:llinell-amser
3935 %
3936 % See \cref{subsec:anatomi-llinell-amser} for an overview of the \conceptname[no idx]{timeline}'s components and construction.
3937 %
3938 % Placing different \elementslabelname on different \conceptname[type=element,idx as=layer,idx post=effect of placing \string\textconcept{elements} on different]{layers} enables the same basic building blocks to result in different styles, but the blocks may also be configured directly.
3939 % The layers on which the \conceptname[type=element,idx as=connection,idx post=effect of drawing on different \string\textconcept{layers},link,link to=connection]{connections} and \conceptname[type=element,idx as=line,idx post=effect of drawing on different \string\textconcept{layers},link,link to=line]{lines} of items connected to the \conceptname[idx post=connections \string\textrm{and} lines,link,idx font post=\ConceptFont]{timeline} are drawn also affects the appearance.
3940 % For example, putting \conceptname[type=element,idx as=connection,no idx,link,link to=connection]{connections} behind the \conceptname[type=element,idx post=using to change appearance of \string\textconcept{connectors}]{border} results in circular \conceptname[type=element,idx as=chronos connector]{chronos connectors} appearing as semicircles.
3941 % \Pkg{chronos}'s use of layers is explained in \cref{subsec:haenau,sec:haenau-llunio}.
3942 %
3943 % \DescribeChoice{connections on,lines on,timeline/timeline on,timeline/border on}\vals{background,middle ground,main,foreground,overlay}\AfterLastParam
3944 % Which \conceptname[type=layer,no link,idx as={connections on,lines on,timeline/timeline on,timeline/border on},font=\KeyFont]{layer} each type of element should be placed on.
3945 % Aside from \keyname[type=layer,no link]{main} these are not standard layers.
3946 % In particular, \keyname[type=layer,no link,idx post=\string\emph{vs.} \string\texttt{chronos background}]{background} is not the standard \TikZ{} \keyname[type=layer,no link,no idx]{background} layer, but instead refers to the \keyname[type=layer,idx post=\string\emph{vs.} \string\texttt{background}]{chronos background} layer.
3947 % \Default
3948 % See \cref{subsec:haenau}.
3949 %
3950 % The \conceptname[idx post={configuration, main key}]{timeline} should be configured using the following \keylabelname{}.
3951 %
3952 % \DescribeKey{timeline}\valmarg{key-value list}\AfterLastParam
3953 % \meta{key-value list} should be a list of \pkg{chronos} \keyslabelname{} from the \conceptname[no idx]{timeline} configuration options.
3954 % These \keyslabelname{} may also be accessed more verbosely as \texttt{/chronos/timeline/}\meta{key name} or, in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}} as \texttt{timeline/}\meta{key name}.
3955 % Some may also work without the \texttt{timeline/} prefix, but \emph{this is not guaranteed and may break without notice in future releases}.
3956 % \begin{chronoscode}
3957 % \begin{chronos}
3958 % [
3959 % timeline={% timeline configuration
3960 % dates={1310-02-03}:{1350-06-07},
3961 % timeline foreground=black,
3962 % timeline background=gray,
3963 % minor years,
3964 % timeline height=5pt,
3965 % timeline width=\textwidth,
3966 % timeline era margin=10pt,
3967 % major step font=\sffamily\bfseries,
3968 % minor step font=\sffamily\bfseries\small,
3969 % timeline minor marks,
3970 % timeline marks,
3971 % timeline years=above,
3972 % },
3973 % ]
3974 % \end{chronos}
3975 % \end{chronoscode}
3976 %
3977 % \Conceptname[idx post=configuration keys,link]{timeline} configuration \keyslabelname{} are prefixed with \texttt{timeline/} in this manual.
3978 %
3979 % \subsubsection{Timeline Dates}\label{subsubsec:timeline-dyddiadau}
3980 %^^A BEGIN subsubsec:timeline-dyddiadau
3981 %
3982 % \DescribeDatekey{timeline/dates}\cvals{start date,end date}\AfterLastParam
3983 % The fist and last date to be represented on the \conceptname[idx post=dates,link]{timeline}.
3984 % Dates must be specified as explained in \cref{subsec:dyddiadau}.
3985 % This key offers a more compact syntax as an alternative to the keys \keyname[link,idx=false,type=datekey,link prefix=timeline/]{start date,end date} (or \keyname[link,idx=false,type=datekey,link prefix=timeline/]{start,end}) explained below.
3986 % That is
3987 % \begin{chronoscode}
3988 % \begin{chronos}
3989 % [
3990 % timeline={%
3991 % dates={1310-02-03}:{1350-06-07},
3992 % % equivalent to
3993 % start date={1310-02-03},
3994 % end date={1350-06-07},
3995 % % equivalent to
3996 % start={1310-02-03},
3997 % end={1350-06-07},
3998 % },
3999 % ]
4000 % \end{chronos}
4001 % \end{chronoscode}
4002 %
4003 % \DescribeDatekey{timeline/start date,timeline/start}\valmarg{date}\AfterLastParam %^^A start/.forward to=/chronos/llinell amser/blwyddyn dechrau
4004 % The first date to represent on the \conceptname[idx post={date, first},link]{timeline}, specified as explained in \cref{subsec:dyddiadau}.
4005 % \begin{chronoscode}
4006 % \begin{chronos}
4007 % [
4008 % timeline={%
4009 % start date={1310-02-03},
4010 % % equivalent to
4011 % start={1310-02-03},
4012 % },
4013 % ]
4014 % \end{chronos}
4015 % \end{chronoscode}
4016 %
4017 % \DescribeDatekey{timeline/end date,timeline/end}\valmarg{date}\AfterLastParam %^^A end/.forward to=/chronos/llinell amser/blwyddyn diwedd
4018 % The last date to represent on the \conceptname[idx post={date, last},link]{timeline}, specified as explained in \cref{subsec:dyddiadau}.
4019 % \begin{chronoscode}
4020 % \begin{chronos}
4021 % [
4022 % timeline={%
4023 % end date={1350-06-07},
4024 % % equivalent to
4025 % end={1350-06-07},
4026 % },
4027 % ]
4028 % \end{chronos}
4029 % \end{chronoscode}
4030 %
4031 %^^A END subsubsec:timeline-dyddiadau
4032 %
4033 % \subsubsection{Timeline Dimensions}\label{subsubsec:timeline-dims}
4034 %^^A BEGIN subsubsec:timeline-dims
4035 %
4036 % See \cref{nod:dims}.
4037 %
4038 % The dimensions of the \conceptname[idx post=dimensions]{timeline} line and border are illustrated in \cref{fig:timeline-dims}.
4039 %
4040 % The total height of the \conceptname[idx post=total height as function of \string\textkey{timeline height} and \string\textkey{timeline border height}]{timeline} is a function of the dimensions \keyname[link,link prefix=timeline/,idx=false,type=dimkey]{timeline height,timeline border height}:
4041 % \[
4042 % \text{timeline height} + 2\cdot \text{timeline border height}
4043 % \]
4044 %
4045 % The total width is \keyname[link,link prefix=timeline/,idx post=as total width,type=dimkey]{timeline width}.
4046 % The width includes the width used to represent the time covered by the \conceptname[idx post=width]{timeline} and twice the \keyname[link,idx=false,type=dimkey,link prefix=timeline/]{timeline margin}.
4047 % If era labels are used, the width also includes the space used for these\texsethanks{Martin Scharrer}{56405} and the \keyname[type=dimkey,link,idx=false,idx as=timeline era margin,link to=timeline/timeline era margin]{timeline era margins}.
4048 %
4049 % For example,
4050 % \begin{chronoscode}
4051 % \begin{chronos}
4052 % [
4053 % timeline={%
4054 % timeline height=10mm,
4055 % timeline border height=2.5mm,
4056 % timeline width=200mm,
4057 % timeline mark eras,
4058 % timeline margin=5mm,
4059 % timeline era margin=2.5mm,
4060 % dates={-200}:2000,
4061 % },
4062 % ]
4063 % \end{chronos}
4064 % \end{chronoscode}
4065 % would result in a total timeline height of 15mm and a total timeline width of 200mm.
4066 % The width used to represent the years from 200 \bceyearlabel{} to 2000 \ceyearlabel{} would be
4067 % \[
4068 % 200\mathrm{mm} - 2\cdot5\mathrm{mm} - 2\cdot2.5\mathrm{mm} - \text{width of \bcelabel{} label} - \text{width of \celabel{} label}
4069 % \]
4070 % that is,
4071 % \[
4072 % 185\mathrm{mm} - \text{width of \bcelabel{} label} - \text{width of \celabel{} label}
4073 % \]
4074 %
4075 % \begin{figure}
4076 % \begin{adjustwidth}{-\tewadjust}{0pt}
4077 % \centering
4078 % \sffamily
4079 % \begin{chronos}
4080 % [
4081 % timeline={%
4082 % dates={-5}:{5-01-01},
4083 % timeline background=white,
4084 % timeline foreground=white,
4085 % timeline line={draw=black},
4086 % timeline border inner colour=white,
4087 % timeline border outer colour=white,
4088 % timeline border middle colour=white,
4089 % timeline border+={draw=black},
4090 % timeline height=30mm,
4091 % timeline border height=10mm,
4092 % timeline width=\textwidth+\tewadjust,
4093 % timeline margin=25mm,
4094 % timeline era margin=25mm,
4095 % timeline year={text height=10mm},
4096 % },
4097 % ]
4098 % \foreach \i/\j/\k/\m [count=\a] in
4099 % {
4100 % chronos pre-head/chronos top/-4/timeline border height,
4101 % chronos base/chronos pre-foot/-4/timeline border height,
4102 % chronos top/chronos base/-2/timeline height
4103 % }{
4104 % \node (n\a) at ($(\i -| chronos year \k)!.5!(chronos year \k |- \j)$) {\m};
4105 % \draw [-Latex] (n\a.north) -- (n\a.north |-\i);
4106 % \draw [-Latex] (n\a.south) -- (n\a.south |-\j);
4107 % }
4108 % \coordinate (b) at ([yshift=5pt]current bounding box.north);
4109 % \foreach \i/\j/\k/\m [count=\a] in
4110 % {
4111 % chronos pre/chronos post/b/timeline width,
4112 % chronos pre/chronos bce.west/chronos year 2.north/timeline\\margin,
4113 % chronos ce.east/chronos post/chronos year 2.north/timeline\\margin,
4114 % chronos ce.west/chronos ce.east/chronos ce.base/\celabel,
4115 % chronos bce.west/chronos bce.east/chronos bce.base/\bcelabel,
4116 % chronos bce.east/chronos start/chronos year 2.north/timeline\\era margin,
4117 % chronos end/chronos ce.west/chronos year 2.north/timeline\\era margin
4118 % }{
4119 % \node [align=center] (n\a) at ($(\i |- \k)!.5!(\k -| \j)$) {\m};
4120 % \draw [-Latex] (n\a.west) -- (n\a.west -| \i);
4121 % \draw [-Latex] (n\a.east) -- (n\a.east -| \j);
4122 % }
4123 % \foreach \i in {chronos bce.east,chronos ce.east,chronos bce.west, chronos ce.west,chronos start,chronos end}
4124 % \draw [help lines,dashed] (chronos top -| \i) -- (chronos base -| \i);
4125 % \end{chronos}
4126 % \caption{Timeline dimensions.}\label{fig:timeline-dims}
4127 % \end{adjustwidth}
4128 % \end{figure}
4129 %
4130 % \DescribeDimkey{timeline/timeline height,timeline/height}\val{dimension}\AfterLastParam
4131 % The height of the \conceptname[idx post=height]{timeline} excluding any border.
4132 % \Default
4133 % For example,
4134 % \begin{chronoscode}
4135 % timeline={
4136 % timeline height'=10mm,% we can use ' here
4137 % },
4138 % \end{chronoscode}
4139 %
4140 % \DescribeMacro{\timelineht}The \keyname[type=dimkey,no idx,link,link to=timeline/timeline height]{height of the timeline}.
4141 % This macro is available \emph{only at the end of the \conceptname[link,type=concept]{\meta{chronos preamble}} and can be considered reliable only within the \conceptname[link,type=concept]{\meta{timeline specification}}}\footnote{%^^A
4142 % Note that the unreliability applies to the internal macro, too.%^^A
4143 % }.
4144 % Despite its unreliability, early availability is essential to some \chronosstyleslabelname{} definitions.
4145 % In these cases, the \chronosstylelabelname{} is responsible for ensuring accuracy (or compensating for inaccuracy).
4146 % In standard cases, this happens automatically, even though it is not guaranteed.
4147 % However, if you neither load a \chronosstylelabelname{} nor configure dimensions explicitly, you should not try to use this macro before the \conceptname[link,no idx]{timeline} is constructed.
4148 %
4149 % \DescribeDimkey{timeline/timeline border height}\val{dimension}\AfterLastParam
4150 % The height of each of the upper and lower borders.
4151 % \Default
4152 % For example,
4153 % \begin{chronoscode}
4154 % timeline={
4155 % timeline border height'+=2.5pt,% we can use ' here
4156 % },
4157 % \end{chronoscode}
4158 %
4159 % \DescribeMacro{\timelineborderht}The \keyname[type=dimkey,no idx,link,link to=timeline/timeline border height]{height of the border}.
4160 % This macro is available \emph{only within the \conceptname[link,type=concept]{\meta{timeline specification}}}.
4161 %
4162 % \DescribeDimkey{timeline/timeline width,timeline/width}\val{dimension}\AfterLastParam
4163 % The total width of the \conceptname[idx post=total width]{timeline}, including margins.
4164 % \Default{\cs{textwidth}}
4165 % For example,
4166 % \begin{chronoscode}
4167 % timeline={
4168 % timeline width=.75\paperheight,% we cannot use ' here
4169 % timeline width'-=10mm,% we can use ' here
4170 % },
4171 % \end{chronoscode}
4172 %
4173 % \DescribeMacro{\timelinewd}The \keyname[type=dimkey,no idx,link,link to=timeline/timeline width]{width of the timeline}.
4174 % This macro is available \emph{only within the \conceptname[link,type=concept]{\meta{timeline specification}}}.
4175 %
4176 % \DescribeDimkey{timeline/timeline margin}\val{dimension}\AfterLastParam
4177 % The horizontal space to allow at each of the two ends of the \conceptname[idx post=margins]{timeline}.
4178 % \Default{15pt}
4179 % For example,
4180 % \begin{chronoscode}
4181 % timeline={
4182 % timeline margin'+=-2.5pt,% we can use ' here
4183 % },
4184 % \end{chronoscode}
4185 %
4186 % \DescribeDimkey{timeline/timeline era margin}\val{dimension}\AfterLastParam
4187 % The horizontal space to allow between the first/last point on the \conceptname[idx post=era margins,idx font post=\ConceptFont]{timeline} and the era labels.
4188 % \Default{15pt}
4189 % For example,
4190 % \begin{chronoscode}
4191 % timeline={
4192 % timeline era margin+=0.05,% we can't use ' here
4193 % },
4194 % \end{chronoscode}
4195 %
4196 % The following keys determine dimensions of the \pkg{chronos} picture as a whole.
4197 % They do not affect the dimensions of the \conceptname[idx post=dimensions]{timeline} itself.
4198 %
4199 % \DescribeDimkey{headings border}\val{dimension}\AfterLastParam
4200 % The distance between the top of the highest \keyname[idx as=levels,link to=levels,idx post=placement]{level} and the top of the space used for headers.
4201 % \Default[if there are one or more \conceptname[idx post=placement]{levels} above the timeline]{15pt + \meta{headings drop} + \meta{upper subheadings drop} + \meta{lower subheadings drop}}
4202 % \Default[otherwise]{5pt + \meta{headings drop} + \meta{upper subheadings drop} + \meta{lower subheadings drop}}
4203 %
4204 % \DescribeDimkey{headings drop}\val{dimension}\AfterLastParam
4205 % The distance between the top of the border and the \conceptname[link,idx post=placement]{headings}.
4206 % \Default[if headings are omitted]{0pt}
4207 % \Default[if headings are used]{15pt}
4208 % \emph{Note that you should set this explicitly to \texttt{0pt} if using \conceptname[idx post=without \string\textconcept{headings}]{subheadings} without \conceptname[link,no idx]{headings}.}
4209 %
4210 % \DescribeDimkey{subheadings drops}\cvalsmarg{dimension 1,dimension 2}\AfterLastParam
4211 % The distances between the \conceptname[link,idx post=placement relative to \string\textconcept{subheadings}]{headings} and upper \conceptname[link,idx post=placement]{subheadings} and between the tops of the \conceptname[link,idx post=placement]{upper subheadings,lower subheadings}.
4212 % \Default[if headings are omitted]{0pt:0pt}
4213 % \Default[if headings are used]{12pt:10pt}
4214 % \emph{Note that you should set this explicitly to \texttt{0pt:0pt}, \meta{dimension}\texttt{:0pt} or \texttt{0pt:}\meta{dimension} if using \conceptname[idx post=without \string\textconcept{upper}/\string\textconcept{lower subheadings}]{headings} without \conceptname[no idx,conj=and/or]{upper subheadings,lower subheadings} or only one of \conceptname[conj=or,idx post=as only \string\textconcept{subheadings}]{upper subheadings,lower subheadings}.}
4215 %
4216 % \DescribeDimkey{headings drops\textquotesingle,headings\textquotesingle +,headings\textquotesingle -}\cvalsmarg{dimension 1,dimension 2,dimension 3}\AfterLastParam
4217 % A convenience key equivalent to setting \keyname[type=dimkey,no idx,link to=headings drop]{headings drop\textquotesingle} to \meta{dimension 1} and \keyname[type=dimkey,no idx,link to=subheadings drops]{subheadings drops\textquotesingle} to \meta{dimension 2} and \meta{dimension 3}.
4218 % \emph{Note that only the \texttt{\textquotesingle} forms are available.}
4219 % For \pkgname[no link,no idx]{pgfmath} support, use \keyname[link,idx=false,type=dimkey]{headings drop,subheadings drops}.
4220 %
4221 % \DescribeDimkey{outer border}\val{dimension}\AfterLastParam
4222 % If a \conceptname[link,idx post=and \string\textkey{outer border}]{frame} is created, this is the outer border.
4223 % In effect, the bounding box will be set to be this distance from the \conceptname[link,idx post=and bounding box]{frame}, less half the line width used to draw it.
4224 % \Default{5pt}
4225 %
4226 % \DescribeDimkey{borders\textquotesingle,borders\textquotesingle +,borders\textquotesingle -}\cvalsmarg{dimension,dimension,dimension,dimension,dimension,dimension}\AfterLastParam
4227 % Sets the \keyname[link,idx=false,type=dimkey]{headings border,top border,right border,bottom border,left border,outer border} in one go.
4228 % \emph{Note that only the \texttt{\textquotesingle} forms are available.}
4229 % For \pkgname[no link,no idx]{pgfmath} support, use \keyname[link,idx=false,type=dimkey]{top border,right border,left border,bottom border,headings border}.
4230 %
4231 % \emph{If you're not sure what this key does or uncertain whether to use it, it is not the key you are looking for.}
4232 % Setting the \keyname[link,idx=false,type=dimkey]{outer border,headings border} suffices in most cases.
4233 %
4234 % \DescribeDimkey{top border,right border,bottom border,left border}\val{dimension}\AfterLastParam
4235 % \emph{If} the \conceptname[link,idx post=if not using bounding box]{frame} does not use the bounding box, these dimensions determine the internal margin between each of the top of the headings, the \conceptname[idx post=dimensions]{timeline}'s right end, the bottom of the lowest \keyname[idx as=levels,link to=levels,idx post=placement if \string\textconcept{frame} not using bounding box]{level}, the \conceptname[no idx]{timeline}'s left end and the \conceptname[link,no idx]{frame}, less half the line width used to draw the \conceptname[link,no idx]{frame}.
4236 % \Default{0pt}
4237 % \emph{Most people should let the frame use the bounding box\chronosdocidx[idx pre=tikzpicture,type=env,idx font pre=\KeyFont]{bounding box}, which is the default, and leave these dimensions alone.}
4238 %
4239 %^^A END subsubsec:timeline-dims
4240 %
4241 % \subsubsection{Timeline Marks and Years}\label{subsubsec:timeline-marks-years}
4242 %^^A BEGIN subsubsec:timeline-marks-years
4243 %
4244 % \Pkg{chronos} offers two primary styles of \conceptname[idx post={styles, on line \string\emph{vs.}\ off line}]{timeline}.
4245 % In one, the line has sufficient vertical depth (\keyname[link,idx=false,type=dimkey,link prefix=timeline/]{timeline height}) for years, era labels and marks to be drawn on the \conceptname[idx post={styles, on line}]{timeline} itself.
4246 % In the other, the \conceptname[idx post={styles, off line}]{timeline} may be much thinner, with marks, era labels and years drawn above or below the line.
4247 % In this case, the marks appear to grow out from the line and the year labels float slightly above or below.
4248 %
4249 % It is also possible to use \pkg{chronos} to draw a line with neither marks nor years.
4250 % Alternatively, you might want to create ‘invisible’ marks or years, which may be useful for placement purposes\footnote{%^^A
4251 % You don't need this simply to connect \elementslabelname{} to the \conceptname[no idx]{timeline}.
4252 % \pkg{chronos} doesn't depend on the creation of marks or years for that purpose.}.
4253 % \Cref{fig:timeline-dims} shows a \conceptname[idx post={marks \string\textrm{and} years\string\textrm{, invisible}},idx font post=\ConceptFont]{timeline} in which this has been done by setting the foreground and background colours equal.
4254 % The nodes are used to place the arrows and labels illustrating the various \dimkeyslabelname{}.
4255 %
4256 % \DescribeChoice{timeline/timeline years}\vals{on line,off line,above,below,none}%^^A
4257 % \chronosdocidx[type=choice,idx pre=timeline/timeline years,target prefix=timeline/timeline years/,target,idx font pre=\KeyFont]{on line,off line,above,below,none}%^^A
4258 % \AfterLastParam
4259 % Whether years (and any era labels and marks) should be created on the \conceptname[idx post={styles, \string\textconcept{marks} and \string\textconcept{years}}]{timeline}, off it or not at all and, if they should be off the \conceptname[no idx]{timeline}, whether they should be above or below it.
4260 % The options are mutually exclusive, except that \option{off line} implies either \opts[or]{above,below}.
4261 % See also \keyname[type=boolkey,link,link prefix=timeline/,idx=false]{minor years,timeline marks,timeline minor marks,timeline bare marks}, which further determine what exactly is shown.
4262 % \Default*{}none\par
4263 % \Initial{on line}
4264 %
4265 % it may actually make sense to write something like
4266 % \begin{chronoscode}
4267 % \begin{chronos}
4268 % [
4269 % timeline={%
4270 % timeline years=off line,
4271 % timeline years=none,
4272 % },
4273 % ]
4274 % \end{chronos}
4275 % \end{chronoscode}
4276 % if one wants an off-line style of line with no years or marks.
4277 % I don't know why one \emph{would} want such a thing, but the possibility is there.
4278 %
4279 % \option{none} is actually intended to support a particular style of \conceptname[type=tag,idx post=support for \string\textkey{event years on line}]{event}-only \conceptname[idx post={styles, \string\textconcept{marks} and \string\textconcept{years}, none}]{timeline}, in which the dates are created on the line itself.
4280 %
4281 % \DescribeKey{event years on line} Don't create regular year labels or marks on the \conceptname[idx post={styles, \string\textconcept{event years on line}}]{timeline} itself.
4282 % Instead, put the years of subsequently added \conceptname[type=element,idx as=event,idx post=event years on line,idx font post=\KeyFont]{events} onto the line.
4283 % This option creates a \conceptname[no idx]{timeline} suitable for showing years on the \conceptname[idx post={styles, \string\textconcept{marks} and \string\textconcept{years}, on line}]{timeline}, but doesn't create any labels when drawing the line itself.
4284 % \begin{figure}
4285 % \begin{adjustwidth}{-\tewadjust}{0pt}
4286 % \centering
4287 % %^^A ateb: http://tex.stackexchange.com/a/324448/
4288 % \begin{chronos}
4289 % [
4290 % timeline={%
4291 % timeline width=150mm,
4292 % timeline height=5mm,
4293 % start date=1935-01-01,
4294 % end date=2003-12-31,
4295 % timeline font=\sffamily\footnotesize,
4296 % timeline border height=5pt,
4297 % mark eras=false,
4298 % },
4299 % event text tag={font=\sffamily\scriptsize, fill=none},
4300 % event years on line,
4301 % ]
4302 % \chronosevent {date={2001},name=The \emph{Mr.~Men}\\Celebrate their 30\textsuperscript{th}\\Anniversary,as is,yshift=10pt,event year on line skip}
4303 % \chronosevent {date={2000},name=vouchers replace\\cash support for\\asylum seekers}
4304 % \chronosevent {date={1988},name=section 28 prevents state\\schools `promoting homosexuality',yshift=55pt}
4305 % \chronosevent {date={1984},name=miners' strike ends}
4306 % \chronosevent {date={1979},name=labour government\\falls \& thatcher\\wins power,yshift=10pt}
4307 % \chronosevent {date={1942},special date=WWII,name=people discover\\some stuff\\\& lots of people\\get killed}
4308 % \end{chronos}
4309 % \caption{Illustration of \keyname[no link]{event years on line}.}\label{fig:event-years-on-line}
4310 % \end{adjustwidth}
4311 % \end{figure}
4312 %
4313 % Assuming \keyname[type=choice,link,link prefix=timeline/,idx=false]{timeline years} is not set to \texttt{none}, as it is if \keyname[idx=false,link]{event years on line} is enabled, the following \keyslabelname{} determine how and where \pkg{chronos} represents time on (or off) the \conceptname[no idx]{timeline} itself.
4314 % The primary concepts here are those of \conceptname{major steps,minor steps}.
4315 % The space available to represent time on the \conceptname[idx post=representation of time on]{timeline} (see \cref{subsubsec:timeline-dims}) is divided into \conceptname[no idx]{major steps} and, optionally, further divided into \conceptname[no idx]{minor steps}.
4316 % These can be highlighted with \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{timeline marks, timeline minor marks} and are set using \keyname[link,link prefix=timeline/,idx=false]{step major year,step minor year}.
4317 %
4318 % In addition to \conceptsname{year}, \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{timeline bare marks} may be used to create unlabelled subdivisions at intermediate points.
4319 % In the standard case, the value of \keyname[link,link prefix=timeline/,idx=false]{step divisions} is used to divide the distance equally.
4320 % For example, if you specify 5, \pkg{chronos} will use 4 lines to subdivide each.
4321 % No attempt is made to place these so they correspond to any particular date: if you request 12, \pkg{chronos} will not make the division for February smaller than the one for December.
4322 %
4323 % However, if a \conceptname[idx post=short (temporal duration)]{timeline} is short, \pkg{chronos} proceeds differently.
4324 % ‘Short’ refers to temporal duration rather than dimension and includes any \conceptname[no idx]{timeline} which begins and ends in the same year or in consecutive years.
4325 %
4326 % \DescribeBoolkey{timeline/minor years}\vals{true,false}\AfterLastParam
4327 % Whether to label \conceptname[idx post=whether to label]{minor years}, in addition to \conceptname[no idx]{major years}.
4328 % \Default{true}
4329 % \Initial{true}
4330 %
4331 % \DescribeKey{timeline/step major year,timeline/step major years}\valmarg{positive integer}\AfterLastParam %^^A step major years/.forward to=/chronos/llinell amser/cam blwyddyn fawr
4332 % How often to label \conceptname[idx post=frequency of labelling]{major years} on the \conceptname[idx post=major years,idx font post=\ConceptFont]{timeline} if showing them.
4333 % Use this \keylabelname{} if you want a larger or bolder font and/or a different date format and/or thicker or longer \conceptname[idx post=using different styles for]{marks} to be used for some year labels.
4334 % You can also use this key if you want all year labels on the \conceptname[no idx]{timeline} to use the same format.
4335 % For example, you might want to print the full 4 digits of the year each thousand years.
4336 % \Default
4337 %
4338 % \DescribeKey{timeline/step minor year,timeline/step minor years}\valmarg{positive integer}\AfterLastParam %^^A step minor years/.forward to=/chronos/llinell amser/cam blwyddyn fach
4339 % How often to label \conceptname[idx post=frequency of labelling]{minor years} on the \conceptname[idx post=minor years,idx font post=\ConceptFont]{timeline} if displaying them.
4340 % The idea is that you might want a smaller or lighter font and/or a different date format and/or thinner or shorter \conceptname[idx post=style for \string\textconcept{minor years}]{marks} to be used for intermediate year labels.
4341 % For example, you might want to print full years only every millennium and the last 3 digits of the year each century.
4342 % \Default
4343 % \Pkg{chronos} labels \conceptname[idx post=labelled only if labelling \string\textconcept{major years}]{minor years} only if labelling \conceptname[idx post=labelling as prerequisite for \string\textconcept{minor year} labels]{major years}.
4344 % Although the package attempts to correct the result if only \conceptname[idx as=step minor year,font=\KeyFont,idx post=attempted correction if specified without \string\textconcept{major years}]{minor years} are requested, it is better to use \keyname[link,link prefix=timeline/,idx=false]{step minor year} only in conjunction with \conceptname[idx post=recommended when using \string\textkey{step minor year}]{major years}.
4345 %
4346 % \DescribeKey{timeline/step year,timeline/step years}\valmarg{positive integer}\AfterLastParam %^^A step years/.forward to=/chronos/llinell amser/cam blwyddyn
4347 % How often to label \conceptsname[idx post=frequency of labelling]{year} on the \conceptname[idx post=years,idx font post=\ConceptFont]{timeline}, if you want them all to be formatted in the same way.
4348 % This \keylabelname{} sets \keyname[link,link prefix=timeline/,idx=false]{step major years} internally and unsets \keyname[link,link prefix=timeline/,idx=false]{step minor year}.
4349 % \Default
4350 %
4351 % \Pkg{chronos} tries to label \conceptname[idx post=modulo \string\textkey{step major year} and \string\textkey{step minor year}]{years} \emph{modulo} the \keyname[link,link prefix=timeline/,idx post={years, \string\normalfont{modulo}},idx font post=\ConceptFont]{step major year,step minor year} (or \keyname[link prefix=timeline/,idx as=timeline/step year]{step year}).
4352 % This means you can start the \conceptname[idx post={years\string\normalfont, modulo},idx font post=\ConceptFont]{timeline} at 3,814 \bceyearlabel{}, request \conceptname[idx post=non-modulo start date\string\idxeg]{major years} every millennium and \conceptname[idx post=non-modulo start date\string\idxeg]{minor years} every half millennium without worrying about which year should be the first (labelled) \conceptname[idx post=first \string\emph{vs.}\space first labelled]{year}.
4353 % \begin{figure}
4354 % \begin{adjustwidth}{-\tewadjust}{0pt}
4355 % \centering
4356 % \subcaptionbox{Default selection of \conceptsname[idx post=labelled \string\textconcept{year} modulo\string\idxeg]{major years,minor years}.\label{subfig:modulo-ill}}
4357 % {%^^A
4358 % \begin{chronos}
4359 % [
4360 % timeline={%
4361 % timeline years=above,
4362 % dates={-3814}:1213,
4363 % step major year=1000,
4364 % step minor year=500,
4365 % },
4366 % ]
4367 % \end{chronos}%^^A
4368 % }\bigskip
4369 %
4370 % \subcaptionbox{Selected \conceptsname[idx post=labelled \string\textconcept{year} non-modulo\string\idxeg]{major years,minor years} with \keyname[link prefix=timeline/,idx as=timeline/step from year,idx post=and non-modulo \string\textconcept{years}\string\idxeg]{step from year}\texttt{=3810}.\label{subfig:non-modulo-ill}}
4371 % {%^^A
4372 % \begin{chronos}
4373 % [
4374 % timeline={%
4375 % timeline years=above,
4376 % dates={-3814}:1213,
4377 % step major year=1000,
4378 % step minor year=500,
4379 % step from year=-3810,
4380 % },
4381 % ]
4382 % \end{chronos}%^^A
4383 % }
4384 % \caption{Default (\cref{subfig:modulo-ill}) and non-default (\cref{subfig:non-modulo-ill}) selection of \conceptname[idx post=years \string\textnormal{modulo \string\emph{vs.}\space non-modulo}\string\idxeg,idx font post=\ConceptFont]{major years,minor years} when \keyname[link,idx=false,type=datekey]{dates}\texttt{=\{-3814\}:1213}, \keyname[link prefix=timeline/,idx as=timeline/step major year]{step major year}\texttt{=1000} and \keyname[link prefix=timeline/,idx as=timeline/step minor year]{step minor year}\texttt{=500}.}\label{fig:modulo-ill}
4385 % \end{adjustwidth}
4386 % \end{figure}
4387 % \Cref{fig:modulo-ill} illustrates \pkg{chronos}'s default choices in this case.
4388 % Note that the first year is \emph{not} determined by the start date alone in \cref{subfig:modulo-ill}, but is determined in conjunction with \keyname[link prefix=timeline/,idx as={timeline/step major year,timeline/step minor year}]{step major year,step minor year} so that -1 \bceyearlabel{} ends (and 1 \ceyearlabel{} begins) at a \conceptname[idx post=at \string\textconcept{era switch}\string\idxeg]{major year} and the turn of millennia generally occur at \conceptname[idx post=millennium\string\idxeg]{major years}, while the first \conceptname[idx post=half millennium\string\idxeg]{minor year} is 3,500 \bceyearlabel{}.
4389 %
4390 % \DescribeKey{timeline/step from year}\valmarg{integer}\AfterLastParam %^^A step from year/.forward to=/chronos/llinell amser/camu o flwyddyn
4391 % \emph{Do not use this key unless \pkg{chronos} produces undesirable results by default.}
4392 % If for some reason you do \emph{not} want \conceptsname[idx post=non-modulo configuration]{year} on the \conceptname[idx post={years\string\normalfont, not modulo},idx font post=\ConceptFont]{timeline} to be determined modulo \keyname[link,link prefix=timeline/,idx=false]{step major year,step minor year}, you may tell \pkg{chronos} where to begin stepping from.
4393 % In this case, \pkg{chronos} will issue a warning, but it will implement your choice.
4394 % \Default
4395 %
4396 % Note that \cref{subfig:non-modulo-ill} effectively includes no \conceptsname[idx post=dependent on modulo \string\textconcept{year}]{major years} because \pkg{chronos} tests whether the current \conceptname[idx post=test for \string\textconcept{major}]{year} is modulo the \keyname[link,link prefix=timeline/,idx=false]{step major year} when deciding how to format the year label and \conceptsname[idx post=effect of non-modulo \string\textconcept{year}]{marks}.
4397 %
4398 % \DescribeCoord{chronos year \meta{YYYY},chronos year -\meta{YYYY}}
4399 % \DescribeNode{chronos year \meta{YYYY},chronos year -\meta{YYYY}}
4400 % Every \conceptname[idx post=name]{major year,minor year} receives a name: a \texttt{node} or \texttt{coordinate} is created with the name \texttt{chronos year YYYY} for \ceyearlabel{} and \texttt{chronos year -YYYY} for \bceyearlabel{}.
4401 % No zeros are added, so years with fewer than four digits get nodes or coordinates with names such as \texttt{chronos year -1}.
4402 % \Pkg{chronos} creates all \conceptsname[idx post=marked at start]{year} at the beginning of the year i.e.~1\textsuperscript{st} January.
4403 % (This is analogous to a ruler which marks each centimetre at its beginning.)
4404 %
4405 % \DescribeCoord{chronos origin}
4406 % If the \conceptname[idx font post=\KeyFont,idx post=chronos origin \string\textnormal{dependant on }\string\textconcept{era switch}]{timeline} spans the switch of eras from \bceyearlabel{} to \ceyearlabel{} \emph{and} the \conceptname[idx font post=\KeyFont,idx post=chronos origin \string\textnormal{dependant on configuration modulo}]{years} represented on the \conceptname[idx post={years\string\normalfont, modulo},idx font post=\ConceptFont]{timeline} are modulo \keyname[link,link prefix=timeline/,idx=false,conj=or){step major year,step minor year} (as they are by default], an additional coordinate named \texttt{chronos origin} is created at the era switch point, \texttt{chronos year 1}.
4407 %
4408 % \DescribeCoord{chronos year 0}
4409 % If \keyname[link,idx=false,type=boolkey,link prefix=timeline/]{year zero} is \texttt{false}, as it is by default, a third coordinate named \texttt{chronos year 0} is created at \keyname[type=coord,no link]{chronos origin}\footnote{%^^A
4410 % So the non-existent year zero is marked at the same point as the existent year one.
4411 % This avoids complications in \keyname[type=macro,no link]{\cs{foreach}} loops.}.
4412 %
4413 %^^A By default, \pkg{chronos} calculates all the \conceptsname{year} to label on (or off) the \conceptname{timeline} from the \keyname[link,idx=false,type=datekey]{start date} and \keyname[link prefix=timeline/]{step major year,step minor year}, including any calculated defaults and \chronosstylelabelname{} and/or user-specified values.
4414 %
4415 % \DescribeKey{timeline/step divisions}\valmarg{positive integer}\AfterLastParam %^^A step divisions/.forward to=/chronos/llinell amser/camau bach
4416 % Whether the \conceptname[idx post=step divisions,idx font post=\ConceptFont]{timeline} should be further subdivided between \conceptname[conj=and/or,idx as={major years,minor years},idx post=dividing with \string\textconcept{bare marks}]{major,minor years} using \conceptname[idx post=setting,no link]{bare marks} and, if so, how many sub-divisions should be made.
4417 % These are simple subdivisions of the distance between points.
4418 % Unlike the labels/marks made for \conceptname[idx post=cf.~\string\textconcept{bare marks}]{years}, they do not involve calculations involving dates and are not named.
4419 % \Default
4420 %
4421 % \DescribeKey{timeline/timeline year}\valmarg{key-value list}\AfterLastParam %^^A timeline year/.forward to=/chronos/timeline year@too
4422 % \emph{Adds} \meta{key-value list} to the common \stylelabelname{} used when putting \conceptname[idx post={style in common with}]{major years,minor years} onto the \conceptname[idx post={years\string\textnormal{, style}},idx font post=\ConceptFont]{timeline}.
4423 % Do not specify \keyname[no link,idx post=will be overridden]{font} or \keyname[no link,idx post=will be overridden]{anchor} here as they will be overridden.
4424 % Although both \conceptname[idx as={major years,minor years},idx post={style differentiated from}]{major,minor years} use the same general \stylelabelname{}, they may and, by default do, use different fonts and \dateformatslabelname{}.
4425 % \Example{timeline/timeline year={fill=chronos timeline background colour}}
4426 % \Default[off line]{text\val{timeline foreground}, text opacity=1, align=center, fill opacity=.75}
4427 % \Default[on line]{text\val{timeline foreground}, anchor=center}
4428 %
4429 %^^A \DescribeStyle{timeline year off line,timeline year on line}
4430 %^^A If you wish to \emph{replace} the \styleslabelname{} used to format the \conceptsname{year}, you may redefine the relevant \stylelabelname{}.
4431 %^^A \begin{chronoscode}
4432 %^^A \begin{chronos}
4433 %^^A [
4434 %^^A timeline years=on line,
4435 %^^A timeline year on line/.style={text=magenta},% for magenta years
4436 %^^A ]
4437 %^^A \end{chronos}
4438 %^^A \end{chronoscode}
4439 %^^A \Default[timeline year off line]{text\val{timeline foreground}, text opacity=1, align=center, fill opacity=.75}
4440 %^^A \Default[timeline year on line]{text\val{timeline foreground}, anchor=center}
4441 %
4442 % \DescribeKey{timeline/timeline years anchor}\valmarg{text}\AfterLastParam
4443 % The \TikZ{} \keyname[no link,idx post=for \string\textconcept{years}]{anchor} to use when creating the \texttt{nodes} for \conceptname[idx post=set \string\TikZ{} anchor]{years} on or off the \conceptname[idx post={years\string\textrm{,} \string\texttt{anchor}},idx font post=\ConceptFont]{timeline}.
4444 % \emph{Do not set this option unless you know you need to.}
4445 % In most cases, \pkg{chronos} will pick a sensible default.
4446 % The \keylabelname{} is provided primarily for cases where you want to rotate the \conceptname[idx post=rotate labels]{year} labels in \styleslabelname{} which place them off the \conceptname[type=key,no idx,link,link to=timeline/timeline line]{line}.
4447 % Even then, you should not need to change the setting if using a \stylelabelname{} designed for rotation, unless you need to change the angle.
4448 % \Default
4449 %
4450 % \DescribeBoolkey{timeline/timeline marks}\vals{true,false}\AfterLastParam
4451 % Whether to draw vertical marks on or off the \conceptname[idx post=marks,idx font post=\ConceptFont]{timeline} at \conceptname[idx post=setting \string\textconcept{marks}]{major years} using the \stylelabelname{} set with \keyname[link,link prefix=timeline/,idx=false]{timeline mark}.
4452 % \Default{true}
4453 % \Initial{true}
4454 %
4455 % \DescribeBoolkey{timeline/timeline minor marks}\vals{true,false}\AfterLastParam
4456 % Whether to draw vertical marks on or off the \conceptname[idx post=minor marks,idx font post=\ConceptFont]{timeline} at \conceptname[idx post=setting \string\textconcept{minor marks}]{minor years} using the \stylelabelname{} set with \keyname[link,link prefix=timeline/,idx=false]{timeline minor mark}.
4457 % \Default{true}
4458 % \Initial{true}
4459 %
4460 % \DescribeBoolkey{timeline/timeline show years}\vals{true,false}\AfterLastParam
4461 % Whether to represent years on or off the \conceptname[idx post=years,idx font post=\ConceptFont]{timeline} at all.
4462 % If false, neither labels nor marks will be added when the \conceptname[no idx]{timeline} is constructed.
4463 % This is useful if you wish to use a \stylelabelname{} such as \keyname[link,idx=false]{event years on line}, but is the nuclear option otherwise.
4464 % \Default{true}
4465 % \Initial{true}
4466 %
4467 %
4468 % \DescribeBoolkey{timeline/timeline bare marks}\vals{true,false}\AfterLastParam
4469 % Whether to draw \conceptname{bare marks} on or off the \conceptname[idx post=bare marks,idx font post=\ConceptFont]{timeline} in between \conceptsname[no idx]{year}\footnote{If your \conceptname[no idx]{timeline} is very short and 12 \keyname[link,link prefix=timeline/,idx=false]{step divisions} are set, \pkg{chronos} will actually mark months.
4470 % In other cases, marks simply divide the available space and are not placed by date.} using the \stylelabelname{} set by \keyname[link,link prefix=timeline/,idx=false]{timeline bare mark}.
4471 % If you specify \keyname[link,link prefix=timeline/,idx=false]{step divisions}, this \keylabelname{} will be automatically enabled.
4472 % If you don't want bare marks, don't set/set to zero \keyname[link,link prefix=timeline/,idx=false]{step divisions}.
4473 % \Default{true}
4474 % \Initial{false}
4475 %
4476 % \DescribeKey{timeline/timeline mark}\valmarg{key-value list}\AfterLastParam %^^A timeline mark/.forward to=/chronos/timeline mark@too
4477 % \emph{Adds} to the \stylelabelname{} used for the vertical lines drawn when \pkg{chronos} labels a \conceptname[idx post=marks,idx font post=\ConceptFont]{major year} on or off the \conceptname[idx post={marks, adding to style},idx font post=\ConceptFont]{timeline} and \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{timeline marks} is true.
4478 % These correspond to the \conceptname{major steps} at which \pkg{chronos} puts \conceptname[idx post=marks \string\textnormal{for }major,idx font post=\ConceptFont]{years}.
4479 % \Example{timeline mark={thick}}
4480 % \Default[off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, thin, shorten >=-2.5pt}
4481 % \Default[on line]{draw\val{timeline foreground}}
4482 %
4483 % \DescribeKey{timeline/timeline minor mark}\valmarg{key-value list}\AfterLastParam %^^A timeline minor mark/.forward to=/chronos/timeline minor mark@too
4484 % \emph{Adds} \meta{key-value list} to the \stylelabelname{} used for the vertical lines drawn when \pkg{chronos} labels a \conceptname{minor year} on or off the timeline and \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{timeline minor marks} is true.
4485 % These correspond to the \conceptname[idx post=marks\string\textnormal{ at},idx font post=\ConceptFont]{minor steps} at which \pkg{chronos} puts \conceptname[idx post=at \string\textconcept{minor steps}]{years}.
4486 % \Example{timeline mark={thin, shorten >=-2pt}}
4487 % \Default[off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, very thin, shorten >=-2.5pt}
4488 % \Default[on line]{draw\val{timeline foreground}, thin}
4489 %
4490 % \DescribeKey{timeline/timeline bare mark}\valmarg{key-value list}\AfterLastParam %^^A timeline bare mark/.forward to=/chronos/timeline bare mark@too
4491 % \emph{Adds} \meta{key-value list} to the \stylelabelname{} used to draw lines at \keyname[link,link prefix=timeline/,idx=false]{step divisions}, provided \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{timeline marks} is true.
4492 % \Example{timeline bare mark={thin, <-}}
4493 % \Default[off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, very thin, shorten >=-1.5pt}
4494 % \Default[on line]{draw\val{timeline foreground}, thick}
4495 %
4496 % \DescribeKey{timeline/timeline all marks}\valmarg{key-value list}\AfterLastParam %^^A timeline all marks/.forward to=/chronos/timeline bare mark@too
4497 % \emph{Adds} to the \styleslabelname{} used to draw lines at \conceptname[idx post=common configuration]{major years,minor years,step divisions}.
4498 % This is equivalent to passing \meta{key-value list} to each of \keyname[link,link prefix=timeline/,idx=false]{timeline mark,timeline minor mark,timeline bare mark}.
4499 %
4500 %^^A \DescribeStyle{timeline mark off line,timeline mark on line,timeline minor mark off line,timeline minor mark on line,timeline bare mark off line,timeline bare mark on line}If you wish to \emph{replace}, as opposed to modifying, the \styleslabelname{} used for rendering \conceptname{marks}, you can redefine the relevant \styleslabelname{}.
4501 %^^A \emph{Note that \cs{draw} is required for visible \conceptname{marks}.}
4502 %^^A \begin{chronoscode}
4503 %^^A \begin{chronos}
4504 %^^A [
4505 %^^A timeline years=below,
4506 %^^A timeline mark off line/.style={-{Circle}, thick, draw=gray, shorten >=-4pt},
4507 %^^A timeline minor mark off line/.style={-{Circle}, thin, draw=gray, shorten >=-3pt},
4508 %^^A timeline bare mark off line/.style={-{Circle}, ultra thin, draw=gray, shorten >=-2pt},
4509 %^^A ]
4510 %^^A \end{chronos}
4511 %^^A \end{chronoscode}
4512 %^^A \Default[timeline mark off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, thin, shorten >=-2.5pt}
4513 %^^A \Default[timeline mark on line]{draw\val{timeline foreground}}
4514 %^^A \Default[timeline minor mark off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, very thin, shorten >=-2.5pt}
4515 %^^A \Default[timeline minor mark on line]{draw\val{timeline foreground}, thin}
4516 %^^A \Default[timeline bare mark off line]{draw\val{timeline foreground}, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-, very thin, shorten >=-1.5pt}
4517 %^^A \Default[timeline bare mark on line]{draw\val{timeline foreground}, thick}
4518 %
4519 % \DescribeStyle{event year on line}
4520 % The \stylelabelname{} used to mark \conceptsname[idx post=event year on line,idx font post=\KeyFont]{year} on the \conceptname[idx post=event year on line,idx font post=\KeyFont]{timeline} if \keyname[idx=false,link]{event years on line} is enabled.
4521 % By default, the \stylelabelname{} otherwise used for \conceptsname[no idx]{year} when on the line is used.
4522 % Redefine this if you wish, but you could also use \keyname[link,link prefix=timeline/,idx=false,type=choice]{timeline years}, since no other \conceptsname[idx post=unmarked]{year} will be set on the line anyway.
4523 %
4524 % \DescribeKey{event year on line skip}
4525 % Don't put this particular event's year on the \conceptname[idx post=skip{\string\ttfamily\string\space\ event year on line}]{timeline}.
4526 % This can be used if the line would otherwise become too crowded.
4527 % See \cref{subsec:add-elements-lconfig}.
4528 %
4529 % \DescribeStyle{timeline/era switch off line}
4530 % The \stylelabelname{} to use if years are ‘off line’ and \keyname[link,link prefix=timeline/,idx=false,type=boolkey]{mark at era switch} is \texttt{true}.
4531 % With the standard settings, you would get a small mark at the switch, no different from other intermediate marks.
4532 % Likely you want something more similar in stature to the year labels.
4533 % Redefine or supplement using standard \TikZ{} techniques.
4534 % \Default{thick, shorten >=0pt}
4535 % \begin{chronoscode}
4536 % \begin{chronos}
4537 % [
4538 % timeline={%
4539 % era switch off line/.append style={ultra thick},% retain undoing of shortening in default, but make mark thicker
4540 % era switch off line/.style={ultra thick, shorten>=-2pt},% make mark thicker and longer
4541 % era switch off line/.style={shorten>=-2pt},% make mark longer but use whatever thickness is used for other marks
4542 % },
4543 % ]
4544 % \end{chronos}
4545 % \end{chronoscode}
4546 %
4547 %^^A END subsubsec:timeline-marks-years
4548 %
4549 % \subsubsection{Timeline Fonts}\label{subsubsec:timeline-fonts}
4550 %^^A BEGIN subsubsec:timeline-fonts
4551 %
4552 % \DescribeKey{major step font}\valmarg{key-value list}\AfterLastParam %^^A major step font/.forward to=/chronos/llinell amser/ffont camau mawr
4553 % The font used for \conceptname[idx post=font]{major years}.
4554 % \Default{\sffamily\bfseries}
4555 % \begin{chronoscode}
4556 % \begin{chronos}
4557 % [
4558 % timeline={%
4559 % major step font=\sffamily,
4560 % },
4561 % ]
4562 % \end{chronos}
4563 % \end{chronoscode}
4564 %
4565 %
4566 % \DescribeKey{timeline/minor step font}\valmarg{key-value list}\AfterLastParam %^^A minor step font/.forward to=/chronos/llinell amser/ffont camau bach
4567 % The font used for \conceptname[idx post=font]{minor years}.
4568 % \Default{\sffamily}
4569 % \begin{chronoscode}
4570 % \begin{chronos}
4571 % [
4572 % timeline={%
4573 % minor step font=\sffamily\small,
4574 % },
4575 % ]
4576 % \end{chronos}
4577 % \end{chronoscode}
4578 %
4579 % \DescribeKey{timeline/eras font}\valmarg{key-value list}\AfterLastParam %^^A eras font/.forward to=/chronos/llinell amser/ffont cyfnodau
4580 % The font used for era labels on the \conceptname[idx post={font}]{timeline}.
4581 % \Default{\sffamily\bfseries}
4582 % \begin{chronoscode}
4583 % \begin{chronos}
4584 % [
4585 % timeline={%
4586 % eras font=\sffamily\bfseries\large,
4587 % },
4588 % ]
4589 % \end{chronos}
4590 % \end{chronoscode}
4591 %
4592 %^^A END subsubsec:timeline-fonts
4593 %
4594 % \subsubsection{Timeline Colours}\label{subsubsec:timeline-lliwiau}
4595 %^^A BEGIN subsubsec:timeline-lliwiau
4596 %
4597 % \DescribeColkey{timeline/timeline border inner colour,timeline/timeline border inner color}\val{colour name}\AfterLastParam
4598 % The innermost colour used for the gradient used to shade the \conceptname[type=element,idx as=timeline border,idx post=colour configuration]{timeline borders}, if any.
4599 % This colour is accessible within the \enviro{chronos} environment as \keyname[link,idx=false,type=colour,conj=or]{chronos timeline border inner colour,chronos timeline border inner color}.
4600 % \Default*{}the \keyname[link,link prefix=timeline/,idx=false,type=colkey]{timeline background} colour, which is itself \texttt{black} by default.
4601 % \begin{chronoscode}
4602 % \begin{chronos}
4603 % [
4604 % timeline={%
4605 % timeline border inner colour=blue,
4606 % },
4607 % ]
4608 % \end{chronos}
4609 % \end{chronoscode}
4610 %
4611 % \DescribeColkey{timeline/timeline border outer colour,timeline/timeline border outer color}\val{colour name}\AfterLastParam
4612 % The outermost colour used for the gradient used to shade the \conceptname[type=element,idx as=timeline border,idx post=colour configuration]{timeline borders}, if any.
4613 % This colour is accessible within the \enviro{chronos} environment as \keyname[link,idx=false,type=colour,conj=or]{chronos timeline border outer colour,chronos timeline border outer color}.
4614 % \Default*{}the \keyname[type=colkey,no idx]{background} colour, which is itself \texttt{white} by default.
4615 % \begin{chronoscode}
4616 % \begin{chronos}
4617 % [
4618 % timeline={%
4619 % timeline border outer colour=green!5!white,
4620 % },
4621 % ]
4622 % \end{chronos}
4623 % \end{chronoscode}
4624 %
4625 % \DescribeColkey{timeline/timeline border middle colour,timeline/timeline border middle color}\val{colour name}\AfterLastParam
4626 % The middle colour used for the gradient used to shade the \conceptname,idx post=colour configuration[type=element,idx as=timeline border]{timeline borders}, if any.
4627 % This colour is accessible within the \enviro{chronos} environment as \keyname[link,idx=false,type=colour,conj=or]{chronos timeline border middle colour,chronos timeline border middle color}.
4628 % \Default*{}a 50-50 mix of the \keyname[link,idx=false,type=colkey,link prefix=timeline/]{timeline border outer colour,timeline border inner colour}.
4629 % \begin{chronoscode}
4630 % \begin{chronos}
4631 % [
4632 % timeline={%
4633 % timeline border middle colour=blue!20!green,
4634 % },
4635 % ]
4636 % \end{chronos}
4637 % \end{chronoscode}
4638 %
4639 % \DescribeColkey{timeline/timeline background}\val{colour name}\AfterLastParam
4640 % The colour used for the background of the central part of the \conceptname[idx post=colours,idx font post=\ConceptFont]{timeline}.
4641 % This colour is accessible within the \enviro{chronos} environment as \keyname[link,idx=false,type=colour,conj=or]{chronos timeline background colour,chronos timeline background color}.
4642 % \Default*{}the \keyname[type=colkey,no idx]{foreground} colour, which is itself \texttt{black} by default (if putting years/marks on the line).
4643 % \Default*{}the \keyname[type=colkey,no idx]{background} colour, which is itself \texttt{white} by default (otherwise).
4644 % \begin{chronoscode}
4645 % \begin{chronos}
4646 % [
4647 % timeline={%
4648 % timeline background=blue,
4649 % },
4650 % ]
4651 % \end{chronos}
4652 % \end{chronoscode}
4653 %
4654 % \DescribeColkey{timeline/timeline foreground}\val{colour name}\AfterLastParam
4655 % The colour used for the foreground of the central part of the \conceptname[idx post=colours,idx font post=\ConceptFont,no idx]{timeline}.
4656 % This colour is accessible within the \enviro{chronos} environment as \keyname[link,idx=false,type=colour,conj=or]{chronos timeline foreground colour,chronos timeline foreground color}.
4657 % \Default*{}the \keyname[type=colkey,no idx]{background} colour, which is itself \texttt{white} by default (if putting years/marks on the line).
4658 % \Default*{}the \keyname[type=colkey,no idx]{foreground} colour, which is itself \texttt{black} by default (otherwise).
4659 % \begin{chronoscode}
4660 % \begin{chronos}
4661 % [
4662 % timeline={%
4663 % timeline foreground=green!5!white,
4664 % },
4665 % ]
4666 % \end{chronos}
4667 % \end{chronoscode}
4668 %
4669 % \begin{figure}
4670 % \centering
4671 % \begin{chronos}
4672 % [
4673 % timeline={%
4674 % dates={-2:2},
4675 % mark at era switch=false,
4676 % timeline border inner colour=blue,
4677 % timeline border outer colour=green!5!white,
4678 % timeline border middle colour=blue!20!green,
4679 % timeline background=blue,
4680 % timeline foreground=green!5!white,
4681 % },
4682 % background=magenta,
4683 % foreground=red,
4684 % ]
4685 % \end{chronos}
4686 % \caption{Cumulative effect of colour settings given as examples in \cref{subsubsec:timeline-lliwiau,subsec:lliwiau}.}\label{fig:timeline-lliwiau-ee}
4687 % \end{figure}
4688 %
4689 % The cumulative effect of the colour settings given in the examples in this \namecref{subsubsec:timeline-lliwiau}, together with the \keyname[type=colkey]{background,foreground} from \cref{subsec:lliwiau} is shown in \cref{fig:timeline-lliwiau-ee}.
4690 %
4691 %
4692 %^^A END subsubsec:timeline-lliwiau
4693 %
4694 % \subsubsection{Timeline Style}\label{subsubsec:timeline-style}
4695 %^^A BEGIN subsubsec:timeline-style
4696 %
4697 % The \conceptname[link,idx post=style]{timeline}'s overall style can be customised using the following \keyslabelname{}, which should (and, by default, do) utilise \conceptname[idx pre=timeline,idx font pre=\ConceptFont]{colours} from the \conceptname[link,no idx,type=concept]{colour scheme} (see \cref{subsec:chronos-style-creation}).
4698 % Unless you are creating a \conceptname[type=concept,link,no idx]{chronos style}, it is best to \emph{add to} rather than \emph{replacing} the existing configuration.
4699 % For example, if you wish the line to take the form of an arrow, you can simply add the use of an appropriate arrow tip, without modifying the colours, dimensions or markings.
4700 %
4701 % \DescribeKey{timeline/timeline line,timeline/timeline line\textquotesingle,timeline/timeline line+}\valmarg{key-value list}\AfterLastParam
4702 % The style of the \conceptname[link,idx pre=timeline,idx font pre=\ConceptFont]{timeline line}.
4703 % \keyname[no idx]{timeline/timeline line+} adds to the current list; \keyname[no idx]{timeline/timeline line,timeline/timeline line\textquotesingle} replace it.
4704 % \Default{empty}
4705 % \Initial
4706 % This \keylabelname{} makes it possible to override the default drawing or filling of the \conceptsname[no idx,link]{timeline line}.
4707 %
4708 % For example, \keyname[type=chronosstyle,idx post=use of \string\textkey{timeline line}\string\idxeg]{blues below} includes the following in its \conceptname[link,idx post={configuration, \string\textkey{timeline line}}]{timeline} configuration,
4709 % \begin{chronoscode}
4710 % timeline={%
4711 % ...
4712 % timeline line={Bar-Latex,chronos timeline foreground colour,double=chronos timeline background colour,line width=\timelineht/3,double distance=\timelineht/3,shorten <=-\timelineht/3,shorten >=-3pt-2.1\timelineht},
4713 % timeline config+={\pgfqkeys{/chronos/timeline}{timeline width-={3pt+2.43\timelineht}}},
4714 % ...
4715 % }
4716 % \end{chronoscode}
4717 %
4718 % To make the \conceptname[no idx]{timeline line} into an arrow, without otherwise modifying the existing style, use, for example,
4719 % \begin{chronoscode}
4720 % timeline={%
4721 % ...
4722 % timeline line+={shorten >={-10mm}, -{Triangle Cap[length=10mm]}},
4723 % timeline config+={\pgfqkeys{/chronos/timeline}{timeline width-=10mm}},
4724 % ...
4725 % }
4726 % \end{chronoscode}
4727 % The adjustments are required to ensure that the tapered part is not counted when \enviro{chronos} calculates how much of the total \keyname[idx pre=timeline,link pre=timeline/,idx font pre=\KeyFont,type=dimkey]{timeline width} is available to represent time.
4728 %
4729 % \DescribeBoolkey{timeline/timeline arrow}\vals{true,false}\AfterLastParam
4730 % Whether the \conceptname[link,no idx]{timeline} should be or have an arrow or arrows.
4731 % \Default{true}
4732 % \Initial{false}
4733 % \emph{Whether this has any effect depends entirely on the \chronosstylelabelname{}.
4734 % With the default settings, it does nothing but trigger a warning, since \texttt{on line} \styleslabelname{} cannot have arrows.}
4735 %
4736 % \DescribeKey{timeline/no timeline arrow}%^^A
4737 % A convenience \keylabelname{} which sets \keyname[type=boolkey,no idx]{timeline/timeline arrow} \texttt{false}.
4738 % \emph{Whether this has any effect depends entirely on the \chronosstylelabelname{}.}
4739 %
4740 % \DescribeKey{timeline/timeline border,timeline/timeline border\textquotesingle,timeline/timeline border+}\valmarg{key-value list}\AfterLastParam
4741 % The style of the \conceptname[link,idx pre=timeline,idx font pre=\ConceptFont]{timeline border}.
4742 % \keyname[no idx]{timeline/timeline border+} adds to the current list; \keyname[no idx]{timeline/timeline border,timeline/timeline border\textquotesingle} replace it.
4743 % \Default{empty}
4744 % \Initial
4745 % This \keylabelname{} makes it possible to override the default gradients used to fill the \conceptsname[no idx,link,link to=timeline/timeline border]{border}.
4746 %
4747 %^^A END subsubsec:timeline-style
4748 %
4749 %^^A END subsec:llinell-amser
4750 %
4751 % \subsection{Frame}\label{subsec:frame}
4752 %^^A BEGIN subsec:frame
4753 %
4754 % \DescribeBoolkey{frame}\vals{true,false}\AfterLastParam
4755 % Whether to draw a frame.
4756 % This is initially false, but use of \keyname[no idx,link]{main/frame} will automatically set it to true.
4757 % \Default{true}
4758 % \Initial{false}
4759 %
4760 % \DescribeBoolkey{frame uses bb}\vals{true,false}\AfterLastParam
4761 % Whether the bounding box should be used to determine any frame at the end of the \enviro{chronos} environment.
4762 % This is true by default and almost certainly what you want unless you are smuggling code into the end of the environment or using the frame for nefarious purposes.
4763 % \Default{true}
4764 % \Initial{true}
4765 %
4766 % \DescribeKey{main/frame,main/frame\textquotesingle,main/frame+}\valmarg{key-value list}\AfterLastParam
4767 % The style of the \TikZ{} \texttt{node} used to draw the \keyname[type=boolkey,idx post=style]{frame}.
4768 % This may be freely redefined as desired.
4769 % \Default[empty]
4770 % \Example{main/frame=\{draw=black,ultra thick,inner sep=5pt\}}
4771 % \Example{main/frame+=\{double=blue\}}
4772 % The second form may be useful if you wish to modify, rather than replace, a style defined by a \conceptname[type=chronosstyle,idx as=modifying,font=\normalfont]{\chronosstylelabelname}.
4773 % \keyname[link,no idx]{main/frame,main/frame\textquotesingle} replace any current list; \keyname[link,no idx]{main/frame+} adds to it.
4774 %
4775 %
4776 %^^A END subsec:frame
4777 %
4778 % \subsection{Placing Things: Levels \& Coordinates}\label{subsec:levels-coords}
4779 %^^A BEGIN subsec:levels-coords
4780 %
4781 % Knowing where to put things may get tricky in complicated or densely-packed \conceptname[idx as=timeline,idx post=densely packed]{timelines}.
4782 % \Pkg{chronos} offers several techniques to help.
4783 % The simplest is to simply use existing items as reference points.
4784 % \Pkg{chronos} names coordinates and nodes routinely and predictably, as explained throughout this documentation.
4785 % However, sometimes this isn't quite enough.
4786 % \Conceptname[idx post=help with placement,link]{levels,chronos coordinates} offer additional help with vertical and horizontal placement respectively.
4787 %
4788 % \subsubsection{Levels}\label{subsubsec:levels}\chronosdochypertargets{element}{}{levels,level}
4789 %^^A BEGIN subsubsec:levels
4790 %
4791 % \Conceptname{levels} are not (generally) visible \elementslabelname{}.
4792 % They are instead part of the structure behind-the-scenes.
4793 % They are, if you like, minimal stage-hands.
4794 %
4795 % The idea is to tell \pkg{chronos} how many tiers (approximately) of \elementslabelname{} you will create above and below the \conceptname[idx post=levels,idx font post=\ConceptFont]{timeline}.
4796 % For each of these levels, \pkg{chronos} creates a standardised node or \keyname[type=choice,idx as=placeholders,link to=placeholders,idx post=levels,idx font post=\ConceptFont]{placeholder} based on the settings used for \elementslabelname{} of type \conceptname[type=tag,idx post=as basis for \string\textconcept{levels}]{life} when the \conceptname[no idx]{timeline} is constructed.
4797 % Each of these nodes is named: \texttt{level 1}, \texttt{level 2}, \dots{} above the \conceptname[no idx]{timeline} and \texttt{level -1}, \texttt{level -2}, \dots{} below\footnote{You can also refer to the nodes above as \texttt{u1}, \texttt{u2} etc.\ and those below as \texttt{i1}, \texttt{i2} etc\@.}.
4798 % The first node in each direction is shifted \texttt{2pt} from the \conceptname[no idx]{timeline}.
4799 % Subsequent nodes are created directly above each other, with no separation between.
4800 %
4801 % Together with points on the \conceptname[no idx]{timeline}, you then have a crude system for placing things horizontally and vertically.
4802 % It also enables you to ‘stack’ \conceptname[idx as=text tag,idx post=stacking]{text tags}, but create them in any order.
4803 %
4804 % \DescribeKey{levels}\cvalsmarg{number above,number below}\AfterLastParam %^^A levels/.forward to=/chronos/lefelau
4805 % \meta{number above} and \meta{number below} should be non-negative integers specifying how many levels to create above and below the \conceptname[idx post={levels\string\textnormal{, creating}},idx font post=\ConceptFont]{timeline} respectively.
4806 % \Default{}no number of \keyname[no idx]{levels} are created by default (not even zero).
4807 % \begin{chronoscode}
4808 % \begin{chronos}
4809 % [
4810 % levels=4:4,
4811 % ]
4812 % \end{chronos}
4813 % \end{chronoscode}
4814 %
4815 % \DescribeKey{levels at}\valmarg{coordinate}\AfterLastParam %^^A levels at/.forward to=/chronos/lefelau at
4816 % Although they are not intended to be visible in the \conceptname[idx post={levels\string\textnormal{, rendering visible}},idx font post=\ConceptFont]{timeline}, placeholder nodes may be rendered visible for debugging or development purposes.
4817 % As such, it may be useful to move them from their default location.
4818 % \Default{chronos mid}
4819 % \begin{chronoscode}
4820 % \begin{chronos}
4821 % [
4822 % levels at=chronos year -200,% make sure this exists!
4823 % ]
4824 % \end{chronos}
4825 % \end{chronoscode}
4826 %
4827 % To render the nodes temporarily visible, see \cref{sec:dadfygio}.
4828 %
4829 %^^A END subsubsec:levels
4830 %
4831 % \subsubsection{Chronos Coordinates}\label{subsubsec:chronos-coords}\chronosdochypertargets{element}{}{chronos coords,chronos coordinate,chronos coordinates,chronos coord}
4832 %^^A BEGIN subsubsec:chronos-coords
4833 %
4834 % In addition to the coordinates and nodes shown in \cref{fig:anatomi-coords}, \pkg{chronos} names a coordinate or node \texttt{chronos year \meta{year}} for each year represented on the \conceptname[idx post=coordinates]{timeline}.
4835 % However, depending on your preferred style, this may not provide sufficient horizontal reference points.
4836 % In that case, you can create additional coordinates.
4837 % Like \conceptname[idx post=cf.~\string\textconcept{chronos coordinates},link]{levels}, \conceptname[idx post=cf.~\string\textconcept{levels},link]{chronos coordinates} are not ordinarily visible; unlike \conceptname[no idx]{levels}, there is nothing there to see\footnote{You could label them, of course, but they are just regular \pgf/\TikZ{} coordinates and so naturally invisible.}.
4838 %
4839 % \DescribeClistkey{chronos coords}\valmarg{comma-separated list of years}\AfterLastParam
4840 % For each \meta{year} in \meta{comma-separated list of years}, \pkg{chronos} will place a single coordinate named \texttt{chronos year \meta{year}} at the appropriate point on the \conceptname[idx post={coordinates, creating additional}]{timeline}.
4841 % These may be used together with \conceptname[no idx,link]{levels} to specify coordinates e.g.~\texttt{(chronos year \meta{year} \textbar- level \meta{n})} is the point vertically aligned with \texttt{level \meta{n}} and horizontally aligned with \texttt{chronos year \meta{year}}.
4842 % \Default{empty}
4843 %
4844 %^^A END subsubsec:chronos-coords
4845 %
4846 % \subsubsection{Miscellaneous}\label{subsubsec:misc}
4847 %^^A BEGIN subsubsec:misc
4848 %
4849 % \DescribeMacro{\chronosbaselineskip}The \enviro{chronos} \envlabelname{} sets this \macrolabelname{} equal to the current \keyname[type=macro,no link]{\cs{baselineskip}}.
4850 % It may be used to fine-tune placement in the same way you might use \cs{baselineskip} outside a \keyname[type=env,no link,idx post=\string\cs{chronosbaselineskip}]{tikzpicture}.
4851 %
4852 %^^A END subsubsec:misc
4853 %
4854 %^^A END subsec:levels-coords
4855 %
4856 % \subsection{Headings}\label{subsec:headings}
4857 %^^A BEGIN subsec:headings
4858 %
4859 % \DescribeClistkey{headings,headings+,headings\textquotesingle}\tuplelistvalsmarg{text/coordinate 1/coordinate 2,text/coordinate 1/coordinate 2,\dots}\AfterLastParam
4860 % List of value triplets in the format used by \pgf{}'s \cs{foreach}.
4861 % The list should consist of one or more triplets where \meta{text} is used in capitalised form for the content of a node which will be aligned with \texttt{chronos main headings} vertically and placed midway between the horizontal positions of \meta{coordinate 1} and \meta{coordinate 2}.
4862 % \keyname[type=clistkey,link,no idx]{headings,headings+} add to the current list; \keyname[type=clistkey,link,no idx]{headings\textquotesingle} replaces it.
4863 % \Default*{}none\par
4864 % See \cref{subsubsec:ee-headings} for an example.\par
4865 %
4866 % \DescribeKey{heading,heading+,heading\textquotesingle}\valmarg{text}\marg{coordinate 1}\marg{coordinate 2}\AfterLastParam
4867 % Add or set a single \conceptname{heading}.
4868 % These forms require the same information as \keyname[type=clistkey,no idx]{headings,headings+,headings\textquotesingle} but as three separate arguments.
4869 % \Default*{}none\par
4870 % See \cref{subsubsec:ee-headings} for an example.\par
4871 %
4872 % \DescribeClistkey{subheadings,subheadings+,subheadings\textquotesingle}\tuplelistvalsmarg{text/coordinate 1/coordinate 2/coordinate 3,text/coordinate 1/coordinate 2/coordinate 3,\dots}\AfterLastParam
4873 % List of value quadruplets in the format used by \pgf{}'s \cs{foreach}.
4874 % The list should consist of one or more quadruplets where \meta{text} is used in capitalised form for the content of a node which will be aligned with \meta{coordinate 4} vertically and placed midway between the horizontal positions of \meta{coordinate 1} and \meta{coordinate 2}.
4875 % \meta{coordinate 4} should be either \texttt{chronos upper subheadings} or \texttt{chronos lower subheadings}.
4876 % \keyname[type=clistkey,link,no idx]{subheadings,subheadings+} add to the current list; \keyname[type=clistkey,link,no idx]{subheadings\textquotesingle} replaces it.
4877 % \Default*{}none\par
4878 % See \cref{subsubsec:ee-headings} for an example.\par
4879 %
4880 % \DescribeKey{subheading,subheading+,subheading\textquotesingle}\valmarg{text}\marg{coordinate 1}\marg{coordinate 2}\marg{coordinate 3}\AfterLastParam
4881 % Add or set a single \conceptname{subheading} horizontally aligned with the midpoint between the horizontal positions of \meta{coordinate 1} and \meta{coordinate 2} and vertically aligned with \meta{coordinate 3}.
4882 % \meta{coordinate 3} should be either \texttt{chronos lower subheadings} or \texttt{chronos upper subheadings}, though this is not enforced.
4883 % These forms require the same information as \keyname[type=clistkey,no idx]{subheadings,subheadings+,subheadings\textquotesingle} but as four separate arguments.
4884 % \Default*{}none\par
4885 % See \cref{subsubsec:ee-headings} for an example.\par
4886 %
4887 % \DescribeClistkey{century subheadings,century subheadings+,century subheadings\textquotesingle}\valmarg{number list}\marg{text}\AfterLastParam
4888 % Create a \conceptname[idx post=century subheadings,idx font post=\KeyFont,link]{subheading} aligned with \texttt{chronos lower subheadings} for each of the centuries specified in \val{number list}, using \meta{text} as the superscript for each.
4889 % Note that for the $n$th century \texttt{chronos year} coordinates much exist for both the year $n$00 and the year $(n+1)$00.
4890 % \keyname[type=clistkey,no idx]{century subheadings,century subheadings+} add to the current list; \keyname[type=clistkey,no idx]{century subheadings\textquotesingle} replaces it.
4891 % \Default*{}none\par
4892 % See \cref{subsubsec:ee-headings} for an example.\par
4893 %
4894 % \DescribeKey{century subheading,century subheading+,century subheading\textquotesingle}\valmarg{number}\marg{text}\AfterLastParam
4895 % Add or set a single \conceptname[no idx,link]{century subheading}.
4896 % These forms require the same information as \keyname[type=clistkey,no idx]{century subheadings,century subheadings+,century subheadings\textquotesingle} but expect a single \meta{number}.
4897 % \Default*{}none\par
4898 % See \cref{subsubsec:ee-headings} for an example.\par
4899 %
4900 % \subsubsection{Example}\label{subsubsec:ee-headings}
4901 %^^A BEGIN subsubsec:ee-headings
4902 %
4903 % For example, here's an excerpt from the code used for \cref{fig:anatomi} which demonstrates the use of \keyslabelname{} to create \conceptname[idx post=use of keys to create\string\idxeg]{headings,subheadings}.
4904 % \begin{latexcode}
4905 % \begin{chronos}
4906 % [
4907 % timeline={%
4908 % dates={-500}:1500,
4909 % },
4910 % chronos coords={-500,-450,...,1500},
4911 % headings={heading/chronos year 800/chronos year 1500,another heading/chronos year -450/chronos year 1,a third heading/chronos year 100/chronos year 800},
4912 % subheadings={subheading on upper level/chronos year -250/chronos year 500/chronos upper subheadings,subheading on lower level/chronos start/chronos year -100/chronos lower subheadings,another subheading/chronos year 1000/chronos year 1500/chronos upper subheadings,yet another subheading/chronos year 500/chronos year 1000/chronos lower subheadings},
4913 % century subheadings={12,13,...,15}{th},
4914 % century subheading={1}{st},
4915 % ]
4916 % \end{chronos}
4917 % \end{latexcode}
4918 % Note the use of \keyname[type=clistkey,idx post={to add coordinates for \string\textconcept{headings}, \string\textconcept{subheadings} and \string\textconcept{century subheadings}}]{chronos coords} to add coordinates for years which may not be visibly represented on the \conceptsname[idx post=coordinates for unrepresented \string\textconcept{year}]{timeline}.
4919 % This ensures the \texttt{chronos year} coordinates needed to place \conceptname[link,idx post=ensuring required coordinates exist]{headings,subheadings,century subheadings} exist.
4920 % It is permissible for coordinates to lie beyond the \conceptname[no idx,link]{timeline}'s \keyname[type=datekey,link prefix=timeline/,idx as=timeline/end date]{end date}, though you may get strange results if you create coordinates too distant from the endpoint.
4921 %
4922 %^^A END subsubsec:ee-headings
4923 %
4924 % \subsubsection{Headings Configuration}\label{subsubsec:headings-config}
4925 %^^A BEGIN subsubsec:headings-config
4926 %
4927 % \DescribeKey{headings style,headings style+,headings style\textquotesingle}\valmarg{key-value list}\AfterLastParam
4928 % \pgf/\TikZ{} options to apply to \conceptname[idx post=style configuration]{headings}.
4929 % \keyname[link,no idx]{headings style,headings style\textquotesingle} replace the current list; \keyname[link,no idx]{headings style+} replaces it.
4930 % \Default[empty]
4931 % \Example{headings style=\{align=center, anchor=base, inner sep=0pt, outer sep=0pt, color=chronos main colour, opacity=.8, font=\bs bfseries\}}
4932 % Although the \stylelabelname{} is empty by default, \texttt{anchor=base} is passed to the node prior to the \stylelabelname{}.
4933 % If you do not want this alignment, therefore, you must specify an alternative anchor.
4934 %
4935 % \DescribeKey{subheadings style,subheadings style+,subheadings style\textquotesingle}\valmarg{key-value list}\AfterLastParam
4936 % \pgf/\TikZ{} options to apply to \conceptname[idx post=style configuration]{subheadings}.
4937 % \keyname[no idx]{subheadings style,subheadings style\textquotesingle} replace the current list; \keyname[no idx]{subheadings style+} replaces it.
4938 % \Default[empty]
4939 % \Example{subheadings style=\{align=center, anchor=base, inner sep=0pt, outer sep=0pt, font=\bs bfseries\bs itshape\bs footnotesize, color=chronos main colour!75!chronos main background colour, opacity=.8\}}
4940 % Although the \stylelabelname{} is empty by default, \texttt{anchor=base} is passed to the node prior to the \stylelabelname{}.
4941 % If you do not want this alignment, therefore, you must specify an alternative anchor.
4942 %
4943 %^^A END subsubsec:headings-config
4944 %
4945 %^^A END subsec:headings
4946 %
4947 % \subsection{Colours}\label{subsec:lliwiau}\chronosdocidx[target,type=colour,font=\normalfont,idx as=configuration]{colour}
4948 %^^A BEGIN subsec:lliwiau
4949 %
4950 % For \conceptname[no idx,link]{timeline} colours, see \cref{subsubsec:timeline-lliwiau}.
4951 % For basic colours, see \cref{subsec:lliwiau-basic}.
4952 %
4953 % The \emph{easiest} way to customise colours is to load a \conceptname[type=concept,link,idx post=as customisation]{colour scheme} as explained in \cref{subsec:chronos-schemes}.
4954 %
4955 % The \emph{simplest} way to make use of colours is to specify colours for \elementslabelname{} manually.
4956 % Defaults can be configured in the \conceptname[no idx]{timeline} setup.
4957 %
4958 % \DescribeColkey{life/default colour,event/default colour,period/default colour,theory/default colour,info/default colour,life/default color,event/default color,period/default color,theory/default color,info/default color}\hypertarget{colkey:<tag>/default-colour}{}\val{colour name}\AfterLastParam
4959 % Sets the default colour for elements of the specified type.
4960 % This provides a fall-back colour and ensures some colour is always found, even when none is specified.
4961 % \Default*{}\keyname[type=colour,idx post=as \string\textconcept{tag} default]{chronos main colour}\par
4962 % See \keyname[type=colkey]{foreground} in \cref{subsubsec:timeline-lliwiau}.
4963 % For example,
4964 % \begin{chronoscode}
4965 % \begin{chronos}
4966 % [
4967 % life/default colour=chronos timeline foreground colour,
4968 % event/default colour=chronos timeline foreground colour!50!chronos main colour,
4969 % period/default colour=chronos main colour,
4970 % theory/default colour=chronos timeline background colour,
4971 % info/default colour=chronos main colour!50!chronos main background colour,
4972 % ]
4973 % \end{chronos}
4974 % \end{chronoscode}
4975 %
4976 %
4977 % Alternatively or in addition, colours can be set on a per-element basis (\cref{subsec:add-elements-gconfig,subsec:add-elements-lconfig,subsec:add-elements-glconfig}).
4978 %
4979 %
4980 % \subsubsection{Colour Rotation}\label{subsubsec:troi-lliwiau}\chronosdocidx[type=concept,target,font=\ConceptFont]{colour rotation}\vspace{-\baselineskip}
4981 %^^A BEGIN subsubsec:troi-lliwiau
4982 %
4983 % More complex configuration can be achieved using lists of colours from which \pkg{chronos} selects when adding elements to the \conceptname[idx as=additional,idx post=and \string\textconcept{colour rotation},font=\ConceptFont]{timeline}.
4984 % If you wanted to typeset all elements of type \conceptname[type=tag,link,idx post=colours of the rainbow\string\idxeg]{life} in the colours of the rainbow taken in order, for example, it would be error prone and inflexible to assign colours manually.
4985 % Instead, we would like \pkg{chronos} to select the colours in turn, keep track of which colour is used for which element and automatically adjust the assignments if items are inserted or removed from the \conceptname[no idx,idx post={elements, additional}]{timeline}.
4986 %
4987 % To achieve this, \pkg{chronos} supports \conceptname[type=concept,link,no idx]{colour rotation} for \conceptname[type=element,idx as=text tag,link,link to=text tag,idx post=and \string\textconcept{colour rotation}]{text tags}, \conceptname[type=element,idx as=connection,link,link to=connection,idx post=and \string\textconcept{colour rotation}]{connections} and \conceptname[type=element,idx as=line,link,link to=line,idx post=and \string\textconcept{colour rotation}]{lines} of type \conceptname[type=tag,link,idx post=colour rotation,idx font post=\ConceptFont]{life,event,period,theory}.
4988 %
4989 % \Pkg{chronos} assigns all \conceptsname[link,type=concept,idx post=colour assignment to]{element} belonging to \conceptsname[type=concept,link,idx post=colour assignment to \string\textconcept{elements}]{tag} \conceptname[type=tag,link,idx post=assignment of colours to \string\textconcept{elements} of \string\textconcept{tag} type]{life,event,period,theory,info} a \conceptname[type=colour,no link,font=\normalfont,idx as=assignment by \string\pkg{chronos}]{colour} with a predictable \conceptname[type=colour]{colour name}.
4990 % \Pkg{chronos} determines the colour to assign to the \conceptname[link,type=concept,no idx]{element} as follows.
4991 % \begin{enumerate}
4992 % \item First, \pkg{chronos} checks whether a \keyname[type=colkey,idx post=in assignment of \string\textconcept{colour names}]{colour} has been specified for the \conceptname[link,type=concept,no idx]{element}.
4993 % \item[\sqarrow] If it has, that \keyname[type=colkey,no idx]{colour} is assigned.
4994 % \item If not, \pkg{chronos} checks whether \conceptname[link,type=concept,idx post=in assignment of \string\textconcept{colour names}]{colour rotation} is enabled for the relevant type of element.
4995 % \item[\sqarrow] If it is, \pkg{chronos} assigns the next colour from the specified \conceptname[type=concept,link,idx post=colour assignment from]{colour list} for the type of element in question and according to whether the element will be placed above or below the \conceptname[idx post={elements, additional},no idx]{timeline}.
4996 % That colour is then moved to the bottom of the \conceptname[type=concept,idx as=colour list,idx post=rotation,link to=colour list,link]{list}.
4997 % \item If \conceptname[link,type=concept,link to=colour rotation,no idx]{rotation} is not enabled, a configurable \keyname[type=colkey,idx as=\meta{tag}/default colour,link pre=\meta{tag}/,idx post=in assignment of \string\textconcept{colour names}]{default colour} is assigned instead.
4998 % \end{enumerate}
4999 %
5000 % 8 sets of colours can be configured which correspond to material placed above and below the \conceptname[idx post={elements, additional},no idx]{timeline} for each of default, \conceptname[type=tag,idx post=colour lists \string\textrm{for} colour rotation,idx font post=\ConceptFont]{life,event,period}.
5001 % See \cref{subsubsec:collist} for details.
5002 %
5003 %^^A END subsubsec:troi-lliwiau
5004 %
5005 % \subsubsection[Using Colours]{Using \Conceptname[type=colour,font=\normalfont,idx as=using,no link]{colours}}\label{subsubsec:enwau-lliwiau}\chronosdocidx[idx as=accessing,type=colour,target,font=\normalfont]{colours}\hypertarget{colour}{}\vspace{-\baselineskip}%^^A
5006 %^^A BEGIN subsubsec:enwau-lliwiau
5007 %
5008 % There are at least two things you might want \pkg{chronos} to tell you about \elementslabelname{}' \conceptname[type=colour,idx as=colours,no idx]{\colourslabelname{}}.
5009 % First, you might want to know the \keyname[type=colour,idx as=colour,no idx,no link]{\colourlabelname{}} assigned to a particular \elementlabelname{} \emph{after} the \elementlabelname{} is created.
5010 % Second, you might want to know the \keyname[type=colour,idx as=colour,no idx,no link]{\colourlabelname{}} assigned to the current \elementlabelname{} during creation.
5011 % \Cref{par:enwau-lliwiau-ar-ol} addresses the first, \cref{par:enwau-lliwiau-current-tag} the second.
5012 %
5013 % \paragraph{Colours by Element Name}\label{par:enwau-lliwiau-ar-ol}
5014 %^^A BEGIN par:enwau-lliwiau-ar-ol
5015 %
5016 % Regardless of how the \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname{}} assigned to an \elementlabelname{} ends up being determined, \pkg{chronos} assigns the \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname{}} a name derived from the \elementlabelname{} so that it can be used later, if required.
5017 %
5018 % The result of this is that, assuming we have created an \elementlabelname{} of type \conceptname[type=tag,idx post=colour names \string\textrm{assigned to} \string\textkey{donald knuth}\string\idxeg,idx font post=\ConceptFont]{life} with \keyname[idx post=as supporting \string\textkey{chronos connect}\string\idxeg]{name}\texttt{=donald knuth}, we can write
5019 % \begin{chronoscode}[chronos,connect,life]
5020 % \draw [chronos connect=life:donald knuth] (text tag connector donald knuth1) -- (text tag connector metafont2);
5021 % \end{chronoscode}
5022 % to connect Donald Knuth with an \elementlabelname{} named \texttt{metafont}, which might be of type \conceptname[type=tag,idx post=metafont\idxeg,idx font post=\KeyFont]{theory}.
5023 % The code used to draw the \conceptname[no idx,link]{connection} will use the same \keyname[type=style,no link,idx as=matching \string\textconcept{connection},font=\normalfont]{style} and \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname{}} as any \conceptname[link,idx post=Donald Knuth\string\idxeg]{connection} drawn between Donald Knuth and the \conceptname[no idx]{timeline}\footnote{See \cref{subsec:add-cysylltiadau}}.
5024 % This \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname{}} can also be (and, by default, is) passed to the \conceptname[type=element,idx as=\meta{tag}/text tag,link,link to=\meta{tag}/text tag,idx post=assigned colour passed to]{text tag}.
5025 % For example, a darker shade might be used for the text and outline of the node, and a paler one as a filling.
5026 % The \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname{}} may also be accessed directly using \texttt{colour donald knuth}, \texttt{color donald knuth} or, if \keyname[type=boolkey,idx post=donald knuth\string\idxeg,idx font post=\KeyFont]{simple colour names} are enabled\footnote{See \cref{sec:invoke,subsubsec:enwau-lliw-syml}.}, simply \texttt{donald knuth}.
5027 %
5028 % \DescribeColour{colour \meta{name},color \meta{name}}
5029 % \Conceptname[type=colour,idx as=names,idx post=assigned,font=\normalfont]{\colourlabelname{} names} assigned to the \conceptname[idx as=element,type=concept,idx post=names of colours assigned to]{\elementlabelname} created with \keyname[idx post=use in assigned colour names]{name}\val{name}.\fortags{life,event,period,theory,info}\AfterLastParam
5030 % \emph{Note these names cannot be used during the \elementlabelname{}'s creation in \keyname[type=macro,no link,no idx]{\cs{chronos\meta{tag}}}.}
5031 %
5032 % \DescribeColour{\meta{name}}An additional name for \keyname[type=colour,no idx]{colour \meta{name}}.\fortags{life,event,period,theory,info}\AfterLastParam
5033 % \emph{Requires \keyname[type=boolkey,no idx]{simple colour names}.}
5034 %
5035 %^^A END par:enwau-lliwiau-ar-ol
5036 %
5037 % \paragraph{The Current Tag Colour}\label{par:enwau-lliwiau-current-tag}
5038 %^^A BEGIN par:enwau-lliwiau-current-tag
5039 %
5040 % You may also wish to refer to an \conceptname[idx as=using assigned colour during creation,font=\normalfont]{\elementlabelname}'s assigned \conceptname[type=colour,idx as=in \string\textconcept{tag} context,font=\normalfont]{\colourlabelname} while creating it.
5041 %
5042 % \DescribeColour{chronos current tag colour,chronos current tag color}The \conceptname[type=colour,idx as=current \string\textconcept{tag},font=\normalfont]{\colourlabelname} assigned to the current \conceptname[idx as=element,type=concept,no idx]{\elementlabelname} during creation.\fortags{life,event,period,theory,info}\AfterLastParam
5043 % This \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname} is available when creating an \conceptname[idx as=element,no idx,type=concept]{\elementlabelname} belonging to an appropriate \conceptname[type=concept,idx as=tag]{\taglabelname} i.e.~inside the \conceptname[type=concept,idx as=tag,no idx]{\taglabelname} context setup when using \keyname[type=macro,conj=or,idx post=using assigned colour in]{\cs{chronoslife},\cs{chronosevent},\cs{chronosperiod},\cs{chronostheory}}.
5044 % Outside a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname} context, \keyname[type=colour,idx post=outside \string\textconcept{tag} contexts]{chronos current tag colour,chronos current tag color} are equivalent to \keyname[type=colour,idx post=chronos current tag colour \string\textrm{as equivalent to outside \string\textconcept{tag} contexts},idx font post=\KeyFont]{chronos main colour}.
5045 % \Example{\bs hypersetup\{urlcolor=chronos current tag colour\}}
5046 % \Cref{fig:chronos-dev} uses this code within a \keyname[env,no link]{\enviro{figure}} to override the colour of URL links locally in such a way that each hyperlink's colour is the \conceptname[type=colour,idx as=colour,no idx]{\colourlabelname} of the \conceptname[no idx]{text tag} to which it belongs.
5047 %
5048 %^^A END par:enwau-lliwiau-current-tag
5049 %
5050 %^^A END subsubsec:enwau-lliwiau
5051 %
5052 % \subsubsection{Colour Lists}\label{subsubsec:collist}\chronosdocidx[type=concept,target,font=\ConceptFont]{colour list}
5053 %^^A BEGIN subsubsec:collist
5054 %
5055 % The lists of colours for \conceptname[type=concept,link,no idx]{colour rotation} (\cref{subsubsec:troi-lliwiau}) may be loaded from provided styles, specified directly.%^^A or transferred from another \pkg{chronos} colour list.
5056 %^^A For example, you could specify that elements of type \conceptname[type=tag]{event} should use whatever-list-of-colours-is-specified-for-type-\conceptname[type=tag]{life}-above-the-timeline when typeset below the \conceptname{timeline}.
5057 %
5058 % No specific lists are provided for \conceptname[type=tag,idx post=using default \string\textconcept{colour lists} as \string\textconcept{tag}-specific]{theory}, but you can obviously reserve the default lists for this type, if you want distinct lists for everything.
5059 %
5060 % \DescribeCollistkey{colours above,colors above}\val{list of colour names}\AfterLastParam %^^A ,lliwiau uchod
5061 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default colour list for use above the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5062 % \Default{Red,Orange,Yellow,Green,Blue,MidnightBlue,Violet}
5063 %
5064 % \DescribeCollistkey{colours below,colors below}\val{list of colour names}\AfterLastParam %^^A ,lliwiau isod
5065 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, sets the default colour list for use below the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5066 % \Default{Red,Orange,Yellow,Green,Blue,MidnightBlue,Violet}
5067 %
5068 % \DescribeBoolkey{colour rotation,color rotation}\vals{true,false}\AfterLastParam
5069 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, determines whether colours are rotated by default or not.
5070 % \Default{true}
5071 % This key does not override \taglabelname{}-specific settings.
5072 % Depending on other settings, therefore, using this key may have no effect or it may enable \conceptname[type=concept,link,idx post=effect of \string\texttt{colour rotation} key]{colour rotation} for everything.
5073 %
5074 % \DescribeKey{rotate all colours,rotate all colors}
5075 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, enables both default \conceptname[type=concept,link,no idx]{colour rotation} and \conceptname[type=concept,link,no idx]{colour rotation} for all supported \tagslabelname{}.
5076 % This key overrides \taglabelname{}-specific settings.
5077 %
5078 % \DescribeKey{no colour rotation,no color rotation}
5079 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, disables default \conceptname[type=concept,link,no idx]{colour rotation}.
5080 % This key does not override \taglabelname{}-specific settings.
5081 % Depending on other settings, therefore, using this key may have no effect or it may prevent \conceptname[type=concept,link,no idx]{colour rotation} completely.
5082 %
5083 % \DescribeKey{rotate no colours,rotate no colors}
5084 % When given in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or to \keyname[type=macro,no idx]{\cs{chronosset}}, disables both default \conceptname[type=concept,link,no idx]{colour rotation} and \conceptname[type=concept,link,no idx]{colour rotation} for all \tagslabelname{}.
5085 % This key overrides \taglabelname{}-specific settings.
5086 %
5087 % Note that, like many \pkg{chronos} keys, the effect of setting these depends on the current key path.
5088 % That means that using a key when creating a tag of type \conceptname[type=tag,idx post=as example of \string\textconcept{tag} context]{life}, for example, the key will have a different effect from using in in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}.
5089 %
5090 % \DescribeCollistkey{life/colours above,life/colors above}\val{list of colour names}\AfterLastParam %^^A ,byw/lliwiau uchod
5091 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (above)},idx font post=\ConceptFont]{life} placed above the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5092 % \Default[empty]
5093 %
5094 % \DescribeCollistkey{life/colours below,life/colors below}\val{list of colour names}\AfterLastParam %^^A ,byw/lliwiau isod
5095 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (below)},idx font post=\ConceptFont]{life} placed below the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5096 % \Default{empty}
5097 %
5098 % \DescribeCollistkey{event/colours above,event/colors above}\val{list of colour names}\AfterLastParam %^^A ,digwyddiad/lliwiau uchod
5099 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (above)},idx font post=\ConceptFont]{event} placed above the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5100 % \Default{empty}
5101 %
5102 % \DescribeCollistkey{event/colours below,event/colors below}\val{list of colour names}\AfterLastParam %^^A ,digwyddiad/lliwiau isod
5103 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (below)},idx font post=\ConceptFont]{event} placed below the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5104 %
5105 % \DescribeCollistkey{period/colours above,period/colors above}\val{list of colour names}\AfterLastParam %^^A ,parhad/lliwiau uchod
5106 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (above)},idx font post=\ConceptFont]{period} placed above the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5107 % \Default{empty}
5108 %
5109 % \DescribeCollistkey{period/colours below,period/colors below}\val{list of colour names}\AfterLastParam %^^A ,parhad/lliwiau isod
5110 % Sets the colour list for use with elements of type \conceptname[type=tag,idx post=colour rotation\string\textrm{ (below)},idx font post=\ConceptFont]{period} placed below the \conceptname[no idx]{timeline} to \meta{list of colour names}.
5111 % \Default{empty}
5112 %
5113 %^^A END subsubsec:collist
5114 %
5115 %
5116 % \subsubsection{Simple Colour Names}\label{subsubsec:enwau-lliw-syml}
5117 %^^A BEGIN subsubsec:enwau-lliw-syml
5118 %
5119 % If you wish to enable or disable \keyname[type=boolkey,no idx]{simple colour names} (see \cref{sec:invoke,subsec:lliwiau}) for a particular \conceptname[no idx]{timeline}, use one of the following two options.
5120 %
5121 % \DescribeBoolkey{simple colour names,simple color names}\vals{true,false}\AfterLastParam
5122 % Enable or disable \keyname[type=boolkey,no idx]{simple colour names}.
5123 % \Default{true}
5124 % \Initial{true}
5125 % \Example{simple colour names=false,}
5126 % See \cref{sec:invoke} for details, but note that the \keyslabelname{} here are implemented differently.
5127 %
5128 % \DescribeKey{no simple colour names,no simple color names}
5129 % Disable \keyname[type=boolkey,no idx]{simple colour names}.
5130 % \Example{no simple colour names,}
5131 % See \cref{sec:invoke} for details, but note that the \keyslabelname{} here are implemented differently.
5132 % In particular, unlike both \keyname[type=boolkey,no idx]{simple colour names} and the load-time option, \keyname[no idx]{no simple colour names} does \emph{not} take an argument.
5133 %
5134 %^^A END subsubsec:enwau-lliw-syml
5135 %
5136 %
5137 %^^A END subsec:lliwiau
5138 %
5139 % \section{Adding Elements to the Timeline}\label{sec:macros-add-elements}
5140 %^^A BEGIN sec:macros-add-elements
5141 %
5142 % See \cref{subsec:mathau} for an overview of the components available for use in the \conceptname[no idx]{timeline}'s \conceptname[type=concept,no idx,link]{\meta{timeline additions specification}}.
5143 %
5144 % Seven \macroslabelname{} are provided for adding \elementslabelname{} to the \conceptname[idx post={additional \string\textconcept{elements}}]{timeline}.
5145 % Conceptually, these are always ‘above’ or ‘below’, though they could also be created to the left or right.
5146 % For an overview of the way these commands work, see \cref{sec:anatomy}.
5147 %
5148 % \subsection{Adding Connectable Elements}\label{subsec:macros-connected-elements}
5149 %^^A BEGIN subsec:macros-connected-elements
5150 %
5151 % The most important kinds of additions \pkg{chronos} supports are those which can be connected to the \conceptname[idx post={additional \string\textconcept{elements}, \string\textsf{timeline-connectable}}]{timeline} itself.
5152 %
5153 % \subsubsection{Timeline-Connectable Elements}\label{subsubsec:macros-timeline-connectable}
5154 %^^A BEGIN subsubsec:macros-timeline-connectable
5155 %
5156 % \DescribeMacro{\chronoslife}\marg{key-value list} \fortags*{life}\AfterLastParam %^^A \byw{}
5157 % Create an element of type \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{life}.
5158 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5159 % At a minimum, \keyname[link prefix=life/,idx as=life/name]{name} and \keyname[link prefix=life/,type=datekey,no idx]{birth} must be specified for a living person.
5160 % If the person is dead, both \keyname[link prefix=life/,type=datekey,idx as={life/birth,life/death}]{birth,death} or \keyname[link prefix=life/,type=datekey,no idx]{dates} should be given.
5161 % If no date of death is specified, \pkg{chronos} assumes the person is living and uses the current date when placing the \elementlabelname{} on the \conceptname[no idx]{timeline}.
5162 %
5163 % \changes{v0.9.3}{2025-07-11}{Add \texttt{at aux} and \texttt{line add yshift} etc.}
5164 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{life}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5165 % \begin{table}
5166 % \begin{adjustwidth}{-\tewadjust}{0pt}
5167 % \centering
5168 % \mmzset{disable}%
5169 % \caption{Keys which are enabled (\fycheck) and disabled/ineffective (\fycross) for \taglabelname{} contexts associated with \pkg{chronos} macros.}\label{tab:tag-options}
5170 % \chronosdocidx[type=tag,font=\ConceptFont,idx post={options (summary)}]{life,event,period,theory,info,theory circle,main,copyleft,copyright}
5171 % \tikzset{tikzmark prefix=cyd-destunau}%^^A memoization aborted
5172 % \begin{tabular}{>{\ttfamily}lcccccccc}
5173 % \toprule
5174 % \sffamily & \sffamily & \sffamily & \sffamily & \sffamily & \sffamily theory & \sffamily & \sffamily & \sffamily copyleft \\
5175 % \tikzmark{o}\sffamily Option & \sffamily life & \sffamily event & \sffamily period & \sffamily theory & \sffamily circle & \sffamily info & \sffamily main & \sffamily copyright \tikzmark{p}\\\midrule
5176 % name \tikzmark{e} & \fycheck & \fycheck & \fycheck & \fycheck & \fycheck &\fycheck & \fycheck & \fycheck \\
5177 % as is & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5178 % at & \fycheck & \fycheck & \fycheck & \fycheck & \fycheck &\fycheck & \fycheck & \fycheck \\
5179 % at aux & \fycheck & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5180 % tag anchor & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycheck & \fycheck \\
5181 % colour \textbar{} color & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycross & \fycross \\
5182 % connect & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5183 % connectors \textbar{} connectors+ \textbar{} connectors' & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5184 % place above & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5185 % place below & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5186 % dates & \fycheck & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5187 % date & \fycross & \fycheck & \fycross & \fycross & \fycross &\fycross & \fycross & \fycross \\
5188 % birth & \fycheck & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycross \\
5189 % death & \fycheck & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycross \\
5190 % start & \fycross & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5191 % end & \fycross & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5192 % dates content & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5193 % name content & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycheck & \fycheck \\
5194 % text content & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycross & \fycross \\
5195 % event year on line skip & \fycross & \fycheck & \fycross & \fycross & \fycross & \fycross & \fycross & \fycross \\
5196 % caption & \fycross & \fycross & \fycross & \fycross & \fycross &\fycheck & \fycross & \fycross \\
5197 % labels & \fycross & \fycross & \fycross & \fycross & \fycheck &\fycross & \fycross & \fycross \\
5198 % circle texts & \fycross & \fycross & \fycross & \fycross & \fycheck &\fycross & \fycross & \fycross \\
5199 % sizes & \fycross & \fycross & \fycross & \fycross & \fycheck &\fycross & \fycross & \fycross \\
5200 % author& \fycross & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycheck \\
5201 % copyleft & \fycross & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycheck \\
5202 % notice & \fycross & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycheck \\
5203 % rotate & \fycross & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycheck \\
5204 % year & \fycross & \fycross & \fycross & \fycross & \fycross &\fycross & \fycross & \fycheck \tikzmark{ll} \\ \cmidrule(lr){1-8}
5205 % date format\tikzmark{rh} & \fycross & \fycheck & \fycross & \fycross & \fycross &\fycross & \fycross & \fycross \\
5206 % date formats & \fycheck & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5207 % full dates & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5208 % only years & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5209 % show eras & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5210 % without eras & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5211 % only text & \fycheck & \fycheck & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5212 % tag \textbar{} tag+ & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycross & \fycross \\
5213 % connection \textbar{} connection+ & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5214 % line \textbar{} line+ & \fycheck & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5215 % line add yshift & \fycheck & \fycross & \fycheck & \fycross & \fycross &\fycross & \fycross & \fycross \\
5216 % text tag \textbar{} text tag+ & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycross & \fycross \\
5217 % default colour \textbar{} color & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycheck & \fycross & \fycross \\
5218 % colours \textbar{} colors above & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5219 % colours \textbar{} colors below & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5220 %^^A colours \textbar{} colors above from clist & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross \\
5221 %^^A colours \textbar{} colors below from clist & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross \\
5222 % colour \textbar{} color rotation & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \\
5223 % text tag yshift & \fycheck & \fycheck & \fycheck & \fycheck & \fycross &\fycross & \fycross & \fycross \tikzmark{g} \\
5224 % \bottomrule
5225 % \end{tabular}
5226 % \begin{tikzpicture}[remember picture,overlay,decoration={brace,mirror,amplitude=5},every node/.style={font=\sffamily}]%^^A memoization aborted
5227 % \coordinate [xshift=-2.5pt] (a) at ($(pic cs:o)!.5!({pic cs:o} |- {pic cs:e})$);
5228 % \coordinate (b) at (a |- {$(pic cs:rh)!.5!({pic cs:rh} |- {pic cs:ll})$});
5229 % \coordinate (c) at (b |- {pic cs:g});
5230 % \draw [decorate] ([yshift=-1pt]a) -- node [midway,left=10pt,anchor=base,rotate=90] {primarily per item configuration} ([yshift=5pt]b) ;
5231 % \draw [decorate] ([yshift=-1pt]b) -- node [midway,left=10pt,rotate=90,anchor=base] {primarily all-of-type-\taglabelname{} configuration} ([yshift=-1pt]c);
5232 % \end{tikzpicture}%%^^A memoization aborted
5233 % \end{adjustwidth}
5234 % \end{table}
5235 %
5236 % Creating the \elementlabelname{} involves constructing, naming and connecting several components.
5237 % These are described in \cref{tab:life-period} for a typical case, but note that additional \conceptname[idx pre=life,idx font pre=\ConceptFont]{connectors} require \keyname[link prefix=life/,idx as=life/connectors]{connectors} to be set, the \conceptname[idx pre=life,idx font pre=\ConceptFont]{connection} is drawn only if \keyname[link prefix=life/,type=boolkey,idx as=life/connect]{connect} is \texttt{true} and some components may be rendered invisibly.
5238 % \begin{table}
5239 % \begin{adjustwidth}{-\tewadjust}{0pt}
5240 % \centering
5241 % \caption{Components of \conceptname[idx as=element,type=concept,idx post=components of \textconcept{life} and \textconcept{period}]{elements} of \conceptname[type=concept,no idx,link]{tag} types \conceptname[type=tag,idx post=components of]{life,period}.}\label{tab:life-period}
5242 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{life,period}%
5243 % \chronosdocidx[type=tag,idx pre=life,idx font pre=\ConceptFont,font=\ConceptFont]{chronos connector,main connector,text tag connector,connectors,line,text tag,connection}%^^A
5244 % \chronosdocidx[type=tag,idx pre=period,idx font pre=\ConceptFont,font=\ConceptFont]{chronos connector,main connector,text tag connector,connectors,line,text tag,connection}%^^A
5245 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5246 % \toprule
5247 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5248 % \fycross{} & \keyname[type=coord,no link,idx post=as component of \string\textconcept{life} and \string\textconcept{period}]{\meta{name}} & Point on \conceptname[no idx]{timeline} midway between \meta{birth} and \meta{death} (\conceptname[no idx]{life}) or \meta{start} and \meta{end} (\conceptname[no idx]{period}). & coordinate \\
5249 % \conceptname[idx post=as component of \string\textconcept{life}]{line}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{line} & \fycross{} & Line or rectangle on or near \conceptname[no idx]{timeline} or \conceptname[idx post=as location of \string\textconcept{line}]{timeline border} from \meta{birth} to \meta{death} (\conceptname[no idx]{life}) or \meta{start} to \meta{end} (\conceptname[no idx]{period}). & \cs{path} \\
5250 % \conceptname[idx post=as component of \string\textconcept{life}]{chronos connector}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{chronos connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{life} and \string\textconcept{period}]{chronos connector \meta{name}} & Connection point midway along \conceptname[no idx]{line}. & node \\
5251 % \conceptname[idx post=as component of \string\textconcept{life}]{text tag}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{text tag} & \keyname[type=node,no link,no link,idx post=as component of \string\textconcept{life} and \string\textconcept{period}]{tag \meta{name}} & Main box representing \elementlabelname{}. By default, contains dates above capitalised \meta{name} (\conceptname[no idx]{life}) or capitalised \meta{name} above dates (\conceptname[no idx]{period}). & node \\
5252 % \conceptname[idx post=as component of \string\textconcept{life}]{main connector}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{main connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{life} and \string\textconcept{period}]{main connector \meta{name}} & Connection point at \TikZ{} anchor of \conceptname[no idx]{text tag}. & node \\
5253 % \conceptname[idx as=connection,idx post=as component of \string\textconcept{life}]{connection}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{connection} & \fycross{} & Line between the \conceptname[no idx]{chronos connector,main connector}. & \cs{draw} \\
5254 % \conceptname[idx as=text tag connector,idx post=as component of \string\textconcept{life}]{connectors}\chronosdocidx[type=element,idx post=as component of \string\textconcept{period},font=\ConceptFont]{text tag connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{life} and \string\textconcept{period}]{connector \meta{name}\textrm{\textit{n}}} & Secondary connection point(s) at \TikZ{} anchor(s) of \conceptname[no idx]{text tag}, named in order with $n=1,2,\ldots$. & node \\ \bottomrule
5255 % \end{tabularx}
5256 % \end{adjustwidth}
5257 % \end{table}
5258 %
5259 % For example,
5260 % \begin{chronoscode}
5261 % \chronoslife{%
5262 % name=leslie lamport,
5263 % birth={1941-02-07},
5264 % at=leslie lamport |- u1.north,
5265 % connectors=east,
5266 % tag anchor=west,
5267 % xshift=10pt,
5268 % }
5269 % \end{chronoscode}
5270 % This will create a text node (\conceptname[no idx,link]{text tag}) named \keyname[type=node,no link,symbol=eg]{tag leslie lamport} with two \conceptname[no idx,link,link to=connector]{connectors}, \texttt{10pt} to the right of coordinate \verb+(leslie lamport |- u1.north)+, using the settings for \conceptname[type=tag,no idx,link]{life}.
5271 % The main \conceptname[no idx,link]{connector}, named \keyname[type=node,no link,,symbol=eg]{main connector leslie lamport} or \keyname[type=node,no link,symbol=eg]{connector leslie lamport0}, will be at the \TikZ{} anchor \texttt{west}.
5272 % This will be used as the \TikZ{} \texttt{anchor} when placing the node and used to connect it to the \conceptname[no idx]{timeline}.
5273 % A second \conceptname[no idx]{connector}, named \keyname[type=node,no link,symbol=eg]{connector leslie lamport1} will be created at the \texttt{east}, which may be used to connect the \conceptname[no idx]{text tag} to other \elementslabelname{}.
5274 %
5275 % A \conceptname[no idx,link]{chronos connector}, named \keyname[type=node,no link,symbol=eg]{chronos connector leslie lamport} will be created on the \conceptname[no idx]{timeline} at the midpoint between \texttt{1941-02-07} and today's date.
5276 % A \conceptname[no idx,link]{line} will also be marked on the \conceptname[no idx,link]{timeline border}, on the \conceptname[idx post=as location of \string\textconcept{line}]{timeline} or near the \conceptname[no idx]{timeline}, between these dates.
5277 %
5278 % Note that the coordinate \keyname[type=coord,no link,symbol=eg]{leslie lamport} need not (and generally should not) exist when this command is given. of coordinates
5279 % A coordinate of this name will be created on the \conceptname[idx post=as location of \string\textkey{leslie lamport}\string\idxeg]{timeline} midway between the birth and death dates (or, in this case, between the birth date and today's date) prior to creation of the \conceptname[no idx]{text tag}.
5280 % However, \texttt{u1} must exist.
5281 % In this case, it refers to a node created using the \keyname[idx post=u1\string\idxeg,idx font post=\KeyFont]{levels}\chronosdocidx[type=key,idx post=level 1\string\idxeg,idx font post=\KeyFont]{levels} option.
5282 % \keyname[type=node,no link,symbol=eg]{u1} is also known as \keyname[type=node,no link,symbol=eg]{level 1} and refers the the first level above the \conceptname[no idx]{timeline}.
5283 % Lamport will be a bit higher because the \conceptname[no idx,link]{text tag}'s \texttt{west} anchor will be aligned with the \texttt{north} of node \texttt{level 1}.
5284 %
5285 % Since the \conceptname[idx post=shifted right\string\idxeg]{text tag} is shifted right, the \conceptname[idx post=use of \string\texttt{\textbar-}]{connection} will be drawn using \verb+|-+\chronosdocidx[idx as=\textbar-]{\string\textbar -} rather than \verb|--|\chronosdocidx{\string\verb*\verbatimchar--\verbatimchar}.
5286 % If more complex paths are required, \texttt{connect=false} may be used and the \conceptname[no idx,link]{text tag} connected to the \conceptname[idx post={connections, \string\textrm{complex}},idx font post=\ConceptFont]{timeline} manually.
5287 % A \conceptname{chronos connector}, \keyname[type=node,no link,symbol=eg,no idx]{chronos connector leslie lamport}, would then be created on the \conceptname[idx post=connectors,idx font post=\ConceptFont]{timeline}, as would the \conceptname[idx as=connector,link,link to=connector,no idx]{connectors} on the \conceptname[no idx,link]{text tag}, but the \conceptname[no idx,link]{connection} itself would be omitted.
5288 %
5289 % In addition, a colour named \keyname[type=colour,no link,idx as=colour leslie lamport\string\idxeg]{colour leslie lamport} or \keyname[type=colour,no link,idx as=color leslie lamport\string\idxeg]{color leslie lamport} will be created.
5290 % This is typically used in the \styleslabelname{} responsible for the appearance of the \conceptname[idx as={text tag,line,connection,text tag connector,chronos connector},idx post=use of \string\texttt{colour leslie lamport} in\string\idxeg]{text tag,line,connection,connectors} and may be referenced and reused later.
5291 % If \keyname[type=boolkey,conj=or,idx post=Leslie Lamport\string\idxeg]{simple colour names,simple color names} are used, it may also be referenced as \keyname[type=colour,no link,idx as=leslie lamport\string\idxeg]{leslie lamport}.
5292 %
5293 % \DescribeMacro{\chronosevent}\marg{key-value list} \fortags*{event}\AfterLastParam %^^A {}
5294 % Create an element of type \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{event}.
5295 % This is intended for events spanning no more than a day.
5296 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5297 % At a minimum, \keyname[link prefix=event/,idx as=event/name]{name} and \keyname[link prefix=event/,type=datekey,idx as=event/date]{date} should be specified.
5298 %
5299 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{event}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5300 %
5301 % Creating the \elementlabelname{} involves constructing, naming and connecting several components.
5302 % These are described in \cref{tab:dig} for a typical case, but note that additional \conceptname[idx as=text tag connectors]{connectors} require \keyname[link prefix=event/,idx as=event/connectors]{connectors} to be set, the \conceptname[idx pre=event,idx font pre=\ConceptFont,idx as={connection\string\textnormal{conditions for drawing}}]{connection} is drawn only if \keyname[link prefix=event/,type=boolkey,idx as=event/connect]{connect} is \texttt{true} and some components may be rendered invisibly.
5303 % \begin{table}
5304 % \begin{adjustwidth}{-\tewadjust}{0pt}
5305 % \centering
5306 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textconcept{event}]{element} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,idx post=components of]{event}.}\label{tab:dig}
5307 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{event}
5308 % \chronosdocidx[type=tag,idx pre=event,idx font pre=\ConceptFont,font=\ConceptFont]{chronos connector,main connector,text tag connector,connectors,line,text tag,connection}%^^A
5309 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5310 % \toprule
5311 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5312 % \fycross{} & \meta{name} & Point on \conceptname[no idx]{timeline} at \meta{date}. & coordinate \\
5313 % \conceptname[idx post=as component of \string\textsf{event}]{line} & \fycross{} & Line from \conceptname[no idx]{timeline} to the edge of \conceptname[no idx]{timeline border} at \meta{date}. & \cs{path} \\
5314 % \conceptname[idx post=as component of \string\textsf{event}]{chronos connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{event}]{chronos connector \meta{name}} & Connection point at end of \conceptname[no idx]{line}. & node \\
5315 % \conceptname[idx post=as component of \string\textsf{event}]{text tag} & \keyname[type=node,no link,idx post=as component of \string\textconcept{event}]{tag \meta{name}} & Main box representing \elementlabelname{}. By default, contains the date above the capitalised \meta{name}. & node \\
5316 % \conceptname[idx post=as component of \string\textsf{event}]{main connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{event}]{main connector \meta{name}} & Connection point at \TikZ{} anchor of \conceptname[no idx]{text tag}. & node \\
5317 % \conceptname[idx post=as component of \string\textsf{event}]{connection} & \fycross{} & Line between the \conceptname[no idx]{chronos connector,main connector}. & \cs{draw} \\
5318 % \conceptname[idx as=text tag connector,idx post=as component of \string\textsf{event}]{connectors} & \keyname[type=node,no link,idx post=as component of \string\textconcept{event}]{connector \meta{name}\textrm{\textit{n}}} & Secondary connection point(s) at \TikZ{} anchor(s) of \conceptname[no idx]{text tag}, named in order with $n=1,2,\ldots$. & node \\ \bottomrule
5319 % \end{tabularx}
5320 % \end{adjustwidth}
5321 % \end{table}
5322 %
5323 % For example,
5324 % \begin{chronoscode}
5325 % \chronosevent {%
5326 % name=\emph{Common Sense},
5327 % as is,
5328 % yshift=5pt,
5329 % date=1776,
5330 % text=WildStrawberry,% will affect text for the element itself but not drawing, filling or the assigned colour
5331 % place below,% does nothing because the positive yshift pushes the element above the timeline
5332 % }%
5333 % \end{chronoscode}
5334 % Note the use of \keyname[link prefix=event/,type=boolkey,idx as=event/as is,link to=as is]{as is} to prevent errors trying to capitalise \cs{emph}.
5335 % \keyname[link prefix=event/,type=boolkey,idx as=event/place below]{place below} has no effect here: the item still ends up above the \conceptname[no idx]{timeline} due to \texttt{yshift=5pt}.
5336 % Note the use of only a year in \keyname[link prefix=event/,type=datekey,idx as=event/date]{date}.
5337 % If you only specify years, you probably want to configure your \conceptname[no idx]{timeline} to avoid printing full dates or you will end up with everything happening on January 1\textsuperscript{st}.
5338 % See \cref{subsubsec:dyddiad-output}.
5339 %
5340 % \DescribeMacro{\chronosperiod}\marg{key-value list} \fortags*{period}\AfterLastParam %^^A {}
5341 % Create an element of type \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{period}.
5342 % This is intended for extended events spanning more than one day.
5343 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5344 % At a minimum, \keyname[link prefix=period/,idx as=period/name,idx post=as mandatory for ongoing]{name} and \keyname[link prefix=period/,type=datekey,idx as=period/start,idx post=as mandatory for ongoing]{start} must be specified for an ongoing \conceptname[type=tag,idx post=mandatory keys for ongoing]{period}.
5345 % If the extended event has ended, both \keyname[link prefix=period/,type=datekey,idx as={period/start,period/end},idx post=as mandatory for completed]{start,end} or \keyname[link prefix=period/,type=datekey,idx as=period/dates,idx post=as mandatory for completed]{dates} should be given.
5346 % If no end date is specified, \pkg{chronos} assumes the \conceptname[type=tag,idx post=mandatory keys for completed]{period} is ongoing and uses the current date when placing the \elementlabelname{} on the \conceptname[no idx]{timeline}.
5347 %
5348 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{period}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5349 %
5350 % Creating the \elementlabelname{} involves constructing, naming and connecting several components.
5351 % These are described in \cref{tab:life-period} for a typical case, but note that additional \conceptname[idx as=text tag connector,idx pre=period,idx font pre=\ConceptFont]{connectors} require \keyname[link prefix=period/,idx as=period/connectors]{connectors} to be set, the \conceptname{connection} is drawn only if \keyname[link prefix=period/,type=boolkey,idx as=period/connect]{connect} is \texttt{true} and some components may be rendered invisibly.
5352 %
5353 % For example,
5354 % \begin{chronoscode}
5355 % \chronosperiod {%
5356 % dates={476-01-01}:{476-10-31},
5357 % name=Fall of the\\Roman Empire,
5358 % colour=blue,
5359 % line+={draw=gray},% draw ugly grey border around line
5360 % }
5361 % \end{chronoscode}
5362 % This will construct an \elementlabelname{} analogous to the one created for Lamport.
5363 % Note that the names of nodes and coordinates will be based on \texttt{Fall of theRoman Empire} because \pkg{chronos} will remove the \verb|\\| and the capitalisation won't change.
5364 % \texttt{colour Fall of theRoman Empire} will be \texttt{blue} and the \conceptname[idx post=Fall of theRoman Empire\string\idxeg,idx font post=\KeyFont]{line} representing the \conceptname[type=tag,idx post=representation on \string\textconcept{timeline}]{period} on the \conceptname[no idx]{timeline} will be drawn in \texttt{gray} but potentially filled in \texttt{blue}.
5365 % This is because \keyname[link prefix=period/,idx as=period/line+]{line+} adds to any existing \stylelabelname{} rather than replacing it.
5366 %
5367 %^^A END subsubsec:macros-timeline-connectable
5368 %
5369 % \subsubsection{Adding Other Connectable Elements}\label{subsubsec:macros-other-connectable}
5370 %^^A BEGIN subsubsec:macros-other-connectable
5371 %
5372 % Of the remaining \elementslabelname{}, only those of type \conceptname[type=tag,link,idx post=as \string\textconcept{connectable}]{theory} are connectable.
5373 % While they cannot be connected to the \conceptname[idx post={additional \string\textconcept{elements}, \string\textconcept{connectable}}]{timeline}\footnote{At least, \pkg{chronos} won't connect them for you.}, \pkg{chronos} can create \conceptname[idx as=text tag connector,idx post=creation for \string\textconcept{theories}]{connectors} for them to enable easy \conceptname[idx as=connection,idx post=connectors \string\textrm{as facilitating} connections \string\textrm{to} theories,idx font post=\ConceptFont]{connections} to other \elementslabelname{}.
5374 %
5375 % \DescribeMacro{\chronostheory}\marg{key-value list} \fortags*{theory}\AfterLastParam %^^A {}
5376 % Create an element of type \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{theory}.
5377 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5378 % At a minimum, \keyname[link pre=theory/,idx as=theory/name]{name} must be specified, but \keyname[link pre=theory/,idx as=theory/at]{at} is required for placement.
5379 % If left unspecified, \pkg{chronos} will place the \conceptname[type=tag,idx post=default placement]{theory} at \keyname[type=coord,idx post=default placement of \string\textconcept{theory}]{chronos origin} and issue a warning.
5380 %
5381 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{theory}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5382 %
5383 % Creating the \elementlabelname{} involves constructing and naming components of up to two kinds.
5384 % These are described in \cref{tab:theory} for a typical case, but note that a \conceptname[idx post=required keys for \string\textconcept{theory}]{connector} requires \keyname[link pre=theory/,idx as=theory/tag anchor]{tag anchor} or \keyname[link pre=theory/,idx as=theory/connectors]{connectors} to be set.
5385 % \Conceptname[idx as=text tag connector,idx post=potential invisibility]{connectors} may be rendered invisibly.
5386 % \begin{table}
5387 % \begin{adjustwidth}{-\tewadjust}{0pt}
5388 % \centering
5389 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textconcept{theory}]{element} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,idx post=components of]{theory}.}\label{tab:theory}
5390 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{theory}
5391 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5392 % \toprule
5393 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5394 % \fycross{} & \meta{name} & Alias for \conceptname[idx post=as component of \string\textconcept{theory}]{text tag}. & node \\
5395 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{theory}]{text tag} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory}]{tag \meta{name}} & Main box representing \elementlabelname{}. By default, contains the capitalised \meta{name}. & node \\
5396 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{theory}]{main connector} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory}]{main connector \meta{name}} & Connection point at \TikZ{} anchor of \conceptname[no idx]{text tag}. & node \\
5397 % \conceptname[idx as=text tag connector,type=node,no link,idx post=as component of \string\textconcept{theory}]{connectors} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory}]{connector \meta{name}\textrm{\textit{n}}} & Secondary connection point(s) at \TikZ{} anchor(s) of \conceptname[no idx]{text tag}, named in order with $n=1,2,\ldots$. & node \\ \bottomrule
5398 % \end{tabularx}
5399 % \end{adjustwidth}
5400 % \end{table}
5401 %
5402 %^^A END subsubsec:macros-other-connectable
5403 %
5404 %^^A END subsec:macros-connected-elements
5405 %
5406 % \subsection{Adding Non-Connectable Elements}\label{subsec:macros-non-connectable-elements}
5407 %^^A BEGIN subsec:macros-non-connectable-elements
5408 %
5409 % The remaining \elementslabelname{} are \conceptname[idx post={additional \string\textconcept{elements}, \string\textconcept{non-connectable}},idx as=timeline]{non-connectable}.
5410 %
5411 % \DescribeMacro{\chronostheorycircle}\marg{key-value list} \fortags*{theory circle}\AfterLastParam %^^A {}
5412 % Create a \conceptname[,idx post=create \string\textconcept{element} of type]{theory circle}.
5413 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5414 % At a minimum, \keyname[link pre=theory circle/,idx as=theory circle/name,idx post=as mandatory]{name} must be specified, but \keyname[link pre=theory circle/,idx as=theory circle/at]{at} is required for placement.
5415 %^^A If left unspecified, \pkg{chronos} will place the \conceptname[type=tag]{theory circle} at \texttt{chronos origin} and issue a warning.
5416 %
5417 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{theory circle}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5418 %
5419 % Creating the \elementlabelname{} involves constructing and naming components of several kinds.
5420 % Depending on the \stylelabelname{}, the \elementlabelname{} is intended to consist of a ring with text placed on the upper and lower semicircles and labels above and below.
5421 % A symbol or picture can then be placed at the centre.
5422 % The components are described in \cref{tab:cylch-theori} for a typical case, but note that these are \stylelabelname{}-dependant.
5423 % \begin{table}
5424 % \begin{adjustwidth}{-\tewadjust}{0pt}
5425 % \centering
5426 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textsf{theory circle}]{element} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post=components of]{theory circle}.}\label{tab:cylch-theori}
5427 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{theory circle}
5428 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5429 % \toprule
5430 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5431 % \fycross{} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory circle}]{\meta{name}} & A (rectangular!) box containing all other components. & node \\
5432 % \fycross{} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory circle}]{label above \meta{name}} & Label above the ring. & nodes \\
5433 % \fycross{} & \keyname[type=node,no link,idx post=as component of \string\textconcept{theory circle}]{label below \meta{name}} & Label below the ring. & \\
5434 % \fycross{} & \keyname[type=coord,no link,idx post=as component of \string\textconcept{theory circle}]{\meta{name}1} & Centre of the ring. & coordinate \\
5435 % \bottomrule
5436 % \end{tabularx}
5437 % \end{adjustwidth}
5438 % \end{table}
5439 % In practice, this \elementlabelname{} could be used in other ways since it depends primarily on re-definable \styleslabelname{}.
5440 % However, in that case, there's no reason to avoid --- and every reason to prefer --- a new name.
5441 %^^A The \styleslabelname{} should receive four \meta{text} components, two for the upper and lower semicircles, and two for the upper and lower labels.
5442 %
5443 % For example,
5444 % \begin{chronoscode}
5445 % \chronostheorycircle{
5446 % name=gutenberg revolution,
5447 % at=chronos end |- printing press.center,
5448 % sizes=15pt:9pt,
5449 % circle texts=Gutenberg:Revolution,
5450 % labels=15\textsuperscript{th}c.\thinspace \celabel:21\textsuperscript{st}c.\thinspace \celabel,
5451 % }
5452 % \end{chronoscode}
5453 %
5454 %
5455 % \DescribeMacro{\chronosinfo}\marg{key-value list} \fortags*{info}\AfterLastParam %^^A {}
5456 % Create an element of type \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{info} i.e.~an information box with a distinct caption.
5457 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5458 % At a minimum, \keyname[link pre=info/,idx as={info/name,info/at},idx post=as required]{name,at} must be specified.
5459 %
5460 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{info}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5461 %
5462 % Creating the \elementlabelname{} involves constructing and naming two components.
5463 % These are described in \cref{tab:info} for a typical case.
5464 % \begin{table}
5465 % \begin{adjustwidth}{-\tewadjust}{0pt}
5466 % \centering
5467 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textsf{info}]{element} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post=components of]{info}.}\label{tab:info}
5468 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{info}
5469 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5470 % \toprule
5471 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5472 % \fycross{} & \meta{name} & Alias for \conceptname[idx post=as component of \string\textconcept{info}]{text tag}. & node \\
5473 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{info}]{text tag} & \keyname[type=node,no link,idx post=as component of \string\textconcept{info}]{tag \meta{name}} & Main box representing \elementlabelname{}. Empty by default. & node \\
5474 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{info}]{caption} & \keyname[type=node,no link,idx post=as component of \string\textconcept{info}]{caption \meta{name}} & By default, contains the capitalised \meta{name}. & node \\
5475 % \bottomrule
5476 % \end{tabularx}
5477 % \end{adjustwidth}
5478 % \end{table}
5479 %
5480 % For example,
5481 % \begin{chronoscode}[caption,text,content]
5482 % \chronosinfo{%
5483 % name=syllogism,
5484 % at=chronos year 200 |- u4,
5485 % text content={All men are\\[-.25em]\hspace*{1.5em}mortal.\\Socrates is a\\[-.25em]\hspace*{1.5em}man.\\$\therefore$ Socrates is\\[-.25em]\hspace*{1.5em}mortal.},
5486 % anchor=north,
5487 % caption=A Syllogism,
5488 % }
5489 % \end{chronoscode}
5490 % Note the use of \keyname[link pre=info/,idx as=info/caption]{caption} to override the default reuse of \keyname[link pre=info/,idx as=info/name]{name}.
5491 % This allows the box to be captioned ‘A Syllogism’, while allowing references simply to \texttt{syllogism}.
5492 %
5493 % \DescribeMacro{\chronosmaintitle}\marg{key-value list} \fortags*{main}\AfterLastParam %^^A {}
5494 % Create the main title.
5495 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5496 % At a minimum, \keyname[idx post=as required for \string\cs{chronosmaintitle}]{name,at} must be specified.
5497 %
5498 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{main}, with detailed usage information provided in \cref{subsec:add-elements-lconfig,subsec:add-elements-gconfig}.
5499 %
5500 % The result is simply a \TikZ{} node, as described in \cref{tab:prifdeitl}.
5501 % \begin{table}
5502 % \begin{adjustwidth}{-\tewadjust}{0pt}
5503 % \centering
5504 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textsf{main}]{element} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,idx post=components of \string\textconcept{main title}]{main}.}\label{tab:prifdeitl}
5505 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post={components}]{main}
5506 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5507 % \toprule
5508 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5509 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{main}]{text tag} & \keyname[type=node,no link,idx post=as component of \string\textconcept{main/main title}]{\meta{name}} & By default, contains the capitalised \meta{name}. & node \\
5510 % \bottomrule
5511 % \end{tabularx}
5512 % \end{adjustwidth}
5513 % \end{table}
5514 %
5515 % \DescribeMacro{\chronoscopyright}\marg{key-value list} \fortags*{copyleft,copyright}\AfterLastParam %^^A {}
5516 % Create a \conceptname[type=tag,no idx]{copyleft} or \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{copyright} notice.
5517 % The \meta{key-value list} should specify values for \pkg{chronos} \keyslabelname{} and may include arbitrary \TikZ{} \keyslabelname{}.
5518 % At a minimum, \keyname[link pre=copyright/,idx as=copyright/at]{at} should be specified to avoid a warning.
5519 %
5520 %
5521 % \Cref{tab:tag-options} summarises the \pkg{chronos} \keyslabelname{} supported by \elementslabelname{} of type \conceptname[type=tag,idx post=availability of keys]{copyleft,copyright}, with detailed usage information provided in \cref{subsec:add-elements-glconfig,subsec:add-elements-gconfig}.
5522 %
5523 % The result is simply a \TikZ{} node, as described in \cref{tab:hawlfraint}.
5524 % \begin{table}
5525 % \begin{adjustwidth}{-\tewadjust}{0pt}
5526 % \centering
5527 % \caption{Components of an \conceptname[type=concept,idx post=components of \string\textsf{copyleft} and \string\textsf{copyright}]{element} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,idx post={components of}]{copyleft,copyright}.}\label{tab:hawlfraint}
5528 %^^A \chronosdocidx[type=tag,font=\ConceptFont,idx post=components]{copyleft,copyright}
5529 % \begin{tabularx}{\textwidth+\tewadjust}{l>{\ttfamily}lX>{\ttfamily}l}
5530 % \toprule
5531 % \sffamily \Conceptname[type=concept,no idx]{element} & \sffamily Name & \sffamily Description & \TikZ{} Type \\\midrule
5532 % \conceptname[type=node,no link,idx post=as component of \string\textconcept{copyleft}/\string\textconcept{copyright}]{text tag} & \keyname[type=node,no link,idx post=as component of \string\textconcept{copyleft} and \string\textconcept{copyright}]{\meta{name}} & By default, contains a standard copyright or copyleft notice utilising whatever details are provided or default values and dummy texts. & node \\
5533 % \bottomrule
5534 % \end{tabularx}
5535 % \end{adjustwidth}
5536 % \end{table}
5537 %
5538 % \DescribeMacro{\chronoscopyleft}\marg{key-value list} \fortags*{copyleft,copyright}\AfterLastParam %^^A {}
5539 % Create a \conceptname[type=tag,idx post=create \string\textconcept{element} of \string\textconcept{tag} type]{copyleft} notice.
5540 % Sets \keyname[type=boolkey,link prefix=copyleft/,idx as=copyleft/copyleft]{copyleft} \texttt{true} before passing \marg{key-value list} to \keyname[type=macro,idx post=invoked by \string\cs{chronoscopyleft}]{\cs{chronoscopyright}}.
5541 %
5542 %^^A END subsec:macros-non-connectable-elements
5543 %
5544 %
5545 % \subsection{Additional Elements: Local Configuration}\label{subsec:add-elements-lconfig}\chronosdocidx[type=tag,font=\ConceptFont,idx post={configuration, local}]{life,event,period,theory,info,theory circle,main,copyleft,copyright}\vspace{-\baselineskip}
5546 %^^A BEGIN subsec:add-elements-lconfig
5547 %
5548 % These \keyslabelname{} are designed for use when creating specific \elementslabelname{}.
5549 % That is, they should be used in the argument of a \pkg{chronos} command such as \keyname[type=macro,conj=or,idx post={configuration, local}]{\cs{chronoslife},\cs{chronosevent},\cs{chronosperiod},\cs{chronostheory},\cs{chronosinfo},\cs{chronostheorycircle},\cs{chronosmaintitle},\cs{chronoscopyleft},\cs{chronoscopyright}}.
5550 % If used globally (e.g.~in \keyname[type=macro,idx post=setting normally local keys in]{\cs{chronosset}} or the \conceptname[type=concept,idx post=setting normally local keys in]{\meta{chronos preamble}}), they will determine defaults for all \elementslabelname{} (belonging to the relevant \conceptname[link,no idx,type=concept]{tag}).
5551 % Where this makes sense, the possibility is noted below; where it is not noted, global usage is unsupported.
5552 %
5553 % \DescribeKey{name}\val{text} \fortags[names=name,type=key]{life,event,period,theory,info,theory circle,main,copyleft,copyright}\AfterLastParam
5554 % The base name of the \conceptname[idx as=naming,font=\normalfont]{element}.
5555 % Except for \keyname[type=macro,idx post=name\string\textnormal{ optional for},idx font post=\KeyFont]{\cs{chronosmaintitle},\cs{chronoscopyleft},\cs{chronoscopyright}}, \textbf{this key is required}.
5556 % \Default[\conceptname[type=tag,idx post=default name for \string\textconcept{main title}]{main}]{main title}
5557 % \Default*{}\texttt{copyleft} \emph{and} \texttt{copyright} (\conceptname[type=tag,idx post=default name]{copyleft,copyright})\par
5558 % By default, \meta{text} is used multiple times.
5559 %
5560 % First, it is capitalised and used for (part of) the content created for the \conceptname[idx as={capitalisation of name},font=\normalfont]{element} added to the \conceptname[no idx]{timeline}.
5561 % \keyname[type=boolkey,no idx]{as is} prevents capitalisation.
5562 % In the case of \conceptname[type=tag,idx post=use of \string\textkey{name} in content of]{life,event,period}, it is used for the non-date part of the content.
5563 % In the case of \conceptname[type=tag,idx post=use of \string\textkey{name} in content of]{theory,main}, it is used for the whole content of the title.
5564 % In the case of \conceptname[type=tag,idx post=use of \string\textkey{name} in content of]{info}, it is used to create the caption.
5565 % In the case of \conceptname[type=tag,idx post=use of \string\textkey{name} in content of]{copyleft,copyright}, it is used as the author's name if \keyname[link prefix=copyright/,idx as=copyright/author]{author} is unset.
5566 % It is not used to create content in the case of \conceptname[type=tag,idx post=non-use of \string\textkey{name} in]{theory circle}.
5567 %
5568 % Second, it is processed to create multiple names for different parts of the \conceptname[idx as=use by \string\textconcept{chronos},font=\normalfont]{element} e.g.~names for \conceptsname[conj={,},idx post=use of \string\textkey{name} in]{connectors,text tag} etc.
5569 % Processing attempts to remove some things which would be problematic when used as part of the names for coordinates and nodes, but markup can still cause problems.
5570 % In this case, use \keyname[idx post=problematic markup]{name content} or \keyname[idx post=problematic markup]{text content} for the marked-up version and give \meta{name} a suitably simplified version.
5571 %
5572 % \DescribeBoolkey{as is}\vals{true,false} \fortags[names=as is,type=boolkey]{life,event,period,theory}\AfterLastParam
5573 % Whether to skip capitalisation of \keyname[idx post=whether to capitalise]{name} if using it in the textual content of the \conceptname[type=concept,idx post={capitalisation, preventing}]{element}.
5574 % If true, the \keyname[idx post=prevent capitalisation]{name} will \emph{not} be capitalised; if false, it will be.
5575 % Capitalisation is never used when setting the names of coordinates, nodes etc.
5576 % \Default{false}
5577 %
5578 % \DescribeKey{at}\val{coordinate} \fortags[names=at,type=key]{life,event,period,theory,info,theory circle,main,copyleft,copyright}\AfterLastParam
5579 % Where to place the \conceptname[idx as=placement,font=\normalfont]{element}.
5580 % This key is mandatory for \conceptname[type=tag,idx post=at \string\textrm{mandatory},idx font post=\KeyFont]{theory circle,info,main,copyleft,copyright}.
5581 %
5582 % For \conceptname[type=tag,idx post=at \string\textrm{optional},idx font post=\KeyFont]{life,event,period,theory}, the key is optional.
5583 % By default, the text tag will be placed at \meta{name}, which is a point on the \conceptname[no idx]{timeline} calculated according to date, offset vertically by either \keyname[no link]{yshift} or \keyname[type=dimkey]{text tag yshift}.
5584 % Since \conceptname[type=tag,idx post=text tags \string\textrm{dateless},idx font post=\ConceptFont]{theory} text tags do not have dates, they are placed at the \keyname[type=coord,no link]{(chronos origin)} and a warning is issued.
5585 % \Example{at=\meta{name} \textbar{}- level -2}
5586 % This will align \meta{name} horizontally with its placement point on the \conceptname[no idx]{timeline} and vertically with \keyname[type=node,no link,symbol=eg]{level -2}, assuming at least two levels exist below the \conceptname[no idx]{timeline}.
5587 % See \cref{subsec:levels-coords}.
5588 %
5589 % \changes{v0.9.3}{2025-07-11}{Add \texttt{at aux}.}
5590 % \DescribeKey{at aux}\val{text} \fortags[names=at aux,type=key]{life,period}\AfterLastParam
5591 % A wrapper around \keyname[type=key,no idx]{at} which appends a space followed by the sanitised name of the current element to \meta{text} before passing the result to the key.
5592 %
5593 % At present, the only values of \val{text} which make sense are \texttt{birth} or \texttt{death} (for \conceptname[type=tag,idx post=at aux,idx font post=\KeyFont]{life}) and \texttt{start} or \texttt{end} (for \conceptname[type=tag,idx post=at aux,idx font post=\KeyFont]{period}).
5594 % These options allow the \conceptname[type=element,idx post=at aux,idx font post=\KeyFont]{text tag} to be placed relative to the end points of the \conceptname[type=element,idx post=at aux,idx font post=\KeyFont]{line}, rather than at its centre.
5595 %
5596 % This key is intended for use with \texttt{off line} styles, especially those utilising \keyname[type=dimkey]{line add yshift}.
5597 %
5598 % \DescribeKey{tag anchor}\val{node anchor} \fortags[names=tag anchor,type=key]{life,event,period,theory,info,main,copyleft,copyright}\AfterLastParam
5599 % The \pgf/\TikZ{} anchor to use for the \conceptname[idx as=main connector,idx post=anchor,idx font post=\KeyFont]{element}'s \conceptname[no idx]{main connector}.
5600 % This is the point \pkg{chronos} uses to connect \conceptname[type=tag,idx post=point connected to \string\textsf{timeline}]{life,event,period} text tags to the \conceptname[no idx]{timeline}.
5601 % By default, this anchor is also used when placing the text tag.
5602 % That is, \keyname[idx post=as \string\textkey{anchor}]{tag anchor} is used as the \TikZ{} \keyname[no link,idx post=used as \string\TikZ]{anchor}.
5603 % If you want different anchors to be used for the connection point and for placement, you can use both \keyslabelname.
5604 % \begin{chronoscode}
5605 % \chronoslife{%
5606 % name=friedrich gottlob koenig,
5607 % dates={1774-04-17}:{1833-01-17},
5608 % at=friedrich gottlob koenig |- i1.north,
5609 % tag anchor=east,
5610 % anchor=north east,
5611 % xshift=-5pt,
5612 % }
5613 % \end{chronoscode}
5614 % Default[for \elementslabelname{} below the \conceptname[no idx]{timeline}]{north}
5615 % Default[for \elementslabelname{} above the \conceptname[no idx]{timeline}]{south}
5616 % These defaults may be overridden on a per-\conceptname[type=concept,link,no idx]{tag} basis by setting the \keylabelname{} globally.
5617 % For example,
5618 % \begin{chronoscode}
5619 % \begin{chronos}[%
5620 % life/tag anchor=50,
5621 % event/tag anchor=north east,
5622 % period/tag anchor=south,
5623 % ]
5624 % \end{chronos}
5625 % \end{chronoscode}
5626 %
5627 % \DescribeColkey{colour,color}\val{colour name} \fortags[names={colour,color},type=colkey]{life,event,period,theory,info}\AfterLastParam
5628 % The colour to assign to the \conceptname[type=concept,idx post=colour \string\textrm{to assign}]{element}.
5629 % The effect depends on the type of \conceptname[type=concept,no idx]{element} being created and other settings.
5630 % To modify the default colours, see \cref{subsec:lliwiau,subsec:add-elements-gconfig}.
5631 %
5632 % \DescribeBoolkey{connect}\vals{true,false} \fortags[names={connect},type=boolkey]{life,event,period}\AfterLastParam
5633 % Whether to connect the \conceptname[idx as=whether to connect to \string\textconcept{timeline},font=\normalfont]{element} to the \conceptname[no idx]{timeline}.
5634 % \Default{true}
5635 %
5636 % \DescribeKey{connectors,connectors+,connectors\textquotesingle}\val{list of node anchors} \fortags[names={connectors,connectors+,connectors\textquotesingle},type=key]{life,event,period,theory}\AfterLastParam
5637 % Connection points to create on the \conceptname[type=concept,idx post=connection points]{element}'s \conceptname[idx post=connection points]{text tag}.
5638 % Applies to \conceptname[type=tag,idx post={connectors\string\textrm{, creating additional}},idx font post=\ConceptFont]{life,event,period,theory}.
5639 % \texttt{connectors} and \texttt{connectors+} \emph{add} to the existing list (if any).
5640 % \texttt{connectors\textquotesingle} \emph{replaces} it.
5641 % \Default[empty]
5642 % \begin{chronoscode}[]
5643 % connectors={north,south,east,west},
5644 % connectors'={north},
5645 % connectors+={south},
5646 % connectors={east},
5647 % \end{chronoscode}
5648 % This code would result in connection points at the node's \texttt{north}, \texttt{south} and \texttt{east} anchors.
5649 %
5650 % Note that one connection point is always created if the \conceptname[idx as=main connector \string\textrm{always created}]{element} is of a kind which could be connected to the \conceptname[no idx]{timeline}.
5651 %
5652 %
5653 % \DescribeKey{default colour,default color} Use the \keyname[type=colkey,link pre=\meta{tag}/,idx as=\meta{tag}/default colour,idx post=applying to \string\textconcept{elements}]{default colour} assigned to \conceptname[idx as=default colour,idx post=setting]{elements} of this \conceptname[type=concept,idx post=use \string\textkey{default colour} assigned to \string\textconcept{elements} belonging to]{tag} type. \fortags[names={default colour,default color},type=key]{life,event,period,theory,info,main}\AfterLastParam
5654 % \emph{This key does something quite different if used in a global configuration context.
5655 % See \cref{subsec:add-elements-gconfig} and \cref{subsec:lliwiau} for details.}
5656 % For example,
5657 % \begin{chronoscode}
5658 % \begin{chronos}
5659 % [
5660 % life/colour rotation=true,
5661 % life/default colour=gray,
5662 % ]
5663 % \chronoslife{% use colour from life's colours above colour list
5664 % name=chris,
5665 % dates={1038-01-10}:{1066:11-19},
5666 % at=u2 -| chris,
5667 % }
5668 % \chronoslife{% use gray
5669 % name=sandy,
5670 % dates={1345-11-23}:{1378-12-24},
5671 % at=u3 -| sandy,
5672 % default colour,
5673 % }
5674 % \chronoslife{% use blue
5675 % name=alex,
5676 % dates={1246-09-22}:{1295-02-07},
5677 % at=u5 -| alex,
5678 % colour=blue,
5679 % }
5680 % \chronoslife{% use colour from life's colours below colour list
5681 % name=hilary,
5682 % dates={1156-06-12}:{1201-04-01},
5683 % at=i4 -| hilary,
5684 % }
5685 % \end{chronos}
5686 % \end{chronoscode}
5687 % Note the lack of an argument when used locally.
5688 %
5689 % Note that there is no reason to use this \keylabelname{} unless you wish to override \conceptname[type=concept,link,no idx]{colour rotation} for a particular \elementlabelname{}.
5690 % It suffices not to specify a \keyname[type=colkey]{colour}.
5691 %
5692 % \DescribeBoolkey{place below}\vals{true,false} \fortags[names={place below},type=boolkey]{life,event,period,theory}\AfterLastParam
5693 % By default, \pkg{chronos} alternates putting \elementslabelname{} of a particular type above and below the \conceptname[no idx]{timeline}, but you may wish to put everything above or below, all \elementslabelname{} of particular type above or below.
5694 % Furthermore, you may wish to override the default for particular \elementslabelname.
5695 % Densely-packed \conceptname[idx as=timeline,idx post={densely packed, use of space in}]{timelines}, especially, can require considerable intervention in order to make best use of the space while arranging things in a clear and (hopefully) visually appealing way.
5696 % \begin{chronoscode}[place,below]
5697 % \chronosevent {%
5698 % name=red letter day,
5699 % date=1750,
5700 % place below=false,
5701 % }
5702 % \end{chronoscode}
5703 % \Default{true}
5704 % \Initial
5705 %
5706 % \DescribeKey{place above}A convenience \keylabelname{} equivalent to \lstinline|place below=false|. \fortags[names=place above,type=key]{life,event,period,theory}\AfterLastParam
5707 % Thus the previous code could be rewritten as
5708 % \begin{chronoscode}[place,above]
5709 % \chronosevent {%
5710 % name=red letter day,
5711 % date=1750,
5712 % place above,
5713 % }
5714 % \end{chronoscode}
5715 %
5716 % \changes{v0.9.3}{2025-07-11}{Add \texttt{line add yshift} etc.}
5717 % \DescribeDimkey{line add yshift,line add yshift+,line add yshift\textquotesingle,line add yshift-}\valmarg{dimension}\chronosdochypertargets{dimkey}{life,period}{line add yshift}\fortags{life,period}\AfterLastParam
5718 %
5719 % \emph{Additional} vertical displacement of \conceptsname[no idx,link,link to=\meta{tag}/line]{line} from the \conceptname[no idx]{timeline}.
5720 % This is \emph{added} to the default vertical displacement.
5721 %
5722 % Cf.~\keyname[type=dimkey]{line yshift}.
5723 %
5724 % \DescribeMacro{\lineyshift}The \keyname[no idx,link,link to=line yshift,type=dimkey]{line yshift}.
5725 % This macro is available \emph{only within the \conceptname[link,type=concept]{\meta{timeline specification}}}.
5726 %
5727 %
5728 % \DescribeDatekey{dates}\cvalsmarg{birth date,death date} \fortags[names={dates},type=datekey]{life}\AfterLastParam
5729 % \cvalsmarg{start date,end date} \fortags[names=dates,type=datekey]{period}\AfterLastParam
5730 % Dates of a \conceptname[type=tag,conj=or,link,idx post=dates,idx font post=\KeyFont]{life,period}, specified as explained in \cref{subsec:dyddiadau}.
5731 % The second date may be empty for a living person or ongoing occurrence.
5732 % This key offers a more compact syntax as an alternative to the keys \keyname[type=datekey,no idx]{birth,death} or \keyname[type=datekey,no idx]{start,end} explained below.
5733 % That is
5734 % \begin{chronoscode}[dates]
5735 % dates={1310-02-03}:{1350-06-07},
5736 % \end{chronoscode}
5737 % is equivalent to
5738 % \begin{chronoscode}[birth,death]
5739 % birth={1310-02-03},
5740 % death={1350-06-07},
5741 % \end{chronoscode}
5742 % for \conceptname[type=tag,idx post={date specifications, equivalent}]{life} or
5743 % \begin{chronoscode}[end,start]
5744 % start={1310-02-03},
5745 % end={1350-06-07},
5746 % \end{chronoscode}
5747 % for \conceptname[type=tag,idx post={date specifications, equivalent}]{period}.
5748 %
5749 % By default, these dates are used for both placement on the \conceptname[no idx]{timeline} and the date content of the \conceptname[idx as=text ,idx post=date content in \string\textconcept{life}/\string\textconcept{period}]{element}'s \conceptname[link,link to=\meta{tag}/text tag,idx as=\meta{tag}/text tag,idx post=date content in \string\textconcept{life}/\string\textconcept{period}]{text tag}, but see \keyname[no idx,link]{dates content}.
5750 %
5751 % \DescribeDatekey{birth}\valmarg{birth date} \fortags[names={birth},type=datekey]{life}\AfterLastParam
5752 % The date of birth for a \conceptname[type=tag,link,no idx]{life}, specified as explained in \cref{subsec:dyddiadau}.
5753 % See \keyname[type=datekey,no idx,link]{dates} above.
5754 %
5755 % \DescribeDatekey{death}\valmarg{death date} \fortags[names={death},type=datekey]{life}\AfterLastParam
5756 % The date of death for a \conceptname[type=tag,link,no idx]{life}, specified as explained in \cref{subsec:dyddiadau}.
5757 % See \keyname[type=datekey,no idx]{dates} above.
5758 %
5759 % \DescribeDatekey{start}\valmarg{start date} \fortags[names={start},type=datekey]{period}\AfterLastParam
5760 % The start date of a \conceptname[type=tag,link,no idx]{period}, specified as explained in \cref{subsec:dyddiadau}.
5761 % See \keyname[type=datekey,no idx]{dates} above.
5762 %
5763 % \DescribeDatekey{end}\valmarg{end date} \fortags[names={end},type=datekey]{period}\AfterLastParam
5764 % The end date of a \conceptname[type=tag,link,no idx]{period}, specified as explained in \cref{subsec:dyddiadau}.
5765 % See \keyname[type=datekey,no idx]{dates} above.
5766 %
5767 % \DescribeDatekey{date}\valmarg{date} \fortags[names={date},type=datekey]{event}\AfterLastParam
5768 % The date of an \conceptname[type=tag,link,idx post=date,idx font post=\KeyFont]{event}, specified as explained in \cref{subsec:dyddiadau}.
5769 % By default, the date is used for both placement on the \conceptname[no idx]{timeline} and the date content of the \conceptname[idx as=text tag,idx post=date content in \string\textconcept{event}]{element}'s \conceptname[link,link to=\meta{tag}/text tag,idx as=\meta{tag}/text tag,idx post=date content in \string\textconcept{event}]{text tag}, but see \keyname[no idx]{dates content}.
5770 %
5771 % \DescribeKey{event year on line skip} Don't put this particular event's year on the \conceptname[no idx]{timeline}. \fortags[names=event year on line skip,type=key]{event}\AfterLastParam
5772 % This can be used if the line would otherwise become too crowded when using \keyname{event years on line}.
5773 % Cf.~\keyname[no idx]{special date}.
5774 % See \cref{subsubsec:timeline-marks-years}.
5775 % \Cref{fig:event-years-on-line} illustrates the effect of using this \keylabelname{}.
5776 %
5777 % \DescribeKey{special date}\valmarg{text} \fortags[names=special date,type=key]{event}\AfterLastParam
5778 % Use \meta{text} rather than the \keyname[type=datekey,no idx]{date} for a particular \conceptname[type=tag,link,no idx]{event} when using \keyname[no idx]{event years on line}.
5779 % Cf.~\keyname[no idx]{event year on line skip}.
5780 % See \cref{subsubsec:timeline-marks-years}.
5781 % \Cref{fig:event-years-on-line} illustrates the effect of using this \keylabelname{}.
5782 %
5783 %
5784 % \DescribeKey{dates content}\valmarg{text} \chronosdochypertargets{key}{life,event,period}{dates content}\fortags{life,event,period}\AfterLastParam
5785 % Override the use of specified dates when creating content for the \elementlabelname{}'s \conceptname[type=element,link,link to=\meta{tag}/text tag,no idx]{text tag}.
5786 % This is intended for ‘special’ cases e.g.~uncertain, approximate or non-standardly specified dates.
5787 % By default, the value is derived from \keyname[type=datekey,no idx]{dates} or \keyname[type=datekey,no idx]{date}.
5788 % \Example{dates content=\{c600--1450\bs,\cs{celabel}\}}
5789 %
5790 % \DescribeKey{name content}\valmarg{text} \fortags[names=name content,type=key]{life,event,period,theory,info,main}\AfterLastParam
5791 % Override the use of the \conceptname[type=concept,link,no idx]{element}'s \keyname[idx post=override for \string\textconcept{text tag} content]{name} when creating content for the \elementlabelname's \conceptname[type=element,link,no idx,link to=\meta{tag}/text tag]{text tag}.
5792 % This might be necessary if special markup is required.
5793 % For example,
5794 % \begin{chronoscode}
5795 % name content=\LaTeX3 Hummingbird,
5796 % \end{chronoscode}
5797 % It may also be desirable where longer content would render reuse of a \keyname[no idx]{name} unwieldy.
5798 %
5799 % \DescribeKey{text content}\valmarg{text} \fortags[names=text content,type=key]{life,event,period,theory,info}\AfterLastParam
5800 % Override the use of both \conceptname[type=concept,link,no idx]{element}'s \keyname[no idx]{name} and \keyname[type=datekey,no idx]{dates} when creating content for the \conceptname[type=concept,link,no idx]{element}'s \conceptname[type=element,link,link to=\meta{tag}/text tag,no idx]{text tag}.
5801 % \begin{chronoscode}[text,content]
5802 % name=block printing,
5803 % text content={Block printing, originally used to print pictures and text onto cloth, developed into a method of printing books on paper.},
5804 % \end{chronoscode}
5805 %
5806 % \DescribeBoolkey{phantom}\vals{true,false} \fortags[names=phantom,type=boolkey]{life,event,period}\AfterLastParam
5807 % Create a ‘phantom’ \elementlabelname.
5808 % Phantoms have assigned colours, require \keysname[idx post=required for phantoms]{name} and potentially feature \conceptsname[link,idx post=phantoms]{line}, but they do not have \conceptsname[conj=or,idx post=absent in phantoms]{text tag,connection}.
5809 % Note that these \conceptsname[idx post=phantoms,idx as=additional]{components} are not invisible; \emph{they are not constructed at all}.
5810 % \Default{true}
5811 % \Initial{false}
5812 % \Example{\cs{chronosperiod}\marg{name=c17,dates=1600:1699,colour=cyan,phantom}}
5813 % This \keylabelname{} may be used globally to set a different \conceptname[link,no idx,type=concept]{tag}-specific default.
5814 % \begin{chronoscode}
5815 % \begin{chronos}[%
5816 % period/phantom,% make periods are phantoms by default
5817 % event/phantom=true,% make events are phantoms by default
5818 % life/phantom=false,% make lives non-phantoms by default (this matches the package default)
5819 % ]
5820 % \end{chronos}
5821 % \end{chronoscode}
5822 % For example, this \keylabelname{} may be used to colour stretches of time without visibly labelling them, in conjunction with non-phantom \conceptsname[conj=or,link,no idx]{life,event}\texseans{701743}.
5823 % \begin{chronoscode}
5824 % \begin{chronos}[% https://tex.stackexchange.com/a/701743/
5825 % ...
5826 % period={%
5827 % phantom,
5828 % colours below={orange,cyan,green,green},
5829 % },
5830 % ...
5831 % ]
5832 % % these **must** be named, even though they invisible, detached phantoms
5833 % \chronosperiod{dates=2018:2019,name={n1}}
5834 % \chronosperiod{dates=2019:2022,name={n2}}
5835 % \chronosperiod{dates=2022:2023,name={n3}}
5836 % \chronosperiod{dates=2023:2024,name={n4}}
5837 % ...
5838 % \end{chronos}
5839 % \end{chronoscode}
5840 %
5841 % \DescribeKey{caption}\valmarg{text} \fortags[names=caption,type=key]{info}\AfterLastParam
5842 % The caption for an \conceptname[type=concept,link,no idx]{element} of type \conceptname[type=tag,link,idx post=setting caption]{info}.
5843 %
5844 % \DescribeKey{labels}\cvalsmarg{upper label,lower label} \fortags[names=labels,type=key]{theory circle}\AfterLastParam
5845 % Labels to be placed above and below a \conceptname[type=element,link,no idx]{theory circle}.
5846 %
5847 % \DescribeKey{circle texts}\cvalsmarg{upper text,lower text} \fortags[names={circle texts},type=key]{theory circle}\AfterLastParam
5848 % The text to place in the upper and lower parts of a \conceptname[link,no idx]{theory circle}.
5849 % By default, this uses \lstinline|text effects along path|, so the content must be consistent with the restrictions imposed by use of this \TikZ{} \texttt{decoration}.
5850 %
5851 % \DescribeDimkey{sizes}\cvals{outer circle dimension,inner circle dimension} \fortags[names={sizes,sizes+,sizes-,sizes\textquotesingle,sizes\textquotesingle +,sizes\textquotesingle -},type=dimkey]{theory circle}\AfterLastParam
5852 % The sizes of the inner and outer circles used to create a \conceptname[type=element,link,no idx]{theory circle}.
5853 % \Default{15pt:9pt}
5854 % The difference between the two dimensions gives the thickness of the ring around which text is placed; the size of the inner circle gives the dimension of the hole in which a symbol or similar may be placed.
5855 % This \keylabelname{} may be used globally to set defaults.
5856 % \begin{chronoscode}
5857 % \begin{chronos}[%
5858 % theory/circles/sizes'+=10pt:5pt,
5859 % ]
5860 % \end{chronos}
5861 % \end{chronoscode}
5862 %
5863 %^^A END subsec:add-elements-lconfig
5864 %
5865 % \subsection{Additional Elements: Local/Global Configuration}\label{subsec:add-elements-glconfig}
5866 % \chronosdocidx[type=tag,font=\ConceptFont,idx post={configuration,local/global}]{life,event,period,theory,info,theory circle,main,copyleft,copyright}\vspace{-\baselineskip}
5867 %^^A BEGIN subsec:add-elements-glconfig
5868 %
5869 % Although you will generally want to use the following keys in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}, they can also be used to influence the format of a particular \elementlabelname{}.
5870 %
5871 % \DescribeDateformat{\meta{tag}/date format}\valmarg{date format specification} \hypertarget{dateformat:event/date-format}{}\fortags{event}\AfterLastParam
5872 % Use \meta{date format specification} to format date.
5873 % \begin{chronoscode}
5874 % \chronosevent{%
5875 % ...,
5876 % date format={!a, !d !b},% show short day of week, day of month and short month
5877 % }
5878 % \end{chronos}
5879 % \end{chronoscode}
5880 % See \cref{subsec:dyddiadau} for details and defaults.
5881 %
5882 % \DescribeDateformat{\meta{tag}/date formats}\cvalsmarg{date format spec.,date format spec.,date format spec.} \hypertarget{dateformat:life/date-formats}{}\hypertarget{dateformat:period/date-formats}{}\fortags{life,period}\AfterLastParam
5883 % Use \meta{date format spec.}s to format date range.
5884 % \begin{chronoscode}
5885 % \chronosevent{%
5886 % ...,
5887 % date formats={!d}:{!d !B},% show day of month for start/birth date and day of month and month name for end/death date
5888 % }
5889 % \end{chronos}
5890 % \end{chronoscode}
5891 % See \cref{subsec:dyddiadau} for details and defaults.
5892 %
5893 % \DescribeKey{full dates,\meta{tag}/full dates}\hypertarget{key:life/full-dates}{}\hypertarget{key:period/full-dates}{}\hypertarget{key:event/full-dates}{}Show full dates. \fortags{life,event,period}\AfterLastParam
5894 % \begin{chronoscode}
5895 % \chronoslife{%
5896 % ...,
5897 % full dates,
5898 % }
5899 % \end{chronos}
5900 % \end{chronoscode}
5901 % See \cref{subsec:dyddiadau} for details and defaults.
5902 %
5903 % \DescribeKey{only years,\meta{tag}/only years}\hypertarget{key:life/only-years}{}\hypertarget{key:period/only-years}{}\hypertarget{key:event/only-years}{}Show only years. \fortags{life,event,period}\AfterLastParam
5904 % \begin{chronoscode}
5905 % \chronoslife{%
5906 % ...,
5907 % only years,% use only years in all dates
5908 % event/full dates,% override to use full dates for events
5909 % }
5910 % \end{chronos}
5911 % \end{chronoscode}
5912 % See \cref{subsec:dyddiadau} for details and defaults.
5913 %
5914 % \DescribeKey{show eras,\meta{tag}/show eras}\hypertarget{key:life/show-eras}{}\hypertarget{key:period/show-eras}{}\hypertarget{key:event/show-eras}{}Show eras. \fortags{life,event,period}\AfterLastParam
5915 % \begin{chronoscode}[show]
5916 % \chronoslife{%
5917 % ...,
5918 % show eras,% show eras in all text tags
5919 % }
5920 % \end{chronos}
5921 % \end{chronoscode}
5922 % See \cref{subsec:dyddiadau} for details and defaults.
5923 %
5924 % \DescribeKey{without eras,\meta{tag}/without eras}\hypertarget{key:life/without-eras}{}\hypertarget{key:period/without-eras}{}\hypertarget{key:event/without-eras}{}Omit eras. \fortags{life,event,period}\AfterLastParam
5925 % \begin{chronoscode}[without,show]
5926 % \chronoslife{%
5927 % ...,
5928 % without eras,% omit eras in all text tags
5929 % life/show eras,% override to show eras in life text tags
5930 % }
5931 % \end{chronos}
5932 % \end{chronoscode}
5933 % See \cref{subsec:dyddiadau} for details and defaults.
5934 %
5935 % \DescribeKey{only text,\meta{tag}/only text}\hypertarget{key:life/only-text}{}\hypertarget{key:period/only-text}{}\hypertarget{key:event/only-text}{}Omit all date information. \fortags{life,event,period}\AfterLastParam
5936 % \Default*{}disabled
5937 % \begin{chronoscode}
5938 % \chronoslife{%
5939 % ...,
5940 % only text,% omit all dates from all tags
5941 % }
5942 % \end{chronos}
5943 % \end{chronoscode}
5944 %
5945 % The following six sets of keys all work in the same way\footnote{%^^A
5946 % There is a seventh set, \keyname[target,no link]{\meta{tag}/tag,\meta{tag}/tag+,\meta{tag}/tag\textquotesingle}\chronosdochypertargets{key}{life,event,period,theory,info}{tag,tag+,tag\textquotesingle}, which may be of interest to advanced users.
5947 % These \keyslabelname{} are also potentially destructive.
5948 % Not only \keyname[no link]{\meta{tag}/tag\textquotesingle}, but also \keyname[no link]{\meta{tag}/tag} and even \keyname[no link]{\meta{tag}/tag+}, can overwrite default settings for such things as \conceptname[type=concept,link,no idx]{colour rotation}.}.
5949 % If used when creating a specific \elementlabelname{}, they affect that \elementlabelname{}.
5950 %^^A If set in the optional argument to \enviro{chronos} or \keyname[type=macro]{\cs{chronosset}} with no prefix, they set a default.
5951 %^^A This default is used if no \conceptname[type=concept]{tag}-specific setting is configured.
5952 % If set in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or \keyname[type=macro,no idx]{\cs{chronosset}} with a \conceptname[type=concept,no idx]{tag} prefix, they set the \conceptname[type=concept,idx post={prefix, influence on configuration}]{tag}-specific setting and will affect all \elementslabelname{} belonging to that \taglabelname{} unless overridden locally.
5953 %
5954 % \emph{Note these \keyslabelname{} \emph{require} a \conceptname[type=concept,idx as=tag,idx post=prefix required]{\taglabelname} prefix if used in a global context, such as the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}.
5955 % They do \emph{not} need a prefix if used when creating a particular \elementlabelname{}.}
5956 % For example,
5957 % \begin{chronoscode}
5958 % \begin{chronos}
5959 % [
5960 % event/line+={semithick},% prefix required ; event/ explicit
5961 % ]
5962 % \chronosevent{%
5963 % name=dydd dewi sant,
5964 % date={1982-03-01},
5965 % line+={double},% no prefix ; event/ implicit
5966 % }
5967 % \end{chronos}
5968 % \end{chronoscode}
5969 %
5970 % \DescribeKey{\meta{tag}/connection,\meta{tag}/connection+,\meta{tag}/connection\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period,theory}{connection,connection+,connection\textquotesingle}\fortags{life,event,period,theory}\AfterLastParam
5971 % \meta{key-value list} to apply to this \elementlabelname{}'s \conceptname[type=element]{connection}.
5972 % This affects the line drawn between the \elementlabelname{}'s \conceptname[idx post=connection,idx font post=\ConceptFont]{connector} on the \conceptname[no idx]{timeline} and the \conceptname[idx post=connection,idx font post=\ConceptFont]{text tag}'s \conceptname[idx post=connection,idx font post=\ConceptFont]{main connector}.
5973 % This is intended for arbitrary \TikZ{} \keyslabelname{}; it should \emph{not} be used for \pkg{chronos} keys as they may not be processed correctly.
5974 % \keyname{\meta{tag}/connection,\meta{tag}/connection\textquotesingle} replace any current list; \keyname{\meta{tag}/connection+} adds to it.
5975 %
5976 % \DescribeKey{\meta{tag}/line,\meta{tag}/line+,\meta{tag}/line\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period}{line,line+,line\textquotesingle}\fortags{life,event,period}\AfterLastParam
5977 % \meta{key-value list} to apply to this \elementlabelname{}'s \conceptname[idx post=style]{line} on or parallel to the \conceptname[no idx]{timeline}.
5978 % This is the line representing the temporal extension of a \conceptname[conj=or,idx post=representation of temporarl extention]{life,period}.
5979 % This is intended for arbitrary \TikZ{} \keyslabelname{}; it should \emph{not} be used for \pkg{chronos} keys as they may not be processed correctly.
5980 % \keyname{\meta{tag}/line,\meta{tag}/line\textquotesingle} replace any current list; \keyname{\meta{tag}/line+} adds to it.
5981 % \Default[on line, life/period]{fill=\#\#1,fill opacity=.25,draw=none}
5982 % \Default[on line, event]{draw=\#\#1,fill=none,opacity=.25}
5983 % \Default[off line, life/period]{draw=\#\#1,thick,fill opacity=.75}
5984 % \Default[off line, event]{draw=\#\#1,draw opacity=.75,fill=none}
5985 %
5986 % \DescribeDimkey{line yshift,line yshift+,line yshift\textquotesingle,line yshift-}\valmarg{dimension}\chronosdochypertargets{dimkey}{life,period}{line yshift}\fortags{life,period}\AfterLastParam
5987 %
5988 % Default vertical displacement of \conceptsname[no idx,link,link to=\meta{tag}/line]{line} from the \conceptname[no idx]{timeline}.
5989 % Whether the displacement is reckoned from the centre or border of the \conceptname[no idx]{timeline} depends on the default placement.
5990 %
5991 % Cf.~\keyname[type=dimkey]{line add yshift}.
5992 %
5993 % \DescribeMacro{\lineyshift}The \keyname[no idx,link,link to=line yshift,type=dimkey]{line yshift}.
5994 % This macro is available \emph{only within the \conceptname[link,type=concept]{\meta{timeline specification}}}.
5995 %
5996 % \DescribeKey{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period,theory,info}{text tag,text tag+,text tag\textquotesingle}\fortags{life,event,period,theory,info}\AfterLastParam
5997 % \meta{key-value list} to apply to this \elementlabelname{}'s \conceptname[type=element,idx post=apply arbitrary \string\TikZ{} to]{text tag}.
5998 % This is intended for arbitrary \TikZ{} \keyslabelname{}; it should \emph{not} be used for \pkg{chronos} keys as they may not be processed correctly.
5999 % \keyname{\meta{tag}/text tag,\meta{tag}/text tag\textquotesingle} replace any current list; \keyname{\meta{tag}/text tag+} adds to it.
6000 % \begin{chronoscode}
6001 % \chronosset{%
6002 % life/text tag+={font=\scshape\small},
6003 % event/text tag+={font=\scshape\footnotesize},
6004 % period/text tag+={font=\itshape\footnotesize},
6005 % }
6006 % \end{chronoscode}
6007 % See also \keyname[no idx]{\meta{tag}/date font,\meta{tag}/text font}.
6008 %
6009 %
6010 % \DescribeKey{\meta{tag}/chronos connector,\meta{tag}/chronos connector+,\meta{tag}/chronos connector\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period,theory}{chronos connector,chronos connector+,chronos connector\textquotesingle}\fortags{life,event,period}\AfterLastParam
6011 % Specify \TikZ{} settings to be used when creating \conceptname[idx as=chronos connector]{chronos connectors} on the \conceptname[no idx]{timeline}.
6012 % Note that \keyname{\meta{tag}/chronos connector} \emph{adds} options to the current list.
6013 % If, for some reason, you want to override this, you must do so explicitly.
6014 % In general, it does \emph{not} make sense to change this base option, so consider carefully whether you wish to do so.
6015 % \Default{anchor=center,inner sep=0pt,outer sep=0pt}
6016 %
6017 % \DescribeKey{\meta{tag}/text tag connector,\meta{tag}/text tag connector+,\meta{tag}/text tag connector\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period,theory}{text tag connector,text tag connector+,text tag connector\textquotesingle}\fortags{life,event,period,theory}\AfterLastParam
6018 % Specify \TikZ{} settings to be used when creating \conceptname[idx as=text tag connector,idx post=configuration]{text tag connectors} on the \conceptname[no idx]{timeline}.
6019 % Note that \keyname{\meta{tag}/text tag connector} \emph{adds} options to the current list.
6020 % If, for some reason, you want to override this, you must do so explicitly.
6021 % In general, it does \emph{not} make sense to change this base option, so consider carefully whether you wish to do so.
6022 % \Default{anchor=center,inner sep=0pt,outer sep=0pt}
6023 %
6024 % \DescribeKey{\meta{tag}/main text tag connector,\meta{tag}/main text tag connector+,\meta{tag}/main text tag connector\textquotesingle}\valmarg{key-value list} \chronosdochypertargets{key}{life,event,period,theory}{main text tag connector,main text tag connector+,main text tag connector\textquotesingle}\fortags{life,event,period,theory}\AfterLastParam
6025 % Specify \emph{additional} \TikZ{} settings to be used when creating the main \conceptname[idx as=text tag connector,idx post=additional configuration for main]{connectors} on \conceptname[idx as=text tag,idx post=configuration specific to main connector]{text tags}.
6026 % \keyname{\meta{tag}/main text tag connector,\meta{tag}/main text tag connector\textquotesingle} replace any current list; \keyname{\meta{tag}/main text tag connector+} adds to it.
6027 % The ‘main’ \conceptname[idx post={main\string\textnormal{, identifying}},idx font post=\ConceptFont]{connector} is the one which connects (or would connect) the \conceptname[idx post={main connector\string\textnormal{, identifying}},idx font post=\ConceptFont]{text tag} to the \conceptname[no idx]{timeline}.
6028 % These \keyslabelname{} are rarely needed because, usually, you want all the \conceptname[idx as=text tag connector,no idx]{text tag connectors} to look the same.
6029 % Only use one of these three \keyslabelname{} rather than one from the previous set if you \emph{don't} want \meta{key-value list} to apply to all of them.
6030 % You do \emph{not} need to duplicate settings here.
6031 %
6032 % Note that \keyname{\meta{tag}/main text tag connector} \emph{adds} options to the current list.
6033 % If, for some reason, you want to override this, you must do so explicitly.
6034 % In general, it does \emph{not} make sense to change this base option, so consider carefully whether you wish to do so.
6035 % \Default{anchor=center,inner sep=0pt,outer sep=0pt}
6036 %
6037 % \DescribeKey{\meta{tag}/label,\meta{tag}/label\textquotesingle,\meta{tag}/label+}\valmarg{key-value list} \chronosdochypertargets{key}{info,theory circle}{label,label\textquotesingle,label+}\fortags{info,theory circle}\AfterLastParam
6038 % Style to apply to the \conceptname[idx post=style]{caption} of an \elementlabelname{} of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,idx post=style of caption]{info} or the \conceptname[idx post=style]{labels} of an \elementlabelname{} of type \conceptname[type=tag,idx post=common style for \string\textconcept{labels}]{theory circle}.
6039 % In the latter case, the style applies to both the upper and lower \conceptname[idx post=common style for upper and lower]{label}.
6040 % \Default[empty]
6041 % \keyname[no idx,link prefix=\meta{tag}/]{label,label\textquotesingle} replace the current list; \keyname[link prefix=\meta{tag}/,no idx]{label+} replaces it.
6042 %
6043 % \DescribeKey{\meta{tag}/title,\meta{tag}/title\textquotesingle,\meta{tag}/title+}\valmarg{key-value list} \chronosdochypertargets{key}{main}{title,title\textquotesingle,title+}\fortags{main}\AfterLastParam
6044 % Style to apply to the \conceptname[idx post=style]{main title}, an \elementlabelname{} of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,idx post=style for \string\textconcept{main title}]{main}.
6045 % \Default[empty]
6046 % \keyname{main/title,main/title\textquotesingle} replace the current list; \keyname{main/title+} replaces it.
6047 %
6048 % \DescribeStyle{\meta{tag}/title lines}Place \conceptname[idx post=title lines,idx font post=\KeyFont]{main title} between two parallel lines aligned to the width of the text. \chronosdochypertargets{style}{main}{title lines}\fortags{main}\AfterLastParam
6049 % This \stylelabelname{} is available when creating a \conceptname[idx post=title lines,idx font post=\KeyFont]{text tag} of type \conceptname[type=tag,no idx]{main} and draws lines along the northern and southern sides of the node.
6050 % It is used in \keyname[type=chronosstyle,idx post=use of \string\texttt{title lines}]{somewhat plain,date centric}.
6051 %
6052 % \DescribeKey{\meta{tag}/author}\valmarg{text} \chronosdochypertargets{key}{copyleft,copyright}{author}\fortags{copyleft,copyright}\AfterLastParam
6053 % The author's name for a \conceptname[type=tag,conj=or,no idx]{copyleft,copyright} notice.
6054 % This is used only if \keyname{name content} is unset.
6055 % \Default[as a last resort]{Author}
6056 % If \keyname[link prefix=copyleft/,idx as=copyleft/author]{author} and \keyname[idx post=if unset]{name content} are unset, \pkg{chronos} first tries to figure out a suitable author.
6057 % If \keyname[idx post=capitalisation]{name} is set, a capitalised version is used.
6058 % Otherwise, if \keyname[type=macro,no link]{\cs{svnauthor}} is defined, \cs{svnFullAuthor}\marg{\cs{svnauthor}} is used, if \keyname[type=macro,no link]{\cs{svnFullAuthor}} is available, or \cs{svnauthor}, if it is not.
6059 % If \pkg{chronos} still hasn't found an author, \texttt{Author} is used.
6060 %
6061 % \DescribeBoolkey{\meta{tag}/copyleft}\vals{true,false} \chronosdochypertargets{boolkey}{copyleft,copyright}{copyleft}\fortags{copyleft,copyright}\AfterLastParam
6062 % Whether a \conceptname[type=tag,conj=or,no idx]{copyleft,copyright} notice should specify copyleft or copyright.
6063 % \Default*{false} (\keyname[type=macro]{\cs{chronoscopyright}})\par
6064 % \Default*{true} (\keyname[type=macro]{\cs{chronoscopyleft}})\par
6065 % \keyname[type=macro,no idx]{\cs{chronoscopyright}} respects the global default, so if you set \keyname[type=boolkey,no idx]{\meta{tag}/copyleft} \texttt{true} with \keyname[type=macro,idx post=effect on \string\cs{chronoscopyright}]{\cs{chronosset}}, both \macroslabelname{} will make copyleft notices unless overridden in the \meta{key-value list} of options they absorb when executed.
6066 % \keyname[type=macro,no idx]{\cs{chronoscopyleft}} always creates a copyleft notice, regardless of any global settings, unless \keyname[type=boolkey,prefix=copyleft/,no idx]{copyleft} is explicitly set \texttt{false} when invoked.
6067 %
6068 % \DescribeKey{\meta{tag}/notice}\valmarg{macro definition} \chronosdochypertargets{key}{copyleft,copyright}{notice}\fortags{copyleft,copyright}\AfterLastParam
6069 % Template for a \conceptname[type=tag,conj=or,no idx]{copyleft,copyright} notice.
6070 % It is used as the definition of the \macrolabelname{} used for the content of the notice and should absorb two arguments: year and author.
6071 % \Default*{\{Copyleft \bs textcopyleft\{\} \#1 \#2\}} (if \keyname[type=boolkey,no idx]{\meta{tag}/copyleft} is \texttt{true})\par
6072 % \Default*{\{Copyright \bs textcopyright\{\} \#1 \#2\}} (if \keyname[type=boolkey,no idx]{\meta{tag}/copyleft} is \texttt{false})\par
6073 % For example,
6074 % \begin{chronoscode}
6075 % \begin{chronos}
6076 % [
6077 % copyright/notice={Created by #2 in the year #1 of the Great Debacle at the behest of His Gracious Grasp Full Acre Fanfare the Nineteenth.},
6078 % ]
6079 % \end{chronoscode}
6080 %
6081 % \DescribeKey{\meta{tag}/rotate}\val{angle} \chronosdochypertargets{key}{copyleft,copyright}{rotate}\fortags{copyleft,copyright}\AfterLastParam
6082 % The angle to rotate the node containing a \conceptname[type=tag,conj=or,no idx]{copyleft,copyright} notice.
6083 % \Default{90}
6084 %
6085 % \DescribeKey{\meta{tag}/year}\val{text} \chronosdochypertargets{key}{copyleft,copyright}{year}\fortags{copyleft,copyright}\AfterLastParam
6086 % The year of publication for a \conceptname[type=tag,conj=or,no idx]{copyleft,copyright} notice.
6087 % \Default[if available]{\cs{svnyear}}
6088 % \Default[otherwise]{\cs{today}}
6089 %
6090 % \subsubsection{Specialist Fonts for Text Tags}\label{subsubsec:text-tags-specialist-fonts}
6091 %^^A BEGIN subsubsec:text-tags-specialist-fonts
6092 %
6093 % \DescribeKey{\meta{tag}/date font}\valmarg{font commands} \hypertarget{key:life/date-font}{}\hypertarget{key:event/date-font}{}\hypertarget{key:period/date font}{}\fortags{life,event,period}\AfterLastParam
6094 % Set font macros to be applied to the date content of \conceptsname[link,idx post={font, date(s)}]{text tag}.
6095 % \Default{}
6096 % \begin{chronoscode}
6097 % \chronosset{%
6098 % ...
6099 % event/date font=\itshape\bfseries\small,
6100 % life/date font=\sffamily\large,
6101 % period/date font=\upshape\normalsize\mdseries,
6102 % }
6103 % \end{chronoscode}
6104 % Note that if you want to alter the font for the entire contents of the \conceptname[link,no idx]{text tag}, it is better to just use \texttt{\meta{tag}/text tag+={font\valmarg{}}}.
6105 % Use \texttt{date font} to modify those settings specifically for date(s).
6106 % Note that if \conceptname[link,no idx]{era label} are included, they will not be affected.
6107 %
6108 % \DescribeKey{\meta{tag}/text font}\valmarg{font commands} \hypertarget{key:life/text-font}{}\hypertarget{key:event/text-font}{}\hypertarget{key:period/text-font}{}\fortags{life,event,period}\AfterLastParam
6109 % Set font macros to be applied to the text content of \conceptsname[link,idx post={font, text}]{text tag}.
6110 % \Default{}
6111 % \begin{chronoscode}
6112 % \chronosset{%
6113 % ...
6114 % event/text font=\uishape\large,
6115 % life/text font=\sffamily\Large,
6116 % period/text font=\small\bfseries,
6117 % }
6118 % \end{chronoscode}
6119 % Note that if you want to alter the font for the entire contents of the \conceptname[link,no idx]{text tag}, it is better to just use \texttt{\meta{tag}/text tag+={font\valmarg{}}}.
6120 % Use \texttt{text font} to modify those settings specifically for names.
6121 %
6122 %
6123 %^^A END subsubsec:text-tags-specialist-fonts
6124 %
6125 %^^A END subsec:add-elements-glconfig
6126 %
6127 % \subsection{Additional Elements: Global Configuration}\label{subsec:add-elements-gconfig}
6128 % \chronosdocidx[type=tag,font=\ConceptFont,idx post={configuration,global}]{life,event,period,theory,info,theory circle,main,copyleft,copyright}\vspace{-\baselineskip}
6129 %^^A BEGIN subsec:add-elements-gconfig
6130 %
6131 % \emph{Except where otherwise noted, the \keyslabelname{} in this section should not be used locally.}
6132 % The following \keyslabelname{} are intended for use in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} or in \keyname[type=macro,no idx]{\cs{chronosset}}.
6133 % They are not intended for use when creating particular \conceptname[type=concept,idx as=element,idx post=global colour configuration,link,link to=element]{elements}.
6134 % For example, \keyname[type=colkey,link prefix=\meta{tag}/,idx as=\meta{tag}/default colour,idx post=setting \string\emph{vs.}\space using]{default colour} should \emph{not} be used for particular \conceptname[type=concept,idx as=element,link,link to=element,no idx]{elements}, unless you wish to \emph{use} the existing default, as opposed to setting it.
6135 % Instead, use \keyname[type=colkey]{colour} to override default settings.
6136 %
6137 % See \cref{subsec:lliwiau} for further information about \colkeyslabelname{} and \collistkeyslabelname{}.
6138 %
6139 % \DescribeKey{life,event,period,theory}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6140 % Equivalent to prefixing each item in \meta{key-value list} with \meta{tag}.
6141 % \begin{chronoscode}
6142 % \begin{chronos}
6143 % [
6144 % life={%
6145 % full dates,
6146 % without eras,
6147 % text tag+={font=\sffamily},
6148 % text font=\bfseries,
6149 % date font=\small,
6150 % colours above={red,orange,blue},
6151 % colours below={darkgray,gray,black,magenta},
6152 % },
6153 % period={%
6154 % only years,
6155 % text tag+={opacity=.75},
6156 % },
6157 % event={%
6158 % text tag+={double=blue},
6159 % },
6160 % ]
6161 % \end{chronos}
6162 % \end{chronoscode}
6163 %
6164 % \DescribeColkey{\meta{tag}/default colour,\meta{tag}/default color}\val{colour name} \fortags[names={\meta{tag}},type=colkey]{life,event,period,theory,info}\AfterLastParam
6165 % The default colour to use for all \conceptname[idx as=element,type=concept,link,link to=element,no idx]{elements} of type \meta{tag}, as explained in \cref{subsec:lliwiau}.
6166 % \emph{This key does something quite different if used when creating a specific \elementlabelname.
6167 % See \cref{subsec:add-elements-lconfig} for details.}
6168 % For example,
6169 % \begin{chronoscode}
6170 % \begin{chronos}[
6171 % life/default colour=blue,
6172 % event/default colour=green,
6173 % period/default colour=red,
6174 % ]
6175 % \end{chronos}
6176 % \end{chronoscode}
6177 % See \cref{subsec:lliwiau} for details and defaults.
6178 %
6179 % \DescribeCollistkey[noindex]{colours above,colors above,\meta{tag}/colours above,\meta{tag}/colors above}\valmarg{colour list} \fortags{life,event,period,theory}\AfterLastParam
6180 % The default and \conceptname[type=concept,no idx,link]{tag}-specific colour lists for all susceptible \conceptname[idx as=element,type=concept,link,link to=element,no idx]{elements} above the \conceptname[no idx]{timeline}.
6181 % \emph{These keys should never be used when creating specific \elementslabelname.}
6182 % \begin{chronoscode}
6183 % \begin{chronos}[
6184 % colours above={gray,blue,green},
6185 % life/colours above={magenta,pink,purple},
6186 % ]
6187 % \end{chronos}
6188 % \end{chronoscode}
6189 % See \cref{subsec:lliwiau} for details and defaults.
6190 %
6191 % \DescribeCollistkey[noindex]{colours below,colors below,\meta{tag}/colours below,\meta{tag}/colors below}\valmarg{colour list} \fortags{life,event,period,theory}\AfterLastParam
6192 % The default and \conceptname[type=concept,no idx,link]{tag}-specific colour lists for all susceptible \conceptname[idx as=element,type=concept,no idx]{elements} below the \conceptname[no idx]{timeline}.
6193 % \emph{These keys should never be used when creating specific \elementslabelname.}
6194 % \begin{chronoscode}
6195 % \begin{chronos}[
6196 % colours below={red,orange,magenta},
6197 % theory/colours below={black,gray},
6198 % ]
6199 % \end{chronos}
6200 % \end{chronoscode}
6201 % See \cref{subsec:lliwiau} for details and defaults.
6202 %
6203 %^^A \DescribeCollistkey{colours above from clist,colors above from clist}\val{} \fortags{life,event,period,theory}\AfterLastParam
6204 %^^A
6205 %^^A \DescribeCollistkey{colours below from clist,colors below from clist}\val{} \fortags{life,event,period,theory}\AfterLastParam
6206 %
6207 % \DescribeBoolkey[noindex]{colour rotation,color rotation,\meta{tag}/colour rotation,\meta{tag}/color rotation}\vals{true,false} \fortags{life,event,period,theory}\AfterLastParam
6208 % Whether \conceptname[type=concept,link,no idx]{colour rotation} is enabled by default.
6209 % \Default{true}
6210 % \begin{chronoscode}
6211 % \begin{chronos}[
6212 % colour rotation=false,
6213 % ]
6214 % \end{chronos}
6215 % \end{chronoscode}
6216 % See \cref{subsec:lliwiau} for details and defaults.
6217 %
6218 % \DescribeKey{copyleft,copyleft\textquotesingle,copyleft+,copyright,copyright\textquotesingle,copyright+}\valmarg{key-value list} \fortags[names={copyleft,copyleft\textquotesingle,copyleft+,copyright,copyright\textquotesingle,copyright+},type=key]{copyleft,copyright}\AfterLastParam
6219 % Style to apply to the \conceptname[conj=or,idx post=style]{copyleft,copyright}, an \elementlabelname{} of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,conj=/]{copyleft,copyright}.
6220 % \Default[empty]
6221 % \keyname[link,no idx]{copyleft,copyleft\textquotesingle,copyright,copyright\textquotesingle} replace the current list; \keyname[link,no idx]{copyleft+,copyright+} replace it.
6222 %
6223 % \DescribeBoolkey{event dates split}\vals{true,false} \fortags{event}\AfterLastParam
6224 % Create two \conceptsname[idx post=event dates split,idx font post=\KeyFont]{text tag} for each \conceptname[type=tag,idx post=split \string\textconcept{text tags}]{event}, one above and one below the \conceptname[no idx]{timeline}.
6225 % The formatted \keyname[type=datekey,idx post=effect of \string\textkey{event dates split} on use of]{date} or \keyname[idx post=effect of \string\textkey{event dates split} on use of]{dates content} goes into one and the formatted \keyname[idx post=effect of \string\textkey{event dates split} on use of,conj=or]{name,name content} goes into the other.
6226 % \emph{This \keylabelname{} has no effect on \conceptname[idx as=text tag,no idx]{text tags} belonging to other \conceptname[type=concept,idx as=tag,no idx]{tags}, such as \conceptname[type=tag,conj=or,idx post=split \string\textconcept{text tags} unsupported]{life,period}.}
6227 % \Default{true}
6228 % \Initial{false}
6229 %
6230 % \DescribeStyle{event date split}Additional \stylelabelname{} applied to \conceptname[idx as=text tag,no idx]{text tags} of type \conceptname[type=tag,idx post={split \string\textconcept{text tags}, style}]{event} if \keyname[type=boolkey,no idx]{event dates split} is \texttt{true}. \fortags{event}\AfterLastParam
6231 % This \stylelabelname{} is provided primarily for use \emph{outside} the \enviro{chronos} environment, in case you want some \conceptname[idx as=timeline,idx post={split and unsplit \string\textconcept{events}, combining in same document}]{timelines} with split events and some without.
6232 % It is \emph{not} intended to support both split and unsplit events on the same \conceptname[idx post={split and unsplit \string\textconcept{events}, combining in same \string\textconcept{timeline} unsupported}]{timeline}.
6233 % \Default[empty]
6234 %
6235 % The next twelve sets of \keyslabelname{} fall into two groups, corresponding to the five sets of corresponding \keyslabelname{} explained in \cref{subsec:add-elements-glconfig}.
6236 % \textbf{\emph{None of these keys should be used when creating specific \elementslabelname{}.}}
6237 %
6238 % The first set of six consists of plural forms, as opposed to the singular forms used for \conceptname[type=concept,no idx]{tag}-specific configuration.
6239 % These are available in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} and \keyname[type=macro,no idx]{\cs{chronosset}}.
6240 %
6241 % \DescribeKey{text tags,text tags+,text tags\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory,info}\AfterLastParam
6242 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=text tag,idx post={configuring global defaults}]{text tags} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6243 % \keyname[link,no idx]{text tags,text tags\textquotesingle} replace the current value; \keyname[link,no idx]{text tags+} replaces it.
6244 % \Default{outer sep=0pt,text=\#1!75!black}
6245 %
6246 % The \keylabelname{} are passed a single argument specifying the current \elementlabelname{}'s assigned \conceptname[type=colour,font=\normalfont,idx as=use in keys]{colour}, which may be used in the usual way i.e.~by writing \texttt{\#1} everywhere you would like the \colourlabelname{} to be used.
6247 %
6248 % Note that, when checking if a more fine-grained value is set, \emph{the lists of \meta{key-value} pairs are regarded as a whole.
6249 % They are \emph{not} treated on a \meta{key}-by-\meta{key} basis.}
6250 % So if you write
6251 % \begin{chronoscode}
6252 % \begin{chronos}
6253 % [
6254 % event/text tag={},
6255 % text tags+={fill=green},
6256 % ]
6257 % \end{chronos}
6258 % \end{chronoscode}
6259 % you will \emph{not} get green \conceptname[idx as=text tag,idx post=holistic treatment of configuration]{text tags} for \conceptname[type=tag,idx as=event,idx post=holistic treatment of configuration]{events}.
6260 % Nor will you get the \pkgoptlabelname{} default.
6261 % Instead, no \stylelabelname{} whatsoever will be applied when creating \conceptname[type=tag,idx post=no style]{event} \conceptname[idx as=text tag,idx post=no style]{text tags}.
6262 %
6263 % \DescribeKey{connections,connections+,connections\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6264 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=connection,idx post={configuring global defaults}]{connections} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6265 % \keyname[link,no idx]{connections,connections\textquotesingle} replace the current value; \keyname[link,no idx]{connections+} replaces it.
6266 % \Default{draw=\#1}
6267 %
6268 % These \keyslabelname{} are related to the \conceptname[type=concept,no idx]{tag}-specific \keyname{\meta{tag}/connection,\meta{tag}/connection+,\meta{tag}/connection\textquotesingle} in just the same way as \keyname[no idx]{text tags,text tags+,text tags\textquotesingle} are related to \keyname[no idx]{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}.
6269 % Please see above for details.
6270 %
6271 % \DescribeKey{lines,lines+,lines\textquotesingle}\valmarg{key-value list} \fortags{life,event,period}\AfterLastParam
6272 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=line,idx post={configuring global defaults}]{lines} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6273 % \keyname[link,no idx]{lines,lines\textquotesingle} replace the current value; \keyname[link,no idx]{lines+} replaces it.
6274 % \Default*{}none (see \cref{subsec:add-elements-glconfig} for \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific defaults.)
6275 %
6276 % These \keyslabelname{} are related to the \conceptname[type=concept,no idx]{tag}-specific \keyname{\meta{tag}/line,\meta{tag}/line+,\meta{tag}/line\textquotesingle} in just the same way as \keyname[no idx]{text tags,text tags+,text tags\textquotesingle} are related to \keyname[no idx]{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}.
6277 % Please see above for details.
6278 %
6279 % \DescribeKey{chronos connectors,chronos connectors+,chronos connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6280 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=chronos connector,idx post={configuring global defaults}]{chronos connectors} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6281 % \keyname[no idx,link]{chronos connectors\textquotesingle} replaces the current value; \keyname[no idx,link]{chronos connectors,chronos connectors+} replace it.
6282 % \Default{anchor=center,inner sep=0pt,outer sep=0pt}
6283 %
6284 % These \keyslabelname{} are related to the \conceptname[type=concept,no idx]{tag}-specific \keyname{\meta{tag}/chronos connector,\meta{tag}/chronos connector+,\meta{tag}/chronos connector\textquotesingle} in just the same way as \keyname[no idx]{text tags,text tags+,text tags\textquotesingle} are related to \keyname[no idx]{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}.
6285 % Please see above for details.
6286 %
6287 % \DescribeKey{text tag connectors,text tag connectors+,text tag connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6288 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=text tag connector,idx post={configuring global defaults}]{text tag connectors} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6289 % \keyname[no idx]{text tag connectors\textquotesingle} replaces the current value; \keyname[no idx]{text tag connectors,text tag connectors+} replace it.
6290 % \Default{anchor=center,inner sep=0pt,outer sep=0pt}
6291 %
6292 % These \keyslabelname{} are related to the \conceptname[type=concept,no idx]{tag}-specific \keyname{\meta{tag}/text tag connector,\meta{tag}/text tag connector+,\meta{tag}/text tag connector\textquotesingle} in just the same way as \keyname[no idx]{text tags,text tags+,text tags\textquotesingle} are related to \keyname[no idx]{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}.
6293 % Please see above for details.
6294 %
6295 % \DescribeKey{main text tag connectors,main text tag connectors+,main text tag connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6296 % Set or modify the global default \meta{key-value list} to be applied to \conceptname[idx as=text tag connector,idx post={configuring global defaults}]{main text tag connectors} in the absence of a \conceptname[type=concept,idx as=tag,no idx]{\taglabelname}-specific setting (\cref{subsec:add-elements-glconfig}).
6297 % \keyname[no idx]{main text tag connectors\textquotesingle} replaces the current value; \keyname[no idx]{main text tag connectors,main text tag connectors+} add to it.
6298 % \Default[empty]
6299 %
6300 % These \keyslabelname{} are related to the \conceptname[type=concept,no idx]{tag}-specific \keyname{\meta{tag}/main text tag connector,\meta{tag}/main text tag connector+,\meta{tag}/main text tag connector\textquotesingle} in just the same way as \keyname[no idx]{text tags,text tags+,text tags\textquotesingle} are related to \keyname[no idx]{\meta{tag}/text tag,\meta{tag}/text tag+,\meta{tag}/text tag\textquotesingle}.
6301 % Please see above for details.
6302 %
6303 % The next six sets of \keyslabelname{} are convenience \keyslabelname{} which set or modify the global defaults and the corresponding \keyslabelname{} for all \conceptname[type=concept,idx as=tag,idx post=global defaults for all]{\tagslabelname} at once.
6304 %
6305 % \DescribeKey{every text tags,every text tags+,every text tags\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory,info}\AfterLastParam
6306 % A convenience key equivalent to setting the same \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every text tags}]{text tags,life/text tag,event/text tag,period/text tag,theory/text tag,info/text tag} or the \texttt{+} or \texttt{\textquotesingle} variants.
6307 % \emph{This key should never be used when creating a specific \elementlabelname.}
6308 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6309 %
6310 % \DescribeKey{every connections,every connections+,every connections\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6311 % A convenience key equivalent to setting the same \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every connections}]{connections,life/connection,event/connection,period/connection,theory/connection} or the \texttt{+} or \texttt{\textquotesingle} variants.
6312 % \emph{This key should never be used when creating a specific \elementlabelname.}
6313 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6314 %
6315 % \DescribeKey{every lines,every lines+,every lines\textquotesingle}\valmarg{key-value list} \fortags{life,event,period}\AfterLastParam
6316 % A convenience key equivalent to setting the same \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every lines}]{lines,life/line,event/line,period/line} or the \texttt{+} or \texttt{\textquotesingle} variants.
6317 % \emph{This key should never be used when creating a specific \elementlabelname.}
6318 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6319 %
6320 % \DescribeKey{every chronos connectors,every chronos connectors+,every chronos connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6321 % A convenience key equivalent to setting \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every chronos connectors}]{chronos connectors,life/chronos connector,event/chronos connector,period/chronos connector,theory/chronos connector} or the \texttt{+} or \texttt{\textquotesingle} variants.
6322 % \emph{This key should never be used when creating a specific \elementlabelname.}
6323 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6324 %
6325 % \DescribeKey{every text tag connectors,every text tag connectors+,every text tag connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6326 % A convenience key equivalent to setting the same \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every text tag connectors}]{text tag connectors,life/text tag connector,event/text tag connector,period/text tag connector,theory/text tag connector} or the \texttt{+} or \texttt{\textquotesingle} variants.
6327 % \emph{This key should never be used when creating a specific \elementlabelname.}
6328 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6329 %
6330 % \DescribeKey{every main text tag connectors,every main text tag connectors+,every main text tag connectors\textquotesingle}\valmarg{key-value list} \fortags{life,event,period,theory}\AfterLastParam
6331 % A convenience key equivalent to setting the same \meta{key-value list} for all of \keyname[link,idx post=set by \string\textkey{every main text tag connectors}]{main text tag connectors,life/main text tag connector,event/main text tag connector,period/main text tag connector,theory/main text tag connector} or the \texttt{+} or \texttt{\textquotesingle} variants.
6332 % \emph{This key should never be used when creating a specific \elementlabelname.}
6333 % See \cref{subsec:add-elements-glconfig} and above for details and defaults.
6334 %
6335 % \DescribeKey{every theory circle circle,every theory circle circle\textquotesingle,every theory circle circle+}\valmarg{key-value list} \fortags{theory circle}\AfterLastParam
6336 % Configuration of the base ring for \elementslabelname{} of \conceptname[type=concept,idx post=theory circle,idx font post=\ConceptFont]{tag} type \conceptname[type=tag,idx post=configuring base ring]{theory circle}.
6337 % The ring consists of two circles with the smaller forming a hole in the centre by default.
6338 % Changing or deleting the filling rule will eliminate the hole.
6339 % \Default{fill=\meta{chronos main colour}, draw=\meta{chronos main colour}, even odd rule}
6340 % \keyname[link,no idx]{every theory circle circle,every theory circle circle+} add to the current \meta{key-value list}; \keyname[link,no idx]{every theory circle circle\textquotesingle} replaces it.
6341 %
6342 % \DescribeKey{every theory circle text,every theory circle text\textquotesingle,every theory circle text+}\valmarg{key-value list} \fortags{theory circle}\AfterLastParam
6343 % Style applied to the texts used in constructing \elementslabelname of \conceptname[type=concept,no idx]{tag} type \conceptname[type=tag,no idx]{theory circle}.
6344 % By default the texts are placed along the semicircular paths corresponding to the upper and lower halves of the ring formed by the theory circle circles.
6345 % This means the colour used here should differ from that used to fill the circles, given the default \styleslabelname{}.
6346 % \Default{decoration=\{text effects along path, text=\{\#\#1\}, text effects/.cd, fit text to path, text=chronos@prifliw@cefndir, characters=\{text along path, font=\bs scriptsize\bs scshape\}\}, decorate}
6347 % \keyname[link,no idx]{every theory circle text,every theory circle text+} add to the current \meta{key-value list}; \keyname[link,no idx]{every theory circle text\textquotesingle} replaces it.
6348 %
6349 % \DescribeDimkey{text tag yshift}\val{dimension} \fortags{life,event,period,theory}\AfterLastParam
6350 % The \texttt{yshift} to apply when placing the \keyname[idx as=\meta{tag}/text tag,link prefix=\meta{tag}/]{text tag} if \texttt{yshift} is otherwise \texttt{0pt} and \keyname[idx post=if unset]{at} is unset.
6351 % You should probably never use this key in the context of a particular \elementlabelname{}, because \texttt{yshift} works just as well and will probably be more reliable and certainly faster.
6352 % Moreover, unlike \texttt{yshift}, which can be used to adjust a position set with \keyname[no idx]{at}, \keyname[type=dimkey,no idx]{text tag yshift} cannot.
6353 % If \keyname[no idx]{at} is used, \keyname[type=dimkey,no idx]{text tag yshift} is ignored.
6354 % It makes sense to set this globally if you want all \elementslabelname{} or all \elementslabelname{} belonging to a particular \taglabelname{} to be shifted by some specified distance from the \conceptname[no idx]{timeline}.
6355 % For example,
6356 % \begin{chronoscode}[text,yshift,tag]
6357 % \begin{chronos}[
6358 % life/text tag yshift=10pt,
6359 % event/text tag yshift=30pt,
6360 % period/text tag yshift=50pt,
6361 % theory/text tag yshift=70pt,
6362 % ]
6363 % \end{chronos}
6364 % \end{chronoscode}
6365 %
6366 % \begin{chronos}
6367 % [
6368 % dates=1540:1560,
6369 % life/text tag yshift=10pt,
6370 % event/text tag yshift=30pt,
6371 % period/text tag yshift=50pt,
6372 % theory/text tag yshift=70pt,
6373 % ]
6374 % \chronoslife{name=life,dates=1550:1555}
6375 % \chronosevent{name=event,date=1542}
6376 % \chronosperiod{name=period,dates=1543:1548}
6377 % \chronostheory{name=theory}
6378 % \end{chronos}
6379 %
6380 % The following \keyslabelname{} take the form \arg{every} \meta{tag}, optionally followed by prime or plus.
6381 % \emph{They should not be used to configure \elementslabelname{} for which other global \keyslabelname{} exist, such as \conceptname[conj=or,idx as={colour,connection,connector,date format,line,text tag},idx post=cf.\string\space \string\textkey{every} \string\meta{tag}]{colours,connections,connectors,date formats,lines,text tags}.}
6382 % Generally, these \keyslabelname{} should be unnecessary and are best avoided, although they may occasionally be convenient.
6383 %
6384 % \DescribeKey{every life,every life\textquotesingle,every life+}\valmarg{key-value list} \fortags{life}\AfterLastParam
6385 % Additional configuration for all \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post={configuration, global}]{life}.
6386 % These do much the same as \keyname[no idx]{life/tag,life/tag+,life/tag\textquotesingle}, but should \emph{never} be used when creating a specific \elementlabelname{}.
6387 % \keyname[link,no idx]{every life,every life+} add to the current \meta{key-value list}; \keyname[link,no idx]{every life\textquotesingle} replaces it.
6388 %
6389 % \DescribeKey{every event,every event\textquotesingle,every event+}\valmarg{key-value list} \fortags{event}\AfterLastParam
6390 % Additional configuration for all \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post={configuration, global}]{event}.
6391 % These do much the same as \keyname[no idx]{event/tag,event/tag+,event/tag\textquotesingle}, but should \emph{never} be used when creating a specific \elementlabelname{}.
6392 % \keyname[link,no idx]{every event,every event+} add to the current \meta{key-value list}; \keyname[link,no idx]{every event\textquotesingle} replaces it.
6393 %
6394 % \DescribeKey{every period,every period\textquotesingle,every period+}\valmarg{key-value list} \fortags{period}\AfterLastParam
6395 % Additional configuration for all \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post={configuration, global}]{period}.
6396 % These do much the same as \keyname[no idx]{period/tag,period/tag+,period/tag\textquotesingle}, but should \emph{never} be used when creating a specific \elementlabelname{}.
6397 % \keyname[link,no idx]{every period,every period+} add to the current \meta{key-value list}; \keyname[link,no idx]{every period\textquotesingle} replaces it.
6398 %
6399 % \DescribeKey{every theory,every theory\textquotesingle,every theory+}\valmarg{key-value list} \fortags{theory}\AfterLastParam
6400 % Additional configuration for all \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post={configuration, global}]{theory}.
6401 % These do much the same as \keyname[no idx]{theory/tag,theory/tag+,theory/tag\textquotesingle}, but should \emph{never} be used when creating a specific \elementlabelname{}.
6402 % \keyname[link,no idx]{every theory,every theory+} add to the current \meta{key-value list}; \keyname[link,no idx]{every theory\textquotesingle} replaces it.
6403 %
6404 % \DescribeKey{every info,every info\textquotesingle,every info+}\valmarg{key-value list} \fortags{info}\AfterLastParam
6405 % Additional configuration for all \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post={configuration, global}]{info}.
6406 % These do much the same as \keyname[no idx]{info/tag,info/tag+,info/tag\textquotesingle}, but should \emph{never} be used when creating a specific \elementlabelname{}.
6407 % \keyname[link,no idx]{every info,every info+} add to the current \meta{key-value list}; \keyname[link,no idx]{every info\textquotesingle} replaces it.
6408 %
6409 %^^A END subsec:add-elements-gconfig
6410 %
6411 %^^A END sec:macros-add-elements
6412 %
6413 % \subsection{Adding Connections, Using Colours and Accessing Styles}\label{subsec:add-cysylltiadau}
6414 % \chronosdocidx[type=tag,font=\ConceptFont,idx post={colours,using}]{life,event,period,theory,info}%^^A
6415 % \chronosdocidx[type=tag,font=\ConceptFont,idx post={styles,using}]{life,event,period,theory,info}\vspace{-\baselineskip}
6416 %^^A BEGIN subsec:add-cysylltiadau
6417 %
6418 % To access the \collistlabelname{} used for the \conceptname[no idx]{timeline} etc., see \cref{subsec:lliwiau-basic,subsubsec:timeline-lliwiau}.
6419 % For details of the way \collistlabelname{} are assigned to \elementslabelname{}, see \cref{subsec:lliwiau}.
6420 %
6421 % \Conceptname[type=tag,idx post=as \string\textconcept{connectable} to other \string\textconcept{elements}]{life,event,period,theory} \elementslabelname{} are designed to be connected not only, in the case of those which are connectable, to the \conceptname[no idx]{timeline}, but also to each other.
6422 % To ensure consistent styling, this requires the use of \pkg{chronos} \styleslabelname{} in \TikZ{} commands.
6423 %
6424 % In addition, densely-packed \conceptname[idx as=timeline,idx post={densely packed, non-standard paths}]{timelines} sometimes require non-standard paths be used to connect a minority of \elementslabelname{} to the \conceptname[no idx]{timeline} in an efficient way.
6425 % Again, this requires access to \pkg{chronos} \styleslabelname{}.
6426 %
6427 % \DescribeStyle{chronos connect}\cvalsmarg{tag,\elementlabelname{} name} \fortags{life,event,period,theory}\AfterLastParam
6428 % This sets the \stylelabelname{} used for \conceptsname[link,idx post={style, using directly}]{connection} belonging to \elementslabelname{} of type \meta{tag} with the \conceptname[type=colour,font=\normalfont,idx as=use in \string\texttt{chronos connect}]{colour} assigned to \meta{\elementlabelname{} name} (\cref{subsec:lliwiau}).
6429 % For example,
6430 % \begin{codlatex}[chronos,connect]
6431 % \draw [chronos connect=life:johannes gutenberg] (connector johannes gutenberg) -- (connector printing press) (connector johannes gutenberg2) -|- (connector movable type) (connector johannes gutenberg3) -- ++(5pt,0pt) |-| (connector gutenberg bible);
6432 % \end{codlatex}
6433 %
6434 % This will draw a line using the \stylelabelname{} for \conceptsname[idx post=adding with \string\textkey{chronos connect} for \string\textkey{johannes gutenberg}\string\idxeg,link]{connection} of \conceptname[type=concept,no idx,link]{tag} type \conceptname[type=tag,no idx,link]{life} and the \conceptname[type=colour,idx as=assigned to \string\textkey{johannes gutenberg},symbol=eg,font=\normalfont]{colour} assigned to the \elementlabelname{} named \keyname[type=element,no link,symbol=eg]{johannes gutenberg}.
6435 % Note the use of \conceptsname[idx as=text tag connector,idx post=johannes gutenberg\string\idxeg,idx font post=\KeyFont]{connector} on both the \elementlabelname{}'s own \conceptname[link,link to=\meta{tag}/text tag,idx as=\meta{tag}/text tag,idx post=chronos connect,idx font post=\KeyFont]{text tag} and on other \elementslabelname{}' \conceptsname[idx as=text tag,no idx,link,link to=\meta{tag}/text tag]{text tag}.
6436 % In this case, \keyname[type=element,idx pre=text tag,idx font pre=\ConceptFont,symbol=eg,no link]{tag johannes gutenberg} is being \conceptname[idx as=connection,idx post=between \string\textkey{johannes gutenberg} and other \string\textconcept{elements}\string\idxeg]{connected} to \keyname[type=element,idx pre=text tag,idx font pre=\ConceptFont,symbol=eg,no link]{tag printing press}, \keyname[type=element,idx pre=text tag,idx font pre=\ConceptFont,symbol=eg,no link]{tag movable type} and \keyname[type=element,idx pre=text tag,idx font pre=\ConceptFont,symbol=eg,no link]{tag gutenberg bible}.
6437 %
6438 % The following four \keyslabelname{} provide analogous access to the \styleslabelname{} and \collistlabelname{} used for \conceptsname[link,no idx]{chronos connector,text tag connector,line,text tag} and are used in the same way.
6439 %
6440 % \DescribeStyle{chronos create chronos connector}\cvalsmarg{tag,\elementlabelname{} name} \fortags{life,event,period}\AfterLastParam
6441 % This sets the \stylelabelname{} used for \conceptsname[idx as=chronos connector,link,idx post={style, using directly}]{chronos connector} belonging to \elementslabelname{} of type \meta{tag} with the \conceptname[type=colour,font=\normalfont,idx as=use in \string\texttt{chronos create chronos connector}]{colour} assigned to \meta{\elementlabelname{} name}.
6442 %
6443 % \DescribeStyle{chronos create text tag connector}\cvalsmarg{tag,\elementlabelname{} name} \fortags{life,event,period,theory}\AfterLastParam
6444 % This sets the \stylelabelname{} used for \conceptsname[idx as=text tag connector,link,idx post={style, using directly}]{text tag connector} belonging to \elementslabelname{} of type \meta{tag} with the \conceptname[type=colour,font=\normalfont,idx as=use in \string\texttt{chronos create text tag connector}]{colour} assigned to \meta{\elementlabelname{} name}.
6445 %
6446 % \DescribeStyle{chronos mark line}\cvalsmarg{tag,\elementlabelname{} name} \fortags{life,event,period}\AfterLastParam
6447 % This sets the \stylelabelname{} used for \conceptsname[idx as=line,link,idx post={style, using directly}]{line} (on or near the \conceptname[no idx]{timeline}) belonging to \elementslabelname{} of type \meta{tag} with the \conceptname[type=colour,font=\normalfont,idx as=use in \string\texttt{chronos mark line}]{colour} assigned to \meta{\elementlabelname{} name}.
6448 %
6449 % \DescribeStyle{chronos text tag}\cvalsmarg{tag,\elementlabelname{} name} \fortags{life,event,period,theory,info}\AfterLastParam
6450 % This sets the \stylelabelname{} used for \conceptsname[idx as=text tag,link,idx post={style, using directly}]{text tag} belonging to \elementslabelname{} of type \meta{tag} with the \conceptname[type=colour,font=\normalfont,idx as=use in \string\texttt{chronos text tag}]{colour} assigned to \meta{\elementlabelname{} name}.
6451 %
6452 % We can also use the \conceptname[type=colour,font=\normalfont,idx as={using directly}]{colour} assigned to \texttt{johannes gutenberg} directly.
6453 % Perhaps, for example, we'd like to put a book symbol near this \elementlabelname{} in the appropriate \conceptname[type=colour,no idx]{colour}.
6454 % \Example{\cs{node} [colour johannes gutenberg, above left=5pt and 10pt of tag johannes gutenberg.north west, anchor=south east, inner sep=0pt] \{\meta{book-symbol}\};}
6455 %
6456 %^^A END subsec:add-cysylltiadau
6457 %
6458 % \section{Drawing on Chronos Layers}\label{sec:haenau-llunio}
6459 %^^A BEGIN sec:haenau-llunio
6460 %
6461 % See \cref{subsec:haenau}.
6462 %
6463 % \DescribeStyle{on chronos background layer}Apply to a \keyname[env,no link]{scope} to draw everything inside on \layerlabelname{} \keyname[type=layer]{chronos background}.\AfterLastParam
6464 % \begin{chronoscode}[on,chronos,layer,background]
6465 % \begin{scope}[on chronos background layer]
6466 % \node {Something};% in between the regular background and chronos middle ground
6467 % \end{scope}
6468 % \end{chronoscode}
6469 %
6470 % \DescribeStyle{on chronos middle ground layer}Apply to a \keyname[env,no link,no idx]{scope} to draw everything inside on \layerlabelname{} \keyname[type=layer]{chronos middle ground}.\AfterLastParam
6471 % \begin{chronoscode}[on,chronos,layer,middle,ground]
6472 % \begin{scope}[on chronos middle ground layer]
6473 % \node {Something};% behind the main layer and chronos background
6474 % \end{scope}
6475 % \end{chronoscode}
6476 %
6477 % \DescribeStyle{on chronos foreground layer}Apply to a \keyname[env,no link,no idx]{scope} to draw everything inside on \layerlabelname{} \keyname[type=layer]{chronos foreground}.\AfterLastParam
6478 % \begin{chronoscode}[on,chronos,layer,foreground]
6479 % \begin{scope}[on chronos foreground layer]
6480 % \node {Something};% above the main layer but behind chronos overlay.
6481 % \end{scope}
6482 % \end{chronoscode}
6483 %
6484 % \DescribeStyle{on chronos overlay layer}Apply to a \keyname[env,no link,no idx]{scope} to draw everything inside on \layerlabelname{} \keyname[type=layer]{chronos overlay}.\AfterLastParam
6485 % By default, \pkg{chronos} puts only debugging information on \keyname[type=layer]{chronos overlay}, which means drawing on this layer should always draw on top of anything constructed by the package code.
6486 % \begin{chronoscode}[on,chronos,layer,overlay]
6487 % \begin{scope}[on chronos overlay layer]
6488 % \node {Something over everything else.};
6489 % \end{scope}
6490 % \end{chronoscode}
6491 %
6492 % In addition, \pkg{chronos} never puts anything on the non-chronos \pgf{}/\TikZ{} \keyname[type=layer,no link]{background} layer and it would be difficult to persuade it to do so without rewriting internal code.
6493 % Drawing on \emph{this} layer, therefore, is almost guaranteed to end up behind everything constructed by the package code\footnote{Unless nefarious \TeX{}nicians have interfered with your installation.
6494 % It is even quite unlikely a bug would cause this kind of problem, though bugs will doubtless cause many others.}.
6495 % \begin{chronoscode}[on,layer,background]
6496 % \begin{scope}[on background layer]% fill area below the timeline
6497 % \fill [blue!25!white] (chronos pre |- chronos bottom) rectangle (chronos post-foot);
6498 % \end{scope}
6499 % \end{chronoscode}
6500 %
6501 %^^A END sec:haenau-llunio
6502 %
6503 % \section{Externalising Chronos Timelines with Memoize}\label{sec:external-memoize}
6504 %^^A BEGIN sec:external-memoize
6505 %
6506 % As explained in \cref{sec:compat}, \keyname[type=env,idx post=cannot be externalised with \string\pkg{external}]{chronos} \conceptsname[no idx]{timeline} cannot be externalised with \pgf/\TikZ's \pkgname[type=lib,idx post=incompatibility]{external}.
6507 % Since \pgf/\TikZ{}, in general, and \pkg{chronos}, in particular, can be rather slow to compile, this is serious issue.
6508 % If you only have a two or three small \conceptsname[no idx]{timeline}, the compilation time will be negligible.
6509 % But if you have a large, densely packed \conceptname[no idx]{timeline} or many \conceptsname[no idx]{timeline}, compilation time will quickly become excessive.
6510 %
6511 % Fortunately, \keyname[type=env,idx post=externalisation with \string\pkg{memoize}]{chronos} \envslabelname{} \emph{can} be externalised.
6512 % Moreover, they can be externalised more conveniently, more robustly and more securely, without the need for a separate compilation for each \keyname[type=env,no idx]{chronos}.
6513 % This means compilation is only a little slower when the \conceptsname[no idx]{timeline} are being compiled (whereas compilation would be far slower with the \pkg{external} \liblabelname, even if it worked) and subsequent compilations are fast.
6514 %
6515 % Sašo Živanović's \pkgname{memoize} has no trouble compiling this documentation and externalising its \conceptsname[no idx]{timeline}.
6516 % \Pkgname[no idx]{memoize} is a little more trouble to set up initially than the \pkgname[type=lib,no link,idx post=cf.~\string\pkg{memoize}]{external} \liblabelname{}, but requires far less fine-tuning once configured.
6517 %
6518 % \emph{\bfseries To externalise \pkg{chronos} \conceptsname[no idx]{timeline}, you must first setup memoization as explained in \pkg{memoize}'s documentation\footnote{%^^A
6519 % By default, \pkg{memoize} uses \keyname[type=prog,no link]{perl} and requires the installation of a couple of libraries.
6520 % If you use Linux or have \keyname[type=prog,no link]{python} already installed, I'd recommend using this method as it requires only a single extra library, is faster and more robust.
6521 % If you do not wish to use either \keyname[conj=or,type=prog,no idx,no link]{perl,python}, you can use \TeX{}, but I have not personally tested this method as it is slower and less secure.}.}
6522 %
6523 % \Pkgname[idx post=memoize\string\textnormal{-ready},idx font post=\PkgFont]{chronos} supports automemoization out-of-the-box\footnote{%^^A
6524 % This fantastic feat was accomplished by copying a line of code from \pkg{memoize}'s manual and substituting \texttt{chronos} for the appropriate word.
6525 % Even I managed to achieve this without major incident.}: to enable automatic memoization of \keyname[type=env,idx post=enable automemoization]{chronos} \envslabelname{}, simply load \pkg{memoize} early in your preamble.
6526 % \Pkgname[no idx]{chronos} will then enable ‘automemoization’ for all \conceptsname[no idx]{timeline}\footnote{%^^A
6527 % Of course, memoization can be disabled permanently or temporarily for some or all \conceptsname[no idx]{timeline}.
6528 % See \pkg{memoize}'s documentation for details or look at the code for this document, which disables memoization for \cref{fig:chronos-dev} to prevent destruction of hyperlinks.}.
6529 %
6530 % All \chronosstyleslabelname{} (except default) and all \colschemeslabelname{} (except \keyname[type=colscheme,no link,idx post={modification will not cause \string\pkg{memoize} recompilation}]{default}) are defined so that modification will automatically trigger the recompilation of all \pkg{chronos} \conceptsname[link,no idx]{timeline} which use them.
6531 %
6532 %^^A END sec:external-memoize
6533 %
6534 % \section{Deferring Code}\label{sec:defer}
6535 %^^A BEGIN sec:defer
6536 %
6537 % \emph{If you don't know why you might want to use the \keyslabelname{} in this \namecref{sec:defer}, you don't need to use them.}
6538 %
6539 % \DescribeKey{timeline config,timeline config\textquotesingle,timeline config+}\valmarg{code}\AfterLastParam
6540 % Execute additional \meta{code} after \pkg{chronos} has processed the \keyslabelname{} at the start of the \enviro{chronos} environment, but before further processing the resulting configuration and constructing the \conceptname[idx post=additional configuration]{timeline}.
6541 % These \keyslabelname{} are provided primarily for use in \chronosstylelabelname{} definitions, but may occasionally be useful elsewhere.
6542 % \keyname{timeline config,timeline config+} add to the current code; \keyname{timeline config\textquotesingle} replaces it.
6543 % Note that \keyname[idx post=destructiveness]{timeline config\textquotesingle} is destructive: it obliterates any existing code \pkg{chronos} has installed, which may be entirely unrelated to the code now being stored.
6544 % \Conceptname[type=concept,idx post=authors should never use \string\textkey{timeline config\string\textquotesingle}]{chronos style} authors should never use this form.
6545 % Even if the code is for purely private use in a locked room with no internet access, you should stick to the additive forms unless your memory is infallible \emph{and} you always remember to use it.
6546 %
6547 %^^A END sec:defer
6548 %
6549 % \subsection{Additional \TikZ{}}\label{subsec:add-tikz}
6550 %^^A BEGIN subsec:add-tikz
6551 %
6552 % Generally, you can mix arbitrary \TikZ{} code freely into the body of the \keyname[no idx,type=env]{\enviro{chronos}} environment.
6553 % For example, this is how to add \conceptname[idx as=connection,idx post=adding between \string\textconcept{text tags}]{connections} between \conceptname[idx as=\meta{tag}/text tag,no idx]{text tags} or to decorate your \conceptname[no idx]{timeline} with symbols or ornaments.
6554 %
6555 % However, sometimes you might want to add something \emph{after} \keyname[no idx,type=env]{\enviro{chronos}} has finished.
6556 % You might, for example, want to do something after the \conceptname[no idx,link,link to=main/frame]{frame} is drawn or place something relative to \conceptname[conj=or,no idx]{headings,subheadings}
6557 % Two sets of \keyslabelname{} are provided for this purpose.
6558 % One set enable you to execute arbitrary \TikZ{} code within the picture's bounding box; the other enables you to do so outside.
6559 % Generally, it is the first set you will want to use; the second are useful in a narrower range of cases and for debugging purposes.
6560 %
6561 % \DescribeKey{chronos tikz\textquotesingle,chronos tikz,chronos tikz+}\valmarg{\TikZ{} commands}\AfterLastParam
6562 % Commands to execute after the \conceptname[no idx,link,type=concept]{\meta{timeline additions specification}} and any \conceptname[idx post=adding code after]{frame,headings,subheadings} are drawn, but before debugging information is added (see \cref{sec:dadfygio}).
6563 % \keyname[link,no idx]{chronos tikz,chronos tikz+} add to current material; \keyname[link,no idx]{chronos tikz\textquotesingle} replaces it.
6564 % Material added with these \keyslabelname{} is included in the final picture's bounding box.
6565 % If you draw outside the \conceptname[no idx,link,link to=main/frame]{frame} and \conceptname[idx pre=chronos tikz,idx font pre=\KeyFont,symbol=eg]{outer border}, for example, the final bounding box expands to accommodate it.
6566 % \emph{If you aren't sure which set of \keyslabelname{} to use, choose these.}
6567 %
6568 % \DescribeKey{chronos tikz outside bb\textquotesingle,chronos tikz outside bb,chronos tikz outside bb+}\valmarg{\TikZ{} commands}\AfterLastParam
6569 % Commands to execute after the \conceptname[no idx,link,type=concept]{\meta{timeline additions specification}} and any \conceptname[idx post=adding code after outside bounding box]{frame,headings,subheadings} are drawn, but before debugging information is added (see \cref{sec:dadfygio}).
6570 % \keyname[link,no idx]{chronos tikz outside bb,chronos tikz outside bb+} add to current material; \keyname[link,no idx]{chronos tikz outside bb\textquotesingle} replaces it.
6571 % Material added with these \keyslabelname{} is excluded when the final picture's bounding box is determined.
6572 % If you draw outside the \conceptname[no idx,link,link to=main/frame]{frame} and \conceptname[idx pre=chronos tikz outside bb,idx font pre=\KeyFont,symbol=eg]{outer border}, for example, \TeX{} will treat it as if it didn't exist and you will need to ensure adequate space is available to accommodate it manually.
6573 % \emph{If you aren't sure which set of \keyslabelname{} to use, avoid these.}
6574 %
6575 % Finally, you might want to add material at some specific point in the construction of the picture (e.g.~after \conceptsname[link,no idx]{heading} but before the \conceptname[link,no idx]{frame}).
6576 % The following sets of \keyslabelname{} facilitate such additions.
6577 %
6578 % \DescribeKey{before headings\textquotesingle,before headings,before headings+}\valmarg{\TikZ{} commands}\AfterLastParam
6579 % Commands to execute after the \conceptname[no idx,link,type=concept]{\meta{timeline additions specification}}, but before constructing any \conceptname[idx post=adding code before]{headings}.
6580 % \keyname[link,no idx]{before headings,before headings+} add to current material; \keyname[link,no idx]{before headings\textquotesingle} replaces it.
6581 %
6582 % \DescribeKey{before drawing frame\textquotesingle,before drawing frame,before drawing frame+}\valmarg{\TikZ{} commands}\AfterLastParam
6583 % Commands to execute after the \conceptname[no idx,link,type=concept]{\meta{timeline additions specification}} and any \conceptname[idx post=adding code after]{headings,subheadings} are drawn, but before constructing any \conceptname[idx post=adding code before]{frame}.
6584 % \keyname[link,no idx]{before drawing frame,before drawing frame+} add to current material; \keyname[link,no idx]{before drawing frame\textquotesingle} replaces it.
6585 %
6586 %
6587 %^^A END subsec:add-tikz
6588 %
6589 % \section{Custom Schemes and Styles}\label{sec:scheme-style-creation}
6590 %^^A BEGIN sec:scheme-style-creation
6591 %
6592 % The \macroslabelname{} and \keyslabelname{} explained in this \namecref{sec:scheme-style-creation} enable you to define custom \conceptname[type=colscheme,idx as=defining custom,font=\normalfont]{colour schemes} and \conceptname[type=chronosstyle,idx as=defining custom,font=\normalfont]{chronos styles}.
6593 % These may then be used in the same way as those provided by \pkg{chronos} (\cref{sec:schemes-styles}).
6594 %
6595 % \textbf{\emph{Customisation is a two-stage process.
6596 % \Chronosstyleslabelname{} should not define colours definable by \colschemeslabelname{}.}}
6597 %
6598 % \Colschemeslabelname{} are straightforward to define; \chronosstyleslabelname{} are a bit trickier.
6599 %
6600 % \subsection{Defining Chronos Colour Schemes}\label{subsec:chronos-scheme-creation}\chronosdochypertargets{concept}{}{chronos colour scheme}
6601 %^^A BEGIN subsec:chronos-scheme-creation
6602 %
6603 % As explained in \cref{subsec:chronos-schemes}, in addition to the default colours, \pkg{chronos} currently provides \keyname[type=colscheme,idx post=as instance of custom\string\idxeg]{blues,contninety,cronoleg,lavender,modern,offlinebasic,offlinealt,sobriety,xcolseries}\footnote{%^^A
6604 % Note that \keyname[no link,no idx]{xcolseries} uses the \texttt{hsb} colour model, which is not supported by \pgf/\TikZ{}.
6605 % If loading this set of colours directly, add \texttt{/utils/exec={\selectcolormodel{rgb}}} to \enviro{chronos}'s optional argument.
6606 % This is not necessary if loading a \conceptname[no idx,link,type=concept]{chronos style} which utilises \texttt{xcolseries}.%
6607 % In either case, all colours in the current \enviro{chronos} \envlabelname{} will be converted to \texttt{rgb}.%^^A
6608 % } (\cref{tab:colschemes}).
6609 % \keyname[type=colscheme,idx post=use of colour series]{xcolseries} demonstrates the use of \pkg{xcolor} colour series in \pkg{chronos} \collistslabelname{}.
6610 % \keyname[type=colscheme,idx post=as example of minimal modification to support \string\textsf{chronos styles}]{contninety,modern,offlinebasic,offlinealt} illustrate the use of \colschemeslabelname{} to support \chronosstyleslabelname{} which require minimal modifications of other \colschemeslabelname{}.
6611 %
6612 % New \colschemeslabelname{} should follow the examples in \pkg{chronos-lib-colschemes.sty}\footnote{%^^A
6613 % For historical reasons, \keyname[type=colscheme,idx post=implementation internal]{cronoleg} is non-standardly defined as it was the default scheme during most \pkg{chronos} development.
6614 % The current implementation of this scheme is officially internal.
6615 % The implementation --- as opposed to the scheme --- is highly likely to change in backwards-incompatible ways without notice.
6616 % This warning does not apply to \emph{usage} of the \colschemelabelname{}, but you should not take it as a model for a new scheme, except to pass it as an option to \keyname[type=macro]{\cs{chronosnewcolourscheme}}.}.
6617 % For instance, here's the code to set up \keyname[type=colscheme,idx post=definition]{blues}:
6618 % \begin{chronoscode}
6619 % \chronosnewcolourscheme{blues}{% chronos-lib-colschemes.sty
6620 % timeline foreground=DodgerBlue4,
6621 % timeline background=DodgerBlue2,
6622 % default below={Cerulean!50!DodgerBlue4,Cerulean!50!DodgerBlue3,Cerulean!50!DodgerBlue2,Cerulean!50!DodgerBlue1,Cerulean},
6623 % default above={Cerulean!50!DodgerBlue4,Cerulean!50!DodgerBlue3,Cerulean!50!DodgerBlue2,Cerulean!50!DodgerBlue1,Cerulean},
6624 % foreground=DodgerBlue4,
6625 % background=white,
6626 % }
6627 % \end{chronoscode}
6628 % This is intended for ‘off line’ \conceptname[idx as=timeline,idx post={absence of \string\textconcept{borders} in off-line}]{timelines} so it doesn't include colours for a \conceptname{timeline border}, though \pkg{chronos} will derive such colours anyway, as explained below.
6629 %
6630 % There are two pitfalls in defining a \colschemelabelname{}.
6631 % First, definitions cannot utilise other \pkg{chronos} colours at this stage.
6632 % You cannot, therefore, define the middle border colour, for example, in terms of the outer and inner colours.
6633 %
6634 % Second, scheme names must consist of letters only as they are used to create new \macroslabelname{}.
6635 %
6636 % \DescribeMacro{\chronosnewcolourscheme}\oarg{existing scheme}\marg{name}\marg{key-value list}\AfterLastParam
6637 % \DescribeMacro{\chronosnewcolorscheme}\oarg{existing scheme}\marg{name}\marg{key-value list}\AfterLastParam
6638 % If \meta{existing scheme} is specified, it should be the name of an existing \colschemelabelname{}; otherwise, a default set of colours is loaded.
6639 % \meta{name} is the name of the new \colschemelabelname{} and must be a unique string of alphabetic characters suitable for use in a \macrolabelname{} name.
6640 % \meta{key-value list} is a list of key-value pairs from the list in \cref{tab:colscheme}.
6641 % \begin{table}
6642 % \begin{adjustwidth}{-\tewadjust}{0pt}
6643 % \centering
6644 % \caption{Keys for \cs{chronosnewcolourscheme}.
6645 % Note that neither ‘colour’ nor ‘color’ appears in any \keylabelname{}.}\label{tab:colscheme}
6646 % \chronosdocidx[type=colscheme,font=\normalfont,idx post={options (summary)}]{creating}
6647 % \begin{tabularx}\linewidth{>{\ttfamily}ll>{\ttfamily\raggedright\arraybackslash}X}
6648 % \toprule
6649 % \sffamily Key & \sffamily Expected Argument Type & \sffamily Example \\\midrule
6650 % \hypertarget{colschemekey:foreground}{foreground} & \meta{colour name} & chronosblack \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@prifliw}{#1}} %^^A chronos main colour &
6651 % \hypertarget{colschemekey:background}{background} & \meta{colour name} & chronoswhite \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@prifliw@cefndir}{#1}} %^^A chronos main background colour &
6652 % \hypertarget{colschemekey:timeline-foreground}{timeline foreground} & \meta{colour name} & chronosCerulean \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@lliw@llinell}{#1}} %^^A chronos timeline foreground colour &
6653 % \hypertarget{colschemekey:timeline-background}{timeline background} & \meta{colour name} & chronosDodgerBlue4!50!chronosblack \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@lliw@cefndir@llinell}{#1}} %^^A chronos timeline background colour &
6654 % \hypertarget{colschemekey:timeline-border-outer}{timeline border outer} & \meta{colour name} & chronoswhite \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@borderouter}{#1}} %^^A timeline border outer colour &
6655 % \hypertarget{colschemekey:timeline-border-inner}{timeline border inner} & \meta{colour name} & chronosCerulean \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@borderinner}{#1}} %^^A timeline border inner colour &
6656 % \hypertarget{colschemekey:timeline-border-middle}{timeline border middle} & \meta{colour name} & chronosDodgerBlue4!50!chronosblack \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@bordermiddle}{#1}} %^^A timeline border middle colour &
6657 % \cmidrule(lr){1-3}
6658 % \hypertarget{colschemekey:life/default}{life/default} & \meta{colour name} & chronosDodgerBlue4 \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@byw@lliw@rhagosodedig}{#1}} %^^A life/default colour &
6659 % \hypertarget{colschemekey:event/default}{event/default} & \meta{colour name} & chronosDodgerBlue4 \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@digwyddiad@lliw@rhagosodedig}{#1}} %^^A event/default colour &
6660 % \hypertarget{colschemekey:period/default}{period/default} & \meta{colour name} & chronosDodgerBlue4 \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@parhad@lliw@rhagosodedig}{#1}} %^^A period/default colour &
6661 % \hypertarget{colschemekey:theory/default}{theory/default} & \meta{colour name} & chronosDodgerBlue4 \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@theori@lliw@rhagosodedig}{#1}} %^^A theory/default colour &
6662 % \hypertarget{colschemekey:info/default}{info/default} & \meta{colour name} & chronosDodgerBlue4 \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@gwybodaeth@lliw@rhagosodedig}{#1}} %^^A info/default colour &
6663 % \cmidrule(lr){1-3}
6664 % \hypertarget{colschemekey:default-above}{default above} & \meta{list of colour names} & chronosRed, chronosOrange, chronosYellow, chronosGreen, chronosBlue, chronosMidnightBlue, chronosViolet \\ %^^A \g__chronos_lliwiau_uchod_clist %^^A colours above &
6665 % \hypertarget{colschemekey:default-below}{default below} & \meta{list of colour names} & chronosCerulean!50!chronosDodgerBlue4, chronosCerulean!50!chronosDodgerBlue3, chronosCerulean!50!chronosDodgerBlue2, chronosCerulean!50!chronosDodgerBlue1, chronosCerulean \\ %^^A \g__chronos_lliwiau_isod_clist %^^A colours below &
6666 % \hypertarget{colschemekey:life/above}{life/above} & \meta{list of colour names} & chronosDeepPink2, chronosDarkOrange1, chronosFirebrick1, chronosPurple0, chronosWildStrawberry, chronosOrangeRed1, chronosDarkGoldenrod1, chronosDarkOrchid3 \\ %^^A \g__chronos_lliwiau_byw_uchod_clist %^^A life/colours above &
6667 % \hypertarget{colschemekey:life/below}{life/below} & \meta{list of colour names} & chronosDodgerBlue3, chronosGreen3, chronosBlue3, chronosSpringGreen4, chronosDeepSkyBlue2, chronosForestGreen, chronosPeriwinkle, chronosSeaGreen3 \\ %^^A \g__chronos_lliwiau_byw_isod_clist %^^A life/colours below &
6668 % \hypertarget{colschemekey:event/above}{event/above} & \meta{list of colour names} & chronosThistle4, chronosThistle4!.5!chronosThistle3, chronosThistle3, chronosThistle3!.5!chronosThistle2, chronosThistle2 \\ %^^A \g__chronos_lliwiau_digwyddiad_uchod_clist %^^A event/colours above &
6669 % \hypertarget{colschemekey:event/below}{event/below} & \meta{list of colour names} & chronosSeashell4, chronosSeashell4!.5!chronosSeashell3, chronosSeashell3, chronosSeashell3!.5!chronosSeashell2, chronosSeashell2 \\ %^^A \g__chronos_lliwiau_digwyddiad_isod_clist %^^A event/colours below &
6670 % \hypertarget{colschemekey:period/above}{period/above} & \meta{list of colour names} & chronosMistyRose4, chronosMistyRose4!.5!chronosMistyRose3, chronosMistyRose3, chronosMistyRose3!.5!chronosMistyRose2, chronosMistyRose2 \\ %^^A \g__chronos_lliwiau_parhad_uchod_clist %^^A period/colours above &
6671 % \hypertarget{colschemekey:period/below}{period/below} & \meta{list of colour names} & chronosIvory4, chronosIvory4!.5!chronosIvory3, chronosIvory3, chronosIvory3!.5!chronosIvory2, chronosIvory2 \\ %^^A \g__chronos_lliwiau_parhad_isod_clist %^^A period/colours below &
6672 % \hypertarget{colschemekey:theory/above}{theory/above} & \meta{list of colour names} & xcolor s2!![0],xcolor s2!![1],xcolor s2!![2],xcolor s2!![3],xcolor s2!![4],xcolor s2!![5],xcolor s2!![6],xcolor s2!![7],xcolor s2!![8],xcolor s2!![9],xcolor s2!![10],xcolor s2!![11], xcolor s2!![12],xcolor s2!![13],xcolor s2!![14],xcolor s2!![15] \\ %^^A \g__xcolor_lliwiau_theori_uchod_clist %^^A theory/colours above &
6673 % \hypertarget{colschemekey:theory/below}{theory/below} & \meta{list of colour names} & xcolor g2!![0],xcolor g2!![1],xcolor g2!![2],xcolor g2!![3],xcolor g2!![4],xcolor g2!![5],xcolor g2!![6],xcolor g2!![7],xcolor g2!![8],xcolor g2!![9],xcolor g2!![10],xcolor g2!![11],xcolor g2!![12],xcolor g2!![13],xcolor g2!![14],xcolor g2!![15] \\ %^^A \g__xcolor_lliwiau_theori_isod_clist %^^A theory/colours below &
6674 % \bottomrule
6675 % \end{tabularx}
6676 % \end{adjustwidth}
6677 % \end{table}
6678 %
6679 % Schemes need not use all \keyslabelname{}\footnote{%^^A
6680 % In fact, they need not use any, though a \colschemelabelname{} which uses none would serve no purpose.}.
6681 % It is sufficient to specify the required deviations from \meta{existing scheme}.
6682 % For example, here's the code to set up \keyname[type=colscheme,idx post=sufficient to define deviations from \string\meta{existing scheme}]{offlinealt},
6683 % \begin{chronoscode}
6684 % \chronosnewcolourscheme[cronoleg]{offlinealt}{%
6685 % timeline foreground=blue!40,
6686 % }
6687 % \end{chronoscode}
6688 %
6689 % \subsubsection{How Colour Schemes are Processed}\label{subsubsec:colscheme-process}
6690 %^^A BEGIN subsubsec:colscheme-process
6691 %
6692 % When a \colschemelabelname{} is loaded, \pkg{chronos} processes the settings in six stages.
6693 % \begin{enumerate}
6694 % \item The specified \meta{existing scheme} or defaults are loaded.
6695 % \item \Keyslabelname{} for the ‘core’ \colourslabelname{} \keyname[type=colschemekey,idx pre=processing]{foreground,background} are set and flipped to provide default settings for the ‘core derivative’ \colourslabelname{} \keyname[type=colschemekey,idx post=colour derivation]{timeline foreground,timeline background}.
6696 % \item \Keyslabelname{} for the ‘core derivative’ \colourslabelname{} \keyname[type=colschemekey,idx pre=processing]{timeline foreground,timeline background} are set and the resulting four \colourslabelname{} used to derive default settings for the ‘core border’ \colourslabelname{} \keyname[type=colschemekey,idx post=colour derivation]{timeline border inner,timeline border middle,timeline border outer}.
6697 % In particular, \keyname[type=colschemekey,no idx]{timeline border inner} is set to match \keyname[type=colschemekey,no idx]{timeline background}, \keyname[type=colschemekey,no idx]{timeline border outer} is set to \keyname[type=colschemekey,no idx]{background} and \keyname[type=colschemekey,no idx]{timeline border middle} is set to a 50-50 mix of the two.
6698 % \item \Keyslabelname{} for the ‘core border’ \colourslabelname{} \keyname[type=colschemekey,idx pre=processing]{timeline border inner,timeline border middle,timeline border outer} are set.
6699 % The main \keyname[type=colschemekey,no idx]{foreground} \colourlabelname{} is assigned to the ‘elemental’ default \colourslabelname{} \keyname[type=colschemekey,idx post=colour derivation]{life/default,event/default,period/default,theory/default,info/default}.
6700 % \item \Keyslabelname{} for the ‘elemental’ default \colourslabelname{} \keyname[type=colschemekey,idx pre=processing]{life/default,event/default,period/default,theory/default} are set.
6701 % \item \emph{Much later}, after the user configuration for the \enviro{chronos} \envlabelname{} has been read, \pkg{chronos} potentially flips the ‘core derivative’ \colourslabelname{} \keyname[type=colschemekey,idx pre=processing (delayed)]{timeline foreground,timeline background}.
6702 % See \cref{subsec:chronos-style-creation}.
6703 % \end{enumerate}
6704 %
6705 % Only after this sixth stage are the ‘public’ names listed in \cref{tab:colnames} assigned to the final set of \colschemelabelname{}-definable \colourslabelname{}.
6706 %
6707 %^^A END subsubsec:colscheme-process
6708 %
6709 %
6710 %^^A END subsec:chronos-scheme-creation
6711 %
6712 % \subsection{Defining Chronos Styles}\label{subsec:chronos-style-creation}\chronosdochypertargets{concept}{}{chronos style}
6713 %^^A BEGIN subsec:chronos-style-creation
6714 %
6715 % The current method for creating \conceptsname[type=chronosstyle,idx as=defining custom,font=\normalfont]{chronos style} is straightforward in theory, but potentially hazardous in practice.
6716 % Here's an example from \pkg{chronos-lib-styles.sty}.
6717 % \begin{chronoscode}
6718 % \pgfqkeys{/chronos}{%
6719 % blues below/.style={%
6720 % /chronos/.cd,
6721 % blues below/.meaning to context,
6722 % colour scheme=blues,
6723 % rotate all colours,
6724 % timeline={%
6725 % timeline years=above,
6726 % timeline marks,
6727 % timeline minor marks,
6728 % step minor year=50,
6729 % step divisions=10,
6730 % step major year=100,
6731 % dates=1550:2050,
6732 % timeline height'=3pt,
6733 % timeline line={chronos timeline foreground colour,double=chronos timeline background colour,line width=\timelineht/3,double distance=\timelineht/3},
6734 % timeline arrow,
6735 % conditional timeline arrow={%
6736 % timeline/timeline line+={Bar-Latex,shorten <=-\timelineht/3,shorten >=-3pt-2.1\timelineht},
6737 % timeline/timeline width-={3pt+2.43\timelineht},
6738 % before headings+={\path (chronos post) -- ++(3pt+2.1\timelineht,0pt) (chronos pre) -- ++(-\timelineht/3,0pt);},
6739 % }{},
6740 % timeline mark={chronos timeline foreground colour,line width=.6pt,shorten >=-4pt},
6741 % timeline minor mark={chronos timeline foreground colour,line width=.5pt,shorten >=-3.5pt},
6742 % timeline bare mark={chronos timeline foreground colour,line width=.3pt,shorten >=-2.5pt},
6743 % timeline year={fill=none,text=chronos timeline foreground colour,rotate around={45:(chronos year \chronosyeari |- chronos top)}},
6744 % major step font=\sffamily\footnotesize\tlstyle,
6745 % timeline years anchor=south west,
6746 % minor step font=\sffamily\scriptsize\tlstyle,
6747 % timeline margin'=17.5pt,
6748 % },
6749 % minor year format={!Y},
6750 % every event below,
6751 % every life below,
6752 % every period below,
6753 % levels=0:3,
6754 % headings style+={text=chronos main colour!75!chronos main background colour,font=\small\itshape\bfseries},
6755 % subheadings style+={text=chronos main colour!75!chronos main background colour,font=\footnotesize\itshape},
6756 % main/title+={font=\LARGE,text=chronos timeline foreground colour,draw=chronos timeline background colour,semithick},
6757 % main/frame+={thick,draw,chronos timeline foreground colour,double=chronos timeline background colour},
6758 % copyright={font=\footnotesize\sffamily, inner sep=0pt, outer sep=0pt, text=chronos timeline foreground colour!50!chronos main background colour},
6759 % copyright/rotate=90,
6760 % copyright/tag anchor=north west,
6761 % },
6762 % }
6763 % \end{chronoscode}
6764 % This definition is chosen because it is one of the most technically complex examples.
6765 % This complexity is a function of several factors: it uses \emph{off-line} years; the year labels are rotated; the line involves two arrow tips; and the line is drawn with \texttt{double}.
6766 %
6767 % Note the following:
6768 % \begin{enumerate}
6769 % \item\label{item:col-use} colours listed in \cref{tab:colscheme} are used but not defined;
6770 % \item\label{item:custom-col} instead, a custom colour configuration is set by loading an appropriate \colschemelabelname{};
6771 % \item\label{item:weird-i} there is a weird looking \keyname[type=macro,idx post=use in \string\textkey{blues below}]{\cs{chronosyeari}} in the definition of \keyname[link prefix=timeline/,idx as=timeline/timeline year]{timeline year};
6772 % \item\label{item:timeline-arrow} \keyname[type=boolkey,idx post=use in \string\textkey{blues below}\string\idxeg]{timeline/timeline arrow} and \keyname[idx post=use in \string\textkey{blues below}\string\idxeg]{timeline/conditional timeline arrow} enables use of arrow tips to be toggled off;
6773 % \item\label{item:def-dyddiadau} \keyname[type=datekey,no idx]{dates} are defined, even though they are almost certainly wrong in most cases;
6774 % \item\label{item:meaning2context} \keyname[no link,type=keyhandler,idx post=use in \string\texttt{blues below}\string\idxeg]{.meaning to context} is used, even though the user might not have loaded \pkg{memoize}, which defines it.
6775 % \item\label{item:tlstyle} some fonts use a non-standard command \cs{tlstyle}.
6776 % \end{enumerate}
6777 %
6778 % \Cref{item:tlstyle} need not concern us here.
6779 % If certain packages are loaded, it ensures tabular, lining figures; if not, \pkg{chronos} provides a command with this name at the end of the preamble by simply \cs{let}ting it to \cs{upshape}.
6780 %
6781 % Regarding \cref{item:def-dyddiadau}, the standard \chronosstyleslabelname{} all define \keyname[type=datekey,idx post=whether to define in \string\textsf{chronos styles}]{dates}, but whether they should do so is another question.
6782 % On the one hand, if they are not defined (as they are not if no \chronosstylelabelname{} is loaded), \pkg{chronos} will generate an error, alerting the user to the deficiency.
6783 % Since it is highly unlikely any default choice will suit any user, let alone most of them, an error might be considered appropriate.
6784 % On the other hand, some \chronosstyleslabelname{} are far more suitable for some temporal ranges than others.
6785 % For example, consider this excerpt from the definition of \keyname[type=chronosstyle,idx post=suitability for temporal ranges of]{contemporary 90}:
6786 % \begin{chronoscode}
6787 % timeline={%
6788 % timeline marks,
6789 % timeline minor marks,
6790 % timeline mark={ultra thick},
6791 % timeline minor mark={thick},
6792 % step divisions=4,
6793 % step major years=2,
6794 % },
6795 % \end{chronoscode}
6796 % This is fine for a \conceptname[no idx]{timeline} of a decade or two, but quite unsuitable for one representing either the period 3,000\,\bce{}--2025\,\ce{} or the first half of 1857.
6797 % While a user can always modify these settings, along with the \keyname[type=datekey,no idx]{dates}, a default range provides a sense of the temporal duration the \chronosstylelabelname{} is suitable for ‘out-of-the-box’.
6798 %
6799 % The author of this package has found a comfortable spot on a convenient fence and intends to stay there, whatever the provided \chronosstyleslabelname{} might suggest.
6800 % The reader is warned to make the most of the fences available here, as there are none whatsoever in the next \namecref{subsubsec:custom-styles-colours}.
6801 %
6802 % \subsubsection{How (Not) to Customise Colours}\label{subsubsec:custom-styles-colours}
6803 %^^A BEGIN subsubsec:custom-styles-colours
6804 %
6805 % \Cref{item:col-use,item:custom-col} are the most important.
6806 % \textbf{\emph{\Chronosstyleslabelname{} \emph{MUST NOT} set core, core derivative or core border colours,} where ‘core, core derivative and core border colours’ refer to those listed in \cref{tab:colscheme,tab:colnames}.}
6807 % In many cases, violating this rule may appear to work, but in others doing so will produce weird results or errors.
6808 % \begin{table}
6809 % \centering
6810 % \mmzset{disable}%^^A
6811 % \caption{Keys and names for \pkg{chronos} colours.
6812 % Note that neither ‘colour’ nor ‘color’ appears in any \keylabelname{} in the first column, but in every key in the second.
6813 % In the second column, ‘color’ may be substituted for ‘colour’ in any name.}\label{tab:colnames}
6814 % \chronosdocidx[type=colscheme,font=\normalfont,target]{colour names}%^^A
6815 %^^A \chronosdochypertargets{colour}{}{core,core derivative,core border}%
6816 % \chronosdocidx[type=colour,font=\ConceptFont,target]{core,core derivative,core border,elemental}%^^A
6817 % \begin{tabular}{>{\ttfamily}l>{\ttfamily}l}
6818 % \toprule\tikzmark{colnames-pen}%^^A memoization aborted
6819 % \tikzmark{colnames-a}\sffamily Colour Schemes Key & \sffamily Later Accessible As \\\midrule
6820 % \tikzmark{colnames-b}%^^A
6821 % \keyname[type=colschemekey]{foreground} & \chronosdochypertargets*{colour}{}{chronos main colour,chronos main color} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@prifliw}{#1}} %^^A chronos main colour &
6822 % \keyname[type=colschemekey]{background} & \chronosdochypertargets*{colour}{}{chronos main background colour,chronos main background color} \tikzmark{colnames-c}\\ %^^A {\__chronos_color_set_from_existing:nn {chronos@prifliw@cefndir}{#1}} %^^A chronos main background colour &
6823 % \cmidrule(lr){1-2}
6824 % \tikzmark{colnames-d}%^^A
6825 % \keyname[type=colschemekey]{timeline foreground} & \chronosdochypertargets*{colour}{}{chronos timeline foreground colour,chronos timeline foreground color} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@lliw@llinell}{#1}} %^^A chronos timeline foreground colour &
6826 % \keyname[type=colschemekey]{timeline background} & \chronosdochypertargets*{colour}{}{chronos timeline background colour,chronos timeline background color} \tikzmark{colnames-e}\\ %^^A {\__chronos_color_set_from_existing:nn {chronos@lliw@cefndir@llinell}{#1}} %^^A chronos timeline background colour &
6827 % \cmidrule(lr){1-2}
6828 % \tikzmark{colnames-f}%^^A
6829 % \keyname[type=colschemekey]{timeline border outer} & \chronosdochypertargets*{colour}{}{chronos timeline border outer colour,chronos timeline border outer color} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@borderouter}{#1}} %^^A timeline border outer colour &
6830 % \keyname[type=colschemekey]{timeline border inner} & \chronosdochypertargets*{colour}{}{chronos timeline border inner colour,chronos timeline border inner color} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@borderinner}{#1}} %^^A timeline border inner colour &
6831 % \keyname[type=colschemekey]{timeline border middle} & \chronosdochypertargets*{colour}{}{chronos timeline border middle colour,chronos timeline border middle color} \tikzmark{colnames-g}\\ %^^A {\__chronos_color_set_from_existing:nn {chronos@bordermiddle}{#1}} %^^A timeline border middle colour &
6832 % \cmidrule(lr){1-2}
6833 % \tikzmark{colnames-h}%^^A
6834 % \keyname[type=colschemekey]{life/default} & \fycross{} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@byw@lliw@rhagosodedig}{#1}} %^^A life/default colour &
6835 % \keyname[type=colschemekey]{event/default} & \fycross{} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@digwyddiad@lliw@rhagosodedig}{#1}} %^^A event/default colour &
6836 % \keyname[type=colschemekey]{period/default} & \fycross{} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@parhad@lliw@rhagosodedig}{#1}} %^^A period/default colour &
6837 % \keyname[type=colschemekey]{theory/default} & \fycross{} \\ %^^A {\__chronos_color_set_from_existing:nn {chronos@theori@lliw@rhagosodedig}{#1}} %^^A theory/default colour &
6838 % \keyname[type=colschemekey]{info/default} & \fycross{} \tikzmark{colnames-i}\\ %^^A {\__chronos_color_set_from_existing:nn {chronos@gwybodaeth@lliw@rhagosodedig}{#1}} %^^A info/default colour &
6839 % \cmidrule(lr){1-2}
6840 % \tikzmark{colnames-j}%^^A
6841 % \keyname[type=colschemekey]{default above} & \fycross{} \\ %^^A \g__chronos_lliwiau_uchod_clist %^^A colours above &
6842 % \keyname[type=colschemekey]{default below} & \fycross{} \\ %^^A \g__chronos_lliwiau_isod_clist %^^A colours below &
6843 % \keyname[type=colschemekey]{life/above} & \fycross{} \\ %^^A \g__chronos_lliwiau_byw_uchod_clist %^^A life/colours above &
6844 % \keyname[type=colschemekey]{life/below} & \fycross{} \\ %^^A \g__chronos_lliwiau_byw_isod_clist %^^A life/colours below &
6845 % \keyname[type=colschemekey]{event/above} & \fycross{} \\ %^^A \g__chronos_lliwiau_digwyddiad_uchod_clist %^^A event/colours above &
6846 % \keyname[type=colschemekey]{event/below} & \fycross{} \\ %^^A \g__chronos_lliwiau_digwyddiad_isod_clist %^^A event/colours below &
6847 % \keyname[type=colschemekey]{period/above} & \fycross{} \\ %^^A \g__chronos_lliwiau_parhad_uchod_clist %^^A period/colours above &
6848 % \keyname[type=colschemekey]{period/below} & \fycross{} \\ %^^A \g__chronos_lliwiau_parhad_isod_clist %^^A period/colours below &
6849 % \keyname[type=colschemekey]{theory/above} & \fycross{} \\ %^^A \g__chronos_lliwiau_theori_uchod_clist %^^A theory/colours above &
6850 % \keyname[type=colschemekey]{theory/below} & \fycross{}\tikzmark{colnames-k} \\ %^^A \g__chronos_lliwiau_theori_isod_clist %^^A theory/colours below &
6851 % \bottomrule
6852 % \end{tabular}\tikzmark{colnames-de}
6853 % \begin{tikzpicture}[remember picture,overlay,decoration={brace,mirror,amplitude=5},every node/.style={font=\sffamily}]
6854 % \foreach \i in {a,b,...,k} \coordinate (c\i) at (pic cs:colnames-\i);
6855 % \foreach \i/\j in {a/b,c/d,d/e,e/f/,f/g,g/h,h/i,i/j,j/k}
6856 % \coordinate (c\i\j) at ($(pic cs:colnames-\i)!0.5!(pic cs:colnames-\j)$);
6857 % \path (cab) ++(-5pt,0pt) coordinate (ch);
6858 % \foreach \i/\j/\k in {ab/c/core,cd/e/{core\\derivative},ef/g/{core\\border},gh/i/{default\\colours},ij/k/colour\\lists}
6859 % \draw [decorate] (c\i -| ch) -- (c\j -| ch) node [midway,align=right,anchor=east,xshift=-5pt,name=n\i\j] {\k} ;
6860 % \coordinate (ch2) at (ncde.west);
6861 % \draw [decorate] ([yshift=1.5pt]{ch2 |- cgh}) -- ([yshift=-1.5pt]{ch2 |- ck}) coordinate [midway,xshift=-5pt] (nghk) ;
6862 % \foreach \i/\j/\k in {g/ab/{C\\O\\R\\E}} \draw [decorate] ([yshift=-1.5pt]{{pic cs:colnames-de} |- c\i}) -- ([yshift=1.5pt]{{pic cs:colnames-de} |- c\j}) node [midway,align=center,anchor=west,xshift=5pt,name=core2,font=\sffamily\bfseries\Large] {\k} ;
6863 % \foreach \i/\j/\k/\l in {ab/g/{C\\O\\R\\E}/core1,gh/k/{E\\L\\E\\M\\E\\N\\T\\A\\L}/ele} \draw [decorate] ([yshift=1.5pt]{ch2 |- c\i}) -- ([yshift=-1.5pt]{ch2 |- c\j}) node [midway,align=center,anchor=east,xshift=-5pt,name=\l,font=\sffamily\bfseries\Large] {\k} ;
6864 % \node [left=5pt of core1.west,align=right,anchor=east,name=mnd] {MUST\\NOT\\define!};
6865 % \node [align=right,anchor=east] at (mnd.east |- nghk) {Should\\NOT\\touch!};
6866 % \end{tikzpicture}
6867 % \end{table}
6868 %
6869 % Moreover, \textbf{\emph{\chronosstyleslabelname{} \emph{should not} set any other \conceptname[type=colkey,no link,idx as=should not be set by,font=\normalfont]{\colkeylabelname{}} or \conceptname[type=collist,idx as=should not be set by,font=\normalfont,no link]{\collistlabelname{}} directly}}.
6870 % In many cases, violating this rule may appear to work, but in others doing so will cause things not to work as expected.
6871 %
6872 % To summarise, \textbf{\emph{if it \emph{can} be done by a \conceptname[type=colscheme,no idx,no link]{\colschemelabelname{}}, it \emph{should} be done by a \conceptname[type=colscheme,no idx,no link]{\colschemelabelname{}}}\footnote{%^^A
6873 % That is, ‘can implies ought’.}}.
6874 %
6875 % The reason for this restriction is that the colours are not finalised and the public colour names are not defined when the \colschemelabelname{} and/or \chronosstylelabelname{} are read.
6876 % Initially, \pkg{chronos} assigns colours only to internal names.
6877 % When the user configuration in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} has been read, \pkg{chronos} starts the \enviro{tikzpicture} \envlabelname{} and further processes the configuration before drawing the \conceptname[idx post={configuration, further processing}]{timeline}.
6878 % As part of this processing, \pkg{chronos} makes changes to colours in specified circumstances.
6879 %
6880 % In particular, the colours assigned to the \conceptname[idx post={colours, further processing changes}]{timeline} foreground and background are switched if three conditions are satisfied.
6881 % \begin{enumerate}
6882 % \item The internal colour names for \keyname[type=colour]{chronos timeline foreground colour,chronos timeline background colour} evaluate to the same colour specification.
6883 % \item One of the specifications is identical to the colour specification for \keyname[type=colour,no link]{white}.
6884 % \item\label{condition:off-line} \keyname[type=choice,idx as=timeline/timeline years,link prefix=timeline/,link]{timeline years} is not \texttt{on line}.
6885 % \end{enumerate}
6886 % Condition \labelcref{condition:off-line} cannot be determined until the complete configuration has been read.
6887 % In particular, it is not known when \colschemeslabelname{} and \chronosstyleslabelname{} are read.
6888 % While it is recommended users select a \chronosstylelabelname{} congruent with their preferred setting for \keyname[type=choice,idx as=timeline/timeline years,link prefix=timeline/,link,no idx]{timeline years}, this is intended to make configuration easier and is not a requirement.
6889 %
6890 % Only \emph{after} colours are potentially switched are the public names listed in \cref{tab:colnames} assigned, long after \conceptname[type=colscheme,idx as=colour scheme,no idx]{colour schemes} and \conceptname[type=chronosstyle,idx as=chronos style,no idx]{chronos styles} have been read.
6891 %
6892 % It is nonetheless possible, indeed recommended, to \emph{use} the public names in \chronosstyleslabelname{}, though they cannot be used in \colschemeslabelname{}.
6893 % It is only \emph{defining} them at this stage which is problematic.
6894 %
6895 % Here is an example from the definition of \keyname[type=chronosstyle,idx post=use of public colour names in]{modern} in \pkgname[no link]{chronos-lib-styles}:
6896 % \cywir\begin{chronoscode}
6897 % timeline line={chronos timeline background colour, opacity=1},
6898 % period/line={fill=chronos timeline foreground colour, blend mode=overlay},
6899 % life/line={fill=chronos timeline foreground colour, blend mode=overlay},
6900 % event/line={draw=chronos timeline foreground colour, thick, blend mode=overlay},
6901 % every text tags={fill=chronos main background colour, text=####1, fill opacity=.75, text opacity=1, draw=none, rounded corners, align=center, font=\sffamily\footnotesize},
6902 % \end{chronoscode}
6903 % This is perfectly proper\footnote{%^^A
6904 % At least, it is fine as far as \pkg{chronos} goes. Whether it is proper \TikZ{} code is not for me to judge.}.
6905 % However, if you were to include something such as
6906 % \anghywir\begin{chronoscode}
6907 % timeline border middle colour=chronos timeline border inner colour!50!chronos timeline border outer colour,
6908 % \end{chronoscode}
6909 % you would get an error complaining about the use of undefined colours.
6910 % The definition of \keyname[type=colkey,link,link prefix=timeline/,idx as=timeline/timeline border middle colour,idx post=illegitimacy of definition in \string\textconcept{chronos style}\string\idxeg]{timeline border middle colour} is the prerogative of the \colschemelabelname{} and shouldn't feature in a \chronosstylelabelname{} at all, but this particular definition is illegitimate in any case because neither \keyname[type=colour,conj=nor,link]{chronos timeline border inner colour,chronos timeline border outer colour} yet exists.
6911 %
6912 % But why shouldn't \chronosstyleslabelname{} include colour definitions of the kind permitted in \colschemeslabelname{}?
6913 % Because \pkg{chronos} processes the definitions in \colschemeslabelname{} as they are read (\cref{subsubsec:colscheme-process}).
6914 % If you put
6915 % \anghywir\begin{chronoscode}
6916 % foreground=SlateBlue4,
6917 % background=Snow1,
6918 % \end{chronoscode}
6919 % in a \chronosstylelabelname{}, \emph{only} these colours will be set.
6920 % In particular, neither the \conceptname[idx post={colours, reason not to set in \string\textconcept{chronos style}}]{timeline} nor any default colours will be affected at all.
6921 % But if you put this into a \colschemelabelname{}, \pkg{chronos} will derive colours for the \conceptname[idx post={colours for, derivation of}]{timeline} and set default colours for \elementslabelname{} belonging to the various \tagslabelname{}.
6922 % If no other changes are made, the result will be a white-on-blue \conceptname[no idx]{timeline} with blue-to-white \conceptname[idx as=timeline border]{timeline borders} and blue as the fallback colour for \conceptname[type=concept,idx post={fallback colour, problems}]{tag} \elementslabelname{}.
6923 % (This is probably wrong for \texttt{off line} and \pkg{chronos} won't correct you because \texttt{Snow1} isn't exactly \texttt{white}, but that's why \colschemeslabelname{} should do either a bit more or a bit less than this.)
6924 %
6925 % If you wish, your \chronosstylelabelname{} can load a \colschemelabelname{} of its own.
6926 % This is what many of the standard \conceptname[type=chronosstyle,idx as=loading a \string\textsf{colour scheme},font=\normalfont]{\chronosstyleslabelname} do.
6927 % For instance, here is the sum total of \keyname[type=chronosstyle,idx post=use of custom \string\textsf{colour scheme} in]{modern}'s \keyname[type=colscheme,link,no idx]{modern} \colschemelabelname{},
6928 % \cywir\begin{chronoscode}
6929 % \chronosnewcolourscheme{modern}{%
6930 % timeline foreground=chronosSilver,
6931 % }
6932 % \end{chronoscode}
6933 %
6934 %^^A END subsubsec:custom-styles-colours
6935 %
6936 % \subsubsection{How to Rotate Years}\label{subsubsec:rotate-years}
6937 %^^A BEGIN subsubsec:rotate-years
6938 %
6939 % \Cref{item:weird-i} is a function of this style's rotation of the year labels created for the \conceptname[idx post=weird \string\texttt{\string\cs{chronosyeari}} in \string\textconcept{chronos style}]{timeline}.
6940 % The easiest way to do this is to \texttt{rotate around} one of the anchors belonging to the node containing the relevant year.
6941 % Obviously, we can't do this for each node.
6942 % We don't know how many there are or what they are named.
6943 % Instead, we need a hook into the \cs{foreach} loop \pkg{chronos} uses when creating the year labels.
6944 %
6945 % \DescribeMacro{\chronosyeari} refers to the current \conceptname{year} \emph{inside the \cs{foreach} loop used to mark years on the \conceptname[link,no idx]{timeline}}.
6946 % \texttt{(chronos year \cs{chronosyeari})} isn't actually the node, but the point representing the date on the \conceptname[idx post=chronos year \string\cs{chronosyeari},idx font post=\KeyFont]{timeline}, but the node starts there, so we can use it provided \keyname[link prefix=timeline/,idx as=timeline/timeline years anchor]{timeline years anchor} is set appropriately.
6947 % \begin{chronoscode}
6948 % timeline year={rotate around={45:(chronos year \chronosyeari |- chronos top)}},
6949 % timeline years anchor=south west,
6950 % \end{chronoscode}
6951 %
6952 %^^A END subsubsec:rotate-years
6953 %
6954 % \subsubsection{Hashes}\label{subsubsec:hashes}\chronosdocidx{\string\verb*\verbatimchar\string#\verbatimchar\string\space (hash)}\chronosdocidx[font=\normalfont]{hash (\string\verb*\verbatimchar\string#\verbatimchar )}
6955 %^^A BEGIN subsubsec:hashes
6956 %
6957 % You may have noticed the following line in the excerpt from \keyname[type=chronosstyle,link,idx post=quadrupling of hashes in]{modern}'s definition above.
6958 % \begin{chronoscode}
6959 % every text tags={fill=chronos main background colour, text=####1, fill opacity=.75, text opacity=1, draw=none, rounded corners, align=center, font=\sffamily\footnotesize},
6960 % \end{chronoscode}
6961 % Anywhere you'd normally use a single hash (e.g.~\#1) in defining a \TikZ{} \stylelabelname{}, you need two (\#\#1) because you're nesting that definition within the definition of another \stylelabelname{}.
6962 % So it is not surprising to find lines such as
6963 % \begin{chronoscode}
6964 % connections={draw=##1, {Triangle[width=0pt 3,reversed,length=0pt 1.5]}-{Triangle[width=0pt 5,reversed,length=0pt 2.5]}},
6965 % \end{chronoscode}
6966 % in \keyname[type=chronosstyle,link,no idx]{modern}'s definition, but why \emph{four}?
6967 %
6968 % Certain \keyslabelname{} require one or more additional doublings of hashes.
6969 % Anytime you use an \texttt{every} \keylabelname{}, you need to double.
6970 % Double double makes four, so we get \texttt{text=\#\#\#\#1}\footnote{%^^A
6971 % For real fun with hashes, may I recommend \pkg{chronos} or \pkg{forest}?}.
6972 %
6973 %
6974 % Elsewhere, a single doubling is generally sufficient, as shown in these lines from the definition of \keyname[type=chronosstyle,link,idx post=doubling of hashes in]{plain arrow}
6975 % \begin{chronoscode}
6976 % period/line+={line width=2pt,draw=##1},
6977 % life/line+={line width=2pt,draw=##1},
6978 % \end{chronoscode}
6979 % Incidentally, \pgf{} doesn't complain if you quadruple the hashes here, though it does so if you make the same mistake elsewhere.
6980 % So silence does not always indicate correctness.
6981 % This is important if you're debugging: don't assume because a pattern generates no error in one case, it cannot be the source of an error in another.
6982 %
6983 % Note also that if you say
6984 % \anghywir\begin{codchronos}
6985 % text tags={draw=####1,sharp corners,text opacity=1,fill opacity=1,draw opacity=1,drop shadow},
6986 % \end{codchronos}
6987 % \TeX{} will give you an error suggesting you haven't used \emph{enough} hashes,
6988 % \iffalse
6989 %<*verb>
6990 % \fi
6991 \begin{verbatim}
6992 ! Illegal parameter number in definition of \tikz@temp.
6993 <to be read again>
6994 1
6995 l.113 ]
6996
6997 ? h
6998 You meant to type ## instead of #, right?
6999 Or maybe a } was forgotten somewhere earlier, and things
7000 are all screwed up? I'm going to assume that you meant ##.
7001
7002 ?
7003 \end{verbatim}
7004 % \iffalse
7005 %</verb>
7006 % \fi
7007 % If you double the hashes \emph{again} (\texttt{\#\#\#\#\#\#\#\#1}), you'll get the same error.
7008 % The actual problem is that you've used too many.
7009 % \cywir\begin{chronoscode}
7010 % text tags={draw=##1,sharp corners,text opacity=1,fill opacity=1,draw opacity=1,drop shadow},
7011 % \end{chronoscode}
7012 % is correct in a \chronosstylelabelname{} definition i.e.~twice the number required in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}}.
7013 % If you reduce the hashes to one (\texttt{\#1}), you'll get no error but the wrong output as the \elementlabelname{}'s colour won't be used.
7014 %
7015 % \textbf{\emph{Despite this, \chronosstyleslabelname{} should always use \pkg{chronos} \keyslabelname{} and hashes for colours.}}
7016 %
7017 % Hashes are essential for two reasons.
7018 % \begin{enumerate}
7019 % \item Hard-coding colours breaks \conceptname[type=concept,link,idx post=breaking]{colour rotation}.
7020 % In order for colours to be not just assigned in rotation, but used for the \elementslabelname{} they are assigned to, \chronosstylelabelname{} definitions must use the colour names passed to them.
7021 % So hashes are essential when defining the properties of \conceptname[type=concept,idx post=hashes essential]{tag} \elementslabelname{} subject to \conceptname[type=concept,link,idx post=hashes essential]{colour rotation}.
7022 % \item \textbf{\emph{\Pkg{chronos} cannot track colours it doesn't know about and it doesn't know about colours passed directly to \pgf/\TikZ{} \keyslabelname{}.}}
7023 % Hard-coding colours breaks the system of colour names \pkgname[no link,idx post=incorrect assignment of colour names]{chronos} provides.
7024 % \Pkg{chronos} will assign colour names to colours regardless, but the names will not refer to the colours actually used.
7025 % They will merely refer to the colours assigned.
7026 % \Chronosstyleslabelname{} are responsible for ensuring assigned colours are used so \pkg{chronos} colour names work correctly.
7027 % Suppose a \chronosstylelabelname{} includes \texttt{event/text tag+=\{text=red\},event/connection+=\{draw=red\}}.
7028 % \Pkg{chronos} will keep assigning colours to \elementslabelname{} of \conceptname[type=concept,link,no idx]{tag} type \conceptname[type=tag,idx post=colour rotation,idx font post=\ConceptFont]{event}, but it will not assign ‘red’ except by happy chance.
7029 % \Example{\bs draw [chronos connect=period:red letter day] \dots{}}
7030 % will still work, but may well use black or navy blue rather than the pillar box red expected.
7031 % Since this referencing system works for some \elementslabelname{} not subject to \conceptname[type=concept,link,no idx]{colour rotation} at all, such as those belonging to \conceptname[type=concept,link,no idx]{tag} \conceptname[type=tag,idx post=as case of colour assignment without \string\textconcept{colour rotation}]{info} and applies even when \conceptname[type=concept,link,no idx]{colour rotation} is disabled completely, it constitutes a more general reason to avoid hard-coding colours, even if the effects may be less immediately noticeable in some \conceptname[idx as=timeline,idx post={colours, reason to avoid hard-coding}]{timelines}.
7032 % \end{enumerate}
7033 %
7034 %^^A END subsubsec:hashes
7035 %
7036 % \subsubsection{Timeline Arrow}\label{subsubsec:timeline-arrow}
7037 %^^A BEGIN subsubsec:timeline-arrow
7038 %
7039 % \Chronosstyleslabelname{} must decide whether to support \conceptsname[link,no idx]{timeline} with and/or without one or more
7040 % \textconcept{arrow tips} and/or \textconcept{line caps}.
7041 % In deciding this, note the following points.
7042 % \begin{itemize}
7043 % \item Only \keyname[type=choice,link prefix=timeline/timeline years/,idx pre=timeline/timeline years,no idx]{off line} styles can support these features.
7044 % \item Adding, removing or modifying a tip or cap requires adjusting the \keyname[type=dimkey,idx post=adjustments for arrow tips and line caps,idx as=timeline/timeline width,link pre=timeline/]{timeline width}.
7045 % This is because the length available for representing time is reduced when some proportion of the \conceptname[link,no idx,link pre=timeline/]{timeline line} is used for a tip or cap.
7046 % \Pkgname[idx post=adjustments required of styles]{chronos} adjusts automatically for \keysname[type=dimkey,idx pre=timeline,link pre=timeline/]{timeline margin,timeline era margin}, but \styleslabelname{} are responsible for other adjustments.
7047 % \item Supporting both arrowed and non-arrowed variants therefore requires conditionalised code.
7048 % \item Each arrow tip and line cap requires a bespoke adjustment, even if used in default form.
7049 % \item Users may legitimately use \keyname[type=boolkey,idx post=following \string\textconcept{\string\chronosstyleslabelname}]{timeline/timeline arrow} and \keyname[idx post=following \string\textconcept{\string\chronosstyleslabelname}]{timeline/no timeline arrow} after loading a \chronosstylelabelname{}.
7050 % \item \Chronosstyleslabelname{} may legitimately ignore these \keyslabelname{}.
7051 % \item \Chronosstyleslabelname{} must delay finalising the content of \keyname[no idx]{timeline} until the end of the \conceptname[link,no idx,type=concept]{\meta{chronos preamble}} if they wish to support variants with and without tips and/or caps.
7052 % \end{itemize}
7053 %
7054 % See \keyname[type=boolkey,no idx]{timeline/timeline arrow} and \keyname[no idx]{timeline/no timeline arrow}.
7055 %
7056 % \DescribeKey{timeline/conditional timeline arrow}\valsmarg{key-value list if arrow/cap}{key-value list otherwise}\AfterLastParam
7057 % This \keylabelname{} expects two arguments: \meta{key-value list if arrow/cap} should be a list of key-values to be executed if \keyname[no idx,type=boolkey]{timeline/timeline arrow} is \texttt{true}; \meta{key value list otherwise} should be a list of key-values to be executed if it is \texttt{false}.
7058 % \Pkgname[no idx]{chronos} will switch the \keylabelname{} path to \texttt{/chronos/} prior to using the list, but the \texttt{timeline} prefix must be specified if required.
7059 % The effect is to add code to the \stylelabelname{} \keyname{timeline/do timeline arrow} which executes \meta{key-value list if arrow/cap} if \keyname[type=boolkey,no idx,link pre=timeline/]{timeline arrow} is \texttt{true} and \meta{key-value list otherwise} otherwise.
7060 % More specifically, the code used to implement this mechanism is equivalent to
7061 % \begin{chronoscode}
7062 % conditional timeline arrow/.code 2 args={%
7063 % \pgfqkeys{/chronos}{%
7064 % llinell amser/.cd,
7065 % timeline@arrow/.style={/chronos/.cd,#1},
7066 % no@timeline@arrow/.style={/chronos/.cd,#2},
7067 % do timeline arrow/.add code={%
7068 % \ifchronostimelinearrow
7069 % \tikzset{/chronos/llinell amser/timeline@arrow}%
7070 % \else
7071 % \tikzset{/chronos/llinell amser/no@timeline@arrow}%
7072 % \fi
7073 % },
7074 % }%
7075 % },
7076 % \end{chronoscode}
7077 % If the \conceptname[link,no idx]{timeline} uses off line \conceptsname[link,no idx]{years}, \texttt{\cs{pgfqkeys}\marg{/chronos/timeline}\marg{do timeline arrow}} is executed after \keyname[type=dimkey,idx post={finalised before \string\texttt{timeline/do timeline arrow}}]{timeline/timeline height} is finalised.
7078 % \Example{\normalfont See below.}
7079 %
7080 % \DescribeKey{timeline/do timeline arrow}\AfterLastParam
7081 % \Chronosstyleslabelname{} are expected to set this \emph{via} \keyname[no idx]{timeline/conditional timeline arrow}, which causes it to be executed in \keyname[link,no idx]{timeline config}, but they could also execute it explicitly if required.
7082 % \Default
7083 %
7084 % For example, \keyname[type=chronosstyle,idx post=use of \string\textkey{conditional timeline arrow}\string\idxeg]{lines on line} supports arrowed and non-arrowed variants using
7085 % \begin{chronoscode}
7086 % lines on line/.style={% https://tex.stackexchange.com/a/324453/
7087 % /chronos/.cd,
7088 % ...
7089 % timeline={%
7090 % timeline width'=120mm,
7091 % ...
7092 % timeline arrow,
7093 % conditional timeline arrow={%
7094 % timeline/timeline width'-=20mm,
7095 % timeline/timeline line+={shorten >=-20mm, -{Triangle Cap[length=20mm]}},
7096 % before headings+={%
7097 % \path (chronos post) -- +(20mm,0pt);
7098 % },
7099 % }{},
7100 % },
7101 % ...
7102 % },
7103 % \end{chronoscode}
7104 % \texttt{timeline arrow} requests an arrow by default, but does nothing else.
7105 % \texttt{conditional timeline arrow} sets up the \stylelabelname{} \keyslabelname{} to execute if \keyname[no idx,link pre=timeline/,type=boolkey]{timeline arrow} is still enabled when \keyname[no idx,link pre=timeline/]{do timeline arrow} is executed.
7106 % At this stage, then, no actual changes are applied to the \stylelabelname{} to be applied to the \conceptname[link,no idx]{timeline}.
7107 %
7108 % The actual effects on the \conceptname[no idx]{timeline}'s \stylelabelname{} are determined only at the end of \conceptname[link,no idx,type=concept]{\meta{chronos preamble}} when \keyname[no idx]{timeline/do timeline arrow} is executed.
7109 % Hence, the user may override the \stylelabelname{}'s use of \texttt{timeline arrow} by writing \texttt{timeline/timeline arrow=false} or \texttt{timeline/no timeline arrow} after loading \keyname[type=chronosstyle,no idx]{lines on line}.
7110 %
7111 % \Styleslabelname{} which support \conceptname[link,no idx]{timeline} arrows must do the following to ensure correct results\footnote{%^^A
7112 % This is necessary because \env{chronos} discards the bounding box which includes the arrows immediately after drawing them and it is not possible (as far as I can tell) to extract the required information, even though \pgf{} has just performed all these calculations itself.%^^A
7113 % }.
7114 % \begin{enumerate}
7115 % \item Set \keyname[type=boolkey]{timeline/timeline arrow} if an arrow, non-default line-cap or similar is to be default.
7116 % \item Use \keyname{timeline/conditional timeline arrow} if a non-arrow is to be supported and configure the arrow/cap/spacer(s) \emph{only} using this conditional.
7117 % \item Decrease \keyname[type=dimkey]{timeline/timeline width} by the total length of arrows, caps and spacers.
7118 % At the beginning of the \enviro{chronos} \envlabelname{}, this dimension must equal the actual length available for the \keysname[type=dimkey,no idx,link pre=timeline/]{timeline era margin}, \keysname[type=dimkey,link pre=timeline/,no idx]{timeline margin} and the representation of time, else \conceptname[link,no idx]{marks,years} may be placed onto arrows or caps.
7119 % \begin{enumerate}
7120 % \item[] The recommended way to do this at present is to
7121 % \item calculate the total length of arrows, caps and spacers by hand and use \keyname[link to=timeline/timeline width,type=dimkey,no idx]{timeline/timeline width'}\valmarg{total length} to subtract it from the user-specified \texttt{width}\footnote{%^^A
7122 % Accurate calculation requires knowledge of \cs{pgflinewidth}, any use of \texttt{double}, custom options passed to the arrow and details of the formula \pgf{} uses to calculate the length for the specific types of arrow tips and/or line caps configured.
7123 % In some cases, this information is included in the \TikZ{} manual but, in most cases, you must consult the source of the \lib{arrows.meta} \liblabelname{}.};
7124 % \item add \texttt{shorten >=} and/or \texttt{shorten <=}, as appropriate, to increase the length of the line just while it is being drawn.
7125 % \end{enumerate}
7126 % \item Ensure the bounding box includes any arrows, caps and spacers.
7127 % \begin{enumerate}
7128 % \item[] One way to achieve this is to
7129 % \item use \keyname{before headings+} to place coordinates at the tip and very tail of the arrow/cap/spacer(s).
7130 % \end{enumerate}
7131 % \item Calculations must account for \cs{pgflinewidth} and, if applicable, any use of \texttt{double}, in order to avoid overfull boxes.
7132 % \end{enumerate}
7133 %
7134 %^^A END subsubsec:timeline-arrow
7135 %
7136 % \subsubsection{Styles and Automemoization}\label{subsubsec:memoizable-style}
7137 %^^A BEGIN subsubsec:memoizable-style
7138 %
7139 % It is recommended that \chronosstyleslabelname{} are configured so that externalised \enviro{chronos} \conceptsname[no idx,no link]{timeline} which use them are automatically recompiled if the \styleslabelname{}' definitions change.
7140 % This can be achieved by adding \meta{name of style}\texttt{/.meaning to context} to each \chronosstylelabelname{}'s definition.
7141 % For example, the packaged \styleslabelname{} all use the following template to begin their definitions.
7142 % \begin{chronoscode}
7143 % \pgfqkeys{/chronos}{%
7144 % <name of style>/.style={%
7145 % /chronos/.cd,
7146 % <name of style>/.meaning to context,
7147 % ...
7148 % },
7149 % }
7150 % \end{chronoscode}
7151 % This is safe, even if \pkg{memoize} isn't used, because \pkg{chronos} provides a fallback \keyhandlerlabelname{}, \keyname[type=keyhandler,no link,idx post=use in \string\textconcept{chronos styles}]{.meaning to context} which does nothing.
7152 %
7153 %^^A END subsubsec:memoizable-style
7154 %
7155 %^^A END subsec:chronos-style-creation
7156 %
7157 % \subsection{Defining Styles for Additional Elements}\label{subsec:element-style-creation}
7158 %^^A BEGIN subsec:element-style-creation
7159 %
7160 % Due to the way \pkg{chronos} manages \conceptname[type=concept,idx post=custom \string\textsf{styles}]{tag} contexts, creating custom \styleslabelname{} to apply to the additional \elementslabelname{} explained in \cref{sec:macros-add-elements} is not necessarily straightforward.
7161 %
7162 % If you only want to use non-\pkg{chronos} \keyslabelname{} in your \stylelabelname{}, however, it \emph{is} straightforward.
7163 % Simply create whatever \pgf{}/\TikZ{} \styleslabelname{} you wish and add them to particular \elementslabelname{} as you deem appropriate.
7164 %
7165 % The trouble starts if you want to define \stylelabelname{} which include \pkg{chronos} \keyslabelname{}.
7166 % More particularly, difficulties arise if you want to use \keyslabelname{} which are specific to \conceptname[type=concept,link,no idx]{tag} contexts such as \keyname[conj=or,idx post=trouble in custom \string\textsf{styles}]{at,tag anchor}.
7167 % For example, the \conceptname[no idx]{timeline} in \cref{fig:chronos-dev} uses three custom \styleslabelname{}, \keyname[type=style,no link,idx pre=custom,idx font pre=\normalfont,symbol=eg]{tag left,tag post,tag right} to place \conceptname[idx as=text tag,idx post={custom style using \string\pkg{chronos} keys\string\idxeg}]{text tags}.
7168 % Consider the definition of \keyname[type=style,no link]{tag right},
7169 % \begin{chronoscode}
7170 % at/.expand once=level -##1.south -| ##2,
7171 % tag anchor=north west,
7172 % anchor=south west,
7173 % xshift=5pt,
7174 % connectors=east,
7175 % \end{chronoscode}
7176 % It uses \keyname[idx post=in custom style\string\idxeg]{at,tag anchor}, which are \conceptname[type=concept,link,no idx]{tag}-specific \pkg{chronos} \keyslabelname{}, as well as the \keyname[no link]{anchor,xshift} \pgf/TikZ{} \keyslabelname{}.
7177 % A naïve approach would suggest
7178 % \anghywir\begin{chronoscode}
7179 % tag right/.style 2 args={%
7180 % at/.expand once=level -##1.south -| ##2,
7181 % tag anchor=north west,
7182 % anchor=south west,
7183 % xshift=5pt,
7184 % connectors=east,
7185 % },
7186 % \end{chronoscode}
7187 % but this will fail.
7188 % Less naïvely, you might fiddle with path prefixes, but this won't work reliably either because \pkg{chronos} effectively activates\chronosdocidx[type=tag,font=\normalfont,idx post=activated by installation under \string\texttt{/chronos}]{-specific settings} some \conceptname[type=concept,link,no idx]{tag}-specific settings by installing them temporarily under \texttt{/chronos}.
7189 % Meanwhile, it redefines\chronosdocidx[type=key,font=\normalfont]{redefinition in \string\textsf{tag}-specific contexts} a subset of both the global and \conceptname[type=concept,link,no idx]{tag}-specific \keyslabelname{} to ensure local \elementlabelname{}-specific settings don't ‘leak’\footnote{\pgf/\TikZ{} has this type of containment down to a fine art.
7190 % \Pkg{chronos}'s approach is altogether cruder.}.
7191 %
7192 % The result of all this is that you cannot generally use standard \pgf/\TikZ{} techniques to define \styleslabelname{} involving \pkg{chronos} \keyslabelname{} for use in creating \pkg{chronos} \elementslabelname{} belonging to \conceptname[type=concept,idx as=tag,link,no idx,link to=tag]{tags}.
7193 % Given the aims of \pkg{chronos}, this is a significant limitation only partially mitigated by the following workaround.
7194 %
7195 % \Pkg{chronos} provides a \pgf{}/\TikZ{} \conceptname[type=keyhandler,idx as=for \string\textsf{style} creation,font=\normalfont]{key handler} to facilitate the creation of straightforward \styleslabelname{}, but the current version has significant limitations I've not been able to solve.
7196 %
7197 % \DescribeKeyhandler{.chronos key maker}\valmarg{key name}\marg{pgf key handler}\marg{value}\AfterLastParam
7198 % \meta{key name} should be a name suitable for a \pgf{}/\TikZ{} \keylabelname{}.
7199 % \meta{pgf key handler} should be a \pgf{} key handler, without the leading dot, such as \texttt{style 2 args} or \texttt{ecode}.
7200 % \meta{value} should be the value or definition for \meta{key name}.
7201 % \emph{Only handlers which expect a single argument may be used.}
7202 % This limits the maximum number of arguments \meta{key name} can absorb to two, since the only \pgf{} \keyhandlerslabelname{} capable of absorbing three or more arguments themselves require two or more.
7203 %
7204 % The \keyhandlerlabelname{} is available in the \conceptname[type=concept,no idx,link]{\meta{chronos preamble}} and in \keyname[type=macro,no idx]{\cs{chronosset}}.
7205 % It requires a single doubling of hashes.
7206 % \Example{}Here are the definitions of \keyname[type=keyhandler,no link,idx pre=.chronos key maker,idx font pre=\KeyFont,symbol=eg]{tag left,tag post,tag right} mentioned above.
7207 % \begin{chronoscode}[chronos,key,maker,end]
7208 % tag right/.chronos key maker={tag right}{style 2 args}{%
7209 % at/.expand once=level -##1.south -| ##2,
7210 % tag anchor=north west,
7211 % anchor=south west,
7212 % xshift=5pt,
7213 % connectors=east,
7214 % },
7215 % tag left/.chronos key maker={tag left}{style 2 args}{%
7216 % at/.expand once=level -##1.south -| ##2,
7217 % tag anchor=north east,
7218 % anchor=south east,
7219 % xshift=-5pt,
7220 % text tag+={align=right},
7221 % },
7222 % tag post/.chronos key maker={tag post}{style}{%
7223 % at=level -##1.south -| chronos end,
7224 % tag anchor=north west,
7225 % anchor=south east,
7226 % connect=false,
7227 % connectors=east,
7228 % },
7229 % \end{chronoscode}
7230 % Note \keyname[type=style,no link,idx pre=custom,symbol=eg]{tag post}'s use of the standard \texttt{coordinate} \texttt{chronos end} (\cref{fig:anatomi-coords}).
7231 %
7232 %^^A END subsec:element-style-creation
7233 %
7234 %^^A END sec:scheme-style-creation
7235 %
7236 % \section{Debugging}\label{sec:dadfygio}
7237 %^^A BEGIN sec:dadfygio
7238 %
7239 % \emph{Note that many \keyslabelname{} in this section draw \keyname[type=style]{on chronos overlay layer}.
7240 % They will typically draw \textbf{over} content you've created.}
7241 % This should not be a concern as they are not intended for use in the final document.
7242 %
7243 % \DescribeChoice{placeholders}\vals{on,off}\AfterLastParam
7244 % If enabled, any helper nodes created with \keyname[idx post=making visible]{levels} will be visible rather than invisible\texsethanks{Qrrbrbirlbel}{694967} and vertical lines corresponding to \conceptname[idx post=vertical lines corresponding to]{headings} will be drawn.
7245 % This option is intended to assist in the creation of complex \conceptname[idx as=timeline,idx post={creation of complex}]{timelines}.
7246 % \Default{on}
7247 % \Initial{off}
7248 %
7249 % \DescribeStyle{placeholder lines}\valmarg{key-value list}\AfterLastParam
7250 % The \stylelabelname{} used to draw any lines created when \keyname[type=choice,idx post=style]{placeholders} is enabled.
7251 % The style may be modified or replaced using the usual \TikZ{} techniques, but the settings for nodes should not be altered in a way which changes their size e.g.~by setting \texttt{line width} or similar.
7252 % \begin{chronoscode}[placeholder,placeholders,lines]
7253 % \begin{chronos}
7254 % [
7255 % placeholders,
7256 % placeholder lines/.append style={thick},% for the default nodes and similar lines, but thicker
7257 % placeholder lines/.style={thin,draw=magenta,<->},% for magenta double-arrowed lines with no changes to nodes
7258 % ]
7259 % \end{chronos}
7260 % \end{chronoscode}
7261 % \Default{help lines, every node/.append style={rotate=-90,anchor=south,pos=.25,inner sep=0pt}}
7262 %
7263 % The following were created for use in developing the package, but some may be more generally useful.
7264 % Those which seem most likely to be helpful are listed first.
7265 %
7266 % \emph{Note that all of the \keyslabelname{} which follow ignore the picture's bounding box.
7267 % This means they will disappear (or partially disappear) with no warning if there is insufficient space.}
7268 % This may be a concern, but having half the \conceptname[no idx]{timeline} disappear from view is worse.
7269 %
7270 % \DescribeBoolkey{show coords}\vals{true,false}\AfterLastParam
7271 % Labels a selection of \pkg{chronos} coordinates, which may be useful for placement or trouble-shooting purposes.
7272 % \Default{true}
7273 % \Initial{false}
7274 %
7275 % \DescribeBoolkey{show bounding box}\vals{true,false}\AfterLastParam
7276 % Draws the bounding box of the \enviro{tikzpicture} containing the \conceptname[no idx]{timeline}.
7277 % \Default{true}
7278 % \Initial{false}
7279 %
7280 % \DescribeBoolkey{show nodes}\vals{true,false}\AfterLastParam
7281 % If, and only if, \keyname[type=boolkey,idx as=timeline/timeline mark eras,idx post=effect of enabling explicitly \string\emph{vs.}~implicitly on \string\textkey{show nodes},link prefix=timeline/,link]{timeline mark eras} is explicitly enabled (as opposed to being enabled just because a \conceptname[no idx]{timeline} spans \bceyearlabel{} and \ceyearlabel{}), draws and labels the nodes containing the era labels on the \conceptname[idx post=show nodes,idx font post=\KeyFont]{timeline}.
7282 % \Default{true}
7283 % \Initial{false}
7284 %
7285 % \DescribeKey{debug}A convenience \keylabelname{} which switches on all four of the options above.
7286 % \begin{chronoscode}[debug]
7287 % \begin{chronos}
7288 % debug,
7289 % \end{chronos}
7290 % \end{chronoscode}
7291 %
7292 % The following \keyslabelname{} are available to customise the output of the options in this section.
7293 %
7294 % \DescribeColkey{show coordinate colour,show coordinate color}\val{colour name}\AfterLastParam
7295 % \Default{red}
7296 %
7297 % \DescribeColkey{show bb colour,show bb color}\val{colour name}\AfterLastParam
7298 % \Default{green}
7299 %
7300 % \DescribeColkey{show node colour,show node color}\val{colour name}\AfterLastParam
7301 % \Default{blue}
7302 %
7303 % \DescribeStyle{show coordinate}
7304 % A \stylelabelname{} used to show coordinates.
7305 % It is used both directly and indirectly by both \keyname[type=style]{show coord} and \keyname[type=style]{show node coord}.
7306 % If you want to redefine it, it should take 5 arguments: a colour name, an angle, the name of the coordinate, a dimension and a (possibly empty) key-value list.
7307 % \Default{fill=\#1, circle, anchor=center, inner sep=1pt, text=\#1, pin=\{[\#1, inner sep=0pt, pin edge=\{draw=\#1\}, pin distance=\#4, \#5]\#2:\#3\}}
7308 %
7309 % \DescribeStyle{show coord}
7310 % A \stylelabelname{} used to show coordinates.
7311 % If you want to redefine it, it should take 2 arguments: the name of the coordinate and an angle.
7312 % \Default{/chronos/show coordinate=\{\meta{chronos show coordinate colour}\}\{\#1\}\{\#2\}\{30pt\}\{\}}
7313 %
7314 % \DescribeStyle{show node coord}
7315 % A \stylelabelname{} used to show particular points on nodes.
7316 % If you want to redefine it, it should take 2 arguments: the name of the coordinate and an angle.
7317 % \Default{/chronos/show coordinate=\{\meta{chronos show node colour}\}\{\#1\}\{\#2\}\{30pt\}\{\}}
7318 %
7319 % \DescribeMacro{\chronosshowcolour}\oarg{\cs{macroname}}\marg{colour name}\AfterLastParam%^^A \chronos@dangoslliw
7320 % \DescribeMacro{\chronosshowcolour*}\oarg{\cs{macroname}}\marg{colour name}\AfterLastParam
7321 % \DescribeMacro{\chronosshowcolor}\oarg{\cs{macroname}}\marg{colour name}\AfterLastParam
7322 % \DescribeMacro{\chronosshowcolor*}\oarg{\cs{macroname}}\marg{colour name}\AfterLastParam
7323 % Extract the colour specification of \meta{colour name} to the \macrolabelname{} \meta{\cs{macroname}}.
7324 % The starred forms show \meta{\cs{macroname}}; the remainder merely (re)define it.
7325 % In case it is not obvious, don't use a \meta{\cs{macroname}} you care about as it will be overwritten without warning.
7326 % By default, an internal \macrolabelname{} is used and reused, so, if you don't specify \meta{\cs{macroname}}, you can only inspect one colour specification at a time.
7327 % \Example{\cs{chronosshowcolour*}\{white\}} will show the colour specification of \texttt{white} on the terminal.
7328 %
7329 % The remainder are unlikely to be helpful except in debugging \pkg{chronos} and no attempt has been made to render their output intelligible.
7330 %
7331 % \DescribeMacro{\chronosshowpreset}%^^A \chronos@dangos@gosod
7332 % Show non-default globalised options.
7333 % This shows the properties\footnote{Specifically, the contents of the \pkg{expl3} sequence used to record the names of \pkg{chronos} properties.} currently recorded as set by the user.
7334 % This includes selected options set by \chronosstyleslabelname{} and options set with \keyname[type=macro,idx post=showing options]{\cs{chronosset}}, but not defaults set by \pkg{chronos} when loading.
7335 % This list is used in deciding whether to change the current setting of an option during \conceptname[no idx]{timeline} configuration.
7336 % For example, if a user specifically requests \keyname[type=choice,link prefix=timeline/timeline years/,idx pre=timeline/timeline years,idx font pre=\KeyFont]{off line} \conceptsname[idx post=effects of configuration]{year} with a \keyname[type=dimkey,idx as=timeline/timeline height,link prefix=timeline/,link]{timeline height} of 50mm in white-on-blue, \pkg{chronos} won't override those settings.
7337 % But if a user asks for \keyname[type=choice,link prefix=timeline/timeline years/,idx pre=timeline/timeline years,no idx]{off line} \conceptsname[no idx]{year} without specifying \keyname[type=dimkey,idx as=timeline/timeline height,link prefix=timeline/,link,no idx]{timeline height} or changing the default colours, \pkg{chronos} will try to select something reasonable for \keyname[type=dimkey,idx as=timeline/timeline height,no idx,link prefix=timeline/,link]{timeline height} and assume the user wants black-on-white rather than white-on-white.
7338 %
7339 % The output of \keyname[type=macro]{\cs{chronosshowpreset}} is unlikely to prove especially enlightening unless debugging \pkg{chronos}.
7340 % Here, for example, is the output when used at the start of a sample \enviro{chronos} environment,
7341 % \iffalse
7342 %<*verb>
7343 % \fi
7344 \begin{verbatim}
7345 The sequence \l__chronos_gosod_seq is empty
7346 > .
7347 \end{verbatim}
7348 % \iffalse
7349 %</verb>
7350 % \fi
7351 % and right after the optional argument has been processed,
7352 % \iffalse
7353 %<*verb>
7354 % \fi
7355 \begin{verbatim}
7356 The sequence \l__chronos_gosod_seq contains the items (without outer braces):
7357 > {angor@blynyddoedd}
7358 > {timeline@years}
7359 > {@digwyddiad@llawn}
7360 > {@byw@llawn}
7361 > {@parhad@llawn}
7362 > {markeras}
7363 > {llinell}
7364 > {cysylltiad}
7365 > {llinell amser}
7366 > {border}.
7367 \end{verbatim}
7368 % \iffalse
7369 %</verb>
7370 % \fi
7371 % So this user didn't specify any non-default settings in the document preamble or with \keyname[type=macro,idx post=not used\string\idxeg]{\cs{chronosset}}, but has either set or specified a \chronosstylelabelname{} which set various options for this particular \enviro{chronos} \envlabelname{}, which \pkg{chronos} should respect.
7372 % Note that the output tells us nothing about {what} has been chosen, but only \emph{that} an explicit choice has been made.
7373 % For example, \texttt{markeras} means the user has decided eras should or should not be marked on the \conceptname[idx post=identifying explicit choices]{timeline}, but does not tell us which.
7374 %
7375 % \DescribeMacro{\chronosshowfeatures}\oarg{tag}\fortags{life,event,period,theory,info}\AfterLastParam %^^A \chronos@dangos@nodweddion | \chronos@dangos@nodweddion@rhag
7376 % Shows properties\footnote{Specifically, \pkg{expl3} property lists.} assigned to either the current or \meta{tag} context.
7377 % Note that the output uses the original names for \tagslabelname{}, which differ from those documented in this manual.
7378 % \texttt{life, event, period, theory} and \texttt{info} correspond to \texttt{byw, digwyddiad, parhad, theori} and \texttt{gwybodaeth}.
7379 %
7380 % Without an argument, the default list of properties is shown if the command is executed outside a \conceptname[type=concept,idx post={effect on \string\cs{chronosshowfeatures}}]{tag} context; otherwise, the list for the current context is shown.
7381 % With an argument, the list of properties for \meta{tag} is shown regardless of execution context.
7382 %
7383 % There is no list of properties associated with \taglabelname{} \conceptname[type=tag,idx post=no associated list of properties]{main}.
7384 %
7385 % Here's the output from \keyname[type=macro]{\cs{chronosshowfeatures}} inside a \enviro{chronos} \envlabelname{}, but outside any \taglabelname{} context,
7386 % \iffalse
7387 %<*verb>
7388 % \fi
7389 \begin{verbatim}
7390 The property list \l__chronos_prop contains the pairs (without outer braces):
7391 > {@tag} => {{,/chronos/troi lliwiau=false,/chronos/blynyddoedd yn
7392 unig,/chronos/heb gyfnodau,/chronos/troi lliwiau=true}}
7393 > {@cysylltwr@chronos} => {{coordinate}}
7394 > {@cysylltwr@testun} => {{anchor=center,inner sep=0pt,outer
7395 sep=0pt,circle, anchor=center, draw=none, fill=none, minimum
7396 size=\pgflinewidth }}
7397 > {@llinell} => {{}}
7398 > {@testun} => {{fill=chronos main background colour, text=####1, fill
7399 opacity=.75, text opacity=1, draw=none, rounded corners, align=center,
7400 font=\sffamily \footnotesize ,draw=####1,sharp corners,text opacity=1,fill
7401 opacity=1,draw opacity=1,drop shadow}}
7402 > {@cysylltiad} => {{draw=##1, {Triangle[width=0pt 3,reversed,length=0pt
7403 1.5]}-{Triangle[width=0pt 5,reversed,length=0pt 2.5]}}}.
7404 \end{verbatim}
7405 % \iffalse
7406 %</verb>
7407 % \fi
7408 % and from \cs{chronosshowfeatures}\texttt{[event]},
7409 % \iffalse
7410 %<*verb>
7411 % \fi
7412 \begin{verbatim}
7413 The property list \l__chronos_digwyddiad_prop contains the pairs (without
7414 outer braces):
7415 > {@cysylltwr@chronos} => {{coordinate}}
7416 > {@cysylltwr@testun} => {{circle, anchor=center, draw=none, fill=none,
7417 minimum size=\pgflinewidth }}
7418 > {@testun} => {{fill=chronos main background colour, text=##1, fill
7419 opacity=.75, text opacity=1, draw=none, rounded corners, align=center,
7420 font=\sffamily \footnotesize ,draw=##1,sharp corners,text opacity=1,fill
7421 opacity=1,draw opacity=1,drop shadow}}
7422 > {@tag} => {{/chronos/blynyddoedd yn unig,/chronos/heb
7423 gyfnodau,/chronos/troi lliwiau=true}}
7424 > {@llinell} => {{draw=chronos timeline foreground colour, thick, blend
7425 mode=overlay}}.
7426 \end{verbatim}
7427 % \iffalse
7428 %</verb>
7429 % \fi
7430 %
7431 %
7432 %^^A END sec:dadfygio
7433 %
7434 %^^A END sec:macros-add-elements
7435 %
7436 % \clearpage
7437 %
7438 % \loadgeometry{safonol}%
7439 % \fancyheadoffset[lh]{0pt}%
7440 %
7441 % \section{Compatibility}\label{sec:compat}
7442 %^^A BEGIN sec:compat
7443 %
7444 % \Pkg{chronos} \conceptname[idx as=timeline,idx post=compatibility]{timelines} cannot be externalised using \TikZ{}'s \lib{external} \liblabelname{}\footnote{%^^A
7445 % However, \pkg{chronos} pictures \emph{can} be ‘memoized’.
7446 % Moreover, if \pkgname[idx post=compatibility]{memoize} is loaded, \pkg{chronos} will set up ‘automemoization’ by default.
7447 % See \cref{sec:external-memoize}.}.
7448 %
7449 % \TikZ{}'s \lib{spy} \liblabelname{} also appears to be incompatible.
7450 %
7451 % Arrow tips\chronosdocidx[idx post=compatibility]{arrow tips} and line caps\chronosdocidx[idx post=compatibility]{line caps} from \TikZ{}'s \lib{arrows}\chronosdocidx[idx post=compatibility,font=\PkgFont,type=lib]{arrows} \liblabelname{} are not supported in \keyname[idx post={arrow tips}]{timeline}\chronosdocidx[idx post={line caps},font=KeyFont,type=key]{timeline}.
7452 % Please use \lib{arrows.meta}\chronosdocidx[idx post=compatibility,font=\PkgFont,type=lib]{arrows.meta} instead.
7453 %
7454 % \Pkg{chronos} defines some commands without either marking them as internal or using a package-specific prefix.
7455 % These commands are of the following kinds.
7456 % \begin{itemize}
7457 % \item They use Welsh rather than English (\keyname[type=macro,no link,idx pre=use of Welsh]{\cs{byw},\cs{digwyddiad},\cs{parhad},\cs{gwybodaeth},\cs{theori},\cs{cylchtheori},\cs{prifdeitl}}).
7458 % These all use \cs{NewDocumentCommand}.
7459 % Should they already be defined, \LaTeXe{} will produce an error and existing definitions will not be overwritten.
7460 % \item They are defined only locally within the \conceptname[link,no idx,type=concept]{\meta{timeline specification}}.
7461 % These provide local access to \enviro{chronos} internals and do not use a package-specific prefix for reasons of convenience.
7462 % These \macroslabelname{} are listed in \cref{tab:enviro}.
7463 % \begin{table}
7464 % \centering
7465 % \caption{Public names for \pkgname[no link,idx post=internal macros defined locally]{chronos} internal macros defined locally within the \conceptname[no idx,type=concept]{\meta{timeline specification}}.}\label{tab:enviro}
7466 % \begin{tabular}{ll}
7467 % \toprule
7468 % \sffamily Public name & \sffamily\keyname[type=pkg,no link,idx as=chronos,font=\PkgFont,idx post=internal macro names]{\Pkg{chronos}} internal name \\\midrule
7469 % \keyname[type=macro,no link]{\cs{ceyearlabel}} & \keyname[type=macro,no link]{\cs{chronos@yearce}} \\
7470 % \keyname[type=macro,no link]{\cs{bceyearlabel}} & \keyname[type=macro,no link]{\cs{chronos@yearbce}} \\
7471 % \keyname[type=macro,no link]{\cs{celabel}} & \keyname[type=macro,no link]{\cs{chronos@ce}} \\
7472 % \keyname[type=macro,no link]{\cs{bcelabel}} & \keyname[type=macro,no link]{\cs{chronos@bce}} \\
7473 % \keyname[type=macro,link]{\cs{timelineht}} & \keyname[type=macro,no link]{\cs{chronos@height}} \\
7474 % \keyname[type=macro,link]{\cs{timelineborderht}} & \keyname[type=macro,no link]{\cs{chronos@borderheight}} \\
7475 % \keyname[type=macro,link]{\cs{timelinewd}} & \keyname[type=macro,no link]{\cs{chronos@width}} \\
7476 % \keyname[type=macro,link]{\cs{lineyshift}} & \keyname[type=macro,no link]{\cs{chronos@llinell@yshift}} \\
7477 % \bottomrule
7478 % \end{tabular}
7479 % \end{table}
7480 % \emph{Note that some of these \macroslabelname{} are also defined conditionally at the end of the preamble.
7481 % The local definitions described here are unconditional.}
7482 % \item They are ‘throwaway’, extremely temporary macros such as \keyname[type=macro,no link,idx pre=throwaway definition,idx as=\cs{tempa}\string\textrm{\string\idxeg}]{\cs{tempa}}.
7483 % These are used only very, very locally.
7484 % Any macro which needs to retain its definition for more than a few lines uses a \texttt{chronos@} prefix unless it is a variable in a \pgf{} \keyname[type=macro,no link]{\cs{foreach}} loop.
7485 % \item They are defined only if undefined at the end of the preamble, so existing definitions are maintained without warning or error.
7486 % This applies to cases where either \pkg{chronos} uses a command if it is available (e.g.~\keyname[type=macro,no link,idx pre=conditionally used,idx as=\cs{uishape}\string\textrm{\string\idxeg}]{\cs{uishape}}), but needs a fallback otherwise, or a public macro is made available as a convenience, if the user is not using the name already (e.g.~\keyname[type=macro,idx pre=conditionally defined,idx as=\cs{celabel}\string\textrm{\string\idxeg}]{\cs{celabel}}).
7487 % These \macroslabelname{} are listed in \cref{tab:public,tab:provides}.
7488 % \begin{table}
7489 % \centering
7490 % \caption{Public names for \pkgname[no link,idx post=internal macros conditionally defined]{chronos} internal macros defined if undefined at the end of the preamble.}\label{tab:public}
7491 % \begin{tabular}{ll}
7492 % \toprule
7493 % \sffamily Public name & \sffamily\keyname[type=pkg,no link,idx as=chronos,font=\PkgFont,idx post=internal macro names]{\Pkg{chronos}} internal name \\\midrule
7494 % \keyname[type=macro,target,no link]{\cs{ceyearlabel}} & \keyname[type=macro,no link]{\cs{chronos@yearce}} \\
7495 % \keyname[type=macro,target,no link]{\cs{bceyearlabel}} & \keyname[type=macro,no link]{\cs{chronos@yearbce}} \\
7496 % \keyname[type=macro,target,no link]{\cs{celabel}} & \keyname[type=macro,no link]{\cs{chronos@ce}} \\
7497 % \keyname[type=macro,target,no link]{\cs{bcelabel}} & \keyname[type=macro,no link]{\cs{chronos@bce}} \\
7498 % \bottomrule
7499 % \end{tabular}
7500 % \end{table}
7501 % \begin{table}
7502 % \centering
7503 % \caption{Fallback definitions for \macroslabelname{} undefined at the end of the preamble.}\label{tab:provides}
7504 % \begin{tabular}{ll}
7505 % \toprule
7506 % \sffamily Functionality used if defined & \sffamily\keyname[type=pkg,no link,font=\PkgFont,idx as=chronos,idx post=fallback macro definitions]{\Pkg{chronos}} fallback definition \\\midrule
7507 % \keyname[type=macro,no link]{\cs{tlstyle}} & \cs{let}\cs{tlstyle}\cs{upshape} \\
7508 % \keyname[type=macro,no link]{\cs{plstyle}} & \cs{let}\cs{plstyle}\cs{upshape} \\
7509 % \keyname[type=macro,no link]{\cs{uishape}} & \cs{let}\cs{uishape}\cs{itshape} \\
7510 % \keyname[type=macro,no link]{\cs{textui}} & \cs{DeclareTextFontCommand}\{\cs{textui}\}\{\cs{uishape}\} \\
7511 % \keyname[type=macro,no link]{\cs{sishape}} & \cs{DeclareRobustCommand}\cs{sishape}\{\cs{itshape}\cs{scshape}\} \\
7512 % \keyname[type=macro,no link]{\cs{textsi}} & \cs{DeclareTextFontCommand}\{\cs{textsi}\}\{\cs{sishape}\} \\
7513 % \bottomrule
7514 % \end{tabular}
7515 % \end{table}
7516 % \item They are differently-named replacements for a subset of \pkgname[no link,idx post=compatibility of \string\textpkg{chronos} replacements]{etoolbox} macros and tests\footnote{%^^A
7517 % They are a response to advice not to mix \pkg{expl3} and \pkg{etoolbox}.
7518 % Since I'd originally thought it was better to use \pkg{etoolbox} functions than create a slew of wrappers for \pkg{expl3} functions, these are the products of the resulting rewrite.
7519 % Despite my best efforts, the dependency on \pkg{etoolbox} remains, but usage is confined to cases where \pkg{expl3} does not offer equivalent functionality.%^^A
7520 % }, which are defined only if they do not exist.
7521 % If they already exist, \pkg{chronos} produces a warning and continues, hoping for the best.
7522 % This set of macros is compatible with \pkgname[no link,idx post=as dependency]{etoolbox}, which \pkg{chronos} depends on for patching purposes.
7523 % However, they may be incompatible with packages I'm unaware of or which are not yet published, in which case the warnings may prove informative.
7524 % These macros are listed in \cref{tab:etoolbox}.
7525 % \begin{table}
7526 % \centering
7527 % \caption{Approximate replacements for \pkgname[type=pkg,no link,idx post=macros with \string\pkg{chronos} analogues]{etoolbox} macros.}\label{tab:etoolbox}
7528 % \begin{tabular}{>{\ttfamily}ll}
7529 % \toprule
7530 % \sffamily\pkgname[no link]{etoolbox} & \sffamily\keyname[type=pkg,no link,idx as=chronos,font=\PkgFont,idx post=replacements for \string\textsf{etoolbox} macros]{\pkg{chronos}} \pkgname[no link]{expl3} wrapper \\\midrule
7531 % \keyname[type=macro,no link]{\cs{ifundef}} & \keyname[type=macro,no link]{\cs{IfFreeTF},\cs{IfFreeT},\cs{IfFreeF}} \\
7532 % \keyname[type=macro,no link]{\cs{ifdef}} & \keyname[type=macro,no link]{\cs{IfExistTF},\cs{IfExistT},\cs{IfExistF}} \\
7533 % \keyname[type=macro,no link]{\cs{ifcsundef}} & \keyname[type=macro,no link]{\cs{IfCSFreeTF},\cs{IfCSFreeT},\cs{IfCSFreeF}} \\
7534 % \keyname[type=macro,no link]{\cs{ifcsdef}} & \keyname[type=macro,no link]{\cs{IfCSExistTF},\cs{IfCSExistT},\cs{IfCSExistF}} \\
7535 % \keyname[type=macro,no link]{\cs{undef}} & \keyname[type=macro,no link]{\cs{Undefine}} \\
7536 % \keyname[type=macro,no link]{\cs{csletcs}} & \keyname[type=macro,no link]{\cs{CSletCS}} \\
7537 % \keyname[type=macro,no link]{\cs{cslet}} & \keyname[type=macro,no link]{\cs{CSlet}} \\
7538 % \keyname[type=macro,no link]{\cs{ifboolexpr}} & \keyname[type=macro,no link]{\cs{IfBooleanExprTF},\cs{IfBooleanExprT},\cs{IfBooleanExprF}} \\
7539 % bool & \keyname[type=macro,no link]{\cs{LegacyBoolean}} \\
7540 % test & \keyname[type=macro,no link]{\cs{CSFreeBoolean}} \\
7541 % \keyname[type=macro,no link]{\cs{ifnumcomp}} & \keyname[type=macro,no link]{\cs{IntCompareBoolean},\cs{IfIntCompareTF},\cs{IfIntCompareT},\cs{IfIntCompareF}} \\
7542 % \bottomrule
7543 % \end{tabular}
7544 % \end{table}
7545 % \end{itemize}
7546 %
7547 %
7548 % \subsection{Compatibility with Code from \TeX{} SE Answers}\label{subsec:compat-texse}
7549 %^^A BEGIN subsec:compat-texse
7550 %
7551 % The CTAN release of \pkg{chronos} is not backwards compatible with versions published on \href{https://tex.stackexchange.com/}{\TeX{} StackExchange}.
7552 % However, there are several methods you can use to update most \conceptname[idx as=timeline,idx post=updating from \string\TeX{}\space SE code]{timelines} produced using code from answers there.
7553 % Which approach is best depends on the specific case.
7554 %
7555 % I suggest four possible approaches below.
7556 % Of these, \cref{method:complete,method:no-chronos} are strongly recommended.
7557 % The remaining \cref{method:cy,method:rename} are for those keen for adventures in the typesetting hinterlands, desperate souls suffering in imminent-deadline hells and the perilously inquisitive with too much time on their hands.
7558 % They are included because most of us, at one time or another, find ourselves in situations of the second type, even if we are too home-loving and incurious to dare the others.
7559 %
7560 % \begin{chronosmethod}%^^A
7561 % \item\label{method:complete}\chronosdocidx[type=concept,idx post=updating from \string\TeX{}\space SE code,font=\ConceptFont]{timeline} If you intend to develop work utilising code from \TeX{} SE answers further, I strongly recommend taking the time to switch to the new key-value interface and \enviro{chronos} \envlabelname{}.
7562 % This method is the most work, but also the most reliable and flexible.
7563 % There is no guarantee that either of the alternative methods \cref*{method:cy,method:rename} will work or continue to work with future \pkg{chronos} releases.
7564 % \Cref{method:no-chronos} is an option, but if you are actively developing a \conceptname[no idx]{timeline}, the flexibility of \pkg{chronos} should make things easier and provide options otherwise unavailable.
7565 % If you put more work in and then find the code you have insufficient to your needs, you will only have delayed and expanded the task of updating.
7566 % \item\label{method:no-chronos}\chronosdocidx[type=concept,idx post=updating with retained \string\TeX{}\space SE code,font=\ConceptFont]{timeline} If you don't intend to develop existing \conceptsname[type=concept,idx as=timeline,idx post=completed using \string\TeX{}\space SE code]{timeline} further, I strongly recommend not loading \pkg{chronos}, renaming any existing file to avoid conflicts and doing an ultra-simple update so existing documents load the renamed file.
7567 % This is the simplest, most straightforward option.
7568 % Why fix what ain't broke?
7569 % If the code you have works and you're satisfied with the results, you need this package like a head needs an ache.
7570 % The only thing you should do --- and you really \emph{should} do this --- is rename any conflicting package you created locally.
7571 % That is, if you've stuck code from an SE answer in a file named \texttt{chronos.sty}, I strongly recommend renaming it to, for example, \texttt{chronos-se.sty} to avoid conflicts.
7572 % Then you can use \pkg{chronos} in new documents and just change the \cs{usepackage} invocation to \pkg{chronos-se} in old ones.
7573 % \item\label{method:hinterlands} If \cref{method:complete,method:no-chronos} aren't options --- if, say, you want to use this package for a new \conceptname[no idx]{timeline} in a document with existing \conceptname[type=concept,idx as=timeline,idx post=combining package and \string\TeX{}\space SE code in single document]{timelines} and you don't have time to update those, then one of the following pairs of definitions \emph{may} produce more-or-less the same output from existing or slightly modified code.
7574 % Note that there is no guarantee this will work in any particular case or, if it does, that it will continue to work with future releases of \pkg{chronos}.
7575 % It may, however, provide a quick-and-dirty fix if you are stuck.
7576 % \begin{chronosmethod}
7577 % \item\label{method:cy} This requires minimal changes to existing code.
7578 % You will need to modify existing \conceptname[type=concept,idx as=timeline,idx post=combining package and \string\TeX{}\space SE code in single document with minimal changes]{timelines} to use the \enviro{chronos} \envlabelname{} if they are currently in \enviro{tikzpicture} \envslabelname{}.
7579 % Then place the following code \emph{into the preamble} of your document:
7580 % \iffalse
7581 %<*verb>
7582 % \fi
7583 \begin{verbatim}
7584 \usepackage{chronos}
7585 \makeatletter
7586 % The following definitions **MUST** be in the premable.
7587 % They will **NOT** work if placed after \begin{document}
7588 % or before \usepackage{chronos}.
7589 % BEGIN \chronosevent
7590 \NewDocumentCommand \chronosevent { O {} m O {} +m D () { \chronos@testun@yshift } }
7591 {% #1 [<connection options>]
7592 % #2 {<date>}
7593 % #3 [<text tag options>]
7594 % #4 {<text>}
7595 % #5 (<yshift>)
7596 \digwyddiad{%
7597 date=#2,
7598 name=#4,
7599 yshift=#5,
7600 text tag+={#3},
7601 connection+={#1},
7602 }%
7603 }
7604 % END \chronosevent
7605 % BEGIN \chronosperiod
7606 \NewDocumentCommand \chronosperiod { O {} m O {} m O {} +m D () { \chronos@testun@yshift } }
7607 {% #1 [<line options>]
7608 % #2 {<start date>}
7609 % #3 [<connection options>]
7610 % #4 {<end date>}
7611 % #5 [<text tag options>]
7612 % #6 {<text>}
7613 % #7 (<yshift>)
7614 \parhad{%
7615 start=#2,
7616 end=#4,
7617 name=#6,
7618 yshift=#7,
7619 connection+={#3},
7620 text tag+={#5},
7621 line+={#1},
7622 }%
7623 }
7624 % END \chronosperiod
7625 \makeatother
7626 \end{verbatim}
7627 % \iffalse
7628 %</verb>
7629 % \fi
7630 % If you use this method, you \emph{cannot} use the key-value versions of \keyname[type=macro,idx post=method incompatible with key-value version of]{\cs{chronosevent},\cs{chronosperiod}}.
7631 % Instead, you will need to use \keyname[type=macro,no link]{\cs{digwyddiad}} for events and \keyname[type=macro,no link]{\cs{parhad}} for periods when you wish to make use of the new features.
7632 % \item\label{method:rename}\chronosdocidx[type=concept,font=\ConceptFont,idx post=combining package and \string\TeX{}\space SE code in single document with legacy names]{timeline} Alternatively, update all existing \envslabelname{} to use \enviro{chronos} as explained in \cref{method:cy}, if required.
7633 % Then replace every occurrence of \keyname[type=macro,idx post=renaming \string\TeX{}\space SE version]{\cs{chronosevent},\cs{chronosperiod}} with \keyname[type=macro,no link]{\cs{chronoslegacyevent},\cs{chronoslegacyperiod}} and place the following in your document preamble\footnote{The location isn't crucial in this case, provided the definitions are read before you use them and after \pkg{chronos} is loaded, but it is bad practice to define new commands in the body of documents.}:
7634 % \iffalse
7635 %<*verb>
7636 % \fi
7637 \begin{verbatim}
7638 \usepackage{chronos}
7639 \makeatletter
7640 % BEGIN \chronoslegacyevent
7641 \NewDocumentCommand \chronoslegacyevent { O {} m O {} +m D () { \chronos@testun@yshift } }
7642 {% #1 [<connection options>]
7643 % #2 {<date>}
7644 % #3 [<text tag options>]
7645 % #4 {<text>}
7646 % #5 (<yshift>)
7647 \chronosevent{%
7648 date=#2,
7649 name=#4,
7650 yshift=#5,
7651 text tag+={#3},
7652 connection+={#1},
7653 }%
7654 }
7655 % END \chronoslegacyevent
7656 % BEGIN \chronoslegacyperiod
7657 \NewDocumentCommand \chronoslegacyperiod { O {} m O {} m O {} +m D () { \chronos@testun@yshift } }
7658 {% #1 [<line options>]
7659 % #2 {<start date>}
7660 % #3 [<connection options>]
7661 % #4 {<end date>}
7662 % #5 [<text tag options>]
7663 % #6 {<text>}
7664 % #7 (<yshift>)
7665 \chronosperiod{%
7666 start=#2,
7667 end=#4,
7668 name=#6,
7669 yshift=#7,
7670 connection+={#3},
7671 text tag+={#5},
7672 line+={#1},
7673 }%
7674 }
7675 % END \chronoslegacyperiod
7676 \makeatother
7677 \end{verbatim}
7678 % \iffalse
7679 %</verb>
7680 % \fi
7681 % This allows you to use \keyname[type=macro,idx post=method allowing use of key-value interface in]{\cs{chronosevent},\cs{chronosperiod}} with the key-value interface in new \conceptname[idx as=timeline,idx post=key-value interface]{timelines}.
7682 % \end{chronosmethod}
7683 % \end{chronosmethod}
7684 %
7685 %
7686 %^^A END subsec:compat-texse
7687 %^^A END sec:compat
7688 %
7689 % \changes{v0.9}{2025-03-01}{First CTAN release.}
7690 %
7691 % \changes{v0.7?}{2023-07-01}{First repo release. (Ish.) Earlier versions were published informally on \href{https:tex.stackexchange.com}{\TeX{} StackExchange}.}
7692 %
7693 %
7694 % \MaybeStop{%
7695 %^^A \loadgeometry{safonol}%
7696 %^^A \setlength\tewadjust{\marginparwidth+\marginparsep}%
7697 %^^A \fancyheadoffset[lh]{0pt}%^^A REQUIRED - do NOT remove this line!!
7698 %^^A \pagestyle{fancy}%
7699 %^^A \thispagestyle{fancyplain}%
7700 % \def\glossaryname{Change History}%
7701 % \PrintChanges
7702 % \PrintIndex
7703 % }
7704 %
7705 % You do not need to read the remainder of this document in order to install or use the package.
7706 %
7707 % \iffalse
7708 %<*doc>
7709 \RequirePackage{svn-prov}
7710 \def\GetFileBaseName#1-#2\nil{#1}
7711 \edef\MyFileBaseName{\expandafter\GetFileBaseName\jobname\nil}
7712 \ProvidesFileSVN[\MyFileBaseName-doc]{$Id: chronos.dtx 11797 2026-03-21 16:01:38Z cfrees $}[v0.9.4 \revinfo]
7713 \DefineFileInfoSVN
7714 \AddToHook{begindocument}{\OnlyDescription}
7715 \expandafter\newif\csname ifchronoscodetoo\endcsname
7716 \chronoscodetoofalse
7717 \input{\MyFileBaseName.dtx}
7718 %</doc>
7719 % \fi
7720 % \iffalse
7721 %<*doc-code>
7722 \RequirePackage{svn-prov}
7723 \def\GetFileBaseName#1-#2\nil{#1}
7724 \edef\MyFileBaseName{\expandafter\GetFileBaseName\jobname\nil}
7725 \ProvidesFileSVN[\MyFileBaseName-imp]{$Id: chronos.dtx 11797 2026-03-21 16:01:38Z cfrees $}[v0.9.4 \revinfo]
7726 \DefineFileInfoSVN
7727 \AddToHook{begindocument}{\AlsoImplementation}
7728 \expandafter\newif\csname ifchronoscodetoo\endcsname
7729 \chronoscodetootrue
7730 \input{\MyFileBaseName.dtx}
7731 %</doc-code>
7732 % \fi
7733 %
7734 % \ifchronoscodetoo\relax
7735 % \else
7736 %\Finale
7737 % \fi
7738 %
7739 %^^A vim: et:tw=0:sw=2:ts=2:foldmethod=marker:fmr=<<<,>>>: