v0.1.0

Author: feijianwu

.gitignore

@@ -0,0 +1,9 @@
+.idea
+.DS_Store
+tests/.swallow
+build
+dist
+.eggs
+*.app
+*.dist
+*.build

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+    "configurations": [
+        {
+            "name": "Python: File",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "justMyCode": true
+        }
+    ]
+}

.workflow/branch-pipeline.yml

@@ -0,0 +1,52 @@
+version: '1.0'
+name: branch-pipeline
+displayName: BranchPipeline
+stages:
+  - stage: 
+    name: compile
+    displayName: 编译
+    steps:
+      - step: build@python
+        name: build_python
+        displayName: Python 构建
+        pythonVersion: '3.9'
+        # 非必填字段，开启后表示将构建产物暂存，但不会上传到制品库中，7天后自动清除
+        artifacts:
+            # 构建产物名字，作为产物的唯一标识可向下传递，支持自定义，默认为BUILD_ARTIFACT。在下游可以通过${BUILD_ARTIFACT}方式引用来获取构建物地址
+          - name: BUILD_ARTIFACT
+            # 构建产物获取路径，是指代码编译完毕之后构建物的所在路径
+            path:
+              - ./
+        commands:
+          - python3 -m pip install --upgrade pip
+          - pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+          - pip3 install -r requirements.txt
+          - python3 ./main.py
+      - step: publish@general_artifacts
+        name: publish_general_artifacts
+        displayName: 上传制品
+        # 上游构建任务定义的产物名，默认BUILD_ARTIFACT
+        dependArtifact: BUILD_ARTIFACT
+        # 上传到制品库时的制品命名，默认output
+        artifactName: output
+        dependsOn: build_python
+  - stage: 
+    name: release
+    displayName: 发布
+    steps:
+      - step: publish@release_artifacts
+        name: publish_release_artifacts
+        displayName: '发布'
+        # 上游上传制品任务的产出
+        dependArtifact: output
+        # 发布制品版本号
+        version: '1.0.0.0'
+        # 是否开启版本号自增，默认开启
+        autoIncrement: true
+triggers:
+  push:
+    branches:
+      exclude:
+        - master
+      include:
+        - .*

.workflow/master-pipeline.yml

@@ -0,0 +1,50 @@
+version: '1.0'
+name: master-pipeline
+displayName: MasterPipeline
+stages:
+  - stage: 
+    name: compile
+    displayName: 编译
+    steps:
+      - step: build@python
+        name: build_python
+        displayName: Python 构建
+        pythonVersion: '3.9'
+        # 非必填字段，开启后表示将构建产物暂存，但不会上传到制品库中，7天后自动清除
+        artifacts:
+            # 构建产物名字，作为产物的唯一标识可向下传递，支持自定义，默认为BUILD_ARTIFACT。在下游可以通过${BUILD_ARTIFACT}方式引用来获取构建物地址
+          - name: BUILD_ARTIFACT
+            # 构建产物获取路径，是指代码编译完毕之后构建物的所在路径
+            path:
+              - ./
+        commands:
+          - python3 -m pip install --upgrade pip
+          - pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+          - pip3 install -r requirements.txt
+          - python3 ./main.py
+      - step: publish@general_artifacts
+        name: publish_general_artifacts
+        displayName: 上传制品
+        # 上游构建任务定义的产物名，默认BUILD_ARTIFACT
+        dependArtifact: BUILD_ARTIFACT
+        # 上传到制品库时的制品命名，默认output
+        artifactName: output
+        dependsOn: build_python
+  - stage: 
+    name: release
+    displayName: 发布
+    steps:
+      - step: publish@release_artifacts
+        name: publish_release_artifacts
+        displayName: '发布'
+        # 上游上传制品任务的产出
+        dependArtifact: output
+        # 发布制品版本号
+        version: '1.0.0.0'
+        # 是否开启版本号自增，默认开启
+        autoIncrement: true
+triggers:
+  push:
+    branches:
+      include:
+        - master

.workflow/pr-pipeline.yml

