From 0d5b5b187d61d882eb51e15e9f536d89a040447d Mon Sep 17 00:00:00 2001
From: Sebastian Golebiewski <sebastianx.golebiewski@intel.com>
Date: Wed, 15 Mar 2023 15:23:20 +0100
Subject: [PATCH] [DOCS] Adding 'Scrollbox' - new sphinx directive (#15305)

---
 .../openvino_sphinx_theme/__init__.py         |  8 ++-
 .../openvino_sphinx_theme/directives/code.py  | 60 ++++++++++++++++++-
 .../static/css/openvino_sphinx_theme.css      |  7 +++
 3 files changed, 73 insertions(+), 2 deletions(-)

diff --git a/docs/openvino_sphinx_theme/openvino_sphinx_theme/__init__.py b/docs/openvino_sphinx_theme/openvino_sphinx_theme/__init__.py
index 5c0306b1c4f..59da0bba524 100644
--- a/docs/openvino_sphinx_theme/openvino_sphinx_theme/__init__.py
+++ b/docs/openvino_sphinx_theme/openvino_sphinx_theme/__init__.py
@@ -9,7 +9,7 @@ from pathlib import Path
 from bs4 import BeautifulSoup
 from sphinx.util import logging
 from pydata_sphinx_theme import index_toctree
-from .directives.code import DoxygenSnippet
+from .directives.code import DoxygenSnippet, Scrollbox, Nodescrollbox, visit_scrollbox, depart_scrollbox
 
 SPHINX_LOGGER = logging.getLogger(__name__)
 
@@ -219,4 +219,10 @@ def setup(app):
     app.connect('env-before-read-docs', read_doxygen_configs)
     app.add_html_theme('openvino_sphinx_theme', theme_path)
     rst.directives.register_directive('doxygensnippet', DoxygenSnippet)
+    rst.directives.register_directive('scrollbox', Scrollbox)
+    app.add_node(
+        Nodescrollbox,
+        html=(visit_scrollbox, depart_scrollbox),
+        latex=(visit_scrollbox, depart_scrollbox)
+    )
     return {'parallel_read_safe': True, 'parallel_write_safe': True}
diff --git a/docs/openvino_sphinx_theme/openvino_sphinx_theme/directives/code.py b/docs/openvino_sphinx_theme/openvino_sphinx_theme/directives/code.py
index ba4412d92ab..5ef2c5ff667 100644
--- a/docs/openvino_sphinx_theme/openvino_sphinx_theme/directives/code.py
+++ b/docs/openvino_sphinx_theme/openvino_sphinx_theme/directives/code.py
@@ -2,7 +2,7 @@ import os.path
 
 from sphinx.directives.code import LiteralInclude, LiteralIncludeReader, container_wrapper
 from sphinx.util import logging
-from docutils.parsers.rst import directives
+from docutils.parsers.rst import Directive, directives
 from typing import List, Tuple
 from docutils.nodes import Node
 from docutils import nodes
@@ -74,3 +74,61 @@ class DoxygenSnippet(LiteralInclude):
             return [retnode]
         except Exception as exc:
             return [document.reporter.warning(exc, line=self.lineno)]
+
+
+def visit_scrollbox(self, node):
+    attrs = {}
+    attrs["style"] = (
+        (("height:" + "".join(c for c in str(node["height"]) if c.isdigit()) + "px!important; " ) if "height" in node is not None else "")
+        + (("width:" + "".join(c for c in str(node["width"]) if c.isdigit()) ) if "width" in node is not None else "")
+        + (("px; " if node["width"].find("px") != -1 else "%;") if "width" in node is not None else "")
+        + ( ("border-left:solid "+"".join(c for c in str(node["delimiter"]) if c.isdigit())+ "px " + (("".join(str(node["delimiter-color"]))) if "delimiter-color" in node is not None else "#dee2e6") +"; ") if "delimiter" in node is not None else "")
+    )
+    attrs["class"] = "scrollbox"
+    self.body.append(self.starttag(node, "div", **attrs))
+
+
+def depart_scrollbox(self, node):
+    self.body.append("</div>\n")
+
+
+class Nodescrollbox(nodes.container):
+    def create_scrollbox_component(
+        rawtext: str = "",
+        **attributes,
+    ) -> nodes.container:
+        node = nodes.container(rawtext, is_div=True, **attributes)
+        return node
+
+
+class Scrollbox(Directive):
+    has_content = True
+    required_arguments = 0
+    optional_arguments = 1
+    final_argument_whitespace = True
+    option_spec = {
+        'name': directives.unchanged,
+        'width': directives.length_or_percentage_or_unitless,
+        'height': directives.length_or_percentage_or_unitless,
+        'style': directives.unchanged,
+        'delimiter': directives.length_or_percentage_or_unitless,
+        'delimiter-color': directives.unchanged,
+    }
+
+    has_content = True
+
+    def run(self):
+        classes = ['scrollbox','']
+        node = Nodescrollbox("div", rawtext="\n".join(self.content), classes=classes)
+        if 'height' in self.options:
+            node['height'] = self.options['height']
+        if 'width' in self.options:
+            node['width'] = self.options['width']
+        if 'delimiter' in self.options:
+            node['delimiter'] = self.options['delimiter']
+        if 'delimiter-color' in self.options:
+            node['delimiter-color'] = self.options['delimiter-color']
+        self.add_name(node)
+        if self.content:
+            self.state.nested_parse(self.content, self.content_offset, node)
+        return [node]
diff --git a/docs/openvino_sphinx_theme/openvino_sphinx_theme/static/css/openvino_sphinx_theme.css b/docs/openvino_sphinx_theme/openvino_sphinx_theme/static/css/openvino_sphinx_theme.css
index f087505746d..2a6063da77b 100644
--- a/docs/openvino_sphinx_theme/openvino_sphinx_theme/static/css/openvino_sphinx_theme.css
+++ b/docs/openvino_sphinx_theme/openvino_sphinx_theme/static/css/openvino_sphinx_theme.css
@@ -55,6 +55,13 @@ body {
     border-color: rgb(var(--ost-color-primary));
 }
 
+/* Scrollbox Extension */
+
+.scrollbox {
+    overflow-y:scroll;
+    height:300px;
+}
+
 /* Syntax Highlighting */
 
 code {