Building planetable.xyz

Release Notes
 
Planet Feature Update 13

Sepia

Sepia 是一个为轻博客(microblog)优化的主题,在这次的更新中,我们为这种使用方式带来了多个功能和设计上的更新,让你可以更频繁和简单地使用 Planet 发布想法,图片,甚至音视频。

sepia-microblog

写长文章不是一件容易和经常的事情,所以很多人通常会在使用多个不同的平台,一个用于长文章,其他地方是一些更简短和快速的输出。比如 Vitalik 会把他的长文章写在 vitalik.eth,而在 XWarpcast 这样的平台上进行一些更频繁和轻量级的输出。

Sepia 主题,及新的 ⌘+D 快捷键输入框,让你可以用 Planet 搭建一个完全属于自己的 microblog 轻博客。

quick-post-new
⌘+D 快捷输入框

本次更新后,快捷输入框可以支持支持图片、视频和音频的添加。

现在 Planet 的两个主要地址 olivida.ethplanetable.eth 也从默认的 Plain 主题切换到了 Sepia 主题。同时,在下面这个网站可以看到 Sepia 主题的另外一个实际例子:

https://sepia.olivida.eth.sucks/

在网页上接受 ETH 打赏

你可以通过 Planet 的一个新功能,在网站上快速开启接受 ETH 打赏。

accept-donation
右键点击 My Planet 然后选择 Accept Donation
donation-settings
在 Accept Donation 设置中填入你的 ETH 地址

然后访客点击导航栏中的 Donate 按钮,连接钱包,就可以发送打赏。

donation-modal

目前打赏功能支持的是 mainnet 上的 ETH。在后续的更新中,我们会加入其他 L2 上的选择,并继续优化这个页面。

如果你是内容创作者、开源软件开发者,之前用过 PayPal 或者 Ko-Fi 的打赏,那么来试试这种新的方式吧。不需要向任何人申请,也没有任何人可以扣留你收到的款项,一切都只需要代码。

颜色定制及配色的输出输入

template-settings
右键点击 My Planet 然后选择 Template Settings,就可以对 Sepia 主题的颜色进行定制。
template-settings-colors
你甚至可以将定制结果输出成 JSON 文件,然后就可以用于分享配色。也可以在这个界面选择恢复默认配色。

如果你在定制主题的过程中遇到问题,欢迎加入我们的 Telegram 中文用户群讨论。

在下面的这个地址,可以看到一个深色定制的 Sepia 站点的例子:

https://k51qzi5uqu5dgy9qlqct5gsbggde32kc8wkz6419j67t9aw38bmyuwtkzmwdtn.eth.sucks/

API

我们改进了 Planet 内置的 REST API 服务器的实现,并增加了一个用于查看最近请求的 API Console。

api-console

Planet API 的具体文档可参考这个地址:

https://github.com/Planetable/Planet/blob/main/Technotes/API.md

基于 Planet API,我们做了一个实验性的 Web Client。你可以用这样的方式获得这个 Web Client:

cd ~/Library/Containers/xyz.planetable.Planet/Data/Documents/Planet/Public/
git clone https://github.com/livid/planet-web app

从设置中打开 API 服务器:

planet-api-server

假设你使用的也是 8086 这个端口,那么访问 http://localhost:8086/app/ 就可以看到这个实验性的 Web Client。

experimental-api-client

如果你在使用 API 的过程中遇到任何问题,欢迎加入我们的 Telegram 中文用户群讨论。

其他修复和改进

  • 修复了插入 Retina Display 截图时 img 标签里的 width
  • 在 Follow Planet 时,如果 paste 了 eth.limo 或者 eth.sucks 地址现在会自动从中提取 ENS
  • 分享照片时,照片文件里的 GPS 信息会被去掉
  • 修复和优化了一个在保存和发布 Planet 站点时的并行处理问题
  • 可以获得每篇文章的基于 CID 的永久链接。基于 CID 的永久链接,即使站点的 IPNS 地址无法解析,也依然可以在大部分 IPFS Gateway 上快速打开。
  • Smart Feeds 现在会显示总条目数
  • 每次新内容发布时,如果 prewarm 开关打开,那么 tags 和 archive 页面也会在网关上被预热,这样可以让网站被初次访问的访客更快打开。
 
Planet Feature Update 12

更新了对 WalletConnect 的支持,众多针对 IPFS 的改进和新功能,全新的 Monochrom 头像图片集,及其他使用体验上的改进。

WalletConnectV2

Planet 更新了对 WalletConnect 的支持,升级到了 WalletConnectV2 版本。现在你可以使用手机钱包,比如 Rainbow,OKX 在 Planet 里登录,并用来向你关注的内容创作者打赏 ETH。同时,作为一个重要的基础架构,这也让将来 Planet 支持其他更复杂的合约调用或是 L2,成为可能。

新的 IPFS+ENS 网关

当你为站点生成分享链接时,现在可以使用一个新的高性能 IPFS+ENS 网关 eth.sucks。在设定了 content hash 的 ENS 末尾加上 .sucks 就可以访问上面的 IPFS 网站,比如:

可以从设置中选择这个新的网关。

前段时间,Cloudflare 宣布他们会停止维护 cf-ipfs 网关。所以,目前,还能用的 IPFS+ENS 网关,就是这些了:

一个健康的生态系统需要更多的参与者。

IPFS 控制面板

现在点击左下角显示 Online 的区域,会看到一个新的 IPFS 控制面板:

显示 IPFS 的版本信息,空间占用,及实时的带宽消耗。如果需要,甚至可以从这个控制面板里暂时关闭 IPFS 进程。

用本地 IPFS 网关打开任意 IPFS 资源

现在可以从 File 菜单下找到一个新的 Open 选项,用它来打开任意的 IPFS 或者 ENS 资源地址。

复用 Tags

