experimental: internal theme plugin (#82)

* initial markdown to html plugin based on byrnereese/mkdocs-markdown-filter
* works
* reorder to match squidfunk/mkdocs-material plugin setup

Author: ntno

Makefile

@@ -71,6 +71,10 @@ tox: install-tox install-test-prereqs
 check-version-match:
 	cat terminal/theme_version.html | grep -s --silent $(version)\"\>\$$ -o 
 
+install-from-dist: build-theme
+	pip uninstall mkdocs-terminal
+	pip install dist/*.tar.gz
+
 #for developer use, assumes you have already installed prereqs
 quick-tests:
 	flake8 --ignore E501 && \

NOTES.md

@@ -50,3 +50,7 @@ Terminal for MkDocs' Tile Grid relies on the *meta*[^mkdocs-page-meta] attribute
 ### img tile
 `<div .*? <figure(.)[^>]*? <img(.)*`
 
+
+
+[project.entry-points."mkdocs.plugins"]
+# markdown-filter = "mkdocs_markdown_filter.plugin:MarkdownFilterPlugin"

documentation/docs/about/debug.md

@@ -0,0 +1,20 @@
+---
+tiles:
+  - caption: '*@petradr*'
+    img_src: ../../../img/picsum/167_200x200.jpeg
+    img_title: 'to Picsum homepage'
+    img_alt: 'close up image of fallen leaves'
+    link_href: https://picsum.photos/ 
+  - caption: 'Marcin **C**zerwinski'
+    img_src: ../../../img/picsum/127_200x200.jpeg
+    img_title: 'to Picsum homepage'
+    img_alt: 'close up image of green moss on a log'
+    link_href: https://picsum.photos/ 
+  - caption: 'Steve Richey'
+    img_src: ../../../img/picsum/143_200x200.jpeg
+    img_title: 'to Picsum homepage'
+    img_alt: 'overhead image of fallen leaves'
+    link_href: https://picsum.photos/ 
+---
+
+# Debug Markdown Experiments

documentation/local.yml

@@ -15,6 +15,10 @@ theme:
   static_templates:
     - 404.html
 
+plugins:
+  - git-revision-date
+  - search
+
 watch:
   - '../terminal'
   - './mkdocs.yml'

documentation/mkdocs.yml

@@ -49,6 +49,8 @@ nav:
       - Typography: 'elements/typography.md'
     - Install: 'install.md'
     - Releases: 'releases.md'
+    # - About: 
+    #   - Debug: 'about/debug.md'
 
 markdown_extensions:
   # Python Markdown  

package-lock.json

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

package.json

@@ -28,6 +28,9 @@ classifiers = [
 Source = "https://github.com/ntno/mkdocs-terminal"
 Issues = "https://github.com/ntno/mkdocs-terminal/issues"
 
+[project.entry-points."mkdocs.plugins"]
+"terminal/md-to-html" = "terminal.plugins.md_to_html.plugin:MarkdownToHtmlFilterPlugin"
+
 [project.entry-points."mkdocs.themes"]
 terminal = "terminal"
 

pyproject.toml

@@ -18,7 +18,7 @@
 [open-source-template](https://github.com/auth0/open-source-template/blob/master/LICENSE) by [@auth0](https://github.com/auth0)  
 
 [mkdocs/mkdocs](https://github.com/mkdocs/mkdocs/blob/master/LICENSE)  
-```
+```text
 Copyright © 2014-present, Tom Christie. All rights reserved.
 
 Redistribution and use in source and binary forms, with or
@@ -87,3 +87,24 @@ POSSIBILITY OF SUCH DAMAGE.
 ```text
 Creative Commons ― CC BY 3.0
 ```
+
+[mkdocs-markdown-filter](https://github.com/byrnereese/mkdocs-markdown-filter/blob/master/LICENSE)  by [Byrne Reese](https://github.com/byrnereese)
+```text
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```