DOC - Update kitchen sink pages (#2190)

drammock · web-flow · commit 400fdc1c1fe7 · 2025-05-01T15:27:01.000+01:00
closes #2038
diff --git a/docs/examples/kitchen-sink/admonitions.rst b/docs/examples/kitchen-sink/admonitions.rst
@@ -17,114 +17,149 @@ Sphinx provides several different types of admonitions.
    This is what admonitions are a special case of, according to the docutils
    documentation.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``admonition``
 ==============
 
 .. admonition:: The one with the custom titles
 
    It's got a certain charm to it.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``attention``
 =============
 
 .. attention::
 
    Climate change is real.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``caution``
 ===========
 
 .. caution::
 
    Cliff ahead: Don't drive off it.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``danger``
 ==========
 
 .. danger::
 
    Mad scientist at work!
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``error``
 =========
 
 .. error::
 
    Does not compute.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``hint``
 ========
 
 .. hint::
 
    Insulators insulate, until they are subject to ______ voltage.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``important``
 =============
 
 .. important::
 
    Tech is not neutral, nor is it apolitical.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``note``
 ========
 
 .. note::
 
    This is a note.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``seealso``
 ===========
 
 .. seealso::
 
    Other relevant information.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``tip``
 =======
 
 .. tip::
 
    25% if the service is good.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``todo``
 ========
 
 .. todo::
 
    This needs the ``sphinx.ext.todo`` extension.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``warning``
 ===========
 
 .. warning::
 
    Reader discretion is strongly advised.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``versionadded``
 ================
 
 .. versionadded:: v0.1.1
 
    Here's a version added message.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``versionchanged``
 ==================
 
 .. versionchanged:: v0.1.1
 
    Here's a version changed message.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
 ``deprecated``
 ==============
 
 .. deprecated:: v0.1.1
 
    Here's a deprecation message.
 
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
+
+
 ``versionremoved``
 ==================
 
 .. versionremoved:: v0.1.1
 
    Here's a version removed message.
+
+   We also support *italic*, **bold**, ``code``, `links <https://www.sphinx-doc.org/en/master/>`_, and more.
diff --git a/docs/examples/kitchen-sink/generic.rst b/docs/examples/kitchen-sink/generic.rst
@@ -3,7 +3,7 @@
    Licensed under Creative Commons Attribution-ShareAlike 4.0 International License
    SPDX-License-Identifier: CC-BY-SA-4.0
 
-.. |EXAMPLE| image:: https://source.unsplash.com/32x32/daily?icon
+.. |EXAMPLE| image:: https://picsum.photos/16/16
     :width: 1em
 
 =============
@@ -28,9 +28,9 @@ a :sup:`superscript`, :emphasis:`emphasis`, :strong:`strong`, and
 Hyperlinks
 ----------
 
-It is a website, so it'll have hyperlinks like http://www.python.org (inline),
+It is a website, so it'll have hyperlinks like https://www.python.org/ (inline),
 or Python_ (external reference), example_ (internal reference),
-`Python web site <http://www.python.org>`__ (external hyperlinks with embedded
+`Python web site <https://www.python.org/>`__ (external hyperlinks with embedded
 URI), footnote references (manually numbered [1]_, anonymous auto-numbered [#]_,
 labeled auto-numbered [#label]_, or symbolic [*]_), citation references ([12]_),
 substitution references (|example|), and _`inline hyperlink targets`
@@ -110,7 +110,7 @@ Sidebar
 
     Lorem ipsum dolor sit amet consectetur adipisicing elit.
 
-    .. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+    .. image:: https://picsum.photos/200/200
 
     Lorem ipsum dolor sit amet consectetur adipisicing elit.
 
@@ -199,7 +199,7 @@ Targets_.
 
 Explicit external targets are interpolated into references such as "Python_".
 
-.. _Python: http://www.python.org/
+.. _Python: https://www.python.org/
 
 Targets may be indirect and anonymous.  Thus `this phrase`__ may also
 refer to the Targets_ section.
@@ -268,4 +268,4 @@ voluptatem officia culpa optio atque. Quaerat sed quibusdam ratione nam.
 Download Links
 ==============
 
-:download:`This long long long long long long long long long long long long long long long download link should wrap white-spaces <https://source.unsplash.com/200x200/daily?cute+puppy>`
+:download:`This long long long long long long long long long long long long long long long download link should wrap white-spaces <https://picsum.photos/200/200>`
diff --git a/docs/examples/kitchen-sink/images.rst b/docs/examples/kitchen-sink/images.rst
@@ -12,18 +12,18 @@ Images
 
 An image:
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://picsum.photos/200/200
    :height: 200
    :width: 200
 
 A clickable image:
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
-   :target: https://unsplash.com/
+.. image:: https://picsum.photos/200/200
+   :target: https://picsum.photos/
    :height: 200
    :width: 200
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://picsum.photos/200/200
    :align: right
    :height: 200
    :width: 200
@@ -43,7 +43,7 @@ sapiente veritatis doloribus accusantium molestiae modi recusandae
 excepturi facere, corrupti expedita sit nihil temporibus eius sequi
 animi, illo libero labore fuga.
 
-.. image:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. image:: https://picsum.photos/200/200
    :align: left
    :height: 200
    :width: 200
@@ -66,7 +66,7 @@ animi, illo libero labore fuga.
 Figures
 -------
 
-.. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. figure:: https://picsum.photos/200/200
    :alt: reStructuredText, the markup syntax
 
    A figure is an image with a caption and/or a legend:
@@ -83,7 +83,7 @@ Figures
 
 A figure directive with center alignment
 
-.. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. figure:: https://picsum.photos/200/200
    :align: center
 
    This caption should be centered.
diff --git a/docs/examples/kitchen-sink/index.rst b/docs/examples/kitchen-sink/index.rst
@@ -8,7 +8,9 @@ Kitchen Sink
 
 .. note::
 
-   The Kitchen Sink was generated from the `Sphinx Themes website <https://sphinx-themes.org/>`_, a community-supported showcase of themes for `Sphinx <https://www.sphinx-doc.org/>`_.
+   The Kitchen Sink was generated from the
+   `Sphinx Themes website <https://sphinx-themes.org/>`_, a community-supported showcase
+   of themes for `Sphinx <https://www.sphinx-doc.org/>`_.
    Check it out to see other great themes.
 
    .. button-link:: https://sphinx-themes.org
diff --git a/docs/examples/kitchen-sink/lists.rst b/docs/examples/kitchen-sink/lists.rst
@@ -105,7 +105,7 @@ Field list
 Glossary
 --------
 
-This is a glossary with definition terms for thing like :term:`Writing`:
+This is a glossary with definition terms for things like :term:`Writing`:
 
 .. glossary::
 
@@ -174,9 +174,9 @@ Complex
 
   * Nested item 3.
 
-- ``inline literall``
-- ``inline literall``
-- ``inline literall``
+- ``inline literal``
+- ``inline literal``
+- ``inline literal``
 - This item has multiple paragraphs.
 
   This item has multiple paragraphs.
@@ -189,13 +189,13 @@ Second list level
 ^^^^^^^^^^^^^^^^^
 
 - here is a list in a second-level section.
-- `yahoo <http://www.yahoo.com>`_
-- `yahoo <http://www.yahoo.com>`_
+- `yahoo <https://www.yahoo.com/>`_
+- `yahoo <https://www.yahoo.com/>`_
 
-  - `yahoo <http://www.yahoo.com>`_
+  - `yahoo <https://www.yahoo.com/>`_
   - here is an inner bullet ``oh``
 
-    - one more ``with an inline literally``. `yahoo <http://www.yahoo.com>`_
+    - one more ``with an inline literally``. `yahoo <https://www.yahoo.com/>`_
 
       heh heh. child. try to beat this embed:
 
@@ -204,8 +204,8 @@ Second list level
           :linenos:
           :lines: 10-20
 
-  - and another. `yahoo <http://www.yahoo.com>`_
-  - `yahoo <http://www.yahoo.com>`_
+  - and another. `yahoo <https://www.yahoo.com/>`_
+  - `yahoo <https://www.yahoo.com/>`_
   - ``hi``
 - how about an admonition?
 
@@ -217,15 +217,15 @@ Second list level
 But deeper down the rabbit hole
 """""""""""""""""""""""""""""""
 
-- I kept saying that, "deeper down the rabbit hole". `yahoo <http://www.yahoo.com>`_
+- I kept saying that, "deeper down the rabbit hole". `yahoo <https://www.yahoo.com/>`_
 
-  - I cackle at night `yahoo <http://www.yahoo.com>`_.
+  - I cackle at night `yahoo <https://www.yahoo.com/>`_.
 - I'm so lonely here in GZ ``guangzhou``
-- A man of python destiny, hopes and dreams. `yahoo <http://www.yahoo.com>`_
+- A man of python destiny, hopes and dreams. `yahoo <https://www.yahoo.com/>`_
 
-  - `yahoo <http://www.yahoo.com>`_
+  - `yahoo <https://www.yahoo.com/>`_
 
-    - `yahoo <http://www.yahoo.com>`_ ``hi``
+    - `yahoo <https://www.yahoo.com/>`_ ``hi``
     - ``destiny``
 
 Hlists
@@ -237,20 +237,20 @@ Hlists
     - First item
     - Second item
     - Third item
-    - Forth item
+    - Fourth item
     - Fifth item
-    - Sixths item
+    - Sixth item
 
 .. rubric:: Hlist with images
 
 .. hlist::
     :columns: 2
 
-    - .. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+    - .. figure:: https://picsum.photos/200/200
 
          This is a short caption for a figure.
 
-    - .. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+    - .. figure:: https://picsum.photos/200/200
 
          This is a long caption for a figure. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
          Donec porttitor dolor in odio posuere, vitae ornare libero mattis. In lobortis justo vestibulum nibh aliquet, non.
diff --git a/docs/examples/kitchen-sink/structure.rst b/docs/examples/kitchen-sink/structure.rst
@@ -83,7 +83,7 @@ luctus efficitur arcu. Cras ut dictum mi. Nulla congue interdum lorem, semper se
 Document Subsection
 -------------------
 
-.. figure:: https://source.unsplash.com/200x200/daily?cute+puppy
+.. figure:: https://picsum.photos/200/200
     :align: right
     :figwidth: 200px
 
diff --git a/docs/examples/kitchen-sink/tables.rst b/docs/examples/kitchen-sink/tables.rst
diff --git a/docs/examples/kitchen-sink/typography.rst b/docs/examples/kitchen-sink/typography.rst
diff --git a/docs/scripts/update_kitchen_sink.py b/docs/scripts/update_kitchen_sink.py
