nebula/README.md

139 lines
3.9 KiB
Markdown
Raw Normal View History

2020-06-19 17:10:44 +08:00
# nebula
2022-11-14 11:22:52 +08:00
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Frymcu%2Fnebula.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Frymcu%2Fnebula?ref=badge_shield)
2022-04-21 11:21:02 +08:00
## 💡 简介
nebula[ˈnebyələ]n.星云)是一款现代化的知识社区项目,使用 Vue + NuxtJS + Element-UI 实现
2020-06-19 17:10:44 +08:00
2022-04-21 11:21:02 +08:00
与 [forest](https://github.com/rymcu/forest) [ˈfôrəst]n.森林)一起食用,让我们一起探索知识社区的未来。
## ⚡ 动机
2022-08-02 08:15:00 +08:00
在 2019 年的某一天,受到 [Hugh](https://rymcu.com/user/Hugh) 的邀请, 构建一个开源嵌入式知识学习交流平台。因此就有了 nebula 这个项目。 nebula
2022-04-21 11:21:02 +08:00
在很多方面受到了 [Symphony](https://github.com/88250/symphony) 的启发,并尝试着在 [Symphony](https://github.com/88250/symphony)
和 [B3log 思想](https://ld246.com/article/1546941897596) 的基础上进一步探索。
## ✨ 特性
- 内容编辑器
- MarkdownGFM
- emoji
- 上传文件
- 图片
- 文件
- 单独渲染 MP3 文件
- 单独渲染视频文件
- 剪切板处理
- 粘贴内容处理为 Markdown
- 粘贴图片自动重新上传
- 数学公式LaTeX、流程图支持
- 工具栏
- 表情
- 粗体
- 斜体
- 引用
- 无序列表
- 有序列表
- 链接
- 上传
- 预览
- 全屏
- 编辑模式
- 传统的 Markdown 分屏编辑预览
- 保留 Markdown 标记符的即时渲染
- 类富文本编辑器的所见即所得
- 注册
- 用户名
- 邮箱
- 验证码
- 登录
- 账户(用户名/邮箱)
- 密码
- 忘记密码
- 邮箱
- 邮箱验证
- 发帖
- 帖子类型
- 普通帖子
- 标题
- 正文
- 内容编辑器
- 标签
- 使用已有(选择、自动完成)或创建
- 默认“待分类”
- 发布后
- 可更新
- 可删除
- 回帖
- 内容编辑器
- 回复(回复针对回帖)
- 货币
- 货币规则
- 浏览贴子
- 编辑自己的帖子
- 发布时间/浏览数/标签
- 分享
- 微信
- 分享链接(带用户标识)
## 报告缺陷
> 社区系统可能存在一些潜在的缺陷,大家如果有空的话可以帮助我们一起解决。
如果你在使用社区时发现了如下类型的问题,请回帖进行反馈,并附上 bug 截图以及操作步骤:
* **功能性缺陷**:例如发布文章失败、创建作品集失败等
* **安全性漏洞**:例如 XSS/CSRF、盗用用户信息等
## 功能建议
欢迎对社区提出功能特性方面的建议,我们一起讨论,如果有可能我们会尽快实现。
在提功能建议前可以先看一下 [计划表](https://rymcu.com/article/29) ,避免重复提议
## 鸣谢
2022-11-14 11:22:52 +08:00
- 感谢以下开发者对 Nebula 作出的贡献:
<a href="https://github.com/rymcu/nebula/graphs/contributors">
<img src="https://contrib.rocks/image?repo=rymcu/nebula&max=1000" />
</a>
2022-04-21 11:21:02 +08:00
- 感谢 `JetBrains` 对本项目的帮助,为作者提供了开源许可版 `JetBrains` 全家桶
2020-08-07 10:49:32 +08:00
2022-11-14 11:22:52 +08:00
![JetBrains](assets/jb_beam.svg)
2020-06-19 17:10:44 +08:00
## Build Setup
```bash
# install dependencies
2020-08-07 10:49:32 +08:00
$ npm install
2020-06-19 17:10:44 +08:00
# serve with hot reload at localhost:3000
2020-08-07 10:49:32 +08:00
$ npm dev
2020-06-19 17:10:44 +08:00
# build for production and launch server
2020-08-07 10:49:32 +08:00
$ npm build
$ npm start
2020-06-19 17:10:44 +08:00
# generate static project
2020-08-07 10:49:32 +08:00
$ npm generate
2020-06-19 17:10:44 +08:00
```
2021-02-05 10:12:58 +08:00
## 项目部署
2021-02-05 10:16:34 +08:00
1. 关闭本地项目后,在控制台执行 `npm run build` 进行打包
2021-02-05 10:12:58 +08:00
2. 拷贝以下文件至服务器
2021-02-05 10:16:34 +08:00
2021-02-05 10:12:58 +08:00
![build](assets/build.png)
3. 服务器安装 `Nodejs` 环境
4. 项目目录下执行 `npm install`
5. 执行 `npm install pm2 -g`
6. 执行 `pm2 list` 检查 `pm2` 是否安装好
7. 执行 `pm2 start npm --name nebula -- run start`
2021-02-05 10:12:58 +08:00
2020-06-19 17:10:44 +08:00
For detailed explanation on how things work, check out [Nuxt.js docs](https://nuxtjs.org).
## License
2022-11-14 11:22:52 +08:00
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Frymcu%2Fnebula.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Frymcu%2Fnebula?ref=badge_large)