Skip to content
This repository has been archived by the owner on Sep 25, 2022. It is now read-only.

A python3-based one-click website building system

License

Notifications You must be signed in to change notification settings

waterflames-team/wing-kernel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lingkong-wing(灵翼)

介绍

灵翼是一个由非凡小王开发,折腾调协助维护的基于python3语言的一键建站系统
此版本为命令行版(在线版内核),最终版本请等此版本第三代时一并发布的在线版(lingkong-wing-web)

软件架构

此仓库

仓库 仓库文件夹
wing.py(主文件) blog_exhibition(默认主题文件)
blog_exhibition:config(内容配置文件)、theme(主题模板文件以及激活文件)
readme(readme所需的文件)
con.py(json读取文件)
theme(主题选择文件)
LICENSE(开源协议)
README(本自述文件)

主题仓库

外部 内部 再内部
主题1 json配置文件
theme文件
主题2 以此类推
样式文件 主题1 index文件
web文件夹(其他web文件)

效果

实际使用效果:

欢迎前往首批测试点(Leo韩)查看公测用户用wing生成的博客

自带config的生成效果:

1、blog_exhibition效果

系统环境

mac、linux和win都可以

手机版可以等一下后面的在线版(有关关键词:github、gitee、在线修改、灵活管理)

安装前的版本说明

因为在仓库里的是dev版本

dev版本不是特别稳定

如果你运气不好,还有可能是没做完的dev版

所以推荐你看正式版本的安装,开发版本的安装是给开发者查看的,谢谢!

安装教程

首先你要保证你的电脑中有python3.5(>=3.5均可)和git(git可选)

如没有可以百度一下属于自己系统的python3和git(git可选)安装方式

作者的python为3.7.3,如果你用你下载的python3运行出现错误,可以试一试使用与作者相同的python3.7.3

正式版本的安装:

  1. 打开发行版,下载最新``正式版本的wing的压缩包,然后解压,右键,git bash here
不想安装git的用户可以打开cmd,cd到这个目录下,继续操作
  1. 输入cd lingkong-wing
  2. 去往主题仓库选择自己喜欢的主题,放入你的lingkong-wing文件夹内,然后编辑theme.json中的主题名为文件夹名
温馨提示:文件夹名不可修改,仓库里是啥名就是啥名
温馨提示:以上这步可以不做,因为wing有一款自带的主题
温馨提示:官方的所有主题都会放在仓库中,如果你要使用官方主题,只需编辑theme.json中的主题名为文件夹名即可
  1. 如果你是windows系统,那在git的bash或cmd中输入pip install markdown,如果你是unix系统(macos、linux等),那在终端中输入pip3 install markdown
温馨提示:这步有可能出错,如果出错请到readme的最下面找到问题反馈与帮助找到提问方法提问

然后你的前期的环境准备工作就完成了

开发版本的安装:

  1. 在要下载的地方右键,git bash here(前提是你有装git)输入并执行:(Unix的系统可以在终端中cd到你想要装的地方执行)
git clone https://gitee.com/lingkonggzs/lingkong-wing.git
不想安装git的用户可以下载zip,解压,然后打开cmd,cd到这个目录下,继续操作
  1. 输入cd lingkong-wing
  2. 去往主题仓库选择自己喜欢的主题,放入你的lingkong-wing文件夹内,然后编辑theme.json中的主题名为文件夹名
温馨提示:文件夹名不可修改,仓库里是啥名就是啥名
温馨提示:以上这步可以不做,因为wing有一款自带的主题
温馨提示:官方的所有主题都会放在仓库中,如果你要使用官方主题,只需编辑theme.json中的主题名为文件夹名即可
  1. 如果你是windows系统,那在git的bash或cmd中输入pip install markdown,如果你是unix系统(macos、linux等),那在终端中输入pip3 install markdown
温馨提示:这步有可能出错,如果出错请到readme的最下面找到问题反馈与帮助找到提问方法提问

然后你的前期的环境准备工作就完成了

默认主题的使用说明

首先你要打开theme.json

把theme这项后面的引号里的blog-XXXX改成你复制过来主题的文件夹名

温馨提示:以上这步可以不做,因为wing有一款自带的主题

然后打开你的主题文件夹,打开文件夹下的config.json配置上你喜欢的东西

配置内容说明:

  1. user:用户称呼
  2. photo:头像地址(本地与网络上的均可)
  3. word-max:最大的文章值
  4. word-1\2\3-id:文章id
  5. word-1\2\3-title:文章标题
  6. word-1\2\3-date:文章发表日期
  7. word-1\2\3-from:文章对应的md文件名
  8. right-name:跳转区名字
  9. right-max:最大的链接数量
  10. right-1\2\3-id:链接id
  11. right-1\2\3-id:链接名字
  12. right-1\2\3-id:链接跳转地址(本地与网络上的均可)