在为内容选择 tag 时,现在可以从之前已经用过的 tag 里点击选择。

新的站点头像图片集 Monochrom

99 个全新设计的站点头像图片。

在站点设置中,可以选择在保存新的站点头像图片时,存储为圆形图片。这样做的用途是,如果你希望在浏览器的收藏夹中也显示圆形图片,而不是默认的方形。

新的快速分享拖拽

可以用拖拽任意图片放到文章列表,就可以打开一个新的快速分享发帖方式。

新的短文本输入发送

按下 CMD+D 就可以打开一个新的短文本输入发送框,配合 Sepia 主题,很适合用来记录和分享一些简短的想法。

比如这是一个使用 Sepia 主题的 microblog 站点:

sepia.olivida.eth

其他修复和改进

  • 修复了一个会发生在 macOS 12/13 上的文章列表异常。如果你使用的是 macOS 14 那么不会遇到这个问题。
  • 可以在搜索结果列表中使用键盘上下选择结果打开。
  • 模版中现在可以读取到文章主图(hero image)的高宽信息。
  • 站点 IPNS 发布完成时,会用本地通知方式显示最新的 CID。
  • 新的站点设置:Do Not Index。写入一个 robots.txt 规则文件告知搜索引擎不要索引网站。
  • 新的站点设置:Prewarm。每次新文章发布时,Planet 可以自动在当前选择的公共网关上访问一次新文章地址,这样新文章在公共网关的 IPFS 节点里就会有一份新鲜的副本,让其他访问者可以更快打开内容。
  • Insider 版本现在会有一个单独的二进制文件名称 Planet-Insider 以更方便地和其他版本共存。
  • 增加了 Filebase 节点的 Peering,如果你使用 Filebase 的 Pinning 服务,那么可以让 Filebase 的节点更容易完成同步。
 
Planet Feature Update 11

这是 Planet 的第 11 次主要功能更新,带来了这些新功能:搜索、更快的 IPNS 公共网关、置顶文章、文章的导入导出。

搜索

使用快捷键 CMD+F 就可以打开 Planet 内的全局搜索功能。你可以搜索自己写的文章,或者是你跟随的其他网站上的文章。

Search

更快的 IPNS 公共网关

在之前的版本中,我们提供 ipfs.io 或者 cf-ipfs.com 作为公共网关的选项。在这次的新版本中,我们有了一个更快的新选项:由社区项目 eth.limoNameSys 驱动。

比如,你当前正在看的这个 Planet 网站的 IPNS 地址是 k51qzi5uqu5dgbfw2poynnynor8h9kqqoxmzdrxy4h4wnzx1x5p4n40ijtosxk,你可以用下面的这个新的网关地址打开它:


IPNS + ipfs2.eth.limo

https://k51qzi5uqu5dgbfw2poynnynor8h9kqqoxmzdrxy4h4wnzx1x5p4n40ijtosxk.ipfs2.eth.limo


通常,这个新的网关地址会比之前的这些选项更快:

这个新的公共网关也可以用来打开任意的 CIDv1 地址:


CIDv1 + ipfs2.eth.limo

https://bafybeihyeuqc7nv2zfwt3x6bglgxrca2xglt26jzzqpi4zxci5czxwskku.ipfs2.eth.limo


当你在使用 Open in Public Gateway 这个功能时,现在就会默认以 ipfs2.eth.limo 打开。

置顶文章

自己的文章现在可以用置顶功能固定到列表顶部。右键单击自己的文章就可以看到这个新功能。

Pin Article

文章导出导入

你现在可以把自己的文章导出为一个数据包,然后可以在另外一台 Mac 的 Planet 里导入。或者也可以直接使用 AirDrop 发送。

Export Article

其他修复和改进

  • 改进:完整构建(Full Rebuild)功能现在通过使用所有 CPU 核心而变得更快
  • 改进:更好地监控发布 IPNS 文件夹(Published Folders)里的变更
  • 新功能:新文章发布时,在公共网关上进行预加载
  • 新功能:顶部工具栏现在有了一个新的可以编辑自己文章的按钮
  • 修复:新创建的文章的滚动位置,之前的版本里,可能滚动位置不能在列表里完整显示新创建的文章
 
Planet Feature Update 10

这次的更新里包括了一些重要的性能方面的改进,及一个全新的主题:Sepia!

与 eth.limo 的直连(IPFS Peering)

eth.limo 是目前最好的 ENS 网站网关。IPFS 直连(Peering)功能的加入,意味着你接下来更新的任何新内容,都可以更顺畅地出现在 eth.limo 上。因为现在 eth.limo 在 IPFS 网络上可以直接找到你的节点。

关于这项技术的更多细节,如果你好奇,可以阅读 IPFS 官方关于 Peering 的文档:

https://docs.ipfs.tech/how-to/peering-with-content-providers/

新主题 Sepia

Sepia 是一个全新设计的主题,非常适合更新频繁的 microblog 类型内容。

点击 这里 可以看到使用这个主题的一个演示网站。

功能列表:

  • 按时间顺序在首页展示每一个发帖的完整内容(类似 Twitter/X 的展示逻辑)
  • 当使用桌面浏览器访问时,呈现的是两栏结构,同时针对移动设备做了响应式设计适配
  • 支持视频、音频、及多图内容
  • 支持 Planet 最新的标签和归档功能

我们会继续改进围绕这个新主题的发帖功能。期待能够收到来自大家的反馈。在下一次的更新中,我们会加入一个全新的发帖界面,让更频繁的内容更新过程变得更加舒服。😌

改进了的 IPNS 发布流程

当你尝试在应用程序正在执行 IPNS 发布(侧边栏中有动画沙漏图标时)时退出应用程序,现在会显示一个确认对话框。以前,在此过程中退出应用程序可能导致 IPNS 发布未完成,并导致网站无法解析。

我们相信这个改进会大幅改善 IPNS 网站因为发布中断而导致的无法解析问题。

