From ce443142209f4411e8349d472431a565608acbde Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Thu, 22 May 2025 18:35:48 +0200 Subject: [PATCH 01/18] draft changes to gallery and legacy recipes --- doc/sphinx/source/generate_gallery.py | 27 ++++++++++++++----- doc/sphinx/source/recipes/index.rst | 8 +++--- .../recipes/{ => legacy}/recipe_rainfarm.rst | 0 .../{ => legacy}/recipe_schlund20jgr.rst | 0 .../recipes/{ => legacy}/recipe_spei.rst | 0 doc/sphinx/source/recipes/recipe_gier20bg.rst | 1 + 6 files changed, 24 insertions(+), 12 deletions(-) rename doc/sphinx/source/recipes/{ => legacy}/recipe_rainfarm.rst (100%) rename doc/sphinx/source/recipes/{ => legacy}/recipe_schlund20jgr.rst (100%) rename doc/sphinx/source/recipes/{ => legacy}/recipe_spei.rst (100%) diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 6ee72601d2..dfc992d5c9 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -2,6 +2,7 @@ """Create gallery with all available recipes.""" import os +from pathlib import Path RECIPE_DIR = "recipes" OUT_PATH = os.path.abspath("gallery.rst") @@ -31,10 +32,14 @@ def _get_figure_index(file_content): """Get index of figure in text.""" + offset = 0 + if ".. gallery=True" in file_content: + offset = file_content.index(".. gallery=True") + 15 + file_content = file_content[offset:] if FIGURE_STR in file_content: - return file_content.index(FIGURE_STR) + len(FIGURE_STR) + return offset + file_content.index(FIGURE_STR) + len(FIGURE_STR) if IMAGE_STR in file_content: - return file_content.index(IMAGE_STR) + len(IMAGE_STR) + return offset + file_content.index(IMAGE_STR) + len(IMAGE_STR) raise ValueError("File does not contain image") @@ -79,6 +84,17 @@ def _get_next_row(filenames, file_contents): return (row, refs) +def _find_recipes(root_dir, exclude_dirs): + return [ + path.relative_to(root_dir) + for path in Path(root_dir).rglob("recipe_*.rst") + if not any( + path.parents[0].name.startswith(exclude) + for exclude in exclude_dirs + ) + ] + + def main(): """Generate gallery for recipe plots.""" print(f"Generating gallery at {OUT_PATH}") @@ -87,11 +103,8 @@ def main(): refs = "" filenames = [] file_contents = [] - for filename in sorted(os.listdir(RECIPE_DIR)): - if not filename.startswith("recipe_"): - continue - if not filename.endswith(".rst"): - continue + fnames = _find_recipes(RECIPE_DIR, ["legacy", "figures"]) + for filename in sorted(fnames): with open(os.path.join(RECIPE_DIR, filename)) as in_file: recipe_file = in_file.read() if FIGURE_STR not in recipe_file and IMAGE_STR not in recipe_file: diff --git a/doc/sphinx/source/recipes/index.rst b/doc/sphinx/source/recipes/index.rst index c1104fb97e..8260b5dd95 100644 --- a/doc/sphinx/source/recipes/index.rst +++ b/doc/sphinx/source/recipes/index.rst @@ -107,7 +107,6 @@ IPCC recipe_ipccwg1ar6ch3 recipe_ipccwg1ar5ch9 recipe_collins13ipcc - recipe_examples Land ^^^^ @@ -165,11 +164,10 @@ require a legacy version of ESMValTool to run. .. toctree:: - :maxdepth: 1 + :maxdepth: 2 + + legacy_recipe_list - recipe_rainfarm - recipe_schlund20jgr - recipe_spei Broken recipe list diff --git a/doc/sphinx/source/recipes/recipe_rainfarm.rst b/doc/sphinx/source/recipes/legacy/recipe_rainfarm.rst similarity index 100% rename from doc/sphinx/source/recipes/recipe_rainfarm.rst rename to doc/sphinx/source/recipes/legacy/recipe_rainfarm.rst diff --git a/doc/sphinx/source/recipes/recipe_schlund20jgr.rst b/doc/sphinx/source/recipes/legacy/recipe_schlund20jgr.rst similarity index 100% rename from doc/sphinx/source/recipes/recipe_schlund20jgr.rst rename to doc/sphinx/source/recipes/legacy/recipe_schlund20jgr.rst diff --git a/doc/sphinx/source/recipes/recipe_spei.rst b/doc/sphinx/source/recipes/legacy/recipe_spei.rst similarity index 100% rename from doc/sphinx/source/recipes/recipe_spei.rst rename to doc/sphinx/source/recipes/legacy/recipe_spei.rst diff --git a/doc/sphinx/source/recipes/recipe_gier20bg.rst b/doc/sphinx/source/recipes/recipe_gier20bg.rst index b8f8fb9b8e..443fda48db 100644 --- a/doc/sphinx/source/recipes/recipe_gier20bg.rst +++ b/doc/sphinx/source/recipes/recipe_gier20bg.rst @@ -193,6 +193,7 @@ Example plots Barplot of the growth rate, averaged over all years, with standard deviation of interannual variability. +.. gallery=True .. _fig_gier20bg_5: .. figure:: /recipes/figures/gier20bg/fig05.png :align: center From dc9ce254d7b928aadec675ec64827909ab530e08 Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Fri, 23 May 2025 10:12:29 +0200 Subject: [PATCH 02/18] add legacy recipe page --- doc/sphinx/source/recipes/legacy_recipe_list.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 doc/sphinx/source/recipes/legacy_recipe_list.rst diff --git a/doc/sphinx/source/recipes/legacy_recipe_list.rst b/doc/sphinx/source/recipes/legacy_recipe_list.rst new file mode 100644 index 0000000000..dc32ed8720 --- /dev/null +++ b/doc/sphinx/source/recipes/legacy_recipe_list.rst @@ -0,0 +1,15 @@ +.. _legacy_recipe_list: + +Legacy Recipes +============== + +Recipes that have been retired and are included for +documentation purposes only. Typically, these recipes +require a legacy version of ESMValTool to run. + +.. toctree:: + :maxdepth: 1 + + legacy/recipe_rainfarm + legacy/recipe_schlund20jgr + legacy/recipe_spei From fb0f11f4fd5f6b589eb1dc2ddf4f3b4ce4856282 Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Fri, 23 May 2025 11:20:24 +0200 Subject: [PATCH 03/18] fav image in better comment style --- doc/sphinx/source/generate_gallery.py | 4 ++-- doc/sphinx/source/recipes/recipe_gier20bg.rst | 3 ++- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index dfc992d5c9..59634161d6 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -33,8 +33,8 @@ def _get_figure_index(file_content): """Get index of figure in text.""" offset = 0 - if ".. gallery=True" in file_content: - offset = file_content.index(".. gallery=True") + 15 + if "gallery=True" in file_content: + offset = file_content.index("gallery=True") + 12 file_content = file_content[offset:] if FIGURE_STR in file_content: return offset + file_content.index(FIGURE_STR) + len(FIGURE_STR) diff --git a/doc/sphinx/source/recipes/recipe_gier20bg.rst b/doc/sphinx/source/recipes/recipe_gier20bg.rst index 443fda48db..7ead4b7b58 100644 --- a/doc/sphinx/source/recipes/recipe_gier20bg.rst +++ b/doc/sphinx/source/recipes/recipe_gier20bg.rst @@ -193,7 +193,8 @@ Example plots Barplot of the growth rate, averaged over all years, with standard deviation of interannual variability. -.. gallery=True +.. + gallery=True .. _fig_gier20bg_5: .. figure:: /recipes/figures/gier20bg/fig05.png :align: center From 720e999c0405a98c8a822bc14b01df315c784ac1 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Tue, 27 May 2025 12:32:14 +0200 Subject: [PATCH 04/18] docutils parser, html layout, multiple figures per recipe --- doc/sphinx/source/generate_gallery.py | 201 ++++++++++++-------------- 1 file changed, 92 insertions(+), 109 deletions(-) diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 59634161d6..7fe2301e4c 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -2,7 +2,12 @@ """Create gallery with all available recipes.""" import os +import html from pathlib import Path +from docutils.core import publish_doctree +from docutils import nodes + + RECIPE_DIR = "recipes" OUT_PATH = os.path.abspath("gallery.rst") @@ -16,72 +21,78 @@ "`_." "\n\n" ) -WIDTH = ":width: 90%" -FIGURE_STR = ".. figure::" -IMAGE_STR = " image:: " -TABLE_SEP = ( - "+---------------------------------------------------" - "+---------------------------------------------------+\n" +MAX_CAPTION_LENGTH = 300 + +START_GALLERY = ( + ".. raw:: html\n\n" + '
\n\n' ) -EMPTY_TABLE = ( - "| " - "| |\n" + +END_GALLERY = ( + '\n.. raw:: html\n\n' + '
\n\n' ) -CELL_WIDTH = 50 - - -def _get_figure_index(file_content): - """Get index of figure in text.""" - offset = 0 - if "gallery=True" in file_content: - offset = file_content.index("gallery=True") + 12 - file_content = file_content[offset:] - if FIGURE_STR in file_content: - return offset + file_content.index(FIGURE_STR) + len(FIGURE_STR) - if IMAGE_STR in file_content: - return offset + file_content.index(IMAGE_STR) + len(IMAGE_STR) - raise ValueError("File does not contain image") - - -def _get_next_row(filenames, file_contents): - """Get next row.""" - figure_idx = [_get_figure_index(content) for content in file_contents] - figure_paths = [ - file_contents[idx][fig_idx:].split("\n")[0].strip() - for (idx, fig_idx) in enumerate(figure_idx) - ] - subst = [f"|{os.path.splitext(filename)[0]}|" for filename in filenames] - link = [file_contents[0].split()[1][1:-1]] - if figure_paths[1] == "": - subst[1] = "" - link.append("") - else: - link.append(file_contents[1].split()[1][1:-1]) - - # Build table - row = "" - refs = "" - row += TABLE_SEP - row += f"| {subst[0].ljust(CELL_WIDTH)}| {subst[1].ljust(CELL_WIDTH)}|\n" - row += EMPTY_TABLE - left_col = "[#]_".ljust(CELL_WIDTH) - if figure_paths[1] == "": - right_col = "".ljust(CELL_WIDTH) - else: - right_col = "[#]_".ljust(CELL_WIDTH) - row += f"| {left_col}| {right_col}|\n" - - # Build refs - for idx, path in enumerate(figure_paths): - if path == "": - continue - refs += f".. {subst[idx]} image:: {path}\n" - refs += f" {WIDTH}\n" - refs += "\n" - refs += f".. [#] :ref:`{link[idx]}`\n" - refs += "\n" - - return (row, refs) + +FIGURE_HTML = ( + '.. figure:: {uri}\n' + ' :width: 90%\n\n' + ' :ref:`{caption} <{link}>`\n\n' +) + + +def _has_gallery_marker(node): + """Wether the node is preceeded by a ``.. gallery`` comment.""" + siblings = list(node.parent) + idx = siblings.index(node) + if idx <= 0: + return False + prev_node = siblings[idx - 1] + if not isinstance(prev_node, nodes.comment): + return False + return prev_node.astext().lower().strip().startswith("gallery") + + +def _is_excluded_from_gallery(node): + """Wether the node has a no-gallery marker.""" + comments = node.traverse(nodes.comment) + for comment in comments: + if comment.astext().lower().strip() == "no-gallery": + return True + return False + + +def _get_figures_from_file(fname): + """Get marked, no or first figure from documentation page.""" + with (Path(RECIPE_DIR)/fname).open() as f: + content = f.read() + tree = publish_doctree(content) + link = content.split("\n")[0].split(" ")[1][1:-1] # get link from first line + if _is_excluded_from_gallery(tree): # ignore files with no-gallery marker + return [] + figures = tree.traverse(nodes.figure) + for fig in figures: + fig["link"] = link # add doc page link to figure + marked_figures = [f for f in figures if _has_gallery_marker(f)] + if len(marked_figures) > 0: # consider all figures with gallery marker + return marked_figures + if len(figures) > 0: # select first figure if nothing is marked + return [figures[0]] + return [] + + +def _get_data_from_figure(figure): + image = figure.traverse(nodes.image)[0] + try: + caption = figure.traverse(nodes.caption)[0].astext().strip() + except IndexError: + caption = "No caption available" + if len(caption) > MAX_CAPTION_LENGTH: + caption = caption[:MAX_CAPTION_LENGTH] + "..." + return { + "uri": html.escape(image["uri"]), + "caption": html.escape(caption.replace("\n", " ")), + "link": html.escape(figure["link"]), + } def _find_recipes(root_dir, exclude_dirs): @@ -95,56 +106,28 @@ def _find_recipes(root_dir, exclude_dirs): ] +def _generate_rst_file(fname, data): + """Generate rst file from data.""" + output = "" + output += HEADER + output += START_GALLERY + for figure_data in data: + output += FIGURE_HTML.format(**figure_data) + output += END_GALLERY + with open(fname, "w") as f: + f.write(output) + print(f"Wrote {fname}") + + def main(): """Generate gallery for recipe plots.""" print(f"Generating gallery at {OUT_PATH}") - left_col = True - table = "" - refs = "" - filenames = [] - file_contents = [] + figures = [] fnames = _find_recipes(RECIPE_DIR, ["legacy", "figures"]) for filename in sorted(fnames): - with open(os.path.join(RECIPE_DIR, filename)) as in_file: - recipe_file = in_file.read() - if FIGURE_STR not in recipe_file and IMAGE_STR not in recipe_file: - print(f"INFO: {filename} does not contain an image, skipping") - continue - if not recipe_file.startswith(".."): - print( - f"INFO: {filename} does not contain reference at top, skipping" - ) - continue - - # Get next row - if left_col: - left_col = False - filenames = [filename] - file_contents = [recipe_file] - continue - else: - left_col = True - filenames.append(filename) - file_contents.append(recipe_file) - new_row = _get_next_row(filenames, file_contents) - table += new_row[0] - refs += new_row[1] - - # Last row - if len(filenames) == 1: - filenames.append("") - file_contents.append(f"{FIGURE_STR}\n") - new_row = _get_next_row(filenames, file_contents) - table += new_row[0] - refs += new_row[1] - table += TABLE_SEP - table += "\n" - - # Write file - whole_file = HEADER + table + refs - with open(OUT_PATH, "w") as out_file: - print(whole_file, file=out_file) - print(f"Wrote {OUT_PATH}") + figures.extend(_get_figures_from_file(filename)) + data = [_get_data_from_figure(f) for f in figures] + _generate_rst_file(OUT_PATH, data) if __name__ == "__main__": From ed6b9954833ba241eccb2ad0654dbaccf70a30a0 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Tue, 27 May 2025 14:10:56 +0200 Subject: [PATCH 05/18] skip recipes without label in first line --- doc/sphinx/source/generate_gallery.py | 28 +++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 7fe2301e4c..1d9146baee 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -1,13 +1,12 @@ #!/usr/bin/env python """Create gallery with all available recipes.""" -import os import html +import os from pathlib import Path -from docutils.core import publish_doctree -from docutils import nodes - +from docutils import nodes +from docutils.core import publish_doctree RECIPE_DIR = "recipes" OUT_PATH = os.path.abspath("gallery.rst") @@ -25,18 +24,15 @@ START_GALLERY = ( ".. raw:: html\n\n" - '
\n\n' + '
\n\n' ) -END_GALLERY = ( - '\n.. raw:: html\n\n' - '
\n\n' -) +END_GALLERY = "\n.. raw:: html\n\n
\n\n" FIGURE_HTML = ( - '.. figure:: {uri}\n' - ' :width: 90%\n\n' - ' :ref:`{caption} <{link}>`\n\n' + ".. figure:: {uri}\n :width: 90%\n\n :ref:`{caption} <{link}>`\n\n" ) @@ -63,10 +59,14 @@ def _is_excluded_from_gallery(node): def _get_figures_from_file(fname): """Get marked, no or first figure from documentation page.""" - with (Path(RECIPE_DIR)/fname).open() as f: + with (Path(RECIPE_DIR) / fname).open() as f: content = f.read() tree = publish_doctree(content) - link = content.split("\n")[0].split(" ")[1][1:-1] # get link from first line + try: + link = content.split("\n")[0].split(" ")[1][1:-1] + except IndexError: + print(f"No label found in first line of {fname}. Skipping") + return [] if _is_excluded_from_gallery(tree): # ignore files with no-gallery marker return [] figures = tree.traverse(nodes.figure) From d5a93b04c1a91c993b3e0104b01b1a7aa494cfa1 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Wed, 28 May 2025 11:14:03 +0200 Subject: [PATCH 06/18] improve look and feel, extra css file --- doc/sphinx/source/_static/custom.css | 31 +++++++++++++++++++++++++++ doc/sphinx/source/conf.py | 7 +++++- doc/sphinx/source/generate_gallery.py | 13 ++++------- 3 files changed, 41 insertions(+), 10 deletions(-) create mode 100644 doc/sphinx/source/_static/custom.css diff --git a/doc/sphinx/source/_static/custom.css b/doc/sphinx/source/_static/custom.css new file mode 100644 index 0000000000..5401a023fe --- /dev/null +++ b/doc/sphinx/source/_static/custom.css @@ -0,0 +1,31 @@ +.gallery { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(200px, 250px)); + gap: 1em; +} + +.gallery figure:hover { + background-color: var(--pst-color-surface); +} + +.gallery figure img { + max-height: 300px; + object-fit: cover; + overflow: hidden; +} + +.gallery figure figcaption { + color: var(--pst-color-text-muted); + line-height: 1.2; + text-decoration: none; +} + +.gallery figure figcaption a { + text-decoration: none; + color: var(--pst-color-text); +} + +.gallery figure figcaption a:hover { + text-decoration: underline; + color: var(--pst-color-link-hover); +} diff --git a/doc/sphinx/source/conf.py b/doc/sphinx/source/conf.py index de7feb4775..fb40b0b10f 100644 --- a/doc/sphinx/source/conf.py +++ b/doc/sphinx/source/conf.py @@ -197,7 +197,12 @@ # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ["figures/ESMValTool-logo-2-dark.png"] +html_static_path = [ + "figures/ESMValTool-logo-2-dark.png", + "_static", +] + +html_css_files = ["custom.css"] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 1d9146baee..9204058f58 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -14,25 +14,20 @@ ".. DO NOT MODIFY! THIS PAGE IS AUTOGENERATED!\n\n" "#######\nGallery\n#######\n\n" "This section shows example plots produced by ESMValTool. For more " - "information, click on the footnote below the image. " + "information, follow the links in the figure captions." "A website displaying results produced with the latest release of " "ESMValTool for all available recipes can be accessed `here " "`_." "\n\n" ) -MAX_CAPTION_LENGTH = 300 +MAX_CAPTION_LENGTH = 100 -START_GALLERY = ( - ".. raw:: html\n\n" - '
\n\n' -) +START_GALLERY = '.. raw:: html\n\n
\n\n' END_GALLERY = "\n.. raw:: html\n\n
\n\n" FIGURE_HTML = ( - ".. figure:: {uri}\n :width: 90%\n\n :ref:`{caption} <{link}>`\n\n" + ".. figure:: {uri}\n :width: 100%\n\n :ref:`{caption} <{link}>`\n\n" ) From 946c6762b12c0f3e7d161b69c81516cd274f4739 Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Wed, 28 May 2025 13:28:11 +0200 Subject: [PATCH 07/18] readd psyplot legacy --- .../source/recipes/legacy/recipe_psyplot.rst | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 doc/sphinx/source/recipes/legacy/recipe_psyplot.rst diff --git a/doc/sphinx/source/recipes/legacy/recipe_psyplot.rst b/doc/sphinx/source/recipes/legacy/recipe_psyplot.rst new file mode 100644 index 0000000000..7ab5f5077a --- /dev/null +++ b/doc/sphinx/source/recipes/legacy/recipe_psyplot.rst @@ -0,0 +1,70 @@ +.. _recipes_psyplot_diag: + +Legacy recipe: Psyplot Diagnostics +================================== + +.. note:: + + This recipe has been retired and moved to the folder "archive". This recipe is only included + for documentation purposes and not maintained any more. The last known ESMValTool version + supporting this recipe is version 2.12.0. + +Overview +-------- + +These recipes showcase the use of the Psyplot diagnostic that provides a +high-level interface to `Psyplot `__ for ESMValTool +recipes. + + +Available recipes and diagnostics +--------------------------------- + +Recipes are stored in recipes/ + + * recipe_psyplot.yml + +Diagnostics are stored in archive/legacy_diag_scripts + + * psyplot_diag.py + + +Variables +--------- + +Arbitrary variables are supported. + + +Observations and reformat scripts +--------------------------------- + +Arbitrary datasets are supported. + + +References +---------- + +* Sommer, (2017), The psyplot interactive visualization framework, Journal of + Open Source Software, 2(16), 363, doi:10.21105/joss.00363 + + +Example plots +------------- + +.. _fig_psyplot_1: +.. figure:: /recipes/figures/psyplot/psyplot_CanESM5.jpg + :align: center + :width: 50% + + Historical near-surface air temperature climatology over Europe simulated by + CanESM5 between 1995 and 2014. The plot visualizes the invidividual + rectangular grid cells of the model's regular grid. + +.. _fig_psyplot_2: +.. figure:: /recipes/figures/psyplot/psyplot_ICON-ESM-LR.jpg + :align: center + :width: 50% + + Historical near-surface air temperature climatology over Europe simulated by + ICON-ESM-LR between 1995 and 2014. The plot visualizes the invidividual + triangular grid cells of the model's unstructured grid. From 6f59f5859c1c528c54bd86dce704aefab47b817d Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Wed, 28 May 2025 14:29:38 +0200 Subject: [PATCH 08/18] Fixing figure captions --- doc/sphinx/source/recipes/recipe_capacity_factor.rst | 2 +- .../source/recipes/recipe_climate_change_hotspot.rst | 10 ++++++++-- doc/sphinx/source/recipes/recipe_combined_indices.rst | 2 +- .../recipes/recipe_diurnal_temperature_index.rst | 2 +- doc/sphinx/source/recipes/recipe_extreme_index.rst | 2 +- .../source/recipes/recipe_heatwaves_coldwaves.rst | 2 +- doc/sphinx/source/recipes/recipe_impact.rst | 2 +- doc/sphinx/source/recipes/recipe_kcs.rst | 4 ++++ .../source/recipes/recipe_modes_of_variability.rst | 2 +- .../source/recipes/recipe_multimodel_products.rst | 2 +- .../source/recipes/recipe_pv_capacity_factor.rst | 2 +- doc/sphinx/source/recipes/recipe_seaice_drift.rst | 8 ++++---- .../source/recipes/recipe_thermodyn_diagtool.rst | 2 ++ doc/sphinx/source/recipes/recipe_toymodel.rst | 2 +- 14 files changed, 28 insertions(+), 16 deletions(-) diff --git a/doc/sphinx/source/recipes/recipe_capacity_factor.rst b/doc/sphinx/source/recipes/recipe_capacity_factor.rst index 39b277e294..94956324dd 100644 --- a/doc/sphinx/source/recipes/recipe_capacity_factor.rst +++ b/doc/sphinx/source/recipes/recipe_capacity_factor.rst @@ -75,4 +75,4 @@ Example plots :align: center :width: 14cm -Wind capacity factor for five turbines: Enercon E70 (top-left), Gamesa G80 (middle-top), Gamesa G87 (top-right), Vestas V100 (bottom-left) and Vestas V110 (middle-bottom) using the IPSL-CM5A-MR simulations for the r1p1i1 ensemble for the rcp8.5 scenario during the period 2021-2050. + Wind capacity factor for five turbines: Enercon E70 (top-left), Gamesa G80 (middle-top), Gamesa G87 (top-right), Vestas V100 (bottom-left) and Vestas V110 (middle-bottom) using the IPSL-CM5A-MR simulations for the r1p1i1 ensemble for the rcp8.5 scenario during the period 2021-2050. diff --git a/doc/sphinx/source/recipes/recipe_climate_change_hotspot.rst b/doc/sphinx/source/recipes/recipe_climate_change_hotspot.rst index ea3adadd61..cb5e94db93 100644 --- a/doc/sphinx/source/recipes/recipe_climate_change_hotspot.rst +++ b/doc/sphinx/source/recipes/recipe_climate_change_hotspot.rst @@ -190,11 +190,17 @@ Example plots .. figure:: /recipes/figures/cos22esd/tas_45.png :align: center + Mediterranean region temperature change differences against the mean global temperature + change. The changes for the periods 2041–2060 (first and third + row) and 2081–2100 (second and fourth row) are evaluated against 1986–2005 mean. The differences are shown for the CMIP5 (left) + and CMIP6 (right) DJF, JJA and annual mean projections (columns) under the high emission scenario RCP8.5 and SSP5-8.5 respectively. N + indicates the number of models included in the ensemble mean. + .. figure:: /recipes/figures/cos22esd/pr_45.png :align: center - Mediterranean region temperature (upper rows) and precipitation (lower rows) change differences against the mean global temperature - change and the mean 30–45º  N latitudinal belt precipitation change respectively. The changes for the periods 2041–2060 (first and third + Mediterranean region precipitation change differences against the mean 30–45º  N latitudinal belt precipitation change respectively. + The changes for the periods 2041–2060 (first and third row) and 2081–2100 (second and fourth row) are evaluated against 1986–2005 mean. The differences are shown for the CMIP5 (left) and CMIP6 (right) DJF, JJA and annual mean projections (columns) under the high emission scenario RCP8.5 and SSP5-8.5 respectively. N indicates the number of models included in the ensemble mean. diff --git a/doc/sphinx/source/recipes/recipe_combined_indices.rst b/doc/sphinx/source/recipes/recipe_combined_indices.rst index cff0856bff..2ac5639333 100644 --- a/doc/sphinx/source/recipes/recipe_combined_indices.rst +++ b/doc/sphinx/source/recipes/recipe_combined_indices.rst @@ -77,4 +77,4 @@ Example plots :align: center :width: 14cm -Time series of the standardized sea surface temperature (tos) area averaged over the Nino 3.4 region during the boreal winter (December-January-February). The time series correspond to the MPI-ESM-MR (red) and BCC-CSM1-1 (blue) models and their mean (black) during the period 1950-2005 for the ensemble r1p1i1 of the historical simulations. + Time series of the standardized sea surface temperature (tos) area averaged over the Nino 3.4 region during the boreal winter (December-January-February). The time series correspond to the MPI-ESM-MR (red) and BCC-CSM1-1 (blue) models and their mean (black) during the period 1950-2005 for the ensemble r1p1i1 of the historical simulations. diff --git a/doc/sphinx/source/recipes/recipe_diurnal_temperature_index.rst b/doc/sphinx/source/recipes/recipe_diurnal_temperature_index.rst index 200255ed50..3464fc21f7 100644 --- a/doc/sphinx/source/recipes/recipe_diurnal_temperature_index.rst +++ b/doc/sphinx/source/recipes/recipe_diurnal_temperature_index.rst @@ -73,4 +73,4 @@ Example plots :align: center :width: 14cm -Mean number of days exceeding the Diurnal Temperature Range (DTR) simulated during the historical period (1961-1990) by 5 degrees during the period 2030-2080. The result is derived from one RCP 8.5 scenario simulated by MPI-ESM-MR. + Mean number of days exceeding the Diurnal Temperature Range (DTR) simulated during the historical period (1961-1990) by 5 degrees during the period 2030-2080. The result is derived from one RCP 8.5 scenario simulated by MPI-ESM-MR. diff --git a/doc/sphinx/source/recipes/recipe_extreme_index.rst b/doc/sphinx/source/recipes/recipe_extreme_index.rst index e4656a3a77..1639c303a7 100644 --- a/doc/sphinx/source/recipes/recipe_extreme_index.rst +++ b/doc/sphinx/source/recipes/recipe_extreme_index.rst @@ -93,4 +93,4 @@ Example plots :align: center :width: 14cm -Average change in the heat component (t90p metric) of the Combined Climate Extreme Index for the 2020-2040 compared to the 1971-2000 reference period for the RCP 8.5 scenario simulated by MPI-ESM-MR. + Average change in the heat component (t90p metric) of the Combined Climate Extreme Index for the 2020-2040 compared to the 1971-2000 reference period for the RCP 8.5 scenario simulated by MPI-ESM-MR. diff --git a/doc/sphinx/source/recipes/recipe_heatwaves_coldwaves.rst b/doc/sphinx/source/recipes/recipe_heatwaves_coldwaves.rst index 019508ae80..ba4b6eb39e 100644 --- a/doc/sphinx/source/recipes/recipe_heatwaves_coldwaves.rst +++ b/doc/sphinx/source/recipes/recipe_heatwaves_coldwaves.rst @@ -69,4 +69,4 @@ Example plots :align: center :width: 14cm -Mean number of summer days during the period 2060-2080 when the daily maximum near-surface air temperature exceeds the 80th quantile of the 1971-2000 reference period. The results are based on one RCP 8.5 scenario simulated by BCC-CSM1-1. + Mean number of summer days during the period 2060-2080 when the daily maximum near-surface air temperature exceeds the 80th quantile of the 1971-2000 reference period. The results are based on one RCP 8.5 scenario simulated by BCC-CSM1-1. diff --git a/doc/sphinx/source/recipes/recipe_impact.rst b/doc/sphinx/source/recipes/recipe_impact.rst index b873f227ad..b7d2455366 100644 --- a/doc/sphinx/source/recipes/recipe_impact.rst +++ b/doc/sphinx/source/recipes/recipe_impact.rst @@ -69,7 +69,7 @@ Example plots .. figure:: /recipes/figures/impact/bias_vs_change.png :align: center - "Bias and change for each variable" + Bias and change for each variable .. raw:: html diff --git a/doc/sphinx/source/recipes/recipe_kcs.rst b/doc/sphinx/source/recipes/recipe_kcs.rst index 1ed117ecb6..285e531534 100644 --- a/doc/sphinx/source/recipes/recipe_kcs.rst +++ b/doc/sphinx/source/recipes/recipe_kcs.rst @@ -128,6 +128,8 @@ AND highlighting the selected steering parameters and resampling periods: .. figure:: /recipes/figures/kcs/global_matching.png :align: center + CMIP spread in global temperature change, highlighting selected steering parameters and resampling periods + The diagnostic ``local_resampling`` produces a number of output files: * ``season_means_.nc``: intermediate results, containing the season means for each segment of the original target model ensemble. @@ -158,3 +160,5 @@ The diagnostic ``local_resampling`` produces a number of output files: .. _fig_kcs_local_validation: .. figure:: /recipes/figures/kcs/local_validation_2085.png :align: center + + Validation figure, reproducing figures 5 and 6 from Lenderink et al. (2014) diff --git a/doc/sphinx/source/recipes/recipe_modes_of_variability.rst b/doc/sphinx/source/recipes/recipe_modes_of_variability.rst index 3fcd4aa5d2..13ffeb986a 100644 --- a/doc/sphinx/source/recipes/recipe_modes_of_variability.rst +++ b/doc/sphinx/source/recipes/recipe_modes_of_variability.rst @@ -86,4 +86,4 @@ Example plots :align: center :width: 14cm -Four modes of variability for autumn (September-October-November) in the North Atlantic European Sector for the RCP 8.5 scenario using BCC-CSM1-1 future projection during the period 2020-2075. The frequency of occurrence of each variability mode is indicated in the title of each map. + Four modes of variability for autumn (September-October-November) in the North Atlantic European Sector for the RCP 8.5 scenario using BCC-CSM1-1 future projection during the period 2020-2075. The frequency of occurrence of each variability mode is indicated in the title of each map. diff --git a/doc/sphinx/source/recipes/recipe_multimodel_products.rst b/doc/sphinx/source/recipes/recipe_multimodel_products.rst index 9d7bcc651d..9208b8c307 100644 --- a/doc/sphinx/source/recipes/recipe_multimodel_products.rst +++ b/doc/sphinx/source/recipes/recipe_multimodel_products.rst @@ -76,4 +76,4 @@ Example plots .. _fig_multimodprod: .. figure:: /recipes/figures/multimodel_products/tas_JUN_multimodel-anomaly_2006_2099_1961_1990.png -Multi-model mean anomaly of 2-m air temperature during the future projection 2006-2099 in June considering the reference period 1961-1990 (colours). Crosses indicate that the 80% of models agree in the sign of the multi-model mean anomaly. The models selected are BCC-CSM1-1, MPI-ESM-MR and MIROC5 in the r1i1p1 ensembles for the RCP 2.6 scenario. + Multi-model mean anomaly of 2-m air temperature during the future projection 2006-2099 in June considering the reference period 1961-1990 (colours). Crosses indicate that the 80% of models agree in the sign of the multi-model mean anomaly. The models selected are BCC-CSM1-1, MPI-ESM-MR and MIROC5 in the r1i1p1 ensembles for the RCP 2.6 scenario. diff --git a/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst b/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst index 08962f3ca8..37106805a0 100644 --- a/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst +++ b/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst @@ -74,4 +74,4 @@ Example plots :align: center :width: 14cm -PV capacity factor calculated from IPSL-CM5-MR during the DJF season for 1980–2005. + PV capacity factor calculated from IPSL-CM5-MR during the DJF season for 1980–2005. diff --git a/doc/sphinx/source/recipes/recipe_seaice_drift.rst b/doc/sphinx/source/recipes/recipe_seaice_drift.rst index a3207bce0b..10446a4a6c 100644 --- a/doc/sphinx/source/recipes/recipe_seaice_drift.rst +++ b/doc/sphinx/source/recipes/recipe_seaice_drift.rst @@ -75,7 +75,7 @@ Example plots .. figure:: /recipes/figures/seaice_drift/drift-strength.png :align: center -Scatter plots of modelled (red) and observed (blue) monthly mean -sea-ice drift speed against sea-ice concentration (left panel) and sea-ice -thickness (right panel) temporally averaged over the period 1979–2005 and -spatially averaged over the SCICEX box. + Scatter plots of modelled (red) and observed (blue) monthly mean + sea-ice drift speed against sea-ice concentration (left panel) and sea-ice + thickness (right panel) temporally averaged over the period 1979–2005 and + spatially averaged over the SCICEX box. diff --git a/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst b/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst index 5ee51dfb9c..a3c394be36 100644 --- a/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst +++ b/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst @@ -142,7 +142,9 @@ Example plots .. figure:: /recipes/figures/thermodyn_diagtool/meridional_transp.png :align: left :width: 14cm + Meridional transports. .. figure:: /recipes/figures/thermodyn_diagtool/CanESM2_wmb_transp.png :align: right :width: 14cm + Water mass transports. diff --git a/doc/sphinx/source/recipes/recipe_toymodel.rst b/doc/sphinx/source/recipes/recipe_toymodel.rst index c39ac951db..0b58d1da6e 100644 --- a/doc/sphinx/source/recipes/recipe_toymodel.rst +++ b/doc/sphinx/source/recipes/recipe_toymodel.rst @@ -78,4 +78,4 @@ Example plots .. _fig_toymodel: .. figure:: /recipes/figures/toymodel/synthetic_CMIP5_bcc-csm1-1_Amon_rcp45_r1i1p1_psl_2051-2060.jpg -Twenty synthetic single-model ensemble generated by the recipe_toymodel.yml (see Section 3.7.2) for the 2051-2060 monthly data of r1i1p1 RCP 4.5 scenario of BCC_CSM1-1 simulation. + Twenty synthetic single-model ensemble generated by the recipe_toymodel.yml (see Section 3.7.2) for the 2051-2060 monthly data of r1i1p1 RCP 4.5 scenario of BCC_CSM1-1 simulation. From 641134bf5658f0b1687f205b7702d0378fc92513 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Wed, 28 May 2025 14:48:32 +0200 Subject: [PATCH 09/18] responsive layout --- doc/sphinx/source/_static/custom.css | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/doc/sphinx/source/_static/custom.css b/doc/sphinx/source/_static/custom.css index 5401a023fe..f1413130b9 100644 --- a/doc/sphinx/source/_static/custom.css +++ b/doc/sphinx/source/_static/custom.css @@ -1,15 +1,21 @@ .gallery { display: grid; - grid-template-columns: repeat(auto-fit, minmax(200px, 250px)); + grid-template-columns: repeat(3, minmax(200px, 1fr)); gap: 1em; } +@media (max-width: 600px) { + .gallery { + grid-template-columns: repeat(1, minmax(200px, 1fr)); + } +} + .gallery figure:hover { background-color: var(--pst-color-surface); } .gallery figure img { - max-height: 300px; + max-height: 250px; object-fit: cover; overflow: hidden; } From 96f5aea7912b310e9fc4bc8270343a42a704343c Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Wed, 28 May 2025 14:57:48 +0200 Subject: [PATCH 10/18] fix errors --- doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst | 2 +- doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst b/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst index 37106805a0..b632c13515 100644 --- a/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst +++ b/doc/sphinx/source/recipes/recipe_pv_capacity_factor.rst @@ -74,4 +74,4 @@ Example plots :align: center :width: 14cm - PV capacity factor calculated from IPSL-CM5-MR during the DJF season for 1980–2005. + PV capacity factor calculated from IPSL-CM5-MR during the DJF season for 1980–2005. diff --git a/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst b/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst index a3c394be36..c1a5973a5d 100644 --- a/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst +++ b/doc/sphinx/source/recipes/recipe_thermodyn_diagtool.rst @@ -142,9 +142,11 @@ Example plots .. figure:: /recipes/figures/thermodyn_diagtool/meridional_transp.png :align: left :width: 14cm + Meridional transports. .. figure:: /recipes/figures/thermodyn_diagtool/CanESM2_wmb_transp.png :align: right :width: 14cm + Water mass transports. From d5bd2a52e1c77600e0e236fb8ad4473181f2996d Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Wed, 28 May 2025 15:19:30 +0200 Subject: [PATCH 11/18] test 2 gallery plots from 1 recipe file --- doc/sphinx/source/recipes/recipe_gier20bg.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/sphinx/source/recipes/recipe_gier20bg.rst b/doc/sphinx/source/recipes/recipe_gier20bg.rst index 7ead4b7b58..4858ee03ea 100644 --- a/doc/sphinx/source/recipes/recipe_gier20bg.rst +++ b/doc/sphinx/source/recipes/recipe_gier20bg.rst @@ -171,6 +171,8 @@ Example plots Mean fractional coverage of monthly satellite data. .. _fig_gier20bg_2: +.. + gallery .. figure:: /recipes/figures/gier20bg/fig02.png :align: center :width: 80% @@ -193,9 +195,9 @@ Example plots Barplot of the growth rate, averaged over all years, with standard deviation of interannual variability. -.. - gallery=True .. _fig_gier20bg_5: +.. + gallery .. figure:: /recipes/figures/gier20bg/fig05.png :align: center :width: 80% From 62453cfbbcdb59a5ccd579c939be1e3f3c778bc2 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Wed, 28 May 2025 15:26:36 +0200 Subject: [PATCH 12/18] hide docutils parsing errors, fine tune plot width --- doc/sphinx/source/_static/custom.css | 6 +++--- doc/sphinx/source/generate_gallery.py | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/sphinx/source/_static/custom.css b/doc/sphinx/source/_static/custom.css index f1413130b9..f7396ccad4 100644 --- a/doc/sphinx/source/_static/custom.css +++ b/doc/sphinx/source/_static/custom.css @@ -1,12 +1,12 @@ .gallery { display: grid; - grid-template-columns: repeat(3, minmax(200px, 1fr)); + grid-template-columns: repeat(3, minmax(180px, 1fr)); gap: 1em; } -@media (max-width: 600px) { +@media (max-width: 300px) { .gallery { - grid-template-columns: repeat(1, minmax(200px, 1fr)); + grid-template-columns: repeat(1, minmax(180px, 1fr)); } } diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 9204058f58..48cee234a6 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -56,7 +56,7 @@ def _get_figures_from_file(fname): """Get marked, no or first figure from documentation page.""" with (Path(RECIPE_DIR) / fname).open() as f: content = f.read() - tree = publish_doctree(content) + tree = publish_doctree(content, settings_overrides={"report_level": 5}) try: link = content.split("\n")[0].split(" ")[1][1:-1] except IndexError: From 1a9945e993b21ac2e301056c41705a7ddc007c5c Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Wed, 28 May 2025 15:38:25 +0200 Subject: [PATCH 13/18] fix duplicate figure name --- doc/sphinx/source/recipes/recipe_extreme_index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/sphinx/source/recipes/recipe_extreme_index.rst b/doc/sphinx/source/recipes/recipe_extreme_index.rst index 1639c303a7..1149c4ef06 100644 --- a/doc/sphinx/source/recipes/recipe_extreme_index.rst +++ b/doc/sphinx/source/recipes/recipe_extreme_index.rst @@ -88,7 +88,7 @@ References Example plots ------------- -.. _fig_combinedindices1: +.. _fig_extremeindex1: .. figure:: /recipes/figures/recipe_extreme_index/t90p_IPSL-CM5A-LR_rcp85_2020_2040.png :align: center :width: 14cm From a9c40ee92f39c5f26a1f691ff1f7f6e67b5e80e5 Mon Sep 17 00:00:00 2001 From: Lukas Ruhe Date: Mon, 2 Jun 2025 14:14:42 +0200 Subject: [PATCH 14/18] hide caption numbers in gallery --- doc/sphinx/source/_static/custom.css | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/sphinx/source/_static/custom.css b/doc/sphinx/source/_static/custom.css index f7396ccad4..657a3caa20 100644 --- a/doc/sphinx/source/_static/custom.css +++ b/doc/sphinx/source/_static/custom.css @@ -15,7 +15,7 @@ } .gallery figure img { - max-height: 250px; + max-height: 220px; object-fit: cover; overflow: hidden; } @@ -35,3 +35,7 @@ text-decoration: underline; color: var(--pst-color-link-hover); } + +.gallery figure span.caption-number { + display: none; +} From 49723cbae73b627281f3cbf2a4192ec2a7a93941 Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Thu, 5 Jun 2025 16:28:28 +0200 Subject: [PATCH 15/18] add gallery tags to documentation --- doc/sphinx/source/community/diagnostic.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/sphinx/source/community/diagnostic.rst b/doc/sphinx/source/community/diagnostic.rst index e50e4c603b..6b7eb9520d 100644 --- a/doc/sphinx/source/community/diagnostic.rst +++ b/doc/sphinx/source/community/diagnostic.rst @@ -108,6 +108,26 @@ A resolution of 150 `dpi `_ is recommended for these image files, as this is high enough for the images to look good on the documentation webpage, but not so high that the files become large. +By default, the first example image will be used for the automatically +generated gallery. To select a specific image for the gallery, you can use the +syntax + +.. code-block:: rst + + .. _fig_name: + .. + gallery + .. figure:: /recipes/figure/recipe_name/figure-name.png + +To not have any figure appear in the gallery, you can include a + +.. code-block:: rst + + .. + no-gallery + +anywhere in your recipe documentation file. + In the recipe ------------- Fill in the ``documentation`` section of the recipe as described in From 46e5e8fdea191512440fba7474f9705acd6eb80f Mon Sep 17 00:00:00 2001 From: Bettina Gier Date: Thu, 5 Jun 2025 16:39:16 +0200 Subject: [PATCH 16/18] add gallery tags to documentation --- doc/sphinx/source/community/diagnostic.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/sphinx/source/community/diagnostic.rst b/doc/sphinx/source/community/diagnostic.rst index 6b7eb9520d..cb13847847 100644 --- a/doc/sphinx/source/community/diagnostic.rst +++ b/doc/sphinx/source/community/diagnostic.rst @@ -110,7 +110,7 @@ good on the documentation webpage, but not so high that the files become large. By default, the first example image will be used for the automatically generated gallery. To select a specific image for the gallery, you can use the -syntax +following syntax for an arbitrary amount of images: .. code-block:: rst From 8903f829e06562fb2da5dad278b4c3b520439a25 Mon Sep 17 00:00:00 2001 From: Lukas Date: Wed, 18 Jun 2025 13:49:31 +0200 Subject: [PATCH 17/18] Update doc/sphinx/source/generate_gallery.py Co-authored-by: Felicity Chun <32269066+flicj191@users.noreply.github.com> --- doc/sphinx/source/generate_gallery.py | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/sphinx/source/generate_gallery.py b/doc/sphinx/source/generate_gallery.py index 48cee234a6..38103675e1 100644 --- a/doc/sphinx/source/generate_gallery.py +++ b/doc/sphinx/source/generate_gallery.py @@ -11,6 +11,7 @@ RECIPE_DIR = "recipes" OUT_PATH = os.path.abspath("gallery.rst") HEADER = ( + ":html_theme.sidebar_secondary.remove:\n\n" ".. DO NOT MODIFY! THIS PAGE IS AUTOGENERATED!\n\n" "#######\nGallery\n#######\n\n" "This section shows example plots produced by ESMValTool. For more " From 5e50ca72df9b2accd06af83a9c4f32d66fe24807 Mon Sep 17 00:00:00 2001 From: Lukas Date: Thu, 19 Jun 2025 13:08:10 +0200 Subject: [PATCH 18/18] adjust mobile breakpoints without sidebar --- doc/sphinx/source/_static/custom.css | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/sphinx/source/_static/custom.css b/doc/sphinx/source/_static/custom.css index 657a3caa20..ba3dbf80c3 100644 --- a/doc/sphinx/source/_static/custom.css +++ b/doc/sphinx/source/_static/custom.css @@ -4,7 +4,12 @@ gap: 1em; } -@media (max-width: 300px) { +@media (max-width: 620px) { + .gallery { + grid-template-columns: repeat(2, minmax(180px, 1fr)); + } +} +@media (max-width: 420px) { .gallery { grid-template-columns: repeat(1, minmax(180px, 1fr)); }