A MkDocs plugin that converts text between triple dashes to HR elements
Project description
MkDocs HR Plugin
一个用于在 MkDocs 中创建带样式分隔线的插件。可以将 ---文字--- 格式的文本转换为带有居中文字的分隔线,并在目录中优雅显示。
✨ 特性
- 将
---文字---格式转换为带样式的分隔线 - 在目录中以加粗居中的方式显示分隔线文字
- 自动适配亮色/暗色主题
- 分隔线样式美观,粗细和间距适中
- 简单易用,无需配置
🚀 安装
pip install mkdocs-hr-plugin
📖 使用方法
在mkdocs.yml中启用插件
plugins:
- upgradehr
🎨 效果展示
正文
目录
🔧 配置选项
目前插件不需要任何配置,开箱即用。未来可能会添加以下配置选项:
- 自定义分隔线样式
- 自定义文字样式
- 更多主题适配
🤝 贡献指南
欢迎提交 Issue 和 Pull Request!
- Fork 本仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature) - 提交你的改动 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
📝 更新日志
0.1.0 (2024-03-20)
- 初始版本发布
- 基本功能实现
📄 许可证
本项目基于 MIT 许可证 - 查看 LICENSE 文件了解详情
🙏 致谢
- MkDocs 团队提供的优秀文档工具
- 所有贡献者和用户
📮 联系方式
- 作者:amaranth
- 邮箱:amaranth2082@gmail.com
- GitHub:Auzers
⭐ 支持项目
如果这个项目对你有帮助,欢迎star
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4db2dd0f8a02e4b2a92a762da04801c5ad125510254b3bc5a750020fbedf8e0
|
|
| MD5 |
a9974dae0586007819ccc9ded9369bb3
|
|
| BLAKE2b-256 |
502b4feb33540ee08156000dfe44c1d526b3fbf9d88e778c3cbe95c9d653247b
|
File details
Details for the file mkdocs_hr_plugin-0.1.1-py3-none-any.whl.
File metadata
- Download URL: mkdocs_hr_plugin-0.1.1-py3-none-any.whl
- Upload date:
- Size: 6.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be0688ceb332933221b715cd0af114a1c09ef082b21cabc57e53b38102d893c8
|
|
| MD5 |
3021a93b4a9feb767746eb7f014ce835
|
|
| BLAKE2b-256 |
73ca168d8e1703c5ee39f015b450eaee640b459c8a7a7684c4672a00bbb4da98
|