docs/install.md

本地安装

使用 pip 安装

pip install meme_generator

图片下载

由于表情包图片体积较大，meme-generator 包含的表情中的图片并不随代码一起打包，需要在安装后手动执行下载命令：

meme download

直接运行源代码

克隆当前仓库：

git clone https://github.com/MeetWq/meme-generator

通过 python -m meme_generator.app 运行 web 服务器

通过 python -m meme_generator.cli 运行命令行程序

字体安装

为确保表情包中的文字生成正常，需要自行安装字体

Note

字体安装后若文字仍显示不正常，可删掉 matplotlib 字体缓存文件重新运行程序

缓存文件位置：

• Windows: C:\Users\<username>\.matplotlib\fontlist-xxx.json
• Linux: ~/.cache/matplotlib/fontlist-xxx.json
• Mac: ~/Library/Caches/matplotlib/fontlist-xxx.json

中文字体 和 emoji字体 安装

根据系统的不同，推荐安装的字体如下：

• Windows:

大部分 Windows 系统自带 微软雅黑 中文字体 和 Segoe UI Emoji emoji 字体，一般情况下无需额外安装

• Linux:

部分系统可能自带 文泉驿微米黑 中文字体；

对于 Ubuntu 系统，推荐安装 Noto Sans CJK 和 Noto Color Emoji：

sudo apt install fonts-noto-cjk fonts-noto-color-emoji

为避免 Noto Sans CJK 中部分中文显示为异体（日文）字形，可以将简体中文设置为默认语言（详见 ArchWiki）：

sudo locale-gen zh_CN zh_CN.UTF-8
sudo update-locale LC_ALL=zh_CN.UTF-8 LANG=zh_CN.UTF-8
fc-cache -fv

其他 Linux 系统可以自行下载字体文件安装：

思源黑体：https://github.com/adobe-fonts/source-han-sans

NotoSansSC：https://fonts.google.com/noto/specimen/Noto+Sans+SC

Noto Color Emoji：https://github.com/googlefonts/noto-emoji

• Mac:

苹果系统一般自带 "PingFang SC" 中文字体 与 "Apple Color Emoji" emoji 字体

其他字体安装

某些表情包需要用到一些额外字体，存放于仓库中 resources/fonts，需要自行下载安装

具体字体及对应的表情如下：

字体名	字体文件名	用到该字体的表情	备注
Consolas	consola.ttf	charpic
FZKaTong-M19S	FZKATJW.ttf	capoo_say	方正卡通
FZXS14	FZXS14.ttf	nokia	方正像素14
FZSJ-QINGCRJ	FZSJ-QINGCRJ.ttf	psyduck、nijika_holdsign	方正手迹-青春日记
FZShaoEr-M11S	FZSEJW.ttf	raise_sign、nekoha_holdsign	方正少儿
NotoSansSC	NotoSansSC-Regular.otf	5000choyen
NotoSerifSC	NotoSerifSC-Regular.otf	5000choyen
HiraginoMin	HiraginoMin-W5-90-RKSJ-H-2.ttc	oshi_no_ko	明朝体
Aller	Aller_Bd.ttf	osu

字体安装方式

不同系统的字体安装方式：

• Windows:

  • 双击通过字体查看器安装
  • 复制到字体文件夹：C:\Windows\Fonts

• Linux:

在 /usr/share/fonts 目录下新建文件夹，如 myfonts，将字体文件复制到该路径下；

运行如下命令建立字体缓存：

fc-cache -fv

• Mac:

使用字体册打开字体文件安装