你可以根据以上的描述修改/添加json文件

如何新建文章:

  1. 打开config.json
  2. 复制"1"的那一大个地方,如:
"1":{
    "id": "1",
    "title": "hello",
    "date": "20200418",
    "from": "hello.md"
}

这一大个 3. 在上一个大括号(右)的的后面加一个英文, 4. 把1,改成上一个数字+1,1+1=2,就把1改成2 5. 改标题(title)、发布时间(date)、文章对应的md文件名(from) 6. 最后拼接起来长这样:

"1":{
    "id": "1",
    "title": "hello",
    "date": "20200418",
    "from": "hello.md"
},
"2":{
    "id": "2",
    "title": "第二个标题",
    "date": "时间",
    "from": "XXXXX.md"
}

如何新建友链:

  1. 第一步

  2. 第二步ps:这幅图中python3 wing.py s为旧版操作,新版python3 wing.py即可

ps:win打开命令行的方法是右键,git bash here。(也可以双击打开)unix则要cd到这个目录

温馨提示:新版的文件会生成在web文件夹下,如果要上传成果到github、gitee等平台上,请把这个文件夹下的东西全部上传,否则有可能出错

针对上面这行的补充:如果你看到web文件夹下还有.buyaoshan文件,请你不要删掉他,否则这个文件夹下没东西的话,会生成失败。上传到github、gitee等平台上时,你可选择把这个文件一起上传,也可不上传

其他主题的使用方法可以打开那个主题的文件夹,里面会自带一个readme哦!

其他主题的使用方法可以打开那个主题的文件夹,里面会自带一个readme哦!

其他主题的使用方法可以打开那个主题的文件夹,里面会自带一个readme哦!

ps:官方的其他主题也会放在项目中,但没被设置成默认主题,可以自行去theme.json改上主题文件夹名。官方的其他主题同上所述,也一样是放在那个主题的文件夹中的readme!

以下是几个常用的命令

  1. python3 wing.py:激活配置生效
  2. python3 wing.py z:查看使用指南
  3. python3 wing.py v:查看版本号

错误说明

如果你运行时出现错误

请尝试以下方法:

  1. 确认是否是按照作者的方法一步一步做的
  2. 确认编辑config.json的格式是否错误

如果以上办法无效,请划到最下面问题反馈与帮助查看提问方法

版本号说明

版本号的定义为:主版本号.可使用主题数.主程序更新次数-最后更新时间(这个作者老忘记改,请以提交时间为准)

如:

0.1.34-200425
=
第0个主版本,1个可以使用的主题,主程序已更新34次,最后更新时间为2020年4月25日

在线版预告

手机用户可以等一等未来会开发的在线版

在线版在一个网页上,支持本地端的所有功能

还支持一键同步github、gitee

敬请期待!!!

前线开发状态

开发协作群开发主题中:跳转仓库

已适配好默认主题

开发者计划

因为依靠官方的力量没法制作那么多的主题,并且按照灵空官方的惯例,这次的wing开发者计划来啦!

开发者计划的两大方面的制作

  1. html

制作一个html的主题,要求原创、美观

html提交到theme的仓库下的result新建文件夹名叫:类型_名字,如blog_exhibition

  1. py

第二个要模仿默认主题的theme.py文件以及config.json文件,制作一款主题

要求:import后就可以生成好,同样生成的结果要原创、美观

温馨提示:读取json文件可以import config,然后通过运行主程序来运行这个主题文件进行测试

做好之后提交到提交到theme的仓库下新建一个文件夹名叫:类型_名字,如blog_exhibition

以上两大方面,第一个方面只要求制作html,较为简单,但是官方的适配时间要很久。第二个方面是制作一个完整主题,直接就可以使用,无bug官方可以立刻上线,与大家见面

欢迎参与开发者计划!!!

提交方法

  1. Fork theme这个仓库仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

问题反馈与帮助

方法一:提issues(荐)

打开这个页面,然后点击新建issues,接着按照模板填好issues内容,最后点创建就好

方法二:联系作者

  • 作者钉钉:15392006285(加好友请说明来历)

  • 作者qq:2822603942(加好友请说明来历)

推荐第一种方法,第二种方法作者的同意速度没那么快,不太推荐

About

A python3-based one-click website building system

Resources

License

Stars

Watchers

Forks

Languages