docs📝: add docs
continuous-integration/drone/push Build is passing Details

main
isboyjc 2024-06-19 19:14:25 +08:00
parent 5043f59f0f
commit 243fb316a2
10 changed files with 155 additions and 10 deletions

View File

@ -1,5 +1,5 @@
/*
* @LastEditTime: 2024-06-13 19:24:04
* @LastEditTime: 2024-06-19 17:56:59
* @Description: ...
* @Date: 2023-09-19 19:04:57
* @Author: isboyjc
@ -94,13 +94,17 @@ export default defineConfig({
text: '介绍',
items: [
{
text: '记录灵感',
text: '记录',
link: '/docs/basic/record'
},
{
text: '编排灵感',
text: '编排',
link: '/docs/basic/layout'
},
{
text: '编辑器',
link: '/docs/basic/editor'
},
{
text: '微信录入',
link: '/docs/basic/wechat'
@ -242,13 +246,17 @@ export default defineConfig({
text: 'Introduce',
items: [
{
text: 'Record Inspiration',
text: 'Record',
link: '/en/docs/basic/record'
},
{
text: 'Layout Inspiration',
text: 'Layout',
link: '/en/docs/basic/layout'
},
{
text: 'Editor',
link: '/en/docs/basic/editor'
},
{
text: 'WeChat Input',
link: '/en/docs/basic/wechat'

59
docs/basic/editor.md Normal file
View File

@ -0,0 +1,59 @@
---
outline: deep
footer: false
---
# 编辑器
岛屿 `MUSE` 中使用的编辑器叫 `IsleEditor`,它是一个所见即所得( `WYSIWYG` )的 `Notion Style` 风格编辑器,基于开源编辑器 `ProseMirror``Tiptap`,未来,经过我们持续不断的完善,在 `MUSE` 编辑器中适配了所有富文本编辑器功能并确保无问题后,我们会上线岛屿的笔记模块,并且也会开源 `IsleEditor`,敬请期待。
在岛屿笔记自带的编辑器中,您可以使用更丰富的样式来编辑内容。
<div class="flex relative pb-10">
<div class="w-60% h-auto flex-shrink-1 absolute bottom-0 right-0">
<img class="w-full" src="/public/img/site/1.png" />
</div>
<div class="w-60% h-auto flex-shrink-1">
<img class="w-full" src="/public/img/site/2.png" />
</div>
</div>
如过您使用三方的方式记录 `MUSE`比如微信录入、API录入也不用担心因为岛屿还支持主流的 `Markdown` 语法,您可以在三方平台记录时使用 `Markdown` 语法来定义您的内容样式。
未来我们除了会将编辑器逐步开源之外,还会单独提供一个 `MUSE` 编辑器,以供用户在使用扩展 API 定制化记录入口时,也可以使用到岛屿的编辑器。
岛屿编辑器目前已被支持的样式如下:
| 样式 | 说明 | Mac快捷键 | Win快捷键 | Markdown |
|-------|-------|-------|-------|-------|
| Bold | 加粗 | ⌘+B | Ctrl+B | `**isle**` |
| Italic | 斜体 | ⌘+I | Ctrl+I | `*isle*` |
| Underline | 下划线 | ⌘+U | Ctrl+U | |
| Strike | 删除线 | ⌘+Shift+S | Ctrl+Shift+S | `~~isle~~` |
| Code | 内联代码 | ⌘+E | Ctrl+E | `` `isle` `` |
| Link | 链接 | | | |
| Subscript | 下标 | ⌘+, | Ctrl+, | |
| Superscript | 上标 | ⌘+. | Ctrl+. | |
| Emphasis | 着重符 | | | |
| Color | 颜色 | | | |
| Background | 背景颜色 | | | |
| Text align left | 文本左对齐 | ⌘+Shift+L | Ctrl+Shift+L | |
| Text align center | 文本居中对齐 | ⌘+Shift+E | Ctrl+Shift+E | |
| Text align right | 文本右对齐 | ⌘+Shift+R | Ctrl+Shift+R | |
| Text align justify | 文本两端对齐 | ⌘+Shift+J | Ctrl+Shift+J | |
| Paragraph | 段落 | ⌘+Alt+0 | Ctrl+Alt+0 | |
| Heading 1 | 一级标题 | ⌘+Alt+1 | Ctrl+Alt+1 | `# isle` |
| Heading 2 | 二级标题 | ⌘+Alt+2 | Ctrl+Alt+2 | `## isle` |
| Heading 3 | 三级标题 | ⌘+Alt+3 | Ctrl+Alt+3 | `### isle` |
| Heading 4 | 四级标题 | ⌘+Alt+4 | Ctrl+Alt+4 | `#### isle` |
| Heading 5 | 五级标题 | ⌘+Alt+5 | Ctrl+Alt+5 | `##### isle` |
| Heading 6 | 六级标题 | ⌘+Alt+6 | Ctrl+Alt+6 | `###### isle` |
| Ordered List | 有序列表 | ⌘+Shift+7 | Ctrl+Shift+7 | `1. isle` |
| Bullet List | 无序列表 | ⌘+Shift+8 | Ctrl+Shift+8 | `- isle` |
| Task List | 任务列表 | ⌘+Shift+9 | Ctrl+Shift+9 | `[x] isle` |
| Divider | 分割线 | | | `---` |
| Block quote | 块引用 | ⌘+Shift+B | Ctrl+Shift+B | `> isle` |
| Block code | 代码块 | ⌘+Alt+C | Ctrl+Alt+C | ` ```HTML` |
| Image | 图片 | | | |
| Table | 表格 | | | |

View File

@ -3,4 +3,12 @@ outline: deep
footer: false
---
# 编排灵感
# 编排
灵感需要记录,但是灵感往往都是碎片化的,记录也只是第一步。要让这些宝贵的思维火花真正发挥作用,还需要我们学会编排灵感。
编排灵感,是将零散的点子和想法整理、分类、不日回顾、深入思考,并通过系统化的方式将它们转化为实际行动的过程。
您可以通过岛屿笔记回顾自己的灵感,并使用岛屿编辑器二次编辑、排版您的灵感。
除此之外,未来我们会计划上线在线笔记模块,当然我们不会做文档 “协同”,因为岛屿笔记永远的核心是私人,也只会围绕私人知识库迭代,届时您可以在笔记中随时将 `MUSE` 归类编排而后输出,敬请期待。

View File

@ -3,4 +3,60 @@ outline: deep
footer: false
---
# 记录灵感
# 记录
希腊神话中掌管灵感的是 [缪斯](https://baike.baidu.com/item/%E7%BC%AA%E6%96%AF/63445?fr=ge_ala) 女神,岛屿中记录灵感的模块叫 `缪思`,英文名叫 `MUSE`,缘起于此,我们将用户每一个灵感碎片都称之为一个 `MUSE`
## 更多的记录方式
- 通过岛屿笔记 Web 端记录
- 绑定微信公众号,通过微信公众号记录 [👉🏻微信录入](/docs/basic/wechat.md)
- 通过岛屿笔记扩展 API 自由定制化记录 [👉🏻API 扩展](/docs/api/api.md)
使用岛屿 Web 端编辑器记录时,我们的编辑器支持更丰富的样式,以达到绝大多数人的记录需求,通常在记录灵感是我们的需求是简单的,因为我们的需要的是快速记录,但是记录因便于回顾而变得有意义,所以我们支持更多的样式让用户在回顾中二次编辑时,使得内容更具多样化。
你只需关注公众号 `ISLENOTE岛屿笔记` 并绑定帐号,即可在微信中通过 `Markdown` 的语法记录内容,即使你不懂 `Markdown` 语法,你依然可以编辑普通文本去快捷记录,闲暇之余在 Web 端中二次编辑丰富内容。
岛屿的核心是一个帮助您存储个人数据、操作个人数据的平台,它对您个人是完全 `open` 的,您不只可以在岛屿笔记这个工具中操作数据,我们为每个用户都提供了开放的 API 接口,如果您需要,您完全可以自己使用开放接口在任意平台上对接岛屿笔记,您将可以通过一些设置获取到自己的 API使用 API 您可以随意的读写自己的数据,我们完全不设限,因为数据始终是您个人的。当然,如果您构建了其他平台对接岛屿的工具,可以分享出来并联系我们,我们感谢您对岛屿的贡献,并会为您提供一些奖励。
## 简单无压力的记录
使用岛屿笔记或者其他方式记录 `MUSE`,虽然在记录方式上输入有些区别,但是这些都是附带的内容,关于记录,您只需要记住如何打标签这一点,即可轻松玩转岛屿笔记。
在岛屿笔记中,不论任何记录方式,使用 `#` 后面拼接字符以空格结尾即是标签,如果是多级标签,使用 `/` 分割,如下:
```bash
#岛屿笔记
#ISLENOET
#标签/子标签/孙子标签
```
更多关于标签的使用,请查看 [👉🏻多级标签](/docs/basic/label.md)
当然您不使用标签,直接记录也是可以的,但是我们建议您为每个记录打上标签以系统分类方便回顾。
所以使用岛屿笔记记录,您只需要会打字、会用标签就可以了,这一点无论使用何种记录方式都是一致的。
## 更丰富的编辑器
在岛屿笔记自带的编辑器中,您可以使用更丰富的样式来编辑内容。
<div class="flex relative pb-10">
<div class="w-60% h-auto flex-shrink-1 absolute bottom-0 right-0">
<img class="w-full" src="/public/img/site/1.png" />
</div>
<div class="w-60% h-auto flex-shrink-1">
<img class="w-full" src="/public/img/site/2.png" />
</div>
</div>
岛屿笔记的编辑器是一个 `Notion Style` 编辑器,支持主流在线编辑器的样式,未来我们还会持续丰富编辑器的样式。
如过您使用三方的方式记录 `MUSE`比如微信录入、API录入也不用担心因为岛屿还支持主流的 `Markdown` 语法,您可以在三方平台记录时使用 `Markdown` 语法来定义您的内容样式。
未来我们还会将这个编辑器逐步开源,并且会单独提供一个 `MUSE` 编辑器,以供用户在使用扩展 API 定制化记录入口时,也可以使用到岛屿的编辑器。
岛屿编辑器的使用和样式支持列表请查看 [👉🏻岛屿编辑器](/docs/basic/editor.md)

View File

@ -4,3 +4,11 @@ footer: false
---
# 微信录入
通过绑定岛屿笔记的微信公众号,可以直接通过公众号输入内容,即可同步到岛屿笔记,确保你的灵感不会稍纵即逝。
目前能通过微信保存的内容有:
- 文字(已支持)
- 图片(待支持)
- 语音(待支持)

6
en/docs/basic/editor.md Normal file
View File

@ -0,0 +1,6 @@
---
outline: deep
footer: false
---
# Editor

View File

@ -3,4 +3,4 @@ outline: deep
footer: false
---
# Layout inspiration
# Layout

View File

@ -3,4 +3,4 @@ outline: deep
footer: false
---
# Record inspiration
# Record

BIN
public/img/site/1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 273 KiB

BIN
public/img/site/2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 351 KiB