改进了的 Rebuild

现在有两种类型的 Rebuild:Quick Rebuild 和 Full Rebuild。Quick Rebuild 只会重新生成站点的首页文件,即 index.html。Full Rebuild 还会使用您当前为站点选择的模板重新生成每篇帖子。当你正在调试如 Croptop 这样的 SPA(单页应用程序)模板时,Quick Rebuild 会非常有用。

其他修复和改进

  • 修复了在 macOS 14 上添加附件功能无法使用的问题
  • 修复了导致侧栏站点头像模糊的图像插值设置
  • 修复了当头像取消设置时,网站 favicon 未被移除的问题
  • 增加了在快速分享对话框中粘贴图片的支持
  • 为 Planet API 服务增加了 Bonjour 宣告
  • 在头像选择器中增加了随机选择功能
  • 增加了一个新的 API 端点:/v0/id
 
Planet Feature Update 9

在这次的功能更新中,使用 Planet 来进行博客写作的体验更加完整了。我们非常高兴为你带来这些新功能:标签,归档,增强的 Pinning 服务支持,及一个在 Dock 上的动画图标!

Tags

你现在可以使用 Article Settings 或者 Writer 界面上的图标来为文章设置标签。

每个标签会有自己的页面。这样的话,具有同样标签的所有内容就可以在一个页面上看到。

比如,这是 Planet 的所有功能更新的博文,使用的是 Release Notes 这个标签。

https://planetable.eth.limo/release-notes.html

Archive

增加了一个全新的归档页面。在这个页面上可以看到所有的历史内容。

Planet 的三个内置主题都已经为这次的新功能(标签和归档页面)做了更新。

更改 App 图标

新增了 Icon Gallery 让你可以为 App 选择一个新的图标。

如果你持有 Pinnable NFT Series A,那么你还可以解锁两个具有动画特效的图标。

要使用这些 NFT 图标,你需要首先连接你的钱包。你可以使用手机上的 Rainbow 钱包来实现在 Planet 里的扫码登录。

选择主图

当一篇文章具有多个附图时,你可以选择其中的一张作为主要图片(Hero Image)。主要图片会在当文章被分享到其他社交网络时显示。比如当文章链接被分享到 Twitter 或者 Discord 时。

设置了 Hero Image 之后在 Twitter 里分享链接的效果

增强的 Pinnable 支持

我们继续改进了在上一个版本中引入的 Pinnable 集成。现在当你为网站启用 Pinnable 服务时,各类交互的结果会以更及时的方式反馈。

表示网站已经被 pinned 的图标

当你的网站名称右侧出现这个图标时,意味着 Pinnable 已经成功保存了副本。如果你使用的是笔记本电脑,这个时候你可以放心地合上盖子,你的网站会继续通过保存在 Pinnable 服务器上的副本来提供服务。当启用了 Pinnable 的服务时,从各种 IPFS 网关访问你的网站的速度和可用性都会得到提升。而你依然完全控制着网站内容的权威版本。

 
Planet Feature Update 8

下载地址:

Article Settings 及新的文章列表视图

增加了一个新的 Article Settings 右键菜单。可以用来将一篇博客文章设置为 Page。这对于创建像 About Us 和 Contact Us 之类的站点级别页面会特别有用。

通过这些新设置,你可以获得类似 planetable.eth 顶部这样的网站导航设计。这可以通过指定某些文章作为网站导航栏中的条目来实现。

通过点击这个新的列表过滤器,你可以按类型过滤文章,更容易地找到特定页面。

重新设计过的文章条目视图现在会显示内容类型及附件信息。

Planet Avatar Picker

Planet 现在有一个全新的头像选择界面。让你可以从多组充满设计感的图集中选择一张作为你的 Planet 网站的头像。

这次上线的第一个图集,Nostalgia,包含了 99 个简洁而抽象的来自设计师 yihanphotos.eth 的作品。

快速分享

现在你可以把图片拖拽到 Planet 图标上,就可以快速分享图片。

Pinnable

Pinnable 是一个全新的用于 ENS/IPNS 网站的 Pinning 服务。

当你使用 Planet app 创建和发布去中心化网站时,你的 Mac 会成为 P2P 网络上的一个节点,用于托管你的网站。通过使用一个 Pinning 服务,你的网站内容的额外副本会被复制到 Pinning 服务的节点上,这样可以让网站的加载速度更快,同时也增加了内容的可达性(availability)。尤其是对于笔记本用户,就不用让电脑一直开着作为服务器。每次当你发布新内容时,Pinnable 就会开始与你的本地节点进行同步,同步完成之后,你的内容就也存了一份到 Pinnable,这样你就不用一直开着自己的机器作为服务器了。

虽然使用了一个远程服务,你对内容的权威版本依然具有完全的控制。远程服务无法篡改或者删除你的内容。

To-Do 列表语法

Planet 的 Markdown 编辑器现在也可以支持类似 GitHub 的 To-Do 语法。并且在 My Planet 的右侧视图中,可以直接点击 To-Do 列表中的项目来勾上已经完成的事项。

YouTube 嵌入

如果你在正文中包括了一个 YouTube 的视频链接,那么现在链接会自动转化为一个播放器。

其他改进

  • 支持用拖拽的方式调整左侧列表中 My Planet 和 Following Planet 的顺序
  • 在 Rebuild Planet 时现在会显示一个进度条
Rebuild Planet 时的进度条
  • 修复了移动文章时的一个问题
  • 修复了当 App 长时间运行时可能会发生的一个崩溃问题
  • 模版现在可以有自己的设置,这为更复杂的定制模版功能打开了可能性
  • 增强了 Markdown Writer 在滚动时的性能
  • Markdown Writer 的时间选择器现在可以选择「今天」
 
Planet Feature Update 7

