Skip to main content

A MkDocs plugin that converts text between triple dashes to HR elements

Project description

MkDocs HR Plugin

一个用于在 MkDocs 中创建带样式分隔线的插件。可以将 ---文字--- 格式的文本转换为带有居中文字的分隔线,并在目录中优雅显示。

PyPI version License: MIT

✨ 特性

  • ---文字--- 格式转换为带样式的分隔线
  • 在目录中以加粗居中的方式显示分隔线文字
  • 自动适配亮色/暗色主题
  • 分隔线样式美观,粗细和间距适中
  • 简单易用,无需配置

🚀 安装

pip install mkdocs-hr-plugin

📖 使用方法

在mkdocs.yml中启用插件

plugins:
  - upgradehr

🎨 效果展示

正文

正文

目录

目录

🔧 配置选项

目前插件不需要任何配置,开箱即用。未来可能会添加以下配置选项:

  • 自定义分隔线样式
  • 自定义文字样式
  • 更多主题适配

🤝 贡献指南

欢迎提交 Issue 和 Pull Request!

  1. Fork 本仓库
  2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启一个 Pull Request

📝 更新日志

0.1.0 (2024-03-20)

  • 初始版本发布
  • 基本功能实现

📄 许可证

本项目基于 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

  • MkDocs 团队提供的优秀文档工具
  • 所有贡献者和用户

📮 联系方式

⭐ 支持项目

如果这个项目对你有帮助,欢迎star

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs_hr_plugin-0.1.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkdocs_hr_plugin-0.1.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs_hr_plugin-0.1.1.tar.gz.

File metadata

  • Download URL: mkdocs_hr_plugin-0.1.1.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for mkdocs_hr_plugin-0.1.1.tar.gz
Algorithm Hash digest
SHA256 e4db2dd0f8a02e4b2a92a762da04801c5ad125510254b3bc5a750020fbedf8e0
MD5 a9974dae0586007819ccc9ded9369bb3
BLAKE2b-256 502b4feb33540ee08156000dfe44c1d526b3fbf9d88e778c3cbe95c9d653247b

See more details on using hashes here.

File details

Details for the file mkdocs_hr_plugin-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_hr_plugin-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 be0688ceb332933221b715cd0af114a1c09ef082b21cabc57e53b38102d893c8
MD5 3021a93b4a9feb767746eb7f014ce835
BLAKE2b-256 73ca168d8e1703c5ee39f015b450eaee640b459c8a7a7684c4672a00bbb4da98

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page