# mkdocs ezglossary plugin
> Glossary support for mkdocs.
## Features
- Defining multiple glossaries
- Linking to glossary entries in text
- Printing a summary of your glossary with definitions and
references anywhere in your documentation.
- Customizable output
- Unicode support
- PDF support
## Documentation
- Read the [full documentation](https://realtimeprojects.github.io/mkdocs-ezglossary)
## Prerequisites
This plugin requires the
[material definition lists](https://squidfunk.github.io/mkdocs-material/reference/lists/)
to be active or any other plugin which generates
[html description lists](https://www.w3schools.com/HTML/html_lists.asp).
## Installation
pip install mkdocs-ezglossary-plugin
## Quickstart
### Activation
Add the following lines to your mkdocs.yml plugins section:
``` yaml
plugins:
- search
- ezglossary
```
### Defining glossary entries
Provided you use the material definition list, adding a glossary entry
just works by adding a definition list with section specifiers anywhere
in your documentation:
``` markdown
section:term
: A list of specialized words with their definitions
```
### Linking to a glossary entry
You can now link to this glossary definition using the following
syntax. This will produce a link to the definition in your documentation:
``` markdown
- See the <section:term> for details
```
### Printing a summary
Now you can place a summary of all definitions anywhere in your
documentation:
``` markdown
# Terms and Definitions
<glossary::section>
```
Raw data
{
"_id": null,
"home_page": null,
"name": "mkdocs-ezglossary-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "mkdocs, glossary, plugin, references, links",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/71/9c/bcc8c6a7d7f5d5b0e77409ff491b1d9677f4f6cffe39f19bc0efc8a2cd4c/mkdocs_ezglossary_plugin-1.7.1.tar.gz",
"platform": null,
"description": "# mkdocs ezglossary plugin\n> Glossary support for mkdocs.\n\n## Features\n\n- Defining multiple glossaries\n- Linking to glossary entries in text\n- Printing a summary of your glossary with definitions and\n references anywhere in your documentation.\n- Customizable output\n- Unicode support\n- PDF support\n\n## Documentation\n\n- Read the [full documentation](https://realtimeprojects.github.io/mkdocs-ezglossary)\n\n## Prerequisites\n\nThis plugin requires the\n[material definition lists](https://squidfunk.github.io/mkdocs-material/reference/lists/)\nto be active or any other plugin which generates\n[html description lists](https://www.w3schools.com/HTML/html_lists.asp).\n\n## Installation\n\n pip install mkdocs-ezglossary-plugin\n\n## Quickstart\n\n### Activation\n\nAdd the following lines to your mkdocs.yml plugins section:\n\n``` yaml\nplugins:\n - search\n - ezglossary\n```\n\n### Defining glossary entries\n\nProvided you use the material definition list, adding a glossary entry\njust works by adding a definition list with section specifiers anywhere\nin your documentation:\n\n``` markdown\nsection:term\n: A list of specialized words with their definitions\n```\n\n### Linking to a glossary entry\n\nYou can now link to this glossary definition using the following\nsyntax. This will produce a link to the definition in your documentation:\n\n``` markdown\n- See the <section:term> for details\n```\n\n### Printing a summary\n\nNow you can place a summary of all definitions anywhere in your\ndocumentation:\n\n``` markdown\n# Terms and Definitions\n\n<glossary::section>\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "manage multiple glossaries in mkdocs",
"version": "1.7.1",
"project_urls": {
"Bug Tracker": "https://github.com/realtimeprojects/mkdocs-ezglossary/issues",
"Documentation": "https://realtimeprojects.github.io/mkdocs-ezglossary",
"Homepage": "https://github.com/realtimeprojects/mkdocs-ezglossary"
},
"split_keywords": [
"mkdocs",
" glossary",
" plugin",
" references",
" links"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "28187feaaa666981836535cf23c6744945c1630007cedf753533480d90eccb68",
"md5": "49b67cd329318154fe5cef49a73f037b",
"sha256": "d2da91051dfe055220ac32793fc554309e836e8a7a94fa46f17fc955a455fee1"
},
"downloads": -1,
"filename": "mkdocs_ezglossary_plugin-1.7.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "49b67cd329318154fe5cef49a73f037b",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 12190,
"upload_time": "2024-10-11T11:17:19",
"upload_time_iso_8601": "2024-10-11T11:17:19.564798Z",
"url": "https://files.pythonhosted.org/packages/28/18/7feaaa666981836535cf23c6744945c1630007cedf753533480d90eccb68/mkdocs_ezglossary_plugin-1.7.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "719cbcc8c6a7d7f5d5b0e77409ff491b1d9677f4f6cffe39f19bc0efc8a2cd4c",
"md5": "d99d2ff8887aa46118d672596de12f50",
"sha256": "f0f899a3df76662effba6ff2b80b1c50eb6b15a6294efb7d43b4d607e5f14e4c"
},
"downloads": -1,
"filename": "mkdocs_ezglossary_plugin-1.7.1.tar.gz",
"has_sig": false,
"md5_digest": "d99d2ff8887aa46118d672596de12f50",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 12260,
"upload_time": "2024-10-11T11:17:20",
"upload_time_iso_8601": "2024-10-11T11:17:20.860332Z",
"url": "https://files.pythonhosted.org/packages/71/9c/bcc8c6a7d7f5d5b0e77409ff491b1d9677f4f6cffe39f19bc0efc8a2cd4c/mkdocs_ezglossary_plugin-1.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-11 11:17:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "realtimeprojects",
"github_project": "mkdocs-ezglossary",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "mkdocs-ezglossary-plugin"
}
JSON
