Skip to content

Releases: WaylonWalker/markata

v0.9.1.dev8

14 Feb 02:45
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE
  • FIX: feeds now update with any content change
  • FIX: og tags should use property not name

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│              ...
Read more

v0.9.1.dev7

13 Feb 15:54
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE
  • FIX: feeds now update with any content change
  • FIX: og tags should use property not name

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│              ...
Read more

v0.9.1.dev6

13 Feb 15:06
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE
  • FIX: feeds now update with any content change

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html       ...
Read more

v0.9.1.dev5

09 Feb 16:56
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE
  • FIX: feeds now update with any content change

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html       ...
Read more

v0.9.1.dev4

06 Feb 14:20
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│              ...
Read more

v0.9.1.dev3

29 Jan 23:31
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│              ...
Read more

v0.9.1.dev2

29 Jan 21:44
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│              ...
Read more

v0.9.1.dev1

29 Jan 03:22
Compare
Choose a tag to compare

Markata Changelog

0.9.1

  • HUGE DOCS UPDATE

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Here are a couple of build times ran back to back on the same content with 0.8.2 and 0.9.0

Markata

63 posts

  • 0.9.0 - 4.308s cold - 1.457s hot
  • 0.8.2 - 9.063s cold - 1.542s hot

waylonwalker.com

exactly 2k posts

  • 0.9.0 - 69.200s cold - 2.860 hot
  • 0.8.2 - 479s cold - 4.683 hot

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│              ...
Read more

v0.9.0

29 Jan 03:15
Compare
Choose a tag to compare

Markata Changelog

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl            ...
Read more

v0.9.0.dev6

27 Jan 21:58
Compare
Choose a tag to compare

Markata Changelog

0.9.0

  • Feat: add skip plugin
  • Fix: wikilinks uses a faster and more robust link lookup
  • Feat: most plugins now only do work on posts not marked as skip
  • Fix: wikilinks now give good error messages to show you which article is throwing the warning

Performance Improvements

Core Optimizations

  • Added map cache with statistics tracking in Markata core
  • Optimized template rendering with bytecode caching
  • Parallelized markdown rendering and file loading
  • Added configurable cache expiration times for different components

Component-specific Optimizations

  • Updated auto_description to use markdown-it for better performance
  • Improved date parsing with dateparser fallback
  • Optimized post loading with bulk processing
  • Modernized pydantic validators to use new field_validator syntax

0.8.2

  • Fix: markata installs setuptools required by one dependency
  • Fix: cleaup cli output
  • Fix: speed up cli starup with some lazy imports
  • Fix: all cache.adds were replaced with cache.set
  • Fix: Updated to new typer format requiring name=
  • Fix: teardown only runs if a the build process was started, i.e. some clis
    will not need to teardown

0.8.1

Feeds have partials

The feeds plugin now has configurable partial_template that can be used to
render only the inside of the feeds page. This is indended to allow you to
load small feeds into a page with htmx.

Better Jinja Templates

Markata now fully supports jinja templates with a loader that will load from
your templates directory, the markata built-in templates, and from a
dynamically generated templates directory in your .markata.cache directory.

cli

You can list out your templates and configuration with the following command

markata templates show

Variables

The following variables are available within jinja templates for post
templates. This is now consistent accross all three built in plugins that
render jinja templates.

post_template
  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • body - the body of the post
  • post - the current post object
feeds

Similarly from within rendering feeds.

  • __version__ - the version of markata
  • markata - the markata instance
  • config - the markata config
  • posts - the list of posts
  • post - a pseudo post object with title, slug, description, and date for template consistency
  • feed - the current feed object
jinja_md

Similar to posts from within jinja_md to render a markdown post as a template.

  • __version__ - the version of markata
  • markata - the markata instance
  • body - the body of the post
  • config - the markata config
  • post - the current post object

Feeds cli

The feeds cli will help show which templates each feed will be using.

❯ markata feeds show
                                          Feeds 6
┏━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃            Feed ┃ posts ┃ config                                                        ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ project_gallery │ 2     │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Project Gallery                                        │
│                 │       │ slug: project-gallery                                         │
│                 │       │ name: project_gallery                                         │
│                 │       │ filter: 'project-gallery' in str(path)                        │
│                 │       │ sort: title                                                   │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│            docs │ 10    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Documentation                                          │
│                 │       │ slug: docs                                                    │
│                 │       │ name: docs                                                    │
│                 │       │ filter: "markata" not in slug and "tests" not in slug and ... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│         autodoc │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: AutoDoc Python Modules.                                │
│                 │       │ slug: autodoc                                                 │
│                 │       │ name: autodoc                                                 │
│                 │       │ filter: "markata" in slug and "plugin" not in slug and "te... │
│                 │       │ sort: slug                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│             all │ 73    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: All Markata Modules                                    │
│                 │       │ slug: all                                                     │
│                 │       │ name: all                                                     │
│                 │       │ filter: True                                                  │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl                                         │
│                 │       │                                                               │
│    core_modules │ 17    │ DEFAULT_TITLE: All Posts                                      │
│                 │       │ title: Markata Core Modules                                   │
│                 │       │ slug: core_modules                                            │
│                 │       │ name: core_modules                                            │
│                 │       │ filter: 'plugin' not in slug and 'test' not in slug and ti... │
│                 │       │ sort: date                                                    │
│                 │       │ reverse: False                                                │
│                 │       │ rss: True                                                     │
│                 │       │ sitemap: True                                                 │
│                 │       │ card_template: card.html                                      │
│                 │       │ template: feed.html                                           │
│                 │       │ rss_template: rss.xml                                         │
│                 │       │ sitemap_template: sitemap.xml                                 │
│                 │       │ xsl_template: rss.xsl            ...
Read more