这次的更新包括了新的星标类型,Planet 的 API 服务器,对移动主数据目录的支持,IPNS 私钥管理器,支持更多的社交网络连接,Insider 和 Debug 版本的新图标,及 bug 修复和功能改进。

星标类型

现在当你在给一篇文章添加星标时,你可以选择几种新的类型,来为星标赋予一个更明确的含义。其中几种类型会让 Planet 具有 To-Do 管理软件的感觉。除了右键点击,现在还可以从工具栏中来管理文章的星标。

Stars

在后续的更新中,我们将会支持更具星标类型过滤文章。

文章的日期选择器

当你在编辑文章时,可以为文章选择任意日期。无论是过去还是将来。

Writer Date Picker

API 服务器

在 Planet 应用运行的时候,现在可以提供一个 HTTP API 服务器。下面是目前能支持的请求的列表,我们会通过文档提供更具体的使用信息。这是一个 v0 版本的 API,因此在后续的更新中有可能会更改。API 服务器为第三方客户端提供了可能性,尤其是后续对移动设备的支持。

  • GET /v0/planets/my - List all my Planets
  • POST /v0/planets/my - Create a new Planet
  • GET /v0/planets/my/:uuid - Info of a specific My Planet
  • POST /v0/planets/my/:uuid - Modify my Planet
  • POST /v0/planets/my/:uuid/publish - Publish My Planet
  • GET /v0/planets/my/:uuid/public - Expose the content built
  • GET /v0/planets/my/:uuid/articles - List articles under My Planet
  • POST /v0/planets/my/:uuid/articles - Create a new Article
  • GET /v0/planets/my/:uuid/articles/:uuid - Get an article by UUID
  • POST /v0/planets/my/:uuid/articles/:uuid - Modify an article
  • DELETE /v0/planets/my/:uuid/articles/:uuid - Delete an article
Planet API Server

你可以在应用的设置中打开 API 服务器,并设置端口号、用户名及密码。

移动主数据目录及 IPNS 私钥管理器

这还是一个试验性的功能,在使用时请注意数据备份

Planet 应用在默认情况下,所有的数据存放在这个位置:

~/Library/Containers/xyz.planetable.Planet/Data/Documents/Planet

现在在应用设置中,你可以移动这个位置。如果新位置位于 iCloud Drive 或者 Dropbox,那么相当于你就通过云服务备份了数据。

于此同时,本地的所有 IPNS 私钥,现在可以通过一个新的 Key Manager 来管理及通过 iCloud Keychain 备份,如果你在 iCloud 设置中打开了 iCloud Keychain 功能的话。你可以在 Tools 菜单下找到新的 Key Manager。

对于所有数据同步的支持还在测试中。上面提到的移动主目录功能,及新的 Key Manager 功能,为数据在几台 Mac 之间的完全同步提供了可能性。但是目前还有一些边缘情况,需要更多的测试及代码上的处理。因此我们任务这个功能目前还处在一个试验性的阶段。在使用时需要小心。## 更多的社交网络连接支持

现在你可以为你的 Planet 填入这些社交网络的 ID,之后会显示在生成的网站首页,及其他人追随你的 Planet 时看到的信息面板里。

  • Juicebox
  • Mastodon
  • Twitter
  • Telegram
  • GitHub
Juicebox Social

Insider 和 Debug 版本的新图标

我们会时不时发布 Insider 版本。Insider 版本中包括了最新的功能。这些功能通常在进入稳定版本之前,需要更多的测试。因此我们通过 Insider 版本来让新功能在发布之前能够获得更充分的测试。你可以从 Planet 项目的 GitHub Releases 页面下载最新的 Insider 版本。

https://github.com/Planetable/Planet/releases

如果你下载并运行了 Insider 版本,那么你会注意到这个版本现在具有一个独特的蓝色图标,具有类似 Xcode 及其他 Apple 开发工具的风格。同时我们也为 Insider 版本添加了专有的升级通道,因此现在 Insider 版本也可以获得自动升级。

如果你是从源代码构建 Planet,那么你就可以获得这款黄色的具有建设中意味的图标。

Icons: Insider and Debug

在后续的更新中,我们会提供更多的图标选项。比如最近在 Pinnable 项目中出现的新设计

其他细节改进

  • 在默认模版中为表格和 To-Do 列表增加了 CSS 样式
  • 为 HTML 中的社交网络分享图片使用了更兼容的绝对 URL 地址
  • 修复了一个在添加视频时的崩溃问题
  • 修复了之前版本中音频播放器按钮不响应的问题
  • 为工具栏中的 ETH 打赏功能换上了一个由 SF Symbol 驱动的图标
  • 默认的 Plain 主题中的样式微调,带来整体更好的对比度
  • 侧栏中的 Planet 图标增加了边框和投影以实现更好的对比度效果
  • 模版中现在可以使用一个新的变量用于引用社交网络分享大图 social_image_url
 
Planet Feature Update 6

这是 2022 年的最后一天。在我们发布这个功能更新时,有些时区已经迈入 2023 年了。新年快乐!感谢大家在这一年对 Planet 的关注和支持。

在 Feature Update 6 中的一个主要更新,是一个全新的页面主题——Grid。你可以在下面这个地址看到效果:

yihanphotos.eth

yihanphotos.eth

这是一个为大量的图片和视频所优化的设计。针对 Desktop 和 Mobile 都做了响应式的设计。为了支持这个新的主题,软件本身需要提供一系列数据层面的更新:

视频第一帧存为图片文件

视频的第一帧会被保存为一个叫做 _videoThumbnail.png 的图片文件。例如这个红冠亚马逊鹦鹉的视频:

第一帧的图片文件地址:

Hero Image

如果文章附件中包括了一张足够宽的图片,那么这张图片的名字会可以在模版中以 heroImage 这个变量获得。这会为模版设计带来很多新的可能性。

