From aaed20c68e027acab82b0f62a5ed65b6d70aa11d Mon Sep 17 00:00:00 2001 From: arxyzan Date: Wed, 23 Aug 2023 14:51:09 +0000 Subject: [PATCH] deploy: 24c2b22c1da2481decbabcefd7649fae051d6246 --- .buildinfo | 4 + .doctrees/contribute/add_datasets.doctree | Bin 0 -> 2795 bytes .doctrees/contribute/add_docs.doctree | Bin 0 -> 2811 bytes .doctrees/contribute/add_models.doctree | Bin 0 -> 2785 bytes .doctrees/contribute/add_tests.doctree | Bin 0 -> 2776 bytes .../contribute/contribute_to_hezar.doctree | Bin 0 -> 2826 bytes .doctrees/contribute/index.doctree | Bin 0 -> 3289 bytes .doctrees/contribute/pull_requests.doctree | Bin 0 -> 2832 bytes .doctrees/environment.pickle | Bin 0 -> 236853 bytes .doctrees/get_started/index.doctree | Bin 0 -> 3197 bytes .doctrees/get_started/installation.doctree | Bin 0 -> 5359 bytes .doctrees/get_started/overview.doctree | Bin 0 -> 7231 bytes .doctrees/get_started/quick_tour.doctree | Bin 0 -> 18045 bytes .doctrees/guide/hezar_architecture.doctree | Bin 0 -> 43811 bytes .doctrees/guide/index.doctree | Bin 0 -> 3528 bytes .../guide/models_in_depth_overview.doctree | Bin 0 -> 2846 bytes .doctrees/guide/train_custom_models.doctree | Bin 0 -> 3000 bytes .doctrees/index.doctree | Bin 0 -> 3933 bytes .doctrees/source/index.doctree | Bin 0 -> 3491 bytes .doctrees/tutorial/datasets.doctree | Bin 0 -> 12337 bytes .doctrees/tutorial/index.doctree | Bin 0 -> 3192 bytes .doctrees/tutorial/models.doctree | Bin 0 -> 19684 bytes .doctrees/tutorial/preprocessors.doctree | Bin 0 -> 14151 bytes .doctrees/tutorial/training.doctree | Bin 0 -> 16701 bytes .nojekyll | 0 _sources/contribute/add_datasets.md.txt | 1 + _sources/contribute/add_docs.md.txt | 1 + _sources/contribute/add_models.md.txt | 1 + _sources/contribute/add_tests.md.txt | 1 + .../contribute/contribute_to_hezar.md.txt | 1 + _sources/contribute/index.md.txt | 10 + _sources/contribute/pull_requests.md.txt | 1 + _sources/get_started/index.md.txt | 8 + _sources/get_started/installation.md.txt | 25 + _sources/get_started/overview.md.txt | 20 + _sources/get_started/quick_tour.md.txt | 151 +++ _sources/guide/hezar_architecture.md.txt | 220 +++++ _sources/guide/index.md.txt | 11 + .../guide/models_in_depth_overview.md.txt | 1 + _sources/guide/train_custom_models.md.txt | 2 + _sources/index.md.txt | 16 + _sources/source/index.md.txt | 8 + _sources/tutorial/datasets.md.txt | 59 ++ _sources/tutorial/index.md.txt | 9 + _sources/tutorial/models.md.txt | 135 +++ _sources/tutorial/preprocessors.md.txt | 70 ++ _sources/tutorial/training.md.txt | 112 +++ _static/basic.css | 925 ++++++++++++++++++ _static/debug.css | 69 ++ _static/doctools.js | 156 +++ _static/documentation_options.js | 13 + _static/file.png | Bin 0 -> 286 bytes _static/hezar_logo.svg | 25 + _static/language_data.js | 199 ++++ _static/minus.png | Bin 0 -> 90 bytes _static/plus.png | Bin 0 -> 90 bytes _static/pygments.css | 247 +++++ _static/scripts/furo-extensions.js | 0 _static/scripts/furo.js | 3 + _static/scripts/furo.js.LICENSE.txt | 7 + _static/scripts/furo.js.map | 1 + _static/searchtools.js | 574 +++++++++++ _static/skeleton.css | 296 ++++++ _static/sphinx_highlight.js | 154 +++ _static/styles/furo-extensions.css | 2 + _static/styles/furo-extensions.css.map | 1 + _static/styles/furo.css | 2 + _static/styles/furo.css.map | 1 + contribute/add_datasets.html | 306 ++++++ contribute/add_docs.html | 306 ++++++ contribute/add_models.html | 306 ++++++ contribute/add_tests.html | 306 ++++++ contribute/contribute_to_hezar.html | 306 ++++++ contribute/index.html | 316 ++++++ contribute/pull_requests.html | 298 ++++++ genindex.html | 279 ++++++ get_started/index.html | 313 ++++++ get_started/installation.html | 354 +++++++ get_started/overview.html | 323 ++++++ get_started/quick_tour.html | 492 ++++++++++ guide/hezar_architecture.html | 540 ++++++++++ guide/index.html | 314 ++++++ guide/models_in_depth_overview.html | 306 ++++++ guide/train_custom_models.html | 307 ++++++ index.html | 334 +++++++ objects.inv | Bin 0 -> 626 bytes search.html | 287 ++++++ searchindex.js | 1 + source/index.html | 310 ++++++ tutorial/datasets.html | 391 ++++++++ tutorial/index.html | 314 ++++++ tutorial/models.html | 476 +++++++++ tutorial/preprocessors.html | 403 ++++++++ tutorial/training.html | 475 +++++++++ 94 files changed, 11905 insertions(+) create mode 100644 .buildinfo create mode 100644 .doctrees/contribute/add_datasets.doctree create mode 100644 .doctrees/contribute/add_docs.doctree create mode 100644 .doctrees/contribute/add_models.doctree create mode 100644 .doctrees/contribute/add_tests.doctree create mode 100644 .doctrees/contribute/contribute_to_hezar.doctree create mode 100644 .doctrees/contribute/index.doctree create mode 100644 .doctrees/contribute/pull_requests.doctree create mode 100644 .doctrees/environment.pickle create mode 100644 .doctrees/get_started/index.doctree create mode 100644 .doctrees/get_started/installation.doctree create mode 100644 .doctrees/get_started/overview.doctree create mode 100644 .doctrees/get_started/quick_tour.doctree create mode 100644 .doctrees/guide/hezar_architecture.doctree create mode 100644 .doctrees/guide/index.doctree create mode 100644 .doctrees/guide/models_in_depth_overview.doctree create mode 100644 .doctrees/guide/train_custom_models.doctree create mode 100644 .doctrees/index.doctree create mode 100644 .doctrees/source/index.doctree create mode 100644 .doctrees/tutorial/datasets.doctree create mode 100644 .doctrees/tutorial/index.doctree create mode 100644 .doctrees/tutorial/models.doctree create mode 100644 .doctrees/tutorial/preprocessors.doctree create mode 100644 .doctrees/tutorial/training.doctree create mode 100644 .nojekyll create mode 100644 _sources/contribute/add_datasets.md.txt create mode 100644 _sources/contribute/add_docs.md.txt create mode 100644 _sources/contribute/add_models.md.txt create mode 100644 _sources/contribute/add_tests.md.txt create mode 100644 _sources/contribute/contribute_to_hezar.md.txt create mode 100644 _sources/contribute/index.md.txt create mode 100644 _sources/contribute/pull_requests.md.txt create mode 100644 _sources/get_started/index.md.txt create mode 100644 _sources/get_started/installation.md.txt create mode 100644 _sources/get_started/overview.md.txt create mode 100644 _sources/get_started/quick_tour.md.txt create mode 100644 _sources/guide/hezar_architecture.md.txt create mode 100644 _sources/guide/index.md.txt create mode 100644 _sources/guide/models_in_depth_overview.md.txt create mode 100644 _sources/guide/train_custom_models.md.txt create mode 100644 _sources/index.md.txt create mode 100644 _sources/source/index.md.txt create mode 100644 _sources/tutorial/datasets.md.txt create mode 100644 _sources/tutorial/index.md.txt create mode 100644 _sources/tutorial/models.md.txt create mode 100644 _sources/tutorial/preprocessors.md.txt create mode 100644 _sources/tutorial/training.md.txt create mode 100644 _static/basic.css create mode 100644 _static/debug.css create mode 100644 _static/doctools.js create mode 100644 _static/documentation_options.js create mode 100644 _static/file.png create mode 100644 _static/hezar_logo.svg create mode 100644 _static/language_data.js create mode 100644 _static/minus.png create mode 100644 _static/plus.png create mode 100644 _static/pygments.css create mode 100644 _static/scripts/furo-extensions.js create mode 100644 _static/scripts/furo.js create mode 100644 _static/scripts/furo.js.LICENSE.txt create mode 100644 _static/scripts/furo.js.map create mode 100644 _static/searchtools.js create mode 100644 _static/skeleton.css create mode 100644 _static/sphinx_highlight.js create mode 100644 _static/styles/furo-extensions.css create mode 100644 _static/styles/furo-extensions.css.map create mode 100644 _static/styles/furo.css create mode 100644 _static/styles/furo.css.map create mode 100644 contribute/add_datasets.html create mode 100644 contribute/add_docs.html create mode 100644 contribute/add_models.html create mode 100644 contribute/add_tests.html create mode 100644 contribute/contribute_to_hezar.html create mode 100644 contribute/index.html create mode 100644 contribute/pull_requests.html create mode 100644 genindex.html create mode 100644 get_started/index.html create mode 100644 get_started/installation.html create mode 100644 get_started/overview.html create mode 100644 get_started/quick_tour.html create mode 100644 guide/hezar_architecture.html create mode 100644 guide/index.html create mode 100644 guide/models_in_depth_overview.html create mode 100644 guide/train_custom_models.html create mode 100644 index.html create mode 100644 objects.inv create mode 100644 search.html create mode 100644 searchindex.js create mode 100644 source/index.html create mode 100644 tutorial/datasets.html create mode 100644 tutorial/index.html create mode 100644 tutorial/models.html create mode 100644 tutorial/preprocessors.html create mode 100644 tutorial/training.html diff --git a/.buildinfo b/.buildinfo new file mode 100644 index 00000000..a5df2d80 --- /dev/null +++ b/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: cdec0220fc6fa5a0b01e3d9fbaabfd7d +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/.doctrees/contribute/add_datasets.doctree b/.doctrees/contribute/add_datasets.doctree new file mode 100644 index 0000000000000000000000000000000000000000..dff2245c90261659cd037a44744ea7250273d420 GIT binary patch literal 2795 zcmZuzOK%)S5RT*Q+Pn6yA9;Y37!sinB5ZF2IUpns2yPZWAjBK4;{FitcKMFlV&#m?*V=>% z^A7LwjaQNPLdOXw+0scEe3|Eu>Eo}dqn5eY=-v5_&65As<2SJms9RFFhx%UVkv3kw z9=c7Kr{Rtiip5hurlC)rGh*x=o|m4pE^?bf-^e7j7DB8$iWc>1Gxz0UGp5;@VUwie z!-k{NbQJjxfA3_CAA~PPTo-I)yi&}J&b2ukarP56&0mCON10ZQ`w_BC^7^UvxX2@a z$hY|;zK$sQ`v{FcK_~-g9nqskFH-)&D+E1sZ1%|ybVkHfX@f!x3+niifbplzW#n^l z`56-b9KrLCdA|;tAHwbWs@voxS>VluHkJG^+;fI1D`_e#DUF^QX6saToOV>klUt!b z*I_xfKKWYM3~uu>aG zBzw(}zT2VCscg5Mu*YTsS##8RJ6Gz2PR_=D3U|YEY80{t4Z~;wNe}7ISb9|aH4KG9 zjtEnk&Y=}U&%4RdXGd0G{pk83Va8}fI90i11{qJGW-f-EI@3#5I+c|e4pvT9OmGs0 zwb4ZY^Q(`pAFSLAyXgS{n&rrk#DmZclB%hvQ-*Zs*x$z333m<4v_UVi5-@=q0gRl6 zE?RAZHzFM(2T<8W%p&iGA@xp^g(%z>z}6u5MM+xxA*+=@0D4AInGEh!k_y?W_6t#I zna?$u6$wwfY*uQ^$nwn!BAFwvg%veEcStTQ9n18PCd!R@U!cdf@feFvsG1B$2aOt; z2w4xN2WbT-mYJ#%nM&4j)O!o_8Fi|+z~^3SF2F`jfkG(?;o>*D&%&@|B|%acS~9B= zww)wnOkR>YBfQINfzcmoSRS6DdF{unPb7+r1F98A8}VmIO{n&MhoSR$CJ%)06-R`?alT9#Fhym zS7Fy)D2K_&#gt3@0=##mPPpH;1x1(r=+V>`iMm_u>n)KwqfKfLGENZ>3ST!HvRtJQ zx6gbD7m4L6?rMg>70{zIp(enHMNbq7yi(J;6%#L=MPQ~FvmE_y(#j@+erHuxD6vB3VeQkJrXQqL&B!2>zw8o+ z&B^5dKIoiZ5<&dI5BMQou(yb$5US#7{%8H|!8>8?MeFay!rwnP`n$o>O&)#NzxL3Y z?{7}Z?>C0`w@-PW%rAy+8aBw`B|a;XuwL_*d}Ko}3EV}AT3$x}^2+ij_&?&?HVl?w zUELmJ0?m;M1&g&LO|Q9LUC?Dot%owB4T`arZKqVK_f~|hcJG?S-rQ?-Y5$siu#jGRY~(}e4Oo>-t6nCW{a^ot7%+LRvO6PMACkN*Qr5?(<7 literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/add_docs.doctree b/.doctrees/contribute/add_docs.doctree new file mode 100644 index 0000000000000000000000000000000000000000..e3a17f5adf944b92f849b1e5d0c67bc48c5984db GIT binary patch literal 2811 zcmZuzOK%)S5RT*Q+Pk)QZRY_}Vn~ESh_Jm85e;;x&>b zI7Gry-_l%o`~&!J`~<$9nVnrPwq$#{rn(+qeN{C-cYgb~f2;ZlLtAp8X2&$omCl)s zVKdj6FPL)iU3~sayo{fOo}uSfdy}ykZb2jCLgt34_&SC`Qg=eyl`~@O9eeEbw=ApSBja@xi)7b&VHh%`HRr(C~I>a0q+#9JudRdAM$Pf zh_53;{vq(@PY}lbLixz)qof-t|L8T!F>q}5*$;F^#8hd6nhXl+_>zF}r`IhcXd4U9 zP>AP9fq%;Tb?E#M0j#eEkX$7*yt&W<$`8XmXQ;B0rZSV#=&5102DIa}qcWb{3jMhb z%W?F{-&z=C-lTGowm92!NnNC{X_<3EO+myxL|ij#VgMXdc?{j}sr0B$OU`GU+Q+7uCzfd#8dlIbG#jfKgFwS-AlNyxcyoXklEkIjXKb*Ew5uu>aG zBzwaE-|f)nRJO-X*kdyR)Esr*&Xqc$le4j(!rkDU8U@s#VHhnS=>h(XrKIAoVIUMR zB1~mEhgJ+d?dmZ+%+uI1|7vp&;)J-IC2`g z=%ER61RNp6%vFL=V$zXJ+Q6m!} z>+$p;J;8}(rfNi{lC>Q5-om^_o$4d_xtE#?v{6&AP>Mph_|5LKFeq6`0187(W))!D zNiwF0J#|KSpF3CDuSO$??QwbGxK_v7Oh+-?PnuN#&?Jr(D33!qHX%QH`r;+<9GFSA zVm?V0=0BdBN2k)n*E4301#^?i2fBa6T_NGD=ja$Mlsg_zHp2l3S&+6j+XRR$6GN`T zuDwtWy=s>=L*NSR(V0*aa9}}vTZDJQ+KblTi-o^`ZuED9rJFqZuzxMl zdh6c|%I`OZ_qR{DPv#dxHw_zLc!`gTB&?tLOFpupmjv#jL|T`Tzr3>i3I31xwhcSW zw61RNWCG2R3I&U`Bu%fmUR}^-Nv(%6qYa9&mTjk0s`plet#aeQY7) z(%QSfYO8sJ<&W7~F)3}3txQV^3L*zA*Ns<+VUWK=@^9m}m=pMf!^FWymqlmP4%-oX rO}y2LD{^lMl}VqcW|}5m_w%#`nt_?VXF|WYuvnYY<9p&V`tk99cn4-3 literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/add_models.doctree b/.doctrees/contribute/add_models.doctree new file mode 100644 index 0000000000000000000000000000000000000000..4cba94f7cc610e198a6fe073bc0ed0044f66f1cc GIT binary patch literal 2785 zcmZuzTW?%75N?|8Cc8;CmtH_>1FcXg6-l;&J|K8PJVwm}LcCR$_t?8O@v#rSG#jKy z@KA|Jeye%m@(wbs~lQKWk9hEGJhhkGa z603+&e2Bor69lpWokMz9Yb7c^dX0bwo=-pffli5>Xk$@;K}o$>5ODFdy^1`}u0BJ$ zpCfGXspvQ1iUYV@U3Qs$G)Rc&vZD$ zHe`P*aZm)COGM@c*_=t5!o+pQy_b3dxb4pIGqy+;*DS^E_f!Q`WDdZt3BC$Gorvv| z*qd-9oO)vuHjJXQo|Y9h8;wH(FQ?e{+ikE4yDe`Dl1rLT;kbhc?RkoOV`IEFo-Z68 zuf(kkV;xE|9UEIFNCpn2tVm(X+#L=kA2t%Mcr77k(hD*J7Cg2WTBM!CP0K4|JyHA( z(0+V7_61e*Z71&XsYKR1^})@QIK;p%L`)}VY~uN;6?%?C$Wnr z8{>^ghhzXMAIoVH-8i7Z8*(Lzw|FaRQRR4G zhD^(hryV}6jN@eSW(|?TlQ+`I2A|u6Nk>O2KctOvZPpj)u}wV2p%dyRgVC*4jf|yg zM$&`4f)mGW-H2RgYYg??z*I(^nl13To0|);(G#Fh$x{0CYUf!TRJ z{Q_F2gqKt*0s_cWwhnu@B~pM@jhmTv8CSV}lbJ29H?suI3n)s>B$~q$Pwj+bHh~d# z5fq^1LC%=pEb~|N z<@X!I`#a>kk7pNSHxC=+@B$wcS=g+_OEGk@mj(X3LM<6Z{{FO&7NoVO`(e zDkPdC7YY^|NuFLay{4dxl12|@MjMnPqvoAbtKM4@&b52jEcRwz>q~pr?1P1@&$M@c z*;ac3^2cngk(3!^qcBPVf_MYSb?uvsFv#EG@o&?&m=pMH!^FXdmP2PW4(B8Gns{R_ nuED(_b)f>w%{0ll?z7AS?ZC|6GqGQuJJ6;I_@1~(VRZB#kF;6@ literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/add_tests.doctree b/.doctrees/contribute/add_tests.doctree new file mode 100644 index 0000000000000000000000000000000000000000..03d448acf147b7d5f953a3e963d19f582c535e3e GIT binary patch literal 2776 zcmZuzOK%%D5RT(Wwq#p=LZ@?ce^b`X_F?N=Q9Dq>O39xJz-J znIe>2`}83_|0P|dFJjNqGiQP=c#5~cQ3$D+OF3 zQuA~iMl|-R_g0RAM_4(GRmog-d96^?IS_H~Xj(R>br!0t%ZL^ymX9+}h-;os@>3Gq z;*+Blu^-;a2Ccaro*8>G6#OS@+rMzl4GW`N^Fw5pzzgpVOP0h#u_+#jRk$cV zgZ_`9Vp&SRiomv=w|j6MTj&KZnQSOVMvU z6)#|Jb=h3DkflW{FwdWO5$}0RwNo_LkW|)8EO$-*I^KAy($THhpYd>pYsmIi;-CmN zSBK1Nu{onOHHqtvdoT3_DBGRGW^9osu33uR@2LtX#vFHD6MPkXIu_fd~&^M%KwmAIABt3yeq zV`Iw%%D|zD6)8-ao5Dfm!-m2YuPNkAdO>EGg2h=(@jw7fFb6U9$C(sw)d1y%EF zC+_m8MAkg@!OfUDvBUT%Oki$sMy*EHz+pKpLFpm=1L8;(BKWZBE{Ph*xF*DtjHXH$ZAcHfS%PeO6;&)wWyfQ_C2g-Vvvr*C(j#X-d@f~0V?WKkz|~hY{mfZA08R|966NtI$2#Z-PhY-9J_mMOEUC|wEA^kx)T2{r z#_I{Uhm!koZ3Epu6uwk2*7J0P7GhqcqxHBCK$c|QoAUsOt1?0^ijsj!#lgbSl3K3Qh)DnpxA%**H`0W;-@GxYB{To9al7`b17>xA%t0nm_G761SM literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/contribute_to_hezar.doctree b/.doctrees/contribute/contribute_to_hezar.doctree new file mode 100644 index 0000000000000000000000000000000000000000..01cd0d34d6dfed4137f827d12eac961a824a4071 GIT binary patch literal 2826 zcmZuz-EUhp6kpdRZPGUB$2O3*!X`Av#M(@-2gK`mK&t2iLcC3ubFUMd`q~$NtSM3@ zc$h>bzsYp$3J&|`?r6q`h=k^xlprXn&(RA%*L>p z>&zESx%e(V`z2n+PeRYobF00{SPZwok#Qk&!&H17!yvIcA?UTNiw7<S&tl3EM@vF<2Z)T_HdGb2j41o#q#&*-_SdyR;-ulZx}W$RmHixA{Z9 z4rBR;2tI!diw+j|j+{QKm?PyMy+(2dj?F&%fzF7SDs7OVK|vi~A~62sx`-6$xrnF8 z%QN`HKjr<}5B?k`tgo7obR{{wxzI+JKM!}Ep~^~{vQA2)r-s=&x*ew-mGR_O=+Ajr zj;&An*1{n3CgqN_ncALH>Wqa=%bXKx3S92BK${puk*Pd}?)OxBq^d<~S9@1_7f<={ zH1wtnnV?Rah)qr%vyK)eHe0nq0xf6Q_M5FY61yFzGm>(hPNBF13(Z9g`xC95(vB@1 zo~(tPgm>i&GMi{qL{J765GzThi&RDyA|KQgCRs%x=fZI^M;tUZ7a9njhHb-2Z5)y8 z4MX^Dhd!sW-FCtrn+ZhCQRnTPsS`Rm8~Z8L4bG`ih#EKyqXj5Egg;}+srYLc2!$9C zrZSy_D~6tTlcO(=tibx=^+Upp(S~rUa>)!Lo=nYL48uCoOHw+Olo$?IPF6&45(c%< zg#q)c53e7r+zh+P0RYW%#7DxR7jI*Q?5;;ak+CvmJmdK}WR3Hs5K7cUXdfth40 z;uB>d{^PlLR4Pq)J!9rrFgK}mp!!GL6%xvNj*d}6x#RI=CT z+6(2-AGw%vi7&u=N9u(8ZCg-O*^eGYZ4s!0YF}@O)ER9;dzf(wdyx3L*bwC^gt&d? zOQ=Xguo`Vm6Sx9;bSBgU7?^j3{nRI{AFuF@a#HuStFX@0n>6ymX5C9rynv!mxj=C^;;5N2^d?M( zJs1UOIZSc%?>r5-H1vmWcE`Ez)%x3HuT3NHoN@@M@t;hnJdqSg0eq3@p?_1z%pCXGJqUvsp6 z0^A&w-)}VUZ=d2mnO_Xu)NByLOT07^v0n3+d}Ko}5!^)yw=N@pd1d)y{Ezsy4Li%Q zu5RyS0>zOM1&K8!b+0*JozP`U&4)Cj42rRqZKYJKcUOolcki0S-dt;SY5$shOd;da z*t@qXt2x2&M{li=lqSelrlkY~;RA;2#;b%d(BHxNxA9x_3B2dfaqt4OsEk@++hVVg qw_0)q?k%A*>GM=f(}e4Oo~A(4Fw=V`^ot9Nu_-;?6PMACkN*S9Ic&%P literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/index.doctree b/.doctrees/contribute/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..fdacad758e0a3e14f8f42cce33aa438fcb3db5c7 GIT binary patch literal 3289 zcmZuzTW=dh6mFZ^u^q=rdI6+1MFGO$?*N?u4`_&HHW3GAFcZpYsmy z^6hWp5$}hN6Hc>@u1ebSoBw?enE za1yRdp;(;wDGdYa8sWC`WJ}~WS-qV}YAxKwcSq5p{_5qvTpgw~J2h;UczoD)be^sv z-{bclU*(74{V~@C8yl|_GvhODPRE>mM@{oDOta&x^=&Lv&K4&{9{C+Udmzs=v}hx`FjzlHpb0WH3s zgRs}6>iEpivScRG^|Yk-$IHAg<@hOUWrV>h3V4dF9)*!(i+8`J3nJ!98&uw?ppLH* zSW>a^vcW-8IH++7qwnyo8gQ45UbnEV9{wQQa)v4^X$mAMjh-83>+0z^?WnAy)$mlo z^GV;;Fv`41wMp7a94;w!MTQ=b;)I%`%^b9SV`fk#3?&e{UsH+Px3v(u+Pl)bIN^Jf z(4R9@8g<$Lp?%;ED4|7(!%nS`K+7qPgXZXs#Az3)A*q(rEfjZBUe9B=G1J;9?bzDo z1qYdFyc2#3f4R5Xc2L4bIAc)>RgppHZo@{F zjV`>DzM#Z1QxzgpNm`D4@1Qp!PxTS_JV?a_*r+*BC`BP${9^yjFe+JzW;#QIQ&|%SgAlsAj+;Oc=w3&}%xScpF1HeffE07+{=g1wb?pAY?%;p z5%%r5a%hWO%(=u5;Jq$&!u`+|6jk=rqo^$cb+bCxMlqRbGfrU-5?>b^qFjX# zuTOmm6=|ob#zE5rFgrjIY6c7}yTXmsC#;`t@QEUUS87_9Vp>H`BQS$OlcRpmVFG8& zLCNh5T&IK;R7ip$o4Rae_Cd2i0jzRX_q2t->x%u%Lm;V zK2?=7(Xc}hPXTqR3w-}q!W1n~){q*EN7P%$D literal 0 HcmV?d00001 diff --git a/.doctrees/contribute/pull_requests.doctree b/.doctrees/contribute/pull_requests.doctree new file mode 100644 index 0000000000000000000000000000000000000000..fda0f6513902ae1a6a68bd0408fa5e0c3ad0b65e GIT binary patch literal 2832 zcmZ`*TW=gS6mFXCCY#G{lC}Y<4WvS)R5aNNI0>oQod1t(96OTRhrP&}w zf`>{(@>|Udmwy2Nkj2j0>3?rsAs@`ib2MX^$KEHOn$5v}(n9hj;nf ztH^ty~T@yw5C*r3iCG4c)prvO()Zc{L8nWWZ&i0_V~Mg6s&`*MC5(d^u? zapLh|&CyA^ihRI7I9=ff;maY{1sfW#6f?sMZO(_B{X|Xk7p~c1rd4BpSR!a*>Y(j$ zkw^ZBZ}G=`6>jnm;TwMfU-oUCr6YQj1dbYkNcl&v;C|n+>1RLEDG?K;4T{t+sN)L+ z#-A=|L9UaQ!?~7csLpf5!$0L4bsYQ!99dmy|kOkN};#E!@TiSwvc5=>9+@ zK-0o1bhUS-ckzr5&O&d(Pzma^i8$mGHFvZqaoDU45?DFMaickUBXQbxIwPsp=@y1N z@X%bwus7D)Dec(8<>^Y;PN-MDAk(onMFgd9QR9+ix=77rq4H5pVUkr8av>ZiGsMAS zBhWzbENmH8YU7AxZy3^dH*9b!+hZr}vZ+AU9ChB#m^z`8vyq>`T>pX^g{*!VJg$90b}TSH$M9O$O?QvzIjQQG1?GLRW6x9#*?d=i(yb_dO=I4 z(h|eL(#?_zPC~y{I(J|u`uOI>l4RIP0RU*0BR>)W#jq`@ns_>4NOz9&UCgF%->^)Z zoaC$oOkhR;BWIzD?i(XUq(kHYDjSPw5dL zg@cMxAv@K6PAV<)xhB&h;c16WOKllhl&m03=sXhXqyQ#SV8#Mt6r6`1pU++8% z{gRa!NMnYU%<KCCZ4x_tY8TeePUozZecdw#VhA<60eSGa1J4FmYB6fRi{@pga!c zSO@*+>B|%3vv0=PlKMoMtN(bW9-T@PUeB317R-$+8|eNacZGzpo}(kQQ0{mqkp`qDbJCn%1qDR@Hd~ zW{MHZ(Z82)fivb{t(0e^uAcITcHLRG7q|5-m!cqgp9Z0)_A+xzEM zd$(x1&7u!`Hv+An0JkUQ_gmfj+o!ybXM&-dh7EFfg_lMm*5CYu4{hirg1anH%d5yw zt}TCp|3kiI!}cPqE9vb_pgB^Zps}W;={4i43%W?D`A}xGK{3*@?Uai3!4k3M?%mMX zn^~=d_HO9M7BViay@$)Xnj0*C%+?A?X@hKLT1r3=F<`l_eU%Uf`a1;wHhzmaf%hCH z4qjjuolzTXN9+yqW=pQXy(v^CeV&?Wl5o9|r!CM7%=DfK8^xu?+LRveiL2;G$NvK4 C2W<`j literal 0 HcmV?d00001 diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..4297b258daf3db56b94cf5c1735b93ca4635b6aa GIT binary patch literal 236853 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 X(&K`|On@g}%~`Yjl$2}LiNya0r_sGj literal 0 HcmV?d00001 diff --git a/.doctrees/get_started/index.doctree b/.doctrees/get_started/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..0d634fdbc1221be8ec8c516ae2773505f253440c GIT binary patch literal 3197 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 z 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 J$mPA={{X-2cQF6} literal 0 HcmV?d00001 diff --git a/.doctrees/get_started/quick_tour.doctree b/.doctrees/get_started/quick_tour.doctree new file mode 100644 index 0000000000000000000000000000000000000000..5e2e2093bbb1d5ce6d99908a71506407ce47ec4b GIT binary patch literal 18045 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 ICOX|y37|Sw6$+04dQb^ijk_!7~cV~Cz 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 Kyfsdn_5Tk}x16c~ literal 0 HcmV?d00001 diff --git a/.doctrees/guide/index.doctree b/.doctrees/guide/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..68bafc0506192436619f71390d20f59b35a500ca GIT binary patch literal 3528 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 HesuINX>)Su literal 0 HcmV?d00001 diff --git a/.doctrees/guide/train_custom_models.doctree b/.doctrees/guide/train_custom_models.doctree new file mode 100644 index 0000000000000000000000000000000000000000..775ce78f6da427d0310a24f648093288d4a94eea GIT binary patch literal 3000 zcmai0%WfMt6pigjw)~JEN!$X7QwK$w1dXkr=pyJQi)3d+iz4VQAgCcFvYsKQe8h4A z1MMO}4R9CsC)(x@+JEcej5Lx}2MwTjczJnWJm+5i()#`5#*OM<*tVsRYJ5x?Q<`xb z!y40>FSv5?LwxdUyoirO$IvsYy~%hCH=vOTnKQ#xd>cbIsXLk5op%{P3UBKf4=`&h@=E-4~% zQS62eX;Kg?p*@MbA8zJS@!0nR8rG?EMh?6~#wo)U$!yAIHOr~B5aPR~Xi6!*l6A0Yn@(xM|nOEF)xgIBO}nCT+b&1$Wl9$H7w51m(>J*aE9 zAO1&cQaQNmC3oVWFYc$}h%ZnP@c`xj62FJ|J;Lt^vK3#8BV@TO4#d-0l)O0*_N$Z- z)KQ()QJqz!$<*V}b$tBIk917rNNEEwbqngmoPZ~HGb@L+mBYr$Tp;UpxvM}{>T-QL z@&*LrX}FCTmCb3wC@GB|8E$J3w48P{k0&?6`c#KAEPYCRDReV$62wRYsLiRQ23Ab2cRKu&b_OA3U_QiHTbVeM2p-!8K1*3qbqeY3uM(vQm z%PE%YlchH~R$ESIBtbIm!f^``n)4X;hFUwN9iQ7gSqfW;oyr$vJk+L$kaR7WP!fPC zk>0}O-CDwPUP;KAbb?HY0gsad6Q=aTrs1VFj^z9uNBNe+x}bTpY=vDumZ+Me&fBR{ zE3_CN_z~Q7&!|Za02+qV0+J5OpYfDb{4I2)LX8MlnP$+6q2t}~==qVA_`Y{_lW=3S zA%ZHFbAyVfP%{_9c3tT?E3L{(3n9KUB36NI=ghihkM;+m)n3cDnnSsI=TOO~ysS(+(e(+Hx{~vVutF$UA9e zjn8euq@{yAB{GR}b;=8HY!k^?FrgwDjBZWT$WZ2WOWjXjaALWsh{#p4#&F*o7&f@4 zdI@~)CUOBbY6KMKvXCym-gy+dB`*nz!a>QbD%fU{3@Bnx%m|+g=SursuLrR`F3+9N z>R6jmFNQlwvkCy3#PI^x<8U2okRLsK_ATn!HN$Mde3Hz}e>F7^rqYDhQ*MqWcf-mD z*xwVb$l3 zd#O)YKUmO{MFMZGX-&m6QBNZqV>>?;Y%i+y|{>{=HP6K=!gO+95 zD|eK>@P6oo&lXkj&RBSvgr(=xX^F3TB4VV+Zx zsvlCK6_%bg{+`YJ{d29qYb;&o(TBY&iPkTb>x=Towc-8kQ{9KtgQ1<84QhCS2T>B% z-{O^cVM8Yg+*1O~ zgJPibhAEZm?FC_@-MM11Gxb^>+Ph*OQ^>e9_U9=7Ph3PlIQ|!p^r~b4 literal 0 HcmV?d00001 diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..9906ccefc5df3dbdd1bc664f26c446e7a7b06351 GIT binary patch literal 3933 zcmb_fU5^{L72OX@EA48fT_<)6*z3qJQag<$<)aTpfIJli0xYVBplDGP>42J{M0z>H z3CZzl0~kmiQgj0Xc?kQ^ztW%6|Im-e9+ESXR$e~@tpRywF3C&Y%X7}X^L6X5pAUAz zKReJRkl+d4VT4gIcu>tJNUvqV_n-a+z7fcWFP;Yid5!wXyouS`V~=6^{_bs@qQjV zzZh%p{FW~Lq3o0GCI9&PZ?7%-*2S~8OM;Uc$4+fGX&gJYZ`*Z5Q+r47g1TunBleIO zqxh^c$b^r4pJ&=fd5{XCHH>&}6(o;OovbR?FEf%}C_49ZDtlna!Vft%V2{ps*_nNR z!Vu;}RYgJ7}<*&`6RJ-kQw$Eck%?kckz3Q-+PFfz0XF7 zc8{I0=Nl1>BaB$f{`xbj=*%msDL1OHNaY;}3Z;mqRj>l^GHthKA80 z(IpV2F%$tZj)1uT|MIqu^V1&}=bbmk`RSCr-@*X)!vG$3&zX5lvR;!05Fo8?EvaBHHvPsx*mHIP}l?8 z3Qz~J5V7KcPS2+HbU{s`4N-<>kqqw7Zfg6cGExE88@8iG#WT8L=tVwnSWbLKBb!%N zYJ0p$MU~Mx7jauASiwrBn4z|llVwIr!`%5ENKeY3WRQr3kTZ8}+l*%!gzwrO*KSsZ zPEqAEz&ms2JN7W>oR)>S!rVjX=Q>VLlRt$NKRWM#CV$-KlpWL=9bJO-B~^}W)9eoo zy&6B&jIMZT-?@yMIx=z;G)9ja;KiCab*B4TdqIU&`R zPv@@fr5@X3bR~UFK~2cSKYG#H#4Ep+RM3+>{Nb zw!5HEZ2}Ymj@=B*21@f1FGq311iM_|^{{@el)&3DE;8|T!H;6&mPf&rvv=oGnnD`7 zF?hafkG(tqM#*w6RqkNvYXG=RKtErRHC#T37Ak14B$wQrjY@Zj% zQ9_GUW|-w{w=(n5FGrf=`QgpMgeoOf!bp(`U>ets*iz%{AZB{QODlMB_H1ip%LV(p z?MJ8U12jt?-W=FkX-|9r0GejVk3c}q9t%<|DzczRcZT;p@Z7$oXew2fKols7bCG(j zn%Xv`WsVq;4xRz1P?M!&ZQCbMs$^}ldmPw0&Z@jjR`^3!gMmZuRY8PzI0%-2et-9C zQ>kf{$z+*(Je|;GDK$+tR|bfrCV9yT~N`zLIosq*@Vi}Btv-1iZbZ1oC!o_cZtHpK!c6g=m~{pRGU?U%GnkQB&ak%olz zyk$mkcFzp^Q)W!5KbcHm*5mTZFjx)U9S_mnr+SFxd*S1BvR40wHFSUL0QVc-zyw}QEITs zy%e)95}Fe(614taWy7&g>jnj274xWR*LI&4FMWG#J5ftOUO*8A94!rihjNXw9a`g4 z9174vx%RL@jg8tpK)0Kv=pW3;KWX31|73eAFL)@njR2!v-23>$rWf*$v7tfb`;We* z3$?H9a-$^u%U4RoaJoKA&Wq6KvwyD|)ZGu74e`|M_oB1Avvcc~w>Z0P)5_kx5pDct z@ZT4&otgdfwiCWMzzHg!|9P|4w!P>em#@%7d1HKL-?Q(u?RtZ`DsiW;9Q*!Sv&Z=R z9qVa(yb15H`Z(nviN7#-j25qA&AfQAo0d2ajREM8&!ku}CQN;M%eb1|z2ULj>>3u` zz2QG}fWG|Q+xAtDpuvL121NNva+FFT07b-rB75*Fk2KhSK=9wX&!HFifP(Vit4)I; val@6=-Y_4n%mL&_b(05DE&Qk7VdkqrEu6luv4{DUM)?#K`ifVsnvMSp0TKke literal 0 HcmV?d00001 diff --git a/.doctrees/source/index.doctree b/.doctrees/source/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..07ed4c55b449977e90c48e1b6c57f5b41ce20c9a GIT binary patch literal 3491 zcmcInOK)366mFB+i4)stN()GBiYo*Z(b%P8fsj}r*r2FUg(`OFYJBh5Gi2_}Wgd-< zR0$SHM4DX(i8cR=$3K9dz&H05#|=U(sO0v}nKN@<-}&bByUtHP53ZDd{GKTomy0pU zGO03Zg5ST)V=coE+HK0FWieNU59qnu7@@K>ObGA=SrW%w%iVN|zVm~nl6%h1$v zCEMey!@6wit8kz7e8+Mt=*pJg{N%~!A#P*$+EcoSW-H+jp|ajB2yEHF_I)pDonxE6 zTl;kEuL&+`ICfLwcZju`Pn|_9(f3WBnds+MDu^)<;=3bBUVUw6t~g&zNqVB`Eb2JF zWyw5l1-8fT9$jSz{?UY~oKCcplIqE+(kBx}za_f<8?Kp2<D8%aL`GX7`$K{zdEDuaEzmU)R?B z>H*{`FO-wnN~tOwvn#-cO0A}=K(6=xDFN)Z@2_G5fCQ#BuVC2cG8HbPGcIae=46r4 z!m@DG0dz@Gb`*d<7it>Le3$VoLj#`qL4C9pY)h9<0i-M(UGY0*zZoUP61qF+<8!OA zCQr(^?;dqflgH}?^m}!fho``7L3JSOH9cx-+1%r%v;~3RBn8JAVBx+WTDo}jHCZHl zE|mt640B@Hih#zun zRFo%cG>a!bit7|ORO`EQpa~PI(2iH8=ev^ku_*&N^(egC{apdP~k^E zoEWT%`oIgAfVs}g2=febBc6lSZ|5@%I%F7g{3*cxOmFOn92$Z9FzfS#5_#0&RINs0bg z`*TrYsLNEc$RnPv(?y{SO;%5q5J_$Fj2muCeC{O~H)JYeAhnlUO<$nL`Uu9L6UrvT zrGr{6X_@TR_yr?|>ar23jJIW|_b%87b*h%Y=YDK1z(&r2Lcw!x!{h7k_+ded1W5s< z$+S#ZKT4(qzQ@k+uQO{4^U-7iu^AUj%aj}|J)Z=BD{7VwKr^v4M|mvDu?_j*TMs`# zK8Jdiu3aA`=hwg8T#rsA5w9myk2$ro(gwPJ!fY;JtY^s-EtEyl-u4FoWS+FW*#?l9 zA|m9>UpGr>!H0~`nZOU=y(Uz|ec$8+UG|MbQyV1em2zDz6QNR4KN1Hi!#t6q@Kv)R z%Vi32`otA55ofdV0jNm;uLUGr&VYf26>dbHFmAf0$MXnYp-9z=alkqWzzm+24E?)= z3ye|=Bezm$og@^~he$9+MwTtz-meEifK|*YPCN6PR6dJ?n%}Ot1kDR5VqD^A4x3n_ z=M>z8mtY@G0a_O13jW61SaJ6r=B_No!)y=Zmx*)ZYwN09^76rK2pIFl#-sO}AtHWO zlLB6^Kg=a#i+{-qS)F8li?1DG*gy9LV@o-5vftZ@=IX=7Aii3Ae_d+tlAA8G==_Zf zp;n`79CKfCnEiUGdw;r^`B`(&cO%^(i_bBTL}B&KPMJ2o7X@}%pqkGEJ3TY(9{$y= zZ~R~t*yZU#%F!ONRJgH{ME+{@s*@`-)LpLtm zk9SDh`0(9YzpLKCcm#GWu@v8s-Bbwy5F!RVuUnr+j6wba!T%7x08?Ok2j}2_4hFqZ u8Ei@Rf_S$Tm+;=LM>Mq4JR*B1i|;^9nQ@}=JNeS!;S>%N#q;2%wqbiFneLI7ctZpvwqnSTGYBFfRuCH;Hd)=p9xiRN zIEw%$HVhjXpl)V>AlKY-&n3wZ$i=6`{s&nO`2)G-dsQrw-RkZct%tw@G-%fH>ebud ztM|#&Z=Sz=ME#RXX`lPiZp-n!DE3&I%ULgWvyeq1|1w|wH2*kXk#mW&lg3%%vRod) z3YYtVm#`@RFqez8T=+rSD)!H$%oTndmD~9gpXM_k<|}+oP6=NGtTrWQuR6j>nMiY5 zgC!?!vRyj6HuHI|@tE#AI923)SCjviW`9{`uWWy06@!Ofet>_lV zeJ>@9XWYO^Qw-wwROE#E*Q}TItBmn0z;yb~*S6r|adO1JO=lKPGJZs~obGVMvO`JZj6J+xm zL9+TuyzPS_Ry!8lDqvU&b;}R?0V5VUMCjCVBF{>g>Z5_ty5WJqeH^x%aRy7uAGCHBq~=zdVJcTO$@zF>(H z*zF*8x9VE?*G>|LhCeB3V4Q$)xP)C`+-RiGNT1Zw3|UtOR;)aujD+K_mn)mzR@!-H zwGpIl|G-_esM(Lx=JzgN-omEcAkD%9cd1p)j)M)YR;yv?`u}qw&3{;nIGtcxiX4;2(!rk-}ma=4Cl7H|vsV5QlTimkA;klrTO zN)8IUtXWF0V@#V~TS$7b)}pngFy&6&{55KVY3$AfJvvv{Bjq@*YIkG!Jbpo?H}dZE zX1UOt{X%adV-|0{di2N05>KjVuhE#J@cn<(gW4 zOF>x2d!%4#2Yz?Ac7Xqie?p;$QTo$RdL!JW&%bpU!hI8wl;?Lk3~?w_xXr{4W0CP= zO8>Ug(GJb>Qxz1%ndoOiM{+Ie-N@3R#103Xy*N{*rQsOsP=KZgZnKcLO}%%`@`dFf z$P6J>E`pCeM0}B_4?*JZQoB}^5DAYepfY&llrCwn*J#O1XEj5b+m44knO zM-_1kb5b8i^(ln*ED;01z<#nvEGcl*(aQ=yE4z<~a(QLd{!q7SK;dX(!sKJ4C_Z-m zoSZ2lg?fxIQ!vPw-txP`=`VGhCda{lf+ILzSXy-z3$i4HO7YHC-xXoLxnIJ(X5E|69s>Oa@m0&UVQqb=y2QWl_YyOOSr~^@ z6@r-Xq8>U>2yP_Cn6Jt=hsHM}Ep>TI=jCJ zB3&X9erZ46u<)-8cL&|=nx$q%yu~8_HcRZjBlwkavFE2KC$w22nr#52$aRf8>EL>@ zrV(>lnmP##ACg>k6*mq72N!ItHX0OAzy@l}^u<;Rbl0r5BV2B$IRDCvudZ1s&pMre zUAdWLYz?_GL1A_$x>9UV1h5VC)rKz!FeM8s`k2*5Kk*~65+Ooa!R+d)iL`HhOL$P} zkrG~OBtPFf0-3+xVBpfIU_jn@3qD-=Y~nv?H!{qrQIr1{f7d( zv{JoOAj;tl6&aPap@6@PiR6E7#K0dhK$MA;vmjVgb&P@Ph>0AOqLexRJ0==Ig$tyN zVqtCjQ1@+?q|Vb;W92R8I#kQju!1<=N-e}rO4l80vk)lgWYqDytvx3UHdV<>;Zv)n zB&;7(923P+a{#ZD5TkQZjnT%UL{0^AL-AH?RT+N@X5N2Dx30{7@6r&HhT@k|^G_W> zvPsY@Uwvi-VU5=tIadi*YY69qqC&vLG-n1yR7t@k zm=)Cyj&OR{9t?G6ix6RT0%8Y;2?gOzmQ!tz=ZFTTv_TXwH4T(0ifXN1V@eu|N`=te zS;{cAf})gBJ7}I~Z38>40jKfOHrxr&)MQN=eL`(y>1q+2n1X*1e%>)&iEw&XOrj#< zON9vci=7bR$~=Ch4Gu~btc%Bh+sL;HO2O(OxG|MtA2oU>=^~Co47Js=RI)UPyecpI z5oZZKshOcfnzhxMmbHR>6B#Ubw#j*I+BQx{JQLdX zrYcioBw!JJg$%_qFRj@>_DHT(6Yx)m*uw8h^Y({!A8eOiE|_Z0Rd#7wYu+TZhK!8a zZXP~h#9zJ#=1e-VBE-oW3yr}Z7^|fG_Ya03Q%X<{huuseP6o5`yTa;^4+g77O<*hF z!>p(bk+EvSnUs-%k&6B44ZQzZY}cWeIK(9#72y@St>uJjD|i*!99y&8T+@@Iii0#a zrXGnYCfusBvU+G#YMlCNh}JcQdU7nnhIbQIR0RKe=!Aon?$tu+3~oy4j;&dTL;D<| zJ&KeD>+uUJr2qABkuJ+8mDWBnhRX))vGWzu|9vn>PZx4k0XB><=IdacF)XZfrrINy z3iW6jcU%P&X3A*Joo>Hyv*qjg1h>CzoZU?Z?W7{7A?Apg>b4h--A!6VuK)EyV4o~@ z)?NRtUxF*|GfSX4fg&l~EM9o6RK46=dvNsq#6g<`>b5AQ3e*uIo!Ha)5PZU`E zqMSAT3$})oez?Mg=%;V4uXlZcSgnQ50^Rq3(mkhWa9t#ft%r^ut&fGWit7d_&$Jph zQ9|}SN+H=!k?a8?h~l?{@{x>iCbZ}gor>gCj0S)p-ciHd46PETWdc=cL`kf&kRLsA zKGaOscZS4jIFTDM|87-_zE3Vr!UO#$=y1^w8TBgmlVf>i)M&zrN}awxbno%@Urqy$ zEb()B^+8A$J>T};q|+~5f1}V)LuBPrW{v1gqRvnxX8B=lsd*re)!X=k$sh63oOv9aqxG;Lg5Z6G@8pEX_uE<5fc3H|7X^{PpYLuCgTUz3lC#EDWEe)LA!cnIs_ zU0-*AO^H}IL4N&+Y?w97!)Hd1e@Eq_n? z0lpSQ?Ap|iMzc703K%APxjfy8V}bG&t4&@%Di^5zE<#_(E{ft|j*-O_ZE$@Q%0lW* zNdfY_9$~tPEVXxF$Zg}5abmHdXp`HJ^Hf7i1QNn+2J#(~4ekWx=agJ#yFRFfcC;)t zi>Bn1$J$vJ$1UzSNd&541sqU_kvWjxWpt_h*K*O1@E~d<9gV4wimr@IbegX>Qy;%C z3{KiCN#exjc)<)<0*Vu=uE^z*rgRO;l!B7Wi$gO*AbP)rsgR2rZiR!{ePM87XtO*; zcYv&=93%=mhiNy;+`bK?ZPLaYx-!7)C>WJ6Bt>LpRc_aLjRe|zYA8KV!LP~ zVs?F}k`h2$%O2I1q2@zc;{i1q97lIi0p)c|upL#(q_F3O9ofKVWo<^wXVUu#m zbH-s{IBn^!o>rW6*K_$etyBnLrERPowfV4q^SR5ffS!v<#~lJsBNh1P4S2FpB(hrw zSbQcr>I@iwbuPjHhs_D64K4Bn&#%wQi;&6CF4eQVfUP@?_T{N`551eaHut+cz<VolF-#}$WLhRnk`uVL$ zg&o+3^u(?obsz)AFq|e+fr`-3IzL2{6b@6*8iW~HCCE(JW*$^{4=8ZP1P*!J#i}iv zA=C?O1aV|&723;14={u^=xDRHFORcmn>usltTrdmUx*@F7JMj&uyp}U-EJ93LA208 zOD5c-K3r#8mMfe>ACDloe(!5cmv7%kUo=PKS9$P1#~nNZ-k75^d3xaP zx_NmdoqB)6aU)Uv2PQINNXKkf(HM0~e~eCP8q~j6dLfqfIQ^jq&0deP&M)|9Jw{(` z`g4{h&(I&2{%qn;Cg%u-*z1EZz)eBfR}l937yD}SzS_92HtlEpXzcxR!S!`>H0ieX(_9Z=ylL6=w{fCgHnCf(#M7d z%hhuO5a-OPYSZZf`0$R2Ab0%uFsxz*K?w}L5^wTsC+V>ndI4F6)1P^p#2({cf{LH# zKZWr^^Ek{Py4O>vt3I%_`vb!#%VDK)C;i9`GLJO8OQxjZk!vcfIK^4A5$>gM=Rt-z K=i?k1-v0n>oLz|k literal 0 HcmV?d00001 diff --git a/.doctrees/tutorial/index.doctree b/.doctrees/tutorial/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..dfa3719f9b6544263056933eab11346df682305f GIT binary patch literal 3192 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 JQ5R>e{{`8F!=(TK literal 0 HcmV?d00001 diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/_sources/contribute/add_datasets.md.txt b/_sources/contribute/add_datasets.md.txt new file mode 100644 index 00000000..5b766cb2 --- /dev/null +++ b/_sources/contribute/add_datasets.md.txt @@ -0,0 +1 @@ +# Add a Dataset \ No newline at end of file diff --git a/_sources/contribute/add_docs.md.txt b/_sources/contribute/add_docs.md.txt new file mode 100644 index 00000000..c995b375 --- /dev/null +++ b/_sources/contribute/add_docs.md.txt @@ -0,0 +1 @@ +# Contribute to Docs \ No newline at end of file diff --git a/_sources/contribute/add_models.md.txt b/_sources/contribute/add_models.md.txt new file mode 100644 index 00000000..cf550ad8 --- /dev/null +++ b/_sources/contribute/add_models.md.txt @@ -0,0 +1 @@ +# Add a Model \ No newline at end of file diff --git a/_sources/contribute/add_tests.md.txt b/_sources/contribute/add_tests.md.txt new file mode 100644 index 00000000..b37fda3e --- /dev/null +++ b/_sources/contribute/add_tests.md.txt @@ -0,0 +1 @@ +# Add Tests \ No newline at end of file diff --git a/_sources/contribute/contribute_to_hezar.md.txt b/_sources/contribute/contribute_to_hezar.md.txt new file mode 100644 index 00000000..d55cf7e5 --- /dev/null +++ b/_sources/contribute/contribute_to_hezar.md.txt @@ -0,0 +1 @@ +# Contribute to Hezar \ No newline at end of file diff --git a/_sources/contribute/index.md.txt b/_sources/contribute/index.md.txt new file mode 100644 index 00000000..da0583cb --- /dev/null +++ b/_sources/contribute/index.md.txt @@ -0,0 +1,10 @@ +# Contribute + +```{toctree} +contribute_to_hezar.md +add_models.md +add_datasets.md +add_docs.md +add_tests.md +pull_requests.md +``` \ No newline at end of file diff --git a/_sources/contribute/pull_requests.md.txt b/_sources/contribute/pull_requests.md.txt new file mode 100644 index 00000000..02e82902 --- /dev/null +++ b/_sources/contribute/pull_requests.md.txt @@ -0,0 +1 @@ +# Sending a Pull Request \ No newline at end of file diff --git a/_sources/get_started/index.md.txt b/_sources/get_started/index.md.txt new file mode 100644 index 00000000..4be437a2 --- /dev/null +++ b/_sources/get_started/index.md.txt @@ -0,0 +1,8 @@ +# Get Started +```{toctree} +:maxdepth: 1 + +overview.md +installation.md +quick_tour.md +``` \ No newline at end of file diff --git a/_sources/get_started/installation.md.txt b/_sources/get_started/installation.md.txt new file mode 100644 index 00000000..d32620a4 --- /dev/null +++ b/_sources/get_started/installation.md.txt @@ -0,0 +1,25 @@ +# Installation + +#### Install from PyPi +Installing Hezar is as easy as any other Python library! Most of the requirements are cross-platform and installing +them on any machine is a piece of cake! + +``` +pip install hezar +``` +#### Install from source +Also, you can install the dev version of the library using the source: +``` +pip install git+https://github.com/hezarai/hezar.git +``` + +#### Test installation +From a Python console or in CLI just import `hezar` and check the version: +```python +import hezar + +print(hezar.__version__) +``` +``` +0.23.1 +``` \ No newline at end of file diff --git a/_sources/get_started/overview.md.txt b/_sources/get_started/overview.md.txt new file mode 100644 index 00000000..1aa31b5a --- /dev/null +++ b/_sources/get_started/overview.md.txt @@ -0,0 +1,20 @@ +# Overview + +Welcome to Hezar! A library that makes state-of-the-art machine learning as easy as possible aimed for the Persian +language, built by the Persian community! + +In Hezar, the primary goal is to provide plug-and-play AI/ML utilities so that you don't need to know much about what's +going on under the hood. Hezar is not just a model library, but instead it's packed with every aspect you need for any +ML pipeline like datasets, trainers, preprocessors, feature extractors, etc. + +Hezar is a library that: +- brings together all the best works in AI for Persian +- makes using AI models as easy as a couple of lines of code +- seamlessly integrates with Hugging Face Hub for all of its models +- has a highly developer-friendly interface +- has a task-based model interface which is more convenient for general users. +- is packed with additional tools like word embeddings, tokenizers, feature extractors, etc. +- comes with a lot of supplementary ML tools for deployment, benchmarking, optimization, etc. +- and more! + +To find out more, just take the [quick tour](quick_tour.md)! \ No newline at end of file diff --git a/_sources/get_started/quick_tour.md.txt b/_sources/get_started/quick_tour.md.txt new file mode 100644 index 00000000..8e4651cd --- /dev/null +++ b/_sources/get_started/quick_tour.md.txt @@ -0,0 +1,151 @@ +# Quick Tour +Let's have a quick tour on some of the most important features of Hezar! + +### Models +There's a bunch of ready to use trained models for different tasks on the Hub. To see all the models see [here](https://huggingface.co/hezarai)! + +- **Text classification (sentiment analysis, categorization, etc)** +```python +from hezar import Model + +example = ["هزار، کتابخانه‌ای کامل برای به کارگیری آسان هوش مصنوعی"] +model = Model.load("hezarai/bert-fa-sentiment-dksf") +outputs = model.predict(example) +print(outputs) +``` +``` +{'labels': ['positive'], 'probs': [0.812910258769989]} +``` +- **Sequence labeling (POS, NER, etc.)** +```python +from hezar import Model + +pos_model = Model.load("hezarai/bert-fa-pos-lscp-500k") # Part-of-speech +ner_model = Model.load("hezarai/bert-fa-ner-arman") # Named entity recognition +inputs = ["شرکت هوش مصنوعی هزار"] +pos_outputs = pos_model.predict(inputs) +ner_outputs = ner_model.predict(inputs) +print(f"POS: {pos_outputs}") +print(f"NER: {ner_outputs}") +``` +``` +POS: [[{'token': 'شرکت', 'tag': 'Ne'}, {'token': 'هوش', 'tag': 'Ne'}, {'token': 'مصنوعی', 'tag': 'AJe'}, {'token': 'هزار', 'tag': 'NUM'}]] +NER: [[{'token': 'شرکت', 'tag': 'B-org'}, {'token': 'هوش', 'tag': 'I-org'}, {'token': 'مصنوعی', 'tag': 'I-org'}, {'token': 'هزار', 'tag': 'I-org'}]] +``` +- **Speech recognition** +```python +from hezar import Model +from datasets import load_dataset + +ds = load_dataset("mozilla-foundation/common_voice_11_0", "fa", split="test") +sample = ds[1001] +whisper = Model.load("hezarai/whisper-small-fa") +transcript = whisper.predict(sample["path"]) # or pass `sample["audio"]["array"]` (with the right sample rate) +print(transcript) +``` +``` +{'transcription': ['و این تنها محدود به محیط کار نیست']} +``` + +### Word Embeddings +- **FastText** +```python +from hezar import Embedding + +fasttext = Embedding.load("hezarai/fasttext-fa-300") +most_similar = fasttext.most_similar("هزار") +print(most_similar) +``` +``` +[{'score': 0.7579, 'word': 'میلیون'}, + {'score': 0.6943, 'word': '21هزار'}, + {'score': 0.6861, 'word': 'میلیارد'}, + {'score': 0.6825, 'word': '26هزار'}, + {'score': 0.6803, 'word': '٣هزار'}] +``` +- **Word2Vec (Skip-gram)** +```python +from hezar import Embedding + +word2vec = Embedding.load("hezarai/word2vec-skipgram-fa-wikipedia") +most_similar = word2vec.most_similar("هزار") +print(most_similar) +``` +``` +[{'score': 0.7885, 'word': 'چهارهزار'}, + {'score': 0.7788, 'word': '۱۰هزار'}, + {'score': 0.7727, 'word': 'دویست'}, + {'score': 0.7679, 'word': 'میلیون'}, + {'score': 0.7602, 'word': 'پانصد'}] +``` +- **Word2Vec (CBOW)** +```python +from hezar import Embedding + +word2vec = Embedding.load("hezarai/word2vec-cbow-fa-wikipedia") +most_similar = word2vec.most_similar("هزار") +print(most_similar) +``` +``` +[{'score': 0.7407, 'word': 'دویست'}, + {'score': 0.7400, 'word': 'میلیون'}, + {'score': 0.7326, 'word': 'صد'}, + {'score': 0.7276, 'word': 'پانصد'}, + {'score': 0.7011, 'word': 'سیصد'}] +``` + +### Datasets +You can load any of the datasets on the [Hub](https://huggingface.co/hezarai) like below: +```python +from hezar import Dataset + +sentiment_dataset = Dataset.load("hezarai/sentiment-dksf") # A TextClassificationDataset instance +lscp_dataset = Dataset.load("hezarai/lscp-pos-500k") # A SequenceLabelingDataset instance +xlsum_dataset = Dataset.load("hezarai/xlsum-fa") # A TextSummarizationDataset instance +... +``` + +### Training +Hezar makes it super easy to train models using out-of-the-box models and datasets provided in the library. +```python +from hezar import ( + BertSequenceLabeling, + BertSequenceLabelingConfig, + TrainerConfig, + SequenceLabelingTrainer, + Dataset, + Preprocessor, +) + +base_model_path = "hezarai/bert-base-fa" +dataset_path = "hezarai/lscp-pos-500k" + +train_dataset = Dataset.load(dataset_path, split="train", tokenizer_path=base_model_path) +eval_dataset = Dataset.load(dataset_path, split="test", tokenizer_path=base_model_path) + +model = BertSequenceLabeling(BertSequenceLabelingConfig(id2label=train_dataset.config.id2label)) +preprocessor = Preprocessor.load(base_model_path) + +train_config = TrainerConfig( + device="cuda", + init_weights_from=base_model_path, + batch_size=8, + num_epochs=5, + checkpoints_dir="checkpoints/", + metrics=["seqeval"], +) + +trainer = SequenceLabelingTrainer( + config=train_config, + model=model, + train_dataset=train_dataset, + eval_dataset=eval_dataset, + data_collator=train_dataset.data_collator, + preprocessor=preprocessor, +) +trainer.train() + +trainer.push_to_hub("bert-fa-pos-lscp-500k") # push model, config, preprocessor, trainer files and configs +``` + +Want to go deeper? Check out the [guides](../guide/index.md). \ No newline at end of file diff --git a/_sources/guide/hezar_architecture.md.txt b/_sources/guide/hezar_architecture.md.txt new file mode 100644 index 00000000..b2cede2b --- /dev/null +++ b/_sources/guide/hezar_architecture.md.txt @@ -0,0 +1,220 @@ +# Hezar's Architecture + +Right from the first lines of code, Hezar was built having **simplicity**, **modularity** and **extensibility** in mind. +Hezar has a simple yet flexible design pattern that can be seen among most of its main modules. In this guide we +demonstrate the main ideas behind the design. + +Going forward, by the term _module_, we mean any main class +like `Model`, `Dataset`, `Metric`, `Trainer`, `Preprocessor`, +etc. + +## Concept 1: Configurable Modules + +Every single module object in Hezar can be constructed from a key-value container. This container is the module's config +which contains everything needed to build an object from that module. In order to have a portable serializable config +that can be also converted to Python code, there lies Hezar's most important class called `Config`. The `Config` class +is a simple Python dataclass that is equipped with extra methods for importing, exporting, pushing to the Hub, etc. +The `Config` class is defined in `hezar/configs.py` among other config derivatives. +Right now the config derivatives are: + +- `ModelConfig` +- `DatasetConfig` +- `PreprocessorConfig` +- `TrainerConfig` +- `EmbeddingConfig` +- `MetricConfig` + +So every module must have its own config inherited from `Config`. When defining a new config dataclass, one must define +a unique name (as the parameter `name`), responsible for identifying the module type that uses that config class. We'll +discuss why this `name` parameter is necessary in the registry section. + +To give some examples: + +Let's assume you want to write a new model class called `AwesomeModel`. The first step is to provide a config dataclass: + +```python +from dataclasses import dataclass +from hezar import ModelConfig, Model + + +@dataclass +class MyAwesomeModelConfig(ModelConfig): + name = "my_awesome_model" # this has to be a unique name among all models configs + my_param: str = "awesome" + other_param: str = "more_awesome" + + +class MyAwesomeModel(Model): + def __init__(self, config, **kwargs): + super().__init__(config, **kwargs) + # Define the layers or any other stuff here + ... + + def forward(self, inputs, **kwargs): + # Casual PyTorch forward method + ... +``` + +Wait, what's that name for? Why would you need to define a name for everything? The short answer is +_Hezar's registry system_. So let's dive into it! + +## Concept 2: Modules' Registries + +There are lots of base modules in Hezar and many of which might have dozens of subclasses, but as you might have seen by +now, almost every module can load its class using the same base class in a single line. Take a look at the below +snippets: + +```python +# Load a model +from hezar import Model + +roberta_tc = Model.load("hezarai/roberta-fa-sentiment-dksf") # roberta_tc is a RobertaTextClassification instance +bert_pos = Model.load("hezarai/bert-fa-pos-lscp-500k") # bert_pos is a BertSequenceLabeling instance +whisper_speech = Model.load("hezarai/whisper-small-fa") # whisper_speech is a WhisperSpeechRecognition instance +... +# Load a dataset +from hezar import Dataset + +sentiment_dataset = Dataset.load("hezarai/sentiment-dksf") # A TextClassificationDataset instance +lscp_dataset = Dataset.load("hezarai/lscp-pos-500k") # A SequenceLabelingDataset instance +xlsum_dataset = Dataset.load("hezarai/xlsum-fa") # A TextSummarizationDataset instance +... +# Load preprocessors +from hezar import Preprocessor + +wordpiece = Preprocessor.load("hezarai/bert-base-fa") # A WordPieceTokenizer instance +whisper_bpe = Preprocessor.load("hezarai/whisper-small-fa") # A WhisperBPETokenizer instance +sp_unigram_bpe = Preprocessor.load("hezarai/t5-base-fa") # A SentencePieceUnigramTokenizer instance +... +# Load embedding +from hezar import Embedding + +fasttext = Embedding.load("hezarai/fasttext-fa-300") # A FastText instance +word2vec = Embedding.load("hezarai/word2vec-skipgram-fa-wikipedia") # A Word2Vec instance +... +``` + +So, what's going on under the hood that handles module loading and initiation? + +**Registry System**
+Well, there are ways to tackle this challenge, but Hezar manages this by using _a global registry_ for every module +type. These registries are simple Python dictionaries that hold the properties for every module class, module config, +etc. +The general structure is like below: + +```python +# Models registry for example +models_registry = { + "bert_text_classification": Registry( + module_class=hezar.models.text_classification.bert.bert_text_classification.BertTextClassification, + config_class=hezar.models.text_classification.bert.bert_text_classification_config.BertTextClassificationConfig, + doc="SOME DOCSTRING ..." + ), + "AND SO ON...": Registry(...) +} +``` +To get the gist of this, just import registries and take a look at them like so: +```python +from hezar.registry import ( + models_registry, + preprocessors_registry, + datasets_registry, + embeddings_registry, + metrics_registry, +) + +print(preprocessors_registry.keys()) # or any other registry +``` +``` +['text_normalizer', + 'whisper_feature_extractor', + 'wordpiece_tokenizer', + 'bpe_tokenizer', + 'sentencepiece_bpe_tokenizer', + 'sentencepiece_unigram_tokenizer', + 'whisper_bpe_tokenizer'] +``` +Each registry value is a `Registry` (data)class that has 3 properties: `config_class`, `module_class` and `doc`. +- `module_class`: Holds the class object for the module. Using this property you can actually create the module object. +- `config_class`: Holds the config class and can be passed to the module class so that the module can be created. +- `doc`: Holds the docstring of the module if any. + +So now it's pretty easy to create modules objects using the identifier name! Let's say you want to create a +BPE tokenizer. You can do it this way: +```python +from hezar.registry import preprocessors_registry + +module_cls = preprocessors_registry["bpe_tokenizer"].module_class +config_cls = preprocessors_registry["bpe_tokenizer"].config_class + +bpe = module_cls(config_cls()) +``` +Although, this is not how it's actually done in Hezar because it's long and ugly! To handle this properly we use another +internal feature of Hezar called the _builders_! + + +**Builders**
+There is also another important group +of utilities called _builders_. Using builders you can build modules from their names in a single line of code. +These family of functions take 3 main parameters: +- `name`: A registry key name representing that module. This name has to be present in the corresponding registry! +- `config`: Optionally you can pass a config object to control how the module is built. The config has to be of a type that the module accepts. +- `**kwargs`: Optionally you can pass config parameters as keyword arguments to override default the default config. (The override priority is `kwargs` > `config` > default config) +```python +from hezar import builders + +bert = builders.build_model("bert_lm", hidden_size=768, vocab_size=50000) +sp_bpe = builders.build_preprocessor("sentencepiece_bpe_tokenizer") +tc_dataset = builders.build_dataset("text_classification", path="hezarai/sentiment-dksf", tokenizer_path="hezarai/bert-base-fa") +... +``` +So why would you need to use builders or registries when you can import everything normally? like below: +```python +from hezar import WhisperSpeechRecognition, WhisperSpeechRecognitionConfig + +whisper = WhisperSpeechRecognition(WhisperSpeechRecognitionConfig(max_new_tokens=400)) +``` +The answer is that for writing code, you can always use the classes directly. But the fact is that everything works with +configs and a config must have at least some identifiers so that a module can be initialized from it. The main usage of +the registries is to be able to create everything from the configs! So lets slide into the next section, the Hub! + +## Concept 3: Hugging Face Hub Integration +In Hezar, EVERY module can be uploaded to or downloaded from the Hugging Face Hub with ease! Modules have 3 main methods +to do so: +- `load`: A method implemented in any type of base class that loads the module from the Hub or local disk automagically! +- `save`: A method to save all the necessary files and configurations to a path on the local disk. +- `push_to_hub`: A method implemented in any type of base class that pushes all the necessary files and configurations to the Hub so that the module can be loaded from the Hub again. + +**Loading**
+All base modules implement their own `load` method based on their characteristics. But the first step in every load +process is loading the configuration as all the info lies there, and then any other file is loaded. +For example the class `Model` first loads its config and builds the model using `build_model` and the config parameters. +Then the state dict is loaded to the model. If the path contains preprocessor files and configs, it would load them too. +On the other hand, some simple modules like metric might just load the config to create a metric instance. +One important feature of any `load` method is that like builders, it accepts config parameters as keyword arguments so +that you can override config properties. + +**Saving**
+Almost every module has the `save` method implemented which is responsible for saving config and other related files to the +disk. This method takes a `path` parameter which is just the base folder path and any necessary subfolder will be created +automatically based on the module type. For example, if you save a tokenizer at path `my_tokenizer/`, the `Tokenizer`'s +`save` method will create a `preprocessor` folder and saves the `tokenizer.json` and `tokenizer_config.yaml` on that +folder. You can control the `subfolder` parameter and other file/path names if the base class gives you the option. + +**Pushing to the Hub**
+Pushing to the Hugging Face Hub is so much like the save method. The only difference is that the files are then uploaded +to the Hub after saving. + + +## Concept 4: Task-base Modeling +Hezar is a practical library not a framework (it can be though!). That's why we decided to categorize models, trainers, +datasets, etc. under task names e.g, `speech_recognition`, `language_modeling`, etc. If you've worked with other +libraries, this might somewhat seem irrational, but trust us! For most users and usages this fits better! + +## Concept 5: Integration with other tools +Re-inventing the wheel has no place in Hezar. It's strongly recommended that if something already exists somewhere and +we want it, just copy and paste it into the code!
+In terms of backbone frameworks and libraries, we carefully R&D the present tools and choose the one that is the most +simple yet popular. That's why every model in Hezar is a `PyTorch nn.Module`, every tokenizer is based on the Rust +implementation of the famous tokenizers implemented in Hugging Face `tokenizers`, every embedding model is built upon +`gensim` and so on ... . \ No newline at end of file diff --git a/_sources/guide/index.md.txt b/_sources/guide/index.md.txt new file mode 100644 index 00000000..50299871 --- /dev/null +++ b/_sources/guide/index.md.txt @@ -0,0 +1,11 @@ +# Developer Guides + +Welcome to the developer guide section where you can take a deeper dive into the internals of Hezar! + +```{toctree} +:maxdepth: 1 + +hezar_architecture.md +models_in_depth_overview.md +train_custom_models.md +``` \ No newline at end of file diff --git a/_sources/guide/models_in_depth_overview.md.txt b/_sources/guide/models_in_depth_overview.md.txt new file mode 100644 index 00000000..1fc2a791 --- /dev/null +++ b/_sources/guide/models_in_depth_overview.md.txt @@ -0,0 +1 @@ +# Models In-depth Overview \ No newline at end of file diff --git a/_sources/guide/train_custom_models.md.txt b/_sources/guide/train_custom_models.md.txt new file mode 100644 index 00000000..3e0d58d7 --- /dev/null +++ b/_sources/guide/train_custom_models.md.txt @@ -0,0 +1,2 @@ +# Training Custom Models +Docs coming soon, stay tuned! \ No newline at end of file diff --git a/_sources/index.md.txt b/_sources/index.md.txt new file mode 100644 index 00000000..704095be --- /dev/null +++ b/_sources/index.md.txt @@ -0,0 +1,16 @@ +# Welcome to Hezar's documentation! +Welcome to Hezar's official documentation! + +Here you can find every piece of info about all the aspects in Hezar. + +Navigate to the desired section using this table of contents: + +```{toctree} +:maxdepth: 2 + +get_started/index.md +tutorial/index.md +guide/index.md +source/index.md +contribute/index.md +``` \ No newline at end of file diff --git a/_sources/source/index.md.txt b/_sources/source/index.md.txt new file mode 100644 index 00000000..927c0c2c --- /dev/null +++ b/_sources/source/index.md.txt @@ -0,0 +1,8 @@ +# API +The docs here are mostly generated from the official source code on the main branch. + +Docs coming soon, stay tuned! +```{toctree} +:maxdepth: 5 + +``` \ No newline at end of file diff --git a/_sources/tutorial/datasets.md.txt b/_sources/tutorial/datasets.md.txt new file mode 100644 index 00000000..7c2e4337 --- /dev/null +++ b/_sources/tutorial/datasets.md.txt @@ -0,0 +1,59 @@ +# Datasets +Hezar provides both dataset class implementations and ready-to-use data files for the community. + +## Hub Datasets +Hezar datasets are all hosted on the Hugging Face Hub and can be loaded just like any dataset on the Hub. + +### Load using Hugging Face datasets +```python +from datasets import load_dataset + +sentiment_dataset = load_dataset("hezarai/sentiment-dksf") +lscp_dataset = load_dataset("hezarai/lscp-pos-500k") +xlsum_dataset = load_dataset("hezarai/xlsum-fa") +... +``` + +### Load using Hezar Dataset +```python +from hezar import Dataset + +sentiment_dataset = Dataset.load("hezarai/sentiment-dksf") # A TextClassificationDataset instance +lscp_dataset = Dataset.load("hezarai/lscp-pos-500k") # A SequenceLabelingDataset instance +xlsum_dataset = Dataset.load("hezarai/xlsum-fa") # A TextSummarizationDataset instance +... +``` + +The difference between using Hezar vs Hugging Face datasets is the output class. In Hezar when you load +a dataset using the `Dataset` class, it automatically finds the proper class for that dataset and creates a +PyTorch `Dataset` instance so that it can be easily passed to a PyTorch `DataLoader` class. +```python +from torch.utils.data import DataLoader + +from hezar.data.datasets import Dataset + +dataset = Dataset.load( + "hezarai/lscp-pos-500k", + tokenizer_path="hezarai/distilbert-base-fa", # tokenizer_path is necessary for data collator +) + +loader = DataLoader(dataset, batch_size=16, shuffle=True, collate_fn=dataset.data_collator) +itr = iter(loader) +print(next(itr)) +``` +But when loading using Hugging Face datasets, the output is an HF Dataset instance. + +So in a nutshell, any Hezar dataset can be loaded using HF datasets but not vise-versa! +(Because Hezar looks out for a `dataset_config.yaml` file in any dataset repo so non-Hezar datasets cannot be +loaded using Hezar `Dataset` class.) + +## Dataset classes +Hezar categorizes datasets based on their target task. The dataset classes all inherit from the base `Dataset` class +which is a PyTorch Dataset subclass. (hence having `__getitem__` and `__len__` methods.) + +Some examples of the dataset classes are `TextClassificationDataset`, `TextSummarizationDataset`, `SequenceLabelingDataset`, etc. + +## Dataset Templates +We try to have a simple yet practical pattern for all datasets on the Hub. Every dataset on the Hub needs to have +a dataset loading script. Some ready to use templates are located in the [templates/dataset_scripts](https://github.com/hezarai/hezar/tree/main/templates/dataset_scripts) folder. +To add a new Hezar compatible dataset to the Hub you can follow the guide provided there. \ No newline at end of file diff --git a/_sources/tutorial/index.md.txt b/_sources/tutorial/index.md.txt new file mode 100644 index 00000000..e74c8e89 --- /dev/null +++ b/_sources/tutorial/index.md.txt @@ -0,0 +1,9 @@ +# Tutorial +```{toctree} +:maxdepth: 1 + +models.md +datasets.md +training.md +preprocessors.md +``` \ No newline at end of file diff --git a/_sources/tutorial/models.md.txt b/_sources/tutorial/models.md.txt new file mode 100644 index 00000000..0a856d83 --- /dev/null +++ b/_sources/tutorial/models.md.txt @@ -0,0 +1,135 @@ +# Models +In Hezar, models are the typical PyTorch modules with some extra features for loading, saving, exporting, etc. +Let's dive into some of the most important ones! + +## Models Basics +### Building Models +Like any other package, you can import any model from `hezar.models` that you want. +```python +from hezar.models import BertLM, BertLMConfig + +bert = BertLM(BertLMConfig()) +``` +You can also configure the architecture by changing the properties in a model's config like so: +```python +config = BertLMConfig(num_hidden_layers=8, num_attention_heads=8) +bert = BertLM(config) +``` + +Every model in Hezar, can be pushed to or downloaded from the Hub. + +### Loading pre-trained models +Loading a model from Hub is as easy as: +```python +from hezar import Model + +bert = Model.load("hezarai/bert-base-fa") +``` +The `load` methods takes the following steps to build the model: + +1. Load the config file `model_config.yaml` and figure out the model's class using the `name` config parameter. (`bert_lm` in this snippet) +2. Build the model with random weights from the corresponding class. (`BertLM` in this snippet) +3. Download the weights file (`model.pt`) and load the state dict into to the model. +4. If the path contains any preprocessor, the preprocessor (`WordPieceTokenizer` in this snippet) will be loaded too. +(You can disable loading preprocessors by setting `Model.load(path, load_preprocessor=False)`) + +### Inference & Prediction +Now that you have loaded a model along with its preprocessors, feature extractors, etc. you can perform an end-to-end +inference in a single line of code using `Model.predict` method. + +A sequence labeling example would be like this: +```python +from hezar import Model + +pos_model = Model.load("hezarai/bert-fa-pos-lscp-500k") # Part-of-speech +inputs = ["شرکت هوش مصنوعی هزار"] +pos_outputs = pos_model.predict(inputs) +print(f"POS: {pos_outputs}") +``` +``` +POS: [[{'token': 'شرکت', 'tag': 'Ne'}, {'token': 'هوش', 'tag': 'Ne'}, {'token': 'مصنوعی', 'tag': 'AJe'}, {'token': 'هزار', 'tag': 'NUM'}]] +``` + +### Saving Models +You can save any model along with its config and preprocessor and other files on disk like: +```python +from hezar import RobertaLM, RobertaLMConfig + +roberta = RobertaLM(RobertaLMConfig(vocab_size=60000)) +roberta.save("my-roberta") +``` + +### Pushing to the Hub +Every model can be pushed to the Hub. +```python +from hezar import RobertaTextClassification, RobertaTextClassificationConfig + +roberta = RobertaTextClassification(RobertaTextClassificationConfig(num_labels=2)) +roberta.push_to_hub("arxyzan/roberta-sentiment") +``` +``` +INFO: Uploaded:`RobertaTextClassificationConfig(name=roberta_text_classification)` --> `arxyzan/roberta-sentiment/model_config.yaml` +INFO: Uploaded: `RobertaTextClassification(name=roberta_text_classification)` --> `arxyzan/roberta-sentiment/model.pt` +``` +## Custom Models +Every Hezar model is a subclass of the base model class `Model` and the `Model` itself is a subclass of PyTorch `nn.Module` +with some extra features. So if you're familiar with PyTorch, this should feel like home! + +### A Sample Perceptron +```python +from dataclasses import dataclass + +from torch import Tensor, nn + +from hezar import Model, ModelConfig, register_model + + +@dataclass +class PerceptronConfig(ModelConfig): + name = "perceptron" + input_shape: int = 4 + output_shape: int = 2 + + +@register_model("perceptron", config_class=PerceptronConfig) +class Perceptron(Model): + """ + A simple single layer network + """ + + def __init__(self, config, **kwargs): + super().__init__(config, **kwargs) + self.nn = nn.Linear( + in_features=self.config.input_shape, + out_features=self.config.output_shape, + ) + + def forward(self, inputs: list, **kwargs): + inputs = Tensor(inputs).reshape(1, -1) + x = self.nn(inputs) + return x + + def post_process(self, inputs, **kwargs): + return inputs.numpy() + +``` +The only point here is that you have to pass a `ModelConfig` to your model and read everything from the config and the +rest is just typical PyTorch stuff. + +Now you have access to all the features of a Hezar model. +```python +model = Perceptron(PerceptronConfig()) +inputs = [1, 2, 3, 4] +outputs = model.predict(inputs) +print(outputs) +model.save("my-perceptron") +model.push_to_hub("hezarai/perceptron") +``` +``` +[[-1.0953112 -1.9854667]] +INFO: Uploaded:`PerceptronConfig(name=perceptron)` --> `hezarai/perceptron/model_config.yaml` +INFO: Uploaded: `Perceptron(name=perceptron)` --> `hezarai/perceptron/model.pt` +``` + + +To learn more about the internals of the models in Hezar take a look at [the models in-depth guide](../guide/models_in_depth_overview.md) \ No newline at end of file diff --git a/_sources/tutorial/preprocessors.md.txt b/_sources/tutorial/preprocessors.md.txt new file mode 100644 index 00000000..00b784a4 --- /dev/null +++ b/_sources/tutorial/preprocessors.md.txt @@ -0,0 +1,70 @@ +# Preprocessors +A really important group of modules in Hezar is the preprocessors. Preprocessors are responsible for every single +processing of inputs from their rawest form to the point that they're ready to be fed to the model. + +Preprocessors include all the tokenizers, feature extractors, normalizers, etc. and all of them are considered as a +preprocessor type. + +## Loading preprocessors +Following the common pattern among all modules in Hezar, preprocessors also can be loaded in the same way. + +**Loading with the corresponding module**
+You can load any preprocessor of any type with its base class like `Tokenizer`, `AudioFeatureExtractor`, etc. +```python +from hezar import Tokenizer, AudioFeatureExtractor, TextNormalizer + +tokenizer = Tokenizer.load("hezarai/bert-base-fa") +normalizer = TextNormalizer.load("hezarai/roberta-base-fa") +feature_extractor = AudioFeatureExtractor.load("hezarai/whisper-small-fa") +... +``` +**Loading with the Preprocessor class** +Some models might need multiple types of preprocessors. For example encoder-decoder multimodal models like image captioning models +or even audio models need both feature extractor and text tokenizer or even a text normalizer. In order to load all +preprocessors in a path, you can use the `Preprocessor.load`. The output of this method depends on whether the path +contains single or multiple preprocessors. +- If path contains only one preprocessor the output is a preprocessor object of the right type. +- If path contains multiple preprocessors, the output is a `PreprocessorContainer` which is a dict-like object that holds +each preprocessor by its registry name. +```python +from hezar import Tokenizer + +tokenizer = Tokenizer.load("hezarai/bert-base-fa") +print(tokenizer) +``` +``` + +``` + +```python +from hezar import Preprocessor + +whisper_preprocessors = Preprocessor.load("hezarai/whisper-small-fa") +print(whisper_preprocessors) +``` +``` +PreprocessorsContainer( + [ + ('whisper_feature_extractor', + < hezar.preprocessors.feature_extractors.audio.whisper_feature_extractor.WhisperFeatureExtractor at 0x7f6316fdcbb0 >), + ('whisper_bpe_tokenizer', + < hezar.preprocessors.tokenizers.whisper_bpe.WhisperBPETokenizer at 0x7f643cb13f40 >) + ] +) +``` + +## Saving & Pushing to the Hub +Although preprocessor have their own type, they all implement the `load`, `save` and `push_to_hub` methods. +```python +from hezar import TextNormalizer, TextNormalizerConfig + +normalizer = TextNormalizer(TextNormalizerConfig(nfkc=False)) +normalizer.save("my-normalizer") +normalizer.push_to_hub("arxyzan/my-normalizer") +``` +### Folder structure of the preprocessors +All preprocessors are saved under the `preprocessor` subfolder by default. Changing this behaviour is possible from all +three methods: +- `load(..., subfolder="SUBFOLDER")` +- `save(..., subfolder="SUBFOLDER")` +- `push_to_hub(..., subfolder="SUBFOLDER")` \ No newline at end of file diff --git a/_sources/tutorial/training.md.txt b/_sources/tutorial/training.md.txt new file mode 100644 index 00000000..b6e1911f --- /dev/null +++ b/_sources/tutorial/training.md.txt @@ -0,0 +1,112 @@ +# Training & Fine-tuning models + +Training a model in Hezar is pretty much like any other library or even simpler! As mentioned before, any model in Hezar +is also a PyTorch module. So training a model is actually training a PyTorch model with some more cool features! +Let's dive in. + +## Setup +In this example we're going to train a sentiment analysis model based on DistilBERT on a dataset containing +text and sentiment pairs collected from SnappFood/Digikala user comments. +### Import everything needed +First things first, let's import the required stuff. + +```python +from hezar import ( + DistilBertTextClassification, + DistilBertTextClassificationConfig, + TrainerConfig, + TextClassificationTrainer, + Dataset, + Preprocessor, +) +``` +### Define paths +Lets define our paths to the datasets, tokenizer, etc. +```python +MODEL_NAME = "distilbert_text_classification" # model registry name +DATASET_PATH = "hezarai/sentiment-dksf" # dataset path on the Hub +BASE_MODEL_PATH = "hezarai/distilbert-base-fa" # used as model backbone weights and tokenizer +``` +## Datasets +We can easily load our desired datasets from the Hub. +```python +train_dataset = Dataset.load(DATASET_PATH, split="train", tokenizer_path=BASE_MODEL_PATH) +eval_dataset = Dataset.load(DATASET_PATH, split="test", tokenizer_path=BASE_MODEL_PATH) +``` + +## Model +Let's build our model along with its tokenizer. +### Build the model +```python +model = BertTextClassification(BertTextClassificationConfig(id2label=train_dataset.config.id2label)) +``` +### Load the tokenizer +The tokenizer can be loaded from the base model path. +```python +tokenizer = Preprocessor.load(BASE_MODEL_PATH) +``` + +## Trainer +In Hezar, each task has its own trainer but all trainers are almost the same except for loss and metrics computations. +For this example we have to use `TextClassificationTrainer`. +### Trainer Config +Define all the training properties in the trainer's config. +```python +train_config = TrainerConfig( + device="cuda", + init_weights_from=BASE_MODEL_PATH, + batch_size=8, + num_epochs=5, + checkpoints_dir="checkpoints/", + metrics=["f1"], + num_dataloader_workers=0, + seed=42, + optimizer="adamw", + learning_rate=2e-5, + weight_decay=.0, + scheduler="reduce_on_plateau", + use_amp=False, + save_freq=1, +) +``` +### Setup the Trainer +Now that we have our training config we can setup the Trainer. +```python +trainer = TextClassificationTrainer( + config=train_config, + model=model, + train_dataset=train_dataset, + eval_dataset=eval_dataset, + data_collator=train_dataset.data_collator, + preprocessor=preprocessor, +) +``` +### Start Training +```python +trainer.train() +``` +``` +Epoch: 1/5 100%|####################################| 3576/3576 [07:07<00:00, 8.37batch/s, f1=0.732, loss=0.619] +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 38.64batch/s, f1=0.8, loss=0.473] +Epoch: 2/5 100%|####################################| 3576/3576 [07:00<00:00, 8.50batch/s, f1=0.807, loss=0.47] +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 39.87batch/s, f1=0.838, loss=0.419] +Epoch: 3/5 100%|####################################| 3576/3576 [07:01<00:00, 8.48batch/s, f1=0.864, loss=0.348] +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 39.97batch/s, f1=0.875, loss=0.346] +Epoch: 4/5 100%|####################################| 3576/3576 [06:57<00:00, 8.56batch/s, f1=0.919, loss=0.227] +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 38.84batch/s, f1=0.875, loss=0.381] +Epoch: 5/5 100%|####################################| 3576/3576 [07:02<00:00, 8.46batch/s, f1=0.943, loss=0.156] +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 39.71batch/s, f1=0.887, loss=0.446] +``` +### Evaluate +```python +trainer.evaluate() +``` +``` +Evaluating... 100%|####################################| 290/290 [00:07<00:00, 39.46batch/s, f1=0.887, loss=0.445] +``` +## Push everything +Now you can push your trained model to the Hub. The files to push are the model, model config, preprocessor, trainer config, +etc. +```python +trainer.push_to_hub("arxyzan/distilbert-fa-sentiment-dksf") +``` \ No newline at end of file diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 00000000..30fee9d0 --- /dev/null +++ b/_static/basic.css @@ -0,0 +1,925 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a:visited { + color: #551A8B; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +nav.contents, +aside.topic, +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +nav.contents, +aside.topic, +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +nav.contents > :last-child, +aside.topic > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +nav.contents::after, +aside.topic::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +.sig dd { + margin-top: 0px; + margin-bottom: 0px; +} + +.sig dl { + margin-top: 0px; + margin-bottom: 0px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +.translated { + background-color: rgba(207, 255, 207, 0.2) +} + +.untranslated { + background-color: rgba(255, 207, 207, 0.2) +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/_static/debug.css b/_static/debug.css new file mode 100644 index 00000000..74d4aec3 --- /dev/null +++ b/_static/debug.css @@ -0,0 +1,69 @@ +/* + This CSS file should be overridden by the theme authors. It's + meant for debugging and developing the skeleton that this theme provides. +*/ +body { + font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, + "Apple Color Emoji", "Segoe UI Emoji"; + background: lavender; +} +.sb-announcement { + background: rgb(131, 131, 131); +} +.sb-announcement__inner { + background: black; + color: white; +} +.sb-header { + background: lightskyblue; +} +.sb-header__inner { + background: royalblue; + color: white; +} +.sb-header-secondary { + background: lightcyan; +} +.sb-header-secondary__inner { + background: cornflowerblue; + color: white; +} +.sb-sidebar-primary { + background: lightgreen; +} +.sb-main { + background: blanchedalmond; +} +.sb-main__inner { + background: antiquewhite; +} +.sb-header-article { + background: lightsteelblue; +} +.sb-article-container { + background: snow; +} +.sb-article-main { + background: white; +} +.sb-footer-article { + background: lightpink; +} +.sb-sidebar-secondary { + background: lightgoldenrodyellow; +} +.sb-footer-content { + background: plum; +} +.sb-footer-content__inner { + background: palevioletred; +} +.sb-footer { + background: pink; +} +.sb-footer__inner { + background: salmon; +} +.sb-article { + background: white; +} diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 00000000..d06a71d7 --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/_static/documentation_options.js b/_static/documentation_options.js new file mode 100644 index 00000000..7e4c114f --- /dev/null +++ b/_static/documentation_options.js @@ -0,0 +1,13 @@ +const DOCUMENTATION_OPTIONS = { + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/_static/hezar_logo.svg b/_static/hezar_logo.svg new file mode 100644 index 00000000..6f32bc1d --- /dev/null +++ b/_static/hezar_logo.svg @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/_static/language_data.js b/_static/language_data.js new file mode 100644 index 00000000..250f5665 --- /dev/null +++ b/_static/language_data.js @@ -0,0 +1,199 @@ +/* + * language_data.js + * ~~~~~~~~~~~~~~~~ + * + * This script contains the language-specific data used by searchtools.js, + * namely the list of stopwords, stemmer, scorer and splitter. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; + + +/* Non-minified version is copied as a separate JS file, is available */ + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/_static/minus.png b/_static/minus.png new file mode 100644 index 0000000000000000000000000000000000000000..d96755fdaf8bb2214971e0db9c1fd3077d7c419d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu=nj kDsEF_5m^0CR;1wuP-*O&G^0G}KYk!hp00i_>zopr08q^qX#fBK literal 0 HcmV?d00001 diff --git a/_static/plus.png b/_static/plus.png new file mode 100644 index 0000000000000000000000000000000000000000..7107cec93a979b9a5f64843235a16651d563ce2d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu>-2 m3q%Vub%g%s<8sJhVPMczOq}xhg9DJoz~JfX=d#Wzp$Pyb1r*Kz literal 0 HcmV?d00001 diff --git a/_static/pygments.css b/_static/pygments.css new file mode 100644 index 00000000..5ca2352f --- /dev/null +++ b/_static/pygments.css @@ -0,0 +1,247 @@ +.highlight pre { line-height: 125%; } +.highlight td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +.highlight span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +.highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight .hll { background-color: #ffffcc } +.highlight { background: #f8f8f8; } +.highlight .c { color: #008800; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #AA22FF; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .ch { color: #008800; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #008800; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #008800 } /* Comment.Preproc */ +.highlight .cpf { color: #008800; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #008800; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #008800; font-weight: bold } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +.highlight .gr { color: #FF0000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #888888 } /* Generic.Output */ +.highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0044DD } /* Generic.Traceback */ +.highlight .kc { color: #AA22FF; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #AA22FF; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #AA22FF; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #AA22FF } /* Keyword.Pseudo */ +.highlight .kr { color: #AA22FF; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #00BB00; font-weight: bold } /* Keyword.Type */ +.highlight .m { color: #666666 } /* Literal.Number */ +.highlight .s { color: #BB4444 } /* Literal.String */ +.highlight .na { color: #BB4444 } /* Name.Attribute */ +.highlight .nb { color: #AA22FF } /* Name.Builtin */ +.highlight .nc { color: #0000FF } /* Name.Class */ +.highlight .no { color: #880000 } /* Name.Constant */ +.highlight .nd { color: #AA22FF } /* Name.Decorator */ +.highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #00A000 } /* Name.Function */ +.highlight .nl { color: #A0A000 } /* Name.Label */ +.highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #B8860B } /* Name.Variable */ +.highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mb { color: #666666 } /* Literal.Number.Bin */ +.highlight .mf { color: #666666 } /* Literal.Number.Float */ +.highlight .mh { color: #666666 } /* Literal.Number.Hex */ +.highlight .mi { color: #666666 } /* Literal.Number.Integer */ +.highlight .mo { color: #666666 } /* Literal.Number.Oct */ +.highlight .sa { color: #BB4444 } /* Literal.String.Affix */ +.highlight .sb { color: #BB4444 } /* Literal.String.Backtick */ +.highlight .sc { color: #BB4444 } /* Literal.String.Char */ +.highlight .dl { color: #BB4444 } /* Literal.String.Delimiter */ +.highlight .sd { color: #BB4444; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #BB4444 } /* Literal.String.Double */ +.highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #BB4444 } /* Literal.String.Heredoc */ +.highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */ +.highlight .sx { color: #008000 } /* Literal.String.Other */ +.highlight .sr { color: #BB6688 } /* Literal.String.Regex */ +.highlight .s1 { color: #BB4444 } /* Literal.String.Single */ +.highlight .ss { color: #B8860B } /* Literal.String.Symbol */ +.highlight .bp { color: #AA22FF } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #00A000 } /* Name.Function.Magic */ +.highlight .vc { color: #B8860B } /* Name.Variable.Class */ +.highlight .vg { color: #B8860B } /* Name.Variable.Global */ +.highlight .vi { color: #B8860B } /* Name.Variable.Instance */ +.highlight .vm { color: #B8860B } /* Name.Variable.Magic */ +.highlight .il { color: #666666 } /* Literal.Number.Integer.Long */ +@media not print { +body[data-theme="dark"] .highlight pre { line-height: 125%; } +body[data-theme="dark"] .highlight td.linenos .normal { color: #37474F; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight span.linenos { color: #37474F; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight td.linenos .special { color: #607A86; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight span.linenos.special { color: #607A86; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight .hll { background-color: #2C3B41 } +body[data-theme="dark"] .highlight { background: #263238; color: #EEFFFF } +body[data-theme="dark"] .highlight .c { color: #546E7A; font-style: italic } /* Comment */ +body[data-theme="dark"] .highlight .err { color: #FF5370 } /* Error */ +body[data-theme="dark"] .highlight .esc { color: #89DDFF } /* Escape */ +body[data-theme="dark"] .highlight .g { color: #EEFFFF } /* Generic */ +body[data-theme="dark"] .highlight .k { color: #BB80B3 } /* Keyword */ +body[data-theme="dark"] .highlight .l { color: #C3E88D } /* Literal */ +body[data-theme="dark"] .highlight .n { color: #EEFFFF } /* Name */ +body[data-theme="dark"] .highlight .o { color: #89DDFF } /* Operator */ +body[data-theme="dark"] .highlight .p { color: #89DDFF } /* Punctuation */ +body[data-theme="dark"] .highlight .ch { color: #546E7A; font-style: italic } /* Comment.Hashbang */ +body[data-theme="dark"] .highlight .cm { color: #546E7A; font-style: italic } /* Comment.Multiline */ +body[data-theme="dark"] .highlight .cp { color: #546E7A; font-style: italic } /* Comment.Preproc */ +body[data-theme="dark"] .highlight .cpf { color: #546E7A; font-style: italic } /* Comment.PreprocFile */ +body[data-theme="dark"] .highlight .c1 { color: #546E7A; font-style: italic } /* Comment.Single */ +body[data-theme="dark"] .highlight .cs { color: #546E7A; font-style: italic } /* Comment.Special */ +body[data-theme="dark"] .highlight .gd { color: #FF5370 } /* Generic.Deleted */ +body[data-theme="dark"] .highlight .ge { color: #89DDFF } /* Generic.Emph */ +body[data-theme="dark"] .highlight .ges { color: #FFCB6B } /* Generic.EmphStrong */ +body[data-theme="dark"] .highlight .gr { color: #FF5370 } /* Generic.Error */ +body[data-theme="dark"] .highlight .gh { color: #C3E88D } /* Generic.Heading */ +body[data-theme="dark"] .highlight .gi { color: #C3E88D } /* Generic.Inserted */ +body[data-theme="dark"] .highlight .go { color: #546E7A } /* Generic.Output */ +body[data-theme="dark"] .highlight .gp { color: #FFCB6B } /* Generic.Prompt */ +body[data-theme="dark"] .highlight .gs { color: #FF5370 } /* Generic.Strong */ +body[data-theme="dark"] .highlight .gu { color: #89DDFF } /* Generic.Subheading */ +body[data-theme="dark"] .highlight .gt { color: #FF5370 } /* Generic.Traceback */ +body[data-theme="dark"] .highlight .kc { color: #89DDFF } /* Keyword.Constant */ +body[data-theme="dark"] .highlight .kd { color: #BB80B3 } /* Keyword.Declaration */ +body[data-theme="dark"] .highlight .kn { color: #89DDFF; font-style: italic } /* Keyword.Namespace */ +body[data-theme="dark"] .highlight .kp { color: #89DDFF } /* Keyword.Pseudo */ +body[data-theme="dark"] .highlight .kr { color: #BB80B3 } /* Keyword.Reserved */ +body[data-theme="dark"] .highlight .kt { color: #BB80B3 } /* Keyword.Type */ +body[data-theme="dark"] .highlight .ld { color: #C3E88D } /* Literal.Date */ +body[data-theme="dark"] .highlight .m { color: #F78C6C } /* Literal.Number */ +body[data-theme="dark"] .highlight .s { color: #C3E88D } /* Literal.String */ +body[data-theme="dark"] .highlight .na { color: #BB80B3 } /* Name.Attribute */ +body[data-theme="dark"] .highlight .nb { color: #82AAFF } /* Name.Builtin */ +body[data-theme="dark"] .highlight .nc { color: #FFCB6B } /* Name.Class */ +body[data-theme="dark"] .highlight .no { color: #EEFFFF } /* Name.Constant */ +body[data-theme="dark"] .highlight .nd { color: #82AAFF } /* Name.Decorator */ +body[data-theme="dark"] .highlight .ni { color: #89DDFF } /* Name.Entity */ +body[data-theme="dark"] .highlight .ne { color: #FFCB6B } /* Name.Exception */ +body[data-theme="dark"] .highlight .nf { color: #82AAFF } /* Name.Function */ +body[data-theme="dark"] .highlight .nl { color: #82AAFF } /* Name.Label */ +body[data-theme="dark"] .highlight .nn { color: #FFCB6B } /* Name.Namespace */ +body[data-theme="dark"] .highlight .nx { color: #EEFFFF } /* Name.Other */ +body[data-theme="dark"] .highlight .py { color: #FFCB6B } /* Name.Property */ +body[data-theme="dark"] .highlight .nt { color: #FF5370 } /* Name.Tag */ +body[data-theme="dark"] .highlight .nv { color: #89DDFF } /* Name.Variable */ +body[data-theme="dark"] .highlight .ow { color: #89DDFF; font-style: italic } /* Operator.Word */ +body[data-theme="dark"] .highlight .pm { color: #89DDFF } /* Punctuation.Marker */ +body[data-theme="dark"] .highlight .w { color: #EEFFFF } /* Text.Whitespace */ +body[data-theme="dark"] .highlight .mb { color: #F78C6C } /* Literal.Number.Bin */ +body[data-theme="dark"] .highlight .mf { color: #F78C6C } /* Literal.Number.Float */ +body[data-theme="dark"] .highlight .mh { color: #F78C6C } /* Literal.Number.Hex */ +body[data-theme="dark"] .highlight .mi { color: #F78C6C } /* Literal.Number.Integer */ +body[data-theme="dark"] .highlight .mo { color: #F78C6C } /* Literal.Number.Oct */ +body[data-theme="dark"] .highlight .sa { color: #BB80B3 } /* Literal.String.Affix */ +body[data-theme="dark"] .highlight .sb { color: #C3E88D } /* Literal.String.Backtick */ +body[data-theme="dark"] .highlight .sc { color: #C3E88D } /* Literal.String.Char */ +body[data-theme="dark"] .highlight .dl { color: #EEFFFF } /* Literal.String.Delimiter */ +body[data-theme="dark"] .highlight .sd { color: #546E7A; font-style: italic } /* Literal.String.Doc */ +body[data-theme="dark"] .highlight .s2 { color: #C3E88D } /* Literal.String.Double */ +body[data-theme="dark"] .highlight .se { color: #EEFFFF } /* Literal.String.Escape */ +body[data-theme="dark"] .highlight .sh { color: #C3E88D } /* Literal.String.Heredoc */ +body[data-theme="dark"] .highlight .si { color: #89DDFF } /* Literal.String.Interpol */ +body[data-theme="dark"] .highlight .sx { color: #C3E88D } /* Literal.String.Other */ +body[data-theme="dark"] .highlight .sr { color: #89DDFF } /* Literal.String.Regex */ +body[data-theme="dark"] .highlight .s1 { color: #C3E88D } /* Literal.String.Single */ +body[data-theme="dark"] .highlight .ss { color: #89DDFF } /* Literal.String.Symbol */ +body[data-theme="dark"] .highlight .bp { color: #89DDFF } /* Name.Builtin.Pseudo */ +body[data-theme="dark"] .highlight .fm { color: #82AAFF } /* Name.Function.Magic */ +body[data-theme="dark"] .highlight .vc { color: #89DDFF } /* Name.Variable.Class */ +body[data-theme="dark"] .highlight .vg { color: #89DDFF } /* Name.Variable.Global */ +body[data-theme="dark"] .highlight .vi { color: #89DDFF } /* Name.Variable.Instance */ +body[data-theme="dark"] .highlight .vm { color: #82AAFF } /* Name.Variable.Magic */ +body[data-theme="dark"] .highlight .il { color: #F78C6C } /* Literal.Number.Integer.Long */ +@media (prefers-color-scheme: dark) { +body:not([data-theme="light"]) .highlight pre { line-height: 125%; } +body:not([data-theme="light"]) .highlight td.linenos .normal { color: #37474F; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight span.linenos { color: #37474F; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight td.linenos .special { color: #607A86; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight span.linenos.special { color: #607A86; background-color: #263238; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight .hll { background-color: #2C3B41 } +body:not([data-theme="light"]) .highlight { background: #263238; color: #EEFFFF } +body:not([data-theme="light"]) .highlight .c { color: #546E7A; font-style: italic } /* Comment */ +body:not([data-theme="light"]) .highlight .err { color: #FF5370 } /* Error */ +body:not([data-theme="light"]) .highlight .esc { color: #89DDFF } /* Escape */ +body:not([data-theme="light"]) .highlight .g { color: #EEFFFF } /* Generic */ +body:not([data-theme="light"]) .highlight .k { color: #BB80B3 } /* Keyword */ +body:not([data-theme="light"]) .highlight .l { color: #C3E88D } /* Literal */ +body:not([data-theme="light"]) .highlight .n { color: #EEFFFF } /* Name */ +body:not([data-theme="light"]) .highlight .o { color: #89DDFF } /* Operator */ +body:not([data-theme="light"]) .highlight .p { color: #89DDFF } /* Punctuation */ +body:not([data-theme="light"]) .highlight .ch { color: #546E7A; font-style: italic } /* Comment.Hashbang */ +body:not([data-theme="light"]) .highlight .cm { color: #546E7A; font-style: italic } /* Comment.Multiline */ +body:not([data-theme="light"]) .highlight .cp { color: #546E7A; font-style: italic } /* Comment.Preproc */ +body:not([data-theme="light"]) .highlight .cpf { color: #546E7A; font-style: italic } /* Comment.PreprocFile */ +body:not([data-theme="light"]) .highlight .c1 { color: #546E7A; font-style: italic } /* Comment.Single */ +body:not([data-theme="light"]) .highlight .cs { color: #546E7A; font-style: italic } /* Comment.Special */ +body:not([data-theme="light"]) .highlight .gd { color: #FF5370 } /* Generic.Deleted */ +body:not([data-theme="light"]) .highlight .ge { color: #89DDFF } /* Generic.Emph */ +body:not([data-theme="light"]) .highlight .ges { color: #FFCB6B } /* Generic.EmphStrong */ +body:not([data-theme="light"]) .highlight .gr { color: #FF5370 } /* Generic.Error */ +body:not([data-theme="light"]) .highlight .gh { color: #C3E88D } /* Generic.Heading */ +body:not([data-theme="light"]) .highlight .gi { color: #C3E88D } /* Generic.Inserted */ +body:not([data-theme="light"]) .highlight .go { color: #546E7A } /* Generic.Output */ +body:not([data-theme="light"]) .highlight .gp { color: #FFCB6B } /* Generic.Prompt */ +body:not([data-theme="light"]) .highlight .gs { color: #FF5370 } /* Generic.Strong */ +body:not([data-theme="light"]) .highlight .gu { color: #89DDFF } /* Generic.Subheading */ +body:not([data-theme="light"]) .highlight .gt { color: #FF5370 } /* Generic.Traceback */ +body:not([data-theme="light"]) .highlight .kc { color: #89DDFF } /* Keyword.Constant */ +body:not([data-theme="light"]) .highlight .kd { color: #BB80B3 } /* Keyword.Declaration */ +body:not([data-theme="light"]) .highlight .kn { color: #89DDFF; font-style: italic } /* Keyword.Namespace */ +body:not([data-theme="light"]) .highlight .kp { color: #89DDFF } /* Keyword.Pseudo */ +body:not([data-theme="light"]) .highlight .kr { color: #BB80B3 } /* Keyword.Reserved */ +body:not([data-theme="light"]) .highlight .kt { color: #BB80B3 } /* Keyword.Type */ +body:not([data-theme="light"]) .highlight .ld { color: #C3E88D } /* Literal.Date */ +body:not([data-theme="light"]) .highlight .m { color: #F78C6C } /* Literal.Number */ +body:not([data-theme="light"]) .highlight .s { color: #C3E88D } /* Literal.String */ +body:not([data-theme="light"]) .highlight .na { color: #BB80B3 } /* Name.Attribute */ +body:not([data-theme="light"]) .highlight .nb { color: #82AAFF } /* Name.Builtin */ +body:not([data-theme="light"]) .highlight .nc { color: #FFCB6B } /* Name.Class */ +body:not([data-theme="light"]) .highlight .no { color: #EEFFFF } /* Name.Constant */ +body:not([data-theme="light"]) .highlight .nd { color: #82AAFF } /* Name.Decorator */ +body:not([data-theme="light"]) .highlight .ni { color: #89DDFF } /* Name.Entity */ +body:not([data-theme="light"]) .highlight .ne { color: #FFCB6B } /* Name.Exception */ +body:not([data-theme="light"]) .highlight .nf { color: #82AAFF } /* Name.Function */ +body:not([data-theme="light"]) .highlight .nl { color: #82AAFF } /* Name.Label */ +body:not([data-theme="light"]) .highlight .nn { color: #FFCB6B } /* Name.Namespace */ +body:not([data-theme="light"]) .highlight .nx { color: #EEFFFF } /* Name.Other */ +body:not([data-theme="light"]) .highlight .py { color: #FFCB6B } /* Name.Property */ +body:not([data-theme="light"]) .highlight .nt { color: #FF5370 } /* Name.Tag */ +body:not([data-theme="light"]) .highlight .nv { color: #89DDFF } /* Name.Variable */ +body:not([data-theme="light"]) .highlight .ow { color: #89DDFF; font-style: italic } /* Operator.Word */ +body:not([data-theme="light"]) .highlight .pm { color: #89DDFF } /* Punctuation.Marker */ +body:not([data-theme="light"]) .highlight .w { color: #EEFFFF } /* Text.Whitespace */ +body:not([data-theme="light"]) .highlight .mb { color: #F78C6C } /* Literal.Number.Bin */ +body:not([data-theme="light"]) .highlight .mf { color: #F78C6C } /* Literal.Number.Float */ +body:not([data-theme="light"]) .highlight .mh { color: #F78C6C } /* Literal.Number.Hex */ +body:not([data-theme="light"]) .highlight .mi { color: #F78C6C } /* Literal.Number.Integer */ +body:not([data-theme="light"]) .highlight .mo { color: #F78C6C } /* Literal.Number.Oct */ +body:not([data-theme="light"]) .highlight .sa { color: #BB80B3 } /* Literal.String.Affix */ +body:not([data-theme="light"]) .highlight .sb { color: #C3E88D } /* Literal.String.Backtick */ +body:not([data-theme="light"]) .highlight .sc { color: #C3E88D } /* Literal.String.Char */ +body:not([data-theme="light"]) .highlight .dl { color: #EEFFFF } /* Literal.String.Delimiter */ +body:not([data-theme="light"]) .highlight .sd { color: #546E7A; font-style: italic } /* Literal.String.Doc */ +body:not([data-theme="light"]) .highlight .s2 { color: #C3E88D } /* Literal.String.Double */ +body:not([data-theme="light"]) .highlight .se { color: #EEFFFF } /* Literal.String.Escape */ +body:not([data-theme="light"]) .highlight .sh { color: #C3E88D } /* Literal.String.Heredoc */ +body:not([data-theme="light"]) .highlight .si { color: #89DDFF } /* Literal.String.Interpol */ +body:not([data-theme="light"]) .highlight .sx { color: #C3E88D } /* Literal.String.Other */ +body:not([data-theme="light"]) .highlight .sr { color: #89DDFF } /* Literal.String.Regex */ +body:not([data-theme="light"]) .highlight .s1 { color: #C3E88D } /* Literal.String.Single */ +body:not([data-theme="light"]) .highlight .ss { color: #89DDFF } /* Literal.String.Symbol */ +body:not([data-theme="light"]) .highlight .bp { color: #89DDFF } /* Name.Builtin.Pseudo */ +body:not([data-theme="light"]) .highlight .fm { color: #82AAFF } /* Name.Function.Magic */ +body:not([data-theme="light"]) .highlight .vc { color: #89DDFF } /* Name.Variable.Class */ +body:not([data-theme="light"]) .highlight .vg { color: #89DDFF } /* Name.Variable.Global */ +body:not([data-theme="light"]) .highlight .vi { color: #89DDFF } /* Name.Variable.Instance */ +body:not([data-theme="light"]) .highlight .vm { color: #82AAFF } /* Name.Variable.Magic */ +body:not([data-theme="light"]) .highlight .il { color: #F78C6C } /* Literal.Number.Integer.Long */ +} +} \ No newline at end of file diff --git a/_static/scripts/furo-extensions.js b/_static/scripts/furo-extensions.js new file mode 100644 index 00000000..e69de29b diff --git a/_static/scripts/furo.js b/_static/scripts/furo.js new file mode 100644 index 00000000..32e7c05b --- /dev/null +++ b/_static/scripts/furo.js @@ -0,0 +1,3 @@ +/*! For license information please see furo.js.LICENSE.txt */ +(()=>{var t={212:function(t,e,n){var o,r;r=void 0!==n.g?n.g:"undefined"!=typeof window?window:this,o=function(){return function(t){"use strict";var e={navClass:"active",contentClass:"active",nested:!1,nestedClass:"active",offset:0,reflow:!1,events:!0},n=function(t,e,n){if(n.settings.events){var o=new CustomEvent(t,{bubbles:!0,cancelable:!0,detail:n});e.dispatchEvent(o)}},o=function(t){var e=0;if(t.offsetParent)for(;t;)e+=t.offsetTop,t=t.offsetParent;return e>=0?e:0},r=function(t){t&&t.sort((function(t,e){return o(t.content)=Math.max(document.body.scrollHeight,document.documentElement.scrollHeight,document.body.offsetHeight,document.documentElement.offsetHeight,document.body.clientHeight,document.documentElement.clientHeight)},l=function(t,e){var n=t[t.length-1];if(function(t,e){return!(!s()||!c(t.content,e,!0))}(n,e))return n;for(var o=t.length-1;o>=0;o--)if(c(t[o].content,e))return t[o]},a=function(t,e){if(e.nested&&t.parentNode){var n=t.parentNode.closest("li");n&&(n.classList.remove(e.nestedClass),a(n,e))}},i=function(t,e){if(t){var o=t.nav.closest("li");o&&(o.classList.remove(e.navClass),t.content.classList.remove(e.contentClass),a(o,e),n("gumshoeDeactivate",o,{link:t.nav,content:t.content,settings:e}))}},u=function(t,e){if(e.nested){var n=t.parentNode.closest("li");n&&(n.classList.add(e.nestedClass),u(n,e))}};return function(o,c){var s,a,d,f,m,v={setup:function(){s=document.querySelectorAll(o),a=[],Array.prototype.forEach.call(s,(function(t){var e=document.getElementById(decodeURIComponent(t.hash.substr(1)));e&&a.push({nav:t,content:e})})),r(a)},detect:function(){var t=l(a,m);t?d&&t.content===d.content||(i(d,m),function(t,e){if(t){var o=t.nav.closest("li");o&&(o.classList.add(e.navClass),t.content.classList.add(e.contentClass),u(o,e),n("gumshoeActivate",o,{link:t.nav,content:t.content,settings:e}))}}(t,m),d=t):d&&(i(d,m),d=null)}},h=function(e){f&&t.cancelAnimationFrame(f),f=t.requestAnimationFrame(v.detect)},g=function(e){f&&t.cancelAnimationFrame(f),f=t.requestAnimationFrame((function(){r(a),v.detect()}))};return v.destroy=function(){d&&i(d,m),t.removeEventListener("scroll",h,!1),m.reflow&&t.removeEventListener("resize",g,!1),a=null,s=null,d=null,f=null,m=null},m=function(){var t={};return Array.prototype.forEach.call(arguments,(function(e){for(var n in e){if(!e.hasOwnProperty(n))return;t[n]=e[n]}})),t}(e,c||{}),v.setup(),v.detect(),t.addEventListener("scroll",h,!1),m.reflow&&t.addEventListener("resize",g,!1),v}}(r)}.apply(e,[]),void 0===o||(t.exports=o)}},e={};function n(o){var r=e[o];if(void 0!==r)return r.exports;var c=e[o]={exports:{}};return t[o].call(c.exports,c,c.exports,n),c.exports}n.n=t=>{var e=t&&t.__esModule?()=>t.default:()=>t;return n.d(e,{a:e}),e},n.d=(t,e)=>{for(var o in e)n.o(e,o)&&!n.o(t,o)&&Object.defineProperty(t,o,{enumerable:!0,get:e[o]})},n.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(t){if("object"==typeof window)return window}}(),n.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e),(()=>{"use strict";var t=n(212),e=n.n(t),o=null,r=null,c=window.pageYOffset||document.documentElement.scrollTop;const s=64;function l(){const t=localStorage.getItem("theme")||"auto";var e;"light"!==(e=window.matchMedia("(prefers-color-scheme: dark)").matches?"auto"===t?"light":"light"==t?"dark":"auto":"auto"===t?"dark":"dark"==t?"light":"auto")&&"dark"!==e&&"auto"!==e&&(console.error(`Got invalid theme mode: ${e}. Resetting to auto.`),e="auto"),document.body.dataset.theme=e,localStorage.setItem("theme",e),console.log(`Changed to ${e} mode.`)}function a(){!function(){const t=document.getElementsByClassName("theme-toggle");Array.from(t).forEach((t=>{t.addEventListener("click",l)}))}(),function(){let t=0,e=!1;window.addEventListener("scroll",(function(n){t=window.scrollY,e||(window.requestAnimationFrame((function(){var n;n=t,0==Math.floor(r.getBoundingClientRect().top)?r.classList.add("scrolled"):r.classList.remove("scrolled"),function(t){tc&&document.documentElement.classList.remove("show-back-to-top"),c=t}(n),function(t){null!==o&&(0==t?o.scrollTo(0,0):Math.ceil(t)>=Math.floor(document.documentElement.scrollHeight-window.innerHeight)?o.scrollTo(0,o.scrollHeight):document.querySelector(".scroll-current"))}(n),e=!1})),e=!0)})),window.scroll()}(),null!==o&&new(e())(".toc-tree a",{reflow:!0,recursive:!0,navClass:"scroll-current",offset:()=>{let t=parseFloat(getComputedStyle(document.documentElement).fontSize);return r.getBoundingClientRect().height+.5*t+1}})}document.addEventListener("DOMContentLoaded",(function(){document.body.parentNode.classList.remove("no-js"),r=document.querySelector("header"),o=document.querySelector(".toc-scroll"),a()}))})()})(); +//# sourceMappingURL=furo.js.map \ No newline at end of file diff --git a/_static/scripts/furo.js.LICENSE.txt b/_static/scripts/furo.js.LICENSE.txt new file mode 100644 index 00000000..1632189c --- /dev/null +++ b/_static/scripts/furo.js.LICENSE.txt @@ -0,0 +1,7 @@ +/*! + * gumshoejs v5.1.2 (patched by @pradyunsg) + * A simple, framework-agnostic scrollspy script. + * (c) 2019 Chris Ferdinandi + * MIT License + * http://github.com/cferdinandi/gumshoe + */ diff --git a/_static/scripts/furo.js.map b/_static/scripts/furo.js.map new file mode 100644 index 00000000..7b7ddb11 --- /dev/null +++ b/_static/scripts/furo.js.map @@ -0,0 +1 @@ +{"version":3,"file":"scripts/furo.js","mappings":"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","sources":["webpack:///./src/furo/assets/scripts/gumshoe-patched.js","webpack:///webpack/bootstrap","webpack:///webpack/runtime/compat get default export","webpack:///webpack/runtime/define property getters","webpack:///webpack/runtime/global","webpack:///webpack/runtime/hasOwnProperty shorthand","webpack:///./src/furo/assets/scripts/furo.js"],"sourcesContent":["/*!\n * gumshoejs v5.1.2 (patched by @pradyunsg)\n * A simple, framework-agnostic scrollspy script.\n * (c) 2019 Chris Ferdinandi\n * MIT License\n * http://github.com/cferdinandi/gumshoe\n */\n\n(function (root, factory) {\n if (typeof define === \"function\" && define.amd) {\n define([], function () {\n return factory(root);\n });\n } else if (typeof exports === \"object\") {\n module.exports = factory(root);\n } else {\n root.Gumshoe = factory(root);\n }\n})(\n typeof global !== \"undefined\"\n ? global\n : typeof window !== \"undefined\"\n ? window\n : this,\n function (window) {\n \"use strict\";\n\n //\n // Defaults\n //\n\n var defaults = {\n // Active classes\n navClass: \"active\",\n contentClass: \"active\",\n\n // Nested navigation\n nested: false,\n nestedClass: \"active\",\n\n // Offset & reflow\n offset: 0,\n reflow: false,\n\n // Event support\n events: true,\n };\n\n //\n // Methods\n //\n\n /**\n * Merge two or more objects together.\n * @param {Object} objects The objects to merge together\n * @returns {Object} Merged values of defaults and options\n */\n var extend = function () {\n var merged = {};\n Array.prototype.forEach.call(arguments, function (obj) {\n for (var key in obj) {\n if (!obj.hasOwnProperty(key)) return;\n merged[key] = obj[key];\n }\n });\n return merged;\n };\n\n /**\n * Emit a custom event\n * @param {String} type The event type\n * @param {Node} elem The element to attach the event to\n * @param {Object} detail Any details to pass along with the event\n */\n var emitEvent = function (type, elem, detail) {\n // Make sure events are enabled\n if (!detail.settings.events) return;\n\n // Create a new event\n var event = new CustomEvent(type, {\n bubbles: true,\n cancelable: true,\n detail: detail,\n });\n\n // Dispatch the event\n elem.dispatchEvent(event);\n };\n\n /**\n * Get an element's distance from the top of the Document.\n * @param {Node} elem The element\n * @return {Number} Distance from the top in pixels\n */\n var getOffsetTop = function (elem) {\n var location = 0;\n if (elem.offsetParent) {\n while (elem) {\n location += elem.offsetTop;\n elem = elem.offsetParent;\n }\n }\n return location >= 0 ? location : 0;\n };\n\n /**\n * Sort content from first to last in the DOM\n * @param {Array} contents The content areas\n */\n var sortContents = function (contents) {\n if (contents) {\n contents.sort(function (item1, item2) {\n var offset1 = getOffsetTop(item1.content);\n var offset2 = getOffsetTop(item2.content);\n if (offset1 < offset2) return -1;\n return 1;\n });\n }\n };\n\n /**\n * Get the offset to use for calculating position\n * @param {Object} settings The settings for this instantiation\n * @return {Float} The number of pixels to offset the calculations\n */\n var getOffset = function (settings) {\n // if the offset is a function run it\n if (typeof settings.offset === \"function\") {\n return parseFloat(settings.offset());\n }\n\n // Otherwise, return it as-is\n return parseFloat(settings.offset);\n };\n\n /**\n * Get the document element's height\n * @private\n * @returns {Number}\n */\n var getDocumentHeight = function () {\n return Math.max(\n document.body.scrollHeight,\n document.documentElement.scrollHeight,\n document.body.offsetHeight,\n document.documentElement.offsetHeight,\n document.body.clientHeight,\n document.documentElement.clientHeight,\n );\n };\n\n /**\n * Determine if an element is in view\n * @param {Node} elem The element\n * @param {Object} settings The settings for this instantiation\n * @param {Boolean} bottom If true, check if element is above bottom of viewport instead\n * @return {Boolean} Returns true if element is in the viewport\n */\n var isInView = function (elem, settings, bottom) {\n var bounds = elem.getBoundingClientRect();\n var offset = getOffset(settings);\n if (bottom) {\n return (\n parseInt(bounds.bottom, 10) <\n (window.innerHeight || document.documentElement.clientHeight)\n );\n }\n return parseInt(bounds.top, 10) <= offset;\n };\n\n /**\n * Check if at the bottom of the viewport\n * @return {Boolean} If true, page is at the bottom of the viewport\n */\n var isAtBottom = function () {\n if (\n Math.ceil(window.innerHeight + window.pageYOffset) >=\n getDocumentHeight()\n )\n return true;\n return false;\n };\n\n /**\n * Check if the last item should be used (even if not at the top of the page)\n * @param {Object} item The last item\n * @param {Object} settings The settings for this instantiation\n * @return {Boolean} If true, use the last item\n */\n var useLastItem = function (item, settings) {\n if (isAtBottom() && isInView(item.content, settings, true)) return true;\n return false;\n };\n\n /**\n * Get the active content\n * @param {Array} contents The content areas\n * @param {Object} settings The settings for this instantiation\n * @return {Object} The content area and matching navigation link\n */\n var getActive = function (contents, settings) {\n var last = contents[contents.length - 1];\n if (useLastItem(last, settings)) return last;\n for (var i = contents.length - 1; i >= 0; i--) {\n if (isInView(contents[i].content, settings)) return contents[i];\n }\n };\n\n /**\n * Deactivate parent navs in a nested navigation\n * @param {Node} nav The starting navigation element\n * @param {Object} settings The settings for this instantiation\n */\n var deactivateNested = function (nav, settings) {\n // If nesting isn't activated, bail\n if (!settings.nested || !nav.parentNode) return;\n\n // Get the parent navigation\n var li = nav.parentNode.closest(\"li\");\n if (!li) return;\n\n // Remove the active class\n li.classList.remove(settings.nestedClass);\n\n // Apply recursively to any parent navigation elements\n deactivateNested(li, settings);\n };\n\n /**\n * Deactivate a nav and content area\n * @param {Object} items The nav item and content to deactivate\n * @param {Object} settings The settings for this instantiation\n */\n var deactivate = function (items, settings) {\n // Make sure there are items to deactivate\n if (!items) return;\n\n // Get the parent list item\n var li = items.nav.closest(\"li\");\n if (!li) return;\n\n // Remove the active class from the nav and content\n li.classList.remove(settings.navClass);\n items.content.classList.remove(settings.contentClass);\n\n // Deactivate any parent navs in a nested navigation\n deactivateNested(li, settings);\n\n // Emit a custom event\n emitEvent(\"gumshoeDeactivate\", li, {\n link: items.nav,\n content: items.content,\n settings: settings,\n });\n };\n\n /**\n * Activate parent navs in a nested navigation\n * @param {Node} nav The starting navigation element\n * @param {Object} settings The settings for this instantiation\n */\n var activateNested = function (nav, settings) {\n // If nesting isn't activated, bail\n if (!settings.nested) return;\n\n // Get the parent navigation\n var li = nav.parentNode.closest(\"li\");\n if (!li) return;\n\n // Add the active class\n li.classList.add(settings.nestedClass);\n\n // Apply recursively to any parent navigation elements\n activateNested(li, settings);\n };\n\n /**\n * Activate a nav and content area\n * @param {Object} items The nav item and content to activate\n * @param {Object} settings The settings for this instantiation\n */\n var activate = function (items, settings) {\n // Make sure there are items to activate\n if (!items) return;\n\n // Get the parent list item\n var li = items.nav.closest(\"li\");\n if (!li) return;\n\n // Add the active class to the nav and content\n li.classList.add(settings.navClass);\n items.content.classList.add(settings.contentClass);\n\n // Activate any parent navs in a nested navigation\n activateNested(li, settings);\n\n // Emit a custom event\n emitEvent(\"gumshoeActivate\", li, {\n link: items.nav,\n content: items.content,\n settings: settings,\n });\n };\n\n /**\n * Create the Constructor object\n * @param {String} selector The selector to use for navigation items\n * @param {Object} options User options and settings\n */\n var Constructor = function (selector, options) {\n //\n // Variables\n //\n\n var publicAPIs = {};\n var navItems, contents, current, timeout, settings;\n\n //\n // Methods\n //\n\n /**\n * Set variables from DOM elements\n */\n publicAPIs.setup = function () {\n // Get all nav items\n navItems = document.querySelectorAll(selector);\n\n // Create contents array\n contents = [];\n\n // Loop through each item, get it's matching content, and push to the array\n Array.prototype.forEach.call(navItems, function (item) {\n // Get the content for the nav item\n var content = document.getElementById(\n decodeURIComponent(item.hash.substr(1)),\n );\n if (!content) return;\n\n // Push to the contents array\n contents.push({\n nav: item,\n content: content,\n });\n });\n\n // Sort contents by the order they appear in the DOM\n sortContents(contents);\n };\n\n /**\n * Detect which content is currently active\n */\n publicAPIs.detect = function () {\n // Get the active content\n var active = getActive(contents, settings);\n\n // if there's no active content, deactivate and bail\n if (!active) {\n if (current) {\n deactivate(current, settings);\n current = null;\n }\n return;\n }\n\n // If the active content is the one currently active, do nothing\n if (current && active.content === current.content) return;\n\n // Deactivate the current content and activate the new content\n deactivate(current, settings);\n activate(active, settings);\n\n // Update the currently active content\n current = active;\n };\n\n /**\n * Detect the active content on scroll\n * Debounced for performance\n */\n var scrollHandler = function (event) {\n // If there's a timer, cancel it\n if (timeout) {\n window.cancelAnimationFrame(timeout);\n }\n\n // Setup debounce callback\n timeout = window.requestAnimationFrame(publicAPIs.detect);\n };\n\n /**\n * Update content sorting on resize\n * Debounced for performance\n */\n var resizeHandler = function (event) {\n // If there's a timer, cancel it\n if (timeout) {\n window.cancelAnimationFrame(timeout);\n }\n\n // Setup debounce callback\n timeout = window.requestAnimationFrame(function () {\n sortContents(contents);\n publicAPIs.detect();\n });\n };\n\n /**\n * Destroy the current instantiation\n */\n publicAPIs.destroy = function () {\n // Undo DOM changes\n if (current) {\n deactivate(current, settings);\n }\n\n // Remove event listeners\n window.removeEventListener(\"scroll\", scrollHandler, false);\n if (settings.reflow) {\n window.removeEventListener(\"resize\", resizeHandler, false);\n }\n\n // Reset variables\n contents = null;\n navItems = null;\n current = null;\n timeout = null;\n settings = null;\n };\n\n /**\n * Initialize the current instantiation\n */\n var init = function () {\n // Merge user options into defaults\n settings = extend(defaults, options || {});\n\n // Setup variables based on the current DOM\n publicAPIs.setup();\n\n // Find the currently active content\n publicAPIs.detect();\n\n // Setup event listeners\n window.addEventListener(\"scroll\", scrollHandler, false);\n if (settings.reflow) {\n window.addEventListener(\"resize\", resizeHandler, false);\n }\n };\n\n //\n // Initialize and return the public APIs\n //\n\n init();\n return publicAPIs;\n };\n\n //\n // Return the Constructor\n //\n\n return Constructor;\n },\n);\n","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// getDefaultExport function for compatibility with non-harmony modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.g = (function() {\n\tif (typeof globalThis === 'object') return globalThis;\n\ttry {\n\t\treturn this || new Function('return this')();\n\t} catch (e) {\n\t\tif (typeof window === 'object') return window;\n\t}\n})();","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","import Gumshoe from \"./gumshoe-patched.js\";\n\n////////////////////////////////////////////////////////////////////////////////\n// Scroll Handling\n////////////////////////////////////////////////////////////////////////////////\nvar tocScroll = null;\nvar header = null;\nvar lastScrollTop = window.pageYOffset || document.documentElement.scrollTop;\nconst GO_TO_TOP_OFFSET = 64;\n\nfunction scrollHandlerForHeader() {\n if (Math.floor(header.getBoundingClientRect().top) == 0) {\n header.classList.add(\"scrolled\");\n } else {\n header.classList.remove(\"scrolled\");\n }\n}\n\nfunction scrollHandlerForBackToTop(positionY) {\n if (positionY < GO_TO_TOP_OFFSET) {\n document.documentElement.classList.remove(\"show-back-to-top\");\n } else {\n if (positionY < lastScrollTop) {\n document.documentElement.classList.add(\"show-back-to-top\");\n } else if (positionY > lastScrollTop) {\n document.documentElement.classList.remove(\"show-back-to-top\");\n }\n }\n lastScrollTop = positionY;\n}\n\nfunction scrollHandlerForTOC(positionY) {\n if (tocScroll === null) {\n return;\n }\n\n // top of page.\n if (positionY == 0) {\n tocScroll.scrollTo(0, 0);\n } else if (\n // bottom of page.\n Math.ceil(positionY) >=\n Math.floor(document.documentElement.scrollHeight - window.innerHeight)\n ) {\n tocScroll.scrollTo(0, tocScroll.scrollHeight);\n } else {\n // somewhere in the middle.\n const current = document.querySelector(\".scroll-current\");\n if (current == null) {\n return;\n }\n\n // https://github.com/pypa/pip/issues/9159 This breaks scroll behaviours.\n // // scroll the currently \"active\" heading in toc, into view.\n // const rect = current.getBoundingClientRect();\n // if (0 > rect.top) {\n // current.scrollIntoView(true); // the argument is \"alignTop\"\n // } else if (rect.bottom > window.innerHeight) {\n // current.scrollIntoView(false);\n // }\n }\n}\n\nfunction scrollHandler(positionY) {\n scrollHandlerForHeader();\n scrollHandlerForBackToTop(positionY);\n scrollHandlerForTOC(positionY);\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Theme Toggle\n////////////////////////////////////////////////////////////////////////////////\nfunction setTheme(mode) {\n if (mode !== \"light\" && mode !== \"dark\" && mode !== \"auto\") {\n console.error(`Got invalid theme mode: ${mode}. Resetting to auto.`);\n mode = \"auto\";\n }\n\n document.body.dataset.theme = mode;\n localStorage.setItem(\"theme\", mode);\n console.log(`Changed to ${mode} mode.`);\n}\n\nfunction cycleThemeOnce() {\n const currentTheme = localStorage.getItem(\"theme\") || \"auto\";\n const prefersDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\n if (prefersDark) {\n // Auto (dark) -> Light -> Dark\n if (currentTheme === \"auto\") {\n setTheme(\"light\");\n } else if (currentTheme == \"light\") {\n setTheme(\"dark\");\n } else {\n setTheme(\"auto\");\n }\n } else {\n // Auto (light) -> Dark -> Light\n if (currentTheme === \"auto\") {\n setTheme(\"dark\");\n } else if (currentTheme == \"dark\") {\n setTheme(\"light\");\n } else {\n setTheme(\"auto\");\n }\n }\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Setup\n////////////////////////////////////////////////////////////////////////////////\nfunction setupScrollHandler() {\n // Taken from https://developer.mozilla.org/en-US/docs/Web/API/Document/scroll_event\n let last_known_scroll_position = 0;\n let ticking = false;\n\n window.addEventListener(\"scroll\", function (e) {\n last_known_scroll_position = window.scrollY;\n\n if (!ticking) {\n window.requestAnimationFrame(function () {\n scrollHandler(last_known_scroll_position);\n ticking = false;\n });\n\n ticking = true;\n }\n });\n window.scroll();\n}\n\nfunction setupScrollSpy() {\n if (tocScroll === null) {\n return;\n }\n\n // Scrollspy -- highlight table on contents, based on scroll\n new Gumshoe(\".toc-tree a\", {\n reflow: true,\n recursive: true,\n navClass: \"scroll-current\",\n offset: () => {\n let rem = parseFloat(getComputedStyle(document.documentElement).fontSize);\n return header.getBoundingClientRect().height + 0.5 * rem + 1;\n },\n });\n}\n\nfunction setupTheme() {\n // Attach event handlers for toggling themes\n const buttons = document.getElementsByClassName(\"theme-toggle\");\n Array.from(buttons).forEach((btn) => {\n btn.addEventListener(\"click\", cycleThemeOnce);\n });\n}\n\nfunction setup() {\n setupTheme();\n setupScrollHandler();\n setupScrollSpy();\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Main entrypoint\n////////////////////////////////////////////////////////////////////////////////\nfunction main() {\n document.body.parentNode.classList.remove(\"no-js\");\n\n header = document.querySelector(\"header\");\n tocScroll = document.querySelector(\".toc-scroll\");\n\n setup();\n}\n\ndocument.addEventListener(\"DOMContentLoaded\", main);\n"],"names":["root","g","window","this","defaults","navClass","contentClass","nested","nestedClass","offset","reflow","events","emitEvent","type","elem","detail","settings","event","CustomEvent","bubbles","cancelable","dispatchEvent","getOffsetTop","location","offsetParent","offsetTop","sortContents","contents","sort","item1","item2","content","isInView","bottom","bounds","getBoundingClientRect","parseFloat","getOffset","parseInt","innerHeight","document","documentElement","clientHeight","top","isAtBottom","Math","ceil","pageYOffset","max","body","scrollHeight","offsetHeight","getActive","last","length","item","useLastItem","i","deactivateNested","nav","parentNode","li","closest","classList","remove","deactivate","items","link","activateNested","add","selector","options","navItems","current","timeout","publicAPIs","querySelectorAll","Array","prototype","forEach","call","getElementById","decodeURIComponent","hash","substr","push","active","activate","scrollHandler","cancelAnimationFrame","requestAnimationFrame","detect","resizeHandler","destroy","removeEventListener","merged","arguments","obj","key","hasOwnProperty","extend","setup","addEventListener","factory","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","undefined","exports","module","__webpack_modules__","n","getter","__esModule","d","a","definition","o","Object","defineProperty","enumerable","get","globalThis","Function","e","prop","tocScroll","header","lastScrollTop","scrollTop","GO_TO_TOP_OFFSET","cycleThemeOnce","currentTheme","localStorage","getItem","mode","matchMedia","matches","console","error","dataset","theme","setItem","log","buttons","getElementsByClassName","from","btn","setupTheme","last_known_scroll_position","ticking","scrollY","positionY","floor","scrollHandlerForBackToTop","scrollTo","querySelector","scrollHandlerForTOC","scroll","setupScrollHandler","recursive","rem","getComputedStyle","fontSize","height"],"sourceRoot":""} \ No newline at end of file diff --git a/_static/searchtools.js b/_static/searchtools.js new file mode 100644 index 00000000..7918c3fa --- /dev/null +++ b/_static/searchtools.js @@ -0,0 +1,574 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for the full-text search. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +/** + * Simple result scoring code. + */ +if (typeof Scorer === "undefined") { + var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [docname, title, anchor, descr, score, filename] + // and returns the new score. + /* + score: result => { + const [docname, title, anchor, descr, score, filename] = result + return score + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: { + 0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5, // used to be unimportantResults + }, + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + partialTitle: 7, + // query found in terms + term: 5, + partialTerm: 2, + }; +} + +const _removeChildren = (element) => { + while (element && element.lastChild) element.removeChild(element.lastChild); +}; + +/** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping + */ +const _escapeRegExp = (string) => + string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string + +const _displayItem = (item, searchTerms, highlightTerms) => { + const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + const contentRoot = document.documentElement.dataset.content_root; + + const [docName, title, anchor, descr, score, _filename] = item; + + let listItem = document.createElement("li"); + let requestUrl; + let linkUrl; + if (docBuilder === "dirhtml") { + // dirhtml builder + let dirname = docName + "/"; + if (dirname.match(/\/index\/$/)) + dirname = dirname.substring(0, dirname.length - 6); + else if (dirname === "index/") dirname = ""; + requestUrl = contentRoot + dirname; + linkUrl = requestUrl; + } else { + // normal html builders + requestUrl = contentRoot + docName + docFileSuffix; + linkUrl = docName + docLinkSuffix; + } + let linkEl = listItem.appendChild(document.createElement("a")); + linkEl.href = linkUrl + anchor; + linkEl.dataset.score = score; + linkEl.innerHTML = title; + if (descr) { + listItem.appendChild(document.createElement("span")).innerHTML = + " (" + descr + ")"; + // highlight search terms in the description + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + } + else if (showSearchSummary) + fetch(requestUrl) + .then((responseData) => responseData.text()) + .then((data) => { + if (data) + listItem.appendChild( + Search.makeSearchSummary(data, searchTerms) + ); + // highlight search terms in the summary + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + }); + Search.output.appendChild(listItem); +}; +const _finishSearch = (resultCount) => { + Search.stopPulse(); + Search.title.innerText = _("Search Results"); + if (!resultCount) + Search.status.innerText = Documentation.gettext( + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + ); + else + Search.status.innerText = _( + `Search finished, found ${resultCount} page(s) matching the search query.` + ); +}; +const _displayNextItem = ( + results, + resultCount, + searchTerms, + highlightTerms, +) => { + // results left, load the summary and display it + // this is intended to be dynamic (don't sub resultsCount) + if (results.length) { + _displayItem(results.pop(), searchTerms, highlightTerms); + setTimeout( + () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), + 5 + ); + } + // search finished, update title and status message + else _finishSearch(resultCount); +}; + +/** + * Default splitQuery function. Can be overridden in ``sphinx.search`` with a + * custom function per language. + * + * The regular expression works by splitting the string on consecutive characters + * that are not Unicode letters, numbers, underscores, or emoji characters. + * This is the same as ``\W+`` in Python, preserving the surrogate pair area. + */ +if (typeof splitQuery === "undefined") { + var splitQuery = (query) => query + .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) + .filter(term => term) // remove remaining empty strings +} + +/** + * Search Module + */ +const Search = { + _index: null, + _queued_query: null, + _pulse_status: -1, + + htmlToText: (htmlString) => { + const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() }); + const docContent = htmlElement.querySelector('[role="main"]'); + if (docContent !== undefined) return docContent.textContent; + console.warn( + "Content block not found. Sphinx search tries to obtain it via '[role=main]'. Could you check your theme or template." + ); + return ""; + }, + + init: () => { + const query = new URLSearchParams(window.location.search).get("q"); + document + .querySelectorAll('input[name="q"]') + .forEach((el) => (el.value = query)); + if (query) Search.performSearch(query); + }, + + loadIndex: (url) => + (document.body.appendChild(document.createElement("script")).src = url), + + setIndex: (index) => { + Search._index = index; + if (Search._queued_query !== null) { + const query = Search._queued_query; + Search._queued_query = null; + Search.query(query); + } + }, + + hasIndex: () => Search._index !== null, + + deferQuery: (query) => (Search._queued_query = query), + + stopPulse: () => (Search._pulse_status = -1), + + startPulse: () => { + if (Search._pulse_status >= 0) return; + + const pulse = () => { + Search._pulse_status = (Search._pulse_status + 1) % 4; + Search.dots.innerText = ".".repeat(Search._pulse_status); + if (Search._pulse_status >= 0) window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch: (query) => { + // create the required interface elements + const searchText = document.createElement("h2"); + searchText.textContent = _("Searching"); + const searchSummary = document.createElement("p"); + searchSummary.classList.add("search-summary"); + searchSummary.innerText = ""; + const searchList = document.createElement("ul"); + searchList.classList.add("search"); + + const out = document.getElementById("search-results"); + Search.title = out.appendChild(searchText); + Search.dots = Search.title.appendChild(document.createElement("span")); + Search.status = out.appendChild(searchSummary); + Search.output = out.appendChild(searchList); + + const searchProgress = document.getElementById("search-progress"); + // Some themes don't use the search progress node + if (searchProgress) { + searchProgress.innerText = _("Preparing search..."); + } + Search.startPulse(); + + // index already loaded, the browser was quick! + if (Search.hasIndex()) Search.query(query); + else Search.deferQuery(query); + }, + + /** + * execute search (requires search index to be loaded) + */ + query: (query) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + const allTitles = Search._index.alltitles; + const indexEntries = Search._index.indexentries; + + // stem the search terms and add them to the correct list + const stemmer = new Stemmer(); + const searchTerms = new Set(); + const excludedTerms = new Set(); + const highlightTerms = new Set(); + const objectTerms = new Set(splitQuery(query.toLowerCase().trim())); + splitQuery(query.trim()).forEach((queryTerm) => { + const queryTermLower = queryTerm.toLowerCase(); + + // maybe skip this "word" + // stopwords array is from language_data.js + if ( + stopwords.indexOf(queryTermLower) !== -1 || + queryTerm.match(/^\d+$/) + ) + return; + + // stem the word + let word = stemmer.stemWord(queryTermLower); + // select the correct list + if (word[0] === "-") excludedTerms.add(word.substr(1)); + else { + searchTerms.add(word); + highlightTerms.add(queryTermLower); + } + }); + + if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js + localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + } + + // console.debug("SEARCH: searching for:"); + // console.info("required: ", [...searchTerms]); + // console.info("excluded: ", [...excludedTerms]); + + // array of [docname, title, anchor, descr, score, filename] + let results = []; + _removeChildren(document.getElementById("search-progress")); + + const queryLower = query.toLowerCase(); + for (const [title, foundTitles] of Object.entries(allTitles)) { + if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) { + for (const [file, id] of foundTitles) { + let score = Math.round(100 * queryLower.length / title.length) + results.push([ + docNames[file], + titles[file] !== title ? `${titles[file]} > ${title}` : title, + id !== null ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // search for explicit entries in index directives + for (const [entry, foundEntries] of Object.entries(indexEntries)) { + if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + for (const [file, id] of foundEntries) { + let score = Math.round(100 * queryLower.length / entry.length) + results.push([ + docNames[file], + titles[file], + id ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // lookup as object + objectTerms.forEach((term) => + results.push(...Search.performObjectSearch(term, objectTerms)) + ); + + // lookup as search terms in fulltext + results.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + + // let the scorer override scores with a custom scoring function + if (Scorer.score) results.forEach((item) => (item[4] = Scorer.score(item))); + + // now sort the results by score (in opposite order of appearance, since the + // display function below uses pop() to retrieve items) and then + // alphabetically + results.sort((a, b) => { + const leftScore = a[4]; + const rightScore = b[4]; + if (leftScore === rightScore) { + // same score: sort alphabetically + const leftTitle = a[1].toLowerCase(); + const rightTitle = b[1].toLowerCase(); + if (leftTitle === rightTitle) return 0; + return leftTitle > rightTitle ? -1 : 1; // inverted is intentional + } + return leftScore > rightScore ? 1 : -1; + }); + + // remove duplicate search results + // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept + let seen = new Set(); + results = results.reverse().reduce((acc, result) => { + let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + if (!seen.has(resultStr)) { + acc.push(result); + seen.add(resultStr); + } + return acc; + }, []); + + results = results.reverse(); + + // for debugging + //Search.lastresults = results.slice(); // a copy + // console.info("search results:", Search.lastresults); + + // print the results + _displayNextItem(results, results.length, searchTerms, highlightTerms); + }, + + /** + * search for object names + */ + performObjectSearch: (object, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const objects = Search._index.objects; + const objNames = Search._index.objnames; + const titles = Search._index.titles; + + const results = []; + + const objectSearchCallback = (prefix, match) => { + const name = match[4] + const fullname = (prefix ? prefix + "." : "") + name; + const fullnameLower = fullname.toLowerCase(); + if (fullnameLower.indexOf(object) < 0) return; + + let score = 0; + const parts = fullnameLower.split("."); + + // check for different match types: exact matches of full name or + // "last name" (i.e. last dotted part) + if (fullnameLower === object || parts.slice(-1)[0] === object) + score += Scorer.objNameMatch; + else if (parts.slice(-1)[0].indexOf(object) > -1) + score += Scorer.objPartialMatch; // matches in last name + + const objName = objNames[match[1]][2]; + const title = titles[match[0]]; + + // If more than one term searched for, we require other words to be + // found in the name/title/description + const otherTerms = new Set(objectTerms); + otherTerms.delete(object); + if (otherTerms.size > 0) { + const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase(); + if ( + [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0) + ) + return; + } + + let anchor = match[3]; + if (anchor === "") anchor = fullname; + else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname; + + const descr = objName + _(", in ") + title; + + // add custom score for some objects according to scorer + if (Scorer.objPrio.hasOwnProperty(match[2])) + score += Scorer.objPrio[match[2]]; + else score += Scorer.objPrioDefault; + + results.push([ + docNames[match[0]], + fullname, + "#" + anchor, + descr, + score, + filenames[match[0]], + ]); + }; + Object.keys(objects).forEach((prefix) => + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) + ) + ); + return results; + }, + + /** + * search for full-text terms in the index + */ + performTermsSearch: (searchTerms, excludedTerms) => { + // prepare search + const terms = Search._index.terms; + const titleTerms = Search._index.titleterms; + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + + const scoreMap = new Map(); + const fileMap = new Map(); + + // perform the search on the required terms + searchTerms.forEach((word) => { + const files = []; + const arr = [ + { files: terms[word], score: Scorer.term }, + { files: titleTerms[word], score: Scorer.title }, + ]; + // add support for partial matches + if (word.length > 2) { + const escapedWord = _escapeRegExp(word); + Object.keys(terms).forEach((term) => { + if (term.match(escapedWord) && !terms[word]) + arr.push({ files: terms[term], score: Scorer.partialTerm }); + }); + Object.keys(titleTerms).forEach((term) => { + if (term.match(escapedWord) && !titleTerms[word]) + arr.push({ files: titleTerms[word], score: Scorer.partialTitle }); + }); + } + + // no match but word was a required one + if (arr.every((record) => record.files === undefined)) return; + + // found search word in contents + arr.forEach((record) => { + if (record.files === undefined) return; + + let recordFiles = record.files; + if (recordFiles.length === undefined) recordFiles = [recordFiles]; + files.push(...recordFiles); + + // set score for the word in each file + recordFiles.forEach((file) => { + if (!scoreMap.has(file)) scoreMap.set(file, {}); + scoreMap.get(file)[word] = record.score; + }); + }); + + // create the mapping + files.forEach((file) => { + if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1) + fileMap.get(file).push(word); + else fileMap.set(file, [word]); + }); + }); + + // now check if the files don't contain excluded terms + const results = []; + for (const [file, wordList] of fileMap) { + // check if all requirements are matched + + // as search terms with length < 3 are discarded + const filteredTermCount = [...searchTerms].filter( + (term) => term.length > 2 + ).length; + if ( + wordList.length !== searchTerms.size && + wordList.length !== filteredTermCount + ) + continue; + + // ensure that none of the excluded terms is in the search result + if ( + [...excludedTerms].some( + (term) => + terms[term] === file || + titleTerms[term] === file || + (terms[term] || []).includes(file) || + (titleTerms[term] || []).includes(file) + ) + ) + break; + + // select one (max) score for the file. + const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w])); + // add result to the result list + results.push([ + docNames[file], + titles[file], + "", + null, + score, + filenames[file], + ]); + } + return results; + }, + + /** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words. + */ + makeSearchSummary: (htmlText, keywords) => { + const text = Search.htmlToText(htmlText); + if (text === "") return null; + + const textLower = text.toLowerCase(); + const actualStartPosition = [...keywords] + .map((k) => textLower.indexOf(k.toLowerCase())) + .filter((i) => i > -1) + .slice(-1)[0]; + const startWithContext = Math.max(actualStartPosition - 120, 0); + + const top = startWithContext === 0 ? "" : "..."; + const tail = startWithContext + 240 < text.length ? "..." : ""; + + let summary = document.createElement("p"); + summary.classList.add("context"); + summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + + return summary; + }, +}; + +_ready(Search.init); diff --git a/_static/skeleton.css b/_static/skeleton.css new file mode 100644 index 00000000..467c878c --- /dev/null +++ b/_static/skeleton.css @@ -0,0 +1,296 @@ +/* Some sane resets. */ +html { + height: 100%; +} + +body { + margin: 0; + min-height: 100%; +} + +/* All the flexbox magic! */ +body, +.sb-announcement, +.sb-content, +.sb-main, +.sb-container, +.sb-container__inner, +.sb-article-container, +.sb-footer-content, +.sb-header, +.sb-header-secondary, +.sb-footer { + display: flex; +} + +/* These order things vertically */ +body, +.sb-main, +.sb-article-container { + flex-direction: column; +} + +/* Put elements in the center */ +.sb-header, +.sb-header-secondary, +.sb-container, +.sb-content, +.sb-footer, +.sb-footer-content { + justify-content: center; +} +/* Put elements at the ends */ +.sb-article-container { + justify-content: space-between; +} + +/* These elements grow. */ +.sb-main, +.sb-content, +.sb-container, +article { + flex-grow: 1; +} + +/* Because padding making this wider is not fun */ +article { + box-sizing: border-box; +} + +/* The announcements element should never be wider than the page. */ +.sb-announcement { + max-width: 100%; +} + +.sb-sidebar-primary, +.sb-sidebar-secondary { + flex-shrink: 0; + width: 17rem; +} + +.sb-announcement__inner { + justify-content: center; + + box-sizing: border-box; + height: 3rem; + + overflow-x: auto; + white-space: nowrap; +} + +/* Sidebars, with checkbox-based toggle */ +.sb-sidebar-primary, +.sb-sidebar-secondary { + position: fixed; + height: 100%; + top: 0; +} + +.sb-sidebar-primary { + left: -17rem; + transition: left 250ms ease-in-out; +} +.sb-sidebar-secondary { + right: -17rem; + transition: right 250ms ease-in-out; +} + +.sb-sidebar-toggle { + display: none; +} +.sb-sidebar-overlay { + position: fixed; + top: 0; + width: 0; + height: 0; + + transition: width 0ms ease 250ms, height 0ms ease 250ms, opacity 250ms ease; + + opacity: 0; + background-color: rgba(0, 0, 0, 0.54); +} + +#sb-sidebar-toggle--primary:checked + ~ .sb-sidebar-overlay[for="sb-sidebar-toggle--primary"], +#sb-sidebar-toggle--secondary:checked + ~ .sb-sidebar-overlay[for="sb-sidebar-toggle--secondary"] { + width: 100%; + height: 100%; + opacity: 1; + transition: width 0ms ease, height 0ms ease, opacity 250ms ease; +} + +#sb-sidebar-toggle--primary:checked ~ .sb-container .sb-sidebar-primary { + left: 0; +} +#sb-sidebar-toggle--secondary:checked ~ .sb-container .sb-sidebar-secondary { + right: 0; +} + +/* Full-width mode */ +.drop-secondary-sidebar-for-full-width-content + .hide-when-secondary-sidebar-shown { + display: none !important; +} +.drop-secondary-sidebar-for-full-width-content .sb-sidebar-secondary { + display: none !important; +} + +/* Mobile views */ +.sb-page-width { + width: 100%; +} + +.sb-article-container, +.sb-footer-content__inner, +.drop-secondary-sidebar-for-full-width-content .sb-article, +.drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 100vw; +} + +.sb-article, +.match-content-width { + padding: 0 1rem; + box-sizing: border-box; +} + +@media (min-width: 32rem) { + .sb-article, + .match-content-width { + padding: 0 2rem; + } +} + +/* Tablet views */ +@media (min-width: 42rem) { + .sb-article-container { + width: auto; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 42rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} +@media (min-width: 46rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 46rem; + } + .sb-article, + .match-content-width { + width: 46rem; + } +} +@media (min-width: 50rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 50rem; + } + .sb-article, + .match-content-width { + width: 50rem; + } +} + +/* Tablet views */ +@media (min-width: 59rem) { + .sb-sidebar-secondary { + position: static; + } + .hide-when-secondary-sidebar-shown { + display: none !important; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 59rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} +@media (min-width: 63rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 63rem; + } + .sb-article, + .match-content-width { + width: 46rem; + } +} +@media (min-width: 67rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } + .sb-article, + .match-content-width { + width: 50rem; + } +} + +/* Desktop views */ +@media (min-width: 76rem) { + .sb-sidebar-primary { + position: static; + } + .hide-when-primary-sidebar-shown { + display: none !important; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 59rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} + +/* Full desktop views */ +@media (min-width: 80rem) { + .sb-article, + .match-content-width { + width: 46rem; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 63rem; + } +} + +@media (min-width: 84rem) { + .sb-article, + .match-content-width { + width: 50rem; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } +} + +@media (min-width: 88rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } + .sb-page-width { + width: 88rem; + } +} diff --git a/_static/sphinx_highlight.js b/_static/sphinx_highlight.js new file mode 100644 index 00000000..8a96c69a --- /dev/null +++ b/_static/sphinx_highlight.js @@ -0,0 +1,154 @@ +/* Highlighting utilities for Sphinx HTML documentation. */ +"use strict"; + +const SPHINX_HIGHLIGHT_ENABLED = true + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + const rest = document.createTextNode(val.substr(pos + text.length)); + parent.insertBefore( + span, + parent.insertBefore( + rest, + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + /* There may be more occurrences of search term in this node. So call this + * function recursively on the remaining fragment. + */ + _highlight(rest, addItems, text, className); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const SphinxHighlight = { + + /** + * highlight the search words provided in localstorage in the text + */ + highlightSearchWords: () => { + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + + // get and clear terms from localstorage + const url = new URL(window.location); + const highlight = + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms") + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + + // get individual terms from highlight string + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '

' + + '' + + _("Hide Search Matches") + + "

" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + localStorage.removeItem("sphinx_highlight_terms") + }, + + initEscapeListener: () => { + // only install a listener if it is really needed + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; + if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + SphinxHighlight.hideSearchWords(); + event.preventDefault(); + } + }); + }, +}; + +_ready(() => { + /* Do not call highlightSearchWords() when we are on the search page. + * It will highlight words from the *previous* search query. + */ + if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords(); + SphinxHighlight.initEscapeListener(); +}); diff --git a/_static/styles/furo-extensions.css b/_static/styles/furo-extensions.css new file mode 100644 index 00000000..bc447f22 --- /dev/null +++ b/_static/styles/furo-extensions.css @@ -0,0 +1,2 @@ +#furo-sidebar-ad-placement{padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)}#furo-sidebar-ad-placement .ethical-sidebar{background:var(--color-background-secondary);border:none;box-shadow:none}#furo-sidebar-ad-placement .ethical-sidebar:hover{background:var(--color-background-hover)}#furo-sidebar-ad-placement .ethical-sidebar a{color:var(--color-foreground-primary)}#furo-sidebar-ad-placement .ethical-callout a{color:var(--color-foreground-secondary)!important}#furo-readthedocs-versions{background:transparent;display:block;position:static;width:100%}#furo-readthedocs-versions .rst-versions{background:#1a1c1e}#furo-readthedocs-versions .rst-current-version{background:var(--color-sidebar-item-background);cursor:unset}#furo-readthedocs-versions .rst-current-version:hover{background:var(--color-sidebar-item-background)}#furo-readthedocs-versions .rst-current-version .fa-book{color:var(--color-foreground-primary)}#furo-readthedocs-versions>.rst-other-versions{padding:0}#furo-readthedocs-versions>.rst-other-versions small{opacity:1}#furo-readthedocs-versions .injected .rst-versions{position:unset}#furo-readthedocs-versions:focus-within,#furo-readthedocs-versions:hover{box-shadow:0 0 0 1px var(--color-sidebar-background-border)}#furo-readthedocs-versions:focus-within .rst-current-version,#furo-readthedocs-versions:hover .rst-current-version{background:#1a1c1e;font-size:inherit;height:auto;line-height:inherit;padding:12px;text-align:right}#furo-readthedocs-versions:focus-within .rst-current-version .fa-book,#furo-readthedocs-versions:hover .rst-current-version .fa-book{color:#fff;float:left}#furo-readthedocs-versions:focus-within .fa-caret-down,#furo-readthedocs-versions:hover .fa-caret-down{display:none}#furo-readthedocs-versions:focus-within .injected,#furo-readthedocs-versions:focus-within .rst-current-version,#furo-readthedocs-versions:focus-within .rst-other-versions,#furo-readthedocs-versions:hover .injected,#furo-readthedocs-versions:hover .rst-current-version,#furo-readthedocs-versions:hover .rst-other-versions{display:block}#furo-readthedocs-versions:focus-within>.rst-current-version,#furo-readthedocs-versions:hover>.rst-current-version{display:none}.highlight:hover button.copybtn{color:var(--color-code-foreground)}.highlight button.copybtn{align-items:center;background-color:var(--color-code-background);border:none;color:var(--color-background-item);cursor:pointer;height:1.25em;opacity:1;right:.5rem;top:.625rem;transition:color .3s,opacity .3s;width:1.25em}.highlight button.copybtn:hover{background-color:var(--color-code-background);color:var(--color-brand-content)}.highlight button.copybtn:after{background-color:transparent;color:var(--color-code-foreground);display:none}.highlight button.copybtn.success{color:#22863a;transition:color 0ms}.highlight button.copybtn.success:after{display:block}.highlight button.copybtn svg{padding:0}body{--sd-color-primary:var(--color-brand-primary);--sd-color-primary-highlight:var(--color-brand-content);--sd-color-primary-text:var(--color-background-primary);--sd-color-shadow:rgba(0,0,0,.05);--sd-color-card-border:var(--color-card-border);--sd-color-card-border-hover:var(--color-brand-content);--sd-color-card-background:var(--color-card-background);--sd-color-card-text:var(--color-foreground-primary);--sd-color-card-header:var(--color-card-marginals-background);--sd-color-card-footer:var(--color-card-marginals-background);--sd-color-tabs-label-active:var(--color-brand-content);--sd-color-tabs-label-hover:var(--color-foreground-muted);--sd-color-tabs-label-inactive:var(--color-foreground-muted);--sd-color-tabs-underline-active:var(--color-brand-content);--sd-color-tabs-underline-hover:var(--color-foreground-border);--sd-color-tabs-underline-inactive:var(--color-background-border);--sd-color-tabs-overline:var(--color-background-border);--sd-color-tabs-underline:var(--color-background-border)}.sd-tab-content{box-shadow:0 -2px var(--sd-color-tabs-overline),0 1px var(--sd-color-tabs-underline)}.sd-card{box-shadow:0 .1rem .25rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)}.sd-shadow-sm{box-shadow:0 .1rem .25rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-shadow-md{box-shadow:0 .3rem .75rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-shadow-lg{box-shadow:0 .6rem 1.5rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-card-hover:hover{transform:none}.sd-cards-carousel{gap:.25rem;padding:.25rem}body{--tabs--label-text:var(--color-foreground-muted);--tabs--label-text--hover:var(--color-foreground-muted);--tabs--label-text--active:var(--color-brand-content);--tabs--label-text--active--hover:var(--color-brand-content);--tabs--label-background:transparent;--tabs--label-background--hover:transparent;--tabs--label-background--active:transparent;--tabs--label-background--active--hover:transparent;--tabs--padding-x:0.25em;--tabs--margin-x:1em;--tabs--border:var(--color-background-border);--tabs--label-border:transparent;--tabs--label-border--hover:var(--color-foreground-muted);--tabs--label-border--active:var(--color-brand-content);--tabs--label-border--active--hover:var(--color-brand-content)}[role=main] .container{max-width:none;padding-left:0;padding-right:0}.shadow.docutils{border:none;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1)!important}.sphinx-bs .card{background-color:var(--color-background-secondary);color:var(--color-foreground)} +/*# sourceMappingURL=furo-extensions.css.map*/ \ No newline at end of file diff --git a/_static/styles/furo-extensions.css.map b/_static/styles/furo-extensions.css.map new file mode 100644 index 00000000..9ba5637f --- /dev/null +++ b/_static/styles/furo-extensions.css.map @@ -0,0 +1 @@ +{"version":3,"file":"styles/furo-extensions.css","mappings":"AAGA,2BACE,oFACA,4CAKE,6CAHA,YACA,eAEA,CACA,kDACE,yCAEF,8CACE,sCAEJ,8CACE,kDAEJ,2BAGE,uBACA,cAHA,gBACA,UAEA,CAGA,yCACE,mBAEF,gDAEE,gDADA,YACA,CACA,sDACE,gDACF,yDACE,sCAEJ,+CACE,UACA,qDACE,UAGF,mDACE,eAEJ,yEAEE,4DAEA,mHASE,mBAPA,kBAEA,YADA,oBAGA,aADA,gBAIA,CAEA,qIAEE,WADA,UACA,CAEJ,uGACE,aAEF,iUAGE,cAEF,mHACE,aC1EJ,gCACE,mCAEF,0BAKE,mBAUA,8CACA,YAFA,mCAKA,eAZA,cALA,UASA,YADA,YAYA,iCAdA,YAcA,CAEA,gCAEE,8CADA,gCACA,CAEF,gCAGE,6BADA,mCADA,YAEA,CAEF,kCAEE,cADA,oBACA,CACA,wCACE,cAEJ,8BACE,UC5CN,KAEE,6CAA8C,CAC9C,uDAAwD,CACxD,uDAAwD,CAGxD,iCAAsC,CAGtC,+CAAgD,CAChD,uDAAwD,CACxD,uDAAwD,CACxD,oDAAqD,CACrD,6DAA8D,CAC9D,6DAA8D,CAG9D,uDAAwD,CACxD,yDAA0D,CAC1D,4DAA6D,CAC7D,2DAA4D,CAC5D,8DAA+D,CAC/D,iEAAkE,CAClE,uDAAwD,CACxD,wDAAyD,CAG3D,gBACE,qFAGF,SACE,6EAEF,cACE,uFAEF,cACE,uFAEF,cACE,uFAGF,qBACE,eAEF,mBACE,WACA,eChDF,KACE,gDAAiD,CACjD,uDAAwD,CACxD,qDAAsD,CACtD,4DAA6D,CAC7D,oCAAqC,CACrC,2CAA4C,CAC5C,4CAA6C,CAC7C,mDAAoD,CACpD,wBAAyB,CACzB,oBAAqB,CACrB,6CAA8C,CAC9C,gCAAiC,CACjC,yDAA0D,CAC1D,uDAAwD,CACxD,8DAA+D,CCbjE,uBACE,eACA,eACA,gBAGF,iBACE,YACA,+EAGF,iBACE,mDACA","sources":["webpack:///./src/furo/assets/styles/extensions/_readthedocs.sass","webpack:///./src/furo/assets/styles/extensions/_copybutton.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-design.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-inline-tabs.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-panels.sass"],"sourcesContent":["// This file contains the styles used for tweaking how ReadTheDoc's embedded\n// contents would show up inside the theme.\n\n#furo-sidebar-ad-placement\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n .ethical-sidebar\n // Remove the border and box-shadow.\n border: none\n box-shadow: none\n // Manage the background colors.\n background: var(--color-background-secondary)\n &:hover\n background: var(--color-background-hover)\n // Ensure the text is legible.\n a\n color: var(--color-foreground-primary)\n\n .ethical-callout a\n color: var(--color-foreground-secondary) !important\n\n#furo-readthedocs-versions\n position: static\n width: 100%\n background: transparent\n display: block\n\n // Make the background color fit with the theme's aesthetic.\n .rst-versions\n background: rgb(26, 28, 30)\n\n .rst-current-version\n cursor: unset\n background: var(--color-sidebar-item-background)\n &:hover\n background: var(--color-sidebar-item-background)\n .fa-book\n color: var(--color-foreground-primary)\n\n > .rst-other-versions\n padding: 0\n small\n opacity: 1\n\n .injected\n .rst-versions\n position: unset\n\n &:hover,\n &:focus-within\n box-shadow: 0 0 0 1px var(--color-sidebar-background-border)\n\n .rst-current-version\n // Undo the tweaks done in RTD's CSS\n font-size: inherit\n line-height: inherit\n height: auto\n text-align: right\n padding: 12px\n\n // Match the rest of the body\n background: #1a1c1e\n\n .fa-book\n float: left\n color: white\n\n .fa-caret-down\n display: none\n\n .rst-current-version,\n .rst-other-versions,\n .injected\n display: block\n\n > .rst-current-version\n display: none\n",".highlight\n &:hover button.copybtn\n color: var(--color-code-foreground)\n\n button.copybtn\n // Make it visible\n opacity: 1\n\n // Align things correctly\n align-items: center\n\n height: 1.25em\n width: 1.25em\n\n top: 0.625rem // $code-spacing-vertical\n right: 0.5rem\n\n // Make it look better\n color: var(--color-background-item)\n background-color: var(--color-code-background)\n border: none\n\n // Change to cursor to make it obvious that you can click on it\n cursor: pointer\n\n // Transition smoothly, for aesthetics\n transition: color 300ms, opacity 300ms\n\n &:hover\n color: var(--color-brand-content)\n background-color: var(--color-code-background)\n\n &::after\n display: none\n color: var(--color-code-foreground)\n background-color: transparent\n\n &.success\n transition: color 0ms\n color: #22863a\n &::after\n display: block\n\n svg\n padding: 0\n","body\n // Colors\n --sd-color-primary: var(--color-brand-primary)\n --sd-color-primary-highlight: var(--color-brand-content)\n --sd-color-primary-text: var(--color-background-primary)\n\n // Shadows\n --sd-color-shadow: rgba(0, 0, 0, 0.05)\n\n // Cards\n --sd-color-card-border: var(--color-card-border)\n --sd-color-card-border-hover: var(--color-brand-content)\n --sd-color-card-background: var(--color-card-background)\n --sd-color-card-text: var(--color-foreground-primary)\n --sd-color-card-header: var(--color-card-marginals-background)\n --sd-color-card-footer: var(--color-card-marginals-background)\n\n // Tabs\n --sd-color-tabs-label-active: var(--color-brand-content)\n --sd-color-tabs-label-hover: var(--color-foreground-muted)\n --sd-color-tabs-label-inactive: var(--color-foreground-muted)\n --sd-color-tabs-underline-active: var(--color-brand-content)\n --sd-color-tabs-underline-hover: var(--color-foreground-border)\n --sd-color-tabs-underline-inactive: var(--color-background-border)\n --sd-color-tabs-overline: var(--color-background-border)\n --sd-color-tabs-underline: var(--color-background-border)\n\n// Tabs\n.sd-tab-content\n box-shadow: 0 -2px var(--sd-color-tabs-overline), 0 1px var(--sd-color-tabs-underline)\n\n// Shadows\n.sd-card // Have a shadow by default\n box-shadow: 0 0.1rem 0.25rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n.sd-shadow-sm\n box-shadow: 0 0.1rem 0.25rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n.sd-shadow-md\n box-shadow: 0 0.3rem 0.75rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n.sd-shadow-lg\n box-shadow: 0 0.6rem 1.5rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n// Cards\n.sd-card-hover:hover // Don't change scale on hover\n transform: none\n\n.sd-cards-carousel // Have a bit of gap in the carousel by default\n gap: 0.25rem\n padding: 0.25rem\n","// This file contains styles to tweak sphinx-inline-tabs to work well with Furo.\n\nbody\n --tabs--label-text: var(--color-foreground-muted)\n --tabs--label-text--hover: var(--color-foreground-muted)\n --tabs--label-text--active: var(--color-brand-content)\n --tabs--label-text--active--hover: var(--color-brand-content)\n --tabs--label-background: transparent\n --tabs--label-background--hover: transparent\n --tabs--label-background--active: transparent\n --tabs--label-background--active--hover: transparent\n --tabs--padding-x: 0.25em\n --tabs--margin-x: 1em\n --tabs--border: var(--color-background-border)\n --tabs--label-border: transparent\n --tabs--label-border--hover: var(--color-foreground-muted)\n --tabs--label-border--active: var(--color-brand-content)\n --tabs--label-border--active--hover: var(--color-brand-content)\n","// This file contains styles to tweak sphinx-panels to work well with Furo.\n\n// sphinx-panels includes Bootstrap 4, which uses .container which can conflict\n// with docutils' `.. container::` directive.\n[role=\"main\"] .container\n max-width: initial\n padding-left: initial\n padding-right: initial\n\n// Make the panels look nicer!\n.shadow.docutils\n border: none\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n// Make panel colors respond to dark mode\n.sphinx-bs .card\n background-color: var(--color-background-secondary)\n color: var(--color-foreground)\n"],"names":[],"sourceRoot":""} \ No newline at end of file diff --git a/_static/styles/furo.css b/_static/styles/furo.css new file mode 100644 index 00000000..3d29a218 --- /dev/null +++ b/_static/styles/furo.css @@ -0,0 +1,2 @@ +/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{-webkit-text-size-adjust:100%;line-height:1.15}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{border-style:none;padding:0}[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring,button:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}[hidden],template{display:none}@media print{.content-icon-container,.headerlink,.mobile-header,.related-pages{display:none!important}.highlight{border:.1pt solid var(--color-foreground-border)}a,blockquote,dl,ol,pre,table,ul{page-break-inside:avoid}caption,figure,h1,h2,h3,h4,h5,h6,img{page-break-after:avoid;page-break-inside:avoid}dl,ol,ul{page-break-before:avoid}}.visually-hidden{clip:rect(0,0,0,0)!important;border:0!important;height:1px!important;margin:-1px!important;overflow:hidden!important;padding:0!important;position:absolute!important;white-space:nowrap!important;width:1px!important}:-moz-focusring{outline:auto}body{--font-stack:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji;--font-stack--monospace:"SFMono-Regular",Menlo,Consolas,Monaco,Liberation Mono,Lucida Console,monospace;--font-size--normal:100%;--font-size--small:87.5%;--font-size--small--2:81.25%;--font-size--small--3:75%;--font-size--small--4:62.5%;--sidebar-caption-font-size:var(--font-size--small--2);--sidebar-item-font-size:var(--font-size--small);--sidebar-search-input-font-size:var(--font-size--small);--toc-font-size:var(--font-size--small--3);--toc-font-size--mobile:var(--font-size--normal);--toc-title-font-size:var(--font-size--small--4);--admonition-font-size:0.8125rem;--admonition-title-font-size:0.8125rem;--code-font-size:var(--font-size--small--2);--api-font-size:var(--font-size--small);--header-height:calc(var(--sidebar-item-line-height) + var(--sidebar-item-spacing-vertical)*4);--header-padding:0.5rem;--sidebar-tree-space-above:1.5rem;--sidebar-caption-space-above:1rem;--sidebar-item-line-height:1rem;--sidebar-item-spacing-vertical:0.5rem;--sidebar-item-spacing-horizontal:1rem;--sidebar-item-height:calc(var(--sidebar-item-line-height) + var(--sidebar-item-spacing-vertical)*2);--sidebar-expander-width:var(--sidebar-item-height);--sidebar-search-space-above:0.5rem;--sidebar-search-input-spacing-vertical:0.5rem;--sidebar-search-input-spacing-horizontal:0.5rem;--sidebar-search-input-height:1rem;--sidebar-search-icon-size:var(--sidebar-search-input-height);--toc-title-padding:0.25rem 0;--toc-spacing-vertical:1.5rem;--toc-spacing-horizontal:1.5rem;--toc-item-spacing-vertical:0.4rem;--toc-item-spacing-horizontal:1rem;--icon-search:url('data:image/svg+xml;charset=utf-8,');--icon-pencil:url('data:image/svg+xml;charset=utf-8,');--icon-abstract:url('data:image/svg+xml;charset=utf-8,');--icon-info:url('data:image/svg+xml;charset=utf-8,');--icon-flame:url('data:image/svg+xml;charset=utf-8,');--icon-question:url('data:image/svg+xml;charset=utf-8,');--icon-warning:url('data:image/svg+xml;charset=utf-8,');--icon-failure:url('data:image/svg+xml;charset=utf-8,');--icon-spark:url('data:image/svg+xml;charset=utf-8,');--color-admonition-title--caution:#ff9100;--color-admonition-title-background--caution:rgba(255,145,0,.2);--color-admonition-title--warning:#ff9100;--color-admonition-title-background--warning:rgba(255,145,0,.2);--color-admonition-title--danger:#ff5252;--color-admonition-title-background--danger:rgba(255,82,82,.2);--color-admonition-title--attention:#ff5252;--color-admonition-title-background--attention:rgba(255,82,82,.2);--color-admonition-title--error:#ff5252;--color-admonition-title-background--error:rgba(255,82,82,.2);--color-admonition-title--hint:#00c852;--color-admonition-title-background--hint:rgba(0,200,82,.2);--color-admonition-title--tip:#00c852;--color-admonition-title-background--tip:rgba(0,200,82,.2);--color-admonition-title--important:#00bfa5;--color-admonition-title-background--important:rgba(0,191,165,.2);--color-admonition-title--note:#00b0ff;--color-admonition-title-background--note:rgba(0,176,255,.2);--color-admonition-title--seealso:#448aff;--color-admonition-title-background--seealso:rgba(68,138,255,.2);--color-admonition-title--admonition-todo:grey;--color-admonition-title-background--admonition-todo:hsla(0,0%,50%,.2);--color-admonition-title:#651fff;--color-admonition-title-background:rgba(101,31,255,.2);--icon-admonition-default:var(--icon-abstract);--color-topic-title:#14b8a6;--color-topic-title-background:rgba(20,184,166,.2);--icon-topic-default:var(--icon-pencil);--color-problematic:#b30000;--color-foreground-primary:#000;--color-foreground-secondary:#5a5c63;--color-foreground-muted:#646776;--color-foreground-border:#878787;--color-background-primary:#fff;--color-background-secondary:#f8f9fb;--color-background-hover:#efeff4;--color-background-hover--transparent:#efeff400;--color-background-border:#eeebee;--color-background-item:#ccc;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2962ff;--color-brand-content:#2a5adf;--color-api-background:var(--color-background-hover--transparent);--color-api-background-hover:var(--color-background-hover);--color-api-overall:var(--color-foreground-secondary);--color-api-name:var(--color-problematic);--color-api-pre-name:var(--color-problematic);--color-api-paren:var(--color-foreground-secondary);--color-api-keyword:var(--color-foreground-primary);--color-highlight-on-target:#ffc;--color-inline-code-background:var(--color-background-secondary);--color-highlighted-background:#def;--color-highlighted-text:var(--color-foreground-primary);--color-guilabel-background:#ddeeff80;--color-guilabel-border:#bedaf580;--color-guilabel-text:var(--color-foreground-primary);--color-admonition-background:transparent;--color-table-header-background:var(--color-background-secondary);--color-table-border:var(--color-background-border);--color-card-border:var(--color-background-secondary);--color-card-background:transparent;--color-card-marginals-background:var(--color-background-secondary);--color-header-background:var(--color-background-primary);--color-header-border:var(--color-background-border);--color-header-text:var(--color-foreground-primary);--color-sidebar-background:var(--color-background-secondary);--color-sidebar-background-border:var(--color-background-border);--color-sidebar-brand-text:var(--color-foreground-primary);--color-sidebar-caption-text:var(--color-foreground-muted);--color-sidebar-link-text:var(--color-foreground-secondary);--color-sidebar-link-text--top-level:var(--color-brand-primary);--color-sidebar-item-background:var(--color-sidebar-background);--color-sidebar-item-background--current:var( --color-sidebar-item-background );--color-sidebar-item-background--hover:linear-gradient(90deg,var(--color-background-hover--transparent) 0%,var(--color-background-hover) var(--sidebar-item-spacing-horizontal),var(--color-background-hover) 100%);--color-sidebar-item-expander-background:transparent;--color-sidebar-item-expander-background--hover:var( --color-background-hover );--color-sidebar-search-text:var(--color-foreground-primary);--color-sidebar-search-background:var(--color-background-secondary);--color-sidebar-search-background--focus:var(--color-background-primary);--color-sidebar-search-border:var(--color-background-border);--color-sidebar-search-icon:var(--color-foreground-muted);--color-toc-background:var(--color-background-primary);--color-toc-title-text:var(--color-foreground-muted);--color-toc-item-text:var(--color-foreground-secondary);--color-toc-item-text--hover:var(--color-foreground-primary);--color-toc-item-text--active:var(--color-brand-primary);--color-content-foreground:var(--color-foreground-primary);--color-content-background:transparent;--color-link:var(--color-brand-content);--color-link--hover:var(--color-brand-content);--color-link-underline:var(--color-background-border);--color-link-underline--hover:var(--color-foreground-border)}.only-light{display:block!important}html body .only-dark{display:none!important}@media not print{body[data-theme=dark]{--color-problematic:#ee5151;--color-foreground-primary:#ffffffcc;--color-foreground-secondary:#9ca0a5;--color-foreground-muted:#81868d;--color-foreground-border:#666;--color-background-primary:#131416;--color-background-secondary:#1a1c1e;--color-background-hover:#1e2124;--color-background-hover--transparent:#1e212400;--color-background-border:#303335;--color-background-item:#444;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2b8cee;--color-brand-content:#368ce2;--color-highlighted-background:#083563;--color-guilabel-background:#08356380;--color-guilabel-border:#13395f80;--color-api-keyword:var(--color-foreground-secondary);--color-highlight-on-target:#330;--color-admonition-background:#18181a;--color-card-border:var(--color-background-secondary);--color-card-background:#18181a;--color-card-marginals-background:var(--color-background-hover)}html body[data-theme=dark] .only-light{display:none!important}body[data-theme=dark] .only-dark{display:block!important}@media(prefers-color-scheme:dark){body:not([data-theme=light]){--color-problematic:#ee5151;--color-foreground-primary:#ffffffcc;--color-foreground-secondary:#9ca0a5;--color-foreground-muted:#81868d;--color-foreground-border:#666;--color-background-primary:#131416;--color-background-secondary:#1a1c1e;--color-background-hover:#1e2124;--color-background-hover--transparent:#1e212400;--color-background-border:#303335;--color-background-item:#444;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2b8cee;--color-brand-content:#368ce2;--color-highlighted-background:#083563;--color-guilabel-background:#08356380;--color-guilabel-border:#13395f80;--color-api-keyword:var(--color-foreground-secondary);--color-highlight-on-target:#330;--color-admonition-background:#18181a;--color-card-border:var(--color-background-secondary);--color-card-background:#18181a;--color-card-marginals-background:var(--color-background-hover)}html body:not([data-theme=light]) .only-light{display:none!important}body:not([data-theme=light]) .only-dark{display:block!important}}}body[data-theme=auto] .theme-toggle svg.theme-icon-when-auto,body[data-theme=dark] .theme-toggle svg.theme-icon-when-dark,body[data-theme=light] .theme-toggle svg.theme-icon-when-light{display:block}body{font-family:var(--font-stack)}code,kbd,pre,samp{font-family:var(--font-stack--monospace)}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}article{line-height:1.5}h1,h2,h3,h4,h5,h6{border-radius:.5rem;font-weight:700;line-height:1.25;margin:.5rem -.5rem;padding-left:.5rem;padding-right:.5rem}h1+p,h2+p,h3+p,h4+p,h5+p,h6+p{margin-top:0}h1{font-size:2.5em;margin-bottom:1rem}h1,h2{margin-top:1.75rem}h2{font-size:2em}h3{font-size:1.5em}h4{font-size:1.25em}h5{font-size:1.125em}h6{font-size:1em}small{font-size:80%;opacity:75%}p{margin-bottom:.75rem;margin-top:.5rem}hr.docutils{background-color:var(--color-background-border);border:0;height:1px;margin:2rem 0;padding:0}.centered{text-align:center}a{color:var(--color-link);text-decoration:underline;text-decoration-color:var(--color-link-underline)}a:hover{color:var(--color-link--hover);text-decoration-color:var(--color-link-underline--hover)}a.muted-link{color:inherit}a.muted-link:hover{color:var(--color-link);text-decoration-color:var(--color-link-underline--hover)}html{overflow-x:hidden;overflow-y:scroll;scroll-behavior:smooth}.sidebar-scroll,.toc-scroll,article[role=main] *{scrollbar-color:var(--color-foreground-border) transparent;scrollbar-width:thin}.sidebar-scroll::-webkit-scrollbar,.toc-scroll::-webkit-scrollbar,article[role=main] ::-webkit-scrollbar{height:.25rem;width:.25rem}.sidebar-scroll::-webkit-scrollbar-thumb,.toc-scroll::-webkit-scrollbar-thumb,article[role=main] ::-webkit-scrollbar-thumb{background-color:var(--color-foreground-border);border-radius:.125rem}body,html{background:var(--color-background-primary);color:var(--color-foreground-primary);height:100%}article{background:var(--color-content-background);color:var(--color-content-foreground);overflow-wrap:break-word}.page{display:flex;min-height:100%}.mobile-header{background-color:var(--color-header-background);border-bottom:1px solid var(--color-header-border);color:var(--color-header-text);display:none;height:var(--header-height);width:100%;z-index:10}.mobile-header.scrolled{border-bottom:none;box-shadow:0 0 .2rem rgba(0,0,0,.1),0 .2rem .4rem rgba(0,0,0,.2)}.mobile-header .header-center a{color:var(--color-header-text);text-decoration:none}.main{display:flex;flex:1}.sidebar-drawer{background:var(--color-sidebar-background);border-right:1px solid var(--color-sidebar-background-border);box-sizing:border-box;display:flex;justify-content:flex-end;min-width:15em;width:calc(50% - 26em)}.sidebar-container,.toc-drawer{box-sizing:border-box;width:15em}.toc-drawer{background:var(--color-toc-background);padding-right:1rem}.sidebar-sticky,.toc-sticky{display:flex;flex-direction:column;height:min(100%,100vh);height:100vh;position:sticky;top:0}.sidebar-scroll,.toc-scroll{flex-grow:1;flex-shrink:1;overflow:auto;scroll-behavior:smooth}.content{display:flex;flex-direction:column;justify-content:space-between;padding:0 3em;width:46em}.icon{display:inline-block;height:1rem;width:1rem}.icon svg{height:100%;width:100%}.announcement{align-items:center;background-color:var(--color-announcement-background);color:var(--color-announcement-text);display:flex;height:var(--header-height);overflow-x:auto}.announcement+.page{min-height:calc(100% - var(--header-height))}.announcement-content{box-sizing:border-box;min-width:100%;padding:.5rem;text-align:center;white-space:nowrap}.announcement-content a{color:var(--color-announcement-text);text-decoration-color:var(--color-announcement-text)}.announcement-content a:hover{color:var(--color-announcement-text);text-decoration-color:var(--color-link--hover)}.no-js .theme-toggle-container{display:none}.theme-toggle-container{vertical-align:middle}.theme-toggle{background:transparent;border:none;cursor:pointer;padding:0}.theme-toggle svg{color:var(--color-foreground-primary);display:none;height:1rem;vertical-align:middle;width:1rem}.theme-toggle-header{float:left;padding:1rem .5rem}.nav-overlay-icon,.toc-overlay-icon{cursor:pointer;display:none}.nav-overlay-icon .icon,.toc-overlay-icon .icon{color:var(--color-foreground-secondary);height:1rem;width:1rem}.nav-overlay-icon,.toc-header-icon{align-items:center;justify-content:center}.toc-content-icon{height:1.5rem;width:1.5rem}.content-icon-container{display:flex;float:right;gap:.5rem;margin-bottom:1rem;margin-left:1rem;margin-top:1.5rem}.content-icon-container .edit-this-page svg{color:inherit;height:1rem;width:1rem}.sidebar-toggle{display:none;position:absolute}.sidebar-toggle[name=__toc]{left:20px}.sidebar-toggle:checked{left:40px}.overlay{background-color:rgba(0,0,0,.54);height:0;opacity:0;position:fixed;top:0;transition:width 0ms,height 0ms,opacity .25s ease-out;width:0}.sidebar-overlay{z-index:20}.toc-overlay{z-index:40}.sidebar-drawer{transition:left .25s ease-in-out;z-index:30}.toc-drawer{transition:right .25s ease-in-out;z-index:50}#__navigation:checked~.sidebar-overlay{height:100%;opacity:1;width:100%}#__navigation:checked~.page .sidebar-drawer{left:0;top:0}#__toc:checked~.toc-overlay{height:100%;opacity:1;width:100%}#__toc:checked~.page .toc-drawer{right:0;top:0}.back-to-top{background:var(--color-background-primary);border-radius:1rem;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 1px 0 hsla(220,9%,46%,.502);display:none;font-size:.8125rem;left:0;margin-left:50%;padding:.5rem .75rem .5rem .5rem;position:fixed;text-decoration:none;top:1rem;transform:translateX(-50%);z-index:10}.back-to-top svg{fill:currentColor;display:inline-block;height:1rem;width:1rem}.back-to-top span{margin-left:.25rem}.show-back-to-top .back-to-top{align-items:center;display:flex}@media(min-width:97em){html{font-size:110%}}@media(max-width:82em){.toc-content-icon{display:flex}.toc-drawer{border-left:1px solid var(--color-background-muted);height:100vh;position:fixed;right:-15em;top:0}.toc-tree{border-left:none;font-size:var(--toc-font-size--mobile)}.sidebar-drawer{width:calc(50% - 18.5em)}}@media(max-width:67em){.nav-overlay-icon{display:flex}.sidebar-drawer{height:100vh;left:-15em;position:fixed;top:0;width:15em}.toc-header-icon{display:flex}.theme-toggle-content,.toc-content-icon{display:none}.theme-toggle-header{display:block}.mobile-header{align-items:center;display:flex;justify-content:space-between;position:sticky;top:0}.mobile-header .header-left,.mobile-header .header-right{display:flex;height:var(--header-height);padding:0 var(--header-padding)}.mobile-header .header-left label,.mobile-header .header-right label{height:100%;-webkit-user-select:none;-moz-user-select:none;user-select:none;width:100%}.nav-overlay-icon .icon,.theme-toggle svg{height:1.25rem;width:1.25rem}:target{scroll-margin-top:var(--header-height)}.back-to-top{top:calc(var(--header-height) + .5rem)}.page{flex-direction:column;justify-content:center}.content{margin-left:auto;margin-right:auto}}@media(max-width:52em){.content{overflow-x:auto;width:100%}}@media(max-width:46em){.content{padding:0 1em}article aside.sidebar{float:none;margin:1rem 0;width:100%}}.admonition,.topic{background:var(--color-admonition-background);border-radius:.2rem;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1);font-size:var(--admonition-font-size);margin:1rem auto;overflow:hidden;padding:0 .5rem .5rem;page-break-inside:avoid}.admonition>:nth-child(2),.topic>:nth-child(2){margin-top:0}.admonition>:last-child,.topic>:last-child{margin-bottom:0}.admonition p.admonition-title,p.topic-title{font-size:var(--admonition-title-font-size);font-weight:500;line-height:1.3;margin:0 -.5rem .5rem;padding:.4rem .5rem .4rem 2rem;position:relative}.admonition p.admonition-title:before,p.topic-title:before{content:"";height:1rem;left:.5rem;position:absolute;width:1rem}p.admonition-title{background-color:var(--color-admonition-title-background)}p.admonition-title:before{background-color:var(--color-admonition-title);-webkit-mask-image:var(--icon-admonition-default);mask-image:var(--icon-admonition-default);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat}p.topic-title{background-color:var(--color-topic-title-background)}p.topic-title:before{background-color:var(--color-topic-title);-webkit-mask-image:var(--icon-topic-default);mask-image:var(--icon-topic-default);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat}.admonition{border-left:.2rem solid var(--color-admonition-title)}.admonition.caution{border-left-color:var(--color-admonition-title--caution)}.admonition.caution>.admonition-title{background-color:var(--color-admonition-title-background--caution)}.admonition.caution>.admonition-title:before{background-color:var(--color-admonition-title--caution);-webkit-mask-image:var(--icon-spark);mask-image:var(--icon-spark)}.admonition.warning{border-left-color:var(--color-admonition-title--warning)}.admonition.warning>.admonition-title{background-color:var(--color-admonition-title-background--warning)}.admonition.warning>.admonition-title:before{background-color:var(--color-admonition-title--warning);-webkit-mask-image:var(--icon-warning);mask-image:var(--icon-warning)}.admonition.danger{border-left-color:var(--color-admonition-title--danger)}.admonition.danger>.admonition-title{background-color:var(--color-admonition-title-background--danger)}.admonition.danger>.admonition-title:before{background-color:var(--color-admonition-title--danger);-webkit-mask-image:var(--icon-spark);mask-image:var(--icon-spark)}.admonition.attention{border-left-color:var(--color-admonition-title--attention)}.admonition.attention>.admonition-title{background-color:var(--color-admonition-title-background--attention)}.admonition.attention>.admonition-title:before{background-color:var(--color-admonition-title--attention);-webkit-mask-image:var(--icon-warning);mask-image:var(--icon-warning)}.admonition.error{border-left-color:var(--color-admonition-title--error)}.admonition.error>.admonition-title{background-color:var(--color-admonition-title-background--error)}.admonition.error>.admonition-title:before{background-color:var(--color-admonition-title--error);-webkit-mask-image:var(--icon-failure);mask-image:var(--icon-failure)}.admonition.hint{border-left-color:var(--color-admonition-title--hint)}.admonition.hint>.admonition-title{background-color:var(--color-admonition-title-background--hint)}.admonition.hint>.admonition-title:before{background-color:var(--color-admonition-title--hint);-webkit-mask-image:var(--icon-question);mask-image:var(--icon-question)}.admonition.tip{border-left-color:var(--color-admonition-title--tip)}.admonition.tip>.admonition-title{background-color:var(--color-admonition-title-background--tip)}.admonition.tip>.admonition-title:before{background-color:var(--color-admonition-title--tip);-webkit-mask-image:var(--icon-info);mask-image:var(--icon-info)}.admonition.important{border-left-color:var(--color-admonition-title--important)}.admonition.important>.admonition-title{background-color:var(--color-admonition-title-background--important)}.admonition.important>.admonition-title:before{background-color:var(--color-admonition-title--important);-webkit-mask-image:var(--icon-flame);mask-image:var(--icon-flame)}.admonition.note{border-left-color:var(--color-admonition-title--note)}.admonition.note>.admonition-title{background-color:var(--color-admonition-title-background--note)}.admonition.note>.admonition-title:before{background-color:var(--color-admonition-title--note);-webkit-mask-image:var(--icon-pencil);mask-image:var(--icon-pencil)}.admonition.seealso{border-left-color:var(--color-admonition-title--seealso)}.admonition.seealso>.admonition-title{background-color:var(--color-admonition-title-background--seealso)}.admonition.seealso>.admonition-title:before{background-color:var(--color-admonition-title--seealso);-webkit-mask-image:var(--icon-info);mask-image:var(--icon-info)}.admonition.admonition-todo{border-left-color:var(--color-admonition-title--admonition-todo)}.admonition.admonition-todo>.admonition-title{background-color:var(--color-admonition-title-background--admonition-todo)}.admonition.admonition-todo>.admonition-title:before{background-color:var(--color-admonition-title--admonition-todo);-webkit-mask-image:var(--icon-pencil);mask-image:var(--icon-pencil)}.admonition-todo>.admonition-title{text-transform:uppercase}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd{margin-left:2rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd>:first-child{margin-top:.125rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list,dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd>:last-child{margin-bottom:.75rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list>dt{font-size:var(--font-size--small);text-transform:uppercase}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd:empty{margin-bottom:.5rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul{margin-left:-1.2rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul>li>p:nth-child(2){margin-top:0}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul>li>p+p:last-child:empty{margin-bottom:0;margin-top:0}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt{color:var(--color-api-overall)}.sig:not(.sig-inline){background:var(--color-api-background);border-radius:.25rem;font-family:var(--font-stack--monospace);font-size:var(--api-font-size);font-weight:700;margin-left:-.25rem;margin-right:-.25rem;padding:.25rem .5rem .25rem 3em;text-indent:-2.5em;transition:background .1s ease-out}.sig:not(.sig-inline):hover{background:var(--color-api-background-hover)}.sig:not(.sig-inline) a.reference .viewcode-link{font-weight:400;width:3.5rem}em.property{font-style:normal}em.property:first-child{color:var(--color-api-keyword)}.sig-name{color:var(--color-api-name)}.sig-prename{color:var(--color-api-pre-name);font-weight:400}.sig-paren{color:var(--color-api-paren)}.sig-param{font-style:normal}.versionmodified{font-style:italic}div.deprecated p,div.versionadded p,div.versionchanged p{margin-bottom:.125rem;margin-top:.125rem}.viewcode-back,.viewcode-link{float:right;text-align:right}.line-block{margin-bottom:.75rem;margin-top:.5rem}.line-block .line-block{margin-bottom:0;margin-top:0;padding-left:1rem}.code-block-caption,article p.caption,table>caption{font-size:var(--font-size--small);text-align:center}.toctree-wrapper.compound .caption,.toctree-wrapper.compound :not(.caption)>.caption-text{font-size:var(--font-size--small);margin-bottom:0;text-align:initial;text-transform:uppercase}.toctree-wrapper.compound>ul{margin-bottom:0;margin-top:0}.sig-inline,code.literal{background:var(--color-inline-code-background);border-radius:.2em;font-size:var(--font-size--small--2);padding:.1em .2em}pre.literal-block .sig-inline,pre.literal-block code.literal{font-size:inherit;padding:0}p .sig-inline,p code.literal{border:1px solid var(--color-background-border)}.sig-inline{font-family:var(--font-stack--monospace)}div[class*=" highlight-"],div[class^=highlight-]{display:flex;margin:1em 0}div[class*=" highlight-"] .table-wrapper,div[class^=highlight-] .table-wrapper,pre{margin:0;padding:0}pre{overflow:auto}article[role=main] .highlight pre{line-height:1.5}.highlight pre,pre.literal-block{font-size:var(--code-font-size);padding:.625rem .875rem}pre.literal-block{background-color:var(--color-code-background);border-radius:.2rem;color:var(--color-code-foreground);margin-bottom:1rem;margin-top:1rem}.highlight{border-radius:.2rem;width:100%}.highlight .gp,.highlight span.linenos{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none}.highlight .hll{display:block;margin-left:-.875rem;margin-right:-.875rem;padding-left:.875rem;padding-right:.875rem}.code-block-caption{background-color:var(--color-code-background);border-bottom:1px solid;border-radius:.25rem;border-bottom-left-radius:0;border-bottom-right-radius:0;border-color:var(--color-background-border);color:var(--color-code-foreground);display:flex;font-weight:300;padding:.625rem .875rem}.code-block-caption+div[class]{margin-top:0}.code-block-caption+div[class] pre{border-top-left-radius:0;border-top-right-radius:0}.highlighttable{display:block;width:100%}.highlighttable tbody{display:block}.highlighttable tr{display:flex}.highlighttable td.linenos{background-color:var(--color-code-background);border-bottom-left-radius:.2rem;border-top-left-radius:.2rem;color:var(--color-code-foreground);padding:.625rem 0 .625rem .875rem}.highlighttable .linenodiv{box-shadow:-.0625rem 0 var(--color-foreground-border) inset;font-size:var(--code-font-size);padding-right:.875rem}.highlighttable td.code{display:block;flex:1;overflow:hidden;padding:0}.highlighttable td.code .highlight{border-bottom-left-radius:0;border-top-left-radius:0}.highlight span.linenos{box-shadow:-.0625rem 0 var(--color-foreground-border) inset;display:inline-block;margin-right:.875rem;padding-left:0;padding-right:.875rem}.footnote-reference{font-size:var(--font-size--small--4);vertical-align:super}dl.footnote.brackets{color:var(--color-foreground-secondary);display:grid;font-size:var(--font-size--small);grid-template-columns:max-content auto}dl.footnote.brackets dt{margin:0}dl.footnote.brackets dt>.fn-backref{margin-left:.25rem}dl.footnote.brackets dt:after{content:":"}dl.footnote.brackets dt .brackets:before{content:"["}dl.footnote.brackets dt .brackets:after{content:"]"}dl.footnote.brackets dd{margin:0;padding:0 1rem}aside.footnote{color:var(--color-foreground-secondary);font-size:var(--font-size--small)}aside.footnote>span,div.citation>span{float:left;font-weight:500;padding-right:.25rem}aside.footnote>p,div.citation>p{margin-left:2rem}img{box-sizing:border-box;height:auto;max-width:100%}article .figure,article figure{border-radius:.2rem;margin:0}article .figure :last-child,article figure :last-child{margin-bottom:0}article .align-left{clear:left;float:left;margin:0 1rem 1rem}article .align-right{clear:right;float:right;margin:0 1rem 1rem}article .align-center,article .align-default{display:block;margin-left:auto;margin-right:auto;text-align:center}article table.align-default{display:table;text-align:initial}.domainindex-jumpbox,.genindex-jumpbox{border-bottom:1px solid var(--color-background-border);border-top:1px solid var(--color-background-border);padding:.25rem}.domainindex-section h2,.genindex-section h2{margin-bottom:.5rem;margin-top:.75rem}.domainindex-section ul,.genindex-section ul{margin-bottom:0;margin-top:0}ol,ul{margin-bottom:1rem;margin-top:1rem;padding-left:1.2rem}ol li>p:first-child,ul li>p:first-child{margin-bottom:.25rem;margin-top:.25rem}ol li>p:last-child,ul li>p:last-child{margin-top:.25rem}ol li>ol,ol li>ul,ul li>ol,ul li>ul{margin-bottom:.5rem;margin-top:.5rem}ol.arabic{list-style:decimal}ol.loweralpha{list-style:lower-alpha}ol.upperalpha{list-style:upper-alpha}ol.lowerroman{list-style:lower-roman}ol.upperroman{list-style:upper-roman}.simple li>ol,.simple li>ul,.toctree-wrapper li>ol,.toctree-wrapper li>ul{margin-bottom:0;margin-top:0}.field-list dt,.option-list dt,dl.footnote dt,dl.glossary dt,dl.simple dt,dl:not([class]) dt{font-weight:500;margin-top:.25rem}.field-list dt+dt,.option-list dt+dt,dl.footnote dt+dt,dl.glossary dt+dt,dl.simple dt+dt,dl:not([class]) dt+dt{margin-top:0}.field-list dt .classifier:before,.option-list dt .classifier:before,dl.footnote dt .classifier:before,dl.glossary dt .classifier:before,dl.simple dt .classifier:before,dl:not([class]) dt .classifier:before{content:":";margin-left:.2rem;margin-right:.2rem}.field-list dd ul,.field-list dd>p:first-child,.option-list dd ul,.option-list dd>p:first-child,dl.footnote dd ul,dl.footnote dd>p:first-child,dl.glossary dd ul,dl.glossary dd>p:first-child,dl.simple dd ul,dl.simple dd>p:first-child,dl:not([class]) dd ul,dl:not([class]) dd>p:first-child{margin-top:.125rem}.field-list dd ul,.option-list dd ul,dl.footnote dd ul,dl.glossary dd ul,dl.simple dd ul,dl:not([class]) dd ul{margin-bottom:.125rem}.math-wrapper{overflow-x:auto;width:100%}div.math{position:relative;text-align:center}div.math .headerlink,div.math:focus .headerlink{display:none}div.math:hover .headerlink{display:inline-block}div.math span.eqno{position:absolute;right:.5rem;top:50%;transform:translateY(-50%);z-index:1}abbr[title]{cursor:help}.problematic{color:var(--color-problematic)}kbd:not(.compound){background-color:var(--color-background-secondary);border:1px solid var(--color-foreground-border);border-radius:.2rem;box-shadow:0 .0625rem 0 rgba(0,0,0,.2),inset 0 0 0 .125rem var(--color-background-primary);color:var(--color-foreground-primary);display:inline-block;font-size:var(--font-size--small--3);margin:0 .2rem;padding:0 .2rem;vertical-align:text-bottom}blockquote{background:var(--color-background-secondary);border-left:4px solid var(--color-background-border);margin-left:0;margin-right:0;padding:.5rem 1rem}blockquote .attribution{font-weight:600;text-align:right}blockquote.highlights,blockquote.pull-quote{font-size:1.25em}blockquote.epigraph,blockquote.pull-quote{border-left-width:0;border-radius:.5rem}blockquote.highlights{background:transparent;border-left-width:0}p .reference img{vertical-align:middle}p.rubric{font-size:1.125em;font-weight:700;line-height:1.25}dd p.rubric{font-size:var(--font-size--small);font-weight:inherit;line-height:inherit;text-transform:uppercase}article .sidebar{background-color:var(--color-background-secondary);border:1px solid var(--color-background-border);border-radius:.2rem;clear:right;float:right;margin-left:1rem;margin-right:0;width:30%}article .sidebar>*{padding-left:1rem;padding-right:1rem}article .sidebar>ol,article .sidebar>ul{padding-left:2.2rem}article .sidebar .sidebar-title{border-bottom:1px solid var(--color-background-border);font-weight:500;margin:0;padding:.5rem 1rem}.table-wrapper{margin-bottom:.5rem;margin-top:1rem;overflow-x:auto;padding:.2rem .2rem .75rem;width:100%}table.docutils{border-collapse:collapse;border-radius:.2rem;border-spacing:0;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1)}table.docutils th{background:var(--color-table-header-background)}table.docutils td,table.docutils th{border-bottom:1px solid var(--color-table-border);border-left:1px solid var(--color-table-border);border-right:1px solid var(--color-table-border);padding:0 .25rem}table.docutils td p,table.docutils th p{margin:.25rem}table.docutils td:first-child,table.docutils th:first-child{border-left:none}table.docutils td:last-child,table.docutils th:last-child{border-right:none}table.docutils td.text-left,table.docutils th.text-left{text-align:left}table.docutils td.text-right,table.docutils th.text-right{text-align:right}table.docutils td.text-center,table.docutils th.text-center{text-align:center}:target{scroll-margin-top:.5rem}@media(max-width:67em){:target{scroll-margin-top:calc(.5rem + var(--header-height))}section>span:target{scroll-margin-top:calc(.8rem + var(--header-height))}}.headerlink{font-weight:100;-webkit-user-select:none;-moz-user-select:none;user-select:none}.code-block-caption>.headerlink,dl dt>.headerlink,figcaption p>.headerlink,h1>.headerlink,h2>.headerlink,h3>.headerlink,h4>.headerlink,h5>.headerlink,h6>.headerlink,p.caption>.headerlink,table>caption>.headerlink{margin-left:.5rem;visibility:hidden}.code-block-caption:hover>.headerlink,dl dt:hover>.headerlink,figcaption p:hover>.headerlink,h1:hover>.headerlink,h2:hover>.headerlink,h3:hover>.headerlink,h4:hover>.headerlink,h5:hover>.headerlink,h6:hover>.headerlink,p.caption:hover>.headerlink,table>caption:hover>.headerlink{visibility:visible}.code-block-caption>.toc-backref,dl dt>.toc-backref,figcaption p>.toc-backref,h1>.toc-backref,h2>.toc-backref,h3>.toc-backref,h4>.toc-backref,h5>.toc-backref,h6>.toc-backref,p.caption>.toc-backref,table>caption>.toc-backref{color:inherit;text-decoration-line:none}figure:hover>figcaption>p>.headerlink,table:hover>caption>.headerlink{visibility:visible}:target>h1:first-of-type,:target>h2:first-of-type,:target>h3:first-of-type,:target>h4:first-of-type,:target>h5:first-of-type,:target>h6:first-of-type,span:target~h1:first-of-type,span:target~h2:first-of-type,span:target~h3:first-of-type,span:target~h4:first-of-type,span:target~h5:first-of-type,span:target~h6:first-of-type{background-color:var(--color-highlight-on-target)}:target>h1:first-of-type code.literal,:target>h2:first-of-type code.literal,:target>h3:first-of-type code.literal,:target>h4:first-of-type code.literal,:target>h5:first-of-type code.literal,:target>h6:first-of-type code.literal,span:target~h1:first-of-type code.literal,span:target~h2:first-of-type code.literal,span:target~h3:first-of-type code.literal,span:target~h4:first-of-type code.literal,span:target~h5:first-of-type code.literal,span:target~h6:first-of-type code.literal{background-color:transparent}.literal-block-wrapper:target .code-block-caption,.this-will-duplicate-information-and-it-is-still-useful-here li :target,figure:target,table:target>caption{background-color:var(--color-highlight-on-target)}dt:target{background-color:var(--color-highlight-on-target)!important}.footnote-reference:target,.footnote>dt:target+dd{background-color:var(--color-highlight-on-target)}.guilabel{background-color:var(--color-guilabel-background);border:1px solid var(--color-guilabel-border);border-radius:.5em;color:var(--color-guilabel-text);font-size:.9em;padding:0 .3em}footer{display:flex;flex-direction:column;font-size:var(--font-size--small);margin-top:2rem}.bottom-of-page{align-items:center;border-top:1px solid var(--color-background-border);color:var(--color-foreground-secondary);display:flex;justify-content:space-between;line-height:1.5;margin-top:1rem;padding-bottom:1rem;padding-top:1rem}@media(max-width:46em){.bottom-of-page{flex-direction:column-reverse;gap:.25rem;text-align:center}}.bottom-of-page .left-details{font-size:var(--font-size--small)}.bottom-of-page .right-details{display:flex;flex-direction:column;gap:.25rem;text-align:right}.bottom-of-page .icons{display:flex;font-size:1rem;gap:.25rem;justify-content:flex-end}.bottom-of-page .icons a{text-decoration:none}.bottom-of-page .icons img,.bottom-of-page .icons svg{font-size:1.125rem;height:1em;width:1em}.related-pages a{align-items:center;display:flex;text-decoration:none}.related-pages a:hover .page-info .title{color:var(--color-link);text-decoration:underline;text-decoration-color:var(--color-link-underline)}.related-pages a svg.furo-related-icon,.related-pages a svg.furo-related-icon>use{color:var(--color-foreground-border);flex-shrink:0;height:.75rem;margin:0 .5rem;width:.75rem}.related-pages a.next-page{clear:right;float:right;max-width:50%;text-align:right}.related-pages a.prev-page{clear:left;float:left;max-width:50%}.related-pages a.prev-page svg{transform:rotate(180deg)}.page-info{display:flex;flex-direction:column;overflow-wrap:anywhere}.next-page .page-info{align-items:flex-end}.page-info .context{align-items:center;color:var(--color-foreground-muted);display:flex;font-size:var(--font-size--small);padding-bottom:.1rem;text-decoration:none}ul.search{list-style:none;padding-left:0}ul.search li{border-bottom:1px solid var(--color-background-border);padding:1rem 0}[role=main] .highlighted{background-color:var(--color-highlighted-background);color:var(--color-highlighted-text)}.sidebar-brand{display:flex;flex-direction:column;flex-shrink:0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-decoration:none}.sidebar-brand-text{color:var(--color-sidebar-brand-text);font-size:1.5rem;overflow-wrap:break-word}.sidebar-brand-text,.sidebar-logo-container{margin:var(--sidebar-item-spacing-vertical) 0}.sidebar-logo{display:block;margin:0 auto;max-width:100%}.sidebar-search-container{align-items:center;background:var(--color-sidebar-search-background);display:flex;margin-top:var(--sidebar-search-space-above);position:relative}.sidebar-search-container:focus-within,.sidebar-search-container:hover{background:var(--color-sidebar-search-background--focus)}.sidebar-search-container:before{background-color:var(--color-sidebar-search-icon);content:"";height:var(--sidebar-search-icon-size);left:var(--sidebar-item-spacing-horizontal);-webkit-mask-image:var(--icon-search);mask-image:var(--icon-search);position:absolute;width:var(--sidebar-search-icon-size)}.sidebar-search{background:transparent;border:none;border-bottom:1px solid var(--color-sidebar-search-border);border-top:1px solid var(--color-sidebar-search-border);box-sizing:border-box;color:var(--color-sidebar-search-foreground);padding:var(--sidebar-search-input-spacing-vertical) var(--sidebar-search-input-spacing-horizontal) var(--sidebar-search-input-spacing-vertical) calc(var(--sidebar-item-spacing-horizontal) + var(--sidebar-search-input-spacing-horizontal) + var(--sidebar-search-icon-size));width:100%;z-index:10}.sidebar-search:focus{outline:none}.sidebar-search::-moz-placeholder{font-size:var(--sidebar-search-input-font-size)}.sidebar-search::placeholder{font-size:var(--sidebar-search-input-font-size)}#searchbox .highlight-link{margin:0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal) 0;text-align:center}#searchbox .highlight-link a{color:var(--color-sidebar-search-icon);font-size:var(--font-size--small--2)}.sidebar-tree{font-size:var(--sidebar-item-font-size);margin-bottom:var(--sidebar-item-spacing-vertical);margin-top:var(--sidebar-tree-space-above)}.sidebar-tree ul{display:flex;flex-direction:column;list-style:none;margin-bottom:0;margin-top:0;padding:0}.sidebar-tree li{margin:0;position:relative}.sidebar-tree li>ul{margin-left:var(--sidebar-item-spacing-horizontal)}.sidebar-tree .icon,.sidebar-tree .reference{color:var(--color-sidebar-link-text)}.sidebar-tree .reference{box-sizing:border-box;display:inline-block;height:100%;line-height:var(--sidebar-item-line-height);overflow-wrap:anywhere;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-decoration:none;width:100%}.sidebar-tree .reference:hover{background:var(--color-sidebar-item-background--hover)}.sidebar-tree .reference.external:after{color:var(--color-sidebar-link-text);content:url("data:image/svg+xml;charset=utf-8,%3Csvg width='12' height='12' xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' stroke-width='1.5' stroke='%23607D8B' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M0 0h24v24H0z' stroke='none'/%3E%3Cpath d='M11 7H6a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h9a2 2 0 0 0 2-2v-5M10 14 20 4M15 4h5v5'/%3E%3C/svg%3E");margin:0 .25rem;vertical-align:middle}.sidebar-tree .current-page>.reference{font-weight:700}.sidebar-tree label{align-items:center;cursor:pointer;display:flex;height:var(--sidebar-item-height);justify-content:center;position:absolute;right:0;top:0;-webkit-user-select:none;-moz-user-select:none;user-select:none;width:var(--sidebar-expander-width)}.sidebar-tree .caption,.sidebar-tree :not(.caption)>.caption-text{color:var(--color-sidebar-caption-text);font-size:var(--sidebar-caption-font-size);font-weight:700;margin:var(--sidebar-caption-space-above) 0 0 0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-transform:uppercase}.sidebar-tree li.has-children>.reference{padding-right:var(--sidebar-expander-width)}.sidebar-tree .toctree-l1>.reference,.sidebar-tree .toctree-l1>label .icon{color:var(--color-sidebar-link-text--top-level)}.sidebar-tree label{background:var(--color-sidebar-item-expander-background)}.sidebar-tree label:hover{background:var(--color-sidebar-item-expander-background--hover)}.sidebar-tree .current>.reference{background:var(--color-sidebar-item-background--current)}.sidebar-tree .current>.reference:hover{background:var(--color-sidebar-item-background--hover)}.toctree-checkbox{display:none;position:absolute}.toctree-checkbox~ul{display:none}.toctree-checkbox~label .icon svg{transform:rotate(90deg)}.toctree-checkbox:checked~ul{display:block}.toctree-checkbox:checked~label .icon svg{transform:rotate(-90deg)}.toc-title-container{padding:var(--toc-title-padding);padding-top:var(--toc-spacing-vertical)}.toc-title{color:var(--color-toc-title-text);font-size:var(--toc-title-font-size);padding-left:var(--toc-spacing-horizontal);text-transform:uppercase}.no-toc{display:none}.toc-tree-container{padding-bottom:var(--toc-spacing-vertical)}.toc-tree{border-left:1px solid var(--color-background-border);font-size:var(--toc-font-size);line-height:1.3;padding-left:calc(var(--toc-spacing-horizontal) - var(--toc-item-spacing-horizontal))}.toc-tree>ul>li:first-child{padding-top:0}.toc-tree>ul>li:first-child>ul{padding-left:0}.toc-tree>ul>li:first-child>a{display:none}.toc-tree ul{list-style-type:none;margin-bottom:0;margin-top:0;padding-left:var(--toc-item-spacing-horizontal)}.toc-tree li{padding-top:var(--toc-item-spacing-vertical)}.toc-tree li.scroll-current>.reference{color:var(--color-toc-item-text--active);font-weight:700}.toc-tree .reference{color:var(--color-toc-item-text);overflow-wrap:anywhere;text-decoration:none}.toc-scroll{max-height:100vh;overflow-y:scroll}.contents:not(.this-will-duplicate-information-and-it-is-still-useful-here){background:rgba(255,0,0,.25);color:var(--color-problematic)}.contents:not(.this-will-duplicate-information-and-it-is-still-useful-here):before{content:"ERROR: Adding a table of contents in Furo-based documentation is unnecessary, and does not work well with existing styling.Add a 'this-will-duplicate-information-and-it-is-still-useful-here' class, if you want an escape hatch."}.text-align\:left>p{text-align:left}.text-align\:center>p{text-align:center}.text-align\:right>p{text-align:right} +/*# sourceMappingURL=furo.css.map*/ \ No newline at end of file diff --git a/_static/styles/furo.css.map b/_static/styles/furo.css.map new file mode 100644 index 00000000..d1dfb109 --- /dev/null +++ b/_static/styles/furo.css.map @@ -0,0 +1 @@ +{"version":3,"file":"styles/furo.css","mappings":"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0CACE,CAFF,kBACA,CACE,wEACA,CARA,YACA,CAKF,mBAFF,OAII,eACA,CAJF,iCAJE,cAGJ,CANI,oBAEA,CAKF,SAIE,2BADA,UACA,kBAGF,sCACA,CAFF,WACE,WACA,qCACE,gCACA,2EACA,sDAKJ,aACE,mDAII,CAJJ,6CAII,kEACA,iBACE,iDACA,+CACE,aACA,WADA,+BACA,uEANN,YACE,mDAEE,mBADF,0CACE,CADF,qBACE,0DACA,YACE,4DACA,sEANN,YACE,8CACA,kBADA,UACA,2CACE,2EACA,cACE,kEACA,mEANN,yBACE,4DACA,sBACE,+EAEE,iEACA,qEANN,sCACE,CAGE,iBAHF,gBAGE,qBACE,CAJJ,uBACA,gDACE,wDACA,6DAHF,2CACA,CADA,gBACA,eACE,CAGE,sBANN,8BACE,CAII,iBAFF,4DACA,WACE,YADF,uCACE,6EACA,2BANN,8CACE,kDACA,0CACE,8BACA,yFACE,sBACA,sFALJ,mEACA,sBACE,kEACA,6EACE,uCACA,kEALJ,qGAEE,kEACA,6EACE,uCACA,kEALJ,8CACA,uDACE,sEACA,2EACE,sCACA,iEALJ,mGACA,qCACE,oDACA,0DACE,6GACA,gDAGR,yDCrEA,sEACE,CACA,6GACE,gEACF,iGAIF,wFACE,qDAGA,mGAEE,2CAEF,4FACE,gCACF,wGACE,8DAEE,6FAIA,iJAKN,6GACE,gDAKF,yDACA,qCAGA,6BACA,kBACA,qDAKA,oCAEA,+DAGA,2CAGE,oDAIA,oEAEE,qBAGJ,wDAEE,uCAEF,kEAGA,8CAEA,uDAKA,oCAEA,yDAEE,gEAKF,+CC5FA,0EAGE,CACA,qDCLJ,+DAIE,sCAIA,kEACE,yBACA,2FAMA,gBACA,yGCbF,mBAOA,2MAIA,4HAYA,0DACE,8GAYF,8HAQE,mBAEA,6HAOF,YAGA,mIAME,eACA,CAFF,YAEE,4FAMJ,8BAEE,uBAYA,sCAEE,CAJF,oBAEA,CARA,wCAEA,CAHA,8BACA,CAFA,eACA,CAGA,wCAEA,CAEA,mDAIE,kCACE,6BACA,4CAKJ,kDAIA,eACE,aAGF,8BACE,uDACA,sCACA,cAEA,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","sources":["webpack:///./node_modules/normalize.css/normalize.css","webpack:///./src/furo/assets/styles/base/_print.sass","webpack:///./src/furo/assets/styles/base/_screen-readers.sass","webpack:///./src/furo/assets/styles/base/_theme.sass","webpack:///./src/furo/assets/styles/variables/_fonts.scss","webpack:///./src/furo/assets/styles/variables/_spacing.scss","webpack:///./src/furo/assets/styles/variables/_icons.scss","webpack:///./src/furo/assets/styles/variables/_admonitions.scss","webpack:///./src/furo/assets/styles/variables/_colors.scss","webpack:///./src/furo/assets/styles/base/_typography.sass","webpack:///./src/furo/assets/styles/_scaffold.sass","webpack:///./src/furo/assets/styles/content/_admonitions.sass","webpack:///./src/furo/assets/styles/content/_api.sass","webpack:///./src/furo/assets/styles/content/_blocks.sass","webpack:///./src/furo/assets/styles/content/_captions.sass","webpack:///./src/furo/assets/styles/content/_code.sass","webpack:///./src/furo/assets/styles/content/_footnotes.sass","webpack:///./src/furo/assets/styles/content/_images.sass","webpack:///./src/furo/assets/styles/content/_indexes.sass","webpack:///./src/furo/assets/styles/content/_lists.sass","webpack:///./src/furo/assets/styles/content/_math.sass","webpack:///./src/furo/assets/styles/content/_misc.sass","webpack:///./src/furo/assets/styles/content/_rubrics.sass","webpack:///./src/furo/assets/styles/content/_sidebar.sass","webpack:///./src/furo/assets/styles/content/_tables.sass","webpack:///./src/furo/assets/styles/content/_target.sass","webpack:///./src/furo/assets/styles/content/_gui-labels.sass","webpack:///./src/furo/assets/styles/components/_footer.sass","webpack:///./src/furo/assets/styles/components/_sidebar.sass","webpack:///./src/furo/assets/styles/components/_table_of_contents.sass","webpack:///./src/furo/assets/styles/_shame.sass"],"sourcesContent":["/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */\n\n/* Document\n ========================================================================== */\n\n/**\n * 1. Correct the line height in all browsers.\n * 2. Prevent adjustments of font size after orientation changes in iOS.\n */\n\nhtml {\n line-height: 1.15; /* 1 */\n -webkit-text-size-adjust: 100%; /* 2 */\n}\n\n/* Sections\n ========================================================================== */\n\n/**\n * Remove the margin in all browsers.\n */\n\nbody {\n margin: 0;\n}\n\n/**\n * Render the `main` element consistently in IE.\n */\n\nmain {\n display: block;\n}\n\n/**\n * Correct the font size and margin on `h1` elements within `section` and\n * `article` contexts in Chrome, Firefox, and Safari.\n */\n\nh1 {\n font-size: 2em;\n margin: 0.67em 0;\n}\n\n/* Grouping content\n ========================================================================== */\n\n/**\n * 1. Add the correct box sizing in Firefox.\n * 2. Show the overflow in Edge and IE.\n */\n\nhr {\n box-sizing: content-box; /* 1 */\n height: 0; /* 1 */\n overflow: visible; /* 2 */\n}\n\n/**\n * 1. Correct the inheritance and scaling of font size in all browsers.\n * 2. Correct the odd `em` font sizing in all browsers.\n */\n\npre {\n font-family: monospace, monospace; /* 1 */\n font-size: 1em; /* 2 */\n}\n\n/* Text-level semantics\n ========================================================================== */\n\n/**\n * Remove the gray background on active links in IE 10.\n */\n\na {\n background-color: transparent;\n}\n\n/**\n * 1. Remove the bottom border in Chrome 57-\n * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.\n */\n\nabbr[title] {\n border-bottom: none; /* 1 */\n text-decoration: underline; /* 2 */\n text-decoration: underline dotted; /* 2 */\n}\n\n/**\n * Add the correct font weight in Chrome, Edge, and Safari.\n */\n\nb,\nstrong {\n font-weight: bolder;\n}\n\n/**\n * 1. Correct the inheritance and scaling of font size in all browsers.\n * 2. Correct the odd `em` font sizing in all browsers.\n */\n\ncode,\nkbd,\nsamp {\n font-family: monospace, monospace; /* 1 */\n font-size: 1em; /* 2 */\n}\n\n/**\n * Add the correct font size in all browsers.\n */\n\nsmall {\n font-size: 80%;\n}\n\n/**\n * Prevent `sub` and `sup` elements from affecting the line height in\n * all browsers.\n */\n\nsub,\nsup {\n font-size: 75%;\n line-height: 0;\n position: relative;\n vertical-align: baseline;\n}\n\nsub {\n bottom: -0.25em;\n}\n\nsup {\n top: -0.5em;\n}\n\n/* Embedded content\n ========================================================================== */\n\n/**\n * Remove the border on images inside links in IE 10.\n */\n\nimg {\n border-style: none;\n}\n\n/* Forms\n ========================================================================== */\n\n/**\n * 1. Change the font styles in all browsers.\n * 2. Remove the margin in Firefox and Safari.\n */\n\nbutton,\ninput,\noptgroup,\nselect,\ntextarea {\n font-family: inherit; /* 1 */\n font-size: 100%; /* 1 */\n line-height: 1.15; /* 1 */\n margin: 0; /* 2 */\n}\n\n/**\n * Show the overflow in IE.\n * 1. Show the overflow in Edge.\n */\n\nbutton,\ninput { /* 1 */\n overflow: visible;\n}\n\n/**\n * Remove the inheritance of text transform in Edge, Firefox, and IE.\n * 1. Remove the inheritance of text transform in Firefox.\n */\n\nbutton,\nselect { /* 1 */\n text-transform: none;\n}\n\n/**\n * Correct the inability to style clickable types in iOS and Safari.\n */\n\nbutton,\n[type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n -webkit-appearance: button;\n}\n\n/**\n * Remove the inner border and padding in Firefox.\n */\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n border-style: none;\n padding: 0;\n}\n\n/**\n * Restore the focus styles unset by the previous rule.\n */\n\nbutton:-moz-focusring,\n[type=\"button\"]:-moz-focusring,\n[type=\"reset\"]:-moz-focusring,\n[type=\"submit\"]:-moz-focusring {\n outline: 1px dotted ButtonText;\n}\n\n/**\n * Correct the padding in Firefox.\n */\n\nfieldset {\n padding: 0.35em 0.75em 0.625em;\n}\n\n/**\n * 1. Correct the text wrapping in Edge and IE.\n * 2. Correct the color inheritance from `fieldset` elements in IE.\n * 3. Remove the padding so developers are not caught out when they zero out\n * `fieldset` elements in all browsers.\n */\n\nlegend {\n box-sizing: border-box; /* 1 */\n color: inherit; /* 2 */\n display: table; /* 1 */\n max-width: 100%; /* 1 */\n padding: 0; /* 3 */\n white-space: normal; /* 1 */\n}\n\n/**\n * Add the correct vertical alignment in Chrome, Firefox, and Opera.\n */\n\nprogress {\n vertical-align: baseline;\n}\n\n/**\n * Remove the default vertical scrollbar in IE 10+.\n */\n\ntextarea {\n overflow: auto;\n}\n\n/**\n * 1. Add the correct box sizing in IE 10.\n * 2. Remove the padding in IE 10.\n */\n\n[type=\"checkbox\"],\n[type=\"radio\"] {\n box-sizing: border-box; /* 1 */\n padding: 0; /* 2 */\n}\n\n/**\n * Correct the cursor style of increment and decrement buttons in Chrome.\n */\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n height: auto;\n}\n\n/**\n * 1. Correct the odd appearance in Chrome and Safari.\n * 2. Correct the outline style in Safari.\n */\n\n[type=\"search\"] {\n -webkit-appearance: textfield; /* 1 */\n outline-offset: -2px; /* 2 */\n}\n\n/**\n * Remove the inner padding in Chrome and Safari on macOS.\n */\n\n[type=\"search\"]::-webkit-search-decoration {\n -webkit-appearance: none;\n}\n\n/**\n * 1. Correct the inability to style clickable types in iOS and Safari.\n * 2. Change font properties to `inherit` in Safari.\n */\n\n::-webkit-file-upload-button {\n -webkit-appearance: button; /* 1 */\n font: inherit; /* 2 */\n}\n\n/* Interactive\n ========================================================================== */\n\n/*\n * Add the correct display in Edge, IE 10+, and Firefox.\n */\n\ndetails {\n display: block;\n}\n\n/*\n * Add the correct display in all browsers.\n */\n\nsummary {\n display: list-item;\n}\n\n/* Misc\n ========================================================================== */\n\n/**\n * Add the correct display in IE 10+.\n */\n\ntemplate {\n display: none;\n}\n\n/**\n * Add the correct display in IE 10.\n */\n\n[hidden] {\n display: none;\n}\n","// This file contains styles for managing print media.\n\n////////////////////////////////////////////////////////////////////////////////\n// Hide elements not relevant to print media.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n // Hide icon container.\n .content-icon-container\n display: none !important\n\n // Hide showing header links if hovering over when printing.\n .headerlink\n display: none !important\n\n // Hide mobile header.\n .mobile-header\n display: none !important\n\n // Hide navigation links.\n .related-pages\n display: none !important\n\n////////////////////////////////////////////////////////////////////////////////\n// Tweaks related to decolorization.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n // Apply a border around code which no longer have a color background.\n .highlight\n border: 0.1pt solid var(--color-foreground-border)\n\n////////////////////////////////////////////////////////////////////////////////\n// Avoid page break in some relevant cases.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n ul, ol, dl, a, table, pre, blockquote\n page-break-inside: avoid\n\n h1, h2, h3, h4, h5, h6, img, figure, caption\n page-break-inside: avoid\n page-break-after: avoid\n\n ul, ol, dl\n page-break-before: avoid\n",".visually-hidden\n position: absolute !important\n width: 1px !important\n height: 1px !important\n padding: 0 !important\n margin: -1px !important\n overflow: hidden !important\n clip: rect(0,0,0,0) !important\n white-space: nowrap !important\n border: 0 !important\n\n:-moz-focusring\n outline: auto\n","// This file serves as the \"skeleton\" of the theming logic.\n//\n// This contains the bulk of the logic for handling dark mode, color scheme\n// toggling and the handling of color-scheme-specific hiding of elements.\n\nbody\n @include fonts\n @include spacing\n @include icons\n @include admonitions\n @include default-admonition(#651fff, \"abstract\")\n @include default-topic(#14B8A6, \"pencil\")\n\n @include colors\n\n.only-light\n display: block !important\nhtml body .only-dark\n display: none !important\n\n// Ignore dark-mode hints if print media.\n@media not print\n // Enable dark-mode, if requested.\n body[data-theme=\"dark\"]\n @include colors-dark\n\n html & .only-light\n display: none !important\n .only-dark\n display: block !important\n\n // Enable dark mode, unless explicitly told to avoid.\n @media (prefers-color-scheme: dark)\n body:not([data-theme=\"light\"])\n @include colors-dark\n\n html & .only-light\n display: none !important\n .only-dark\n display: block !important\n\n//\n// Theme toggle presentation\n//\nbody[data-theme=\"auto\"]\n .theme-toggle svg.theme-icon-when-auto\n display: block\n\nbody[data-theme=\"dark\"]\n .theme-toggle svg.theme-icon-when-dark\n display: block\n\nbody[data-theme=\"light\"]\n .theme-toggle svg.theme-icon-when-light\n display: block\n","// Fonts used by this theme.\n//\n// There are basically two things here -- using the system font stack and\n// defining sizes for various elements in %ages. We could have also used `em`\n// but %age is easier to reason about for me.\n\n@mixin fonts {\n // These are adapted from https://systemfontstack.com/\n --font-stack: -apple-system, BlinkMacSystemFont, Segoe UI, Helvetica, Arial,\n sans-serif, Apple Color Emoji, Segoe UI Emoji;\n --font-stack--monospace: \"SFMono-Regular\", Menlo, Consolas, Monaco,\n Liberation Mono, Lucida Console, monospace;\n\n --font-size--normal: 100%;\n --font-size--small: 87.5%;\n --font-size--small--2: 81.25%;\n --font-size--small--3: 75%;\n --font-size--small--4: 62.5%;\n\n // Sidebar\n --sidebar-caption-font-size: var(--font-size--small--2);\n --sidebar-item-font-size: var(--font-size--small);\n --sidebar-search-input-font-size: var(--font-size--small);\n\n // Table of Contents\n --toc-font-size: var(--font-size--small--3);\n --toc-font-size--mobile: var(--font-size--normal);\n --toc-title-font-size: var(--font-size--small--4);\n\n // Admonitions\n //\n // These aren't defined in terms of %ages, since nesting these is permitted.\n --admonition-font-size: 0.8125rem;\n --admonition-title-font-size: 0.8125rem;\n\n // Code\n --code-font-size: var(--font-size--small--2);\n\n // API\n --api-font-size: var(--font-size--small);\n}\n","// Spacing for various elements on the page\n//\n// If the user wants to tweak things in a certain way, they are permitted to.\n// They also have to deal with the consequences though!\n\n@mixin spacing {\n // Header!\n --header-height: calc(\n var(--sidebar-item-line-height) + 4 * #{var(--sidebar-item-spacing-vertical)}\n );\n --header-padding: 0.5rem;\n\n // Sidebar\n --sidebar-tree-space-above: 1.5rem;\n --sidebar-caption-space-above: 1rem;\n\n --sidebar-item-line-height: 1rem;\n --sidebar-item-spacing-vertical: 0.5rem;\n --sidebar-item-spacing-horizontal: 1rem;\n --sidebar-item-height: calc(\n var(--sidebar-item-line-height) + 2 *#{var(--sidebar-item-spacing-vertical)}\n );\n\n --sidebar-expander-width: var(--sidebar-item-height); // be square\n\n --sidebar-search-space-above: 0.5rem;\n --sidebar-search-input-spacing-vertical: 0.5rem;\n --sidebar-search-input-spacing-horizontal: 0.5rem;\n --sidebar-search-input-height: 1rem;\n --sidebar-search-icon-size: var(--sidebar-search-input-height);\n\n // Table of Contents\n --toc-title-padding: 0.25rem 0;\n --toc-spacing-vertical: 1.5rem;\n --toc-spacing-horizontal: 1.5rem;\n --toc-item-spacing-vertical: 0.4rem;\n --toc-item-spacing-horizontal: 1rem;\n}\n","// Expose theme icons as CSS variables.\n\n$icons: (\n // Adapted from tabler-icons\n // url: https://tablericons.com/\n \"search\":\n url('data:image/svg+xml;charset=utf-8,'),\n // Factored out from mkdocs-material on 24-Aug-2020.\n // url: https://squidfunk.github.io/mkdocs-material/reference/admonitions/\n \"pencil\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"abstract\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"info\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"flame\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"question\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"warning\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"failure\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"spark\":\n url('data:image/svg+xml;charset=utf-8,')\n);\n\n@mixin icons {\n @each $name, $glyph in $icons {\n --icon-#{$name}: #{$glyph};\n }\n}\n","// Admonitions\n\n// Structure of these is:\n// admonition-class: color \"icon-name\";\n//\n// The colors are translated into CSS variables below. The icons are\n// used directly in the main declarations to set the `mask-image` in\n// the title.\n\n// prettier-ignore\n$admonitions: (\n // Each of these has an reST directives for it.\n \"caution\": #ff9100 \"spark\",\n \"warning\": #ff9100 \"warning\",\n \"danger\": #ff5252 \"spark\",\n \"attention\": #ff5252 \"warning\",\n \"error\": #ff5252 \"failure\",\n \"hint\": #00c852 \"question\",\n \"tip\": #00c852 \"info\",\n \"important\": #00bfa5 \"flame\",\n \"note\": #00b0ff \"pencil\",\n \"seealso\": #448aff \"info\",\n \"admonition-todo\": #808080 \"pencil\"\n);\n\n@mixin default-admonition($color, $icon-name) {\n --color-admonition-title: #{$color};\n --color-admonition-title-background: #{rgba($color, 0.2)};\n\n --icon-admonition-default: var(--icon-#{$icon-name});\n}\n\n@mixin default-topic($color, $icon-name) {\n --color-topic-title: #{$color};\n --color-topic-title-background: #{rgba($color, 0.2)};\n\n --icon-topic-default: var(--icon-#{$icon-name});\n}\n\n@mixin admonitions {\n @each $name, $values in $admonitions {\n --color-admonition-title--#{$name}: #{nth($values, 1)};\n --color-admonition-title-background--#{$name}: #{rgba(\n nth($values, 1),\n 0.2\n )};\n }\n}\n","// Colors used throughout this theme.\n//\n// The aim is to give the user more control. Thus, instead of hard-coding colors\n// in various parts of the stylesheet, the approach taken is to define all\n// colors as CSS variables and reusing them in all the places.\n//\n// `colors-dark` depends on `colors` being included at a lower specificity.\n\n@mixin colors {\n --color-problematic: #b30000;\n\n // Base Colors\n --color-foreground-primary: black; // for main text and headings\n --color-foreground-secondary: #5a5c63; // for secondary text\n --color-foreground-muted: #646776; // for muted text\n --color-foreground-border: #878787; // for content borders\n\n --color-background-primary: white; // for content\n --color-background-secondary: #f8f9fb; // for navigation + ToC\n --color-background-hover: #efeff4ff; // for navigation-item hover\n --color-background-hover--transparent: #efeff400;\n --color-background-border: #eeebee; // for UI borders\n --color-background-item: #ccc; // for \"background\" items (eg: copybutton)\n\n // Announcements\n --color-announcement-background: #000000dd;\n --color-announcement-text: #eeebee;\n\n // Brand colors\n --color-brand-primary: #2962ff;\n --color-brand-content: #2a5adf;\n\n // API documentation\n --color-api-background: var(--color-background-hover--transparent);\n --color-api-background-hover: var(--color-background-hover);\n --color-api-overall: var(--color-foreground-secondary);\n --color-api-name: var(--color-problematic);\n --color-api-pre-name: var(--color-problematic);\n --color-api-paren: var(--color-foreground-secondary);\n --color-api-keyword: var(--color-foreground-primary);\n --color-highlight-on-target: #ffffcc;\n\n // Inline code background\n --color-inline-code-background: var(--color-background-secondary);\n\n // Highlighted text (search)\n --color-highlighted-background: #ddeeff;\n --color-highlighted-text: var(--color-foreground-primary);\n\n // GUI Labels\n --color-guilabel-background: #ddeeff80;\n --color-guilabel-border: #bedaf580;\n --color-guilabel-text: var(--color-foreground-primary);\n\n // Admonitions!\n --color-admonition-background: transparent;\n\n //////////////////////////////////////////////////////////////////////////////\n // Everything below this should be one of:\n // - var(...)\n // - *-gradient(...)\n // - special literal values (eg: transparent, none)\n //////////////////////////////////////////////////////////////////////////////\n\n // Tables\n --color-table-header-background: var(--color-background-secondary);\n --color-table-border: var(--color-background-border);\n\n // Cards\n --color-card-border: var(--color-background-secondary);\n --color-card-background: transparent;\n --color-card-marginals-background: var(--color-background-secondary);\n\n // Header\n --color-header-background: var(--color-background-primary);\n --color-header-border: var(--color-background-border);\n --color-header-text: var(--color-foreground-primary);\n\n // Sidebar (left)\n --color-sidebar-background: var(--color-background-secondary);\n --color-sidebar-background-border: var(--color-background-border);\n\n --color-sidebar-brand-text: var(--color-foreground-primary);\n --color-sidebar-caption-text: var(--color-foreground-muted);\n --color-sidebar-link-text: var(--color-foreground-secondary);\n --color-sidebar-link-text--top-level: var(--color-brand-primary);\n\n --color-sidebar-item-background: var(--color-sidebar-background);\n --color-sidebar-item-background--current: var(\n --color-sidebar-item-background\n );\n --color-sidebar-item-background--hover: linear-gradient(\n 90deg,\n var(--color-background-hover--transparent) 0%,\n var(--color-background-hover) var(--sidebar-item-spacing-horizontal),\n var(--color-background-hover) 100%\n );\n\n --color-sidebar-item-expander-background: transparent;\n --color-sidebar-item-expander-background--hover: var(\n --color-background-hover\n );\n\n --color-sidebar-search-text: var(--color-foreground-primary);\n --color-sidebar-search-background: var(--color-background-secondary);\n --color-sidebar-search-background--focus: var(--color-background-primary);\n --color-sidebar-search-border: var(--color-background-border);\n --color-sidebar-search-icon: var(--color-foreground-muted);\n\n // Table of Contents (right)\n --color-toc-background: var(--color-background-primary);\n --color-toc-title-text: var(--color-foreground-muted);\n --color-toc-item-text: var(--color-foreground-secondary);\n --color-toc-item-text--hover: var(--color-foreground-primary);\n --color-toc-item-text--active: var(--color-brand-primary);\n\n // Actual page contents\n --color-content-foreground: var(--color-foreground-primary);\n --color-content-background: transparent;\n\n // Links\n --color-link: var(--color-brand-content);\n --color-link--hover: var(--color-brand-content);\n --color-link-underline: var(--color-background-border);\n --color-link-underline--hover: var(--color-foreground-border);\n}\n\n@mixin colors-dark {\n --color-problematic: #ee5151;\n\n // Base Colors\n --color-foreground-primary: #ffffffcc; // for main text and headings\n --color-foreground-secondary: #9ca0a5; // for secondary text\n --color-foreground-muted: #81868d; // for muted text\n --color-foreground-border: #666666; // for content borders\n\n --color-background-primary: #131416; // for content\n --color-background-secondary: #1a1c1e; // for navigation + ToC\n --color-background-hover: #1e2124ff; // for navigation-item hover\n --color-background-hover--transparent: #1e212400;\n --color-background-border: #303335; // for UI borders\n --color-background-item: #444; // for \"background\" items (eg: copybutton)\n\n // Announcements\n --color-announcement-background: #000000dd;\n --color-announcement-text: #eeebee;\n\n // Brand colors\n --color-brand-primary: #2b8cee;\n --color-brand-content: #368ce2;\n\n // Highlighted text (search)\n --color-highlighted-background: #083563;\n\n // GUI Labels\n --color-guilabel-background: #08356380;\n --color-guilabel-border: #13395f80;\n\n // API documentation\n --color-api-keyword: var(--color-foreground-secondary);\n --color-highlight-on-target: #333300;\n\n // Admonitions\n --color-admonition-background: #18181a;\n\n // Cards\n --color-card-border: var(--color-background-secondary);\n --color-card-background: #18181a;\n --color-card-marginals-background: var(--color-background-hover);\n}\n","// This file contains the styling for making the content throughout the page,\n// including fonts, paragraphs, headings and spacing among these elements.\n\nbody\n font-family: var(--font-stack)\npre,\ncode,\nkbd,\nsamp\n font-family: var(--font-stack--monospace)\n\n// Make fonts look slightly nicer.\nbody\n -webkit-font-smoothing: antialiased\n -moz-osx-font-smoothing: grayscale\n\n// Line height from Bootstrap 4.1\narticle\n line-height: 1.5\n\n//\n// Headings\n//\nh1,\nh2,\nh3,\nh4,\nh5,\nh6\n line-height: 1.25\n font-weight: bold\n\n border-radius: 0.5rem\n margin-top: 0.5rem\n margin-bottom: 0.5rem\n margin-left: -0.5rem\n margin-right: -0.5rem\n padding-left: 0.5rem\n padding-right: 0.5rem\n\n + p\n margin-top: 0\n\nh1\n font-size: 2.5em\n margin-top: 1.75rem\n margin-bottom: 1rem\nh2\n font-size: 2em\n margin-top: 1.75rem\nh3\n font-size: 1.5em\nh4\n font-size: 1.25em\nh5\n font-size: 1.125em\nh6\n font-size: 1em\n\nsmall\n opacity: 75%\n font-size: 80%\n\n// Paragraph\np\n margin-top: 0.5rem\n margin-bottom: 0.75rem\n\n// Horizontal rules\nhr.docutils\n height: 1px\n padding: 0\n margin: 2rem 0\n background-color: var(--color-background-border)\n border: 0\n\n.centered\n text-align: center\n\n// Links\na\n text-decoration: underline\n\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline)\n\n &:hover\n color: var(--color-link--hover)\n text-decoration-color: var(--color-link-underline--hover)\n &.muted-link\n color: inherit\n &:hover\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline--hover)\n","// This file contains the styles for the overall layouting of the documentation\n// skeleton, including the responsive changes as well as sidebar toggles.\n//\n// This is implemented as a mobile-last design, which isn't ideal, but it is\n// reasonably good-enough and I got pretty tired by the time I'd finished this\n// to move the rules around to fix this. Shouldn't take more than 3-4 hours,\n// if you know what you're doing tho.\n\n// HACK: Not all browsers account for the scrollbar width in media queries.\n// This results in horizontal scrollbars in the breakpoint where we go\n// from displaying everything to hiding the ToC. We accomodate for this by\n// adding a bit of padding to the TOC drawer, disabling the horizontal\n// scrollbar and allowing the scrollbars to cover the padding.\n// https://www.456bereastreet.com/archive/201301/media_query_width_and_vertical_scrollbars/\n\n// HACK: Always having the scrollbar visible, prevents certain browsers from\n// causing the content to stutter horizontally between taller-than-viewport and\n// not-taller-than-viewport pages.\n\nhtml\n overflow-x: hidden\n overflow-y: scroll\n scroll-behavior: smooth\n\n.sidebar-scroll, .toc-scroll, article[role=main] *\n // Override Firefox scrollbar style\n scrollbar-width: thin\n scrollbar-color: var(--color-foreground-border) transparent\n\n // Override Chrome scrollbar styles\n &::-webkit-scrollbar\n width: 0.25rem\n height: 0.25rem\n &::-webkit-scrollbar-thumb\n background-color: var(--color-foreground-border)\n border-radius: 0.125rem\n\n//\n// Overalls\n//\nhtml,\nbody\n height: 100%\n color: var(--color-foreground-primary)\n background: var(--color-background-primary)\n\narticle\n color: var(--color-content-foreground)\n background: var(--color-content-background)\n overflow-wrap: break-word\n\n.page\n display: flex\n // fill the viewport for pages with little content.\n min-height: 100%\n\n.mobile-header\n width: 100%\n height: var(--header-height)\n background-color: var(--color-header-background)\n color: var(--color-header-text)\n border-bottom: 1px solid var(--color-header-border)\n\n // Looks like sub-script/super-script have this, and we need this to\n // be \"on top\" of those.\n z-index: 10\n\n // We don't show the header on large screens.\n display: none\n\n // Add shadow when scrolled\n &.scrolled\n border-bottom: none\n box-shadow: 0 0 0.2rem rgba(0, 0, 0, 0.1), 0 0.2rem 0.4rem rgba(0, 0, 0, 0.2)\n\n .header-center\n a\n color: var(--color-header-text)\n text-decoration: none\n\n.main\n display: flex\n flex: 1\n\n// Sidebar (left) also covers the entire left portion of screen.\n.sidebar-drawer\n box-sizing: border-box\n\n border-right: 1px solid var(--color-sidebar-background-border)\n background: var(--color-sidebar-background)\n\n display: flex\n justify-content: flex-end\n // These next two lines took me two days to figure out.\n width: calc((100% - #{$full-width}) / 2 + #{$sidebar-width})\n min-width: $sidebar-width\n\n// Scroll-along sidebars\n.sidebar-container,\n.toc-drawer\n box-sizing: border-box\n width: $sidebar-width\n\n.toc-drawer\n background: var(--color-toc-background)\n // See HACK described on top of this document\n padding-right: 1rem\n\n.sidebar-sticky,\n.toc-sticky\n position: sticky\n top: 0\n height: min(100%, 100vh)\n height: 100vh\n\n display: flex\n flex-direction: column\n\n.sidebar-scroll,\n.toc-scroll\n flex-grow: 1\n flex-shrink: 1\n\n overflow: auto\n scroll-behavior: smooth\n\n// Central items.\n.content\n padding: 0 $content-padding\n width: $content-width\n\n display: flex\n flex-direction: column\n justify-content: space-between\n\n.icon\n display: inline-block\n height: 1rem\n width: 1rem\n svg\n width: 100%\n height: 100%\n\n//\n// Accommodate announcement banner\n//\n.announcement\n background-color: var(--color-announcement-background)\n color: var(--color-announcement-text)\n\n height: var(--header-height)\n display: flex\n align-items: center\n overflow-x: auto\n & + .page\n min-height: calc(100% - var(--header-height))\n\n.announcement-content\n box-sizing: border-box\n padding: 0.5rem\n min-width: 100%\n white-space: nowrap\n text-align: center\n\n a\n color: var(--color-announcement-text)\n text-decoration-color: var(--color-announcement-text)\n\n &:hover\n color: var(--color-announcement-text)\n text-decoration-color: var(--color-link--hover)\n\n////////////////////////////////////////////////////////////////////////////////\n// Toggles for theme\n////////////////////////////////////////////////////////////////////////////////\n.no-js .theme-toggle-container // don't show theme toggle if there's no JS\n display: none\n\n.theme-toggle-container\n vertical-align: middle\n\n.theme-toggle\n cursor: pointer\n border: none\n padding: 0\n background: transparent\n\n.theme-toggle svg\n vertical-align: middle\n height: 1rem\n width: 1rem\n color: var(--color-foreground-primary)\n display: none\n\n.theme-toggle-header\n float: left\n padding: 1rem 0.5rem\n\n////////////////////////////////////////////////////////////////////////////////\n// Toggles for elements\n////////////////////////////////////////////////////////////////////////////////\n.toc-overlay-icon, .nav-overlay-icon\n display: none\n cursor: pointer\n\n .icon\n color: var(--color-foreground-secondary)\n height: 1rem\n width: 1rem\n\n.toc-header-icon, .nav-overlay-icon\n // for when we set display: flex\n justify-content: center\n align-items: center\n\n.toc-content-icon\n height: 1.5rem\n width: 1.5rem\n\n.content-icon-container\n float: right\n display: flex\n margin-top: 1.5rem\n margin-left: 1rem\n margin-bottom: 1rem\n gap: 0.5rem\n\n .edit-this-page svg\n color: inherit\n height: 1rem\n width: 1rem\n\n.sidebar-toggle\n position: absolute\n display: none\n// \n.sidebar-toggle[name=\"__toc\"]\n left: 20px\n.sidebar-toggle:checked\n left: 40px\n// \n\n.overlay\n position: fixed\n top: 0\n width: 0\n height: 0\n\n transition: width 0ms, height 0ms, opacity 250ms ease-out\n\n opacity: 0\n background-color: rgba(0, 0, 0, 0.54)\n.sidebar-overlay\n z-index: 20\n.toc-overlay\n z-index: 40\n\n// Keep things on top and smooth.\n.sidebar-drawer\n z-index: 30\n transition: left 250ms ease-in-out\n.toc-drawer\n z-index: 50\n transition: right 250ms ease-in-out\n\n// Show the Sidebar\n#__navigation:checked\n & ~ .sidebar-overlay\n width: 100%\n height: 100%\n opacity: 1\n & ~ .page\n .sidebar-drawer\n top: 0\n left: 0\n // Show the toc sidebar\n#__toc:checked\n & ~ .toc-overlay\n width: 100%\n height: 100%\n opacity: 1\n & ~ .page\n .toc-drawer\n top: 0\n right: 0\n\n////////////////////////////////////////////////////////////////////////////////\n// Back to top\n////////////////////////////////////////////////////////////////////////////////\n.back-to-top\n text-decoration: none\n\n display: none\n position: fixed\n left: 0\n top: 1rem\n padding: 0.5rem\n padding-right: 0.75rem\n border-radius: 1rem\n font-size: 0.8125rem\n\n background: var(--color-background-primary)\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), #6b728080 0px 0px 1px 0px\n\n z-index: 10\n\n margin-left: 50%\n transform: translateX(-50%)\n svg\n height: 1rem\n width: 1rem\n fill: currentColor\n display: inline-block\n\n span\n margin-left: 0.25rem\n\n .show-back-to-top &\n display: flex\n align-items: center\n\n////////////////////////////////////////////////////////////////////////////////\n// Responsive layouting\n////////////////////////////////////////////////////////////////////////////////\n// Make things a bit bigger on bigger screens.\n@media (min-width: $full-width + $sidebar-width)\n html\n font-size: 110%\n\n@media (max-width: $full-width)\n // Collapse \"toc\" into the icon.\n .toc-content-icon\n display: flex\n .toc-drawer\n position: fixed\n height: 100vh\n top: 0\n right: -$sidebar-width\n border-left: 1px solid var(--color-background-muted)\n .toc-tree\n border-left: none\n font-size: var(--toc-font-size--mobile)\n\n // Accomodate for a changed content width.\n .sidebar-drawer\n width: calc((100% - #{$full-width - $sidebar-width}) / 2 + #{$sidebar-width})\n\n@media (max-width: $full-width - $sidebar-width)\n // Collapse \"navigation\".\n .nav-overlay-icon\n display: flex\n .sidebar-drawer\n position: fixed\n height: 100vh\n width: $sidebar-width\n\n top: 0\n left: -$sidebar-width\n\n // Swap which icon is visible.\n .toc-header-icon\n display: flex\n .toc-content-icon, .theme-toggle-content\n display: none\n .theme-toggle-header\n display: block\n\n // Show the header.\n .mobile-header\n position: sticky\n top: 0\n display: flex\n justify-content: space-between\n align-items: center\n\n .header-left,\n .header-right\n display: flex\n height: var(--header-height)\n padding: 0 var(--header-padding)\n label\n height: 100%\n width: 100%\n user-select: none\n\n .nav-overlay-icon .icon,\n .theme-toggle svg\n height: 1.25rem\n width: 1.25rem\n\n // Add a scroll margin for the content\n :target\n scroll-margin-top: var(--header-height)\n\n // Show back-to-top below the header\n .back-to-top\n top: calc(var(--header-height) + 0.5rem)\n\n // Center the page, and accommodate for the header.\n .page\n flex-direction: column\n justify-content: center\n .content\n margin-left: auto\n margin-right: auto\n\n@media (max-width: $content-width + 2* $content-padding)\n // Content should respect window limits.\n .content\n width: 100%\n overflow-x: auto\n\n@media (max-width: $content-width)\n .content\n padding: 0 $content-padding--small\n // Don't float sidebars to the right.\n article aside.sidebar\n float: none\n width: 100%\n margin: 1rem 0\n","//\n// The design here is strongly inspired by mkdocs-material.\n.admonition, .topic\n margin: 1rem auto\n padding: 0 0.5rem 0.5rem 0.5rem\n\n background: var(--color-admonition-background)\n\n border-radius: 0.2rem\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n font-size: var(--admonition-font-size)\n\n overflow: hidden\n page-break-inside: avoid\n\n // First element should have no margin, since the title has it.\n > :nth-child(2)\n margin-top: 0\n\n // Last item should have no margin, since we'll control that w/ padding\n > :last-child\n margin-bottom: 0\n\n.admonition p.admonition-title,\np.topic-title\n position: relative\n margin: 0 -0.5rem 0.5rem\n padding-left: 2rem\n padding-right: .5rem\n padding-top: .4rem\n padding-bottom: .4rem\n\n font-weight: 500\n font-size: var(--admonition-title-font-size)\n line-height: 1.3\n\n // Our fancy icon\n &::before\n content: \"\"\n position: absolute\n left: 0.5rem\n width: 1rem\n height: 1rem\n\n// Default styles\np.admonition-title\n background-color: var(--color-admonition-title-background)\n &::before\n background-color: var(--color-admonition-title)\n mask-image: var(--icon-admonition-default)\n mask-repeat: no-repeat\n\np.topic-title\n background-color: var(--color-topic-title-background)\n &::before\n background-color: var(--color-topic-title)\n mask-image: var(--icon-topic-default)\n mask-repeat: no-repeat\n\n//\n// Variants\n//\n.admonition\n border-left: 0.2rem solid var(--color-admonition-title)\n\n @each $type, $value in $admonitions\n &.#{$type}\n border-left-color: var(--color-admonition-title--#{$type})\n > .admonition-title\n background-color: var(--color-admonition-title-background--#{$type})\n &::before\n background-color: var(--color-admonition-title--#{$type})\n mask-image: var(--icon-#{nth($value, 2)})\n\n.admonition-todo > .admonition-title\n text-transform: uppercase\n","// This file stylizes the API documentation (stuff generated by autodoc). It's\n// deeply nested due to how autodoc structures the HTML without enough classes\n// to select the relevant items.\n\n// API docs!\ndl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)\n // Tweak the spacing of all the things!\n dd\n margin-left: 2rem\n > :first-child\n margin-top: 0.125rem\n > :last-child\n margin-bottom: 0.75rem\n\n // This is used for the arguments\n .field-list\n margin-bottom: 0.75rem\n\n // \"Headings\" (like \"Parameters\" and \"Return\")\n > dt\n text-transform: uppercase\n font-size: var(--font-size--small)\n\n dd:empty\n margin-bottom: 0.5rem\n dd > ul\n margin-left: -1.2rem\n > li\n > p:nth-child(2)\n margin-top: 0\n // When the last-empty-paragraph follows a paragraph, it doesn't need\n // to augument the existing spacing.\n > p + p:last-child:empty\n margin-top: 0\n margin-bottom: 0\n\n // Colorize the elements\n > dt\n color: var(--color-api-overall)\n\n.sig:not(.sig-inline)\n font-weight: bold\n\n font-size: var(--api-font-size)\n font-family: var(--font-stack--monospace)\n\n margin-left: -0.25rem\n margin-right: -0.25rem\n padding-top: 0.25rem\n padding-bottom: 0.25rem\n padding-right: 0.5rem\n\n // These are intentionally em, to properly match the font size.\n padding-left: 3em\n text-indent: -2.5em\n\n border-radius: 0.25rem\n\n background: var(--color-api-background)\n transition: background 100ms ease-out\n\n &:hover\n background: var(--color-api-background-hover)\n\n // adjust the size of the [source] link on the right.\n a.reference\n .viewcode-link\n font-weight: normal\n width: 3.5rem\n\nem.property\n font-style: normal\n &:first-child\n color: var(--color-api-keyword)\n.sig-name\n color: var(--color-api-name)\n.sig-prename\n font-weight: normal\n color: var(--color-api-pre-name)\n.sig-paren\n color: var(--color-api-paren)\n.sig-param\n font-style: normal\n\n.versionmodified\n font-style: italic\ndiv.versionadded, div.versionchanged, div.deprecated\n p\n margin-top: 0.125rem\n margin-bottom: 0.125rem\n\n// Align the [docs] and [source] to the right.\n.viewcode-link, .viewcode-back\n float: right\n text-align: right\n",".line-block\n margin-top: 0.5rem\n margin-bottom: 0.75rem\n .line-block\n margin-top: 0rem\n margin-bottom: 0rem\n padding-left: 1rem\n","// Captions\narticle p.caption,\ntable > caption,\n.code-block-caption\n font-size: var(--font-size--small)\n text-align: center\n\n// Caption above a TOCTree\n.toctree-wrapper.compound\n .caption, :not(.caption) > .caption-text\n font-size: var(--font-size--small)\n text-transform: uppercase\n\n text-align: initial\n margin-bottom: 0\n\n > ul\n margin-top: 0\n margin-bottom: 0\n","// Inline code\ncode.literal, .sig-inline\n background: var(--color-inline-code-background)\n border-radius: 0.2em\n // Make the font smaller, and use padding to recover.\n font-size: var(--font-size--small--2)\n padding: 0.1em 0.2em\n\n pre.literal-block &\n font-size: inherit\n padding: 0\n\n p &\n border: 1px solid var(--color-background-border)\n\n.sig-inline\n font-family: var(--font-stack--monospace)\n\n// Code and Literal Blocks\n$code-spacing-vertical: 0.625rem\n$code-spacing-horizontal: 0.875rem\n\n// Wraps every literal block + line numbers.\ndiv[class*=\" highlight-\"],\ndiv[class^=\"highlight-\"]\n margin: 1em 0\n display: flex\n\n .table-wrapper\n margin: 0\n padding: 0\n\npre\n margin: 0\n padding: 0\n overflow: auto\n\n // Needed to have more specificity than pygments' \"pre\" selector. :(\n article[role=\"main\"] .highlight &\n line-height: 1.5\n\n &.literal-block,\n .highlight &\n font-size: var(--code-font-size)\n padding: $code-spacing-vertical $code-spacing-horizontal\n\n // Make it look like all the other blocks.\n &.literal-block\n margin-top: 1rem\n margin-bottom: 1rem\n\n border-radius: 0.2rem\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n\n// All code is always contained in this.\n.highlight\n width: 100%\n border-radius: 0.2rem\n\n // Make line numbers and prompts un-selectable.\n .gp, span.linenos\n user-select: none\n pointer-events: none\n\n // Expand the line-highlighting.\n .hll\n display: block\n margin-left: -$code-spacing-horizontal\n margin-right: -$code-spacing-horizontal\n padding-left: $code-spacing-horizontal\n padding-right: $code-spacing-horizontal\n\n/* Make code block captions be nicely integrated */\n.code-block-caption\n display: flex\n padding: $code-spacing-vertical $code-spacing-horizontal\n\n border-radius: 0.25rem\n border-bottom-left-radius: 0\n border-bottom-right-radius: 0\n font-weight: 300\n border-bottom: 1px solid\n\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n border-color: var(--color-background-border)\n\n + div[class]\n margin-top: 0\n pre\n border-top-left-radius: 0\n border-top-right-radius: 0\n\n// When `html_codeblock_linenos_style` is table.\n.highlighttable\n width: 100%\n display: block\n tbody\n display: block\n\n tr\n display: flex\n\n // Line numbers\n td.linenos\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n padding: $code-spacing-vertical $code-spacing-horizontal\n padding-right: 0\n border-top-left-radius: 0.2rem\n border-bottom-left-radius: 0.2rem\n\n .linenodiv\n padding-right: $code-spacing-horizontal\n font-size: var(--code-font-size)\n box-shadow: -0.0625rem 0 var(--color-foreground-border) inset\n\n // Actual code\n td.code\n padding: 0\n display: block\n flex: 1\n overflow: hidden\n\n .highlight\n border-top-left-radius: 0\n border-bottom-left-radius: 0\n\n// When `html_codeblock_linenos_style` is inline.\n.highlight\n span.linenos\n display: inline-block\n padding-left: 0\n padding-right: $code-spacing-horizontal\n margin-right: $code-spacing-horizontal\n box-shadow: -0.0625rem 0 var(--color-foreground-border) inset\n","// Inline Footnote Reference\n.footnote-reference\n font-size: var(--font-size--small--4)\n vertical-align: super\n\n// Definition list, listing the content of each note.\n// docutils <= 0.17\ndl.footnote.brackets\n font-size: var(--font-size--small)\n color: var(--color-foreground-secondary)\n\n display: grid\n grid-template-columns: max-content auto\n dt\n margin: 0\n > .fn-backref\n margin-left: 0.25rem\n\n &:after\n content: \":\"\n\n .brackets\n &:before\n content: \"[\"\n &:after\n content: \"]\"\n\n dd\n margin: 0\n padding: 0 1rem\n\n// docutils >= 0.18\naside.footnote\n font-size: var(--font-size--small)\n color: var(--color-foreground-secondary)\n\naside.footnote > span,\ndiv.citation > span\n float: left\n font-weight: 500\n padding-right: 0.25rem\n\naside.footnote > p,\ndiv.citation > p\n margin-left: 2rem\n","//\n// Figures\n//\nimg\n box-sizing: border-box\n max-width: 100%\n height: auto\n\narticle\n figure, .figure\n border-radius: 0.2rem\n\n margin: 0\n :last-child\n margin-bottom: 0\n\n .align-left\n float: left\n clear: left\n margin: 0 1rem 1rem\n\n .align-right\n float: right\n clear: right\n margin: 0 1rem 1rem\n\n .align-default,\n .align-center\n display: block\n text-align: center\n margin-left: auto\n margin-right: auto\n\n // WELL, table needs to be stylised like a table.\n table.align-default\n display: table\n text-align: initial\n",".genindex-jumpbox, .domainindex-jumpbox\n border-top: 1px solid var(--color-background-border)\n border-bottom: 1px solid var(--color-background-border)\n padding: 0.25rem\n\n.genindex-section, .domainindex-section\n h2\n margin-top: 0.75rem\n margin-bottom: 0.5rem\n ul\n margin-top: 0\n margin-bottom: 0\n","ul,\nol\n padding-left: 1.2rem\n\n // Space lists out like paragraphs\n margin-top: 1rem\n margin-bottom: 1rem\n // reduce margins within li.\n li\n > p:first-child\n margin-top: 0.25rem\n margin-bottom: 0.25rem\n\n > p:last-child\n margin-top: 0.25rem\n\n > ul,\n > ol\n margin-top: 0.5rem\n margin-bottom: 0.5rem\n\nol\n &.arabic\n list-style: decimal\n &.loweralpha\n list-style: lower-alpha\n &.upperalpha\n list-style: upper-alpha\n &.lowerroman\n list-style: lower-roman\n &.upperroman\n list-style: upper-roman\n\n// Don't space lists out when they're \"simple\" or in a `.. toctree::`\n.simple,\n.toctree-wrapper\n li\n > ul,\n > ol\n margin-top: 0\n margin-bottom: 0\n\n// Definition Lists\n.field-list,\n.option-list,\ndl:not([class]),\ndl.simple,\ndl.footnote,\ndl.glossary\n dt\n font-weight: 500\n margin-top: 0.25rem\n + dt\n margin-top: 0\n\n .classifier::before\n content: \":\"\n margin-left: 0.2rem\n margin-right: 0.2rem\n\n dd\n > p:first-child,\n ul\n margin-top: 0.125rem\n\n ul\n margin-bottom: 0.125rem\n",".math-wrapper\n width: 100%\n overflow-x: auto\n\ndiv.math\n position: relative\n text-align: center\n\n .headerlink,\n &:focus .headerlink\n display: none\n\n &:hover .headerlink\n display: inline-block\n\n span.eqno\n position: absolute\n right: 0.5rem\n top: 50%\n transform: translate(0, -50%)\n z-index: 1\n","// Abbreviations\nabbr[title]\n cursor: help\n\n// \"Problematic\" content, as identified by Sphinx\n.problematic\n color: var(--color-problematic)\n\n// Keyboard / Mouse \"instructions\"\nkbd:not(.compound)\n margin: 0 0.2rem\n padding: 0 0.2rem\n border-radius: 0.2rem\n border: 1px solid var(--color-foreground-border)\n color: var(--color-foreground-primary)\n vertical-align: text-bottom\n\n font-size: var(--font-size--small--3)\n display: inline-block\n\n box-shadow: 0 0.0625rem 0 rgba(0, 0, 0, 0.2), inset 0 0 0 0.125rem var(--color-background-primary)\n\n background-color: var(--color-background-secondary)\n\n// Blockquote\nblockquote\n border-left: 4px solid var(--color-background-border)\n background: var(--color-background-secondary)\n\n margin-left: 0\n margin-right: 0\n padding: 0.5rem 1rem\n\n .attribution\n font-weight: 600\n text-align: right\n\n &.pull-quote,\n &.highlights\n font-size: 1.25em\n\n &.epigraph,\n &.pull-quote\n border-left-width: 0\n border-radius: 0.5rem\n\n &.highlights\n border-left-width: 0\n background: transparent\n\n// Center align embedded-in-text images\np .reference img\n vertical-align: middle\n","p.rubric\n line-height: 1.25\n font-weight: bold\n font-size: 1.125em\n\n // For Numpy-style documentation that's got rubrics within it.\n // https://github.com/pradyunsg/furo/discussions/505\n dd &\n line-height: inherit\n font-weight: inherit\n\n font-size: var(--font-size--small)\n text-transform: uppercase\n","article .sidebar\n float: right\n clear: right\n width: 30%\n\n margin-left: 1rem\n margin-right: 0\n\n border-radius: 0.2rem\n background-color: var(--color-background-secondary)\n border: var(--color-background-border) 1px solid\n\n > *\n padding-left: 1rem\n padding-right: 1rem\n\n > ul, > ol // lists need additional padding, because bullets.\n padding-left: 2.2rem\n\n .sidebar-title\n margin: 0\n padding: 0.5rem 1rem\n border-bottom: var(--color-background-border) 1px solid\n\n font-weight: 500\n\n// TODO: subtitle\n// TODO: dedicated variables?\n",".table-wrapper\n width: 100%\n overflow-x: auto\n margin-top: 1rem\n margin-bottom: 0.5rem\n padding: 0.2rem 0.2rem 0.75rem\n\ntable.docutils\n border-radius: 0.2rem\n border-spacing: 0\n border-collapse: collapse\n\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n th\n background: var(--color-table-header-background)\n\n td,\n th\n // Space things out properly\n padding: 0 0.25rem\n\n // Get the borders looking just-right.\n border-left: 1px solid var(--color-table-border)\n border-right: 1px solid var(--color-table-border)\n border-bottom: 1px solid var(--color-table-border)\n\n p\n margin: 0.25rem\n\n &:first-child\n border-left: none\n &:last-child\n border-right: none\n\n // MyST-parser tables set these classes for control of column alignment\n &.text-left\n text-align: left\n &.text-right\n text-align: right\n &.text-center\n text-align: center\n",":target\n scroll-margin-top: 0.5rem\n\n@media (max-width: $full-width - $sidebar-width)\n :target\n scroll-margin-top: calc(0.5rem + var(--header-height))\n\n // When a heading is selected\n section > span:target\n scroll-margin-top: calc(0.8rem + var(--header-height))\n\n// Permalinks\n.headerlink\n font-weight: 100\n user-select: none\n\nh1,\nh2,\nh3,\nh4,\nh5,\nh6,\ndl dt,\np.caption,\nfigcaption p,\ntable > caption,\n.code-block-caption\n > .headerlink\n margin-left: 0.5rem\n visibility: hidden\n &:hover > .headerlink\n visibility: visible\n\n // Don't change to link-like, if someone adds the contents directive.\n > .toc-backref\n color: inherit\n text-decoration-line: none\n\n// Figure and table captions are special.\nfigure:hover > figcaption > p > .headerlink,\ntable:hover > caption > .headerlink\n visibility: visible\n\n:target >, // Regular section[id] style anchors\nspan:target ~ // Non-regular span[id] style \"extra\" anchors\n h1,\n h2,\n h3,\n h4,\n h5,\n h6\n &:nth-of-type(1)\n background-color: var(--color-highlight-on-target)\n // .headerlink\n // visibility: visible\n code.literal\n background-color: transparent\n\ntable:target > caption,\nfigure:target\n background-color: var(--color-highlight-on-target)\n\n// Inline page contents\n.this-will-duplicate-information-and-it-is-still-useful-here li :target\n background-color: var(--color-highlight-on-target)\n\n// Code block permalinks\n.literal-block-wrapper:target .code-block-caption\n background-color: var(--color-highlight-on-target)\n\n// When a definition list item is selected\n//\n// There isn't really an alternative to !important here, due to the\n// high-specificity of API documentation's selector.\ndt:target\n background-color: var(--color-highlight-on-target) !important\n\n// When a footnote reference is selected\n.footnote > dt:target + dd,\n.footnote-reference:target\n background-color: var(--color-highlight-on-target)\n",".guilabel\n background-color: var(--color-guilabel-background)\n border: 1px solid var(--color-guilabel-border)\n color: var(--color-guilabel-text)\n\n padding: 0 0.3em\n border-radius: 0.5em\n font-size: 0.9em\n","// This file contains the styles used for stylizing the footer that's shown\n// below the content.\n\nfooter\n font-size: var(--font-size--small)\n display: flex\n flex-direction: column\n\n margin-top: 2rem\n\n// Bottom of page information\n.bottom-of-page\n display: flex\n align-items: center\n justify-content: space-between\n\n margin-top: 1rem\n padding-top: 1rem\n padding-bottom: 1rem\n\n color: var(--color-foreground-secondary)\n border-top: 1px solid var(--color-background-border)\n\n line-height: 1.5\n\n @media (max-width: $content-width)\n text-align: center\n flex-direction: column-reverse\n gap: 0.25rem\n\n .left-details\n font-size: var(--font-size--small)\n\n .right-details\n display: flex\n flex-direction: column\n gap: 0.25rem\n text-align: right\n\n .icons\n display: flex\n justify-content: flex-end\n gap: 0.25rem\n font-size: 1rem\n\n a\n text-decoration: none\n\n svg,\n img\n font-size: 1.125rem\n height: 1em\n width: 1em\n\n// Next/Prev page information\n.related-pages\n a\n display: flex\n align-items: center\n\n text-decoration: none\n &:hover .page-info .title\n text-decoration: underline\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline)\n\n svg.furo-related-icon,\n svg.furo-related-icon > use\n flex-shrink: 0\n\n color: var(--color-foreground-border)\n\n width: 0.75rem\n height: 0.75rem\n margin: 0 0.5rem\n\n &.next-page\n max-width: 50%\n\n float: right\n clear: right\n text-align: right\n\n &.prev-page\n max-width: 50%\n\n float: left\n clear: left\n\n svg\n transform: rotate(180deg)\n\n.page-info\n display: flex\n flex-direction: column\n overflow-wrap: anywhere\n\n .next-page &\n align-items: flex-end\n\n .context\n display: flex\n align-items: center\n\n padding-bottom: 0.1rem\n\n color: var(--color-foreground-muted)\n font-size: var(--font-size--small)\n text-decoration: none\n","// This file contains the styles for the contents of the left sidebar, which\n// contains the navigation tree, logo, search etc.\n\n////////////////////////////////////////////////////////////////////////////////\n// Brand on top of the scrollable tree.\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-brand\n display: flex\n flex-direction: column\n flex-shrink: 0\n\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n text-decoration: none\n\n.sidebar-brand-text\n color: var(--color-sidebar-brand-text)\n overflow-wrap: break-word\n margin: var(--sidebar-item-spacing-vertical) 0\n font-size: 1.5rem\n\n.sidebar-logo-container\n margin: var(--sidebar-item-spacing-vertical) 0\n\n.sidebar-logo\n margin: 0 auto\n display: block\n max-width: 100%\n\n////////////////////////////////////////////////////////////////////////////////\n// Search\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-search-container\n display: flex\n align-items: center\n margin-top: var(--sidebar-search-space-above)\n\n position: relative\n\n background: var(--color-sidebar-search-background)\n &:hover,\n &:focus-within\n background: var(--color-sidebar-search-background--focus)\n\n &::before\n content: \"\"\n position: absolute\n left: var(--sidebar-item-spacing-horizontal)\n width: var(--sidebar-search-icon-size)\n height: var(--sidebar-search-icon-size)\n\n background-color: var(--color-sidebar-search-icon)\n mask-image: var(--icon-search)\n\n.sidebar-search\n box-sizing: border-box\n\n border: none\n border-top: 1px solid var(--color-sidebar-search-border)\n border-bottom: 1px solid var(--color-sidebar-search-border)\n\n padding-top: var(--sidebar-search-input-spacing-vertical)\n padding-bottom: var(--sidebar-search-input-spacing-vertical)\n padding-right: var(--sidebar-search-input-spacing-horizontal)\n padding-left: calc(var(--sidebar-item-spacing-horizontal) + var(--sidebar-search-input-spacing-horizontal) + var(--sidebar-search-icon-size))\n\n width: 100%\n\n color: var(--color-sidebar-search-foreground)\n background: transparent\n z-index: 10\n\n &:focus\n outline: none\n\n &::placeholder\n font-size: var(--sidebar-search-input-font-size)\n\n//\n// Hide Search Matches link\n//\n#searchbox .highlight-link\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal) 0\n margin: 0\n text-align: center\n\n a\n color: var(--color-sidebar-search-icon)\n font-size: var(--font-size--small--2)\n\n////////////////////////////////////////////////////////////////////////////////\n// Structure/Skeleton of the navigation tree (left)\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-tree\n font-size: var(--sidebar-item-font-size)\n margin-top: var(--sidebar-tree-space-above)\n margin-bottom: var(--sidebar-item-spacing-vertical)\n\n ul\n padding: 0\n margin-top: 0\n margin-bottom: 0\n\n display: flex\n flex-direction: column\n\n list-style: none\n\n li\n position: relative\n margin: 0\n\n > ul\n margin-left: var(--sidebar-item-spacing-horizontal)\n\n .icon\n color: var(--color-sidebar-link-text)\n\n .reference\n box-sizing: border-box\n color: var(--color-sidebar-link-text)\n\n // Fill the parent.\n display: inline-block\n line-height: var(--sidebar-item-line-height)\n text-decoration: none\n\n // Don't allow long words to cause wrapping.\n overflow-wrap: anywhere\n\n height: 100%\n width: 100%\n\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n\n &:hover\n background: var(--color-sidebar-item-background--hover)\n\n // Add a nice little \"external-link\" arrow here.\n &.external::after\n content: url('data:image/svg+xml,')\n margin: 0 0.25rem\n vertical-align: middle\n color: var(--color-sidebar-link-text)\n\n // Make the current page reference bold.\n .current-page > .reference\n font-weight: bold\n\n label\n position: absolute\n top: 0\n right: 0\n height: var(--sidebar-item-height)\n width: var(--sidebar-expander-width)\n\n cursor: pointer\n user-select: none\n\n display: flex\n justify-content: center\n align-items: center\n\n .caption, :not(.caption) > .caption-text\n font-size: var(--sidebar-caption-font-size)\n color: var(--color-sidebar-caption-text)\n\n font-weight: bold\n text-transform: uppercase\n\n margin: var(--sidebar-caption-space-above) 0 0 0\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n\n // If it has children, add a bit more padding to wrap the content to avoid\n // overlapping with the