From e61af70de862a2bb4b842ee02aeda3aef5b1e0d1 Mon Sep 17 00:00:00 2001
From: Callum Macpherson <93673602+CalMacCQ@users.noreply.github.com>
Date: Wed, 2 Oct 2024 16:04:05 +0100
Subject: [PATCH] docs: use `pytket-docs-theming` submodule (#153)

# Description

Updating the docs build to use the
[pytket-docs-theming](https://github.com/CQCL/pytket-docs-theming)
repository as a submodule. This means the docs can be built locally with
the latest theme config.

I also took great pleasure in deleting a bunch of legacy docs files ;).
If we go with this solution then we don't these anymore.

Take a look at the README for building the docs locally ->
https://github.com/CQCL/pytket-docs-theming/tree/main/extensions#building-the-api-docs-for-pytket-extensions

I've added some bash scripts to automate installing dependencies and
building the docs. Note that these scripts are only intended for local
development and will not be used in the website build. I don't want to
have to make sure that they match in all of the different repositories.

<img width="1421" alt="Screenshot 2024-09-04 at 01 27 54"
src="https://github.com/user-attachments/assets/8da592c8-8a03-495b-be54-7f24c018e2a1">


TODOS

- [x] Finalise how docs dependencies are specified. (proposal added in
README) Happy to have input on this
- [x] Fix docs build in C.I.
- [x] Discuss whether this is feasible for all other extenions that we
care about.


# Related issues

Please mention any github issues addressed by this PR.
---
 .github/workflows/build_and_test.yml          |  27 ++--
 .github/workflows/docs.yml                    |  29 ++--
 .../workflows/docs/Quantinuum_logo_black.png  | Bin 18245 -> 0 bytes
 .../workflows/docs/Quantinuum_logo_white.png  | Bin 16704 -> 0 bytes
 .github/workflows/docs/build-docs             | 114 --------------
 .github/workflows/docs/check-build-docs       |  10 --
 .github/workflows/docs/conf.py                | 149 ------------------
 .github/workflows/docs/requirements.txt       |   6 -
 .gitignore                                    |   4 +
 .gitmodules                                   |   4 +
 docs/README.md                                |   5 +
 docs/_static/custom.css                       |  35 ----
 docs/build-docs.sh                            |  21 +++
 docs/{intro.txt => index.rst}                 |   6 +
 docs/install.sh                               |   8 +
 docs/pytket-docs-theming                      |   1 +
 16 files changed, 80 insertions(+), 339 deletions(-)
 delete mode 100644 .github/workflows/docs/Quantinuum_logo_black.png
 delete mode 100644 .github/workflows/docs/Quantinuum_logo_white.png
 delete mode 100755 .github/workflows/docs/build-docs
 delete mode 100755 .github/workflows/docs/check-build-docs
 delete mode 100644 .github/workflows/docs/conf.py
 delete mode 100644 .github/workflows/docs/requirements.txt
 create mode 100644 .gitmodules
 create mode 100644 docs/README.md
 delete mode 100644 docs/_static/custom.css
 create mode 100644 docs/build-docs.sh
 rename docs/{intro.txt => index.rst} (91%)
 create mode 100644 docs/install.sh
 create mode 160000 docs/pytket-docs-theming

diff --git a/.github/workflows/build_and_test.yml b/.github/workflows/build_and_test.yml
index b9ec7211..23dece74 100644
--- a/.github/workflows/build_and_test.yml
+++ b/.github/workflows/build_and_test.yml
@@ -28,6 +28,7 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: '0'
+        submodules: true
     - run: git fetch --depth=1 origin +refs/tags/*:refs/tags/* +refs/heads/*:refs/remotes/origin/*
     - name: Set up Python 3.10
       uses: actions/setup-python@v5
@@ -66,15 +67,20 @@ jobs:
       with:
         name: artefact-${{ matrix.os }}
         path: wheelhouse/
+    - name: install poetry
+      run: pip install poetry
     - name: Install docs dependencies
       if: (matrix.os == 'ubuntu-22.04') && (github.event_name == 'pull_request' || github.event_name == 'schedule' )
       run: |
-        pip install -r .github/workflows/docs/requirements.txt
+        cd docs
+        bash ./install.sh
+        for w in `find wheelhouse/ -type f -name "*.whl"` ; do poetry install $w ; done
     - name: Build docs
       if: (matrix.os == 'ubuntu-22.04') && (github.event_name == 'pull_request' || github.event_name == 'schedule' )
       timeout-minutes: 20
       run: |
-        ./.github/workflows/docs/check-build-docs
+        cd docs
+        poetry run bash ./build-docs.sh
 
 
   publish_to_pypi:
@@ -111,24 +117,27 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: '0'
-    - name: Set up Python 3.10
+        submodules: true
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: '3.10'
+        python-version: '3.11'
     - name: Download all wheels
       uses: actions/download-artifact@v4
       with:
         path: wheelhouse
     - name: Install pip, wheel
       run: pip install -U pip wheel
+    - name: Install poetry
+      run: pip install poetry
     - name: Install extension
-      run: for w in `find wheelhouse/ -type f -name "*.whl"` ; do pip install $w ; done
+      run: for w in `find wheelhouse/ -type f -name "*.whl"` ; do poetry install $w ; done
     - name: Install docs dependencies
       run: |
-        pip install -r .github/workflows/docs/requirements.txt
+        cd docs
+        bash ./install.sh
     - name: Build docs
       timeout-minutes: 20
       run: |
-        cd .github/workflows/docs
-        mkdir extensions
-        ./build-docs -d ${GITHUB_WORKSPACE}/.github/workflows/docs/extensions/api
\ No newline at end of file
+        cd docs
+        poetry run bash ./build-docs.sh
\ No newline at end of file
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 1f624bb6..56f1a015 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -7,30 +7,27 @@ on:
   schedule:
     # 04:00 every Tuesday morning
     - cron: '0 4 * * 2'
+
 jobs:
   docs:
     name: build docs
     runs-on: ubuntu-22.04
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.10
+      with: 
+        submodules: true
+    - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
-        python-version: '3.10'
-    - name: Upgrade pip and install wheel
-      run: pip install --upgrade pip wheel
-    - name: Install pytket-cutensornet
-      run: pip install .
+        python-version: '3.11'
+    - name: install poetry
+      run: pip install poetry
     - name: Install docs dependencies
-      run: |
-        pip install -r .github/workflows/docs/requirements.txt
+      run: cd docs && bash install.sh 
+    - name: Install pytket cutensornet
+      run: cd docs && poetry run pip install ../.
     - name: Test building docs
-      timeout-minutes: 20
+      timeout-minutes: 10
       run: |
-        cd .github/workflows/docs
-        mkdir extensions
-        ./build-docs -d ${GITHUB_WORKSPACE}/.github/workflows/docs/extensions
-    - uses: actions/upload-artifact@v4
-      with:
-        name: pytket-extension-docs
-        path: .github/workflows/docs/extensions/
\ No newline at end of file
+        cd docs
+        poetry run bash build-docs.sh
\ No newline at end of file
diff --git a/.github/workflows/docs/Quantinuum_logo_black.png b/.github/workflows/docs/Quantinuum_logo_black.png
deleted file mode 100644
index 5569581b8e420f14eee561cbf1bf78ca0c96882f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 18245
zcmeIa`8$-~{{Vd3_mHw?s}PcX-^r3}VF+1Dma(Pm36u3*C@r?^+t{*Y#+tooQ5gH!
zQy~T=L&or&yZ8HhJ^#UTJwJTry1LALpL1U4wQuK44=l}%SQvR3AqZl*WPH&If~av2
zM8!@|3*Ly2W*dP&3<1XWfe>`z4E&EGtW-M$f`p(;7j<pIa@J=zZ}S;7DlZVndlU~Z
z&eE5s=-i<$IwQkRQ9(bD(iKE~*~nEQChfG$$!;t5YjQDm2PGF4W9N8p^>U&Als(9z
zXf4Yxdni&nK}n~%z_#718riY`>)U0pEd&V=mDi}?FONA&D8L^bT3ufF@h02<9{<OU
z|DPyBLZ{<d2zC2>>xMi1qW#^vSS+1p^A5}Y(f79;ovVp#J^hYH8#f5~(j!Mlw|SOI
ztr;Pij@piUe{R@QKyqMNIDO%f1C2)&Y8_FywyQ-BuO}{#$@Nw73vfU>SZX8$HGx_7
zj319#1rT2^)cIOR#!n+EZ*tU8{A&rH9D`<c89zCrYsrQaUp=I*lE{PZ$xYLjD4-W2
z##GRYr<I?^V;fo!FH#6<G(KG7SFN$Mkiz9uT4=zzQbpZ#amrfx&+;I(52Vuo_Ul?N
zsch)QZut({=M5yDsBCxY3#%`7gP=)9V1F`vNi}P+4NGi2yPtoU|BiUs?!+{{UJGD7
z6k>tO@kML<4_=6g>sW`|riY4O<*1~98iW8AmCq{&&6%0X6D+~3Jb0=hp0ut)<3;*>
zEzN(N65CWQO$%9afh{awpD4&JktSqs4_iQ*o1Lad)Q~p}<6#<6Tb)Jtl<MV%-3v6{
zm7@^q1_KU4eW4$E(O7Av-jD$n^TH6ArE+F|p;>LPk(5v=>@Ezh2F+GLDG{$N?&ITW
zD4~!`fc*8*qP1frB`s@}_gli)dwGuMAy+P#1Lh@>L;E^k)8xB2oXQv#@AE=+h!_RP
zwQ8KGOM3r7K2?VWnv?(=)hQ;`s2d}^@G3md;CFvH)M67q&dRYj>@8oYWvQ<89D*`o
z-ef+PPzdRIZUMO-hhZJB96HyPeWKh+l?UqLhId`zblR0e6t>s3o>*9B>zR`4du&b%
z$-J3=DFDf!4JP;#*)GI+ohZp?i^y`$h9ExcC$v!VY3!Z6c(z9`&(W;yTBzIig{_{Y
zfGl9a(~f+&6px9Zge*kiC;On;>x{$1muJ&jjtQU2-e7>f9tWJ^1L|{$e$mA?^+WsR
z`!9YdKnuDserEt>O@h4gcb@fNn#?7j06{?S)>&jZsv>6~4W8y4-Jk&J)EG=?auvx2
z&L^_f;O3$sD7xr03-s=(XrME<gpPg`gK$ozITd6JQ&=45rSLL;J-j*jCoTzshVTrK
z#yM;=!?4#_6#b$$QcnsRQaK4GwsSg#p3>VJW9;6XEBm2Pod*q_1KS6P3G>dZipB*L
zjB!Bt5-bO_#{}N^SX7BYn9BwLKQTRpcf<>E0WaYR!hr0<x|P;gww_zI)UP6qufMRh
zfV@!S=FmcDQcVPpUYL*K!X@Y5)_x;Fj*#nj7)ObVZN?;R3X74WnS<#LBqS5<piWV6
z8%*caTbafY9bK5XyR+Ss`#Fz8-(f9cxh#w~@V21p8{W(gaiyn#1|EYAyrx^&SPYx+
z%7oHV8dNxY358BEAc|9OZ|+axCHfJ_H3954RA4Z%6QM$0ndvPdn*OFnh1VPLLJECx
z=93R5K5`FAX+ooBfUXla_z;rF<}OEJUf<c;isL7s@=TyojDWZfD|fyK@tt|kdDX<+
zJw@_MDku#H7^~jMIGiqP&RZhYx^XscOM00vWaE>Z;TRIKEbLTALUnu<pMIS-+a>vb
zh&3h^F$@<l8zt2+^(a8)F#ePG9fk32?#W!%{095Z`1b|pjqn;21zJEgCSN%UJ8a(k
zaz@38<gB9_2O#nQ;rI^o3*!era@V5OVt}&7u|)+vD!dBA`{z0pR40PWf3=NeBZ$Ur
z-Q!v67k?xaACiF%(mTm41fdwYl_1D5RS(l~-0v2lE!X^HQMG`}KeS^qC<u}$0171<
zVx;c5d6#EtyP_k|d-dQ`OZ<;=Qz}%<)EO`sWbqHD6?XFZ=N!9oE0?VA%Ulp6Fagv9
z4Ys14F|TKS7dlqdtknwrwJ)@qBLF{*f#5j8gf22!+ZIc;*4*OKylq~1x07)MD$pQ;
zg$(CgYgmV!XMeu4-b@*{Yvorhli{0}a(f-1Mp3{lfrDIciVw6(US#61E9R#kb`6<B
zS9C%;6gDLkUH=GF&}X;u5;`PQ3jCFY<1zqGa*Uu!DWKUhPciw!`X{ejALCZxEb8_p
zlzzZ?n#)4#=?@hk?rz|Z^y!bH7M|=se7gLRTid*T4!B!M1Tpt=CU*BDH*3xfXp$d>
zV~OuvsrPQ!X3)pD3G*r}BD@9Zppc6|SC~^BsxQdLyo@%j@4T{qXjier<kh?8o=m9-
zO;W&12d0zR2(xk7aryMa1*)BB@ph;y9r#gKePHq*XBMKLet2S&67uCh_u2j;)iW~+
zT4)1!5EM&E<ol?By=<VE^X8bo#LD3Ud(m*pu4D8#XyE}a;C{nEr{Xs)!!iynCCd&j
zi)Ky==nQbaT^uDp9&d};#F&kZBdx@S)J-O+AXg?+0yRqPYLL@B`cLHd`ISWGQ|9#@
zNi}W2Dfx7On1j@XTpa+Xg{&+0-?0qqy;xCgRj9W3hxTQI3(&UvK>y`5Zo6RSKFRe}
z5RK$3IGX*Uzi9GM6ol&n=}zUnl6J_f<0bszsQQ8mxp%8m0m@7Viv;RdS{oGjH^oI6
za5lvhk5w+8#6Vrt%zO}vu7vz9D&h<8j$iJxbp&Rm^|8gvWGejjb)I4wpk=TgZah)i
zn7cVxSb<l29Pg!*zy)}QwS;7}fCbEK2KBCHT4RF+%zrm`9UMHD@TNeqBLSW2zLPi}
zwD+2+KJ8)XdOwW^K`n0U4$qQN84uJ~2*CRD4B@8QGQBhr#S|9Ud<h>4)DxJkwMu@g
z%p8ru0u}(`YjXKp4ydmf_`PvvuhnaR^6RI|F~O8n$e+}xC*?py+Uk6D0)nEgSH{K}
zm<z#V!_(mH&Ea4%;W#d;akonHFqp5uBb6szeHvnhAsyc8>O#<8ztwg3UQ_bzQ5iEw
zF`1$cZ`({-hzbUIq{hcx6ko58xd;Z*0l6bz7$7Quo0l`MOn^cF|C|NpQH+ACsaOT>
zBs7Tv98O^2zRJ_iD}~MO;3eI@k0zu9eWF4Ec0*nuKX^oUjQeU<QT4WKOh5IW7UByC
zP-l&)3hXPs_`D>?ToAizq}<wN^SSywq>(Gcf=bVgV<Q@c9g@$!e$4T*m^_TCSeI_y
zc=Lm@YXnBas?v~eP4v!hZw!WKk6T!<E7E)f%LcuJVIs<qBLvw=L6-92xqk=*Xown!
z>C>e#XYEIOuL+N7M}PDOnNdS>2eYRsh6=7o$^ehaUecbkAe+_qsaj^IgYhltkQ`Zv
zJmS5Ioki}rn|Km$Qlm6nBLDn)Yeg}XY!m*o^NiMf)KFJ>p&h<q<tXJ(Ci5??xGmXu
z_bP1?6#OuK&Pb}&|74wJ=g!WZHzDr$?b#aV5y+AQm?Fkwos6<6{$wPW=~Nnsk9GnM
zMuIS<X-m-pq81iK&{5>eGRHor>RJN9Lg5Uem_Oy<UKzc^%z*i(KI6xI#+;82@PVOU
zYATCtzU|4iH`+#5I=jtQX~iMZXdzZmHw`@%M~|4@9;rC(cP}!47$T)YQfU&~OZ|OM
zdfcT}{HoSfrU~a0;ak4XDixrxI8DIN9_onV>I1iRVyD4`6Y?$J`dulNHZLia={MD`
zgf5>td!h*yiVkLd56JdRlJfhaYCdvz@{(k^oR%}TJ@zXbwzYI5Z{KRbmlV>{Azv(2
zjZYK{Z)V6=f`t)aVP-o<dvuICLeEULzM=Cz*>9jfrzN!F*Lrnj!)i%>Veju9^0j=i
zXiGrEZXJk-QYu+qZad;J*~=Un-)DZOd3yFV5H79F*pYIX#$LGADnQNs^XHi%7L~je
zaq}zn!p3cmoy${$NQ+kBeFx*c+J<W*9FDY%N%?F&YaRS`Z?T#6b`@%zP_scQZP!Z>
zBb#5Djm*A2w4ZPN(<|2poUa8T(l#AySsgulcqTq~qPq5@sj2KYZm81pu>$1bHyoS+
zY>Gp(e|VSOA!s%}WwzJMdsc%hXAC(UoLF((X3cZfFyDk3!h$rd%eS;5);iwH8mW45
zO)|?_+U*{C|D`{0r0DTML>k^~&Bsa{frJ8*fWoV)XYI8x-0l0Rh1lI8WG@GX=^fY!
zCZH{U+v6{rO?x^$;&k$yH-xU9F{W}&$KC8M7SEraJZa71ztPS(bga++NvQ@>8msmE
z&*y-cN>jy`G*Bfl2G^RIgS5-2@w&sDvPEi2teUCQ6cdC1nTd>@_549(=7Ow?`BtU~
zd%@2{tPWwCt%pz2`enNUnHzcmXT<|oyr0bE?^Q$s>&Q0)6IXWM?(3rZoYG~TFSu#g
z7TPKR3Q}S5o*CnCUlCJ0lxJZNo8G^%B_ow@5b*>pM5VJ012W;23uumCRxmKY=OnNk
z9M@Z+!Zc7mihuZ$##=k{m;DI<M?o3}RH$`vdb($%_4k(+YnMyE337eU+>@>2QWT16
zZ<tzZ9c5MWO;s2F)}?_I%zzwcyw+w?v{u4$iMkweaxZMg_B0TxuN<e#i8QDp;C?bw
zK)R(oU7Isp9g%@o8RUzY^S$IUJ87qiX2>U6O!E_RAq5KnC}-4J>gQ{eTiC;Fg_Lbe
zKC$Uk(R%`3yE8ocbdVP)Ur?$Q?bU&uD7SamN<I0MXVs2AyZ1bIn#@TWkQp#L8K#Qr
z?f3>&RfN|GVQho|dNr?dq_JNM5C$W9t+^$8E&}28T(n&PQRX*zShRNS7KIlGPpFp3
zkhWojTWwDM$VGFo+9()54tq{`><6K|x*<)dnpFf2kPcn-U9sbpBc{Y0c+dkTFxF{i
z6f4u>KlUNqzN=m*-6ps3#rk^%A|{k_2rgIx>yr3dJ>{dnd3`JKM!s5Z5{~onyaN{`
zFJOP^4YCcYYP-*0y!LHBPdKP%#oCzt!3o7&g01~2*aY8_#b@EtGGbSlJNS*E8!r@-
zpY4)-8@Wkca0vkM4wWgEZ~lmk72N;8Pb!qPtN8Fs-CENK<YEP?@VIgrUyD=x)mv5~
zFUUigSdd><jBUrtYd%zsOr?PAfp*yV3<r~0e&)%myo0lBJq3sQ<ew5WIz%%*e{H8k
ziUJ-OPUA=Ke^gBg>xqn~xB^bqA$&+^@{MnFBXbNo)&R(;Z-#OJ*6#XiB^%VZl$*wC
zG^c}0;(aip0PJ1olk=zbbtm7&h~IqGM?x24k4&_gw7K=_>OpwR){nmc-2_%)S!ysb
z^>u&MA7^>L3CpiyDo!>%ML(kS{VubPJiLeZgtGsjSlEEL@_`HRFfW)H4K8c*^<X}E
z0dD-o61yhk7ah}|Bk}ckk#53odE937UiV$i2O!sb0g96X+rVi-KM6gBuo(AbJ8|yg
z=x@_5L9-_it&rs@AgnQQ_h<~mBe(Us%m2{wUG3Yul1aQ-2_z8%B*ELBvt)l+dDD%(
zs2l3Rh{3)dj&6z)-xB;D+M;*QXnuac#*)B})_i|ndjUdC!#I~e=WDbQ3+-_33)AXZ
z(%FtfPC3Kv1(AM6h!23UObaSjdi!R;%#^)^rTR2SQTMy?9t@ukNeI~F0Ic}<=NQ((
z6T0{@R42*sAKDQ%w0pe;FVr9g=ur|uXqetUpG}L5{3k@?S3Tr|>xk{akYLT!1h`?v
z#f_)=NE8{e&c0g{`|a80eOjCgwN{xSUdRnl&Y`AY6tau_M>(C84QTqTl@vQSs&uTT
zdFp7yx1#*2k8a!=4z|X;rqYoG)Yuf)=~79yol+TU%HU@lb|vAW;ySPHcY?6d^%Cq^
ze(8a-R~s|V+$x)=j_M;fDgB4?_@M<@Iq(8d^5S_|tdfC`r@0ETfg#s2?wMGl+aR2A
z*uz*nJH9)|Lq^NGEp(CGlgr$qT^3fYe0B;i<we60sR3lf1)?IhYNps0A}QjKjD2w5
zG98F9>cY`hQR)(ef^DY!QiYVh^{I(S1Tuk1=f0K5s&;PnJY6r)5Z6Xn9ye=;+-7Z4
zi59&y1=m2N(xczZISstfKnB1=;(V+BLo;%}+<yIRy#>B4=-IL71Qo1nlPO5^8(^E_
z9Awn`T;b1aM=EhD%ML6E@ad&<K%ZtoO@S=hGU=)0DWWKzW5sWOd$PmJ^6_ZQ?5`*!
zupbZ5{n3#!sWE1<#)P6HaZw$`pE%B4^M2cLYky+~WUQ`@a340Qfl22lr_)5@rCP90
z6l=rybPEc!Jl3?KW{EJ%4>!|gqZCKVXmyrA-D8==DTzZpEKOe*-Br#hpXG-_%;8;}
zPekQd6Q0r9`0}`QPAs<34qjgsjDorh0sS%p2xOPjekCTm&(;w5#q&UF=jMvmycx==
zkzFnd_%9WDTqt`$OjlS(Q+k&ZuRln2?P2STUB>1B3(cBgm{~3<<g_>mqzZc|UK@@Q
z;EpyLfY*o%7=K3z3dDaQGy^1e9s0s}^_m;?AWJdWSjs_O6g?d5@B)>HkqIk6uPH${
zVd=->{ogrcf2Pyumg`HRrDa{`3Sfq0)WDKtiwLo;Ob$tEXa}ItwFf*at4S<fRHMni
z-7Cd%+2^=91`TxnLbzKRR3HGmt2(<yd-$ansC-YLKjA=~_nH#Q<OA?bi*Ie7KvO(k
zjm7v>QA5FS!4w3DkF`SJD-e_@HK0bWYM?Za@QA#hc-~FJ4kSf?XJMH6p*!UurD6nA
z&VkI@J7=<Gqa;V4!lYD!1^NM6W(7gmCc};FYjii&nk*qpC3ru8e`+y|Tq#s=4Ir24
ztR1w_5=<-bR5UEl{w#D3s2<d)kKj$!j}U`Sn1Whr`u3}pR{U-Rm1rZ()vZ1?DxEAK
zzB>MhN*u}*4;mzv0McY0hYyQ}2hS2{g~rBHqJF`sM-aK3$|P9c6#|qPL5x8W)Ub0p
z2_W$BG0{Nouqay}%d6`HKt@t-2bnzzP=OEt_As5u_<|3C)Om!TR$nIS(nBybI-638
z$0mYjuT8XC$&-bsQGGyTT$RCFRlp5Y3_R!W)A}=7i003aj~UXR=^z8p<GL1Yzr*n-
zugvT%#RjPCIt+dp_*DTVsiHha1sRqCo8g@q_<f!b&t}f3a;(62`7<l@92Al|EZ<*W
z-+5oOmUlAXlunDc@8&(1E?Lm6gXwpSP~xByc=eYl-KQzKHehUaL4FpxpaHQC%`reU
zK%SPdoJvdDQVZOuJ7eQ>s>|v3AYRyg&`Qmuwu9X9Hbp<hiF4RcXS*PO(=)WL=>W9l
zBl%c56y2yw5CnO^F^i>!SM@S2E5zDT?iGv)p_I7{nB+ZVlFG>}00C{UM?X}k295*R
z0Q4cS<}F8aKgom>UCOEhdHn<11!nv-=GH^8fX5Pe^^pK-D3c#(!&}F`$s0*Sj~z7b
ztB<mk%$|VNoB<4AoBg*;L0x%xlgEuk_k}JMGyo?V4wy;Nzfcl!yO-p>p#L0=?e6qy
zS(pGP;E<|Gt;yev7k0n~ANlNdrSb-u07sci>5#N6kc=aY_wb$gUT6A6KS25O!ryC!
z0QA2uYkYSmynaQER7z2GsZWH}br{dk<qLz-6M6OnO)MtkP$i>vKSXIFp?^7WXUUh`
z;e!82`G{(=+A3CI%<Dhz-mFX7j6z0c5?`X+C_>6cC7dRZkO#=Vbj)T7$P-Cgrjm;~
zs9f=2{peU)C{qy-t#~_@7~KIvFjAb3%6CGp&#E?2YYTE62Lc&=!-CHz1I<}_dW?Ru
za<^2fsapmbfaAprdfefUfh`IzTO<N0$fyFKJqNG7&$}IP>ote;9hL}c1qhqQil%Xv
z{Hde*H_GuTdq=xJ6~k0u)(Y3;|BIjgqZ`E22sFb;0ly$q1iEGr8kn<l>9}`0oua%C
zI1N4ePF1(vyPe5D3x?dN3>#NkZ_EuyyB$=bdO^Uc06L{4As|5X9u8g>5fqZS4EX&w
zDL}{u2z`7a!}8*a2`cystiE4il8h1fr8wkJf)()+aC-ly4|jUgjWTJsLlN)fgPdp!
z7+`6AO_0i$VfkJiCj^Xlma1zV7RYBg!|Gg%Gp1DN-{U_hhv3#X_U`6@<^wRZBJQCA
zq6bpY2i&fnY1VWSM7KKy%{JhVoofE;UO@j19`O54iXy}zyNtC!jgCqO)?1E~>(erB
zyG>O3rI$&Y{3a2!L;t31GhKc)tRpp`NB(MD3_9?i=(S_!g$l%B{6vlUJfsn5{_%se
z1@7wpRj)6NbwfkUutcpHWUmRL$q~cB{a9^w*R^Z06kd;D;YhiymyJ28#}@Ae18&KO
z33L(54gbqh%TC|W03NqZAr5-?b)QKm5N4LS!JB4gVd&25>7R$bP#p)@xUw<1zV@Hy
z+nh#Yo7u#CgNfXM6;+BQs}x$DXJE;|{Ynh-0OYf`uy-j#17>Od=E&c5+}{LsunJ%E
z-k~19XWZ)y{Y{O(>!d1GlShAqt1XK$+*EI{fiNb3NjtcNiOrn%?_teL0<HG^Kikv-
z-+P(<p6$3^n3?qJuNwV<WTU{m$CyJefLn3BK#iPk$e?8}H;*MYk5djQ06sJnv<HgW
zl<7M9r_1K4FGCpM*1K}bpHFt|{7`tNd42Ah8->?jRYOLCqlza66OpEi$J%}dY7Y+z
znAB+|)l84`?QeooPX+t$;+LR9dP`mHj&0}<wYY#+$yat5ec}FP<Il)AF9^gQR}ZU*
z#ps-g)9{&#`x+Ak)TIFgoS6%{3h`{j+^HL{!P&qCx7Xg0!VpxR4VuIQ!&wau&x;ji
zw}Xa*2OV6PA?OF}nWrvY|8x}SkrebS#+-@)Ook<BFBeo02AY~s<-c|CiMIKi*)I&E
zU^oE`Pk~{HDjmX%B_#xzxKBb*V91YkTQ}*rEo=J4Xj0>h!9=@nq%H)Vdkpe%4@nmO
zW)oqSo$!2#(a*W+U=2*eILLmQm=0IY+Ywq>M={_ysm=!o9xnd}Ng=wP;Yv0Y6i}T!
z{H}IBP%<vytLdPLcFuy|5jOd!-&zu&Is~S=9dnx;owGXC>dZ8D;V)%qfOY``TyUk^
zeI~9~*np;}9DwuUzY~kkA%S!8Y!|HRJS@TKcPs$nl~9TK?o?(;*p==EC*klRPXSLQ
zuG#(MODCcW(T)mQkc9yhNu(IvyGrBZLoscXL<{MF5H!S#K>9Aghl81wlQE1+5Q+!`
zd{n7mNED{=6||mge8o8DZ~YCN!HENX`E(_Xw(jJ7#SFEp|Kay!%AprQZo8i!&_Ph1
z9?;4v^PF%9;;5sn`@g#Y3*tcG6_7kj2>Qj823F|r;nL8nX9`c)A!y+Wj8>YcSY9{{
zIKWqhr~2_MA?X)ecY?tS0Z=@k*dA2_I=8st-5vYF*!99D_SL{3+{NmO=FtFOHQ=`W
zQME~%To`x?17Qt%st~piy91s!;7+Hudc6Pybvc0z>O@%t_TIh#BTc|tE!6IF4*IMC
zRd@-5lLEc<1h63!1l55g6$%{!O-*P9?sAi|;I9X83wihN+rJB_faWK#9U@ZzJb<9a
z4W1=?`o;EON(j{mzzYptr(f)Ipn!DRz}Bh4gp3fcY6vQD0(8H_B>y}ex7Dx%<|@Ic
zFaQ%wV4Jg-haj)VfP}mamAC-ESukA+Ob;u<l5xy}5QItq5^@D)i?lwy*!VH%?|BxA
z1yr-j_W%~~=@yCtw{>56oDG7$gRTYC3;Mc(FTp*HfouSl)})v2SR6P%mbnGMa_cgV
zJTm)54Wa(P*|ah4>>$;3phN@Dz*NKMJs5o-a0_G`=p^b1=t9y9zizAnOQpfm%r3dU
zz`t`rcM1|cZAu0GJ<#fk`wLwVo{|ar<Is1QX^ukh_&y-i^)ftesSNn#3t|tjW%x)&
ziUSSUlndBYN7bVMj1^`<$VJd@hJxXQ`WV9q-~^mCPs+lZj>14`jIZNELB_ZY?t^@Q
zlSsYuFpi)c2Xjrq+;i{b`aYgOJE=>99XY{{Cq(0sfN_F3e89jH!4`}_3~rUC5z7bQ
z?gS6m-m+ZF6zCbZ-riePAevdA7dneTG;wUs>J~sR;5?-qkiN~<(<FMA66)Fj@+df-
z0Jz=d56CMx4bF9NY%$88!4|%7RFim?z;-H;?QnGlSUqfC1y-P>!*w7hJ_8SD3XABZ
z<Fqm%cbgu9Mt~S}zFAc*7lJd%e@`YnZd8wr*uYP47v1A5_Ab#{Gy1kO1?2iSQO^R=
z;ke$Oa9qIB0l-HE5Fuj?dWZ>Zd3+avN-V*(Lvl6CY0F%|O)3~iib}vCR~5hzg&Wms
zgf_Mw>^4v(3s}y5e|h+tS@>Xmh6>VwPcRhDA<A+S*g9B*U+)6mqxxYO*MSOV$O-_y
z`0N7xNd)gu;9z?KoFM--PN)+!zYdIm-6JR<ls4ca6b({hZ=R*wFE)@zK*q)Z)2`h8
z)jZ@8M$3}qng%o<Bu-G6CF7_wuQ3qF8knJz9wh|It!3D!I{;OI@-7wt?^OjaHUu{W
z1eryEv}u4?TvOeXZ%rf|f87A=dms%!;x^zl2>_x5SeOAz{6GoGh`|$WfQ-^*1rpiz
z8waEDMl2Aj1uzME2AV10HikXk$ZT2+g2rH+pS6t<D@?!)37Ej@OMdxP64+aWQh<UP
zjDk5}*ZQuNW8dESxUJZ6ASM&wwxAGyo~7y0{Xg2maT9s~bCcg=8PYB}+)#lEd~`Pk
za<;@(pF#VW%6k)=k5`^k{6(yQF{#Ee-kY2+ouhaTZmUfFX#-b7MulcmkD{zQR$7;R
z#=Pk&$H1)%T2R^Q?7(*eXuRoS6wf8V(aH$u(!ghjxA@D|1^-4LBOftHMjeo=N58x_
zC`qU%%0=$zPD^?UK&Ud9X0xmFZhj)zI4u{Z$vg%S51Zk0UX&w%>??KE@kpK?FO&`5
z{Dob2AHzDm{abk=wlOVMU0^4RjQ?9jOaT)Gnx>P`2`WYK3CjV@2Ol}0?cgI6`@hHk
zapQl=@IPDle_a7MTdjXk+jc7tIN@4Pa2<kG<4r$XkNf`e$HAW?Mob_aL8B{G(k>k;
zw>4JQHnO$OsT<$7Kiavm@UY!t(cvigr)pH|9r#8n3dexkO9HU=B^r8vkI{KWaMa?0
z1<T{v=As_u&wVB*-<ypLtbadGI;G8@9Ien+zsURhWQtf|*rB9L=zI=3zh3rK6Sqk;
zm^GulOTjAJHZkT0k7!z{-phXm@cBj?y(!+W^!wmvbmO6exgaLjZ_92_yWe7&;}p*D
znvsCAYl>*+qZ#+EpPW1RQ$=5Wj{H8`1uy%I_#C;JgL!<jVxNZJ?J`I<97STK9Mu2x
zPRuGNu4YW`Iy$G3*?O)V?F8?BG7~J{;aYZj{S*JxPCnAvV)%f!gt(G#c<<eaA=QIr
zDi@2|eO6Yjev3fowhX?S;Rc3B-x>>-AJ5)xT>K+RFnk~U^>%j6uu{#L(5c^H%RwA2
zzpzJ2%T+bo*j4P2tTnX};>Cj2{U<z1L(PXNF8LvV<Pp192N86_c)tj78<K?!_PJJJ
zjH(*{A65QRmsa1#kcPdBe3LvA?5OL`r9H>c6?<+MV=#u*lo+-igh|^j)3pbO&mOsu
zQY{Mla!Q`=6*J^L&2IkG!a$pFho6EQ{RdhF!i%MR=ol6!RIS@YiK*Dt=If1O9KA3S
zPvfmTmK|poWk`FQgPA$_`CRRKWhr}s2MI7A(~&qa=_F~YlRBPyNUM$w7(ZSxJ8r>5
zCIEO%a|KpaCxXmc#Gbo!^wN)@3io#<x#p@M->;alHP0VCuR?uksF5tjemP{?!_JfV
zo<BB`6>Dh%cO?{qhe{><RIc;NJeOf{m5=N;szM;O*lOd1{J!IyO*7=z8#bitj%;%c
z%^EFJ8oy+01#~7NYoxoN9tG5=gHb$N^(am)u_!~79_MkMEOY4jT|0HYOu0guNrf|P
zppo(d0=cAe2helYlxoscUXZzLo?VN+_8%cXw3Q>SlQ+DzO1Z*8Q+%AWYS{KbP9QPc
z)%6_UZ<)IHO6=k@lU<ox=|X-UxG1lTil;>)Rknjm<1SPue5Sk8D=|Nt|7C1g>r}K%
zj>A>Qd>aRTU3_whvM1N-Cx@!2ljtii_-%@-%T4$m{~zG+F`bFw3UAE*LHiC(W)gqA
z*CuH-YgH1Q!wZgR??$9+I+B)`9W@%YOqueR#H@GEy{)0Fp0C0IP2+NAD84#Nz3a1o
zn`xdkQxHZ}l}Y$@?$V3W$PUM~v)MGdcxGSOixC+egKwAjR)0M?B7WxEwaFTBkvS$-
zGsKR*631RS>|7?~KT;@6o*(<7DxlomWm$6u`a>iM-_2htYv8GwI+btDL5<v&asOxB
zE;sk_N#oKFnTKoVX;6t3V)q^{aiOoo2#<M9kk^```FCrVSp=7MpY8$6Jg@zJnq9ej
zNwsq`HiKVfdMk7|H2zfQ#0{rwM$oTZV(;(oLG3e(<I>4GskSW&xq%Paewamf@1N3k
zazAL|yTsLVxHmWw|1~Hk>5?GY$-`!-dj%I2sqZ|}nHV5$%4e0PH2rjs{|<*n%x`s%
zSM%}~KY^hdE?-$wplW^ueVw}emMai{WT)uxmYJ{os>>HOU5jAB0`gMeL6C;~KOv6M
zXMU+hsTt?5cMASl^jrT}!(3zNNSfCd@R?_ObZJuM6!(W<YA=K6$Dx`FEr-uVuh~ks
zOAA^tZztuym_1&Cknl6zt7U(Ds4sZKPhF?YPs(y_H@=l;_4+QOH-8cPD%V%^$(!xk
zG%n&ce80Z;QV(kLt?hpi<^Buy?GS57RkU_?&5nLvf6DGoo0xHx<^CdHgV|aJVBW{4
zcxx-Kt$S~NV7Mw2k2Si#TO*J)wI5gF`T}#bbhu-)UA;!6VM*ag)55!<M##$rFLId=
z>c|5j5DaT1wf*V%4wA?Ur1<Q(U16tA$q!7v(cO3XRw9C?-f`X-bt-uTvUooeoz==f
ztEBig_$w~rr0e&Dxd>ZQlv2CJsb2@Rglbz_T?cn7%A+NEquI_?_44aa=Yc8(y|K06
z(3naPuN<~but}>haeSur2^5Na*$Zl~@@vlYD1eI&Y|YA4dDEL5tCCLHBN)O^U$l#&
z1E}P7c+Su}#CwgIzA{Zyp*s_YbkN8ewHfo0JoEfb1i6+SO`&fVz&{1R$t(XRdj%ux
zk(NEFF`2AQv`^~wV=xa(ATO`W%Mur>F1$DIp69-fe~^7mRKZ;l|F9ir2y8pyIGW<?
z<z7O9@4WRAX{vD1<;k=x)+E*T0sDT1{*Q_pxr>gMuH%QS<}};CnO^_ljX4QCL-sk-
zHsBlxY-kFN_fuVz4;mb_Fs9S;k=hHwceH&yF9Xa~cqT1oT}qBE4_W74I9*GpHE>0u
zHeS}RnAgt$fqyqcO{L!gRPWNnN8wG+U5QE@@4j%OH>QUkCm~~{h`((XQKTullgK(%
zB3J(5y6JSKq2rY_C6@oJE*x03CzTj3|GD$2C$wi?^KP--`W_^x%@u=DJH`6akW`wm
zn!~5UvnRUqPQWl(xcyP1eM+MoM#3yJgzi5WQwb-M*AZKbTd7j<{`dBrM0Fkb6RusW
zS>Er>m@7HvXJIY+k=vZsw%G5t+NnZ`PYWp#|L3@_N$hd|iXxVeu6?2Bm-Ix+P{p&C
zoV<`0bL`KedR}jb*X||vnoj00deTMNcl6a0`X8~5Q;s**#(VY)pT*eCQ0u$JAtCz&
z&Zra0#usMKFjpJO3)Nc2V1BV=S^hykSrsUw@(<b_IdO7wbVyeyc21?-B-@rzl@&CU
z(O@O(<xS7T^=NWsS43;~E`8vIe=2f?s$EyV6TQ0Fm4+>HFUaWQ?t;G9%@S{n><4V(
zhE$;hfdc5-x$C@L#R+q5c^R+XAfcWDLKaSl7F;NmoKCfge98CQA%~^;J-^kC(R7GI
zO5@X*JmLH=6($jJGA!ICnY00&L7V&AC=t9x#M88epasns))po)crmK1VpV{u3P*g+
z@U4Oo2&>)>{{~=dxk~;}xJKWVn{dMD_vaAuVgR_)hC>jwSX>KSV=%A$9G(z6hF1mj
zKZGMnf7%!TuV0cMjzDq%oz^d1!-Az!tGx+$?Nb8y8+aRC(`ssDyveNurQC6Q)95{=
zQf2g}(m^`yvDE6Wzsd<WX%b#+seOsnE$~L(s#~KNTs(`2_jBS6+w$((jhuK_*Y$$|
z_d)S%LghEBA+vl^Dw6;~yz;MF65%K;+WP3Atw1vdQc?^`9j~cuO*lrsRTv^djr@lH
z?eW8D$?cBvG4>`Ex$t*l=hv@x19PmzHG(z|vtoB}$!?VlOSwJ%47mPQ7Jwn_TCcW}
zZglBml+M?A$6)UG?Z?gsiF+}!E9WL)tCRdjxZX+8rd#t^rG&@_Tb4=?j+#O{`>*h?
z3ZMq(@K%@dC;9FNP}i{wovu4|Uzjq0THx=On3L@1FS>Gc8}OXZFTrv7^ON{%na_Cb
zOnZLrT&}PpWbAka-CbEd+?k#wiI`Ho0y?AaUiIPC*!9q~@XpvlcCX8+N={fu7D7c$
zG;Q&EskHkI%?_1Y!rLODjb#sqeG&K$I)Mfy*G!M&%#y;UJ{wIRxUS*!a5;zR`1&XD
zoix%z{r1<h-Yy!E9J;hsH1KCXD{m52j0)Iw@zm~>x;KOxL$JE|(b&pTW=?OakK*?l
zmEU_~+No_=DsdfxYpLTcyyr}<uTV;!Hub3t(Q7R+_*g0BafUz0S-sEEDgtrx%1c*C
z*G37yt;>77r$~3MvqwZxBS&mVrKwX!9cQsF=SYmlyy=)Ox7cHd+nPTl%&0HVi#gwz
zmo&@%dUIfGI`rmo=9{ZVhE4w%l$?}GkUDML5EkA>&**a2`AZlp*=7H@+?W^W3OaHg
zL4k<ytUEJpS4k2`KOq(3Lr3CFY<rEu+paU)>WET=3<K?}-)F)fR8}s<-`gE~g!LZe
zF~5YFXisaJaCms`^HcKTl;!eK-|}Yvo6Fa(xi}qjRy2x;!6093k2h6#sqXn!ht$cC
z9%A;6SG9lgzzF#zjCn;LIwO!I&%a2%C~p^uWKf5`H+$KW>?fR=xZG9-zHFs7;XM04
z^o7Wa7-x$jgu)SpU-JAVUy^ZacC+Suof(l;QAcNTr|K1}yfM|ZRICVOnrY1a^JHTO
z0_FBhzk}14Tik(HoFisuC1Nlej}HT$(f7ACr**7mDqWC!cOKKpA0DL-ZrmJtZxNo=
zf2$!TxmN4q&pEQRhT9dB|Bw)+DZOX8-{BsYjMB=_Zy>J+v(>LSL^zLRKHJC7SGSL!
ziI9w3ll3F+Bvd|iW2HvQJo<rXYB|PvI(5JCm$qGs?Ii@h`CpW<1C!T352E+mA7A5d
z7$?41^G|6{YIq~J+_U3`7d7Cxl42V?;vJTzGLg-|R?@BVSu%PpHR2#KJ$$~H`2?qB
z3UQfanWmJ-eGXeAdJ^6JkbY$2f?fiCS@C1N?VaH}qp@qx3Wsv0t3q=AwEmpVN?Omv
zj8TRXV<5M+ERK?H7lPz(V;0WuwrQMH@%Zlj#I>rA_yt)>pzyLGig-9JeM`NFTv9%5
z8her*jd(vZr`o^#l&2|KalExc>6C+8MD;J<YHka6y*EZz%xtB!eEJ_`gs~fuW!$1C
z!nRyU67>Z2!Pws7&@|<%{#Cf|n5XrZa*kv^bk*o8;z{(Hd>vKKefL^#H&~i?iU@15
zb}HPPiaI{iqQ*a7C|LI9?3US=h#l+88%CcwPC9tfB^oVrRGdGmq@~NZ5H@zSj?lcO
z6Or;Q{7WFtK+%4T^7aY&o1A4v+QfJzU>BpTkD^|Nc{XTz1wvVxYot5rnU+V~vGMOW
ztMh+$T_B0<dWq)uT16u8mz$Wr0XKL4x<kuK;GjhQ2r=MSi!a|mvg4dtiQadO!$*o3
zyYKV(X+=8)1KplMrwPrfdk^L%xg|+$%kQH?<umFsq#Lk-_OzY1pQ1lMo0b>Vo=ibx
z50GASyE%HATFOZ}UH+z#NPA<!BU{Xp(5Ez*z8`h70)fQlxi{S>^mZ=}qwi$&jz51?
zH012!xw!sV7U>}n95PXS=gUz(gEuKW#TygPR$^vNV2qVdKIDrTom>;HVxeVX^^jSJ
z%+k<zec5T@igDb(#&8I{{VU)>W*^_{?2?fp<wj|J3)Evh_Sjr9^p$U9=2ej!N?w_F
zBXZA9uj$d;eYPF#b0MIrI(<g2^C}zgR3aw9kC#K}$vWPW+kNL6K82K%QK3&o)@9iS
zZGuzoB<RGhz0CM5RKR|nH&xM6`&GG&RNq+ETU-SDXH)-V{$*eHX>Y5Oa_nr<E$y$=
zrECR@{G42z{J-3(br`&?KSAp$)_D?jAxX%ubq>)XKX!U&&~<Y;<?X@-;+K2W3;Y|^
zp7wzZvrXR;d1`6{7qmomAw{o3zS~uX>kdzR^CxfhM#z^2i0WmntA<-^?p=!@d@tA^
zbk~yH-PoG<%x}9r1@a|yRinfw>QF;n2e09Jb2Os}?VPrVi=iSO!^5ngFm!gWKRz#*
zdR@qr^s4#Xa_}#AQI5|FjP9-MTvDCq@RAW<9}*qzuaM;O(>9AE{l^y8zcyW1a}dzQ
z2aP4DRUN|>oq0)q$}3`=REf#wdp%m7NWDvywnv^a!I&%JzgC#|4E*&G_Yg_NGW!AF
zn`+HoC!Sy`lhVsddSIuFy(*Na7m?fOT|4>V-SVr!Z$3xIUe#{COQAVlVrJ*(O?Lf2
z=ewcnXA~^^OA$AvdFTivut}A`C+R1phY59KK4DWlo7H{IP2VggvgW!b?Yfa@xWJmz
z8<kCi*bKEtCS~nf&#u<3iyd?-(7WFqEW0*48c-O%PTaRECLZsbDbjtrTFvx^{hDXr
zm0H6*H#s2oiy|MjEx5=59WRNOJx1?LbHBsv$86foM-c{%d0TVHeL{;9Ulr$+Qxq-P
zm}gTeF%--S479d43!+L4*koutQ#dbdzU9H*BG!lTAk4_0A9$uX|JvCZb0-dwBE7If
zuQ!QmJO%B(EC;XFHGVXHm>xJ-=snIUJZYAy<cB4-+qK+am!!o~wGVgZ+|YT}9=3oM
zEY2ZcTGNrD#F*uLoA6E@iePV2B&2y`ynFg7U~?tE^REw>y3_sV%6aFGQ#Xu^wY64z
z^UJ-}{C~d^{4Qsgc{_sKc0IzW+>q2tdosB{KTnw-k(?D0gr1FIz@e){N>{owJt>mU
zZHvgKAzGFn@HvL6K9YhqNgwLhmy3=zmtH>KWgo>}D~wYAGQ~<+s8)%iz413Xg(T6m
z3G#OOc9M6FioS?rQB!mpWa`6(t(8b>xoWO`^JRsW$3*XXkzG*&)-;>`p%1wwTkKHT
zG39&07!8Sp7wmeIE9S3#uLC`nbkktCt>T{U&SvqV@GIrnq!0D5tK<5)-{}_}LMH#D
z`L)$IxQcRA*Gk5U*eg2VJqQ^&%%%C%f~N$6*%PQ{vZ8J_0pCsdawDn1>DJv7+GHBb
zTW+t%j$U^Xa!SGkcbD3Jmn>f4X*-bVmx>|l`Dm04e0tDk+TNb`sNUMG=7vBpXA)WQ
zk=wEM2S=X<B19u;g~MYo3~TCJf1NjfQ1r@yhe0Brhb^-x)?q06dY?V_k-&=Gss65?
zgWYb-uljL`USemWrmjkTSgpe4UHnFsl0{8rzyHKh^YPoB!kAP)<84w&)Yp1juEe~-
z@PP&=FK6or9>>`$aWxjl9py+rdbTfePrMZg!TT=)-yNFHz2`e_nZ}uBee3vgj@d@t
zSQK^(uy@sjw!O@)y74WSpNGzP{@c3eW9X4L4U_j4Q*EFA4Xf{#i|&5Axe(wXv2W=y
z9!N=e%kO(Ua<;wsqLlu0HA={D|MMBsDsd@770&qrIX$ENro#-6og~k1E&e~-S$}4J
zd$vk_7tP~KTpCxgO;bAm%vI>J_OF(-IQb+7cMO+EQEh}AZdmHpY+dWI3w)W)^bh1t
zS~pgInv7v(+-M4nQuf$-dY-hA&N<hY5k)ZT&Sm0DSY8PD3xwMzU!h|iDZ$D0!AqL4
zr7KyN0ry>aoAsCOsn&O<Zwq#B|KfZhK9%=CiI|S}Rm2~+%a$Ab+ThcRl-`fE6OgjJ
zoJnlqTQv31MS64ceK@aR%2A{^>UzJqPjbv_P1rd5ezS~_{O!A(i4*ekgI(G2%-s9C
zM*-`6|JW20&=P(EHwvUosVW&pv?dbeC+srBZiC}XO{cr(I0!od!t;qqw`!lPld^c}
z;I@|5t0NhgzTi&-HgOhYXmiK(C@!BwF?iAcDFQ*B;fEmFdHDYYNC{C#Am!np6NhYj
z`=@OFQ;=Af!9?)UwUMmSpOJeu5kD(v-<}KodE<28DdNRcB@Py~n8Q~w+s%tl|3n?z
zA8Q)PV%gf)?OCcgHBie-_-Ir5DN%;y-ElO5v)@7^XUcXkzszz+J7MpXk90_QN22No
z-SX4g$3lM2O79;Pu(Hn4k9?P=4cqmUc`$eEINGMWl$WpufPez+-9xq;4AVT>Ke+1M
zs+LEtp2(>Tou>JyqVAifg{&2qR`RLUeCVkW^ez}JHDQ#hbmmH0I)Pr`Vx~v-@_<3G
zgZ6{NWoo;H{Rd=aYreDPhLXh+e$H`79b21}HKUN`D}>)SZcuzO$f;Ju(tNyP5HUO9
zJQJYg${lq(G8j42rWb?BdJtVcMYSA{WWr^{^)t>aF)+t8QQ)6F$m1yBt<I^$@PLj5
zu#@SxU%q`e)RFgy$G6en+)#J)Q6{`Kt1s8KnH0I`D6Wgwz-AT@J<;U50bvRc0;}Gw
z>F04%M>j0%>TB!l6|S`&<p!Y8yo5&%Hl<UB9WJ8X;DGh($3_Y>!G~|cv7}b$hd$=x
zQn}ahcPECNeGT|-CSB3mF`urPnAeIrXeN5fTxLg+M_1Z+pM85zD>Rx^+1uez-C3}3
zrPpXG+G9Tu|9SaW%LC6V{Od34nU8=aM!oz#zVEkE-Tq)#WiNv7BgkPc6}z-gdSWj7
z3D$p?Qe#h_uxaYd$Auad31*GX4?m46xpttglJax>(w*TAbQErWSNhf$-)rbuXD(SK
z=X((%`-ex#;VpWxw+Us2<YVRQWk!CnBJ3rfCc77}%wLM0UXk8oqZ5&^aH?Ag5bVo%
zM`YS+L{%S|`l{ojgm$%P->A7jDE=F-4uQYazA+Q*=sH5@arEH!IEg#3+FRJo6wg!+
zjHLc5OBjb|9u`-N_I+LfZizq#X`oAdL-Iqm%J$3Bq~^u1r6)PzQypFWX=ZM;Uwg-G
zfpqXwb_lvEqKnr%bxL3-(c{pEHTn~AVPyUb>g|}oD{y-WdI_=`-DAfd?@NA+=2?}-
z3%phh9pp!|f}!=(#*UeqzT4MY`zzPMGs@|(-`YOC9Idw6y3vczhi}U0T#mueJd`0s
z`8H95#{vql*G`j<vx^gPTEnH9Y!6;S7$IZFX5j1(DPuN$ci?&N*h{LrcE-Mi`|jLp
zCwjssww9Mu8;{qIZDTsqUahqzVYOitP~gXw)dOH+Hdx-FMxdM4gy()>z}f!T|MBa5
zV?>8#A$;(%6&!;(nMBCTF1L)p2hUDpwK?GB)AYE#S+M*gSpKYLtpgzLiSPy^Q1njI
zV?ph^XV-%Q!ba^XceqaEycujisZr5SR=vX!2Clb2U2o`d=Qz9Zy?ZT!+D9v`8{IK^
zMSqWvC*hw}gAYv(_<=k8mm1t70VL@B_xgX2|KrC0=gQzR5<GiE<;EXEitxM%E}}rt
NB?I$|HF~Zw{|`5`@Dcz3

diff --git a/.github/workflows/docs/Quantinuum_logo_white.png b/.github/workflows/docs/Quantinuum_logo_white.png
deleted file mode 100644
index e896db91cbc3e092ffacd6174419fbfaba0ff015..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 16704
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

diff --git a/.github/workflows/docs/build-docs b/.github/workflows/docs/build-docs
deleted file mode 100755
index 6166e0bd..00000000
--- a/.github/workflows/docs/build-docs
+++ /dev/null
@@ -1,114 +0,0 @@
-#!/usr/bin/env python
-
-import argparse
-import datetime
-from importlib import import_module
-from pathlib import Path
-import shutil
-import subprocess
-import sys
-
-DOCS_DIR = Path(sys.argv[0]).absolute().parent
-MODULES_DIR = DOCS_DIR.parent.parent.parent
-TKET_EXAMPLES_LINK = "https://tket.quantinuum.com/examples/"
-TKET_MANUAL_LINK = "https://tket.quantinuum.com/user-manual/"
-TKET_WEBSITE_LINK = "https://tket.quantinuum.com/"
-PYTKET_DOCS_LINK = "https://tket.quantinuum.com/api-docs/"
-PYTKET_EX_DOCS_LINK = "https://tket.quantinuum.com/api-docs/extensions.html"
-PYTKET_QULACS_PYPI_LINK = "https://pypi.org/project/pytket-cutensornet/"
-PYTKET_QULACS_GITHUB = "https://github.com/CQCL/pytket-cutensornet"
-MODULE = "cutensornet"
-
-def get_module_version():
-    m = import_module(f"pytket.extensions.{MODULE}")
-    return m._metadata.__extension_version__.split(".")
-
-
-def remove_dir(dirpath):
-    if dirpath.exists() and dirpath.is_dir():
-        shutil.rmtree(dirpath)
-
-
-def fix_links(filepath):
-    with open(filepath, "r", encoding="utf8") as f:
-        content = f.read()
-    content = content.replace("pytket._tket", "pytket")
-    with open(filepath, "w", encoding="utf8") as f:
-        f.write(content)
-
-
-def build_module_docs():
-    v = get_module_version()
-    mod_docs = MODULES_DIR / "docs"
-    mod_build = mod_docs / "build"
-    conf_copy = mod_docs / "conf.py"
-    logo_copy_black = mod_docs / "Quantinuum_logo_black.png"
-    logo_copy_white = mod_docs / "Quantinuum_logo_white.png"
-    shutil.copy(DOCS_DIR / "conf.py", conf_copy)
-    shutil.copy(DOCS_DIR / "Quantinuum_logo_black.png", logo_copy_black)
-    shutil.copy(DOCS_DIR / "Quantinuum_logo_white.png", logo_copy_white)
-    remove_dir(mod_build)
-    index_rst = mod_docs / "index.rst"
-    with open(mod_docs / "intro.txt", "r") as f:
-        content = f.readlines()
-        content.append(
-            "\n.. toctree::\n\t:caption: pytket documentation:\n\t:maxdepth: 1\n\n"
-        )
-        content.append(f"\tpytket API docs <{PYTKET_DOCS_LINK}>\n")
-        content.append(f"\tpytket extensions <{PYTKET_EX_DOCS_LINK}>\n")
-        content.append(f"\tManual <{TKET_MANUAL_LINK}>\n")
-        content.append(f"\tExample notebooks <{TKET_EXAMPLES_LINK}>\n")
-        content.append(f"\tTKET website <{TKET_WEBSITE_LINK}>\n")
-        content.append(
-            "\n.. toctree::\n\t:caption: Links:\n\t:maxdepth: 1\n\n"
-        )
-        content.append(f"\tbug tracker <{PYTKET_QULACS_GITHUB}/issues>\n")
-        content.append(f"\tGitHub <{PYTKET_QULACS_GITHUB}>\n")
-        content.append(f"\tPyPi <{PYTKET_QULACS_PYPI_LINK}>\n")
-
-    with open(index_rst, "w") as f:
-        f.writelines(content)
-    subprocess.run(
-        [
-            "sphinx-build",
-            "-b",
-            "html",
-            "-D",
-            f"project=pytket-{MODULE}",
-            "-D",
-            f"copyright={datetime.date.today().year} Quantinuum",
-            "-D",
-            f"version={'.'.join(v[:2])}",
-            "-D",
-            f"release={'.'.join(v)}",
-            ".",
-            "build",
-        ],
-        cwd=mod_docs,
-    )
-    for htmlfile in mod_build.rglob("*.html"):
-        fix_links(htmlfile)
-    fix_links(mod_build / "searchindex.js")
-    conf_copy.unlink()
-    logo_copy_black.unlink()
-    logo_copy_white.unlink()
-    index_rst.unlink()
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(
-        description="Build HTML documentation for pytket-cutensornet."
-    )
-    parser.add_argument("-d", "--dest", help="copy artifacts into destination folder")
-    args = parser.parse_args()
-
-    print("Building docs for modules:", MODULE)
-    build_module_docs()
-
-    if args.dest is not None:
-        dest = Path(args.dest)
-        shutil.copytree(
-            MODULES_DIR / "docs" / "build",
-            dest,
-            dirs_exist_ok=True,
-            )
\ No newline at end of file
diff --git a/.github/workflows/docs/check-build-docs b/.github/workflows/docs/check-build-docs
deleted file mode 100755
index e3e19b5e..00000000
--- a/.github/workflows/docs/check-build-docs
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/bin/bash
-
-./.github/workflows/docs/build-docs 1>out.txt 2>err.txt
-cat out.txt err.txt
-ERRS=$(cat err.txt)
-if [ -n "$ERRS" ]
-then
-    echo "Docs build failed."
-    exit 1
-fi
\ No newline at end of file
diff --git a/.github/workflows/docs/conf.py b/.github/workflows/docs/conf.py
deleted file mode 100644
index 748ab387..00000000
--- a/.github/workflows/docs/conf.py
+++ /dev/null
@@ -1,149 +0,0 @@
-# -*- coding: utf-8 -*-
-
-# Configuration file for the Sphinx documentation builder.
-# See https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-import re
-from typing import Any, Dict, Optional
-from urllib.parse import urljoin
-
-from docutils import nodes
-from docutils.nodes import Element, TextElement
-from sphinx.application import Sphinx
-from sphinx.environment import BuildEnvironment
-
-author = "Quantinuum"
-
-extensions = [
-    "sphinx.ext.autodoc",
-    "sphinx.ext.autosummary",
-    "sphinx.ext.intersphinx",
-    "sphinx.ext.mathjax",
-    "sphinx.ext.napoleon",
-    "sphinx_copybutton",
-    "enum_tools.autoenum",
-]
-
-pygments_style = "borland"
-
-html_theme = "sphinx_book_theme"
-
-html_theme_options = {
-    "repository_url": "https://github.com/CQCL/pytket-cutensornet",
-    "use_repository_button": True,
-    "use_issues_button": True,
-    "navigation_with_keys": True,
-    "logo": {
-        "image_light": "Quantinuum_logo_black.png",
-        "image_dark": "Quantinuum_logo_white.png",
-    },
-}
-
-html_static_path = ["_static"]
-
-html_css_files = ["custom.css"]
-
-# -- Extension configuration -------------------------------------------------
-
-pytketdoc_base = "https://tket.quantinuum.com/api-docs/"
-
-intersphinx_mapping = {
-    "python": ("https://docs.python.org/3/", None),
-    "pytketdoc": (pytketdoc_base, None),
-    "qiskit": ("https://qiskit.org/documentation/", None),
-    "qulacs": ("http://docs.qulacs.org/en/latest/", None),
-}
-
-autodoc_member_order = "groupwise"
-
-# The following code is for resolving broken hyperlinks in the doc.
-
-# Mappings for broken hyperlinks that intersphinx cannot resolve
-external_url_mapping = {
-    "BasePass": urljoin(pytketdoc_base, "passes.html#pytket.passes.BasePass"),
-    "Predicate": urljoin(pytketdoc_base, "predicates.html#pytket.predicates.Predicate"),
-    "ResultHandle": urljoin(
-        pytketdoc_base,
-        "backends.html#pytket.backends.resulthandle.ResultHandle",
-    ),
-    "BackendResult": urljoin(
-        pytketdoc_base,
-        "backends.html#pytket.backends.backendresult.BackendResult",
-    ),
-    "Circuit": urljoin(pytketdoc_base, "circuit_class.html#pytket.circuit.Circuit"),
-    "BasisOrder": urljoin(pytketdoc_base, "circuit.html#pytket.circuit.BasisOrder"),
-    "QubitPauliOperator": urljoin(
-        pytketdoc_base, "utils.html#pytket.utils.QubitPauliOperator"
-    ),
-    "QubitPauliString": urljoin(
-        pytketdoc_base, "pauli.html#pytket.pauli.QubitPauliString"
-    ),
-}
-
-# Correct mappings for intersphinx to resolve
-custom_internal_mapping = {
-    "pytket.utils.outcomearray.OutcomeArray": "pytket.utils.OutcomeArray",
-    "pytket.utils.operators.QubitPauliOperator": "pytket.utils.QubitPauliOperator",
-    "pytket.backends.backend.Backend": "pytket.backends.Backend",
-    "qiskit.dagcircuit.dagcircuit.DAGCircuit": "qiskit.dagcircuit.DAGCircuit",
-    "qiskit.providers.basebackend.BaseBackend": "qiskit.providers.BaseBackend",
-    "qiskit.qobj.qasm_qobj.QasmQobj": "qiskit.qobj.QasmQobj",
-    "qiskit.result.result.Result": "qiskit.result.Result",
-}
-
-
-def add_reference(
-    app: Sphinx, env: BuildEnvironment, node: Element, contnode: TextElement
-) -> Optional[nodes.reference]:
-    # Fix references in docstrings that are inherited from the base
-    # pytket.backends.Backend class.
-    mapping = app.config.external_url_mapping
-    if node.astext() in mapping:
-        newnode = nodes.reference(
-            "",
-            "",
-            internal=False,
-            refuri=mapping[node.astext()],
-            reftitle=node.get("reftitle", node.astext()),
-        )
-        newnode.append(contnode)
-        return newnode
-    return None
-
-
-def correct_signature(
-    app: Sphinx,
-    what: str,
-    name: str,
-    obj: Any,
-    options: Dict,
-    signature: str,
-    return_annotation: str,
-) -> (str, str):
-    new_signature = signature
-    new_return_annotation = return_annotation
-    for k, v in app.config.custom_internal_mapping.items():
-        if signature is not None:
-            new_signature = new_signature.replace(k, v)
-        if return_annotation is not None:
-            new_return_annotation = new_return_annotation.replace(k, v)
-    # e.g. Replace <CXConfigType.Snake: 0> by CXConfigType.Snake to avoid
-    # silent failure in later stages.
-    if new_signature is not None:
-        enums_signature = re.findall(r"<.+?\: \d+>", new_signature)
-        for e in enums_signature:
-            new_signature = new_signature.replace(e, e[1 : e.find(":")])
-
-    if new_return_annotation is not None:
-        enums_return = re.findall(r"<.+?\: \d+>", new_return_annotation)
-        for e in enums_return:
-            new_return_annotation = new_return_annotation.replace(e, e[1 : e.find(":")])
-
-    return new_signature, new_return_annotation
-
-
-def setup(app):
-    app.add_config_value("custom_internal_mapping", {}, "env")
-    app.add_config_value("external_url_mapping", {}, "env")
-    app.connect("missing-reference", add_reference)
-    app.connect("autodoc-process-signature", correct_signature)
diff --git a/.github/workflows/docs/requirements.txt b/.github/workflows/docs/requirements.txt
deleted file mode 100644
index 96778c80..00000000
--- a/.github/workflows/docs/requirements.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-sphinx >= 4.5, <7
-sphinx_autodoc_annotation
-sphinx-autodoc-typehints>=1.19.3
-sphinx_book_theme >= 1.0.1, <2.0
-sphinx-copybutton
-enum-tools[sphinx]
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index 3b25b435..f159a181 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,3 +14,7 @@ pytket/extensions/cutensornet/_metadata.py
 result
 .direnv
 .envrc
+.venv
+docs/pyproject.toml
+docs/poetry.lock
+
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 00000000..fdc8b037
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,4 @@
+[submodule "docs/pytket-docs-theming"]
+	path = docs/pytket-docs-theming
+	url = https://github.com/CQCL/pytket-docs-theming.git
+	branch = main
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..d401a96b
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,5 @@
+# Building the docs
+
+The docs are built by using the [pytket-docs-theming](https://github.com/CQCL/pytket-docs-theming/) repository as a git submodule. If there are issues with the docs build, feel free to open an issue or pull request there.
+
+For instructions on how to build the docs, take a look at the [extensions README](https://github.com/CQCL/pytket-docs-theming/blob/main/extensions/README.md).
\ No newline at end of file
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
deleted file mode 100644
index 9c8a6ed2..00000000
--- a/docs/_static/custom.css
+++ /dev/null
@@ -1,35 +0,0 @@
-.wy-side-nav-search,
-.wy-nav-top {
-    background: #5A46BE;
-}
-
-.wy-grid-for-nav,
-.wy-body-for-nav,
-.wy-nav-side,
-.wy-side-scroll,
-.wy-menu,
-.wy-menu-vertical {
-    background-color: #FFFFFF;
-}
-
-.wy-menu-vertical a:hover {
-    background-color: #d9d9d9;
-}
-
-.btn-link:visited,
-.btn-link,
-a:visited,
-.a.reference.external,
-.a.reference.internal,
-.wy-menu-vertical a,
-.wy-menu-vertical li,
-.wy-menu-vertical ul,
-.span.pre,
-.sig-param,
-html[data-theme=light] {
-    --pst-color-inline-code: rgb(199, 37, 78) !important;
-}
-
-.sig-name {
-    font-size: 1.25rem;
-}
\ No newline at end of file
diff --git a/docs/build-docs.sh b/docs/build-docs.sh
new file mode 100644
index 00000000..211c70a9
--- /dev/null
+++ b/docs/build-docs.sh
@@ -0,0 +1,21 @@
+#!/bin/bash
+rm -rf build/
+
+# Move theming elements into the docs folder
+cp -R pytket-docs-theming/_static .
+cp -R pytket-docs-theming/quantinuum-sphinx .
+cp pytket-docs-theming/conf.py .
+
+# Get the name of the project
+EXTENSION_NAME="$(basename "$(dirname `pwd`)")"
+
+# Correct github link in navbar
+sed -i '' 's#CQCL/tket#CQCL/'$EXTENSION_NAME'#' _static/nav-config.js
+
+# Build the docs. Ensure we have the correct project title.
+sphinx-build -b html -D html_title="$EXTENSION_NAME" . build 
+
+# Remove copied files. This ensures reusability.
+rm -r _static 
+rm -r quantinuum-sphinx
+rm conf.py
\ No newline at end of file
diff --git a/docs/intro.txt b/docs/index.rst
similarity index 91%
rename from docs/intro.txt
rename to docs/index.rst
index e7876948..f1c9fab3 100644
--- a/docs/intro.txt
+++ b/docs/index.rst
@@ -31,3 +31,9 @@ This will include the necessary dependencies such as CUDA toolkit. Then, to inst
 .. toctree::
     api.rst
     changelog.rst
+
+.. toctree::
+   :caption: Useful links
+
+   Issue tracker <https://github.com/CQCL/pytket-cutensornet/issues>
+   PyPi <https://pypi.org/project/pytket-cutensornet/>
diff --git a/docs/install.sh b/docs/install.sh
new file mode 100644
index 00000000..939fe5a7
--- /dev/null
+++ b/docs/install.sh
@@ -0,0 +1,8 @@
+# Copy over poetry dependencies from theming repository
+cp pytket-docs-theming/extensions/pyproject.toml .
+cp pytket-docs-theming/extensions/poetry.lock .
+
+# Install the docs dependencies. Creates a .venv directory in docs
+poetry install
+
+# NOTE: Editable wheel should be installed separately.
diff --git a/docs/pytket-docs-theming b/docs/pytket-docs-theming
new file mode 160000
index 00000000..cfbe34c4
--- /dev/null
+++ b/docs/pytket-docs-theming
@@ -0,0 +1 @@
+Subproject commit cfbe34c48f88c56085b8ef65f640d0108b8a9fa6