这是一篇迟来的更新日志,本来应该是在七月初发的,但是由于一些原因没发。

第一次更新日志可以当作 Quail 的功能介绍,下面介绍一下 Quail 的功能。

文章撰写

Quail 是机甲的话,作者就是机甲的驾驶员。文章撰写就是 Quail 的驾驶舱。所以驾驶舱的体验好不好,就非常重要。

Markdown

目前,Quail 的默认和唯一标记语言是 Markdown。所以,无论是使用网页版本编辑器,还是使用 Obsidian 插件,都可以用作者们最熟悉的 Markdown 语法撰写文章。

在核心语法以外,Quail 支持大部分 GFM 扩展语法,包括表格、删除线、自动链接等等。

如果文章中包含程式代码,它们会被自动高亮。高亮算法支持主流的大部分编程语言,例如:

#include <stdio.h>

int main() {
	printf("Hello!\n");
	return 0;
}
💡提示

唯一需要留意的是 Quail 正文中使用标题时,最大支持二级标题,也就是 HTML 的 h2

这是因为文章标题本身会被当作 h1 来显示,而按照 HTML 的要求,一个页面只允许有一个 h1。所以请不要在正文中使用一级标题,如果使用的话,行为是不能确定的。

公式与绘图

除了 Markdown 语法以外,Quail 会在文章发布时自动渲染 MathJax 和 Mermaid,这有助于科学类和工程文章的撰写(不过不支持内联公式),例如:

\[\int f(x)dx \\ \int_1^\infty \frac{1}{x^2}dx \]

这个公式的写法是:

$$
\int f(x)dx \\
\int_1^\infty \frac{1}{x^2}dx
$$

以及使用 Mermaid 语法绘图的源码

sequenceDiagram
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!
    Alice-)John: See you later!
```mermaid
sequenceDiagram
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!
    Alice-)John: See you later!
```
📧邮件兼容性

由于这二者目前都是在客户端浏览器渲染,无法在 Email 里显示。

图片与视频

图片相关的部分,细节优化比较多。主要包括:

  • 集成了 Unsplash 支持,允许用户在文章中选择 Unsplash 图片库中的图片作为封面图像。
  • 使用文章中的第一张图片作为封面图像的功能——若未选择指定的封面图像。
  • 上传的图片会以 webp 格式渲染
  • 支持读取剪贴板中的图片
  • 目前图片不支持布局,会默认充填文章宽度

视频部分,则是会自动渲染文章中单独一行的 Youtube 和 Bilibili 链接。Youtube 链接是 https://youtu.be 开头的短链接,Bilibili 则是 https://www.bilibili.com/video 开头的长链接。

📧邮件兼容性

类似于公式和绘图,视频也是在客户端浏览器渲染,无法在 Email 里显示。

支付、概览、标签、主题

开启付费并关联钱包以后,编辑器内会出现付费墙的按钮。在文章任意部分插入付费墙标签以后,付费墙标签之后的所有内容会被视为付费内容,仅有付费订阅读者可以查看。

文章的 slug,简介,标签都可以让 AI 生成。

An image to describe post

为文章提供了浅色和深色两个主题,作者可以为单篇文章设置其中之一,本篇文章就是浅色的。

Obsidian 插件

Quail 有一个 Obsidian 插件,可以把 Obsidian 里面的文章直接发布到 Quail。

An image to describe post

虽然还没有进入社区商店,但是可以手工安装。具体的配置方法请参考这篇文章

付费

Quail 支持付费文章。目前支持按年付费和按季度付费两种模式,作者可以在列表设置里分别设置他们的价格。一般情况下,很多作者会为年费订阅会提供一些优惠。

An image to describe post

付费目前使用的是加密货币,因为法币真的很难搞(但是已经在搞了,别催了别催了)。

付费的设置可以参考这篇文档

💰抽成

单笔费用中的 10% 为 Quail 的抽成,其余 90% 会进入作者绑定的钱包地址。

推送文章

Email 推送

默认条件下,会通过 Email 推送文章。但可以在列表设置的「Email 设置」中关闭 Email 推送。

另外在该设置选项之中,还可以修改订阅时欢迎邮件中的文本和邮件签名。

对于不喜欢的邮件供应商,可以在「邮件提供商黑名单 」中进行屏蔽,这样使用这些邮件供应商的读者将无法订阅。

设置的方式具体请参阅这篇文档

👀请留意

对于付费文章,付费读者的 Email 会得到全文推送,非付费读者的推送内容则只包含付费墙以外的部分。

Telegram 推送

Quail 支持使用 Telegram 频道推送文章,但需要进行一些设置,具体请参阅这篇文档

设置完成以后,推送文章时,Quail 会将文章的链接同时推送到对应的 Telegram 频道。

推送配额

为了防止滥用,Quail 限制每位作者每天只能推送三篇文章。推送限额每天重置一次。

管理

文章置顶

提供了置顶文章功能,让重要文章更加易于访问和查看。最多支持置顶三篇。

订阅者管理

作者可以手工添加、删除订阅者,也可以将某位订阅者指定为收费会员,以获得收费文章访问权限。

Quail 为文章提供了浅色和深色两个主题,作者可以为单篇文章设置其中之一。

阅读、订阅

分享

文章可以方便地分享到 Twitter、Facebook 或者 LinkedIn。

订阅管理

登录以后,用户可以查看和管理自己的订阅情况,也可以执行退订和升级会员等操作。

指标

每个邮件列表的关于页面都提供了一个指标界面, 方便读者检视作者的交付情况。

这些指标包括写了多少文章,其中收费文章有多少;有多少订阅者,其中会员读者有多少;阅览量和阅读量分别是多少。

其它周边

文档

无论怎么设计产品,总有一些操作比较复杂,所以写到了文档里面。 可以在 https://docs.quail.ink 浏览文档内容。

官网

新的官网就在 https://quail.ink

最下面放了 Discord 社区的入口,目前人比较少,欢迎加入:https://discord.com/invite/quMK3kj