pluglet stub (#87)

mkdocs-macros-plugin pluglet stub

Author: ntno

documentation/docs/about/debug.md

@@ -17,4 +17,9 @@ tiles:
     link_href: https://picsum.photos/ 
 ---
 
-# Debug Markdown Experiments
+# Debug Markdown Experiments
+
+{{grid(page.meta.tiles)}}
+
+---
+{{ macros_info() }}

documentation/local.yml

@@ -19,7 +19,12 @@ plugins:
   - terminal/md-to-html
   - git-revision-date
   - search
+  - macros:
+      verbose: true
+      modules: [mkdocs-terminal:terminal.pluglets.tile_grid]
 
 watch:
-  - '../terminal'
+  - '../terminal/partials'
+  - '../terminal/macros'
+  - '../terminal/pluglets'
   - './mkdocs.yml'

documentation/requirements.txt

@@ -8,3 +8,4 @@ pymdown-extensions>=9.9
 # MkDocs Plugins
 mkdocs-git-revision-date-plugin
 mkdocs-exclude-search
+mkdocs-macros-plugin>0.5.10

package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "mkdocs-terminal",
-    "version": "3.4.0",
+    "version": "3.5.0",
     "description": "Terminal.css theme for MkDocs",
     "keywords": [
         "mkdocs",

package.json

@@ -20,8 +20,7 @@ classifiers = [
   "Programming Language :: Python",
   "Topic :: Documentation",
   "Topic :: Software Development :: Documentation",
-  "Topic :: Text Processing :: Markup :: HTML",
-  "Intended Audience :: Developers"
+  "Topic :: Text Processing :: Markup :: HTML"
 ]
 
 [project.urls]

pyproject.toml

@@ -0,0 +1,9 @@
+from terminal.pluglets.tile_grid.util import grid
+
+
+def define_env(env):
+    "Declare environment for jinja2 templates for markdown"
+    chatter = env.start_chatting("terminal.pluglets.tile_grid")
+    for fn in [grid]:
+        env.macro(fn)
+        chatter("added %s macro" % fn.__name__)

terminal/pluglets/tile_grid/__init__.py

@@ -0,0 +1,4 @@
+def grid(tiles):
+    if tiles is not None:
+        return "TODO: " + str(len(tiles))
+    return "invalid_tiles"

terminal/pluglets/tile_grid/util.py

@@ -1 +1 @@
-<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-terminal-3.4.0">
+<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-terminal-3.5.0">

terminal/theme_version.html

@@ -0,0 +1,8 @@
+from terminal.pluglets.tile_grid.util import grid
+
+
+class TestTileGridPluglet():
+
+    def test_null_input(self):
+        macro_output = grid(None)
+        assert macro_output == "invalid_tiles"