{"id":19120867,"url":"https://github.com/waylonwalker/markata-blog-starter","last_synced_at":"2025-05-05T16:25:21.449Z","repository":{"id":60661575,"uuid":"502223175","full_name":"WaylonWalker/markata-blog-starter","owner":"WaylonWalker","description":"Markata Blog Starter","archived":false,"fork":false,"pushed_at":"2023-07-06T04:23:34.000Z","size":738,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T10:28:02.527Z","etag":null,"topics":["hacktoberfest","markata","markata-starter","markdown","web"],"latest_commit_sha":null,"homepage":"https://blog-starter.markata.dev/","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WaylonWalker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-06-11T01:36:57.000Z","updated_at":"2023-01-20T14:29:19.000Z","dependencies_parsed_at":"2025-04-19T02:32:12.705Z","dependency_job_id":"f9ead434-5852-4441-b078-ac7fb710459b","html_url":"https://github.com/WaylonWalker/markata-blog-starter","commit_stats":null,"previous_names":[],"tags_count":3,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaylonWalker%2Fmarkata-blog-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaylonWalker%2Fmarkata-blog-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaylonWalker%2Fmarkata-blog-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WaylonWalker%2Fmarkata-blog-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WaylonWalker","download_url":"https://codeload.github.com/WaylonWalker/markata-blog-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252532707,"owners_count":21763459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","markata","markata-starter","markdown","web"],"created_at":"2024-11-09T05:15:16.298Z","updated_at":"2025-05-05T16:25:21.434Z","avatar_url":"https://github.com/WaylonWalker.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# markata-blog-starter\n\nThis is a blog starter for the python static site generator `markata`.\n\n## New blog from template\n\nThe markata cli includes a `new` command that will present you with questions\nto fill in the jinja variables in this repo.\n\n``` bash\npipx install markata\nmarkata new blog [directory]\n```\n\nAlternatively using copier directly\n\n``` bash\npipx install copier\npip install copier\n\ncopier git+https://github.com/WaylonWalker/markata-blog-starter [directory]\n```\n\n\u003e Note: make sure you specify the [directory] that youu want your site to be\n\u003e created into, not [directory]\n\n## Installation\n\nThis site comes with a `pyproject.toml` that can be used by hatch to\nautomatically take care of your virtual environments for you.\n\n``` bash\npip install hatch\n```\n\n## Building the site, Leveraging Hatch\n\nHatch comes with a nice system for creating scirpts that you can run in your\nmanaged virtual environment with less effort of managing.  You can create any\nthat you want in your own `pyproject.toml`, but these come with the template\nout of the box.\n\n``` bash\n# builds the site\nhatch run build\n\n# clean's cache and output directory\nhatch run clean\n\n# clean's cache and output directory, and builds\nhatch run clean-build\n\n# runs a development server, watches for changes and rebuilds.\nhatch run tui\n\n# run's clean then start's the tui\nhatch run clean-tui\n```\n\n\u003e Hatch takes care of the venv for you\n\n## Building the site, vanilla\n\nYou will want to install everything in a virtual environment to prevent\nyourself from clogging up your system python, or trying to run two versions of\n`markata` for different projects.\n\n``` bash\n# using hatch for the virtual environment\nhatch shell\n\n# using venv\npython -m venv .venv\n. ./.venv/bin/activate\npip install -e .\n```\n\nOnce you have your virtual environment created and activated you can use the\nmarkata cli plugin to build your site.\n\n``` bash\n# builds the site\nmarkata build\n\n# clean's cache and output directory\nmarkata clean\n\n# runs a development server, watches for changes and rebuilds.\nmarkata tui\n```\n\n## repl or script\n\nIt's also possible to run the build from a repl like ipython or a python\nscript.\n\n``` python\nfrom markata import Markata\n\nm = Markata()\nm.run()\n```\n\n## License\n\n`markata-blog-starter` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaylonwalker%2Fmarkata-blog-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaylonwalker%2Fmarkata-blog-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaylonwalker%2Fmarkata-blog-starter/lists"}