debian-mirror-gitlab/doc/development/fe_guide/emojis.md

34 lines
1.7 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
stage: none
group: unassigned
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
---
2018-03-17 18:26:18 +05:30
# Emojis
2020-06-23 00:09:42 +05:30
GitLab supports native Unicode emojis and falls back to image-based emojis selectively
2018-03-17 18:26:18 +05:30
when your platform does not support it.
2019-09-30 21:07:59 +05:30
## How to update Emojis
2018-03-17 18:26:18 +05:30
1. Update the `gemojione` gem
2019-09-30 21:07:59 +05:30
1. Update `fixtures/emojis/index.json` from [Gemojione](https://github.com/bonusly/gemojione/blob/master/config/index.json).
2018-03-17 18:26:18 +05:30
In the future, we could grab the file directly from the gem.
We should probably make a PR on the Gemojione project to get access to
all emojis after being parsed or just a raw path to the `json` file itself.
1. Ensure [`emoji-unicode-version`](https://www.npmjs.com/package/emoji-unicode-version)
is up to date with the latest version.
1. Run `bundle exec rake gemojione:aliases`
1. Run `bundle exec rake gemojione:digests`
1. Run `bundle exec rake gemojione:sprite`
1. Ensure new sprite sheets generated for 1x and 2x
- `app/assets/images/emoji.png`
- `app/assets/images/emoji@2x.png`
1. Ensure you see new individual images copied into `app/assets/images/emoji/`
1. Ensure you can see the new emojis and their aliases in the GFM Autocomplete
1. Ensure you can see the new emojis and their aliases in the award emoji menu
2020-06-23 00:09:42 +05:30
1. You might need to add new emoji Unicode support checks and rules for platforms
2018-03-17 18:26:18 +05:30
that do not support a certain emoji and we need to fallback to an image.
See `app/assets/javascripts/emoji/support/is_emoji_unicode_supported.js`
and `app/assets/javascripts/emoji/support/unicode_support_map.js`