From f79ff930f4e93aa332892f02468756e1ce607fad Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Fri, 2 May 2025 17:58:08 +1000 Subject: [PATCH 01/34] Test link 1 --- docs/guides/land-cover-explorer.md | 2 ++ docs/guides/setup/dea_maps.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index b50a10ba8..3f79b1bb6 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -1,5 +1,7 @@ # Land Cover Explorer +[Test link: DEA Maps](#dea-maps) + [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) :::{admonition} Start exploring diff --git a/docs/guides/setup/dea_maps.md b/docs/guides/setup/dea_maps.md index f38e512cf..b9901d0e2 100644 --- a/docs/guides/setup/dea_maps.md +++ b/docs/guides/setup/dea_maps.md @@ -1,3 +1,5 @@ +(dea-maps)= + # DEA Maps [DEA Maps](https://maps.dea.ga.gov.au/) is an online platform where you can view Digital Earth Australia (DEA) datasets. It aims to make it easy for anyone to access our open-source data — whether you are a scientist, educator, journalist, or otherwise. From 97d9d7ec2cfc4d0729626b77503f4140300057b9 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 09:31:54 +1000 Subject: [PATCH 02/34] Testing settings for links --- docs/conf.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 13cf20c6b..181bcd850 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -62,7 +62,7 @@ elif is_pr_preview: html_baseurl = f"https://{pr_preview_subdomain}.khpreview.dea.ga.gov.au/" else: html_baseurl = "" -html_permalinks = False +html_permalinks = True html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ @@ -89,7 +89,7 @@ "dollarmath", ] myst_heading_anchors = 6 -myst_all_links_external = True +myst_all_links_external = False nbsphinx_requirejs_path = "" nbsphinx_execute = "never" From 62524847efff93a841ed4cef607088e8bf024cb7 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 09:41:31 +1000 Subject: [PATCH 03/34] Testing --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 181bcd850..38ec7c1a7 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -72,7 +72,7 @@ "sphinx.ext.mathjax", "sphinx.ext.napoleon", "myst_parser", - "nbsphinx", + # "nbsphinx", "sphinx_design", "sphinxext.rediraffe", "sphinxcontrib.datatemplates", From a1ccda9e1c2b575a9fdccd557172ab47c6f09b27 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:08:53 +1000 Subject: [PATCH 04/34] Testing --- docs/conf.py | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 38ec7c1a7..73eb07061 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,26 +66,26 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - "sphinx.ext.autodoc", - "sphinx.ext.autosummary", - "sphinx.ext.viewcode", - "sphinx.ext.mathjax", - "sphinx.ext.napoleon", + # "sphinx.ext.autodoc", + # "sphinx.ext.autosummary", + # "sphinx.ext.viewcode", + # "sphinx.ext.mathjax", + # "sphinx.ext.napoleon", "myst_parser", # "nbsphinx", "sphinx_design", - "sphinxext.rediraffe", - "sphinxcontrib.datatemplates", - "sphinx_external_toc", - "sphinx_sitemap", - "notfound.extension", - "sphinx_copybutton", + # "sphinxext.rediraffe", + # "sphinxcontrib.datatemplates", + # "sphinx_external_toc", + # "sphinx_sitemap", + # "notfound.extension", + # "sphinx_copybutton", ] myst_enable_extensions = [ "colon_fence", - "attrs_inline", - "attrs_block", + # "attrs_inline", + # "attrs_block", "dollarmath", ] myst_heading_anchors = 6 From a6a1891870e3a173527739271e08cb14b8c2a653 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:15:04 +1000 Subject: [PATCH 05/34] Testing - link worked --- docs/conf.py | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 73eb07061..48aa19638 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,20 +66,20 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - # "sphinx.ext.autodoc", - # "sphinx.ext.autosummary", - # "sphinx.ext.viewcode", - # "sphinx.ext.mathjax", - # "sphinx.ext.napoleon", + "sphinx.ext.autodoc", + "sphinx.ext.autosummary", + "sphinx.ext.viewcode", + "sphinx.ext.mathjax", + "sphinx.ext.napoleon", "myst_parser", # "nbsphinx", "sphinx_design", # "sphinxext.rediraffe", - # "sphinxcontrib.datatemplates", - # "sphinx_external_toc", - # "sphinx_sitemap", - # "notfound.extension", - # "sphinx_copybutton", + "sphinxcontrib.datatemplates", + "sphinx_external_toc", + "sphinx_sitemap", + "notfound.extension", + "sphinx_copybutton", ] myst_enable_extensions = [ From de045f3a1013945a8284eedf38ae8c4889496623 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:22:04 +1000 Subject: [PATCH 06/34] Testing - link worked --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 48aa19638..9c16e34b2 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -72,7 +72,7 @@ "sphinx.ext.mathjax", "sphinx.ext.napoleon", "myst_parser", - # "nbsphinx", + "nbsphinx", "sphinx_design", # "sphinxext.rediraffe", "sphinxcontrib.datatemplates", From bcb099b3b636d437d028b7504dc7a2f3ba08ddc7 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:30:10 +1000 Subject: [PATCH 07/34] Testing - isolating the nbsphinx plugin --- docs/conf.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 9c16e34b2..dac292ed0 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -72,7 +72,7 @@ "sphinx.ext.mathjax", "sphinx.ext.napoleon", "myst_parser", - "nbsphinx", + # "nbsphinx", "sphinx_design", # "sphinxext.rediraffe", "sphinxcontrib.datatemplates", @@ -84,8 +84,8 @@ myst_enable_extensions = [ "colon_fence", - # "attrs_inline", - # "attrs_block", + "attrs_inline", + "attrs_block", "dollarmath", ] myst_heading_anchors = 6 From 41a83439995769383aaf07782c03b1fd0622f58a Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:42:10 +1000 Subject: [PATCH 08/34] Downgrading nbsphinx to 0.9.1 to address this issue --- docs/conf.py | 2 +- docs/requirements.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index dac292ed0..90770e1df 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -72,7 +72,7 @@ "sphinx.ext.mathjax", "sphinx.ext.napoleon", "myst_parser", - # "nbsphinx", + "nbsphinx", "sphinx_design", # "sphinxext.rediraffe", "sphinxcontrib.datatemplates", diff --git a/docs/requirements.txt b/docs/requirements.txt index 43bb3523a..8c177edc1 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,5 +1,5 @@ sphinx<=7.2.6 -nbsphinx<=0.9.3 +nbsphinx<=0.9.1 ipython<=8.18.1 myst-parser<=2.0.0 ipywidgets<=8.1.1 From d638d840d2a85f9c112622aae2e76a4efe9c9037 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:55:29 +1000 Subject: [PATCH 09/34] A test: @dea-maps --- docs/guides/land-cover-explorer.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 3f79b1bb6..c8842dc09 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -2,6 +2,8 @@ [Test link: DEA Maps](#dea-maps) +@dea-maps + [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) :::{admonition} Start exploring From a788cbdff67539f721fc638b9b2f4c9e87d04994 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 10:56:32 +1000 Subject: [PATCH 10/34] Trying nbsphinx 0.9.7 --- docs/requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index 8c177edc1..209b3734d 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,5 +1,5 @@ sphinx<=7.2.6 -nbsphinx<=0.9.1 +nbsphinx<=0.9.7 ipython<=8.18.1 myst-parser<=2.0.0 ipywidgets<=8.1.1 From 0acbaa41b69e5bc8ef94c70e1b958ced656526cd Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 11:06:39 +1000 Subject: [PATCH 11/34] Removed @dea-maps test --- docs/guides/land-cover-explorer.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index c8842dc09..3f79b1bb6 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -2,8 +2,6 @@ [Test link: DEA Maps](#dea-maps) -@dea-maps - [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) :::{admonition} Start exploring From 583dbdbaf250603e319813c805c2544d2e016f27 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 11:16:49 +1000 Subject: [PATCH 12/34] Link not working in nbsphinx 0.9.7 so reverting to 0.9.1 --- docs/requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index 209b3734d..8c177edc1 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,5 +1,5 @@ sphinx<=7.2.6 -nbsphinx<=0.9.7 +nbsphinx<=0.9.1 ipython<=8.18.1 myst-parser<=2.0.0 ipywidgets<=8.1.1 From c8b93a0a911ea5de92be363d8a7f5fb7e5137b93 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 11:20:13 +1000 Subject: [PATCH 13/34] Code comment [skip ci] --- docs/requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index 8c177edc1..55bb725e1 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,5 +1,5 @@ sphinx<=7.2.6 -nbsphinx<=0.9.1 +nbsphinx<=0.9.1 # Cross-references of the format [Test link](#test-label) break in 0.9.2. ipython<=8.18.1 myst-parser<=2.0.0 ipywidgets<=8.1.1 From 26cd861321a338d460f65cd23a1b1ae49ef6c3cd Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 11:21:41 +1000 Subject: [PATCH 14/34] Code comment [skip ci] --- docs/requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index 55bb725e1..88915185c 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,5 +1,5 @@ sphinx<=7.2.6 -nbsphinx<=0.9.1 # Cross-references of the format [Test link](#test-label) break in 0.9.2. +nbsphinx<=0.9.1 # Cross-references of the format [Test link](#test-label) break in 0.9.2. This bug still occurs in 0.9.7. Issue: https://github.com/spatialaudio/nbsphinx/issues/748 ipython<=8.18.1 myst-parser<=2.0.0 ipywidgets<=8.1.1 From 61c1b11d7b1e51f57ca805c3b5c628b94d23cb1f Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 13:44:37 +1000 Subject: [PATCH 15/34] Reverting some test settings --- docs/conf.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 90770e1df..13cf20c6b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -62,7 +62,7 @@ elif is_pr_preview: html_baseurl = f"https://{pr_preview_subdomain}.khpreview.dea.ga.gov.au/" else: html_baseurl = "" -html_permalinks = True +html_permalinks = False html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ @@ -74,7 +74,7 @@ "myst_parser", "nbsphinx", "sphinx_design", - # "sphinxext.rediraffe", + "sphinxext.rediraffe", "sphinxcontrib.datatemplates", "sphinx_external_toc", "sphinx_sitemap", @@ -89,7 +89,7 @@ "dollarmath", ] myst_heading_anchors = 6 -myst_all_links_external = False +myst_all_links_external = True nbsphinx_requirejs_path = "" nbsphinx_execute = "never" From 64cb7eeefdffb3e92b47ebb4cf297d0c78dbd1c0 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 16:12:24 +1000 Subject: [PATCH 16/34] myst_all_links_external = False --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 13cf20c6b..af75ed77d 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -89,7 +89,7 @@ "dollarmath", ] myst_heading_anchors = 6 -myst_all_links_external = True +myst_all_links_external = False nbsphinx_requirejs_path = "" nbsphinx_execute = "never" From 2ff8479e2119c355c9713dbc3c30f52b2a53f2b1 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Mon, 5 May 2025 17:41:02 +1000 Subject: [PATCH 17/34] Testing Myst URL schemes --- docs/conf.py | 3 ++- docs/guides/land-cover-explorer.md | 7 ++++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index af75ed77d..a846c7629 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -89,7 +89,8 @@ "dollarmath", ] myst_heading_anchors = 6 -myst_all_links_external = False +# myst_all_links_external = False +myst_url_schemes = ["http", "https", "ftp", "mailto", "root"] nbsphinx_requirejs_path = "" nbsphinx_execute = "never" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 3f79b1bb6..2a3a63a32 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -1,6 +1,11 @@ # Land Cover Explorer -[Test link: DEA Maps](#dea-maps) +TESTS: + +* Target: [Test link: DEA Maps](#dea-maps) +* Root-relative: [DEA Surface Reflectance (Sentinel-2A MSI)](/data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `project`: [DEA Surface Reflectance (Sentinel-2A MSI)](project:/data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:/data/product/dea-surface-reflectance-sentinel-2a-msi/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From 42b755c18bb07de5f422a011fcf9a13f83e9e5a7 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 09:05:24 +1000 Subject: [PATCH 18/34] Testing upgrade Myst Parser to 4.0.1 --- docs/requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index 88915185c..1ddda1bfe 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,7 +1,7 @@ sphinx<=7.2.6 nbsphinx<=0.9.1 # Cross-references of the format [Test link](#test-label) break in 0.9.2. This bug still occurs in 0.9.7. Issue: https://github.com/spatialaudio/nbsphinx/issues/748 ipython<=8.18.1 -myst-parser<=2.0.0 +myst-parser<=4.0.1 ipywidgets<=8.1.1 matplotlib<=3.8.2 pydata-sphinx-theme<=0.14.4 From fcf1f981236be55208aa934483ca7c486c437576 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 09:17:35 +1000 Subject: [PATCH 19/34] More testing --- docs/conf.py | 34 +++++++++++++++--------------- docs/guides/land-cover-explorer.md | 3 +++ 2 files changed, 20 insertions(+), 17 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index a846c7629..58e6d45fe 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,27 +66,27 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - "sphinx.ext.autodoc", - "sphinx.ext.autosummary", - "sphinx.ext.viewcode", - "sphinx.ext.mathjax", - "sphinx.ext.napoleon", + # "sphinx.ext.autodoc", + # "sphinx.ext.autosummary", + # "sphinx.ext.viewcode", + # "sphinx.ext.mathjax", + # "sphinx.ext.napoleon", "myst_parser", - "nbsphinx", - "sphinx_design", - "sphinxext.rediraffe", - "sphinxcontrib.datatemplates", - "sphinx_external_toc", - "sphinx_sitemap", - "notfound.extension", - "sphinx_copybutton", + # "nbsphinx", + # "sphinx_design", + # "sphinxext.rediraffe", + # "sphinxcontrib.datatemplates", + # "sphinx_external_toc", + # "sphinx_sitemap", + # "notfound.extension", + # "sphinx_copybutton", ] myst_enable_extensions = [ - "colon_fence", - "attrs_inline", - "attrs_block", - "dollarmath", + # "colon_fence", + # "attrs_inline", + # "attrs_block", + # "dollarmath", ] myst_heading_anchors = 6 # myst_all_links_external = False diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 2a3a63a32..6e14bf7a1 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -6,6 +6,9 @@ TESTS: * Root-relative: [DEA Surface Reflectance (Sentinel-2A MSI)](/data/product/dea-surface-reflectance-sentinel-2a-msi/) * Root-relative `project`: [DEA Surface Reflectance (Sentinel-2A MSI)](project:/data/product/dea-surface-reflectance-sentinel-2a-msi/) * Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:/data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative: +* Root-relative `project`: +* Root-relative `root`: [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From 6978f6431d993ecb1447e4aacb9c5ea391e80034 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 09:24:49 +1000 Subject: [PATCH 20/34] myst_url_schemes configuration --- docs/conf.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 58e6d45fe..9bfeedba3 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -90,7 +90,14 @@ ] myst_heading_anchors = 6 # myst_all_links_external = False -myst_url_schemes = ["http", "https", "ftp", "mailto", "root"] +# myst_url_schemes = ["http", "https", "ftp", "mailto", "root"] +myst_url_schemes = { + "http": None, + "https": None, + "ftp": None, + "mailto": None, + "root": "https://knowledge.dea.ga.gov.au/{{path}}#{{fragment}}", +} nbsphinx_requirejs_path = "" nbsphinx_execute = "never" From 5b1bb6b0e64565242bace51f95e8d23f13a2c5b2 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 09:42:01 +1000 Subject: [PATCH 21/34] More testing --- docs/conf.py | 6 +++++- docs/guides/land-cover-explorer.md | 9 ++++----- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 9bfeedba3..c326fe7eb 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -96,7 +96,11 @@ "https": None, "ftp": None, "mailto": None, - "root": "https://knowledge.dea.ga.gov.au/{{path}}#{{fragment}}", + "root": "https://knowledge.dea.ga.gov.au{{path}}#{{fragment}}", + "rootb": "{{path}}#{{fragment}}", + "rootc": "/{{path}}#{{fragment}}", + "rootd": "{{uri}}", + "roote": "/{{uri}}", } nbsphinx_requirejs_path = "" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 6e14bf7a1..68d27edc3 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -3,12 +3,11 @@ TESTS: * Target: [Test link: DEA Maps](#dea-maps) -* Root-relative: [DEA Surface Reflectance (Sentinel-2A MSI)](/data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative `project`: [DEA Surface Reflectance (Sentinel-2A MSI)](project:/data/product/dea-surface-reflectance-sentinel-2a-msi/) * Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:/data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative: -* Root-relative `project`: -* Root-relative `root`: +* Root-relative `rootb`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootb:/data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `rootc`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootc:data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `rootd`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootd:/data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `roote`: [DEA Surface Reflectance (Sentinel-2A MSI)](roote:data/product/dea-surface-reflectance-sentinel-2a-msi/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From ff224ce722c6cd1e59728cc995aedb691fbccff8 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 10:14:39 +1000 Subject: [PATCH 22/34] More testing --- docs/conf.py | 40 ++++++++++++++---------------- docs/guides/land-cover-explorer.md | 6 +---- 2 files changed, 19 insertions(+), 27 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index c326fe7eb..5f6947492 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,27 +66,27 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - # "sphinx.ext.autodoc", - # "sphinx.ext.autosummary", - # "sphinx.ext.viewcode", - # "sphinx.ext.mathjax", - # "sphinx.ext.napoleon", + "sphinx.ext.autodoc", + "sphinx.ext.autosummary", + "sphinx.ext.viewcode", + "sphinx.ext.mathjax", + "sphinx.ext.napoleon", "myst_parser", - # "nbsphinx", - # "sphinx_design", - # "sphinxext.rediraffe", - # "sphinxcontrib.datatemplates", - # "sphinx_external_toc", - # "sphinx_sitemap", - # "notfound.extension", - # "sphinx_copybutton", + "nbsphinx", + "sphinx_design", + "sphinxext.rediraffe", + "sphinxcontrib.datatemplates", + "sphinx_external_toc", + "sphinx_sitemap", + "notfound.extension", + "sphinx_copybutton", ] myst_enable_extensions = [ - # "colon_fence", - # "attrs_inline", - # "attrs_block", - # "dollarmath", + "colon_fence", + "attrs_inline", + "attrs_block", + "dollarmath", ] myst_heading_anchors = 6 # myst_all_links_external = False @@ -96,11 +96,7 @@ "https": None, "ftp": None, "mailto": None, - "root": "https://knowledge.dea.ga.gov.au{{path}}#{{fragment}}", - "rootb": "{{path}}#{{fragment}}", - "rootc": "/{{path}}#{{fragment}}", - "rootd": "{{uri}}", - "roote": "/{{uri}}", + "root": "/{{uri}}", } nbsphinx_requirejs_path = "" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 68d27edc3..416aa4697 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -3,11 +3,7 @@ TESTS: * Target: [Test link: DEA Maps](#dea-maps) -* Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:/data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative `rootb`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootb:/data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative `rootc`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootc:data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative `rootd`: [DEA Surface Reflectance (Sentinel-2A MSI)](rootd:/data/product/dea-surface-reflectance-sentinel-2a-msi/) -* Root-relative `roote`: [DEA Surface Reflectance (Sentinel-2A MSI)](roote:data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:data/product/dea-surface-reflectance-sentinel-2a-msi/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From c5d4cd9b52e908c7a0097bacfa487f40c74f9156 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 10:55:03 +1000 Subject: [PATCH 23/34] More testing --- docs/conf.py | 34 +++++++++++++++--------------- docs/guides/land-cover-explorer.md | 4 ++-- 2 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 5f6947492..2fb83d89b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,27 +66,27 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - "sphinx.ext.autodoc", - "sphinx.ext.autosummary", - "sphinx.ext.viewcode", - "sphinx.ext.mathjax", - "sphinx.ext.napoleon", + # "sphinx.ext.autodoc", + # "sphinx.ext.autosummary", + # "sphinx.ext.viewcode", + # "sphinx.ext.mathjax", + # "sphinx.ext.napoleon", "myst_parser", - "nbsphinx", - "sphinx_design", - "sphinxext.rediraffe", - "sphinxcontrib.datatemplates", - "sphinx_external_toc", - "sphinx_sitemap", - "notfound.extension", - "sphinx_copybutton", + # "nbsphinx", + # "sphinx_design", + # "sphinxext.rediraffe", + # "sphinxcontrib.datatemplates", + # "sphinx_external_toc", + # "sphinx_sitemap", + # "notfound.extension", + # "sphinx_copybutton", ] myst_enable_extensions = [ - "colon_fence", - "attrs_inline", - "attrs_block", - "dollarmath", + # "colon_fence", + # "attrs_inline", + # "attrs_block", + # "dollarmath", ] myst_heading_anchors = 6 # myst_all_links_external = False diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 416aa4697..3941455a2 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -2,8 +2,8 @@ TESTS: -* Target: [Test link: DEA Maps](#dea-maps) -* Root-relative `root`: [DEA Surface Reflectance (Sentinel-2A MSI)](root:data/product/dea-surface-reflectance-sentinel-2a-msi/) +* Target — [DEA Maps](#dea-maps) +* `root:` — [DEA Maps](root:guides/setup/dea_maps/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From f3810d5968958efa48d9cd34e5b8a097b8c4240d Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 11:48:04 +1000 Subject: [PATCH 24/34] More testing --- docs/conf.py | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 2fb83d89b..614b8cee4 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -66,27 +66,27 @@ html_last_updated_fmt = '%-d %B %Y' # E.g. 1 January 2020 extensions = [ - # "sphinx.ext.autodoc", - # "sphinx.ext.autosummary", - # "sphinx.ext.viewcode", - # "sphinx.ext.mathjax", - # "sphinx.ext.napoleon", + "sphinx.ext.autodoc", + "sphinx.ext.autosummary", + "sphinx.ext.viewcode", + "sphinx.ext.mathjax", + "sphinx.ext.napoleon", "myst_parser", - # "nbsphinx", - # "sphinx_design", - # "sphinxext.rediraffe", - # "sphinxcontrib.datatemplates", - # "sphinx_external_toc", - # "sphinx_sitemap", - # "notfound.extension", - # "sphinx_copybutton", + "nbsphinx", + "sphinx_design", + "sphinxext.rediraffe", + "sphinxcontrib.datatemplates", + "sphinx_external_toc", + "sphinx_sitemap", + "notfound.extension", + "sphinx_copybutton", ] myst_enable_extensions = [ - # "colon_fence", - # "attrs_inline", - # "attrs_block", - # "dollarmath", + "colon_fence", + "attrs_inline", + "attrs_block", + "dollarmath", ] myst_heading_anchors = 6 # myst_all_links_external = False @@ -96,7 +96,7 @@ "https": None, "ftp": None, "mailto": None, - "root": "/{{uri}}", + "root": "https://pr-460-preview.khpreview.dea.ga.gov.au/{{uri}}", } nbsphinx_requirejs_path = "" From 529f0f76908e6e9079b83f5a7626b90e957ad27c Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 11:54:37 +1000 Subject: [PATCH 25/34] Coastlines test --- docs/data/product/dea-coastlines/_data.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/data/product/dea-coastlines/_data.yaml b/docs/data/product/dea-coastlines/_data.yaml index cb9ec9536..0ec0ac542 100644 --- a/docs/data/product/dea-coastlines/_data.yaml +++ b/docs/data/product/dea-coastlines/_data.yaml @@ -76,6 +76,8 @@ access_links_code_examples: name: null - link: https://github.com/GeoscienceAustralia/dea-coastlines name: GitHub repository + - link: "#dea-maps" + name: "Test: DEA Maps" access_links_web_services: - link: https://geoserver.dea.ga.gov.au/geoserver/wms From 7e56fb07f8cf04e75d84eac470020b224bfa58c4 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 15:42:27 +1000 Subject: [PATCH 26/34] Testing links --- docs/conf.py | 3 ++- docs/guides/land-cover-explorer.md | 1 + 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 614b8cee4..c255743f3 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -96,7 +96,8 @@ "https": None, "ftp": None, "mailto": None, - "root": "https://pr-460-preview.khpreview.dea.ga.gov.au/{{uri}}", + "root": "/{{path}};{{params}}?{{query}}#{{fragment}}", + "rootb": "/{{path}}#{{fragment}}", } nbsphinx_requirejs_path = "" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index 3941455a2..db9ae0c8b 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -4,6 +4,7 @@ TESTS: * Target — [DEA Maps](#dea-maps) * `root:` — [DEA Maps](root:guides/setup/dea_maps/) +* `rootb:` — [DEA Maps](rootb:guides/setup/dea_maps/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From e0b898c626ccf13ee8809f793d06bf40e23d86c4 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 15:47:18 +1000 Subject: [PATCH 27/34] Coastlines test links --- docs/_templates/product-v2.rst | 4 ++++ docs/data/product/dea-coastlines/_data.yaml | 2 -- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index 98f9d78d1..7e8bde40f 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -279,6 +279,10 @@
+ :ref:`Test link DEA Maps 1 <#dea-maps>` + + :ref:`Test link DEA Maps 2 ` + .. include:: _overview_1.md :parser: myst_parser.sphinx_ diff --git a/docs/data/product/dea-coastlines/_data.yaml b/docs/data/product/dea-coastlines/_data.yaml index 0ec0ac542..cb9ec9536 100644 --- a/docs/data/product/dea-coastlines/_data.yaml +++ b/docs/data/product/dea-coastlines/_data.yaml @@ -76,8 +76,6 @@ access_links_code_examples: name: null - link: https://github.com/GeoscienceAustralia/dea-coastlines name: GitHub repository - - link: "#dea-maps" - name: "Test: DEA Maps" access_links_web_services: - link: https://geoserver.dea.ga.gov.au/geoserver/wms From aab2f5d9be34c37d2802c67bdb2d62479b55c9b7 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 15:51:06 +1000 Subject: [PATCH 28/34] Coastlines test links --- docs/_templates/product-v2.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index 7e8bde40f..21b24ee5e 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -279,9 +279,11 @@
- :ref:`Test link DEA Maps 1 <#dea-maps>` + :ref:`Test link DEA Maps 1 ` - :ref:`Test link DEA Maps 2 ` + :ref:`Test link DEA Maps 2 <#dea-maps>` + + :ref:`Test link DEA Maps 3 ` .. include:: _overview_1.md :parser: myst_parser.sphinx_ From 190c344a0431b13cc3ded868bf2c4e420a3f1043 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 15:52:46 +1000 Subject: [PATCH 29/34] Coastlines test links --- docs/_templates/product-v2.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index 21b24ee5e..1ceca05f4 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -284,6 +284,14 @@ :ref:`Test link DEA Maps 2 <#dea-maps>` :ref:`Test link DEA Maps 3 ` + + :doc:`Test link DEA Maps 4 ` + + :any:`Test link DEA Maps 5 ` + + :any:`Test link DEA Maps 6 <#dea-maps>` + + :any:`Test link DEA Maps 7 ` .. include:: _overview_1.md :parser: myst_parser.sphinx_ From 314e1c38efc6c1008d87397103fdd2018d3502c1 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 15:56:41 +1000 Subject: [PATCH 30/34] Test links --- docs/conf.py | 2 ++ docs/guides/land-cover-explorer.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/conf.py b/docs/conf.py index c255743f3..ca997305b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -98,6 +98,8 @@ "mailto": None, "root": "/{{path}};{{params}}?{{query}}#{{fragment}}", "rootb": "/{{path}}#{{fragment}}", + "rootc": "/#{{uri}}", + "rootd": "/#{{uri}}", } nbsphinx_requirejs_path = "" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index db9ae0c8b..bf6737078 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -5,6 +5,8 @@ TESTS: * Target — [DEA Maps](#dea-maps) * `root:` — [DEA Maps](root:guides/setup/dea_maps/) * `rootb:` — [DEA Maps](rootb:guides/setup/dea_maps/) +* `rootc:` — [DEA Maps](rootc:guides/setup/dea_maps/) +* `rootd:` — [DEA Maps](rootd:guides/setup/dea_maps/) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From ed8484518c88993820591b27f328eba5d8f9c24d Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 16:01:42 +1000 Subject: [PATCH 31/34] Test links --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index ca997305b..ec8cc8bb9 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -99,7 +99,7 @@ "root": "/{{path}};{{params}}?{{query}}#{{fragment}}", "rootb": "/{{path}}#{{fragment}}", "rootc": "/#{{uri}}", - "rootd": "/#{{uri}}", + "rootd": "/{{path}}?{{query}}#{{fragment}}", } nbsphinx_requirejs_path = "" From 41b0ddf6fde398e1c15b1262229d8b2b9d86fe4a Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 16:22:34 +1000 Subject: [PATCH 32/34] Test links --- docs/conf.py | 5 +---- docs/guides/land-cover-explorer.md | 8 ++++---- 2 files changed, 5 insertions(+), 8 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index ec8cc8bb9..718a905e6 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -96,10 +96,7 @@ "https": None, "ftp": None, "mailto": None, - "root": "/{{path}};{{params}}?{{query}}#{{fragment}}", - "rootb": "/{{path}}#{{fragment}}", - "rootc": "/#{{uri}}", - "rootd": "/{{path}}?{{query}}#{{fragment}}", + "root": "/{{path}}?{{query}}#{{fragment}}", } nbsphinx_requirejs_path = "" diff --git a/docs/guides/land-cover-explorer.md b/docs/guides/land-cover-explorer.md index bf6737078..ac3cd8d77 100644 --- a/docs/guides/land-cover-explorer.md +++ b/docs/guides/land-cover-explorer.md @@ -3,10 +3,10 @@ TESTS: * Target — [DEA Maps](#dea-maps) -* `root:` — [DEA Maps](root:guides/setup/dea_maps/) -* `rootb:` — [DEA Maps](rootb:guides/setup/dea_maps/) -* `rootc:` — [DEA Maps](rootc:guides/setup/dea_maps/) -* `rootd:` — [DEA Maps](rootd:guides/setup/dea_maps/) +* `root:` — [DEA Coastlines](root:data/product/dea-coastlines/) +* `root:` — [DEA Coastlines](root:data/product/dea-coastlines/#key-specifications) +* `root:` — [DEA Coastlines](root:data/product/dea-coastlines/?tab=specifications) +* `root:` — [DEA Coastlines](root:data/product/dea-coastlines/?tab=specifications#product-information) [Land Cover Explorer][Explorer] is a web application in the [Digital Atlas of Australia](https://digital.atlas.gov.au/), developed by Esri. It allows you to navigate and visualise the [DEA Land Cover][LandCover] datasets. (This is an easy alternative to [plotting Land Cover data yourself](/notebooks/DEA_products/DEA_Land_Cover/).) From cf385938015f6a372035e3b0e82a189690fd01f5 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 16:24:56 +1000 Subject: [PATCH 33/34] Test links --- docs/_templates/product-v2.rst | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-) diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index 1ceca05f4..fb1d7e3f7 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -279,19 +279,9 @@
- :ref:`Test link DEA Maps 1 ` + :any:`Test link DEA Maps ` - :ref:`Test link DEA Maps 2 <#dea-maps>` - - :ref:`Test link DEA Maps 3 ` - - :doc:`Test link DEA Maps 4 ` - - :any:`Test link DEA Maps 5 ` - - :any:`Test link DEA Maps 6 <#dea-maps>` - - :any:`Test link DEA Maps 7 ` + :any:`Test link DEA Maps ` .. include:: _overview_1.md :parser: myst_parser.sphinx_ From 4012ded2b18f14566734f4b48bf9af422f51a3f5 Mon Sep 17 00:00:00 2001 From: Benji Glitsos Date: Tue, 6 May 2025 16:47:03 +1000 Subject: [PATCH 34/34] Testing links --- docs/_templates/product-v2.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index fb1d7e3f7..56665cc40 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -282,7 +282,13 @@ :any:`Test link DEA Maps ` :any:`Test link DEA Maps ` - + + :any:`DEA Coastlines ` + + :any:`DEA Coastlines ` + + :any:`DEA Coastlines ` + .. include:: _overview_1.md :parser: myst_parser.sphinx_