同时,这个文件会被额外转换成两个适合在方格布局中使用的版本:_grid.jpg 和 _grid.png。如果附件中包括视频,那么视频的第一帧图片会成为 Hero Image。并且生成两个方格版本,比如:

这类由 Planet 在渲染时额外生成的图片文件,名称都会是 _ 下划线开头。


以上是关于新模版的介绍。在后续的更新中,我们会继续带来模版设计方面的更新。传统的博客系统如 WordPress、Jekyll、Ghost 等,在十多年的积累过程中,积攒了大量经过考验的信息组织方式方面的设计,而这些都是 Planet,从一个静态网站生成器的角度出发,需要接下来全部补齐的。


Published Folders Dashboard

Published Folder 是 Planet 在 2022 年 10 月的功能更新加入的新功能——可以把任意的本地文件夹,发布为 IPNS。

可以把这个功能理解为一个完全图形化界面操作的 IPFS 发布,尤其适合把各种静态网站生成器的 build 结果发布。比如 Jekyll。

之前这个功能的入口是在 Tools 菜单下。现在你可以在 Tools -> Published Folders -> Dashboard 找到这个新的图形界面管理入口。

Published Folders Dashboard

New Template Browser

模版管理工具 Template Browser 现在具有一个三栏式的布局可以用于呈现更多信息。并且可以预览模版的首页列表的设计。

Template Browser UI
 
Planet Feature Update 5

这次的功能更新会是首先以 Insider Build 的方式发布,需要从下面的这个 GitHub 链接去下载。因为其中的一些大的变更,在通过自动更新推送给所有用户之前,我们希望能够更充分地测试一下。

因为这次会有一个主要的新功能——通过 ETH 直接给内容创作者打赏。具体的使用方式是这样的:

ETH Tipping

在 0.11 版本的 Planet 中,可以在菜单 Planet 下找到一个新的选项——Connect Wallet。

Connect Wallet

然后用支持 WalletConnect 的钱包应用扫描弹出的二维码,然后 Planet 应用里就可以知道你的钱包地址及向应用发起交易请求。在这个阶段,不会有签名操作。

Planet WalletConnect QR Code Example

之后当你在 Planet 里访问 .eth 域名上的网站时,在 Toolbar 里会出现这个新的打赏按钮。如果在你 Follow 的 .eth 网站的 Toolbar 里没有出现这个按钮,那么请右键在 Planet 名称上点击 Check for update 解析 ENS 后面对应的钱包地址。并且,这个打赏按钮只会在连接了钱包之后才会出现。

Tip Button

按下之后就可以选择打赏金额——从 0.02E 到 1E 的几个不同的级别。如果你使用的是 MetaMask 的手机版本,那么这里还可以选择使用哪个网络发送,目前支持主网、测试网 Goerli 和测试网 Sepolia。

Tip Tiers

点击 Send 之后,这时手机上的钱包应用就会弹出一个转账确认。按下确认之后,打赏就发送到目标地址了。这是一笔简单的两个 ETH 地址之间的转账,你选择的打赏金额会 100% 进入内容创作者的钱包。

Sending 0.02 ETH to vitalik.eth

如果你在连接钱包的时候使用的应用是 Rainbow,那么需要注意的是 Rainbow 会在连接界面的右下角让你选择网络。如果你希望连接的是测试网 Goerli,那么需要在这里选择。如果你没有看到 Goerli 的选项,那么需要在 Rainbow 的设置中打开对 Testnet 的支持。之后在发送交易时,Rainbow 不支持交易时切换网络,会永远使用一开始的选择。

点击主界面左上方的钱包地址按钮,就可以看到所有过去发出的打赏记录:

ETH Transaction History

MetaMaskRainbow 是我们在开发这个功能的过程中,主要测试过的两个应用。如果你使用的是其他支持 WalletConnect 的应用,可以在 GitHub 的 Discussions 里告知我们,我们来试着进行更多的测试。目前,我们推荐使用的手机钱包 App 是 MetaMask 和 Rainbow。


上面是 0.11 版本中新增的 ETH 打赏功能的介绍。

下面是本次更新中带来的其他功能和修复。

Published Folder 的自动发布

Published Folder 是我们在上一个版本中加入的新功能——你可以把任意的本地文件夹发布为一个 IPNS。如果你之前已经在使用某个静态网站生成器,那么这个功能可以帮助你快速把构建结果发布为 IPNS。

Automatically Publish

新增加的 Automatically Publish 开关可以自动监测文件夹内的内容变化,然后在每次变化发生时,将最新的 CID 写入 IPNS 实现内容的自动更新。

在不同的 Planet 之间移动文章

现在如果你右键点击文章,就可以找到一个新的选项让你可以在 Planet 之间移动文章。

Move Article

比如你可以指定一个 Planet 来作为你的草稿箱,在里面写作和调整文章的样式,然后在完全满意之后,再把这篇文章移动到需要正式发布的那个 Planet。比如你现在看到的这篇文章,就是用这样的流程完成的。

Archive/Unarchive

现在你可以把自己创建的或者正在追踪的 Planet 设置为 Archive 状态。Archive 状态的 Planet 不会显示在侧栏中,也不会被自动发布或者更新,但是所有的数据会在本地保留。

之后如果你想找回,可以从 Planet 的设置面板中 Unarchive。

用于显示 Planet 的 IPNS 和 CID 信息的新面板

如果你需要获得一个 Planet 的 IPNS 或者最新的 CID,那么现在可以右键单击,然后找到一个新的菜单选项 Show IPNS and CID 就可以看到。

Show IPNS and CID

感谢大家对这个项目的持续支持。这次的新功能——ETH 打赏希望大家能够帮忙多多测试。如果需要获得 GoerliETH 测试网上的 ETH 来体验这个功能,可以通过下面这个网站挖一些试试:

如果你在使用中遇到问题,可以从以下社区渠道向开发者反馈或者寻求社区协助:

