Posts tagged: markata

- Markata got a shout out part way through the latest episode of LNL, I will go back, re-listen and take some of the feedback. His thoughts on Markata were interesting. On one hand it really is a thing for me that works for me, and as a person with too many side projects I don’t have the focus to really give it polish. On the other hand it really confirms why listen to podcasts, news, finger on the pulse, opinions and how often these guys are wrong, they are not the expert they probably look at 6 things like this a week. He said that it was some sort of javascript thing, that maybe he could fix or customize with javascript if he wanted, kinda shocking, I thought maybe I accidentally added node modules or something dumb, nope, I have a whopping 1.4% js. So most of the comments were plain wrong. I get it he probably peeked at it for 30s and realized it wasn’t the thing for his problem. At the same time I should probably do a better job at marketing what it really is, cleaning up the docs and demo. Note This post is a thought [1]. It’s a short note that I make about someone else’s content online #thoughts References: [1]: /thoughts/

I was looking back at my analytics [1] page today and wondered what were my posts about back at the beginning. My blog is managed by markata [2] so I looked at a few ways you could pull those posts up. Turns out it’s pretty simple to do, use the markata map with a filter. from markata import Markata m.map('title, slug, date', filter='date.year==2016', sort='date') Note the filter is python eval that should evaluate to a boolean, all of the attributes of the post are available to filter on. Result # [3] [ ('⭐ jupyterlab jupyterlab', 'jupyterlab-jupyterlab', datetime.date(2016, 12, 13)), ('⭐ nickhould tidy-data-python', 'nickhould-tidy-data-python', datetime.date(2016, 12, 9)), ( '⭐ mikeckennedy write-pythonic-code-demos', 'mikeckennedy-write-pythonic-code-demos', datetime.date(2016, 11, 22) ), ( '⭐ mikeckennedy write-pythonic-code-for-better-data-science-webcast', 'mikeckennedy-write-pythonic-code-for-better-data-science-webcast', datetime.date(2016, 11, 22) ), ('⭐ rajshah4 dlgroup', 'rajshah4-dlgroup', datetime.date(2016, 11, 18)), ('⭐ pandas-dev pandas', 'pandas-dev-pandas', datetime.date(2016, 10, 5)) ] You could use the list command as well right within y...

I just implemented a latest blog post link in Markata by asking for the first post slug from the blog feed. The implementation uses the jinja_md plugin to render jinja against the markdown and a tag to redirect. My latest blog post is [[ {{ markata.feeds.blog.posts[0].slug }} ]]. Click the link if you are not automatically redirected. <meta http-equiv="Refresh" content="0; url='/{{ markata.feeds.blog.posts[0].slug }}'" /> Setting up the feed # [1] Feeds are setup in markata.toml configuration. They provide a handy way to create an html [2] feed, rss feed, and quickly reference a filtered set of posts like this. # you will need to enable the jinja_md plugin along with the defaults [markata] hooks = [ "markata.plugins.jinja_md", "default", ] # set up the blog feed [[markata.feeds]] slug = 'blog' template = "feed.html" filter = "date<=today and templateKey in ['blog-post'] and published" sort = "date" reverse = true For more information on markata check out the full markata [3] post. References: [1]: #setting-up-the-feed [2]: /html/ [3]: /markata/

- 11ty https://www.rockyourcode.com/how-to-deploy-eleventy-to-github-pages-with-github-actions/ - hugo puts it in the base url https://gohugo.io/getting-started/configuration/#baseurl - mkdocs uses a special cli build command https://squidfunk.github.io/mkdocs-material/publishing-your-site/#github-pages

Markata now allows you to create jinja extensions that will be loaded right in with nothing more than a pip install. From the Changelog # [1] The entry for 0.5.0.dev2 from markata’s changelog [2] - Created entrypoint hook allowing for users to extend marka with jinja exensions #60 0.5.0.dev2 [3] markata-gh # [4] The first example that you can use right now is markata-gh. It will render repos by GitHub topic and user using the gh cli, which is available in github actions! Get it with a pip install pip install markata-gh Use it with some jinja in your markdown. ## Markata plugins It uses the logged in uer by default. {% gh_repo_list_topic "markata" %} You can more explicitly grab your username, and a topic. {% gh_repo_list_topic "waylonwalker", "personal-website" %} How is this achieved # [5] The jinja extension details are for another post, but this is how markata-gh exposes itslef as a jinja extension. class GhRepoListTopic(Extension): tags = {"gh_repo_list_topic"} def __init__(self, environment): super().__init__(environment) def parse(self, parser): line_number = next(parser.stream).lineno try: args = parser.parse_tuple().items except AttributeError: ...