@@ -0,0 +1,37 @@
+version: '1.0'
+name: pr-pipeline
+displayName: PRPipeline
+stages:
+  - stage: 
+    name: compile
+    displayName: 编译
+    steps:
+      - step: build@python
+        name: build_python
+        displayName: Python 构建
+        pythonVersion: '3.9'
+        # 非必填字段，开启后表示将构建产物暂存，但不会上传到制品库中，7天后自动清除
+        artifacts:
+            # 构建产物名字，作为产物的唯一标识可向下传递，支持自定义，默认为BUILD_ARTIFACT。在下游可以通过${BUILD_ARTIFACT}方式引用来获取构建物地址
+          - name: BUILD_ARTIFACT
+            # 构建产物获取路径，是指代码编译完毕之后构建物的所在路径
+            path:
+              - ./
+        commands:
+          - python3 -m pip install --upgrade pip
+          - pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+          - pip3 install -r requirements.txt
+          - python3 ./main.py
+      - step: publish@general_artifacts
+        name: publish_general_artifacts
+        displayName: 上传制品
+        # 上游构建任务定义的产物名，默认BUILD_ARTIFACT
+        dependArtifact: BUILD_ARTIFACT
+        # 上传到制品库时的制品命名，默认output
+        artifactName: output
+        dependsOn: build_python
+triggers:
+  pr:
+    branches:
+      include:
+        - master

README.md

@@ -0,0 +1,49 @@
+# Swallow
+
+> All those moments will be lost in time, like tears in rain.
+
+Swallow 是一个简单的静态博客写作客户端。Swallow 的宗旨就是`简单`。即使是一个"小白"用户也可以使用 Swallow 搭建自己的博客系统。使用 Swallow。你不需要懂`HTML`、`CSS`、`Javascript`、`网络`
+、`命令行`、`配置文件`等等编程和网络相关的知识。
+
+你只需要会使用软件。然后学一点 [Markdown](https://markdown.com.cn/)（一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档）语法。就可以开始创建自己的个人博客网站了。
+
+**开启你的博客之旅吧**
+
+## 特性
+
+- 使用 Markdown 创作你的博客
+- 可以对文章分组和添加标签
+- 支持 Windows 和 MacOS 客户端
+- 可以本地预览博客站点
+- 支持多种远程部署方式
+  1. [COS（腾讯云对象存储服务）](./doc/cos_deploy.md)
+  2. [Github Page](./doc/github_deploy.md)
+  3. [Gitee Page](./doc/gitee_deploy.md)
+- 支持 Hugo 主题，其中内置主题开箱即用
+- 本地存储文章源文件
+
+## 界面
+
+![软件界面](./doc/imgs/article.png)
+
+![side](./doc/imgs/editor.png)
+
+![home](./doc/imgs/site_conf.png)
+
+![home](./doc/imgs/remote_conf.png)
+
+![home](./doc/imgs/preview.png)
+
+## 开发
+
+> 欢迎各位参与一起开发
+
+### 使用的技术
+
+- [PySide6](https://doc.qt.io/qtforpython/)，qt for python，基于 Python 使用 Qt 开发界面
+- [Hugo](https://gohugo.io/)，静态博客生成引擎
+- [Nuitka](https://nuitka.net/pages/donations.html)，python 打包工具，将 python 程序打包成 Windows、MacOS 和 Linux 可执行程序
+
+### 详细文档
+
+可以参考作者相关的博客。

build.py

@@ -0,0 +1,30 @@
+import os
+import sys
+from pathlib import Path
+
+import nuitka
+
+pkg_path = Path(nuitka.__file__).parent.parent
+
+if sys.platform == "darwin":
+    try:
+        cmd = f'''
+        python -m nuitka --follow-imports --enable-plugin=pyside6 --standalone --macos-create-app-bundle \
+            --macos-app-icon=logo.png \
+            --nofollow-import-to=objc \
+            --nofollow-import-to=numpy \
+            --include-data-dir=lib=lib \
+            --include-package=markdown.extensions \
+            --include-package=pygments.lexers \
+            --include-module=pygments.formatters.html \
+            --include-module=pygments.styles.default \
+            --include-data-dir={pkg_path}/objc=objc \
+            --include-data-dir={pkg_path}/PyObjCTools=PyObjCTools \
+            --include-module=plistlib \
+            --include-package=pkg_resources \
+            main.py
+        '''
+        os.system(cmd)
+        print(cmd)
+    except Exception as e:
+        print(e)

doc/cos_deploy.md

@@ -0,0 +1,23 @@
+baseURL = "http://local:1313/"
+languageCode = "zh-cn"
+defaultContentLanguage = "zh"
+title = "swallow"
+description = "this is my first blogs"
+theme = "mini"
+copyright = ""
+buildFuture = true
+
+[author]
+name = "swallow"
+
+[menu]
+main = [
+    { identifier = "home", name = "Home", url = "/", weight = 1 },
+    { identifier = "articles", name = "Articles", url = "/post", weight = 2 },
+    { identifier = "categories", name = "Categories", url = "/categories", weight = 3 },
+    { identifier = "tags", name = "Tags", url = "/tags", weight = 4 },
+    { identifier = "about", name = "About", url = "/about", weight = 5 },
+]
+
+[params]
+hiddenPostSummaryInHomePage = true