基于 Pjango 的主题博客。使用 Swift4.x
开发,运行在 macOS
和 Linux
上。使用 Pjango,可以快速搭建你的网站。只需集成你需要的组件,而无需关心服务器和数据库具体的实现细节。
Calatrava 则是对其的高度集成,它是已经完成的博客系统。使用 Calatrava,你可以迅速在你的云服务器上运行起你的博客,直接开始写作。
注意:个人博客最新的更新已转为私有仓库,不再开源,该仓库不再维护。
项目包含:
- 前端样式和网页模板。
- 基于 Pjango 的博客服务器程序。
- 基于 Pjango 的可扩展插件集成。
- 克隆此仓库。
- 修改
AppDelegate.swift
中的PJANGO_WORKSPACE
路径。 - 若遇到无法写入日志的错误,请手动新建日志的目录,路径同样位于
AppDelegate.swift
中。 - 按照下文中
准备工作
一节中修改hosts
添加本地解析。 - macOS:使用下面的命令生成 Xcode 工程进行编译:
$ swift package generate-xcodeproj
- Linux: 使用
Swift Package Manager
编译:
$ swift build
- macOS 中请使用 root 用户执行,否则无法使用 80 端口。
- 打开浏览器,输入
calatravatest.com
进入博客。
参考: 我的博客
如果你喜欢这个效果,可以以 Star 的方式支持我。
基于 Pjango 实现,Model 和 View 分离,具体请参考 Pjango 的文档。
默认的设计下,Model 都有一分钟的内存缓存,可以修改各 Model 的 cacheTime
参数。
更多设置可以直接看源码后修改对应的属性。
默认的 WorkSpace 包含以下目录:
- static:静态资源目录,发布后可通过 url 直接访问到静态资源。
- templates:网页模板目录,包含未渲染的网页模板以及博文内容。
- runtime:运行时目录,默认情况目录下仅产生日志文件。
- filedb:文件数据驱动,默认情况下博客不关联任何数据库,数据以 json 文件方式存放在该目录下。
修改 hosts,添加本地解析以方便调试。
127.0.0.1 www.calatravatest.com
127.0.0.1 calatravatest.com
127.0.0.1 posts.calatravatest.com
127.0.0.1 project.calatravatest.com
Global.swift
和 AppDelegate.swift
有部分参数需要根据实际情况修改,如路径和域名等。
在默认使用文件数据驱动的情况下,在 Workspace/filedb/default/LocalConfig.json
修改对应参数即可。
以下为 macOS 平台下使用 MacDown 编写博文的步骤:
使用 MacDown 编写内容并导出成 HTML。
克隆 这个 仓库,编译后二进制程序可自行保存。
运行这个程序,参数为输入文件和输出文件路径,剔除导出的 HTML 中的样式部分。
将博文 HTML 推送至 Workspace/templates/posts
目录下。
将配图等静态资源推送至 Workspace/static
目录下。
编写时请注意静态资源的路径。本地编写时推荐将 .md
文稿临时放在 static
目录下,以配合写作时的静态资源路径和发布以后的 url 访问地址一直。
在默认使用文件数据驱动的情况下,在 Workspace/filedb/default/posts.json
文件中加入相应记录即可。
博文模型:
var pid = PCDataBaseField.init(name: "PID", type: .int)
var title = PCDataBaseField.init(name: "TITLE", type: .string, length: 64)
var date = PCDataBaseField.init(name: "DATE", type: .string, length: 16)
var read = PCDataBaseField.init(name: "READ", type: .int)
var love = PCDataBaseField.init(name: "LOVE", type: .int)
var tag = PCDataBaseField.init(name: "TAG", type: .string, length: 64)
因此,按照模型的结构,json 结构:
{
"objs" : [
[
"id,记录的额外字段,任意整数,不可重复",
"PID,博文id,整数,和博文 HTML 文件名一直。如PID = 17001,对应 HTML 文件为 17001.html",
"TITLE,博文标题",
"DATE,博文发布日期,YYYY-MM-dd HH:mm:ss",
"READ,阅读数量",
"LOVE,点赞数量",
"TAG,标签列表,以|分隔",
]
]
}
根据上面提到的规则,根据各自的模型代码直接修改对应的 json 文件记录即可。
如果改用Pjango-MySQL组件,直接改数据库记录即可。
部分页面内容是直接渲染静态网页的,如 about.html
中的关于内容。因此这部分内容可以直接修改 HTML。
发邮件给我: enum@enumsblog.com
Calatrava 基于 AGPL-3.0 协议进行分发和使用,更多信息参见协议文件。