Single Source of Truth

 
Planet Feature Update 13 - Microblogging · API Console · Experimental Web Client

Sepia

Sepia is a template optimized for microblogging. In this update, we’ve introduced several improvements to enhance this use case, allowing you to share thoughts, images, and even audio or video more frequently and easily using Planet.

sepia-microblog

Writing long-form articles isn’t something most people do regularly, so many users rely on different platforms—one for longer posts and others for quicker, more casual updates. For instance, Vitalik writes his long-form articles on vitalik.eth, but for more frequent, lightweight posts, he turns to platforms like X and Warpcast.

The Sepia template, along with the new ⌘+D quick post shortcut, makes it easy to set up your own microblog on Planet.

quick-post-new
⌘+D Quick Post Input

With this update, the quick input box now supports images, videos, and audio files.

Planet’s main sites, planetable.eth and olivida.eth, have switched from the default Plain theme to the Sepia theme. You can also check out a live demo of the Sepia theme here:

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

Accept ETH Donation

We've added a new feature that lets you easily enable ETH donations on your site.

accept-donation
Right-click My Planet and select "Accept Donation"
donation-settings
Enter your ETH address in the "Accept Donation" settings

Visitors can click the “Donate” button in the navigation bar, connect their wallet, and send donations directly to you.

donation-modal

Right now, donations are supported with ETH on the mainnet. In future updates, we’ll add support for Layer 2 networks and continue refining this feature.

If you’re a content creator or open-source developer who’s previously used PayPal or Ko-Fi for donations, consider giving this method a try. No need to ask for permission and no one can hold back the funds—everything is just code.

Customizing and Sharing Color Themes

template-settings
Right-click My Planet and select "Template Settings" to customize the Sepia theme colors.
template-settings-colors
You can also export your custom theme as a JSON file to share, or revert to the default colors.

Here’s an example of a Sepia site with a dark color theme customization:

https://k51qzi5uqu5dgy9qlqct5gsbggde32kc8wkz6419j67t9aw38bmyuwtkzmwdtn.eth.sucks/

API

We've enhanced Planet's built-in REST API and added an API Console to view recent requests.

api-console

You can check out Planet's API documentation here:

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

We’ve also developed an experimental Web Client based on the Planet API. Here’s how you can try it:

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

Enable the API server in the settings:

planet-api-server

If you're using port 8086, you can access the Web Client at http://localhost:8086/app/.

experimental-api-client

Other Fixes and Improvements

  • Fixed the img tag width when inserting Retina Display screenshots.
  • When following a Planet, ENS will now be automatically extracted from eth.limo or eth.sucks URLs if pasted.
  • GPS data is now stripped from image files when sharing photos.
  • Fixed and optimized an issue related to parallel processing during Planet site saving and publishing.
  • Each article now has a CID-based permanent link, which will remain accessible via most IPFS gateways, even if the site’s IPNS address fails to resolve.
  • Smart Feeds now show the total number of entries.
  • If the prewarm option is enabled, tags and archive pages will also be prewarmed on the gateway whenever new content is published, improving load times for first-time visitors.
 
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 页面也会在网关上被预热,这样可以让网站被初次访问的访客更快打开。
 
Ideas

Combined View of Following

New Smart Feed: Aggregated?

 
Plan

Planet

  • Templates should use UI fonts: Plain, Grid, Sepia, Sparkle
  • Use Self.logger instead of debugPrint
  • Aggregation: notification
  • Follow Featured Sites
  • macOS Language detection for Follow Featured Sites
  • Aggregation: do not sort, or comments will not work
  • Aggregation: timer
  • Show total count of: today, unread, starred
  • More sophisticated way to parse the input when following

Quick Share

  • Support audio attachments
 
About

如果我就把所有关于 Planet 要做的一切,就只写在一个文件里?然后只维护这一个文件作为唯一的项目管理方式?

值得尝试。