wagtailemoji 1.0.2

Wagtail Emoji :tada
====================
:clap: 添加[NotoEmoji](https://github.com/googlei18n/noto-emoji)图标到StreamField. :bomb: :gun: :smoking: :knife


:warning: **重要：能做不代表应该做。**

安装
-------

pip install wagtailemoji

然后将`wagtailemoji`添加到您的已安装应用程序中。

使用方法
-----
### StreamField
以常规方式添加emoji到StreamField，只需设置`icon="emoji-something"`。参考[完整列表](https://github.com/alexgleason/wagtailemoji/blob/master/wagtailemoji/static_src/wagtailemoji/scss/wagtailemoji.scss)。

### wagtailmodeladmin
如果您使用Wagtail 1.4或更高版本，则支持[wagtailmodeladmin](https://github.com/rkhleics/wagtailmodeladmin)。与StreamField类似，只需在您的菜单项上设置`icon="emoji-something"`。

### Hallo插件
您可以通过设置`icon`选项为`icon icon-emoji-something`在自定义Hallo按钮上使用emoji。

```javascript
button.hallobutton({
label: "Skull",
icon: 'icon icon-emoji-skull',
});
```

### 管理员的其他部分
您可以在管理员中任何位置包含图标

```html
<i class="icon icon-emoji-something"></i>
```

在Wagtail 1.3.x及以下版本中，您只能在页面编辑屏幕上使用图标。

### 前端
如果您想的话，也可以在前端导入。

```html
{% load staticfiles %}

<link rel="stylesheet" href="{% static 'wagtailemoji/css/wagtailemoji.css' %}">
```

然后在前端任何位置包含图标

```html
<i class="icon icon-emoji-something"></i>
```

### 将wagtailemoji作为可选依赖项使用
如果您想分发一个带有表情符号的Wagtail插件，您可以使用这个包作为可选依赖项，通过检查它是否已安装在Django中，否则回退。

```python
from django.conf import settings
from wagtail.wagtailcore.blocks import StructBlock


class BlockquoteBlock(StructBlock)
quote = TextBlock()
author = TextBlock()

class Meta
if 'wagtailemoji' in settings.INSTALLED_APPS
icon = 'emoji-skull'
```

(在这种情况下，回退不做任何操作)