Add symmetric tensor tutorial to docs as appendix (#316)

* Add symmetric tensor tutorial to docs as appendix

* Add to landing page

* Update docs/src/appendix/symmetric_tutorial.md

Co-authored-by: Lukas Devos <[email protected]>

* Fix equation references

* Pick a different fusion tree

* Updates on constructing symmetric tensor map from dense data

* Reduce toc depths in index

* Address review comments

* Switch appendix order

* Apply suggestions from code review

Co-authored-by: Jutho <[email protected]>

* Apply suggestions from code review

Co-authored-by: Boris De Vos <[email protected]>

* Add comment on the terms 'charge' and 'sector'

* Add note on `FusionStyle`s

* Show `subblocks` of fermionic operators

* Some formatting

* Un-specify `fusiontrees`

* Apply suggestions from code review

Co-authored-by: Lukas Devos <[email protected]>

* Add note on fusion multiplicities and their implication for the Clebsch-Gordan decomposition

* Change Ising model title

* Remove unnecessary semicolon

* Introduce `Z2Irrep` more gently and demonstrate its fusion rules programatically

* Fix box to be technically correct.

* Update docs/src/appendix/symmetric_tutorial.md

Co-authored-by: Jutho <[email protected]>

* Address more comments, add toc

* Forgot to move the dims check

* Add headers for toc and setup, and switch order

---------

Co-authored-by: Lukas Devos <[email protected]>
Co-authored-by: Jutho <[email protected]>
Co-authored-by: Boris De Vos <[email protected]>

Author: 4 people

docs/Project.toml

@@ -1,8 +1,12 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 DocumenterInterLinks = "d12716ef-a0f6-4df4-a9f1-a5a34e75c656"
+LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
+SUNRepresentations = "1a50b95c-7aac-476d-a9ce-2bfc675fc617"
 TensorKit = "07d1fe3e-3e46-537d-9eac-e9e13d0d4cec"
+Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+WignerSymbols = "9f57e263-0b3d-5e2e-b1be-24f2bb48858b"
 
 [compat]
 Documenter = "1"

docs/make.jl

@@ -21,16 +21,27 @@ pages = [
         "lib/spaces.md", "lib/tensors.md",
     ],
     "Index" => ["index/index.md"],
-    "Appendix" => ["appendix/categories.md"],
+    "Appendix" => ["appendix/symmetric_tutorial.md", "appendix/categories.md"],
 ]
 
+mathengine = MathJax3(
+    Dict(
+        :loader => Dict("load" => ["[tex]/physics"]),
+        :tex => Dict(
+            "inlineMath" => [["\$", "\$"], ["\\(", "\\)"]],
+            "tags" => "ams",
+            "packages" => ["base", "ams", "autoload", "physics"]
+        )
+    )
+)
+
 makedocs(;
     modules = [TensorKit, TensorKitSectors],
     sitename = "TensorKit.jl",
     authors = "Jutho Haegeman",
     warnonly = [:missing_docs, :cross_references],
     format = Documenter.HTML(;
-        prettyurls = true, mathengine = MathJax(), assets = ["assets/custom.css"]
+        prettyurls = true, mathengine, assets = ["assets/custom.css"]
     ),
     pages = pages,
     pagesonly = true,