doc: add Zoomin info banner to doc

Add a banner on top informing about the transition to the Zoomin documentation platform. Signed-off-by: Bartosz Gentkowski <[email protected]>
nrfconnect · Oct 5, 2023 · d0e6d51 · d0e6d51
1 parent 1226be9
commit d0e6d51
Show file tree

Hide file tree

Showing 9 changed files with 23 additions and 0 deletions.
diff --git a/doc/_utils/utils.py b/doc/_utils/utils.py
@@ -128,3 +128,18 @@ def add_google_analytics(app: Sphinx, options: dict) -> None:
 
     options["add_gtm"] = True
     options["gtm_id"] = "GTM-WF4CVFX"
+
+def add_announcement_banner(options: dict) -> None:
+    """Add an announcement banner to the top of the page.
+    Args:
+        options: html theme options.
+    """
+
+    msg = "<b>Important: </b>We're excited to introduce our new technical documentation " \
+           "platform <a href=\"https://docs.nordicsemi.com/\">docs.nordicsemi.com</a>, " \
+           "currently in Beta version. We invite you to explore it and share your feedback. " \
+           "Read more on our " \
+           "<a href=\"https://devzone.nordicsemi.com/nordic/nordic-blog/b/blog/posts/introducing-the-unified-documentation-portal/\">DevZone blog</a>. " \
+
+    options["set_default_announcement"] = True
+    options["default_announcement_message"] = msg
diff --git a/doc/kconfig/conf.py b/doc/kconfig/conf.py
@@ -72,3 +72,4 @@ def setup(app):
     app.add_css_file("css/kconfig.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/matter/conf.py b/doc/matter/conf.py
@@ -71,3 +71,4 @@ def setup(app):
     app.add_css_file("css/matter.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/mcuboot/conf.py b/doc/mcuboot/conf.py
@@ -90,3 +90,4 @@
 
 def setup(app):
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/nrf/conf.py b/doc/nrf/conf.py
@@ -226,3 +226,4 @@ def setup(app):
     app.add_css_file("css/nrf.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/nrfx/conf.py b/doc/nrfx/conf.py
@@ -70,3 +70,4 @@
 
 def setup(app):
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/nrfxlib/conf.py b/doc/nrfxlib/conf.py
@@ -106,3 +106,4 @@ def setup(app):
     app.add_css_file("css/nrfxlib.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/tfm/conf.py b/doc/tfm/conf.py
@@ -81,3 +81,4 @@ def setup(app):
     app.add_css_file("css/tfm.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)
diff --git a/doc/zephyr/conf.py b/doc/zephyr/conf.py
@@ -82,3 +82,4 @@ def setup(app):
     app.add_css_file("css/zephyr.css")
 
     utils.add_google_analytics(app, html_theme_options)
+    utils.add_announcement_banner(html_theme_options)