Markata now uses hatch as its build backend, and version bumping tool. setup.py, and setup.cfg are completely gone. [1] 0.5.0 is big # [2] Markata 0.5.0 is now out, and it’s huge. Even though it’s the backend of this blog I don’t actually have that many posts directly about it. I’ve used it a bit for blog fuel in generic ways, like talking about pluggy and diskcache, but very little have I even mentioned it. Over the last month I made a big push to get 0.5.0 out, which adds a whole bunch of new configurability to markata. Here’s the changelog [3] entry. - Moved to PEP 517 build #59 0.5.0.dev1 My Personal Simple CI/CD # [4] Before cutting all of my personal projects over to hatch. The first thing I did was to setup a solid github action, hatch-action [5]that I can resue. It automatically bumps versions, using pre-releases on all branches other than main, with special branches for bumping major, minor, patch, dev, alha, beta, and dev. hatch new –init # [6] To convert the project over to hatch, and get rid of setup.py/setup.cfg, I ran hatch new --init. This automatically grabs all the metadata for the project and makes a pyproject.toml that has most of what I need. hat...

[1] A long needed feature of markata has been the ability to really configure out templates with configuration rather. It’s been long that you needed that if you really want to change the style, meta tags, or anything in the head you needed to write a plugin or eject out of the template and use your own. Adding some Head # [2] Now you can add some extra style to your site with the existing built-in template. [[markata.head]] text = """ <style> img { width: 100%; height: auto; } ul { display: flex; flex-wrap: wrap; } </style> """ You can have more than one Head # [3] Each text entry in markata.head just gets appended raw into the head. [[markata.head]] text = """ <style> img { width: 100%; height: auto; } ul { display: flex; flex-wrap: wrap; } </style> """ [[markata.head]] text = """ <script> console.log('hey there') </script """ Still need more? # [4] If this does not take you far enough yet, you can still eject out and use your own template pretty easy. If you are going for a full custom site it’s likely that this will be the workflow for awhile. Markata should only get better and make this required less often as it matures. [markata] post_template = "pages/tem...

Markata is a great python framework that allows you to go from markdown to a full website very quickly. You can get up and running with nothing more than Markdown. It is also built on a full plugin architecture, so if there is extra functionality that you want to add, you can create a plugin to make it behave like you want. Full transparancy… I built markata. The talk # [1] The talk is live on YouTube. Make sure you check out the other videos from the conference. There were quite a few quality talks that deserve a watch as well. https://youtu.be/Wq9YBamSgs0 [2] References: [1]: #the-talk [2]: https://stable-diffusion.waylonwalker.com/000221.1721400243.webp

[1] a sprinter edging out his opponent by Dall-e It’s about time to release Markata 0.3.0. I’ve had 8 pre-releases since the last release, but more importantly it has about 3 months of updates. Many of which are just cleaning up bad practices that were showing up as hot spots on my pyinstrument reports Markata started off partly as a python developer frustrated with using nodejs for everything, and a desire to learn how to make frameworks in pluggy. Little did I know how flexible pluggy would make it. It started out just as my blog generator, but has turned into quite a bit more. Over time this side project has grown some warts and some of them were now becoming a big enough issue it was time to cut them out. Let’s compare # [2] I like to use my tils articles for examples and tests like this as there are enough articles for a good test, but they are pretty short and quick to render. mkdir ~/git/tils/tils cp ~/git/waylonwalker.com/pages/til/ ~/tils/tils -r cd ~/git/tils/tils running tils on 0.2.0 # [3] At the time of writing this is the current version of markata, so just make a new venv and run it. python3 -m venv .venv --prompt $(basename $PWD) pip install markata mark...