Markata Supports Jinja Plugins 0.5.0.dev2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Markata now allows you to create jinja extensions that will be loaded right in with nothing more than a .

Date: October 11, 2022

Markata now allows you to create jinja extensions that will be loaded right in with nothing more than a pip install.

From the Changelog
──────────────────

The entry for 0.5.0.dev2 from markata’s changelog <https://markata.dev/changelog/>

- Created entrypoint hook allowing for users to extend marka with jinja exensions #60 0.5.0.dev2

Image: “cybernetic soldier working on a rusting tape machine robot, cinematic lighting, detailed, cell shaded, 4 k, warm colours, concept art, by wlop, ilya kuvshinov, artgerm, krenz cushart, greg rutkowski, pixiv. cinematic dramatic atmosphere, sharp focus, volumetric lighting, cinematic lighting, studio quality” -s50 -W832 -H416 -C12.0 -Ak_lms -S1808537114 <https://stable-diffusion.waylonwalker.com/000368.1808537114.webp> <https://stable-diffusion.waylonwalker.com/000368.1808537114.webp>

markata-gh
──────────

The first example that you can use right now is markata-gh. It will render repos by GitHub topic and user using the gh cli, which is available in github actions!

Get it with a pip install

[code]
  pip install markata-gh

Use it with some jinja in your markdown.

[code]
  ## Markata plugins

  It uses the logged in uer by default.

  {% gh_repo_list_topic "markata" %}

  You can more explicitly grab your username, and a topic.
  {% gh_repo_list_topic "waylonwalker", "personal-website" %}

How is this achieved
────────────────────

The jinja extension details are for another post, but this is how markata-gh exposes itslef as a jinja extension.

[code]
  class GhRepoListTopic(Extension):
      tags = {"gh_repo_list_topic"}

      def __init__(self, environment):
          super().__init__(environment)

      def parse(self, parser):
          line_number = next(parser.stream).lineno
          try:
              args = parser.parse_tuple().items
          except AttributeError:
              raise AttributeError(
                  "Invalid Syntax gh_repo_list_topic expects <username>, or <username>,<topic> both must have the comma"
              )

          return nodes.CallBlock(self.call_method("run", args), [], [], "").set_lineno(
              line_number
          )

      def run(self, username=None, topic=None, caller=None):
          "get's markdown to inject into post"
          return repo_md(username=username, topic=topic)

Image: “cybernetic soldier working on a rusting tape machine robot, cinematic lighting, detailed, cell shaded, 4 k, warm colours, concept art, by wlop, ilya kuvshinov, artgerm, krenz cushart, greg rutkowski, pixiv. cinematic dramatic atmosphere, sharp focus, volumetric lighting, cinematic lighting, studio quality” -s50 -W832 -H416 -C12.0 -Ak_lms -S2487720618 <https://stable-diffusion.waylonwalker.com/000368.2487720618.webp>

Entrypoints
───────────

Then markata-gh exposes itself as an extension through entrypoints.

### Creating entrypoints in pyproject.toml

If your project is using pyproject.toml for packaging you can setup an entrypoint as follows.

[code]
  [project.entry-points."markata.jinja_md"]
  markta_gh = "markata_gh.repo_list:GhRepoListTopic"

Creating entrypoints in setup.py
────────────────────────────────

If your project is using setup.py for packaging you can setup an entrypoint as follows.

[code]
  setup(
      ...
      entry_points={
          "markata.jinja_md": ["markta_gh" = "markata_gh.repo_list:GhRepoListTopic"]
      },
      ...
  )

Image: “cybernetic soldier working on a rusting tape machine robot, cinematic lighting, detailed, cell shaded, 4 k, warm colours, concept art, by wlop, ilya kuvshinov, artgerm, krenz cushart, greg rutkowski, pixiv. cinematic dramatic atmosphere, sharp focus, volumetric lighting, cinematic lighting, studio quality” -s50 -W832 -H416 -C12.0 -Ak_lms -S655826089 <https://stable-diffusion.waylonwalker.com/000368.655826089.webp>