项目：painting 主题

 - 项目初始版本
 - 项目默认主题 painting

.github/workflows/build-and-run.yml

@@ -0,0 +1,44 @@
+name: Build and Run
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-run:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 1. Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 2. Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: 3. Install
+        run: |
+          pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: 4. Run
+        run: |
+          python ./main.py &
+          sleep 7
+
+      - name: 5. Build
+        run: |
+          wget http://localhost:7777
+
+      - name: 6. Log
+        run: |
+          cat endofyear.log
+
+      - name: 7. Push static HTML
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./static
+          publish_branch: html

.github/workflows/docker-publish.yml

@@ -0,0 +1,24 @@
+name: Publish Docker image
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: Build and push Docker image
+        run: |
+          docker build -t sevenwate/endofyear:latest .
+          docker push sevenwate/endofyear:latest

.gitignore

@@ -0,0 +1,4 @@
+/.idea
+*.log
+/Pipfile
+/Pipfile.lock

Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.11.0
+
+WORKDIR /app
+
+ADD . /app
+
+RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple && pip install -r requirements.txt
+
+EXPOSE 7777
+
+CMD [ "python", "./main.py" ]

README.md

@@ -0,0 +1,122 @@
+# EndOfYear
+
+EndOfYear 点燃个人博客的年度辉煌！
+
+![EndOfYear](static/endofyear.jpg)
+
+## 流程
+
+EndOfYear 通过 RSS 获取博客文章数据，对文章数据进行统计、分析和整理，最终输出为 HTML，客观地反映了博客一年的写作情况。
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant Flask
+    participant Config
+    participant Generator
+    participant Scraper
+    participant Analyzer
+
+    User ->> Flask: Access service
+    Flask ->> Config: Check cache
+    activate Config
+    alt Cache exists
+        Config -->> Flask: Return cached data
+    else Cache does not exist
+        Config ->> Generator: Run data generator
+        activate Generator
+        Generator ->> Scraper: Run data scraping
+        activate Scraper
+        Scraper -->> Generator: Return scraped data
+        deactivate Scraper
+        Generator ->> Analyzer: Run data analysis
+        activate Analyzer
+        Analyzer -->> Generator: Return analyzed data
+        deactivate Analyzer
+        Generator -->> Config: Return organized data
+        deactivate Generator
+        Config -->> Flask: Return data
+    end
+    Flask -->> User: Return HTML page
+    deactivate Config
+```
+
+1. 用户访问 Flask 服务。
+2. Flask 检查缓存是否存在。
+    - 如果缓存存在，Flask直接返回缓存数据。
+    - 如果缓存不存在，继续下一步。
+3. Config 模块运行数据生成器（Generator）。
+4. Generator 模块运行数据抓取器（Scraper）来获取RSS数据。
+5. Scraper 将抓取的数据返回给 Generator。
+6. Generator 运行数据分析器（Analyzer）对数据进行分析。
+7. Analyzer 将分析后的数据返回给 Generator。
+8. Generator 整理结构化数据后将其返回给 Flask,Config 模块。
+9. Flask 使用整理后的数据渲染 HTML 页面。
+10. Flask 返回渲染后的 HTML 页面给用户。
+
+## 用法
+
+### Github
+
+1.  Fork 项目到个人仓库
+2. 手动配置仓库的 Workflow permissions 设置为 **Read and write permissions**，否则无法写入 html 分支。
+    1. 导航到 **Settings**（设置）选项卡。
+    2. 在左侧导航栏中，点击 **Actions**（操作）。
+    3. 在 **General**（常规）页面下滑，找到 **Workflow permissions**（工作流权限）。
+    4. 在 **Workflow permissions** 中，选择 **Read and write permissions**（读写权限）。
+    5. 最后点击 **Save**（保存）。
+3. 在仓库首页打开目录下的 `config.ini` 配置文件，点击右上角工具栏的 **🖋️（钢笔）** 图标，在线编辑文件。
+    - `web`：配置为 `false`。
+    - `rss`：配置为 RSS 地址。
+
+```ini
+[default]
+web = false
+
+[blog]
+rss = https://blog.7wate.com/rss.xml
+data =
+```
+
+4. 点击右上角的 **Commit changes** 提交到 `main` 分支，会自动运行 Action。
+5. 等待 Action 运行成功，将会部署静态网站文件至 `html` 分支。
+
+6. 开启仓库的 Pages 功能，默认为根目录。
+7. 访问个人网址，就可以看到啦~
+
+### Docker
+
+1. 拉取最新镜像
+
+```shell
+docker pull sevewate/endofyear:latest
+```
+
+2. 指定 `rss_url` 环境变量，运行 Docker。请将 `https://blog.7wate.com/rss.xml` 替换为自己的 RSS 地址。
+
+```shell
+docker run -p 7777:7777 --env rss=https://blog.7wate.com/rss.xml sevewate/endofyear:latest
+```
+
+3. 访问网址 `localhost:7777`
+
+## 路线图
+
+EndOfYear 目前处于初始阶段，如果您有兴趣，可以为其做出贡献。计划路线如下：
+
+###  V1
+
+- [ ] 对博客系统的数据源进行全面、规模性的测试。
+- [ ] 进一步细化数据分析维度和数据颗粒度，精准描绘用户画像。
+- [ ] 渲染数据的规范，约束主题开发，提高主题的兼容性。
+
+###  V2
+
+- [ ] 丰富和完善主题。
+- [ ] 实现轻量化的运行部署，一键运行。
+- [ ] 探索以插件的方式附加到博客系统的方法。
+
+
+## 协议
+
+EndOfYear 采用 GPL 3.0 协议。

config.ini

@@ -0,0 +1,6 @@
+[default]
+web = true
+
+[blog]
+rss =
+data =