Skip to content

✒️ Go 语言实现的全功能写作系统。Puti is a full-featured writing system written in Go.

License

Notifications You must be signed in to change notification settings

puti-projects/puti

Repository files navigation

Puti Logo

Puti

✒️ Puti is a full-featured writing system written in Golang.

Github Actions Go Report Card Release license

中文 | Engilsh

状态

Puti 项目现在仍在开发中,目标是面向极客的下一代写作系统。

目前在探究如何在后台管理中引入 Wasm,提高性能和开发效率(统一技术栈)。

环境依赖

  • Golang 1.13+ (Build using modules)
  • MySQL

本项目使用了 Go Modules,所以需使用 Go 1.13 以上版本。

项目不依赖 Nginx 之类的 Web Server,默认启用自动HTTPS获取Let's Encrypt证书,但是你可以配置并且使用 Nginx。

功能与计划

项目计划实现以及已经实现的功能如下:

  • 功能
    • 用户
    • 登录注册
      • 登录
      • 注册
      • 第三方接入(github等)
    • 博文系统
      • 文章
      • 页面
      • 分类
      • 标签
      • 专题
    • 知识库系统
      • 笔记本
      • 文档集
    • 媒体
    • 链接
    • 评论
    • 设置
      • 普通设置
      • 第三方设置(接入GItHub,WeChat等)
    • 主题
      • 主题支持
      • 默认主题(Emma)
      • 自由切换
      • 管理界面直接修改主题模板文件
    • 邮件
      • 邮件配置
      • 邮件发送
  • 技术支持
    • 完善的 i18n
    • 邮件服务配置
    • TOC (目前在前端主题实现)
    • 配置图片裁切
    • HTTPS(支持自动 HTTPS)
    • WebServer 转发
    • 头像接入
    • OAuth
    • 媒体文件云存储
  • 生态
    • Docker 镜像支持
    • 配置化的自动部署脚本
    • 简单的统计系统

截图

screenshot_1 screenshot_2 screenshot_3

快速开始

配置

Puti 的配置文件位于 configs 下的 config.yaml,初次使用可以从 config.yaml.example 初始化配置文件。
需要注意的配置:

配置 说明
server.http_port HTTP 端口
server.https_open 是否开启 HTTPS
server.auto_cert 是否开启自动 HTTPS
server.https_port HTTPS 端口
server.tls_cert 如果不是自动 HTTPS,配置 SSL 证书路径
server.tls_key 如果不是自动 HTTPS,配置 SSL 私钥路径
puti_domain 应用绑定的域名,如开启自动 HTTPS,将自动获取域名Let's Encrypt证书;例如:www.example.com
safety.jwt_secret Json web token 秘钥
db.name 数据库名称
db.addr 数据库 HOST:PORT
db.username 数据库登录名
db.password 数据库密码

安装

源码安装

项目使用了 Go Module,所以要求 Go 1.13 及以上的版本。目前移除了 Vendor 目录,因为现在 go proxy 已经能够很好地解决某些问题了。

# 下载
$ go get -u github.com/puti-projects/puti

# 使用Makefile来构建程序
$ cd $GOPATH/src/github.com/puti-projects/puti
$ make

使用 Docker

使用现成的镜像

我们已经提供了现成的镜像,可以直接拉取使用:

# 从 Docker Hub 拉取镜像
$ docker pull puti/puti

# 创建需要挂载的目录,例如:`/data/puti`为应用文件存放目录,`/data/logs/puti`为日志存放目录
$ mkdir -p /data/puti /data/logs/puti

# 第一次通过`docker run`来创建一个容器
$ docker run --name=puti -p 80:8000 -p 443:8080 -v /data/puti:/data/puti -v /data/logs/puti:/data/logs/puti puti/puti

# 使用 `docker stop``docker start`来停止,关闭容器。
$ docker stop puti
$ docker start puti

更多内容查看:Docker use

使用可配置的部署脚本

我们提供了简单方便地一键部署 Docker-compose 脚本文件,懒人必备。具体使用查看:puti-projects/puti-environment

使用

初始化失败,可能是数据库配置的问题(目前没有安装引导)。默认初始化一个账号 admin 密码 admin 的默认账号,请创建自己的账号后移除默认账号。功能完善后会考虑安装引导。

主题

更多主题制作中。目前提供默认主题 Emma 和 Lin,为两种不同风格的主题。

文档

TODO

更新日志

Detailed changes for each release are documented in the changelog file.

依赖

依赖 关于
gin-gonic/gin HTTP web framework written in Go.
go-gorm/gorm The ORM library for Golang.
allegro/bigcache Efficient cache for gigabytes of data written in Go.
spf13/viper Complete configuration solution.
go.uber.org/zap Fast, structured, leveled logging.
vuejs/vue JavaScript framework for building UI on the web.
ElemeFE/element A Vue.js 2.0 UI Toolkit for Web.
PanJiaChen/vue-element-admin A front-end management background integration solution.
hinesboy/mavonEditor (will be removed) A markdown editor.
Vanessa219/vditor An in-browser markdown editor.
88250/lute A structured Markdown engine that supports Go and JavaScript.

说明

部署

可以不使用 Nginx 之类的 WebServer,且支持自动 HTTPS;目前不做重定向判断,如根域名到 www 域名,HTTP 到 HTTPS;较好的实践是再加一层 WebServer。

贡献


goozp

💻📚🎨

感谢

Thanks to JetBrains for providing free Goland IDE based on JetBrains OS licenses.

goland

License

Puti is under the GPL-3.0 license. See the LICENSE file for details.

About

✒️ Go 语言实现的全功能写作系统。Puti is a full-featured writing system written in Go.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages