# Pelimoji
[](https://github.com/pelican-plugins/pelimoji/actions)
[](https://pypi.org/project/pelican-markdown-include/)
Pelimoji is a [Pelican][] plugin that adds support for custom emoji to your site.
Installation
------------
This plugin can be installed via:
python -m pip install pelimoji
As long as you have not explicitly added a `PLUGINS` setting to your Pelican settings file, then the newly-installed plugin should be automatically detected and enabled. Otherwise, you must add `pelimoji` to your existing `PLUGINS` list. For more information, please see the [How to Use Plugins](https://docs.getpelican.com/en/latest/plugins.html#how-to-use-plugins) documentation.
Usage
-----
Within your `PATH` content root create a directory called `emoji`. To that directory, add any square image files at least 16x16 ending in `.png`. These will be your emoji, addressable via the filename before the extension, such as `:gentoo:` if you had a file named `gentoo.png` in your `PELIMOJI_PATH`. This is case-sensitive if your filesystem is case-sensitive. 64x64 works best, but any size will do, including 512x512. Just remember, this will affect load speed for your pages.
When compiling your site, the following directory will be created and automatically added to your `STATIC_PATHS`: `PATH/emoji_map/`. You'll need to ensure that `PATH/emoji_map/emoji.css` is loaded as a stylesheet, whether using something like `webassets` or `cssmin`, or by adding directly.
You may optionally also specify a `PELIMOJI_PREFIX` to require if you might have multiple sets of colon-tags that'd overlap. Whereas I might normally use `:thumbs-up:`, I could then specify `PELIMOJI_PREFIX = "emoji"`, and my tag would instead be `:emoji-thumbs-up:`.
By default this plugin operates on source content files with the following file extensions: `["md", "html", "rst"]`, corresponding to Markdown, HTML, and reStructuredText. If you, say, want this plugin to also process files ending in `.txt`, you should add the following to your settings file:
```python
PELIMOJI_FILE_EXTENSIONS = ["md", "html", "rst", "txt"]
```
Contributing
------------
Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].
To start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.
[Pelican]: https://getpelican.com
[existing issues]: https://github.com/pelican-plugins/pelimoji/issues
[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html
Raw data
{
"_id": null,
"home_page": "https://github.com/pelican-plugins/pelimoji",
"name": "pelimoji",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "pelican,plugin,emoji",
"author": "Kay Ohtie",
"author_email": "kay@coyotesin.space",
"download_url": "https://files.pythonhosted.org/packages/e4/5d/6d2f9a752a9752a67313d03362bdf6ef125c7b957b7c6b292f6fe5acb99b/pelimoji-1.1.1.tar.gz",
"platform": null,
"description": "# Pelimoji\n\n[](https://github.com/pelican-plugins/pelimoji/actions)\n[](https://pypi.org/project/pelican-markdown-include/)\n\n\nPelimoji is a [Pelican][] plugin that adds support for custom emoji to your site.\n\nInstallation\n------------\n\nThis plugin can be installed via:\n\n python -m pip install pelimoji\n\nAs long as you have not explicitly added a `PLUGINS` setting to your Pelican settings file, then the newly-installed plugin should be automatically detected and enabled. Otherwise, you must add `pelimoji` to your existing `PLUGINS` list. For more information, please see the [How to Use Plugins](https://docs.getpelican.com/en/latest/plugins.html#how-to-use-plugins) documentation.\n\nUsage\n-----\n\nWithin your `PATH` content root create a directory called `emoji`. To that directory, add any square image files at least 16x16 ending in `.png`. These will be your emoji, addressable via the filename before the extension, such as `:gentoo:` if you had a file named `gentoo.png` in your `PELIMOJI_PATH`. This is case-sensitive if your filesystem is case-sensitive. 64x64 works best, but any size will do, including 512x512. Just remember, this will affect load speed for your pages.\n\nWhen compiling your site, the following directory will be created and automatically added to your `STATIC_PATHS`: `PATH/emoji_map/`. You'll need to ensure that `PATH/emoji_map/emoji.css` is loaded as a stylesheet, whether using something like `webassets` or `cssmin`, or by adding directly.\n\nYou may optionally also specify a `PELIMOJI_PREFIX` to require if you might have multiple sets of colon-tags that'd overlap. Whereas I might normally use `:thumbs-up:`, I could then specify `PELIMOJI_PREFIX = \"emoji\"`, and my tag would instead be `:emoji-thumbs-up:`.\n\nBy default this plugin operates on source content files with the following file extensions: `[\"md\", \"html\", \"rst\"]`, corresponding to Markdown, HTML, and reStructuredText. If you, say, want this plugin to also process files ending in `.txt`, you should add the following to your settings file:\n\n```python\nPELIMOJI_FILE_EXTENSIONS = [\"md\", \"html\", \"rst\", \"txt\"]\n```\n\nContributing\n------------\n\nContributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].\n\nTo start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.\n\n[Pelican]: https://getpelican.com\n[existing issues]: https://github.com/pelican-plugins/pelimoji/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "Pelican plugin to add custom emoji to your site",
"version": "1.1.1",
"project_urls": {
"Documentation": "https://docs.getpelican.com",
"Funding": "https://donate.getpelican.com/",
"Homepage": "https://github.com/pelican-plugins/pelimoji",
"Issue Tracker": "https://github.com/pelican-plugins/pelimoji/issues",
"Repository": "https://github.com/pelican-plugins/pelimoji"
},
"split_keywords": [
"pelican",
"plugin",
"emoji"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0211196d78b6f3846cc188a03c88646b27e278f7dbaef2abb7333a02271408f6",
"md5": "08bd83e68df476d2be211ec02f333b03",
"sha256": "be761562c80bb10da1418a6756a6dfb2b523972f4ceb5077732316096686eeb6"
},
"downloads": -1,
"filename": "pelimoji-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08bd83e68df476d2be211ec02f333b03",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 5135,
"upload_time": "2023-12-14T15:49:45",
"upload_time_iso_8601": "2023-12-14T15:49:45.119750Z",
"url": "https://files.pythonhosted.org/packages/02/11/196d78b6f3846cc188a03c88646b27e278f7dbaef2abb7333a02271408f6/pelimoji-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e45d6d2f9a752a9752a67313d03362bdf6ef125c7b957b7c6b292f6fe5acb99b",
"md5": "7309ff3198629a8997d8f89e8f1cf938",
"sha256": "73934536ed6552a3ccfc87d87e0c649e9f2d600d6f69f9366be82dddf0f6a9b9"
},
"downloads": -1,
"filename": "pelimoji-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "7309ff3198629a8997d8f89e8f1cf938",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 4958,
"upload_time": "2023-12-14T15:49:46",
"upload_time_iso_8601": "2023-12-14T15:49:46.983352Z",
"url": "https://files.pythonhosted.org/packages/e4/5d/6d2f9a752a9752a67313d03362bdf6ef125c7b957b7c6b292f6fe5acb99b/pelimoji-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-14 15:49:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pelican-plugins",
"github_project": "pelimoji",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pelimoji"
}
JSON
