Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add blog for affine #4661

Merged
merged 1 commit into from
Apr 7, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
80 changes: 80 additions & 0 deletions docs/blog/en/2024/how-to-set-up-affine/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
slug: how-to-set-up-affine
title: "AFFINE Deployment and Usage Guide: Mastering AFFINE's Self-Hosting Basics"
description: Master AFFiNE self-hosting and experience the future of knowledge management. Our guide takes you through the process, enabling you to harness this integrated KnowledgeOS.
authors: [Carson Yang]
tags: [Notes, Sealos, Wiki]
keywords: [AFFINE, Sealos, Notion, Notes, Wiki, whiteboard]
image: images/feature.jpg
date: 2024-04-07T10:00
---

AFFiNE is a completely open-source alternative to Notion and Miro, with a greater emphasis on privacy and security. Unlike Notion, AFFiNE prioritizes the storage of note content locally. The GitHub repository can be found at [https://github.com/toeverything/AFFiNE](https://github.com/toeverything/AFFiNE).

<!--truncate-->

Built using Rust and TypeScript, AFFiNE offers developers maximum flexibility with a simple, single-command setup. This allows for easy customization and deployment of the application.

While Miro and Notion focus primarily on whiteboards and pages, AFFiNE positions itself as an integrated KnowledgeOS. It supports kanban boards, tables, and rich text paragraphs as building blocks to create pages or whiteboards, enabling comprehensive document editing, data processing, and brainstorming in one place.

![](./images/AFFINE.jpg)

## Key Features of AFFiNE

### 1. Seamless Integration of Documents and Whiteboards

AFFiNE stands out as one of the few applications that allows users to place any type of content on a borderless canvas, including rich text, sticky notes, embedded web pages, multi-view databases, linked pages, and even slides.

Each page in AFFiNE has two views, allowing users to access and edit fully functional blocks anywhere, in any form.

![](./images/AFFINE-whiteboard.png)

### 2. Multi-modal AI Copilot

AFFiNE's AI capabilities can assist with a wide range of tasks, from writing professional work reports and turning outlines into expressive slides to summarizing articles into well-structured mind maps. It can even help users draw and write prototype apps and web pages with just a single prompt.

### 3. Local-First & Real-Time Collaboration

AFFiNE adheres to the concept of local-first, emphasizing data privacy. Users have the option to opt out of the cloud service and synchronize their data independently, providing them with greater control over their information.

### 4. Self-Hosting

Users can freely fork and build custom versions of AFFiNE or self-host the application. AFFiNE also plans to launch a plugin community and support third-party modules in the future.

## Self-Hosting AFFiNE

Self-hosting AFFiNE requires PostgreSQL and Redis databases, which can be complex to set up. However, the [Sealos app store](https://sealos.run/docs/guides/templates/) offers a one-click deployment template that simplifies the process.

To get started, open this link:

[![](https://cdn.jsdelivr.net/gh/labring-actions/templates@main/Deploy-on-Sealos.svg)](https://bja.sealos.run/?openapp=system-template%3FtemplateName%3Daffine)

Set the administrator's email (AFFINE_ADMIN_EMAIL) and password (AFFINE_ADMIN_PASSWORD), then click "Go to Sealos deployment" in the upper right corner.

> New users of [Sealos](https://sealos.io) will need to register and log in to a Sealos public cloud account. After logging in, you'll be redirected to the template deployment page.

On the deployment page, click "Deploy Application" in the upper right corner to initiate the deployment process. Once the deployment is complete, click "Details" to view the application details page.

![](./images/AFFINE-on-sealos.png)

Wait for the instance status to change to "running," then click the log icon to view the logs:

![](./images/AFFINE-on-sealos2.png)

A successful startup will display the following log:

![](./images/AFFINE-logs.png)

Click on the external network address to open the visual interface of AFFiNE:

![](./images/AFFINE-details.png)

By default, AFFiNE uses local browser storage. To log in to your self-hosted instance, click "Log in and enable" in the upper right corner:

![](./images/AFFINE-console.png)

After logging in, be sure to click "Enable AFFINE Cloud Service" to avoid data loss, as failing to do so will result in data being stored in the local browser:

![](./images/AFFINE-console2.png)

Once the self-hosted cloud service is enabled, you can start using AFFiNE and take advantage of all its features.
6 changes: 6 additions & 0 deletions docs/blog/en/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,9 @@ xiao-jay:
url: https://github.com/xiao-jay
image_url: https://avatars.githubusercontent.com/u/87080562?v=4

Carson Yang:
name: Carson Yang
title: '@sealos'
url: https://github.com/yangchuansheng
image_url: https://avatars.githubusercontent.com/u/15308462?v=4

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
84 changes: 84 additions & 0 deletions docs/blog/zh-Hans/2024/how-to-set-up-affine/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
---
slug: how-to-set-up-affine
title: Notion 开源替代品 AFFINE 部署和使用教程
description: 本文介绍了开源知识库管理工具 AFFINE 的私有化部署和使用。
authors: [Carson Yang]
tags: [Notes, Sealos, Wiki]
keywords: [AFFINE, Sealos, Notion, Notes, Wiki, whiteboard]
image: images/feature.jpg
date: 2024-04-07T10:00
---

AFFiNE 是一款完全开源的 Notion + Miro 替代品,与 Notion 相比,AFFiNE 更注重隐私安全,优先将笔记内容保存到本地。

<!--truncate-->

GitHub 地址:[https://github.com/toeverything/AFFiNE](https://github.com/toeverything/AFFiNE)

AFFiNE 使用 Rust 和 Typescript 构建,只需要一个命令即可运行整个项目,AFFiNE 以最简单的方式给了所有开发者最大的想象力。

与专注于白板和页面的 Miro 和 Notion 不同,AFFiNE 将其定位定义为一体化的 KnowledgeOS。它支持看板、表格和富文本段落作为构建块来形成页面或白板,可以在这里进行文档编辑、数据处理或头脑风暴等综合处理。

![](./images/AFFINE.jpg)

## AFFiNE 的特性

### 文档与白板融为一体

许多编辑应用声称自己是提高生产力的画布,但 AFFiNE 是为数不多的几款可以让你在无边界画布上放置任何构建块的应用之一 -- 富文本、便签、任何嵌入的网页、多视图数据库、链接页面甚至幻灯片。

每个页面都有 2 个视图,你可以在任何地方以任何形式访问和编辑功能齐全的块。

![](./images/AFFINE-whiteboard.png)

### 多模态 AI copilot

无论是撰写专业的工作报告,还是将大纲转化为富有表现力的幻灯片,亦或是将文章总结为结构良好的思维导图,又或者……只需一个提示,即可直接绘制和编写原型应用和网页,AFFiNE AI 都可以做到。

### 本地优先 & 实时协作

AFFiNE 遵从本地优先的理念,强调数据的私有性,你完全可以不用它的云服务,自己进行同步。用户有了更多的选择权。

![](./images/AFFINE-workspace.png)

### 私有化部署

用户可以随意分叉和构建自定义的 AFFiNE,也可以私有化部署。未来还会推出插件社区和第三方模块。

## 私有化部署 AFFiNE

AFFiNE 的私有化部署依赖 PostgreSQL 和 Redis 数据库,部署起来比较复杂。[Sealos 的应用商店](https://sealos.run/docs/guides/templates/)提供了一键部署的应用模板,点一下鼠标即可完成部署,非常丝滑。

直接打开这个链接:

[![](https://cdn.jsdelivr.net/gh/labring-actions/templates@main/Deploy-on-Sealos.svg)](https://bja.sealos.run/?openapp=system-template%3FtemplateName%3Daffine)

接下来你只需要设置一下管理员的邮箱(AFFINE_ADMIN_EMAIL)和密码(AFFINE_ADMIN_PASSWORD),然后点击右上角的「去 Sealos 部署」。

> 如果您是第一次使用 [Sealos](https://sealos.run),则需要注册登录 Sealos 公有云账号,登录之后会立即跳转到模板的部署页面。

跳转进来之后,点击右上角的「部署应用」开始部署,部署完成后,直接点击应用的「详情」进入该应用的详情页面。

![](./images/AFFINE-on-sealos.png)

等待实例的状态变成 running 后,点击日志图标查看日志:

![](./images/AFFINE-on-sealos2.png)

如果出现了下面的日志,就说明启动成功了:

![](./images/AFFINE-logs.png)

这时点击外网地址即可打开 AFFINE 的可视化界面:

![](./images/AFFINE-details.png)

打开之后,默认使用的是本地浏览器存储。如果想登录我们自己部署的云服务,需要点击右上角的「登录并启用」:

![](./images/AFFINE-console.png)

登录之后,还要再点击「启用 AFFINE Cloud 服务」,不然数据还是继续存储在本地浏览器中,容易丢失:

![](./images/AFFINE-console2.png)

启用之后,我们就可以愉快地使用 AFFINE 啦。
6 changes: 6 additions & 0 deletions docs/blog/zh-Hans/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,9 @@ xiao-jay:
url: https://github.com/xiao-jay
image_url: https://avatars.githubusercontent.com/u/87080562?v=4

Carson Yang:
name: Carson Yang
title: '@sealos'
url: https://github.com/yangchuansheng
image_url: https://avatars.githubusercontent.com/u/15308462?v=4

Loading