如果你十分确定遇到了软件实现上的 bug,那么可以通过 GitHub Issues 向我们描述如何复现 bug,我们会尽快调查和解决。

 
Planet Feature Update 4

欢迎来到 Planet 在 2022 年 10 月 12 日发布的 Feature Update 4。在这次的功能更新中,我们为你带来了 4 个大的主要功能,及其他细节问题上的修复。

下面的链接是从 0.9.2 到 0.10.0 版本之间的所有改动的更新日志:

https://github.com/Planetable/Planet/compare/release-0.9.2...release-0.10.0

发布本地目录到 IPNS

现在你可以在 Planet 把本地的任意目录发布为一个 IPNS。这个功能可以在菜单 Tools -> Published Folders 找到。

published-folders

这样的话,意味着可以用 Planet 发布其他静态网站生成器的构建结果,比如用 Jekyll、Hugo、Zola 等构建的网站,发布为 IPNS。

比如这是一个用 Jekyll 构建的网站:

上面的这个 IPNS 也可以直接在 Planet 里 Follow。

Filebase Pinning

Filebase: Pinned

Filebase 目前提供免费的 5GB 存储空间及 Pinning 服务。关于这个功能的具体使用方式,可以查看我们之前的博客内容:

https://olivida.eth.limo/9BE484CD-0EA5-4742-927E-FA56F7591CC2/

借助 Pinning 服务,只要在每次内部发布完成之后,再稍微多等待一会让 Pinning 服务也保存一份内容之后,就可以合上你的笔记本了。同时你的访客也会获得更快的速度。

我们会在将来提供对更多 Pinning 服务的支持。关于 Pinning 服务的一些设想,还可以看我之前的这篇文章:

https://olivida.eth.limo/09582A3A-7F32-4E3D-97B0-3105DFE42566/

Custom Code

如果你需要在 Planet 构建出来的网站的 HTML 的 head 或者 body 插入代码,比如各类流量统计或者第三方的评论系统。现在可以有更简单的方式了,之前需要编辑本地模版。

现在可以在 My Planet 上右键选择 Custom Code 就可以设置插入代码。

Planet: Custom Code

然后就可以在 3 个可能的位置插入定制代码:

  • <head></head> 中间
  • <body> 开始
  • </body> 结束之前
Planet: Custom Code

RSS 及 Podcast 支持

现在 Planet 在生成网站时,也可以同时生成 RSS 文件。比如你当前正在查看的这个博客的 RSS 地址是:

olivida.eth.limo/rss.xml

如果你发布过音频内容,那么 Planet 还可以为你生成符合 Apple Podcast 标准的,只包括音频内容的 XML 文件,地址是在域名根目录下的 podcast.xml:

olivida.eth.limo/podcast.xml

右键点击 My Planet 可以找到新的 Podcast 设置,里面可以单独为 Podcast 频道设置封面图及选择分类。

Podcast Settings

完整的 Podcast 发布平台还有许多细节功能需要做。我们会在未来持续更新和 Podcast 有关的实现。

其他细节改进

  • 修复了在构建网站时一个没有必要的 CID 变化
  • 增加了针对 localhost 上的 IPFS API 端口在 WKWebView 里的屏蔽规则
  • RSS 订阅时,如果页面上发现了多个不同格式,那么优先选择 JSON Feed
  • 增加了 Insider Build 预览测试版的发布渠道
  • 更新内置 kubo 版本到 0.15。我们也测试了最新的 0.16,但其中似乎有一个未修复的资源消耗问题,因此在本次更新时,没有使用最新的 0.16 而是使用了 0.15。
  • 使用 SecureField 显示所有涉及 API Token 的部分,防止在截图或者屏幕共享时泄露敏感信息。
  • 🌟 支持订阅 Matters Lab 发布的 IPNS

以上是本次 0.10 更新里的主要新功能和改进。如果你在使用中遇到问题,可以从以下社区渠道向开发者反馈或者寻求社区协助:

如果你十分确定遇到了软件实现上的 bug,那么可以通过 GitHub Issues 向我们描述如何复现 bug,我们会尽快调查和解决。

 
Planet Feature Update 3

欢迎来到 Planet 在 2022 年 9 月 18 日发布的 Feature Update 3。在这次的功能更新中,我们为你带来了 2 个大的主要功能,及诸多细节问题上的修复。

下面的链接是从 0.8.1 到 0.9.2 版本之间的所有改动的更新日志:

https://github.com/Planetable/Planet/compare/release-0.8.1...release-0.9.2

Follow .bit

现在在 Follow Planet 时,可以支持 .bit 域名。

.bit 域名是另外一个基于区块链的域名系统,底层数据存储和计算用的链是 Nervos Network

和 ENS 类似,.bit 也提供对 dWeb 的支持,你可以在给你的 .bit 域名绑定用 Planet 生成 IPNS 地址,这样你的 .bit 域名上就可以有用 Planet 构建的网站。.bit 的公共网关是 .bit.cc,比如 olivida.bit 上的 IPNS 可以用这个地址访问到:

https://olivida.bit.cc

和 ENS 不同的是,.bit 在更新 dWeb 纪录的时候,不需要付出额外的 gas 费,因为 .bit 在注册时,注册费中就已经包括了一定数量的数据更新所需要的费用。

dWebServices.xyz

dWebServices.xyz 提供托管的 IPNS 纪录。你可以在 Planet 的设置窗口中填入 dWebServices.xyz 的 API Key 和域名,之后每次你的 Planet 更新时,最后的 CID 就会被设置到 dWebServices.xyz 上的 IPNS 记录。这样,除了 Planet 自带的 IPNS 记录,你会获得一个额外的位于 dWebServices.xyz 上的 IPNS 记录。这对于笔记本电脑用户可能会更方便,因为这样你不需要一直开机来保证你的 IPNS 记录存活。但在 Pinning 服务被引入之前,依然需要确保网络上至少有一个节点保存了你的内容,这样其他人才能访问和 Follow 你的网站。

