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

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

34 lines
1.7 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
stage: none
group: unassigned
2021-02-22 17:27:13 +05:30
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/#assignments
2021-01-29 00:20:46 +05:30
---
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/`
2022-06-21 17:19:12 +05:30
1. Ensure you can see the new emojis and their aliases in the GitLab Flavored Markdown (GLFM) Autocomplete
2018-03-17 18:26:18 +05:30
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`