264b7820c3
* Usage of a proper logging system * Minor optimizations * New features (see documentation soon) * Little code-refactoring * Improves comments |
||
---|---|---|
.gitignore | ||
LICENSE.md | ||
README.md | ||
SgEExt.py |
README.md
SgEExt — a Simple gemoji Emoji Extractor
Pronounced [sgɪksˈt]
Introduction
Let's have a talk about an usual situation.
You run a self-hosted Jekyll blog, with the jemoji plugin loaded so as to "enhanced" your content with some emojis.
You'd have noticed that by default the plugin renders your static pages with <img>
whose src
attributes are pointing to a GitHub's (Microsoft's) location.
The latter means that a third-party is able (note that it may not be the case) to log people who consult your website, and thus is a privacy issue.
So, at this step, you may have tried to extract images to serve it yourself, but the operation is only possible from a macOS system ('cause Apple emojis are present within the system font, and... gemoji is mainly using the "Apple's emoji character palette").
Now that is said, you have some options :
- Buy an Apple device
- Kindly ask a friend with an Apple device to extract and send you those PNGs (cc @Naernon)
- Change your underneath emojis module / plugin / whatever
- Wait for the gemoji project to use another set of emoji
- Download PNGs directly from GitHub, and that is definitely what this is about !
Dependencies
python3
python3-requests
Installation
Manually
git clone https://github.com/HorlogeSkynet/SgEExt.git
Usage
python3 SgEExt.py --help
How does it work ?
The script... :
- ... (after having tried locally) fetches the emojis database hosted on GitHub (don't click if you are on mobile)
- ... iterates through the elements and extracts their unicode value as hexadecimal
- ... uses the above result to download them from GitHub
Compatibility
Although SgEExt has been developed with cross-platform constraints, it has not been tested on Windows yet.
Feedbacks are welcome, as usual.
Apple users, you don't have to go this way.