公开记录中等
软件健康报告模式 0.23.0 · 指标 1.13.0 · 2026-07-21 20:32 UTC
fralau / mkdocs-macros-plugin
Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.
fralau/mkdocs-macros-plugin 的健康指数为 100 分中的 52 分，处于「中等」区间。 其得分最高的类别是Community & Adoption（62/100），最低的是Vitality（39/100）。 最近一次更新在 79 天前。 近期的大部分工作由 1 位贡献者完成。
52
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 49（有风险）的上限。AI 就绪度不计入总体分。
52
优秀85-100堪称典范；基本满足所有检验标准
良好70-84健康；仅有轻微不足
中等50-69可接受，但存在明显不足；建议进行审查
存在风险30-49存在重大薄弱环节；采用时应保持审慎
危急1-29问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 | 标签 |
|---|---|---|---|---|---|---|
| PyPI | mkdocs-macros-plugin指向其他仓库——不计分 | 1.5.0 | 2,917,195 | 38 | 250 天前 | macrosmarkdownmkdocspython |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
39
开发活跃度
36存在风险
评分方式
| 18/36 | 推送新近度 — 最近一次推送于 79 天前 |
| 5.5/36 | 提交节奏 — 52 周中有 8 周有提交 |
| 13/18 | 提交量 — 最近一年 27 次提交 |
| 0/10 | OpenSSF Scorecard：Maintained — 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
所用输入
| commits_last_year | 27 |
| human_commit_share | 1 |
| days_since_last_push | 79 |
| active_weeks_last_year | 8 |
发布纪律
44存在风险
评分方式
| 27/27 | 有发布版本 — 已发布 5 个发布版本 |
| 7.2/36 | 发布时效 — 最近一次发布版本于 625 天前 |
| 5.4/27 | 发布节奏 — 约每 455 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — 无数据 |
所用输入
| releases_count | 5 |
| latest_release_tag | v1.3.7 |
| releases_from_tags | 否 |
| days_since_latest_release | 625 |
| mean_days_between_releases | 455 |
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
62
流行度与采用
61中等
评分方式
| 42.3/60 | 星标 — 407 个星标 |
| 14.4/25 | 复刻 — 54 个复刻 |
| 3.9/15 | 关注者 — 6 位关注者 |
所用输入
| forks | 54 |
| stars | 407 |
| watchers | 6 |
| growth_state | organic |
| growth_factor_pct | 100 |
社区健康
64中等
评分方式
| 22.5/22.5 | README |
| 16.9/22.5 | 许可证 — 存在许可证文件，但不是可识别的许可证 |
| 18/18 | CONTRIBUTING 指南 |
| 0/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 0/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| has_contributing | 是 |
| has_issue_template | 否 |
| has_code_of_conduct | 否 |
| has_pull_request_template | 否 |
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
53
维护者韧性（巴士系数）
41存在风险
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 8.3/22.5 | 提交分布 — 头号贡献者编写了 63% 的提交 |
| 13.5/13.5 | 贡献者广度 — 34 位贡献者 |
| 10/10 | OpenSSF Scorecard：Contributors — project has 3 contributing companies or organizations -- score normalized to 10 |
所用输入
| bus_factor | 1 |
| contributors_sampled | 34 |
| top_contributor_share | 0.632 |
议题与 PR 响应能力
72良好
评分方式
| 45.5/46.8 | 议题解决 — 97% 的议题已关闭 |
| 27/38.3 | PR 接受 — 已裁定的 PR 中 43/61 已合并 |
| 0/15 | OpenSSF Scorecard：Code-Review — Found 2/30 approved changesets -- score normalized to 0 |
所用输入
| merged_prs | 43 |
| open_issues | 4 |
| closed_issues | 149 |
| issue_closed_ratio | 0.974 |
| closed_unmerged_prs | 18 |
所有权与托管责任
50中等
评分方式
| 10/30 | 所有权背书 — 个人（用户）账户 |
| 0/20 | 已验证域名 — 不适用于个人账户 |
| 10.1/25 | 所有者影响力 — fralau 有 24 位关注者 |
| 20.3/25 | 既往记录 — 13 个公开仓库，账户约 8 年 |
所用输入
| followers | 24 |
| owner_type | User |
| is_verified | — |
| owner_login | fralau |
| public_repos | 13 |
| account_age_days | 3,070 |
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。
工程质量
基础的工程与文档实践是否到位？
59
工程实践
48存在风险
评分方式
| 24/24 | CI 工作流 — 2 个工作流 |
| 24/24 | 存在测试 |
| 0/16 | Linter 配置 |
| 0/9.6 | Pre-commit 钩子 |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard：CI-Tests — 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 否 |
| has_linter_config | 否 |
| has_precommit_config | 否 |
文档
75良好
评分方式
| 30/30 | README |
| 0/25 | 文档目录 |
| 15/15 | 文档 / 主页站点 — https://mkdocs-macros-plugin.readthedocs.io |
| 10/10 | 仓库描述 |
| 10/10 | 主题标签 — 8 个主题标签 |
| 10/10 | Wiki |
所用输入
| topics | python, mkdocs, markdown, jinja2-templates, jinja2, documentation, mkdocs-macros-plugin, automation |
| has_wiki | 是 |
| homepage | https://mkdocs-macros-plugin.readthedocs.io |
| has_readme | 是 |
| has_docs_dir | 否 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
46
安全态势
32存在风险
评分方式
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 0/2.5 | CI-Tests — 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 2/30 approved changesets -- score normalized to 0 |
| 2.5/2.5 | Contributors — project has 3 contributing companies or organizations -- score normalized to 10 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.2/2.5 | 许可证 — license file detected |
| 0/7.5 | Maintained — 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
| 0/5 | Packaging — 无数据 |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — 无数据 |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 7.5/7.5 | Vulnerabilities — 0 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 3.2 |
已排除计分（无数据或不适用）：packaging, signed_releases。 其余权重已重新归一化。
依赖安全公告
100优秀
评分方式
| 35/35 | 直接依赖不含已知公告 — 没有直接依赖携带已知公告 |
| 25/25 | 间接依赖不含已知公告 — 没有间接依赖携带已知公告 |
| 0/40 | 没有长期未处理的公告 — 没有公告带有发布日期 |
所用输入
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 24 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
已排除计分（无数据或不适用）：没有长期未处理的公告。 其余权重已重新归一化。 比对的是 pypi:mkdocs-macros-plugin@1.5.0 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 24 个软件包。 未对可达性进行分析。
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？这是一枚独立的实验性徽章——权重为 0.0，因此单独呈现，不影响总体健康评分。
41
AI 代理上下文与指引
32存在风险
评分方式
| 0/45 | 代理指令 — 没有 CLAUDE.md / AGENTS.md / 编辑器规则 |
| 0/15 | 机器可读文档（llms.txt） |
| 31.5/40 | 可读的提交历史 — 100 次人类提交中有 59 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.59 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
验证循环（构建 / 测试 / 类型检查）
33存在风险
评分方式
| 0/18 | 一条命令的引导启动 |
| 22/22 | 自动化测试 |
| 0/11 | Lint / 格式化配置 |
| 11/11 | 静态类型检查 — mkdocs_macros/py.typed |
| 0/10 | 可复现环境 |
| 0/10 | 已体现的代理实践 — 最近 100 次提交中没有代理编写的提交 |
| 0/8 | 自动化维护 — 未观察到自动依赖更新 |
| 0/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | — |
| has_dockerfile | 否 |
| typed_language | 否 |
| bootstrap_files | — |
| has_devcontainer | 否 |
| has_linter_config | 否 |
| typecheck_configs | mkdocs_macros/py.typed |
| agent_commit_share | 0 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
82良好
评分方式
| 27/45 | 可类型检查的代码 — Python，已配置类型检查（mkdocs_macros/py.typed） |
| 55/55 | 可控的文件大小 — 采样的 35 个源文件中有 0 个超过 60KB |
所用输入
| primary_language | Python |
| largest_source_bytes | 36,133 |
| source_files_sampled | 35 |
| oversized_source_files | 0 |
关键数据
407GitHub 星标
34贡献者
27最近 12 个月提交数
79距最近推送天数
5发布版本数
1巴士系数（bus factor）
4开放议题
PyPI软件包生态系统数
数据采集警告
- pypi package 'mkdocs-macros-plugin' points at a different repository (https://github.com/fralau/mkdocs_macros_plugin); excluded from ecosystem scoring
更多细节
Star 与 Fork 历史 407 ★ / 54 ⇿
407Star
54Fork
5发布
每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。
主版本 0次版本 3修订 2
每个点涵盖 8 天。
OpenSSF Scorecard 3.2 / 10
3.2综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 0 | CI-Tests | 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 2/30 approved changesets -- score normalized to 0 |
| 10 | Contributors | project has 3 contributing companies or organizations -- score normalized to 10 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 9 | License | license file detected |
| 0 | Maintained | 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
| 不适用 | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| 不适用 | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
直接依赖 10
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| PyPI | hjson | — | pyproject.toml |
| PyPI | jinja2 | — | pyproject.toml |
| PyPI | mkdocs | >=0.17 | pyproject.toml |
| PyPI | packaging | — | pyproject.toml |
| PyPI | pathspec | — | pyproject.toml |
| PyPI | python-dateutil | — | pyproject.toml |
| PyPI | pyyaml | — | pyproject.toml |
| PyPI | requests | — | pyproject.toml |
| PyPI | super-collections | >= 0.6.2 | pyproject.toml |
| PyPI | termcolor | — | pyproject.toml |
全部依赖 13
来自 GitHub 依赖图的完整解析依赖集合：10 个直接依赖与 3 个间接（传递）软件包。仓库提交锁文件时，传递闭包才是完整的。
| 注册表 | 软件包 | 版本 | 关系 |
|---|---|---|---|
| PyPI | hjson | — | 直接 |
| PyPI | jinja2 | — | 直接 |
| PyPI | mkdocs | — | 直接 |
| PyPI | packaging | — | 直接 |
| PyPI | pathspec | — | 直接 |
| PyPI | python-dateutil | — | 直接 |
| PyPI | pyyaml | — | 直接 |
| PyPI | requests | — | 直接 |
| PyPI | super-collections | — | 直接 |
| PyPI | termcolor | — | 直接 |
| PyPI | mkdocs-include-markdown-plugin | — | 间接 |
| PyPI | mkdocs-material | — | 间接 |
| PyPI | mkdocs-mermaid2-plugin | — | 间接 |
依赖安全公告 0
安装 pypi:mkdocs-macros-plugin@1.5.0 会引入 24 个包（直接与传递）：其中 0 个存在已知公告，0 个为直接依赖。
没有已知公告影响已评估的依赖。
公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析，且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。
原始 JSON 报告 机器可读
{
"data": {
"repo": {
"topics": [
"python",
"mkdocs",
"markdown",
"jinja2-templates",
"jinja2",
"documentation",
"mkdocs-macros-plugin",
"automation"
],
"is_fork": false,
"size_kb": 750,
"has_wiki": true,
"homepage": "https://mkdocs-macros-plugin.readthedocs.io",
"languages": {
"Shell": 1438,
"Python": 90820
},
"pushed_at": "2026-05-03T17:40:07Z",
"created_at": "2018-06-27T15:24:40Z",
"owner_type": "User",
"updated_at": "2026-06-22T16:40:54Z",
"description": "Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.",
"is_archived": false,
"is_disabled": false,
"license_spdx": null,
"default_branch": "master",
"license_spdx_raw": "NOASSERTION",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": null,
"name": "Laurent Franceschetti",
"type": "User",
"login": "fralau",
"company": "SettleNext",
"location": "Geneva, Switzerland",
"followers": 24,
"avatar_url": "https://avatars.githubusercontent.com/u/36767124?v=4",
"created_at": "2018-02-23T14:25:26Z",
"is_verified": null,
"public_repos": 13,
"account_age_days": 3070
},
"license": {
"state": "custom",
"spdx_id": null,
"raw_spdx": "NOASSERTION",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.3.7",
"kind": "patch",
"published_at": "2024-11-03T09:25:47Z"
},
{
"tag": "v1.0.4",
"kind": "patch",
"published_at": "2023-08-13T11:52:51Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2020-11-23T19:17:08Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2020-02-24T20:17:01Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2019-11-10T10:02:05Z"
}
],
"recent_commits": [
{
"oid": "f4f5bb01e28f50e4f0ba697362b1973ae6d4b25d",
"body": "Add `j2_line_statement_prefix` and `j2_line_comment_prefix` to plugin config scheme.\n\nThese options are already forwarded to Jinja through the existing `j2_*` handling, but MkDocs warns because they are not declared in the scheme. Adding them preserves the current runtime behavior while making valid Jinja line statement/comment configuration warning-free.\n\nSigned-off-by: Joey Chen <142381267+JoeyC-Dev@users.noreply.github.com>",
"is_bot": false,
"headline": "fix: support Jinja line prefix config options (#289)",
"author_name": "Joey Chen",
"author_login": "JoeyC-Dev",
"committed_at": "2026-05-03T17:40:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0536f4da1dc643e1fa1f0cc90e71512ada67dc04",
"body": null,
"is_bot": false,
"headline": "Fix type hint for compatibility",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T08:06:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d9a6bc3aac5b12b86f9e2be7af18e1e9178287f6",
"body": null,
"is_bot": false,
"headline": "Require mkdocs-test>=0.6.0 (compatibility with Python 3.8 and 3.9)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T08:03:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bcaa72db2820d60822ffba15e87c75669abc7b92",
"body": " - Remove install restriction for mkdocs-test\n - Add shield in READMEfor Python versions (>= 3.8)",
"is_bot": false,
"headline": "Make last minute corrections",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T07:49:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "356fc2a5b55d1897a2f2c47856d52b10cff4611c",
"body": " - changelog updated\n - bump version number\n - Github tests added for Python 3.8 and 3.9",
"is_bot": false,
"headline": "Prepare for release",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T07:44:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "aaf16bdcb9dfcb9c6ea9b6567ea4af7f8c178185",
"body": null,
"is_bot": false,
"headline": "Limit testing to 3.10 up (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:40:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ba5356c0c263355556aa82dad0fbfde3cce4bc4d",
"body": null,
"is_bot": false,
"headline": "Use proper exit for pytest if Python < 3.10 (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:33:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6c796600bc0886696ce9b76b84354d7e2bc1b6fa",
"body": " - MkDocs-Test incompatible with earlier versions",
"is_bot": false,
"headline": "Skip test_modules.py if Python version < 3.10 (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:11:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cec7440d46589b303d741a5e2df0a240c25b9bdb",
"body": null,
"is_bot": false,
"headline": "Test installation of d2 in a cross-platform way (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T13:27:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "492759c5ab3d05f7c55ec62ffdf9573b715ac6ed",
"body": " - add pytest to test in pyproject.toml",
"is_bot": false,
"headline": "Update with changes from local repo (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:45:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cc5416834a07ffd2ba1fe3d917a701ac6e9c98ad",
"body": null,
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:39:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "54b03834f0dc2457dc116419b6b128323304978a",
"body": null,
"is_bot": false,
"headline": "Clarify code for module import management (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:38:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "301b18342b46fb67e0a91f19d3f97d04b8e6faa9",
"body": null,
"is_bot": false,
"headline": "Add GitHub Actions workflow for testing with Pytest",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T13:58:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5b9d8275813c54bca02377ffe6b915f40738e158",
"body": " - Correct import procedure (which did not take it into account)\n - Make test cases to prove it works\n - Bump version no",
"is_bot": false,
"headline": "Fix error importing packages with `module_name` (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T13:45:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a93a1f74402b5d632acbab35a77d5171eb5d0e6d",
"body": "Added a fix for missing dependency declaration on requests.",
"is_bot": false,
"headline": "Update CHANGELOG for version 1.4.1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-25T12:34:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a76d62bf02f66cc9090cb8b266df738f97c1c80b",
"body": " - included `new_syntax` test case in pytest tests\n - the `config.yml` file contains the j2_extensions parameter\n - bump version number",
"is_bot": false,
"headline": "Add documentation for jinja2_extensions (#272)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:33:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9a329bc2c44af538556c840530d65266ee02ec44",
"body": null,
"is_bot": false,
"headline": "Merge branch 'master' of https://github.com/fralau/mkdocs-macros-plugin",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:01:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2eaf0330e74c458d6ec348a212a94dd7199a89e5",
"body": null,
"is_bot": false,
"headline": "Update post_production.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:00:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c6ea72ac8d57f3a750891953fa00ad0ffa683ea8",
"body": "…(#273)\n\n* add j2_extensions to config scheme",
"is_bot": false,
"headline": "Enable j2 extensions in mkdocs-macros without false-positive warning …",
"author_name": "William Warriner",
"author_login": "wwarriner",
"committed_at": "2025-10-18T12:59:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "51a3afc4868838f2c0e5f69485e74264cf173af8",
"body": null,
"is_bot": false,
"headline": "Add dependency on `requests` (#269)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-01T00:29:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b1dacfb0fba951fc79d36f50895cda3bed3163f6",
"body": null,
"is_bot": false,
"headline": "Delete install_package() function from codebase",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-22T14:15:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4ec687e81b6c1b6ac2ad11f1c8cfae671d86bef0",
"body": " - Change documentation to reflect this\n - Bump version number\n - Changelog for Pypi release",
"is_bot": false,
"headline": "Remove auto-install of missing pluglet (#262)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-21T20:52:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e9dec13e22f12e4fb36bee8065ab90d5e3b90d6e",
"body": null,
"is_bot": false,
"headline": "Remove installation of missing pluglet (but meaningful message) #262",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-21T18:58:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ef2b98d2b6d9971ecd68da3fcc9360d07373c71",
"body": " - The purpose is to prevent failures of yaml dumps",
"is_bot": false,
"headline": "Include new function `yaml_support()` from super_collections (#258)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-19T10:35:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "86e31f781e1d57d0bee0f9e8d2fa6cb756671c9c",
"body": null,
"is_bot": false,
"headline": "Define explicitely python in `update_pypi.sh`",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-12T13:07:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6b396ecb99bffc7b7eab01f1b887bddee8237faa",
"body": null,
"is_bot": false,
"headline": "Add info in doc that a module can have relative path (#263)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-11T15:21:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "62daea93707d9921fbae7bc00c89a824e0667e4b",
"body": "- Added `.has_j2() method for testing the presence of jinja2\n- Added `.env()` method (to clarify code)",
"is_bot": false,
"headline": "Fix: Fix detection of Jinja2, to allow title rendering (#266)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-10T16:21:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e0ba1ba3683d5b618c979dd2d7bca5a48f7c87ad",
"body": null,
"is_bot": false,
"headline": "Test built-in filters (#253)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-11-07T11:15:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bc57e31fc29a22c565ee194f3fb1294e0e4e1c5",
"body": " - update CHANGELOG\n - update authors",
"is_bot": false,
"headline": "Fix imprecision in description of parameters for jinja2 syntax (#252)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-11-03T08:28:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4fb7bf6902d11163970f18ec4ddfeb7a51127657",
"body": null,
"is_bot": false,
"headline": "Change tests: MkDocsPage.find() -> find_text()",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-28T19:16:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b906a368ecfd5cd25abcbea0a37f7a23944a8355",
"body": null,
"is_bot": false,
"headline": "Bump version number",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-26T15:15:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "56418062b60c13faa4bbc15ab75fe6301c531fba",
"body": " - Added test case",
"is_bot": false,
"headline": "Fixed incompatibility with d2 module (#249)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-18T19:59:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3a73707abd48c9df214646d57204cff854bbe98b",
"body": " - change update_pypi.sh accordingly",
"is_bot": false,
"headline": "Migrate to pyproject.toml",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-17T04:41:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "99733bed5e62b9cc43cad1def816aefdf28651a1",
"body": null,
"is_bot": false,
"headline": "Demote info messages as debug (#248)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-16T18:01:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6a9a0e4f41e02a79f0e8f682f5329ed89f5dbb27",
"body": null,
"is_bot": false,
"headline": "Bump version number, for distribution (should solve #247)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-10T19:58:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "32cd528114ff8b4203c5bfe216f32ca613266bc9",
"body": " - added the register_macros test case\n - reimplemented the .variables, .macros and .filters\n properties for MacrosDocProject\n - updated documentation, to document hooks scripts\n (including comparison with MkDocs-Macros modules)",
"is_bot": false,
"headline": "Test the hooks for external registration (#237)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-10T05:48:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "16be58d9c64bf29ad489762fb30f6467eb192450",
"body": null,
"is_bot": false,
"headline": "Migrate all tests toward the mkdocs-test framework (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-09T13:28:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "59f82db2a60eae28832b5a1d44fb475f8c9e309f",
"body": null,
"is_bot": false,
"headline": "Replacing local implementation of SuperDict by super-collections version",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-05T09:27:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "38b9681833fd06ae049c10fded1d33514b6c8d8e",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-02T15:27:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eebbbd1b6d9d587dbb36cb08d5aee35c5a8a34a7",
"body": "Add `pathspec` as dependency",
"is_bot": false,
"headline": "Merge pull request #246 from dwreeves/add-pathspec-as-dependency",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-10-02T15:26:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6d9982213eaca2fd44b9ddc101ed417371d829ed",
"body": null,
"is_bot": false,
"headline": "Add `pathspec` as dependency",
"author_name": "Daniel Reeves",
"author_login": "dwreeves",
"committed_at": "2024-10-02T14:26:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69577e12bc5d4bc4f59f276d599f39263fa4ea82",
"body": " - these two objects are now defined separately from the fixture\n (MacrosDocProject and TestMarkdownPage)",
"is_bot": false,
"headline": "Separate standard DocProject and MarkdownPage classes",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-01T07:11:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "962472c77a6942c1ed293161aabfa6d2bfc71c9c",
"body": " - issue #244",
"is_bot": false,
"headline": "Split test framework into DocProject (general) and MacrosDocProject",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-30T06:37:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e164982ee22bd2b36316eb1a0026cd0c80f1b4a2",
"body": " - Extracted fixture utilities into `fixture_util.py`\n - Created a ./test_fixture.sh to specifically test the fixture,\n with options (also called when invoking `pytest`)\n - Specifically made a test in that context, for the `find_page()` function.",
"is_bot": false,
"headline": "Improve tests (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-29T12:48:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9186fe67f7dc1427043bea74e49906eeb5c3a797",
"body": " - changed name from opt-in and opt-out",
"is_bot": false,
"headline": "Fixed null test and completed added opt_in and opt_out",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-29T08:17:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b76efefa71834d6ba71ca348bde8b1f3d7baebc2",
"body": " - Added a `null` test project that does nothing\n - Improved the `module` to test further things\n - Redefined the `MardkowPage.is_rendered()` method\n as \"not (source is included in target)\"",
"is_bot": false,
"headline": "Improved tests (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-28T08:56:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6265d905cbaf9af6d1d1601b94df6209a8ca5993",
"body": null,
"is_bot": false,
"headline": "Add a testing framework, as described in #244",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-26T08:30:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa90b968828ff7345c647dbf4b8a3e7f3d6b7661",
"body": null,
"is_bot": false,
"headline": "Fix `print` statement left in code #242",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-18T07:45:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8b3f45628ebaf8be2cb9d58a7263dd8dc3df24f",
"body": null,
"is_bot": false,
"headline": "Document hooks for #237 (register macros/variables/filters)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-16T09:35:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c1029d54dcb938a8ba736f87009eff5bf29ed953",
"body": null,
"is_bot": false,
"headline": "Document how to correct issue with macros / admonitions (#240)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-15T06:15:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "67ccb159e7f135305b3f3a20bd56c58a623228e8",
"body": "Fix registration system",
"is_bot": false,
"headline": "Merge pull request #238 from timvink/master",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-09-14T07:16:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "03f5e89acfa246439cc877cc83c386cdebb1b21f",
"body": null,
"is_bot": false,
"headline": "Fix registration system",
"author_name": "Tim Vink",
"author_login": "timvink",
"committed_at": "2024-09-13T14:11:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ddace9739ffa43b26285e82ea70c8ff0d0e719af",
"body": null,
"is_bot": false,
"headline": "remove property on register methods",
"author_name": "Tim Vink",
"author_login": "timvink",
"committed_at": "2024-09-13T13:13:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "363d9046eeb6cb45f33e56c1cc4507cb6487bc39",
"body": null,
"is_bot": false,
"headline": "Add three hooks `register_variables/macros/filters` (#237)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-05T13:37:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2fb833e4009f6875d0df01f00e7c2d4640c1e00a",
"body": "- New filter is now called `relative_url`.",
"is_bot": false,
"headline": "Improved implementation for relative url (#236)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T14:20:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69e7cada20e500177756ce6fe89a7b0c4b1aa640",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T07:06:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5bec964e81d9342ce92b838ad235247dec670f51",
"body": "- This filter is imported from mkdocs.utils",
"is_bot": false,
"headline": "Add standard filter `normalize_url` (#236)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T07:06:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9a08f11742c130b06ff3345d64855669dbbcc4aa",
"body": "Fix encoding issue for other characters set",
"is_bot": false,
"headline": "Merge pull request #228 from caomingpei/master",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-06-02T06:42:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "590232c22954bbdf96a0ba40fa4ccb261e8f3de6",
"body": "Add type marker for PEP 561 compliance",
"is_bot": false,
"headline": "Merge pull request #231 from kchr/pep561",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-06-02T06:38:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e2126bbcb0c01043402125465fccd6144bc94e2c",
"body": "This adds a `py.typed` file in the package directory, which acts as a\nmarker to declare that it is PEP 561 compliant and includes type hints.\n\nMore information is available here:\n\nhttps://mypy.readthedocs.io/en/stable/installed_packages.html#creating-pep-561-compatible-packages\n\nFixes #219.",
"is_bot": false,
"headline": "Add type marker for PEP 561 compliance",
"author_name": "Noor Christensen",
"author_login": "kchr",
"committed_at": "2024-06-01T22:13:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0ee9856132780e51ffaa74831c4b054aecfcd0a7",
"body": "undefined variable config in readme",
"is_bot": false,
"headline": "Merge pull request #230 from garfieldnate/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-05-13T17:42:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bc801a935198fe97710ddc2b4cc46e3b22e1642",
"body": null,
"is_bot": false,
"headline": "undefined variable config in readme",
"author_name": "Nathan Glenn",
"author_login": "garfieldnate",
"committed_at": "2024-05-13T17:23:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a26a60ba49dc79acee31fe0e605341fb22c146a9",
"body": "Fix this https://github.com/fralau/mkdocs-macros-plugin/issues/227\nThis commit is to set the encoding when open a file. It's useful for\nother characters set users.",
"is_bot": false,
"headline": "!B: fix encoding issue for other characters set",
"author_name": "caomingpei",
"author_login": "caomingpei",
"committed_at": "2024-05-09T09:48:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ec9bbb987856a83fb766caf06233e7218c5d905c",
"body": null,
"is_bot": false,
"headline": "Add missed modifications for #226",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-28T14:36:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8a154c421bd9e3fb3dfacc2f57fb2b0b264d292",
"body": null,
"is_bot": false,
"headline": "Update doc for #226",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-27T18:56:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4f96dd5b56817275fa7d5597b4bbac394d07b20e",
"body": " - Generated a warning so as to make the build fail\n in strict mode (`mkdocs build --strict`)\n - Updated documentation of Advanced usage and Troubleshooting\n to clarify this.\n - Bumped revision number.",
"is_bot": false,
"headline": "Generate a Warning in case of variable/macro error (#226)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-27T18:52:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06834c6e881dcdaf8eb6e8cd5e41040deda86ebb",
"body": " - In the Advanced Usage page",
"is_bot": false,
"headline": "Update documentation for issue #215 (emojis in title)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-06T09:29:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "814205a64d7ee0d88bafefb8fa2df33ba9d7e886",
"body": " Files were missing",
"is_bot": false,
"headline": "Push of missing files for #215",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-02T16:03:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "da337b99b3053b04a012d3c4aec38944f20be92d",
"body": " - to prevent a problem in case pymdownx.emoji is being used",
"is_bot": false,
"headline": "Workaround for #215: do not render page title if no macro",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-02T14:18:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bf6c8e4cd0cb0dee9999103d44f18550aaeee82b",
"body": null,
"is_bot": false,
"headline": "Minor corrections to the documentation",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-20T10:04:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cfa03e7b24d883a36341b03a84c22beb06dd113d",
"body": " - `render_macros` in the YAML header has the last word\n - update `opt-in` test case\n - update documentation",
"is_bot": false,
"headline": "Correct management of opt-in",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-20T09:34:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "827943d5b857523eeffeef8f6d40231f06ad2be4",
"body": " - this is a mechanism that forces rendering of files\n for the case when `render_by_default` is set to `false`.\n - it uses a git-like syntax to define files to include",
"is_bot": false,
"headline": "Add `force_render_paths` parameter in config file (#204)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-19T15:20:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ef51c7afa22897ec7136b2dd5700a187fed985e8",
"body": null,
"is_bot": false,
"headline": "Fusion with local version",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-18T16:51:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "38ac286d1b16634d3fb848d8e3506c469404d7e6",
"body": "Fix typos and formatting",
"is_bot": false,
"headline": "Merge pull request #209 from alxgu/fix_typo",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-02-18T16:08:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c43e9c5240d9415a4c207002b1a4d5f40cbfb53",
"body": " - Now it is possible to specify to additional standard jinja2\n parameters, e.g.\n j2_comment_start_string: '[#'\n j2_comment_end_string: '#]'\n - Updated documentation\n - Updated `new_syntax` use case",
"is_bot": false,
"headline": "Add markers for alternative syntax (#208)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-17T10:21:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e844ea72c0c2e11852290a3b7a2e001cb368f520",
"body": null,
"is_bot": false,
"headline": "Bump version no",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-17T09:42:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2e0050c6ecee5ed62b29979536c6058cd49c9838",
"body": null,
"is_bot": false,
"headline": "Correct bold formatting",
"author_name": "Alex",
"author_login": "alxgu",
"committed_at": "2024-02-13T21:52:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d9a85566ad44390c653bea4290b6d3863c0e82db",
"body": null,
"is_bot": false,
"headline": "Fix some typos",
"author_name": "Alex",
"author_login": "alxgu",
"committed_at": "2024-02-13T21:46:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7368260754c65b74e582609d4cd7e38d30b05f7b",
"body": "Add link to wiki for pluglets",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-01-28T07:55:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c80db2ccf30f9bd0c09e11e8deebfba275d93c5",
"body": " - The Jinja2 engine used for HTML templates is the\n standard one of MkDocs, and distinct from the\n macros engine.",
"is_bot": false,
"headline": "Add clarification in doc about HTML templates (#200)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-10T15:57:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8b0ad21432e7776198a26515cb2415a2778e5ac0",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-08T15:47:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8e7ae5c6af54114ffe2fdd19f3906e2666c07df5",
"body": " - clarification of examples in first page\n - fix all relative links, following clarification of link management in MkDocs",
"is_bot": false,
"headline": "Improvement in documentation + fix links",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-08T15:45:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f07146bbc3d317db38b903c4c282315682ccfd31",
"body": "Add example of escaping Handlebars definitions with `{% raw %}`",
"is_bot": false,
"headline": "Merge pull request #193 from oleg-nenashev/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-11-28T20:01:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eef2f23ad74d94b0fd807e924019cbc2c0a7f678",
"body": null,
"is_bot": false,
"headline": "Add example of escaping Handlebars definitions with `{% raw %}`",
"author_name": "Oleg Nenashev",
"author_login": "oleg-nenashev",
"committed_at": "2023-11-28T14:29:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5f72c156815aeb26d4bd48e69cedbd7e06b97616",
"body": " - Now any of the standard functions is accepted (but still files\n if none is found).\n - Error message is explicit.\n - Created the no_module test case to validate that the error is\n properly raised.",
"is_bot": false,
"headline": "Fix bug where `define_env()` is always required in main.py (#191)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-11-28T05:49:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7b71e2566f391af03f8ba9965645d701b0d37770",
"body": null,
"is_bot": false,
"headline": "Add requirement of 'packaging' module (#179)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-31T15:26:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4bfda0bd7efe070439aa5cecea3d3ca2d86375d2",
"body": " - It was a problem with include-markdown directive,\n between doc examples and the 'real' include of the changelog;\n solved it by changing the syntax of the 'real' include.\n - Updated changelog\n - Bumped version number",
"is_bot": false,
"headline": "Fix issue with changelog no longer displayed (#186)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-31T15:13:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "82c5cdde6f40b2089db1edc6226b1041e7eb415f",
"body": "Add a short_tag attribute to git context",
"is_bot": false,
"headline": "Merge pull request #183 from marcospereira/add-short-tag",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-25T13:22:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "298f07f787b46faa5cc0adc98bd5606e5ac773f8",
"body": null,
"is_bot": false,
"headline": "Add a short_tag attribute to git context",
"author_name": "Marcos Pereira",
"author_login": "marcospereira",
"committed_at": "2023-10-20T15:18:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "428a0151a053f31e5d3bab4345e33c73bf050a08",
"body": null,
"is_bot": false,
"headline": "Remove include-markdown in webdoc, since it crashed readthedocs",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-16T14:41:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2161dd45c175e6a0c9fc495212f47b66c27bb2d3",
"body": "Needs a build key.",
"is_bot": false,
"headline": "Update .readthedocs.yml",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-16T14:25:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c64a08d4f8c42f9a6635a97cb88fadaa90a20b12",
"body": "Fix typo in `Rich Markdown Pages` docs",
"is_bot": false,
"headline": "Merge pull request #182 from SimonMarquis/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-16T14:14:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1c1d2c44693a41874a99f3e8c93dc4d74c3932a3",
"body": null,
"is_bot": false,
"headline": "Fix typo in `Rich Markdown Pages` docs",
"author_name": "Simon Marquis",
"author_login": "SimonMarquis",
"committed_at": "2023-10-16T14:11:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9dba19e3ec0dfce7761eee32dfda4dca6cd312af",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-14T12:12:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7da70895975dc67074e352d811ffeb943b11240c",
"body": null,
"is_bot": false,
"headline": "Add experimental logo",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-14T12:09:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0d36ddee96d7c7ea2178d942b665d8eb620791f3",
"body": null,
"is_bot": false,
"headline": "Add experimental logo",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T08:31:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a035c9ff312a7436606215944d0059e77f680684",
"body": " - minor change to README page",
"is_bot": false,
"headline": "Improve first page of documentation with Mermaid diagrams",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T08:19:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "52f6a316844d1c838159daa023f67c6806a6b692",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T06:36:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e5a5bb98d073c24a8015c5998757f2dc7da8f49b",
"body": "Add dependency info.",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-08-13T06:23:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "73cb068b78114d68b8e8a8f81ba9d3995233dbef",
"body": "Give a more user-friendly appearance.",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-08-13T06:04:36Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 5,
"commits_last_year": 27,
"latest_release_at": "2024-11-03T09:25:47Z",
"latest_release_tag": "v1.3.7",
"releases_from_tags": false,
"days_since_last_push": 79,
"active_weeks_last_year": 8,
"days_since_latest_release": 625,
"mean_days_between_releases": 455
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 57,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "mkdocs-macros-plugin",
"exists": true,
"license": "MIT",
"keywords": [
"macros",
"markdown",
"mkdocs",
"python",
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Information Technology",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9"
],
"ecosystem": "pypi",
"matches_repo": false,
"registry_url": "https://pypi.org/project/mkdocs-macros-plugin/",
"is_deprecated": false,
"latest_version": "1.5.0",
"repository_url": "https://github.com/fralau/mkdocs_macros_plugin",
"versions_count": 38,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 2917195,
"first_published_at": "2018-09-11T13:44:39.001257Z",
"latest_published_at": "2025-11-13T08:08:55.545536Z",
"latest_version_yanked": null,
"days_since_latest_publish": 250
}
]
},
"popularity": {
"forks": 54,
"stars": 407,
"watchers": 6,
"fork_history": {
"days": [
{
"date": "2018-08-28",
"count": 1
},
{
"date": "2018-10-30",
"count": 1
},
{
"date": "2019-06-11",
"count": 1
},
{
"date": "2020-01-14",
"count": 1
},
{
"date": "2020-02-27",
"count": 1
},
{
"date": "2020-03-02",
"count": 1
},
{
"date": "2020-05-11",
"count": 1
},
{
"date": "2020-05-14",
"count": 1
},
{
"date": "2020-05-29",
"count": 1
},
{
"date": "2020-07-03",
"count": 1
},
{
"date": "2020-09-15",
"count": 1
},
{
"date": "2020-12-30",
"count": 1
},
{
"date": "2021-01-12",
"count": 1
},
{
"date": "2021-01-21",
"count": 1
},
{
"date": "2021-03-03",
"count": 1
},
{
"date": "2021-04-01",
"count": 1
},
{
"date": "2021-05-25",
"count": 1
},
{
"date": "2021-06-25",
"count": 1
},
{
"date": "2021-07-05",
"count": 1
},
{
"date": "2021-09-03",
"count": 1
},
{
"date": "2021-09-08",
"count": 1
},
{
"date": "2021-09-17",
"count": 1
},
{
"date": "2021-11-07",
"count": 1
},
{
"date": "2021-11-17",
"count": 1
},
{
"date": "2021-12-03",
"count": 1
},
{
"date": "2021-12-17",
"count": 1
},
{
"date": "2022-01-03",
"count": 1
},
{
"date": "2022-02-04",
"count": 1
},
{
"date": "2022-03-30",
"count": 1
},
{
"date": "2022-06-22",
"count": 1
},
{
"date": "2022-10-17",
"count": 1
},
{
"date": "2023-04-12",
"count": 1
},
{
"date": "2023-04-21",
"count": 1
},
{
"date": "2023-07-09",
"count": 1
},
{
"date": "2023-10-20",
"count": 1
},
{
"date": "2023-11-28",
"count": 1
},
{
"date": "2024-02-13",
"count": 2
},
{
"date": "2024-02-21",
"count": 1
},
{
"date": "2024-03-04",
"count": 1
},
{
"date": "2024-04-04",
"count": 1
},
{
"date": "2024-05-13",
"count": 1
},
{
"date": "2024-06-01",
"count": 1
},
{
"date": "2024-10-02",
"count": 1
},
{
"date": "2025-08-01",
"count": 1
},
{
"date": "2025-09-21",
"count": 1
},
{
"date": "2025-10-16",
"count": 1
},
{
"date": "2025-11-09",
"count": 1
},
{
"date": "2025-12-02",
"count": 1
},
{
"date": "2026-05-12",
"count": 1
},
{
"date": "2026-05-18",
"count": 1
},
{
"date": "2026-05-29",
"count": 1
}
],
"complete": true,
"collected": 52,
"total_forks": 54
},
"star_history": {
"days": [
{
"date": "2018-09-27",
"count": 1
},
{
"date": "2018-10-07",
"count": 1
},
{
"date": "2018-10-30",
"count": 1
},
{
"date": "2018-11-10",
"count": 1
},
{
"date": "2018-11-16",
"count": 1
},
{
"date": "2018-12-21",
"count": 1
},
{
"date": "2018-12-24",
"count": 1
},
{
"date": "2019-01-15",
"count": 1
},
{
"date": "2019-01-25",
"count": 1
},
{
"date": "2019-02-01",
"count": 2
},
{
"date": "2019-02-06",
"count": 1
},
{
"date": "2019-03-02",
"count": 1
},
{
"date": "2019-03-06",
"count": 1
},
{
"date": "2019-04-12",
"count": 1
},
{
"date": "2019-04-23",
"count": 1
},
{
"date": "2019-05-12",
"count": 1
},
{
"date": "2019-05-31",
"count": 1
},
{
"date": "2019-06-05",
"count": 1
},
{
"date": "2019-06-11",
"count": 1
},
{
"date": "2019-07-15",
"count": 1
},
{
"date": "2019-08-02",
"count": 1
},
{
"date": "2019-08-23",
"count": 1
},
{
"date": "2019-10-09",
"count": 1
},
{
"date": "2019-10-12",
"count": 1
},
{
"date": "2019-10-15",
"count": 1
},
{
"date": "2019-10-31",
"count": 1
},
{
"date": "2019-11-21",
"count": 1
},
{
"date": "2019-12-08",
"count": 1
},
{
"date": "2019-12-09",
"count": 1
},
{
"date": "2019-12-11",
"count": 1
},
{
"date": "2019-12-17",
"count": 1
},
{
"date": "2020-02-05",
"count": 1
},
{
"date": "2020-02-12",
"count": 1
},
{
"date": "2020-02-14",
"count": 1
},
{
"date": "2020-03-10",
"count": 1
},
{
"date": "2020-03-11",
"count": 1
},
{
"date": "2020-03-21",
"count": 1
},
{
"date": "2020-03-22",
"count": 1
},
{
"date": "2020-03-23",
"count": 1
},
{
"date": "2020-05-07",
"count": 1
},
{
"date": "2020-05-11",
"count": 1
},
{
"date": "2020-05-13",
"count": 1
},
{
"date": "2020-05-26",
"count": 1
},
{
"date": "2020-05-29",
"count": 1
},
{
"date": "2020-05-31",
"count": 1
},
{
"date": "2020-06-05",
"count": 1
},
{
"date": "2020-06-08",
"count": 1
},
{
"date": "2020-06-10",
"count": 1
},
{
"date": "2020-06-19",
"count": 1
},
{
"date": "2020-06-20",
"count": 1
},
{
"date": "2020-06-25",
"count": 1
},
{
"date": "2020-06-27",
"count": 1
},
{
"date": "2020-06-29",
"count": 1
},
{
"date": "2020-07-03",
"count": 1
},
{
"date": "2020-07-10",
"count": 1
},
{
"date": "2020-07-13",
"count": 1
},
{
"date": "2020-07-19",
"count": 1
},
{
"date": "2020-07-30",
"count": 1
},
{
"date": "2020-08-24",
"count": 1
},
{
"date": "2020-09-23",
"count": 1
},
{
"date": "2020-09-24",
"count": 1
},
{
"date": "2020-09-27",
"count": 1
},
{
"date": "2020-09-28",
"count": 1
},
{
"date": "2020-09-30",
"count": 1
},
{
"date": "2020-10-08",
"count": 1
},
{
"date": "2020-10-12",
"count": 1
},
{
"date": "2020-11-03",
"count": 1
},
{
"date": "2020-11-12",
"count": 1
},
{
"date": "2020-11-27",
"count": 1
},
{
"date": "2020-11-28",
"count": 1
},
{
"date": "2020-11-29",
"count": 1
},
{
"date": "2020-12-02",
"count": 1
},
{
"date": "2020-12-07",
"count": 1
},
{
"date": "2020-12-10",
"count": 1
},
{
"date": "2020-12-13",
"count": 1
},
{
"date": "2020-12-14",
"count": 1
},
{
"date": "2020-12-15",
"count": 1
},
{
"date": "2020-12-16",
"count": 1
},
{
"date": "2020-12-17",
"count": 1
},
{
"date": "2020-12-22",
"count": 1
},
{
"date": "2020-12-29",
"count": 1
},
{
"date": "2021-01-12",
"count": 1
},
{
"date": "2021-01-26",
"count": 1
},
{
"date": "2021-02-19",
"count": 1
},
{
"date": "2021-02-25",
"count": 2
},
{
"date": "2021-03-04",
"count": 1
},
{
"date": "2021-03-08",
"count": 1
},
{
"date": "2021-03-10",
"count": 2
},
{
"date": "2021-03-29",
"count": 1
},
{
"date": "2021-04-04",
"count": 1
},
{
"date": "2021-04-09",
"count": 1
},
{
"date": "2021-04-15",
"count": 1
},
{
"date": "2021-04-24",
"count": 2
},
{
"date": "2021-05-23",
"count": 1
},
{
"date": "2021-06-06",
"count": 1
},
{
"date": "2021-06-09",
"count": 1
},
{
"date": "2021-06-13",
"count": 1
},
{
"date": "2021-06-18",
"count": 1
},
{
"date": "2021-06-20",
"count": 1
},
{
"date": "2021-06-26",
"count": 1
},
{
"date": "2021-07-06",
"count": 1
},
{
"date": "2021-07-12",
"count": 1
},
{
"date": "2021-07-18",
"count": 1
},
{
"date": "2021-07-20",
"count": 1
},
{
"date": "2021-08-03",
"count": 1
},
{
"date": "2021-08-05",
"count": 1
},
{
"date": "2021-08-23",
"count": 1
},
{
"date": "2021-08-25",
"count": 1
},
{
"date": "2021-08-26",
"count": 1
},
{
"date": "2021-08-28",
"count": 1
},
{
"date": "2021-09-18",
"count": 1
},
{
"date": "2021-10-12",
"count": 1
},
{
"date": "2021-10-13",
"count": 1
},
{
"date": "2021-10-28",
"count": 1
},
{
"date": "2021-11-09",
"count": 1
},
{
"date": "2021-11-11",
"count": 1
},
{
"date": "2021-11-29",
"count": 1
},
{
"date": "2021-11-30",
"count": 1
},
{
"date": "2022-01-05",
"count": 1
},
{
"date": "2022-01-10",
"count": 1
},
{
"date": "2022-01-18",
"count": 1
},
{
"date": "2022-01-19",
"count": 1
},
{
"date": "2022-01-25",
"count": 1
},
{
"date": "2022-01-31",
"count": 1
},
{
"date": "2022-02-01",
"count": 1
},
{
"date": "2022-02-06",
"count": 1
},
{
"date": "2022-02-18",
"count": 1
},
{
"date": "2022-02-19",
"count": 1
},
{
"date": "2022-03-17",
"count": 1
},
{
"date": "2022-03-26",
"count": 1
},
{
"date": "2022-03-30",
"count": 1
},
{
"date": "2022-03-31",
"count": 1
},
{
"date": "2022-04-18",
"count": 1
},
{
"date": "2022-04-29",
"count": 1
},
{
"date": "2022-05-01",
"count": 1
},
{
"date": "2022-05-05",
"count": 1
},
{
"date": "2022-05-16",
"count": 1
},
{
"date": "2022-05-17",
"count": 1
},
{
"date": "2022-06-15",
"count": 1
},
{
"date": "2022-06-30",
"count": 1
},
{
"date": "2022-07-04",
"count": 1
},
{
"date": "2022-07-15",
"count": 1
},
{
"date": "2022-07-18",
"count": 2
},
{
"date": "2022-07-23",
"count": 1
},
{
"date": "2022-07-25",
"count": 1
},
{
"date": "2022-07-26",
"count": 1
},
{
"date": "2022-08-01",
"count": 1
},
{
"date": "2022-08-31",
"count": 1
},
{
"date": "2022-09-02",
"count": 1
},
{
"date": "2022-09-05",
"count": 1
},
{
"date": "2022-09-12",
"count": 1
},
{
"date": "2022-10-13",
"count": 1
},
{
"date": "2022-10-28",
"count": 1
},
{
"date": "2022-11-05",
"count": 1
},
{
"date": "2022-11-17",
"count": 3
},
{
"date": "2022-11-24",
"count": 1
},
{
"date": "2022-11-26",
"count": 1
},
{
"date": "2022-11-30",
"count": 1
},
{
"date": "2022-12-29",
"count": 1
},
{
"date": "2023-01-04",
"count": 1
},
{
"date": "2023-01-05",
"count": 1
},
{
"date": "2023-01-17",
"count": 1
},
{
"date": "2023-01-24",
"count": 1
},
{
"date": "2023-01-28",
"count": 1
},
{
"date": "2023-02-06",
"count": 1
},
{
"date": "2023-02-07",
"count": 1
},
{
"date": "2023-02-09",
"count": 1
},
{
"date": "2023-02-13",
"count": 1
},
{
"date": "2023-02-18",
"count": 1
},
{
"date": "2023-02-20",
"count": 1
},
{
"date": "2023-02-28",
"count": 1
},
{
"date": "2023-03-26",
"count": 2
},
{
"date": "2023-04-03",
"count": 1
},
{
"date": "2023-04-05",
"count": 1
},
{
"date": "2023-04-11",
"count": 1
},
{
"date": "2023-04-16",
"count": 2
},
{
"date": "2023-04-30",
"count": 1
},
{
"date": "2023-05-06",
"count": 1
},
{
"date": "2023-05-08",
"count": 1
},
{
"date": "2023-05-16",
"count": 1
},
{
"date": "2023-05-25",
"count": 1
},
{
"date": "2023-05-26",
"count": 1
},
{
"date": "2023-05-29",
"count": 1
},
{
"date": "2023-05-30",
"count": 1
},
{
"date": "2023-06-05",
"count": 1
},
{
"date": "2023-06-06",
"count": 1
},
{
"date": "2023-06-08",
"count": 1
},
{
"date": "2023-06-17",
"count": 1
},
{
"date": "2023-06-20",
"count": 1
},
{
"date": "2023-06-27",
"count": 1
},
{
"date": "2023-07-04",
"count": 1
},
{
"date": "2023-07-07",
"count": 1
},
{
"date": "2023-07-09",
"count": 2
},
{
"date": "2023-07-17",
"count": 1
},
{
"date": "2023-07-28",
"count": 1
},
{
"date": "2023-08-04",
"count": 1
},
{
"date": "2023-08-07",
"count": 2
},
{
"date": "2023-08-08",
"count": 1
},
{
"date": "2023-08-17",
"count": 1
},
{
"date": "2023-08-18",
"count": 1
},
{
"date": "2023-08-19",
"count": 2
},
{
"date": "2023-08-21",
"count": 1
},
{
"date": "2023-08-24",
"count": 1
},
{
"date": "2023-09-03",
"count": 2
},
{
"date": "2023-09-10",
"count": 1
},
{
"date": "2023-09-14",
"count": 1
},
{
"date": "2023-09-15",
"count": 2
},
{
"date": "2023-09-17",
"count": 1
},
{
"date": "2023-09-19",
"count": 1
},
{
"date": "2023-09-23",
"count": 1
},
{
"date": "2023-09-28",
"count": 1
},
{
"date": "2023-10-02",
"count": 1
},
{
"date": "2023-10-08",
"count": 1
},
{
"date": "2023-10-16",
"count": 2
},
{
"date": "2023-10-19",
"count": 1
},
{
"date": "2023-10-23",
"count": 1
},
{
"date": "2023-11-04",
"count": 1
},
{
"date": "2023-11-06",
"count": 1
},
{
"date": "2023-11-07",
"count": 1
},
{
"date": "2023-11-18",
"count": 1
},
{
"date": "2023-11-20",
"count": 1
},
{
"date": "2023-11-28",
"count": 1
},
{
"date": "2023-12-07",
"count": 1
},
{
"date": "2023-12-11",
"count": 1
},
{
"date": "2023-12-12",
"count": 3
},
{
"date": "2023-12-14",
"count": 1
},
{
"date": "2023-12-20",
"count": 1
},
{
"date": "2023-12-26",
"count": 1
},
{
"date": "2023-12-27",
"count": 1
},
{
"date": "2023-12-28",
"count": 1
},
{
"date": "2024-01-04",
"count": 1
},
{
"date": "2024-01-20",
"count": 1
},
{
"date": "2024-01-22",
"count": 1
},
{
"date": "2024-01-26",
"count": 1
},
{
"date": "2024-01-30",
"count": 1
},
{
"date": "2024-02-09",
"count": 1
},
{
"date": "2024-02-16",
"count": 1
},
{
"date": "2024-02-18",
"count": 1
},
{
"date": "2024-02-26",
"count": 1
},
{
"date": "2024-03-08",
"count": 1
},
{
"date": "2024-03-26",
"count": 1
},
{
"date": "2024-04-01",
"count": 11
},
{
"date": "2024-04-02",
"count": 4
},
{
"date": "2024-04-03",
"count": 3
},
{
"date": "2024-04-04",
"count": 1
},
{
"date": "2024-04-11",
"count": 1
},
{
"date": "2024-04-12",
"count": 1
},
{
"date": "2024-04-16",
"count": 1
},
{
"date": "2024-04-19",
"count": 1
},
{
"date": "2024-04-24",
"count": 1
},
{
"date": "2024-05-05",
"count": 1
},
{
"date": "2024-05-09",
"count": 1
},
{
"date": "2024-05-10",
"count": 1
},
{
"date": "2024-05-12",
"count": 1
},
{
"date": "2024-05-19",
"count": 1
},
{
"date": "2024-05-27",
"count": 1
},
{
"date": "2024-05-28",
"count": 1
},
{
"date": "2024-05-30",
"count": 1
},
{
"date": "2024-06-01",
"count": 1
},
{
"date": "2024-06-02",
"count": 1
},
{
"date": "2024-06-07",
"count": 1
},
{
"date": "2024-06-15",
"count": 1
},
{
"date": "2024-06-18",
"count": 1
},
{
"date": "2024-06-27",
"count": 1
},
{
"date": "2024-06-28",
"count": 1
},
{
"date": "2024-07-05",
"count": 1
},
{
"date": "2024-07-06",
"count": 1
},
{
"date": "2024-07-13",
"count": 1
},
{
"date": "2024-07-18",
"count": 1
},
{
"date": "2024-07-29",
"count": 1
},
{
"date": "2024-07-30",
"count": 2
},
{
"date": "2024-08-02",
"count": 1
},
{
"date": "2024-08-06",
"count": 1
},
{
"date": "2024-08-08",
"count": 1
},
{
"date": "2024-08-15",
"count": 1
},
{
"date": "2024-08-16",
"count": 1
},
{
"date": "2024-08-19",
"count": 1
},
{
"date": "2024-08-20",
"count": 1
},
{
"date": "2024-08-22",
"count": 1
},
{
"date": "2024-08-23",
"count": 1
},
{
"date": "2024-09-03",
"count": 1
},
{
"date": "2024-09-06",
"count": 1
},
{
"date": "2024-09-15",
"count": 1
},
{
"date": "2024-09-17",
"count": 1
},
{
"date": "2024-09-18",
"count": 1
},
{
"date": "2024-09-19",
"count": 1
},
{
"date": "2024-09-23",
"count": 1
},
{
"date": "2024-09-27",
"count": 1
},
{
"date": "2024-09-30",
"count": 1
},
{
"date": "2024-10-04",
"count": 1
},
{
"date": "2024-10-05",
"count": 1
},
{
"date": "2024-10-07",
"count": 1
},
{
"date": "2024-10-08",
"count": 1
},
{
"date": "2024-10-09",
"count": 1
},
{
"date": "2024-10-10",
"count": 1
},
{
"date": "2024-10-12",
"count": 1
},
{
"date": "2024-10-16",
"count": 1
},
{
"date": "2024-10-25",
"count": 2
},
{
"date": "2024-11-03",
"count": 1
},
{
"date": "2024-11-06",
"count": 1
},
{
"date": "2024-11-19",
"count": 1
},
{
"date": "2024-11-23",
"count": 1
},
{
"date": "2024-12-12",
"count": 1
},
{
"date": "2024-12-16",
"count": 1
},
{
"date": "2024-12-19",
"count": 1
},
{
"date": "2024-12-24",
"count": 1
},
{
"date": "2024-12-31",
"count": 1
},
{
"date": "2025-01-04",
"count": 1
},
{
"date": "2025-01-05",
"count": 1
},
{
"date": "2025-01-07",
"count": 1
},
{
"date": "2025-01-12",
"count": 1
},
{
"date": "2025-01-14",
"count": 1
},
{
"date": "2025-01-24",
"count": 2
},
{
"date": "2025-01-27",
"count": 1
},
{
"date": "2025-02-10",
"count": 1
},
{
"date": "2025-02-22",
"count": 1
},
{
"date": "2025-02-27",
"count": 1
},
{
"date": "2025-03-04",
"count": 1
},
{
"date": "2025-03-10",
"count": 1
},
{
"date": "2025-04-02",
"count": 1
},
{
"date": "2025-04-04",
"count": 1
},
{
"date": "2025-04-11",
"count": 2
},
{
"date": "2025-04-12",
"count": 1
},
{
"date": "2025-04-21",
"count": 1
},
{
"date": "2025-04-24",
"count": 1
},
{
"date": "2025-04-27",
"count": 1
},
{
"date": "2025-05-02",
"count": 1
},
{
"date": "2025-05-12",
"count": 1
},
{
"date": "2025-05-27",
"count": 1
},
{
"date": "2025-05-30",
"count": 1
},
{
"date": "2025-06-04",
"count": 1
},
{
"date": "2025-06-18",
"count": 1
},
{
"date": "2025-06-21",
"count": 1
},
{
"date": "2025-06-26",
"count": 1
},
{
"date": "2025-07-15",
"count": 1
},
{
"date": "2025-07-26",
"count": 1
},
{
"date": "2025-08-05",
"count": 1
},
{
"date": "2025-08-14",
"count": 1
},
{
"date": "2025-08-15",
"count": 2
},
{
"date": "2025-08-28",
"count": 1
},
{
"date": "2025-08-29",
"count": 1
},
{
"date": "2025-09-03",
"count": 1
},
{
"date": "2025-09-05",
"count": 1
},
{
"date": "2025-09-17",
"count": 1
},
{
"date": "2025-09-29",
"count": 1
},
{
"date": "2025-10-14",
"count": 1
},
{
"date": "2025-10-16",
"count": 1
},
{
"date": "2025-10-20",
"count": 1
},
{
"date": "2025-10-31",
"count": 1
},
{
"date": "2025-11-09",
"count": 1
},
{
"date": "2025-11-21",
"count": 1
},
{
"date": "2026-01-01",
"count": 1
},
{
"date": "2026-01-02",
"count": 1
},
{
"date": "2026-01-12",
"count": 1
},
{
"date": "2026-01-17",
"count": 1
},
{
"date": "2026-01-19",
"count": 1
},
{
"date": "2026-01-20",
"count": 1
},
{
"date": "2026-01-23",
"count": 1
},
{
"date": "2026-01-25",
"count": 1
},
{
"date": "2026-02-12",
"count": 3
},
{
"date": "2026-02-14",
"count": 1
},
{
"date": "2026-03-31",
"count": 1
},
{
"date": "2026-04-20",
"count": 1
},
{
"date": "2026-05-04",
"count": 1
},
{
"date": "2026-05-17",
"count": 1
},
{
"date": "2026-06-05",
"count": 1
},
{
"date": "2026-06-19",
"count": 1
}
],
"complete": true,
"collected": 406,
"total_stars": 407
},
"open_issues_and_prs": 5
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"mkdocs_macros/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 36133,
"source_files_sampled": 35,
"oversized_source_files": 0,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml",
"setup.py"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 24,
"assessed_package": "pypi:mkdocs-macros-plugin@1.5.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "hjson",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "jinja2",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "mkdocs",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.17"
},
{
"name": "packaging",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pathspec",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "python-dateutil",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pyyaml",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "super-collections",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">= 0.6.2"
},
{
"name": "termcolor",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "hjson",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "jinja2",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "packaging",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pathspec",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "python-dateutil",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pyyaml",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "requests",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "super-collections",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "termcolor",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-include-markdown-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-material",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-mermaid2-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 13,
"direct_count": 10,
"indirect_count": 3
}
},
"maintainership": {
"issues": {
"open_prs": 1,
"merged_prs": 43,
"open_issues": 4,
"closed_ratio": 0.974,
"closed_issues": 149,
"closed_unmerged_prs": 18
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "fralau",
"commits": 84,
"avatar_url": "https://avatars.githubusercontent.com/u/36767124?v=4"
},
{
"type": "User",
"login": "eyllanesc",
"commits": 5,
"avatar_url": "https://avatars.githubusercontent.com/u/4896200?v=4"
},
{
"type": "User",
"login": "anatoly-scherbakov",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/2282888?v=4"
},
{
"type": "User",
"login": "honzajavorek",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/283441?v=4"
},
{
"type": "User",
"login": "jimporter",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/826865?v=4"
},
{
"type": "User",
"login": "timvink",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/5570380?v=4"
},
{
"type": "User",
"login": "alxgu",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/5547258?v=4"
},
{
"type": "User",
"login": "akhmerov",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/2069677?v=4"
},
{
"type": "User",
"login": "CrispyDrone",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/37639058?v=4"
},
{
"type": "User",
"login": "Bomberus",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/8161919?v=4"
}
],
"contributors_sampled": 34,
"top_contributor_share": 0.632
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"greetings.yml",
"test_push.yaml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 0,
"reason": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 2/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 10,
"reason": "project has 3 contributing companies or organizations -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 9,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 0,
"reason": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "f4f5bb01e28f50e4f0ba697362b1973ae6d4b25d",
"ran_at": "2026-07-21T20:31:57Z",
"aggregate_score": 3.2,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/fralau/mkdocs-macros-plugin",
"host": "github.com",
"name": "mkdocs-macros-plugin",
"owner": "fralau"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 52,
"inputs": {
"security": 46,
"vitality": 39,
"community": 62,
"governance": 53,
"engineering": 59
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "at_risk",
"name": "Vitality",
"value": 39,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "at_risk",
"name": "Development activity",
"note": null,
"notes": [],
"value": 36,
"inputs": {
"commits_last_year": 27,
"human_commit_share": 1,
"days_since_last_push": 79,
"active_weeks_last_year": 8
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 79 days ago",
"points": 18,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 79
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "8/52 weeks with commits",
"points": 5.5,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 8
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "27 commits in the last year",
"points": 13,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 27
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "at_risk",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 44,
"inputs": {
"releases_count": 5,
"latest_release_tag": "v1.3.7",
"releases_from_tags": false,
"days_since_latest_release": 625,
"mean_days_between_releases": 455
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "5 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 5
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 625 days ago",
"points": 7.2,
"status": "partial",
"details": [
{
"code": "release_recency",
"params": {
"days": 625
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~455 days",
"points": 5.4,
"status": "partial",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 455
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 79,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 79 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 79
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "moderate",
"name": "Community & Adoption",
"value": 62,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "moderate",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"forks": 54,
"stars": 407,
"watchers": 6,
"growth_state": "organic",
"growth_factor_pct": 100
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "407 stars",
"points": 42.3,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 407
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "54 forks",
"points": 14.4,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 54
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "6 watchers",
"points": 3.9,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 6
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 64,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "license file present, not a recognized license",
"points": 16.9,
"status": "partial",
"details": [
{
"code": "license_custom",
"params": {}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 53,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 41,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 34,
"top_contributor_share": 0.632
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 63% of commits",
"points": 8.3,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 63
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "34 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 34
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 3 contributing companies or organizations -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 72,
"inputs": {
"merged_prs": 43,
"open_issues": 4,
"closed_issues": 149,
"issue_closed_ratio": 0.974,
"closed_unmerged_prs": 18
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "97% of issues closed",
"points": 45.5,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 97
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "43/61 decided PRs merged",
"points": 27,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 43,
"decided": 61
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 2/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 50,
"inputs": {
"followers": 24,
"owner_type": "User",
"is_verified": null,
"owner_login": "fralau",
"public_repos": 13,
"account_age_days": 3070
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "24 followers of fralau",
"points": 10.1,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 24,
"login": "fralau"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "13 public repos, account ~8 yr old",
"points": 20.3,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 13
}
},
{
"code": "account_age_years",
"params": {
"years": 8
}
}
],
"max_points": 25
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "moderate",
"name": "Engineering Quality",
"value": 59,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "at_risk",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 48,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "good",
"name": "Documentation",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"topics": [
"python",
"mkdocs",
"markdown",
"jinja2-templates",
"jinja2",
"documentation",
"mkdocs-macros-plugin",
"automation"
],
"has_wiki": true,
"homepage": "https://mkdocs-macros-plugin.readthedocs.io",
"has_readme": true,
"has_docs_dir": false,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://mkdocs-macros-plugin.readthedocs.io",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "8 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 8
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 46,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 32,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 3.2
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 2/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 3 contributing companies or organizations -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:mkdocs-macros-plugin@1.5.0 runtime dependency closure — what installing the published package pulls in — 24 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:mkdocs-macros-plugin@1.5.0",
"assessed": 24
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 24,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 24,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 17
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 41,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 32,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.59,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "59 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 31.5,
"status": "partial",
"details": [
{
"code": "legible_history",
"params": {
"legible": 59,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 33,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"mkdocs_macros/py.typed"
],
"agent_commit_share": 0,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "mkdocs_macros/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "mkdocs_macros/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 100",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 36133,
"source_files_sampled": 35,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (mkdocs_macros/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "mkdocs_macros/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/35 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 35,
"oversized": 0
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"pypi package 'mkdocs-macros-plugin' points at a different repository (https://github.com/fralau/mkdocs_macros_plugin); excluded from ecosystem scoring"
],
"report_type": "repository",
"generated_at": "2026-07-21T20:32:16.313632Z",
"schema_version": "0.23.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/f/fralau/mkdocs-macros-plugin.svg",
"full_name": "fralau/mkdocs-macros-plugin",
"license_state": "custom",
"license_spdx": null
}