# mkdocs-minyilife-plugin
An MkDocs plugin for www.minyilife.com blog.
## Installation
```
pip3 install mkdocs-minyilife-plugin
Or
pip3 install https://github.com/lesliezhu/mkdocs-minyilife-plugin/archive/refs/heads/master.zip
```
## mkdocs-ruby-plugin
An MkDocs plugin to add pinyin/furigana to Chinese/Japanese Kanji text.
It's based on https://github.com/ijaureguialzo/mkdocs-furigana-plugin, but replace CSS style with HTML `<ruby>` tag.
Write kanji like this:
> 我(wo)是一只{猫(mao)}。猫(ねこ).
It will look like:
> <ruby>我<rt>wo</rt></ruby>是一只<ruby>猫<rt>mao</rt></ruby>。<ruby>猫<rt>ねこ</rt></ruby>.
Or like this when there is more than one character:
> 我(wo)是{一只猫(yizhimao)}。{綺麗猫(きれいねこ)}.
It will look like:
> <ruby>我<rt>wo</rt></ruby>是<ruby>一只猫<rt>yizhimao</rt></ruby>。<ruby>綺麗猫<rt>きれいねこ</rt></ruby>.
To enable the plugin in the `mkdocs.yml` file:
```yaml
plugins:
- minyilife-ruby:
global_enable: true
title_enable: true
outer_begin: '{'
outer_end: '}'
inter_begin: '('
inter_end: ')
```
If `ruby.global_enable = false`, you can enable this plugin in single page:
```markdown
---
ruby: true
---
```
If `ruby.global_enable = true`, you can disable this plugin in single page:
```markdown
---
ruby: false
---
```
## mkdocs-exclude-plugin
An MkDocs plugin to exclude some markdown files.
It's based on https://github.com/apenwarr/mkdocs-exclude
To enable the plugin in the `mkdocs.yml` file:
```yaml
plugins:
- minyilife-exclude:
globs:
- test1.md
regex:
- 'test[3-9].md$'
```
Raw data
{
"_id": null,
"home_page": "https://github.com/lesliezhu/mkdocs-minyilife-plugin",
"name": "mkdocs-minyilife-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "mkdocs minyilife plugin",
"author": "Leslie Zhu",
"author_email": "pythonisland@gmail.com",
"download_url": null,
"platform": null,
"description": "# mkdocs-minyilife-plugin\n\nAn MkDocs plugin for www.minyilife.com blog.\n\n## Installation\n\n```\npip3 install mkdocs-minyilife-plugin\n\nOr\n\npip3 install https://github.com/lesliezhu/mkdocs-minyilife-plugin/archive/refs/heads/master.zip\n```\n\n## mkdocs-ruby-plugin\n\nAn MkDocs plugin to add pinyin/furigana to Chinese/Japanese Kanji text.\n\nIt's based on https://github.com/ijaureguialzo/mkdocs-furigana-plugin, but replace CSS style with HTML `<ruby>` tag.\n\nWrite kanji like this:\n\n> \u6211(wo)\u662f\u4e00\u53ea{\u732b(mao)}\u3002\u732b(\u306d\u3053).\n\nIt will look like:\n\n> <ruby>\u6211<rt>wo</rt></ruby>\u662f\u4e00\u53ea<ruby>\u732b<rt>mao</rt></ruby>\u3002<ruby>\u732b<rt>\u306d\u3053</rt></ruby>.\n\nOr like this when there is more than one character:\n\n> \u6211(wo)\u662f{\u4e00\u53ea\u732b(yizhimao)}\u3002{\u7dba\u9e97\u732b(\u304d\u308c\u3044\u306d\u3053)}.\n\nIt will look like:\n\n> <ruby>\u6211<rt>wo</rt></ruby>\u662f<ruby>\u4e00\u53ea\u732b<rt>yizhimao</rt></ruby>\u3002<ruby>\u7dba\u9e97\u732b<rt>\u304d\u308c\u3044\u306d\u3053</rt></ruby>.\n\nTo enable the plugin in the `mkdocs.yml` file:\n\n```yaml\nplugins:\n - minyilife-ruby:\n global_enable: true\n title_enable: true\n outer_begin: '{'\n outer_end: '}'\n inter_begin: '('\n inter_end: ')\n```\n\nIf `ruby.global_enable = false`, you can enable this plugin in single page:\n\n\n```markdown\n---\nruby: true\n---\n```\n\nIf `ruby.global_enable = true`, you can disable this plugin in single page:\n\n\n```markdown\n---\nruby: false\n---\n```\n\n## mkdocs-exclude-plugin\n\nAn MkDocs plugin to exclude some markdown files.\n\nIt's based on https://github.com/apenwarr/mkdocs-exclude\n\nTo enable the plugin in the `mkdocs.yml` file:\n\n```yaml\nplugins:\n - minyilife-exclude:\n globs:\n - test1.md\n regex:\n - 'test[3-9].md$'\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An MkDocs plugin for www.lesliezhu.com blog.",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/lesliezhu/mkdocs-minyilife-plugin"
},
"split_keywords": [
"mkdocs",
"minyilife",
"plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "32263e5ea4c8749567af07f21c3065c167a1c231b3fa6a43bc942015c5b67a45",
"md5": "b8b7775232160165196b3ff3efc80d62",
"sha256": "18c249646f0a2694b6b40fbcc5e3086b2b41eeae853cbf3b39b62d48f5740b27"
},
"downloads": -1,
"filename": "mkdocs_minyilife_plugin-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b8b7775232160165196b3ff3efc80d62",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 16369,
"upload_time": "2024-10-31T19:02:36",
"upload_time_iso_8601": "2024-10-31T19:02:36.173172Z",
"url": "https://files.pythonhosted.org/packages/32/26/3e5ea4c8749567af07f21c3065c167a1c231b3fa6a43bc942015c5b67a45/mkdocs_minyilife_plugin-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-31 19:02:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lesliezhu",
"github_project": "mkdocs-minyilife-plugin",
"github_not_found": true,
"lcname": "mkdocs-minyilife-plugin"
}
JSON
