Use sphinx-design dropdown instead of custom toggle class

docs/conf.py

@@ -159,9 +159,7 @@
 html_static_path = ['_static']
 html_favicon = join('_static', 'favicon.ico')
 html_logo = join('_static', 'pyinaturalist_logo.png')
-html_js_files = ['collapsible_container.js']
 html_css_files = [
-    'collapsible_container.css',
     'colors.css',
     'table.css',
     'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.1.1/css/all.min.css',

docs/examples.md

@@ -44,8 +44,7 @@ TODO: Can't generate thumbnails for Altair visualizations
     :end-line: 6
 ```
 
-:::{admonition} Example code
-:class: toggle
+:::{dropdown} Example code
 
 ```{literalinclude} ../examples/observations_to_gpx.py
 :lines: 1,8-
@@ -59,8 +58,7 @@ TODO: Can't generate thumbnails for Altair visualizations
     :end-line: 17
 ```
 
-:::{admonition} Example code
-:class: toggle
+:::{dropdown} Example code
 
 ```{literalinclude} ../examples/observation_photo_metadata.py
 :lines: 1,19-

docs/user_guide/advanced.md

@@ -30,8 +30,8 @@ you will need to use an access token.
 3. Pass that access token to any API request function that uses it
 
 ### Creating an Application
-:::{admonition} Why do I need to create an application?
-:class: toggle, tip
+:::{dropdown} Why do I need to create an application?
+:icon: info
 
 iNaturalist uses OAuth2, which provides several different methods (or "flows") to access the site.
 For example, on the [login page](https://www.inaturalist.org/login), you have the option of logging

docs/user_guide/general.md

@@ -28,8 +28,8 @@ See {ref}`contributing` for details on setup for local development.
 :::
 ::::
 
-:::{admonition} Python version compatibility
-:class: toggle, tip
+:::{dropdown} Python version compatibility
+:icon: info
 
 pyinaturalist currently requires **python 3.7+**. If you need to use an older version
 of python, here are the last compatible versions of pyinaturalist:
@@ -101,8 +101,8 @@ iNaturalist.org:
 ```
 
 And here is what that same observation looks like in JSON:
-:::{admonition} Observation response JSON
-:class: toggle
+:::{dropdown} Observation response JSON
+:icon: code-square
 ```{literalinclude} ../sample_data/get_observation_2.json
 ```
 :::

pyinaturalist/v0/observation_fields.py

@@ -24,8 +24,9 @@ def get_observation_fields(**params) -> JsonResponse:
         >>> from pprint import pprint
         >>> pprint({r['id']: r['name'] for r in response})
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observation_fields.py
 
@@ -75,8 +76,9 @@ def put_observation_field_values(
         ...     access_token=token,
         ... )
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/post_put_observation_field_value.json
                 :language: javascript

pyinaturalist/v0/observations.py

@@ -35,37 +35,43 @@ def get_observations(**params) -> Union[List, str]:
 
         >>> get_observations(id=45414404, converters='atom')
 
-        .. admonition:: Example Response (atom)
-            :class: toggle
+        .. dropdown:: Example Response (atom)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.atom
                 :language: xml
 
-        .. admonition:: Example Response (csv)
-            :class: toggle
+        .. dropdown:: Example Response (csv)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.csv
 
-        .. admonition:: Example Response (dwc)
-            :class: toggle
+        .. dropdown:: Example Response (dwc)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.dwc
                 :language: xml
 
-        .. admonition:: Example Response (json)
-            :class: toggle
+        .. dropdown:: Example Response (json)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.json
                 :language: json
 
-        .. admonition:: Example Response (kml)
-            :class: toggle
+        .. dropdown:: Example Response (kml)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.kml
                 :language: xml
 
-        .. admonition:: Example Response (widget)
-            :class: toggle
+        .. dropdown:: Example Response (widget)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_observations.js
                 :language: javascript
@@ -106,14 +112,16 @@ def create_observation(**params) -> ListResponse:
         >>>     observation_fields={297: 1},  # 297 is the obs. field ID for 'Number of individuals'
         >>> )
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/create_observation_result.json
                 :language: javascript
 
-        .. admonition:: Example Response (failure)
-            :class: toggle
+        .. dropdown:: Example Response (failure)
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/create_observation_fail.json
                 :language: javascript
@@ -171,8 +179,9 @@ def update_observation(observation_id: int, **params) -> ListResponse:
         >>>     description='updated description!',
         >>> )
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/update_observation_result.json
                 :language: javascript
@@ -218,8 +227,9 @@ def upload_photos(observation_id: int, photos: MultiFile, **params) -> ListRespo
         >>>     access_token=token,
         >>> )
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/post_observation_photos_list.json
                 :language: javascript
@@ -261,8 +271,9 @@ def upload_sounds(observation_id: int, sounds: MultiFile, **params) -> ListRespo
         >>> token = get_access_token()
         >>> upload_sounds(1234, '~/observations/2020_09_01_14003156.mp3', access_token=token)
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/post_observation_sounds_list.json
                 :language: javascript

pyinaturalist/v1/controlled_terms.py

@@ -21,8 +21,9 @@ def get_controlled_terms(taxon_id: Optional[int] = None, **params) -> JsonRespon
             4: Pupa
         ...
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_controlled_terms.json
                 :language: JSON
@@ -53,8 +54,9 @@ def get_controlled_terms_for_taxon(taxon_id: int, **params) -> JsonResponse:
             4: Pupa
         ...
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_controlled_terms_for_taxon.json
                 :language: JSON

pyinaturalist/v1/identifications.py

@@ -17,8 +17,9 @@ def get_identifications_by_id(identification_id: MultiInt, **params) -> JsonResp
     Example:
         >>> get_identifications_by_id(155554373)
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_identifications.py
 
@@ -52,8 +53,9 @@ def get_identifications(**params) -> JsonResponse:
         [147500725] Species: 1163860 (improving) added on 2020-12-24 23:52:30+00:00 by jkcook
         ...
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_identifications.py
 

pyinaturalist/v1/messages.py

@@ -22,8 +22,9 @@ def get_message_by_id(message_id: MultiInt, **params) -> JsonResponse:
         >>> response = get_messages(123456)
         >>> pprint(response)
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_messages.json
 
@@ -49,8 +50,9 @@ def get_messages(**params) -> JsonResponse:
         >>> response = get_messages()
         >>> pprint(response)
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/get_messages.json
 

pyinaturalist/v1/observation_fields.py

@@ -31,8 +31,9 @@ def set_observation_field(
         ...     access_token=token,
         ... )
 
-        .. admonition:: Example Response
-            :class: toggle
+        .. dropdown:: Example Response
+            :color: primary
+            :icon: code-square
 
             .. literalinclude:: ../sample_data/post_put_observation_field_value.json
                 :language: javascript