feat: 实现功能

Author: Light

.gitignore

@@ -0,0 +1 @@
+/build

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Light
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,84 @@
+<p align="center">
+  <img src="img/[email protected]" />
+</p>
+
+<h1 align="center">WebStack 网址导航 Typecho 主题</h1>
+
+<p align="center">
+  <a href="https://github.com/LightAPIs/WebStackTypechoTheme/releases/latest">
+    <img src="https://img.shields.io/github/v/release/LightAPIs/WebStackTypechoTheme.svg?color=orange" alt="Release" />
+  </a>
+  <a href="./LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License" />
+  </a>
+</p>
+
+> Typecho 网址导航主题
+
+## 简介
+
+这是一个基于开源项目[WebStack](https://github.com/WebStackPage/WebStackPage.github.io)和[WebStack_钻芒二开版](https://github.com/wclk/WebStack_ZMKI)而制作的 Typecho 网址导航主题。
+
+该项目主要是为了构建一个更适合~~我~~个人使用的网址导航站点，一切从简，以简约实用为原则做个简单纯粹的网址导航。
+
+因此对比一些其他的网址导航程序，本导航程序可能也更适合搭建在像 NAS 这样的私人服务器上面去使用。
+
+## 预览
+
+### 主页预览
+
+- ![index_day](img/index_day.jpg)
+- ![index_dark](img/index_dark.jpg)
+
+### 主题设置预览
+
+- ![config](img/config.jpg)
+
+## 安装
+
+1. 前往 [Typecho](https://typecho.org/download) 下载 Typecho 博客程序，参照安装环境要求及[安装文档](http://docs.typecho.org/install)，根据安装过程中的安装向导依次完成安装即可。
+2. 前往 [Releases](https://github.com/LightAPIs/WebStackTypechoTheme/releases/latest) 下载主题文件压缩包，解压得到 `WebStack` 目录，将其上传至服务器 Typecho 主题目录 `/usr/themes/`。
+3. 在浏览器里打开 Typecho 后台页面(默认：`/admin/index.php`)，点击"更换外观"进入外观设置页面，找到 WebStack Typecho Theme 主题并点击启用即可。此时回到博客首页便能看到导航主题效果了。
+
+## 使用
+
+### 添加分类
+
+在后台的分类管理页面(默认：`/admin/manage-categories.php`)中可以添加或编辑分类，其对应导航页中左侧边栏里的菜单项，一般可以按照网址的类别来进行分类。
+
+### 添加项目
+
+在后台的文章管理页面(默认：`/admin/manage-posts.php`)中可以添加或编辑具体的网址导航项目。
+
+![add](img/add.jpg)
+
+其中可以填写的项目包括：
+
+- 标题：即导航的标题
+- 跳转链接：即导航到的网址
+- 链接描述：可以补充一些关于该导航的信息描述
+- 链接 Logo：即导航显示的图标地址，也可以自行在附件中上传图标并将地址填入
+- 分类：选择导航网址的分类，不勾选则为默认分类
+- *排序：同分类下的导航项目默认按照创建时间进行排序，可以通过填写此值使该导航项目排序更靠前*(**注：该功能需要另外安装 [EnablePostsOrder](https://github.com/LightAPIs/EnablePostsOrder) 插件才能实现**)
+
+### 主题设置
+
+在后台的外观设置页面(默认：`/admin/options-theme.php`)中可以调整设置关于本主题的其他功能。
+
+## 插件
+
+一些提供功能增强的 Typecho 插件：
+
+- [LightAPIs/EnablePostsOrder](https://github.com/LightAPIs/EnablePostsOrder)：用于支持排序导航项目，推荐安装使用
+- [LightAPIs/EncryptYourSite](https://github.com/LightAPIs/EncryptYourSite)：用于加密导航站点，若导航为私人使用且不想每个知道导航域名的都能看到站点内容，则可以安装使用该插件
+
+## 相关项目
+
+本项目的诞生离不开以下这些优秀的项目：
+
+- [wclk/WebStack_ZMKI](https://github.com/wclk/WebStack_ZMKI)
+- [WebStackPage/WebStackPage.github.io](https://github.com/WebStackPage/WebStackPage.github.io)
+
+## License
+
+[MIT](./LICENSE) license

build.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+import os
+import tarfile
+import zipfile
+import argparse
+import json
+
+
+def make_zipfile(output_filename, source_dir, package_dir_name):
+    with zipfile.ZipFile(output_filename, mode="w", compression=zipfile.ZIP_DEFLATED) as zf:
+        for root, dirs, files in os.walk(source_dir):
+            zf.write(root, os.path.join(package_dir_name, os.path.relpath(root, source_dir)))
+            for file in files:
+                filename = os.path.join(root, file)
+                if os.path.isfile(filename):
+                    arcname = os.path.join(package_dir_name, os.path.relpath(filename, source_dir))
+                    zf.write(filename, arcname)
+
+
+if __name__ == "__main__":
+    ap = argparse.ArgumentParser(description="打包项目")
+    ap.add_argument("-s", "--src", required=False, help="自定义项目源文件所在目录")
+    ap.add_argument("-i", "--info", required=False, help="自定义项目信息文件路径")
+
+    args = vars(ap.parse_args())
+    build_dir = "build"
+    print("************************************************")
+    src_path = os.path.join(os.getcwd(), "src")
+    if args["src"] and os.path.exists(args["src"]):
+        src_path = args["src"]
+    print("INFO:: 源文件路径: " + src_path)
+    work_path = os.path.abspath(os.path.dirname(src_path))
+    print("INFO:: 工作路径: " + work_path)
+
+    build_path = os.path.join(work_path, build_dir)
+    if not os.path.exists(build_path):
+        os.makedirs(build_path)
+
+    info_file = os.path.join(work_path, "info.json")
+    if args["info"]:
+        info_file = args["info"]
+    if not os.path.exists(info_file):
+        print("ERROR:: 没有找到需要打包的信息文件！")
+        exit()
+
+    info = {"name": "unknow", "version": "0.1", "package": "src"}
+    with open(info_file, encoding="utf-8") as load_f:
+        info = json.load(load_f)
+
+    build_filename = info["name"] + "_v" + info["version"]
+    print("INFO:: 打包文件名称: " + info["name"])
+    print("INFO:: 打包文件版本: " + info["version"])
+    print("INFO:: 压缩包根目录: " + info["package"])
+
+    build_tar_file = os.path.join(build_path, build_filename + ".tar.gz")
+    if os.path.exists(build_tar_file):
+        os.remove(build_tar_file)
+    with tarfile.open(build_tar_file, mode="w:gz") as tar:
+        tar.add(src_path, arcname=info["package"])
+        print("INFO:: 打包 tar: " + src_path)
+        tar.close()
+    print("INFO:: 已经生成打包文件至: " + build_tar_file)
+
+    build_zip_file = os.path.join(build_path, build_filename + ".zip")
+    if os.path.exists(build_zip_file):
+        os.remove(build_zip_file)
+    make_zipfile(build_zip_file, src_path, info["package"])
+    print("INFO:: 已经生成打包文件至: " + build_zip_file)
+
+    print("SUCCESS:: 打包操作已经完成。")
+    print("************************************************")