目录
这是一款使用flask开发的博客系统
支持文章分类,友情链接,文章信息统计,特殊Markdown样式
成品演示:manyJ'sBlog - 个人博客
1.克隆项目文件
使用git工具命令
git clone https://github.com/kamcdev/Jsoft_katheme_blog.git
或
直接下载压缩包
2.准备环境
安装Python3并在安装过程中启用环境变量
进入Jsoft_katheme_blog目录
使用命令
pip install -r requirements.txt
安装预设的依赖列表
3.启动项目
使用命令
python app.py
启动flask项目后端
在浏览器输入http://127.0.0.1:26178
进入前端页面
你可以在文章列表中看到项目已经包含了几个示例文章
1.添加文章
进入blogs文件夹
然后进入你想要发布的分类文件夹
创建一个名为你想要发布的文章的标题的文件夹(例如“如何配置反向代理”)
然后在文章文件夹内创建
blog.md(文章内容,必须)
config.json(文章信息,必须)
icon.png(文章封面,非必须,不传会显示为默认图标)
这三个文件,随后打开分类文件夹内的blog_category.json
将刚刚创建的文章填入配置,并调整分类(数字越小排序越往前)
文章添加成功!如果操作无误刷新前端即可看见文章
2.添加友链
打开项目根目录下的friendly_links.json
可以看到配置内已经添加了一个示例格式
在友链配置中添加一个像
{"name": "填写友链名称", "url": "https://www.jsoftstudio.top/"}一样的数组
修改name为友链名称,url为地址即可
1.自定义文字颜色
在文章中使用
%颜色代码%内容
即可让从颜色控制符后本行的所有内容变为指定颜色
在想取消颜色的地方使用
%NONE%
即可将颜色重置为默认颜色
示例:
%000000%这是一个黑色文字%NONE%,在取消颜色后,文字将恢复为默认颜色
2.附件
在文章中使用
[dltag:filename.extension](https://example.com/example.txt)
这样的特殊超链接格式
即可在文章中添加附件,附件会带有一个下载按钮
示例:
远程截图工具
[dltag:photoget_client.exe](https://static.jsoftstudio.top/photoget_client.exe)
直接点击上方附件即可下载
3.引用资源
通过res路由引用resources目录下的附件
示例:
<img src="/res/prtsc1.png" width = "716" height = "388" alt="截图1" align=center />
4.内置编辑器
进入/editor路由即可进入内置编辑器,页面内有输入区域,快捷样式,实时预览区域
有清空,复制,保存几个功能
内置编辑器可用的Markdown样式和文章阅读页面是一样的,包括自定义的文字颜色和附件等
在内置编辑器实时编辑更方便
5.RSS订阅
通过/api/rss.xml路由订阅RSS feed
6.浏览器测试
通过/browsertest路由访问浏览器测试页面
感谢您的体验与支持,希望您在体验便利的同时也可以贡献一份代码,为本项目的开源事业做出贡献!
