{ "info": { "author": "sebastian", "author_email": "sebastian.hug@outlook.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# gummi\n\nDo you have a bunch of preamble files for your LaTeX documents and you reuse them all the time? What happens when you want to update these templates? You'll need to modify all the files in all your documents! Very time-consuming work, very boring, but thankfully, _very easy to automate_!\n\nWith `gummi` you can do just that! You just create a git repository with your template files in it and you can use them in every LaTeX document you have!\n\n## Table of contents\n\n1. [Install](#install)\n2. [Commands](#commands)\n3. [Example](#example): [Create template](#create-template), [Use template](#use-the-template), [Update template](#update-the-template)\n\n## Install\n\nSimply run\n\n```bash\npip3 install gummi\n```\n\n## Commands\n\n```\ninit Initializes a LaTeX document\ncheck Checks if any updates to the update are available\ndetach Deletes all the template files\nupdate Updates the templates\n\nYou can use -h on any command to get help for this particular command.\n```\n\n## Example\n\nA LaTeX document of yours might usually look like this:\n\n```\n- .gitignore\n- main.tex\n- Makefile\n- sections/\n| - section1.tex\n| - section2.tex\n| - section2.tex\n- templates/\n| - logo/\n| | logo.pdf\n| - preamle.tex\n| - header.tex\n| - footer.tex\n```\n\nTypically only the `main.tex` and `sections` change, the rest should be consistent over all your documents. Here is where `gummi` commes into play!\n\n### Create templates\n\nFirst, create an empty folder and open a terminal window in it. Then run\n\n```bash\ngummi init --template\n```\n\nBasically, not much happended but a _gummi_ folder was created. Now, put all your template files into it as if the gummi folder was your root directory, like so:\n\n```\n- gummi/\n| - .gitignore\n| - Makefile\n| - templates/\n| | - logo/\n| | | logo.pdf\n| | - preamle.tex\n| | - header.tex\n| | - footer.tex\n```\n\nPush that stuff to the git service you prefer.\n\n### Use the template\n\nNow, visit your LaTeX document folder and again, open a terminal inside it. The structure of your document looks probably like this:\n\n```\n- main.tex\n- sections/\n| - section1.tex\n| - section2.tex\n| - section2.tex\n```\n\nTime to bring up the magic! Run\n\n```bash\ngummi init\n```\n\nWhen asked for the git repository, enter the HTTPS clone URL of the repository and press enter. And this is how your document looks like afterwards:\n\n```\n- .gitignore\n- .gummi/...\n- main.tex\n- Makefile\n- sections/\n| - section1.tex\n| - section2.tex\n| - section2.tex\n- templates/\n| - logo/\n| | logo.pdf\n| - preamle.tex\n| - header.tex\n| - footer.tex\n```\n\n### Update the template\n\nIf your want to update your templates, for example remove the Makefile and add another one, do just that in your template repository and push the changes to the remote git server. Then, simply run\n\n```bash\ngummi update\n```\n\nin your LaTeX document. Your changes are applied immediately! Any changes made locally to a template file will not be lost, these files do not get updated.\n\nThe _.gummi_ folder is important, it is responsible for tracking changes to your templates.\n\nMove the binary to a place where your `$PATH` points to or extend the variable.\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/seboschtion/gummi", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "gummi", "package_url": "https://pypi.org/project/gummi/", "platform": "", "project_url": "https://pypi.org/project/gummi/", "project_urls": { "Homepage": "https://github.com/seboschtion/gummi" }, "release_url": "https://pypi.org/project/gummi/1.2.10/", "requires_dist": [ "GitPython (==2.1.11)", "gitdb2 (==2.0.5)", "rfc3987 (==1.3.8)", "smmap2 (==2.0.5)", "twine (==1.13.0)" ], "requires_python": "", "summary": "Manage your LaTeX templates with ease.", "version": "1.2.10" }, "last_serial": 5251167, "releases": { "1.2.10": [ { "comment_text": "", "digests": { "md5": "373ead838daf8abc3889234a7688a447", "sha256": "03462963c4c7aa6de341adada9d3a1f6fc3c693c0c625530c9770b58e33c93a5" }, "downloads": -1, "filename": "gummi-1.2.10-py3-none-any.whl", "has_sig": false, "md5_digest": "373ead838daf8abc3889234a7688a447", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9021, "upload_time": "2019-05-10T08:26:09", "url": "https://files.pythonhosted.org/packages/f8/35/2f404bd2a5384488abf743fedccaa44c6f5c1d1f82dcd8c625ff47855c9d/gummi-1.2.10-py3-none-any.whl" } ], "1.2.5": [ { "comment_text": "", "digests": { "md5": "b4fc09491149350d1b60178ae966b5b8", "sha256": "13dae73550b9eaa1be0f0dd4e4df307769fca80526f232964946ffa9dbceca06" }, "downloads": -1, "filename": "gummi-1.2.5-py3-none-any.whl", "has_sig": false, "md5_digest": "b4fc09491149350d1b60178ae966b5b8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9537, "upload_time": "2019-04-18T12:43:53", "url": "https://files.pythonhosted.org/packages/de/98/79269ddaaa2966b2d5cab6115fb71719826bafa42d3571f5a499de9a7c53/gummi-1.2.5-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "373ead838daf8abc3889234a7688a447", "sha256": "03462963c4c7aa6de341adada9d3a1f6fc3c693c0c625530c9770b58e33c93a5" }, "downloads": -1, "filename": "gummi-1.2.10-py3-none-any.whl", "has_sig": false, "md5_digest": "373ead838daf8abc3889234a7688a447", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9021, "upload_time": "2019-05-10T08:26:09", "url": "https://files.pythonhosted.org/packages/f8/35/2f404bd2a5384488abf743fedccaa44c6f5c1d1f82dcd8c625ff47855c9d/gummi-1.2.10-py3-none-any.whl" } ] }