ENH(sphinxext): +CSS to plot border * width %100

to help navigate zoom.

This reverts commit 4501d5e:
"DROP(sphinxext): CSS+importlib_resources are not really needed"

Author: ankostis

graphtik/sphinxext/__init__.py

@@ -7,6 +7,7 @@
 import re
 from collections import defaultdict
 from pathlib import Path
+from shutil import copyfileobj
 from typing import Dict, List, Set, Union, cast
 
 import sphinx
@@ -28,6 +29,12 @@
 
 from .. import __version__
 
+try:
+    import importlib.resources as pkg_resources
+except ImportError:
+    # Use backported to PY<3.7 `importlib_resources` lib.
+    import importlib_resources as pkg_resources
+
 obj_name = "graphtik diagram"
 role_name = "graphtik"
 log = logging.getLogger(__name__)
@@ -444,6 +451,26 @@ def _purge_old_document_images(app: Sphinx, env: BuildEnvironment, docname: str)
         env.graphtik_image_purgatory = DocFilesPurgatory()
 
 
+def _stage_my_pkg_resource(inp_fname, out_fpath):
+    with pkg_resources.open_binary(__package__, inp_fname) as inp, open(
+        out_fpath, "wb"
+    ) as out:
+        copyfileobj(inp, out)
+
+
+_css_fname = "graphtik.css"
+
+
+def _copy_graphtik_static_assets(app: Sphinx, exc: Exception) -> None:
+    """Callback of `build-finished`` event. """
+    if not exc and _should_work(app):
+        dst = Path(app.outdir, "_static", _css_fname)
+        ## Builder `latex` does not have _static folder.
+        #
+        if not dst.exists() and dst.parent.exists():
+            _stage_my_pkg_resource(_css_fname, dst)
+
+
 def _validate_and_apply_configs(app: Sphinx, config: Config):
     """Callback of `config-inited`` event. """
     config.graphtik_default_graph_format is None or _valid_format_option(
@@ -507,6 +534,9 @@ def setup(app: Sphinx):
     app.connect("config-inited", _validate_and_apply_configs)
     app.connect("doctree-read", _run_doctests_on_graphtik_document)
     app.connect("env-purge-doc", _purge_old_document_images)
+    app.connect("build-finished", _copy_graphtik_static_assets)
+
+    app.add_css_file(_css_fname)
 
     # Permanently set this, or else, e.g. +SKIP will not work!
     app.config.trim_doctest_flags = False

graphtik/sphinxext/graphtik.css

@@ -0,0 +1,10 @@
+/*
+ * Copyright 2020-2020, Kostis Anagnostopoulos;
+ * Licensed under the terms of the Apache License, Version 2.0. See the LICENSE file associated with the project for terms.
+ */
+
+/** Applied on IMG or OBJECT */
+.graphtik-zoomable-svg {
+    border-style: inset;
+    max-width: 100%;
+}

setup.py

@@ -15,7 +15,7 @@
 with io.open("graphtik/__init__.py", "rt", encoding="utf8") as f:
     version = re.search(r'__version__ = "(.*?)"', f.read()).group(1)
 
-plot_deps = ["pydot", "jinja2"]
+plot_deps = ["pydot", "jinja2", "importlib_resources; python_version<'3.7'"]
 matplot_deps = plot_deps + ["matplotlib"]
 sphinx_deps = plot_deps + ["sphinx >=2"]
 test_deps = list(
@@ -52,6 +52,7 @@
         "Bug Tracker": "https://github.com/pygraphkit/graphtik/issues",
     },
     packages=find_packages(exclude=["test"]),
+    package_data={"graphtik.sphinxext": ["*.css"]},
     python_requires=">=3.6",
     install_requires=[
         "contextvars; python_version < '3.7'",