{
"info": {
"author": "Anton Bukhtiyarov",
"author_email": "apkraft@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 5 - Production/Stable",
"Environment :: Console",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Topic :: Documentation",
"Topic :: Utilities"
],
"description": "# Glossary collector for Foliant\n\nGlossary preprocessor collects terms and definitions from the files stated and inserts them to specified places of the document.\n\n\n## Installation\n\n```shell\n$ pip install foliantcontrib.glossary\n```\n\n\n## Config\n\nTo enable the preprocessor, add `glossary` to `preprocessors` section in the project config.\n\n```yaml\npreprocessors:\n - glossary\n```\n\nThe preprocessor has a number of options (default values stated below):\n\n```yaml\npreprocessors:\n - glossary:\n term_definitions: 'term_definitions.md'\n definition_mark: ': '\n files_to_process: ''\n```\n\n`term_definitions`\n: Local or remote file with terms and definitions in Pandoc [definition_lists](https://pandoc.org/MANUAL.html#definition-lists) notation (by default this file stored in foliant project folder, but you can place it other folder). Also you can use [includes](https://foliant-docs.github.io/docs/preprocessors/includes/) in this file to join several glossary files. In this case `includes` preprocessor should be stated before `glossary` in `foliant.yml` preprocessors section. Note that if several definitions of one term are found, only first will be used.\n\n`definition_mark`\n: Preprocessor uses this string to determine, if the definition should be inserted here. `\": \"` for Pandoc [definition_lists](https://pandoc.org/MANUAL.html#definition-lists) notation.\n\n`files_to_process`\n: You can set certain files to process by preprocessor.\n\n\n## Usage\n\nJust add the preprocessor to the project config, set it up and enjoy the automatically collected glossary in your document.\n\n\n## Example\n\n**foliant.yml**\n\n```yaml\n...\nchapters:\n - text.md\n\npreprocessors:\n...\n - includes\n - glossary\n...\n```\n\n**term_definitions.md**\n\n```\n# Glossary\n\n\n $https://git.repo/repo_name_1$src/glossary_1.md\n\n\n\n $https://git.repo/repo_name_2$src/glossary_2.md\n\n```\n\n**glossary_1.md** from **repo_1**\n\n```\n# Glossary\n\nTerm 1\n\n: Definition 1\n\nTerm 2\n\n: Definition 2\n\nTerm 3\n\n: Definition 3\n\n```\n\n**glossary_2.md** from **repo_2**\n\n```\n# Glossary\n\nTerm 4\n\n: Definition 4\n\n { some code, part of Definition 4 }\n\n Third paragraph of definition 4.\n\nTerm 5\n\n: Definition 5\n\n```\n\n**text.md**\n\n```\n# Main chapter\n\nSome text.\n\n# Glossary\n\n: Term 1\n\n: Term 4\n\n: Term 2\n\n```\n\n**\\_\\_all\\_\\_.md**\n\n```\n# Main chapter\n\nSome text.\n\n# Glossary\n\nTerm 1\n\n: Definition 1\n\n\nTerm 4\n\n: Definition 4\n\n { some code, part of Definition 4 }\n\n Third paragraph of definition 4.\n\n\nTerm 2\n\n: Definition 2\n\n```\n\n\n",
"description_content_type": "text/markdown",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/foliant-docs/foliantcontrib.glossary",
"keywords": "",
"license": "MIT",
"maintainer": "",
"maintainer_email": "",
"name": "foliantcontrib.glossary",
"package_url": "https://pypi.org/project/foliantcontrib.glossary/",
"platform": "any",
"project_url": "https://pypi.org/project/foliantcontrib.glossary/",
"project_urls": {
"Homepage": "https://github.com/foliant-docs/foliantcontrib.glossary"
},
"release_url": "https://pypi.org/project/foliantcontrib.glossary/1.0.0/",
"requires_dist": [
"foliant (>=1.0.10)",
"foliantcontrib.includes (>=1.1.6)"
],
"requires_python": "",
"summary": "Preprocessor for Foliant for collecting document glossary.",
"version": "1.0.0"
},
"last_serial": 5895583,
"releases": {
"1.0.0": [
{
"comment_text": "",
"digests": {
"md5": "90a45edc8c8506b755269451b682d8bf",
"sha256": "49d86fe79ec07a1c97814eb83c236c3155d318a0e7b2d4eaf28165bed662b8eb"
},
"downloads": -1,
"filename": "foliantcontrib.glossary-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "90a45edc8c8506b755269451b682d8bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4452,
"upload_time": "2019-09-27T11:15:17",
"url": "https://files.pythonhosted.org/packages/5c/e0/f3a6e033a6310a214376fdad86f682bb44417d70d1d97696fa1d60659a77/foliantcontrib.glossary-1.0.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "4f7c2d281c8ce85301699e8115c8a38b",
"sha256": "715b2fbf04b95e2ab671bc390a04762f57fc6fa7b34cfd4c5cb22f44e1010366"
},
"downloads": -1,
"filename": "foliantcontrib.glossary-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "4f7c2d281c8ce85301699e8115c8a38b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3540,
"upload_time": "2019-09-27T11:15:19",
"url": "https://files.pythonhosted.org/packages/4e/22/b992b179e42dca889c86943e06f31bcd0cbaa4ff26ac5a155e297fefe840/foliantcontrib.glossary-1.0.0.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "90a45edc8c8506b755269451b682d8bf",
"sha256": "49d86fe79ec07a1c97814eb83c236c3155d318a0e7b2d4eaf28165bed662b8eb"
},
"downloads": -1,
"filename": "foliantcontrib.glossary-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "90a45edc8c8506b755269451b682d8bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4452,
"upload_time": "2019-09-27T11:15:17",
"url": "https://files.pythonhosted.org/packages/5c/e0/f3a6e033a6310a214376fdad86f682bb44417d70d1d97696fa1d60659a77/foliantcontrib.glossary-1.0.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "4f7c2d281c8ce85301699e8115c8a38b",
"sha256": "715b2fbf04b95e2ab671bc390a04762f57fc6fa7b34cfd4c5cb22f44e1010366"
},
"downloads": -1,
"filename": "foliantcontrib.glossary-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "4f7c2d281c8ce85301699e8115c8a38b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3540,
"upload_time": "2019-09-27T11:15:19",
"url": "https://files.pythonhosted.org/packages/4e/22/b992b179e42dca889c86943e06f31bcd0cbaa4ff26ac5a155e297fefe840/foliantcontrib.glossary-1.0.0.tar.gz"
}
]
}