dwebservices-api-key

我们会在未来的功能更新中提供 Pinning 服务的集成,这样使用笔记本电脑运行 Planet 的用户,在每次内容更新后,只需要再稍微等一下,等远程的 Pinning 服务获得内容之后,就可以彻底把本子合上了。

或是通过一个 Pinning DAO 来实现这样的效果。

功能细节改进

  • 现在 Planet 应用的主窗口可以记住位置和尺寸,不会在每次关闭又重开的时候回到一个默认尺寸。
  • 全局设置中增加了选择公共网关的选项。
general-setting-public-gateway
  • 更新了和 Cloudflare 的 peering 设置,现在内容可以更顺畅地被 Cloudflare 的公共网关找到。
  • 本地 IPFS 设置中增加了对 webui.ipfs.io 的 CORS 允许,这样你可以通过 webui.ipfs.io 查看本地 IPFS 节点的一些状态。
  • 增加了对 Planet 内部链接的支持,如果现在你相对链接同一个 Planet 中的其他文章,那么应用将可以正确跳转和设置焦点。
  • 初步支持了链接到另外一个 Planet,比如 planet://zh.gamedb.eth 。如果你已经 Follow,那么会跳转到这个 Planet。如果你还没有 Follow,那么会尝试 Follow 这个地址。
  • 修复了文章列表中未读数更新不实时的问题。
  • 顶部工具栏增加了单篇文章的分享按钮。
  • 降低了 IPFS 进程保持的连接数,可以一定程度降低 IPFS 对资源的消耗。我们会在后续的更新中提供更细致的调整选项。
  • 修复了 Mark All as Read 没有正常工作的问题。
  • 修复了内容检查更新时可能导致风火轮的一个性能问题。
  • 在 Planet 的信息面板中,增加对了 ENS 类型 Planet 的标识。
  • 在 Planet 的信息面板中,可以正确显示其中的 Markdown 语法。也就是说,你可以在 Planet 的 about 信息中使用 Markdown。比如这样的链接:
planet-info-markdown
  • 在 Unfollow Planet 操作上增加了一个确认框防止误操作。
  • Planet 的信息设置窗口现在使用 TabView 来更好地组织更多信息。
  • Planet 信息中可以填入 GitHub / Twitter 用户名,在模版渲染时会用上这些信息。
  • 修复了打开 Plausible.io Dashboard URL 时的一个编码问题。(感谢来自 @Fatpandac 的 PR)
  • 修复了一个编辑器预览区域没有同步滚动的 regression 问题。
  • 编辑器窗口会按照所属的 Planet 记住尺寸和位置。
  • 支持自建版本的 Plausible.io 流量统计服务。
  • 首页模版渲染时新增变量 hasAvatar,模版设计者可以根据这个变量定制是否显示 Planet 的图标。
  • 如果为 Planet 设置了图标,那么图标也会被保存为 32x32 的位于根目录的 favicon.ico。
  • 支持通过 The Iconfactory 的 WorldWideWeb 应用来预览本地构建的网站。

以上是本次 0.9 更新里的主要新功能和改进。如果你在使用中遇到问题,可以从以下社区渠道向开发者反馈或者寻求社区协助:

如果你十分确定遇到了软件实现上的 bug,那么可以通过 GitHub Issues 向我们描述如何复现 bug,我们会尽快调查和解决。

 
Planet Feature Update 2

这是 Planet 的第二个功能更新,版本号 0.8.0,发布于 2022 年 8 月 13 日。这次的更新的代码来自于以下贡献者:

下面的链接是从 0.7.0 到 0.8.0 版本之间的所有改动的更新日志:

https://github.com/Planetable/Planet/compare/release-0.7.0...release-0.8.0

下面是这个版本里带来的新功能和改进。

Plausible.io 数据统计

Plausible.io 是一个开源的数据统计平台,创始团来自欧洲。现在 Planet 支持在 Info 面板中填入 Plausible 的 domain 和 API token,这样就可以通过 Plausible.io 看到有多少人访问过你的 Planet。

比如下面的链接是 olivida.eth 的访问数据例子:

https://plausible.io/olivida.eth.limo

另外一个例子,Plausible.io 官方网站的流量:

https://plausible.io/plausible.io

Plausible.io 的实现方式是尊重隐私的。这个平台不会收集个人信息,甚至都没有使用 cookie。因此不需要在使用 Plausible.io 的页面上弹出 cookie banner。

我们会在未来的版本更新中加入对 self-hosted 版本的 Plausible 的支持。

博客 Podcast 和附件支持

现在你可以在撰写内容时,选择附加一个音频文件,或者是直接将音频文件拖拽到写作窗口中。之后在发布时,页面上就会出现一个音频播放器。

在本篇博客的内容中,就附加了一段音频内容。这是我在 5 月份 Planet 上线之前,和 枫言枫语播客 录制的。里面分享了关于 Planet 在制作过程中的一些思考。

如果是在 0.8.0 之后版本的 Planet 客户端中访问这样的带有音频的内容,那么在工具栏中会看到一个耳机按钮,点击之后就会启动一个全局的音频播放器去播放内容中所携带的音频内容。得益于这个全局播放器的存在,播放时切换查看的文章内容,播放不会被打断。

planet-audio-player

我们会在未来的版本中继续优化这个全局音频播放器的使用体验。

如果你将其他格式的文件,比如 PDF 或者 DMG 之类拖拽进入写作窗口,那么这样的内容在发布之后,会在 0.8.0 的客户端中显示为附件。访客可以点击工具栏中的附件图标就可以下载。

内置模版的细节改进

Planet 目前内置了两个网站模版用于切换样式。

