From 832ddc1c4932a092e94c5aa7977d524706237ee3 Mon Sep 17 00:00:00 2001
From: Danny Colin <dannycolin@users.noreply.github.com>
Date: Sun, 28 Apr 2024 02:55:46 -0400
Subject: [PATCH] (no bug) Use sphinx-rtd-theme (#152)

Gets us in compliance with ReadTheDocs best practices as well.
---
 .readthedocs.yaml                      |  9 ++++--
 docs/en/images/bugzilla-logo-white.svg | 42 ++++++++++++++++++++++++++
 docs/en/rst/_static/bugzilla.css       | 24 +++------------
 docs/en/rst/conf.py                    | 27 ++++++++++++++---
 docs/requirements.txt                  |  3 ++
 5 files changed, 79 insertions(+), 26 deletions(-)
 create mode 100644 docs/en/images/bugzilla-logo-white.svg
 create mode 100644 docs/requirements.txt

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 7eada0dd63..ff4cc83b48 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -1,8 +1,8 @@
 version: 2
 build:
-  os: "ubuntu-20.04"
+  os: "ubuntu-22.04"
   tools:
-    python: "3.10"
+    python: "3.11"
   apt_packages:
     - libfile-copy-recursive-perl
   jobs:
@@ -10,3 +10,8 @@ build:
       - perl docs/makedocs.pl --pod-only
       - cp -rp docs/en/html/integrating/api/ "$READTHEDOCS_OUTPUT/html/integrating/api"
       - cp -p docs/en/html/style.css "$READTHEDOCS_OUTPUT/html/"
+sphinx:
+  configuration: docs/en/rst/conf.py
+python:
+  install:
+    - requirements: docs/requirements.txt
diff --git a/docs/en/images/bugzilla-logo-white.svg b/docs/en/images/bugzilla-logo-white.svg
new file mode 100644
index 0000000000..e53952646f
--- /dev/null
+++ b/docs/en/images/bugzilla-logo-white.svg
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg version="1.1" viewBox="0 0 252 92" xmlns="http://www.w3.org/2000/svg">
+ <g stroke-width="1.85">
+  <path d="m47.645 32.913v-4.0971h0.45851c-0.66923-0.31388-1.413-0.49457-2.1995-0.49457h-26.59c-2.8692 0-5.2043 2.3351-5.2043 5.2043v26.589c0 2.8707 2.3351 5.2058 5.2043 5.2058h26.59c2.869 0 5.2043-2.3351 5.2043-5.2058v-26.589c0-0.20781-0.01577-0.41143-0.03934-0.61277z" opacity=".5"/>
+  <path d="m45.295 64.499h-26.591c-2.8694 0-5.2045-2.3351-5.2045-5.2056v-26.589c0-2.8694 2.3351-5.2045 5.2045-5.2045h26.591c2.869 0 5.2041 2.3351 5.2041 5.2045v26.589c0 2.8703-2.3351 5.2056-5.2041 5.2056" fill="#fff"/>
+  <path d="m48.938 59.293c0 2.0125-1.6313 3.6436-3.6435 3.6436h-26.591c-2.0123 0-3.6435-1.6311-3.6435-3.6436v-26.591c0-2.0125 1.6313-3.6436 3.6435-3.6436h26.591c2.0123 0 3.6435 1.6311 3.6435 3.6436z" fill="#90449e"/>
+  <path d="m52.368 33.122c-2.5532-1.8454-5.0983-3.2457-6.05-3.75 0.76658 1.7745 1.0498 3.1673 1.0584 3.1784-0.0055-8.07e-4 -0.77317-1.6996-1.8931-3.7752-1.1183-2.0796-2.9018-4.4205-5.5279-5.5431-0.89116-0.38159-1.7076-0.53544-2.4548-0.53544-2.7299-0.0095-4.6589 2.1098-5.4461 3.1915-0.26242 0.35715-0.39041 0.58269-0.39041 0.58389l-0.05461 0.09601-0.10015 0.04512c-0.84406 0.37323-1.8258 1.3976-2.5987 2.1053-2.2602 2.0506-3.6377 4.6279-3.6377 7.427 0 1.027 0.18506 2.0872 0.58509 3.1711 0.72889 1.9695 1.9749 3.5276 3.6366 4.8077 1.8987 1.5385 1.7923 5.702 1.8236 5.7345v4.3996c0.04393 0.04592 0.08222 0.08948 0.13176 0.13924 0.14272 0.14193 0.30866 0.29427 0.50054 0.44771 0.71949 0.57647 1.7555 1.1422 3.0496 1.1422 0.82245-8.04e-4 1.7575-0.22816 2.8041-0.84267l0.06105 0.0076c0.46188-3.1684 1.5229-4.8561 3.2118-5.6898 1.6984-0.8347 3.8851-0.82708 6.6322-0.93983 2.7282-0.10594 5.3845-0.54084 7.3842-1.6243 1.9979-1.0897 3.3548-2.7708 3.614-5.5279 0.0082-0.0985 0.01052-0.1979 0.01052-0.29688 0.03801-2.5675-3.1171-5.6382-6.3515-7.9511" fill="#f6bd6d"/>
+  <path d="m25.45 62.958 4.148-7.5529s-7.2059-3.1612-10.85 7.4662v0.08722z"/>
+  <path d="m41.14 26.494c0.1074 0.26455 0.18531 0.54964 0.2477 0.84289-0.0335-0.25678-0.08247-0.50639-0.15186-0.74412-0.03268-0.03194-0.06296-0.0675-0.09589-0.09887"/>
+  <path d="m43.896 31.72c-0.17567-1.8082-1.2347-3.706-2.6089-5.072 1.2529 1.474 2.1418 3.4757 2.1418 5.2965 0 3.402-1.8478 4.8822-4.6628 4.8582-1.7723-0.01324-2.9282-0.34755-3.6823-0.91641 0.77638 0.93887 2.1172 1.436 4.5633 1.2191 2.8568-0.25386 4.5842-1.9357 4.2492-5.3854"/>
+  <path d="m36.587 24.843c-0.0082 0.0019-0.01577 0.0056-0.02134 0.0076-0.0624 0.0616-0.1216 0.12853-0.18023 0.19601 0.06668-0.06962 0.13149-0.14113 0.20298-0.20322"/>
+  <path d="m41.23 26.577c0.0014 0.0056 0.0019 0.0095 0.0027 0.01538 0.0187 0.01694 0.03536 0.03688 0.05301 0.05449-0.0187-0.02409-0.03694-0.0482-0.0568-0.07094" fill="#fff"/>
+  <path d="m41.288 26.647c-0.0187-0.01979-0.03507-0.0369-0.05303-0.05451 0.06941 0.23808 0.11838 0.48756 0.15209 0.74416 0.02705 0.20835 0.04658 0.42023 0.04658 0.63835 0 2.1682-1.3593 3.9256-3.0363 3.9256s-3.0365-1.7575-3.0365-3.9256c0-1.1668 0.39759-2.2089 1.0227-2.9279 0.05868-0.0675 0.11786-0.13445 0.18023-0.19582 0.11918-0.11721 0.24343-0.226 0.37539-0.3195-2.3693 0.36638-3.2692 2.9599-3.2692 6.111 0 2.2285-0.0187 4.1622 1.4143 5.2428 0.75396 0.5689 1.91 0.90178 3.6825 0.91662 2.815 0.02409 4.6628-1.4564 4.6628-4.8584 0-1.8206-0.88896-3.8225-2.1418-5.2965" fill="#fff"/>
+  <path d="m35.36 27.976c0 2.1681 1.3595 3.9256 3.0365 3.9256 1.6769 0 3.0363-1.7575 3.0363-3.9256 0-0.49353-0.07363-0.96388-0.20245-1.3989-1.0776-1.2427-2.4154-2.0929-3.7004-2.0929-0.20781 0-0.40262 0.01979-0.59151 0.04876-0.94043 0.66701-1.5784 1.9584-1.5784 3.4433"/>
+  <path d="m38.898 26.999c0 0.83888-0.56365 1.5189-1.2585 1.5189-0.69545 0-1.2585-0.68007-1.2585-1.5189 0-0.83869 0.56308-1.5189 1.2585-1.5189 0.69485 0 1.2585 0.68026 1.2585 1.5189" fill="#fff"/>
+  <path d="m30.419 53.994 5.88e-4 -5.94e-4c-4.01e-4 -3.8e-4 -5.88e-4 -3.8e-4 -5.88e-4 -3.8e-4z" fill="#231e1f"/>
+  <path d="m38.431 55.363c0.02134-0.01324 0.04419-0.02697 0.06666-0.04169l-0.28826-0.43106c-0.13737 0.09161-0.27199 0.17443-0.40562 0.25308l0.41985 0.04935s0.07659 0.06156 0.20728 0.1702" fill="#231e1f"/>
+  <path d="m30.85 54.326 0.60012 0.07114-0.13199-0.01538z" fill="#f6bd6d"/>
+  <path d="m45.865 28.395c0.3217 0.16387 1.6621 0.85551 3.3387 1.855-0.32831-2.0574-2.7094-4.6384-4.1239-5.9001-0.49477-0.44429-0.88855-0.56548-1.1968-0.56648-0.30788-9.74e-4 -0.55706 0.12757-0.73492 0.2627-0.13069 0.09926-0.21101 0.19285-0.24502 0.23564l-0.0273 0.0593c1.3328 1.207 2.2998 2.6851 2.9893 4.0538" fill="#f6bd6d"/>
+  <path d="m43.473 48.903s-3.0363-2.5159-6.94-1.3012c0 0 5.2058-0.17365 5.8126 1.7346z"/>
+ </g>
+ <path d="m29.333 1.9262c0 0.45507-0.36899 0.82426-0.82426 0.82426-0.45488 0-0.82406-0.36919-0.82406-0.82426 0-0.4549 0.36918-0.82408 0.82406-0.82408 0.45528 0 0.82426 0.36919 0.82426 0.82408z" fill="#5f122b" stroke="#000" stroke-width=".5"/>
+ <path d="m53.798 16.674c0 0.45509-0.36895 0.82426-0.82386 0.82426-0.45509 0-0.82404-0.36917-0.82404-0.82426 0-0.45489 0.36895-0.82408 0.82404-0.82408 0.45489 0 0.82386 0.36921 0.82386 0.82408z" fill="#5f122b" stroke="#000" stroke-width=".5"/>
+ <g stroke-width="1.85">
+  <path d="m39.569 55.852c0-0.42647-0.31306-0.77261-0.69946-0.77261-0.25789 0-0.48034 0.1555-0.60191 0.38479-1.1892 0.74477-2.289 1.043-3.262 1.043h-0.0055c-2.1022-0.0095-3.5452-1.3058-4.1935-2.0326l0.02705-0.25708-0.42303 0.16233-0.55285 0.29284-0.17914 0.11418-0.09747 0.48776 0.14329 0.28984-0.01597 0.01977c0.24504 0.26404 0.65959 0.67262 1.2301 1.0865 0.95464 0.69285 2.3138 1.3775 3.9467 1.3765 1.2081-0.0012 2.576-0.27003 4.0751-1.316 0.34152-0.05143 0.60992-0.48715 0.60992-0.87852" fill="#fff"/>
+  <path d="m58.708 41.37c-0.25922 2.7573-1.6164 4.4382-3.614 5.5281-1.9997 1.0833-4.6563 1.5179-7.3844 1.6241-2.7467 0.11303-4.9337 0.10518-6.6318 0.93983-1.6892 0.8337-2.7501 2.5212-3.212 5.6898l-0.06078-0.0076c-1.0466 0.61434-1.9816 0.84165-2.8041 0.84269-1.2944 0-2.3303-0.56587-3.0498-1.1424-0.19199-0.15338-0.35756-0.30585-0.50036-0.44767l-0.60012-0.07077 0.4681 0.05507 0.13201 0.01538c-0.04981-0.04972-0.08785-0.09332-0.13201-0.13922v-4.3994c-0.03133-0.03248 0.07525-4.1959-1.8236-5.7345-1.6613-1.28-2.9075-2.8379-3.6366-4.8075-0.4-1.0839-0.58487-2.1442-0.58487-3.171 0-2.7991 1.3775-5.3766 3.6377-7.427 0.77298-0.70749 1.7547-1.7321 2.5987-2.1053l0.10015-0.04496 0.05463-0.09601c0-0.0011 0.128-0.22682 0.39019-0.58389 0.78719-1.0817 2.7164-3.202 5.4461-3.1915 0.74732 0 1.5638 0.15377 2.4546 0.53562 2.6259 1.1225 4.4097 3.4633 5.5281 5.5429 1.1197 2.0756 1.8868 3.7744 1.893 3.7754-0.0082-0.0095-0.29166-1.404-1.0582-3.1784 0.95145 0.50397 3.4967 1.9044 6.05 3.7498 3.2342 2.3127 6.3895 5.3834 6.3515 7.9512 0 0.09887-0.0027 0.19818-0.01052 0.29667m-19.427 14.907c-0.03213 0.08547-0.07873 0.16292-0.13525 0.22467-0.29623 0.3209-0.75013 0.50619-1.1361 0.69285-0.66682 0.3217-1.318 0.63077-2.0539 0.75498-0.35134 0.0591-0.7155 0.09755-1.0724 0.0983-1.6327 9.74e-4 -2.9919-0.68366-3.9467-1.3765-0.54741-0.3972-0.94683-0.78597-1.1952-1.0502-0.0027-0.01324-0.0055-0.02409-0.0082-0.03616-0.21103-0.81525 0.76895-1.0873 1.0394-1.1464 0.63158 0.71951 2.0896 2.0598 4.2318 2.07 0.94944 0 1.9083-0.27504 2.734-0.73655 0.26189-0.14572 0.54905-0.30346 0.78019-0.49555 0.04578-0.03827 0.29545 0.09906 0.33609 0.12144 0.13149 0.0717 0.25468 0.16541 0.35314 0.27921 0.14247 0.16311 0.14701 0.40207 0.0726 0.60033m3.6205-31.994c0.03402-0.04282 0.11433-0.13614 0.24504-0.23564 0.17809-0.13519 0.42704-0.2638 0.73511-0.26272 0.3081 9.74e-4 0.70209 0.1222 1.1966 0.56648 1.4145 1.2618 3.7955 3.8427 4.1239 5.9001-1.6763-0.99953-3.0168-1.6908-3.3387-1.855-0.68964-1.3687-1.6565-2.8468-2.9893-4.0538zm9.8631 8.2904c-1.0035-0.72451-2.0465-1.4002-3.0118-1.9901-0.13844-2.4607-2.8065-5.2245-4.3257-6.6187-0.55925-0.50737-1.0882-0.7029-1.5454-0.70068-0.87131 0.0095-1.347 0.64239-1.4125 0.72769-0.66383-0.54261-1.4085-1.018-2.2474-1.3819-0.96768-0.41503-1.8796-0.59029-2.7216-0.59029-3.7678 0.0268-5.9808 3.4024-6.3645 4.0216-1.0053 0.49577-1.9507 1.5197-2.6803 2.1764-2.3643 2.1431-3.8594 4.898-3.8594 7.9279 0 1.1087 0.20112 2.2504 0.62675 3.4054 0.77557 2.0998 2.1151 3.7696 3.8582 5.1096 0.71607 0.53324 1.1558 1.8376 1.3539 3.0119 0.20539 1.1712 0.20432 2.1836 0.2062 2.1864v4.0747c-1.8818 0.20794-1.3995 1.8952-1.3995 1.8952l0.03213 0.05089c-0.0012 4.19e-4 -0.0025 8e-4 -0.0027 0.0012 0.659 0.72411 2.697 2.6776 5.6126 2.6875h0.0055c1.4101 0 3.0111-0.49337 4.7089-1.7739 0.11406-0.06236 0.21904-0.15873 0.21904-0.15873l0.0027-0.0056c0.01052-0.0076 0.02134-0.01324 0.03163-0.02409-0.0027-0.0019-0.0082-0.0076-0.01052-0.0095l0.0055-0.0095s0.44286-1.559-1.2347-1.8208c0.48852-2.7443 1.4065-4.0148 2.7652-4.6948 1.4681-0.73814 3.5968-0.76698 6.358-0.87037 2.7804-0.11168 5.5255-0.54321 7.6791-1.7058 2.1558-1.1544 3.7047-3.0958 3.9659-6.0624 0.01052-0.12048 0.01577-0.23886 0.01577-0.35715-0.03616-3.0881-3.3732-6.123-6.6309-8.4998"/>
+  <path d="m44.786 62.958c-0.65221-2.1492-3.2091-4.7709-4.9337-6.353-1.7933 1.429-3.4831 1.9627-4.9638 1.9627h-0.0055c-2.9157-0.0095-4.9535-1.9636-5.6124-2.6875-3.6351 1.6521-5.46 5.976-5.8751 7.0778z" fill="#c7584d"/>
+  <path d="m23.683 62.936c0.19361-0.49899 0.60392-1.4615 1.2593-2.5406 0.92701-1.5287 2.3381-3.2646 4.2689-4.2007 0.79161 0.82909 2.8082 2.6169 5.672 2.632h0.0055c1.4945 9.74e-4 3.1837-0.524 4.9505-1.8817 1.6822 1.5513 4.0342 4.034 4.6724 5.991h0.5381c-0.66982-2.2766-3.274-4.9092-5.0214-6.5243l-0.16385-0.1503-0.17484 0.13883c-1.7561 1.3986-3.3832 1.9053-4.801 1.9063h-0.0055c-2.7917-0.0056-4.7831-1.8987-5.4197-2.6023l-0.12853-0.14037-0.17219 0.07764c-3.8397 1.7612-5.6654 6.294-6.0354 7.2943z"/>
+ </g>
+ <g fill="#fff">
+  <path d="m84.72 46.444q3.5027 0.64133 5.624 2.516 2.1707 1.8747 2.1707 5.7227 0 5.328-3.7493 7.5973-3.7493 2.22-10.508 2.22h-10.261v-34.089h8.9293q14.109 0 14.109 8.6827 0 3.0093-1.8253 4.9333-1.8253 1.8747-4.4893 2.4173zm-10.212-11.248v9.2253h3.996q2.7133 0 4.292-1.184 1.5787-1.2333 1.5787-3.6013 0-2.4667-1.6773-3.4533-1.628-0.98667-5.1307-0.98667zm3.7987 24.42q3.6013 0 5.476-1.0853 1.924-1.0853 1.924-4.0947 0-2.9107-1.8253-4.1933-1.776-1.2827-4.884-1.2827h-4.4893v10.656z"/>
+  <path d="m118.71 64.5h-5.476l-0.34533-3.6507q-1.48 2.22-3.404 3.3053t-4.588 1.0853q-3.5027 0-5.3773-2.1213-1.8747-2.1707-1.8747-5.9693v-18.747h6.3147v17.957q0 2.2693 0.74 3.2067 0.74 0.888 2.4173 0.888 3.108 0 5.2787-3.7v-18.352h6.3147z"/>
+  <path d="m148.9 39.784q-2.516 0.888-7.548 0.888 2.4173 1.0853 3.552 2.7133 1.184 1.5787 1.184 3.996 0 2.5653-1.2827 4.5387-1.2333 1.9733-3.6507 3.108-2.368 1.1347-5.5747 1.1347-1.776 0-3.108-0.39467-1.0853 0.74-1.0853 1.924 0 1.8253 3.1573 1.8253h3.996q2.8613 0 4.9827 0.93733 2.1707 0.93733 3.3547 2.664 1.184 1.6773 1.184 3.7987 0 3.9467-3.3547 6.1173-3.3547 2.22-9.6693 2.22-4.5387 0-7.1533-0.93733-2.5653-0.93733-3.6507-2.7133t-1.0853-4.5387h5.6733q0 1.3813 0.49333 2.1707 0.54267 0.78933 1.8747 1.184 1.3813 0.39467 3.9467 0.39467 3.6013 0 5.0813-0.888t1.48-2.5653q0-1.48-1.1347-2.3187-1.1347-0.78933-3.3053-0.78933h-3.9467q-3.7 0-5.5747-1.4307t-1.8747-3.6013q0-1.3813 0.78933-2.664 0.83867-1.2827 2.2693-2.1707-2.368-1.2333-3.5027-3.0093-1.0853-1.8253-1.0853-4.3413 0-2.812 1.3813-4.9333t3.7987-3.256q2.4667-1.184 5.624-1.184 4.144 0.09867 6.66-0.592 2.5653-0.74 5.5253-2.3187zm-13.665 2.1707q-2.1213 0-3.3547 1.3813-1.184 1.332-1.184 3.6013 0 2.368 1.2333 3.7493t3.404 1.3813q2.2693 0 3.4533-1.332 1.184-1.3813 1.184-3.848 0-4.9333-4.736-4.9333z"/>
+  <path d="m169.52 42.941-12.629 16.625h12.876l-0.64134 4.9333h-19.487v-4.5387l12.679-16.625h-11.593v-4.9333h18.796z"/>
+  <path d="m180.67 64.5h-6.3147v-26.097h6.3147zm-3.2067-39.319q1.776 0 2.8613 1.1347 1.1347 1.0853 1.1347 2.7133t-1.1347 2.7133q-1.0853 1.0853-2.8613 1.0853-1.7267 0-2.8613-1.0853-1.0853-1.0853-1.0853-2.7133t1.0853-2.7133q1.1347-1.1347 2.8613-1.1347z"/>
+  <path d="m194.14 65.24q-3.0093 0-4.6867-1.7267-1.6773-1.776-1.6773-4.9827v-30.587l6.3147-0.69067v31.08q0 0.93733 0.34533 1.3813 0.34534 0.444 1.1347 0.444t1.4307-0.24667l1.3813 4.44q-1.9733 0.888-4.2427 0.888z"/>
+  <path d="m208.79 65.24q-3.0093 0-4.6867-1.7267-1.6773-1.776-1.6773-4.9827v-30.587l6.3147-0.69067v31.08q0 0.93733 0.34534 1.3813 0.34533 0.444 1.1347 0.444 0.78934 0 1.4307-0.24667l1.3813 4.44q-1.9733 0.888-4.2427 0.888z"/>
+  <path d="m236.52 57.593q0 1.5293 0.444 2.2693 0.49333 0.69067 1.5293 1.0853l-1.332 4.1933q-2.22-0.19733-3.6507-1.0853-1.3813-0.888-2.1213-2.7133-1.332 1.9733-3.3547 2.96-1.9733 0.93733-4.44 0.93733-3.8973 0-6.1667-2.22-2.2693-2.22-2.2693-5.8213 0-4.2427 3.0587-6.4627 3.108-2.2693 8.8307-2.2693h3.256v-1.48q0-2.516-1.184-3.5027-1.1347-1.036-3.7-1.036-2.8613 0-6.9067 1.3813l-1.48-4.292q4.884-1.8747 9.472-1.8747 10.015 0 10.015 8.9787zm-11.248 3.0587q3.2067 0 5.032-3.2067v-5.2787h-2.6147q-6.1173 0-6.1173 4.5387 0 1.8747 0.93733 2.9107t2.7627 1.036z"/>
+ </g>
+ <path d="m34.664 23.049c2.4053-4.7231 8.3249-13.622 17.966-6.7529" fill="none" stroke="#000" stroke-width=".7"/>
+ <path d="m33.66 23.667c1.8691-8.1031 5.4653-19.196-4.3232-21.654" fill="none" stroke="#000" stroke-width=".7"/>
+</svg>
\ No newline at end of file
diff --git a/docs/en/rst/_static/bugzilla.css b/docs/en/rst/_static/bugzilla.css
index 06f5c83752..8d1132f245 100644
--- a/docs/en/rst/_static/bugzilla.css
+++ b/docs/en/rst/_static/bugzilla.css
@@ -1,21 +1,5 @@
-@import 'default.css';
-
-dt { font-weight: bold; }
-
-/* Custom roles */
-.param    { font-weight: bold; }
-.paramval { font-family: monospace; }
-.group    { font-family: monospace; }
-.field    { font-weight: bold; }
-.command  { font-family: monospace; font-size: 130% }
-
-.admonition-todo {
-  background-color: lightpink;
-  border: 2px darkred solid;
-}
-
-/* Make Buggie's antenna not take up so much space */
-.logo {
-  display: block;
-  margin-top: -20px;
+.wy-side-nav-search .wy-dropdown > a img.logo,
+.wy-side-nav-search > a img.logo {
+  min-width: 150px;
+  width: 350px;
 }
diff --git a/docs/en/rst/conf.py b/docs/en/rst/conf.py
index b2bf9ec5e5..9169cb648f 100644
--- a/docs/en/rst/conf.py
+++ b/docs/en/rst/conf.py
@@ -128,12 +128,31 @@ them `here <https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&componen
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+html_theme_options = {
+    #'analytics_id': 'G-XXXXXXXXXX',  #  Provided by Google in your dashboard
+    #'analytics_anonymize_ip': False,
+    'logo_only': True,
+    'display_version': True,
+    'prev_next_buttons_location': 'bottom',
+    'style_external_links': False,
+    'vcs_pageview_mode': '',
+    #'style_nav_header_background': 'white',
+    # Toc options
+    'collapse_navigation': True,
+    'sticky_navigation': True,
+    'navigation_depth': 4,
+    'includehidden': True,
+    'titles_only': False
+}
+
+html_css_files = [
+    "bugzilla.css"
+]
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
@@ -145,11 +164,11 @@ html_theme = 'default'
 # A shorter title for the navigation bar.  Default is the same as html_title.
 #html_short_title = None
 
-html_style = "bugzilla.css"
+#html_style = "bugzilla.css"
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-html_logo = "../images/bugzilla.png"
+html_logo = "../images/bugzilla-logo-white.svg"
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000000..4f1d8b9c9e
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,3 @@
+sphinx==5.3.0
+sphinx_rtd_theme==1.3.0
+readthedocs-sphinx-search==0.3.1
-- 
2.47.3