建站手记
未读Hexo 是一个基于 Node.js 的静态博客框架，它允许用户通过 Markdown 文件快速生成静态网页。
Hexo 目录结构Hexo 的目录结构清晰，便于管理和扩展。以下是 Hexo 项目的基本目录结构：
1234567891011121314151617181920212223.├── .deploy_git├── node_modules├── public├── scaffolds| ├── post.md| ├── page.md| └── draft.md├── source| ├── _drafts| └── _posts├── themes| └── theme-name| ├── _config.yml| ├── languages| ├── layout| ├── scripts| └── source├── _config.yml├── _config.theme-name.yml├── package.json├── yarn.lock└── package-lock.jso ...
一、介绍Qexo是一个美观、强大的在线 静态博客 管理器
官方文档
GitHub
二、部署步骤2.1、Vercel部署2.1.1、创建Vercel项目点击 Vercel一键部署，使用GitHub账号登录，如果GitHub账号不可用就用Google邮箱或其他国外邮箱重新创建一个。
输入仓库名称，点击创建，也可将仓库Fork下来，创建项目时选择Fork的仓库
点击Deploy进行部署
首次部署会报错, 因为还未进行数据库和环境变量配置，无视并进行接下来的步骤
2.1.2、创建数据库1、 Vercel Storage进入Vercel Storage 界面 然后点击右上角的 Create Database 。
选择 Postgres 创建免费 PostgreSQL 数据库
在 Connect 页面获取数据库连接信息。请注意在地区选择的位置选择与你上一步项目对应的地区（通常为 Washington, D.C., USA (East) - iad1）。
绑定项目
在左侧边栏选择 Projects 点击 Connect Project 连接到你第一步创建的项目，然后重新部署即可
...
备查宝典
未读npm link 是一个非常有用的命令，用于在开发过程中将本地 npm 包链接到全局 npm 目录，从而可以在其他项目中使用这个本地包，而不需要发布到 npm 仓库。这对于本地开发和测试非常有帮助。
npm link 的基本用法和步骤
在本地包目录中创建链接：
首先，进入你要链接的本地包的目录，然后运行以下命令：
1npm link
这个命令会在全局 npm 目录中创建一个符号链接，指向你当前的本地包。
在项目中使用链接的包：接下来，进入你希望使用这个本地包的项目目录，然后运行以下命令：
1npm link <package-name>
其中 <package-name> 是你本地包的名称（通常在 package.json 文件中的 name 字段定义）。
这个命令会在项目的 node_modules 目录中创建一个符号链接，指向全局 npm 目录中的本地包。
取消链接：如果你需要取消链接，可以按照以下步骤操作：
在项目目录中运行以下命令，取消项目中的链接：
1npm unlink <package-name>
在本地包目录中运行以下命令 ...
这个错误代码通常时由于权限不足所导致，例如执行npm link
详细报文如下：
123456789101112131415161718192021222324npm ERR! code EPERMnpm ERR! syscall symlinknpm ERR! path D:\hexo\plugins\hexo-footer-pluginnpm ERR! dest D:\Environment\nodejs\node_global\node_modules\hexo-footer-pluginnpm ERR! errno -4048npm ERR! Error: EPERM: operation not permitted, symlink 'D:\hexo\plugins\hexo-footer-plugin' -> 'D:\Environment\nodejs\node_global\node_modules\hexo-footer-plugin'npm ERR! [Error: EPERM: operation not permi ...
Hexo的插件嵌入有两种方式，一种是通过脚本（Scripts）的方式引入，一种是通过插件（Packages）的方式将自定义的插件内容发布到npm上。本文主要介绍第二种，如果您的代码很简单，建议您编写脚本，您只需要把 JavaScript 文件放到主题目录的 scripts 文件夹，在启动时就会自动加载。具体操作可参考 Hexo 博客每天自动生成每日早报文章 中2.2相关介绍。
下面是引用官方的一段话，开发Hexo插件至少要包含 2 个文件：一个是主程序index.js，另一个是 package.json，描述插件的用途和所依赖的插件。package.json 中至少要包含 name, version, main 属性。
链接直达：https://hexo.io/zh-cn/docs/plugins
如果您的代码较复杂，或是您想要发布到 NPM 上，建议您编写插件。首先，在 node_modules 文件夹中建立文件夹，文件夹名称开头必须为 hexo-，如此一来 Hexo 才会在启动时加载；否则 Hexo 将会忽略它。
文件夹内至少要包含 2 个文件：一个是主程序，另一个是 pack ...
1、使用浏览器开发者工具一、使用浏览器开发者工具1.1、 Chrome截图在浏览器网页中按下F12，进入开发者工具。
输入Ctrl+Shift+P进入命令，中文界面输入截图二字，选择截取完整尺寸屏幕截图，英文界面输入Capture full size screenshot，回车（Enter）后，自动自动截取长图
1.2、Edge截图在Edge浏览器页面中，输入Ctrl+Shift+S => 捕获Web区域/捕获整页。
捕获Web区域：可自定义选择截图区域，滚动鼠标滑轮下拉，可长截图
捕获整页：直接截图完Web整个页面。效果非常哇塞
小贴士
对于一些懒加载的页面，可以先滑动到底部加载完所有数据后再截取屏幕
二、使用浏览器插件2.1、截屏长图Master
概述使用Screen Master，这款终极浏览器扩展，轻松获取无可挑剔的全页截图。
这款免费、易用的工具将重新定义你的截图体验，确保每个细节都以像素级完美的精度被捕捉。
这是它的工作原理：
在你的工具栏中找到Screen Master图标（找找拼图图标）并将其固定以便于访问。
打开所需的网页。
点击工具栏按钮。 - ...
一、介绍之前一直想做的功能，今天终于有机会来实现一下，正如描述那样，计划任务每天生成一篇文章用于展示每日新闻
具体效果如下
详情页如下所示
二、实现2.1、 仅固定单页面访问需要使用到 ALAPI 的 每日60秒早报 接口，可免费调用
注册登录后在 个人管理 => 个人中心 => 获取token
如果只想生成一个固定的静态页面访问，可以直接使用以下代码，替换自己的token即可
12345678910111213141516<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale= ...
一、创建Acme账户网站 => 证书 => Acme账户 => 创建账户，邮箱随便填，其他保持默认
二、申请证书网站 => 证书 => 申请证书 ，选择刚才创建的Acme账户验证方式选择Http，勾选自动续期
日志输出证书成功！！代表申请成功
三、站点启用HTTPS选择刚才申请的证书启用HTTPS即可
一、场景描述之前给网站配置反向代理一直用的Nginx Proxy Manager，后来用惯了1Panel建站后会存在一个问题，1Panel使用的反代工具是 OpenResty，需要绑定的端口都是 80 和 443 端口 和 Nginx Proxy Manager 端口冲突，即便通过1Panel直接安装Nginx Proxy Manager绑定的默认端口是80080和80443，但Nginx Proxy Manager如果不绑定80和443端口会导致404问题，所以最好的办法就是直接使用 OpenResty 配置反代。
相关问题可参考官方论坛救助帖
关于npm使用30081、30080.30443端口无法启用反代的问题
nginx-proxy-manager和openresty共存问题
1panel有没有类似NPM的模块
二、操作步骤在域名服务商添加需要解析的记录，例如我在阿里云域名管理后台添加一条 easyweb.shiguangdev.cn 的域名
在 1Panel 创建站点 网站 => 创建网站 => 反向代理
代理地址即 ip + 端口
在面板设置配置服务器地 ...
本文介绍如何在博客添加GitHub贡献日历(github calendar)，中间踩了一些坑，特写此篇，以作记录，效果如下
2026-06-16 最新配置（推荐）原上游项目 Barry-Flynn/python_github_calendar_api 和前端插件 @barry-flynn/hexo-github-calendar 已存在兼容性问题（Python 依赖过旧导致 Vercel 部署 500、GitHub 前端改版导致爬虫失效、Retina 屏幕下月份标签和鼠标悬浮提示错位）。以下是我基于上游 Fork 后的修复版本，项目演化链路为：Zfour/hexo-github-calendar → Barry-Flynn → 我的 Fork。
后端 API我已在 Vercel 部署了修复后的 API，自定义域名为：
1https://github-calendar.shiguang666.eu.org/api
如果你也想自建，Fork Shiguang-coding/python_github_calendar_api 到自己的 GitHub，然后在 Ver ...