在这次的更新中,我们为这两个模版加入了众多的细节改进:

  • 对音频内容的支持
  • 针对视频和图片内容的 CSS 样式优化
  • 在顶部区域,从内容页面返回到首页的链接
  • 在 iOS 移动设备上访问时的 safe-area 问题
  • Plain 主题首页对 Dark Mode 的支持

模版的功能完备是 Planet 的重要部分。所有的内置模版和 Planet App 一样,也都是开源软件,所以如果你发现任何模版相关的问题,也可以通过 GitHub Issues 甚至 PR 的方式反馈给我们:

  • https://github.com/Planetable/SiteTemplatePlain
  • https://github.com/Planetable/SiteTemplate8bit

接下来,我们会在 2022 年 8 月发布关于如何自己构建新模版的详细文档。

下面这个项目是来自开发者 Fledge Shiu 的一个有意思的模版,实现了中文竖排的效果:

https://github.com/FledgeXu/Vertical

然后这里是一个用 8-bit 模版的关于经典老游戏的博客:

https://zh.gamedb.eth.limo/

内置 go-ipfs 版本升级

Planet 内置的 go-ipfs 版本从 0.12 升级到了 0.14。从 0.13 版本开始,上游 Protocol Labs 将 go-ipfs 项目更名为了 kubo,所以之后我们如果需要在文档中提到 go-ipfs,我们会使用它的新名字 kubo。

由于 kubo 的版本升级,会在 Planet 启动时有一个迁移仓库的操作。如果你的本地 IPFS repo 的文件数量较大,那么这个迁移可能会需要一些时间,让它跑一会就好。

我们会在未来的版本中提供更多针对本地 IPFS repo 的图形界面管理功能。

RSS 订阅器相关的细节改进

其实从 Planet 的第一个发布版本开始,这个软件就是带有 RSS 订阅功能的。但是因为一些细节还不够好用,所以我们之前没有公开宣布过这个功能的存在。

在这次的 0.8.0 更新中,我们针对 RSS 订阅的很多细节功能做了改进和测试,所以现在我们可以有一些信心来邀请你试用一下。

这里有一些有趣的 RSS 订阅源:

  • Low Tech Magazine: 一个完全靠太阳能驱动的网站,所以阴天的时候可能会断线。
  • YouTube 上的 Deep Look 频道:各种有趣动物的 4K 科普视频

YouTube Channel: Deep Look

很多会持续更新内容的网站,很可能都带有 RSS 订阅地址,一个例子就是 YouTube 上的各类 Channel 的首页。你可以尝试直接把网址填入到 Follow Planet 那里,如果内容源上确实存在 RSS 地址,那么就可以用 Planet 订阅。

如果你在使用 RSS 订阅功能的过程中遇到问题,欢迎反馈到下面这些社区渠道:

提醒相关的细节改进

我们在这次更新中进一步改进了 Local Notification 的工作方式。现在如果你收到了订阅的 Planet 的内容更新提醒,那么点击 Notification 就可以直接跳转到这篇文章。

其他细节改进

  • 更换了 Markdown 渲染引擎,现在 Planet 可以输出和 GitHub Flavored Markdown 完全一致的结果,同时也解决了之前由于使用 Ink 渲染所带来的一些 crash 问题。
  • 现在在查看文章时,如果执行了任何的下载相关的操作,那么这些操作可以正常工作了,并且可以从一个新的 Download Manager 窗口中看到下载进度。之前的版本中由于缺乏对 WKDownloadDelegate 的实现而导致了下载相关的操作没有反应。
  • 改进了对 DNSLink 加载内容的支持。值得注意的是,如果你希望以 DNSLink 方式订阅一个 IPFS 上的网站,那么需要在 Follow Planet 窗口使用 planet 协议,比如这样去输入域名 planet://zu1k.com
  • 从 Planet 发布的 IPNS 记录的 TTL 时间从 1 周调整到了 1 年。但 IPNS 记录在节点上的存在时间,依然取决于很多其他因素。所以,如果你希望保持你的 IPNS 记录有效,那么至少每周打开 Planet 运行一段时间,就肯定没有问题的。关于 IPNS 及 Pinning 这几个复杂而又重要的技术细节,我们会在接下来的一篇博客里详细介绍。

以上是本次 0.8.0 更新里的主要新功能和改进。如果你在使用中遇到问题,可以从以下社区渠道向开发者反馈或者寻求社区协助:

如果你十分确定遇到了软件实现上的 bug,那么可以通过 GitHub Issues 向我们描述如何复现 bug,我们会尽快调查和解决。

 
Planet Feature Update 1

这是 Planet 的第一个功能更新,版本号 0.7.0。

视频发布

现在在发布文章时,可以为文章附加一条视频。效果就像现在你看到的这篇一样。如果你现在在用的屏幕支持 HDR(比如新款 14 和 16 MacBook Pro 的屏幕),你会注意到这个视频是 HDR 的。

数据存储优化

我们对 App 底层的数据架构做了一次比较大的重构,来解决在上个月初次发布的版本中遇到的一些问题。在有了这个新的数据层之后,整个 App 的性能会有一个明显的提升。比如之前在打开 Unread 时可能会感受到的延迟现在消失了。如果你在升级之后遇到任何和数据相关的问题,可以到这个 Telegram 群寻求开发者支持 https://t.me/+5bl7FIsxeChlOWIz

另外就是,现在 App 在检查到新的内容更新时,会发送本地通知。我们会继续增强和 Notification 有关的功能的使用体验。

增强的 ENS 支持

最近我们发现了一个性能很好的 ENS Gateway——ETH.LIMO,然后我们把 App 里如果用传统浏览器打开 ENS 链接的地方都换成了这个。这样如果你需要把自己发布在 ENS 上的内容发给没有安装 Planet 也没有在使用 Brave 的朋友,那么你可以使用类似下面这样的连接:

https://olivida.eth.limo/