事情的起因是为了部署 Rsshub 服务为自己的 folo 提供小红书的全文解析，而 folo 是不支持本地/ipv6 的 rsshub ，因此需要将对应设置好小红书 cookie 的 rsshub 服务部署到 ipv4 的公网环境之下，权衡之下采取了该方式进行。

以下简单介绍一下自己的尝试过程：

• 首先尝试利用 vercel 部署：由于部署 rsshub 到 vercel 的方式目前还没修复，如果使用 legacy 分支部署 ，也无法支持小红书的全文获取的需求，对应的环境变量可以直接在 github rsshub 仓库的根目录直接添加 .env 文件即可。
• 其余的部署方式部分是需要收费的，或者说注册起来比较麻烦就没有再去尝试；

本地尝试全文获取主要感谢以下作者的探索和分享，这里不再重复分享，通过添加 Cookie 的方式获取了小红书的 全文 Rss 源：

• 顾佳凯的网络日志 | 小红书RSS的解决方案

但是由于小红书反扒严重，因此使用该方案还是要小心被封或者稳定性等问题，故而暂时没有将该 rsshub 源公开出来。

rsshub 的其余部署细节和配置可以参考：RSSHub 官网的文档，这里不在赘述，

转换 ipv6 服务到 ipv4 环境

我们也知道获取公网的 ipv6 地址是比较容易的，通常普通家庭或者宽带都不会有公网的 ipv4 ，在此情况下 ipv6 的访问支持也并没有十分普及，在一些公共网络环境或者一些公司网络中，很多部署在 ipv6 环境下的网页实际上是没法被访问到的，而通过流量访问，还是有其局限性（流量收费限制）；

因此这里就尝试通过免费的 CloudFlare 的 CDN 服务来将 ipv6 服务代理到 ipv4 环境中，以下是一些相关的资料：

• Cloudflare让IPV6不在鸡肋 | 天增的博客
• 利用cloudflare让ipv4与ipv6互通_NAS存储_什么值得买
• 使用Cloudflare代理为纯IPv6站点添加IPv4访问 - 哔哩哔哩

转换腾讯云解析到 Cloudflare

使用 CF 的 CDN 的方式的先决条件是已经有了自己的域名，同时已经通过/可以通过公网 ipv6 发布自己的服务

Cloudflare 官网： https://dash.cloudflare.com/

主要参考开启 Cloudflare CDN 代理，实现 IPv4 to IPv6 转换_ipv4转发ipv6-CSDN博客 一文，在已经基于 ipv6 部署了服务的情况下，参考该博主的文章将域名的 DNS 解析服务转换到 CF 即可，但是后续可能会遇到访问服务的时候反复重定向的问题，这里可以参考[TroubleShooting]( ### CloudFlare 网站【重定向次数过多】) 部分的解决方案；

P.S. 备注

• 后续还是可以在腾讯云的控制台对子域名申请免费证书，对应的解析在 CF 中进行即可，
• 后续对应子域名的添加可以借助 DDNS-GO 直接更新到 CF 中即可
• CF 对于服务的端口是有要求的，笔者本地是通过 Nginx 进行反向代理各项服务的，因此只需要处理好域名的对应关系即可。
• 通过这种方式，可以使用一个备用域名来将自己的一些服务部署到 ipv4 上。

Troubleshooting 一些问题解决

为 CloudFlare 配置 DDNS-Go 动态更新 ipv6 地址

这里 DDNS-Go 的配置没有什么特别的，主要就是要获取 CloudFlare 的密钥，填入对应的配置中即可，具体的密钥获取位置如下：

首先进入 Profile 页面：

选择 API Tokens 中创建一个新的 Token

选择 Edit zone DNS 模板后设置自己要操作的域名如下，最后点击确定即可获取需要的 Token

DDNS-Go 的话只需要新增一个 Cloudflare 的配置，填入对应的 token 后，在 Ipv6 的部分添加你要跟踪的子域名即可，如果域名不存在 Cloudflare 中，其会自动完成对应记录的添加：

Ref: 3、使用DDNS-GO配置DDNS，通过cloudflare api修改指定域名对应的动态ip - 知乎

CloudFlare 网站【重定向次数过多】

通常都是由于 SSL/TLS 的设置冲突导致的，这里只需要去 CloudFlare 管理面板的 SSL/TLS 菜单中将安全策略改为 Full（Strict）即可解决。

具体操作如下图：

ref：使用 CloudFlare 导致网站「重定向的次数过多」解决方案_wordpess 使用 cloudfare 重定向次数-CSDN博客

Fi

本篇中所有专业人士、做市商、大型操盘手、专业投资者都简单的称之为局内人/庄家，他们就是试图赚取股票的批发和零售差价的商人。于股票市场而言是专业人士、局内人和做市商，对于期货市场则是大型操盘手，而外汇现货市场仍是做市商。

Todo

需要对各个阶段的具体表现做一下梳理，各个阶段我们到底希望能在 k 线图中看到什么形态。

量价分析的全局流程

---
title: 量价分析的三个步骤
---
flowchart LR
A[细致分析单 K 线] --> B[分析最新的几根 k 线] -->C[分析全局趋势]
  

前文中已经介绍了量价分析中的前两步，从最新的几条 k 线中获取异常或者反转信号，但还需要从全局趋势中获取当前信号发生所处的点位，从而对信号发生的实际和幅度有所估计，这也是本章要讨论的：量价分析中的全局视角。

要理解专业交易者的做法，投资者应该学会从一个试图以零售价格卖出手中股票存货的商人的角度进行思考，在他们清空货架上的存货的同时，出于盈利的目的，他们将以批发价格买入更多的商品，这是他们调整市场价格的首要目的。

在进行量价分析中全局视野的学习之前，首先要理解几个基本概念，或者说是商人的几个行动阶段/模式：

---
title: 局内人的行动模式
---
stateDiagram-V2
  direction LR
  state 吸筹阶段{
    需求测试 --> 吸筹
  	吸筹 --> 买入高峰
  }
  state 派筹阶段{
    供给测试 --> 派筹
  	派筹 --> 抛售高峰
  }
  买入高峰 --> 供给测试
  抛售高峰 --> 需求测试
  

吸筹与派筹在所有时间跨度中无休止的循环往复，有大波动也有小波动,通过因果定律对每次吸筹和派筹的规模进行不同的分析。

• 吸筹阶段 ：庄家调整市场试图以批发价买入股票储备的阶段（具体查看吸筹部分的文档）
• 派筹阶段 ：庄家抬高股票价格，以零售价卖出手上的筹码（股票储备）的阶段（具体查看派筹部分的文档）
• 供给测试阶段 ：为了避免从吸筹阶段转向派筹阶段时，推高股价的过程中遭遇阻碍，卖家过多使得推高过程中价格下跌，需要从头开始吸筹，因此通过供给测试来判断市场上的卖家是否已经被消化，再推动市场进入派筹阶段。
• 需求测试阶段 ：和供给测试一体双生，是为了准备从派筹阶段转向吸筹阶段的过程中，降低市场价格的过程中不会受到买压的阻碍，测试市场是否已经准备好走向下跌。

这样的吸/派筹阶段和需求/供给测试过程，就是我们在股市中需要寻找的重要信号，而且需要注意的是，往往在吸筹或者派筹阶段以后会有多次而不是单次的测试，一次比一次的成交量更低，当价格突破了这几次测试造成的震荡区间，就说明下一步行动（或者说我们期待的反转，将要到来了）

在理解抛售高峰和买入高峰的时候，需要注意的是这两个定义并不是针对市场的，而是指的是局内人操作中的买入和抛售高峰。此外在了解这两个概念之前，了解一下附录提到的问题可能对概念的理解有所帮助。

• 抛售和买入高峰 ：在吸筹和派筹最后阶段的操作，用于清空最后的存货，此时的 k 线会呈现长影线、低实体、高成交量的特点。

总结一下这几个阶段可能会出现的一些特点：

• 整个局内人的完整工作流程就如下，但是我们需要更加清楚其如何吸引买家、卖家的入场，以及需要梳理一下各个阶段的特点。

这种周期可以存在于任意时间跨度和任意市场。上述情况可能出现于某一货币对的5分钟图中，可能持续数小时。同样，也可能存在于股票的日线图中，持续数周或数月。可能存在于期货合约的小时图中，这种情况下局内人将是大型操盘手，这一周期可能持续数天至数周。时间尺度并不重要，重要的是威科夫的“因果定律”

基本场景和概念辨析

这里对上述量化分析的全局视角中的一些情况做补充说明。

吸筹和派筹中的目标价值区间是如何确定的

Summary

他们并不是提前计算好目标价值区间的值，而是局内人清楚每次市场震荡时，当前价格所处的位置，即是停滞或是要发生反转。

在任意的价格图表中，都会存在价格震荡区域，在这些区域中可以认为是一些超买或者超卖的时刻，在这种区域，市场要么在寻找阻力位，要么在寻找支撑位，他们共同定义了一道价值屏障，在这里趋势要么延续，要么反转；

局内人正是清楚这些区间所在的位置（是一个原先趋势的短暂停滞，还是一个新的趋势形成了），因此将这些区间作为天然的吸筹和派筹的区间。

以一个派筹阶段为例，我们看抛售高峰中究竟发生了什么：

1. 市场本身上涨多时，随着利好信息的加速，市场进入目标区间，出现超买/卖情况中；
2. 开始行动：正面消息支撑，牛市趋势上升，点位停滞派筹；
3. 初始阶段为自然阶段：由局内人驱动的牛市动能自然而然的带动市场上升，成交量高（于平均值）但是不突出，该阶段局内人仅需满足投资者和投机者的需求卖出即可。
4. 后期的抛售高峰：为局内人主要发力的阶段，市场非常弱势，买方被卖方淹没，这时局内人需要不顾一切的支撑市场（利好消息等），甚至推高价格，并开始大量抛售。（他们的卖盘本身会使得价格下跌，为了市场不向不利的方向运动，做市商的努力最终就会导向那个 k 线图。）

还是一直反复说的，大买盘或者卖盘都会直接对价格造成对自己不利的影响，因此需要隐蔽或者拆分成小笔的去进行，也就是为什么行动会被分散在同一个时期的不同时间点。

附录 1 常见问题

为什么上涨总是比下跌需要更多的时间

从局内人的角度出发，，此外考虑到心理学的以下要素，可以知道太迅猛的涨跌和频繁的波动将会吓跑投资者，这并不是局内人乐意见到的。

• 贪婪与恐惧的不对称性：投资者在盈利时倾向于逐步获利了结（导致上涨缓慢），而在亏损时因恐慌可能集中抛售（加速下跌）。行为金融学中的损失厌恶理论表明，人们对损失的敏感度远高于同等收益，这放大了下跌时的抛售压力。
• 预期形成机制：上涨趋势需要持续的利好信息积累信心，而负面消息可能迅速摧毁市场共识。

因此局内人会通过缓慢的推高市场，然后逐渐加大脚步，使买家逐渐建立起信心，并产生市场具备向上的动量的错觉，由此来吸引买方；并且局内人也希望自己隐蔽自己的意图，一次性大量的成交会造成大量的价格波动，且会吸引注意，因此需要徐徐图之。

整个上涨流程就是通过 FOMO 情绪：上涨趋势开始加快步伐，价格逐级抬升，短暂停滞，小级别反转，吸引买方，同时引诱他人，然后继续上涨，直到接近派筹区域，其中因卖方了结利润所造成的小级别反转而小幅增加，帮助维持派筹行动最后一阶段的持仓水平。这正是市场在经历一系列更高的高点和低点、伴随短暂停滞和小幅回撤、继续上涨的原因。（因为有其余卖方的存在？）

而更好的下跌方式就是制造恐慌，利用厌恶损失的心里来造成大规模的连锁反应迅速下跌。

填满仓库和清空仓库一般需要多久

这个问题的答案就是这些周期存在于任意时间跨度下，从跳动点图，到1分钟图、 15分钟和60分钟图，然后到日线图、周线以及月线图。理解这一点的最好方法就是想想一个俄罗斯套娃：

• 首先，这些周期存在于所有时间跨度，其次，通过观察多个时间跨度下的价格行为，你将可以发现这些是如何形成、呈现以及相互间确认的。一个在1分钟图中已经开始的周期，可能会在5分钟图中慢慢显现，也可能在15分钟图中刚刚发展。

虽然这些阶段在所有的时间周期中都存在，但是从某种意义上讲，短期或长期的图表都能提供微观的、远视的视角以观察已经发生的事件。在分析中，我们需要结合这两者，才能做出投资方面的理性决策。

因此我们需要通过短或者极短的时间跨度下观察市场的微观结构，然后用更长的时间跨度来给予我们更宽广的视角来观察量价关系。再次强调，这些都是相对的，对于一个超短线交易者而言，这可能是5分钟、 15分钟或者60分钟图。而一个波段交易者可能会考虑60分钟、 240分钟和日线图。一个趋势交易者可能会使用4小时、日线以及周线图。

高频交易的策略类型

• 做市：与传统的做市行为一样，这一策略通过为市场双方提供流动性以此赚取差价从而获利。
• 套利：当套利机会出现时交易（例如：指数、交易型开放式指数基金以及美国存托凭证与它们各自基础资产间的错配定价）。
• 结构性策略：这些策略通过寻找从市场或者特定交易者的结构性弱点进而占取先机，包括潜伏套利和塞单交易。
• 方向性策略：这些策略试图抢在价格变动前，或者直接引发价格变动，包括指令占先和趋势引发。

市场操纵是否意味着局内人可以任意操控价格变动

局内人并不能任意操纵价格的变动，这里市场操纵的本质是通过引发投资者的恐惧与贪婪情绪来影响市场价格走势，而不是直接操控价格。局内人（如专业人士和做市商）无法垄断市场，他们只能协同作战并利用所有可用资源（如媒体新闻）来 manipulating 市场情绪，从而推动价格向其预期方向移动。成交量是确认局内人是否参与价格变动的关键指标，高成交量在买入或卖出高峰时会揭示他们的操作行为。

Summary

从交易员从场内到线上的转变为引，引出线上交易缺少对市场情绪的感知，因此需要通过成交量来补齐这一信息；此外以价格行为交易方法PAT Price Action Trade来介绍阅读 K 线的方法，并为后续的 VPA 做铺垫（PAT 方法实际上是 VPA 的一部分，只是没有做成交量的确认）

P.S：

• 美股绿涨红跌默认 A 股红涨吕跌默认，本笔记中暂时适用红涨，后续再做调整。
• 成交量本身没有颜色，颜色是为了区分当日的涨跌，和价值图表的颜色一致。

Todo

• 分析影线和实体的所有不同构成能反应的不同猜测
• 每次遇到不同的 k 线图区间，最好介入自己的分析，来完善整个理论

场内交易到场外交易的失败

场内交易员可以通过场内人的表现，来感受到贪婪、恐惧；以及通过场内交易席位的买卖状况来判断市场的情绪，这也就是所谓的"市场的气味"，场外线上交易缺乏了这种气味（信息）,仅凭借价格行为进行交易也导致很多交易员的转型失败。

不可否认的是：价格行为确实存在一些信息和作用如下：

flowchart LR
A[全球新闻动态]--浓缩-->C[价格行为]
B[交易员和投资者的观点和决策]--浓缩-->C

C--详尽分析-->D[未来市场的运行方向]
  

但是在场内，可以通过观察得到以下的这些额外的信息，其隐藏在表现之下，能够帮助我们在价格行为至上，做出更加准确的决策，而不至于被市场欺骗，同时更加敏锐和有效：

timeline
	title extra info in floor trading
	参与人数: 成交量
	电话竞拍的速度: 活跃度
				: 成交速度的相对大小
	交易的紧张和犹豫: 成交速度的变化
			 : 价格变动的停止
			 : 成交速度减缓
	
  

而这些场内的一些额外信息，在在线交易时，可以通过以下的替代指标来感受市场的供求关系和情绪的发展变化。

• 成交量的相对大小
• 成交活跃度
• 成交速度的相对快慢
• 成交速度的变化（一阶导）

有真实情绪的市场和价格的变动相互印证，就可以避免被拍卖商（或者说是定价商，券商，做市商）的虚假竞拍（抬价）所欺骗，从而使得在合适的价格购入对应的商品。

换句话说，再被操纵的市场中，成交量可以揭示价格变动背后的原因；而在未被操纵的市场中，成交量可以真实的反应市场的情绪和交易指令集。

在 VPA 之前，我们先更深入的研究其中的 PA（T）price action trade

PAT 价格行为交易

价格作为一个领先指标，它本身只能显示过去的事实，通过分析我们预测未来可能发生的情况，也许我们可以通过价格获得正确的预测，但是成交量可以让我们做的更加完整和可靠。

价格最重要的四个组成部分为：开盘价、最高价、最低价、收盘价； PAT 就要求通过这些数值的曲线，去感受情绪，一个典型的例子就是开盘时价格的跳空，开盘时价格突然远超或远低于前日价格，这能使得我们感受市场的强烈情绪。

但不得不提的是，随着全球电子交易系统带来的期货、股指期货的 24 小时交易制度，使得开盘价和收盘价的重要性没有以往那么重要（特指具备股指期货的股票指数等，对单只股票而言，其仍然受大盘和市场情绪的影响，还是很重要的），或者说重要性可以被夜盘的期货市场替代，其在夜盘中的交易能使我们提前感受市场的情绪，因此开盘价的变化就不再使人意外。

flowchart LR

A[现货-股指] --衍生--> B[股指期货]--夜盘交易-->C[情绪变化]
C--开盘点位变化-->A
  

这种 24 小时交易会使得跳空变少或者情绪变化的表达更加含蓄/缺失，因此成交量的信息也愈发重要。

Idea

是否可以利用夜盘的信息来从盘后交易中获利？

这并不意味着 PAT 就没有意义了，只是说相比于传统市场缺失了一部分信息，再次强调了成交量的重要性罢了，而要想读懂价格中仍然蕴含的信息，我们需要学会阅读 K 线图，k 线图中蕴含了价格的四大重要组成。

K 线图的形态和基本阅读方法

在相应的时间框架内，每一个元素在分析价格行为时都起着相应的作用；另一方面，当我们适用成交量加以验证的时候，影线和实体最能揭示市场情绪。

k 线图的基本元素

通过上图的形式，将 K 线图解读成一个正弦波，随着市场的上下震荡，买方和卖方争夺控制权的主导地位，在上涨形势中买方最终占据主导权，整个过程可能十分曲折，但是我们只需关注最终形成的趋势即可。接下来我们就需要从中阅读市场情绪：

一、实体的长度/高低预示市场情绪的热烈程度，高实体意味着情绪强烈，低实体意味着情绪低迷 二、影线代表着变化，或者说是意见分歧，因此影线的长度和含义，在量价分析中无比重要。

k 线图中的实体和影线

正如上一小节中所说，实体长度象征市场情绪的激烈程度，而影线代表着具体变化过程；

实体而言：假如市场情绪始终都十分强烈且统一，那么我们将得到一个高实体且没有影线的 K 线图，这意味着市场始终向一个方向前进且没有质疑，该市场情绪强烈且将持续。

而影线由于其代表了变化和分歧，其长度和含义在量价分析中是无比重要的，下面有两个例子：

这是一个不存在实体的下影线，可以认为开盘后卖方占据了主导地位，力量超过了买方，导致价格下跌，随着价格下跌，对买方的吸引力上升，买方的力量逐渐压过了卖方，买家涌入市场，这意味着两点：

1. 无论周期多长，市场情绪出现了反转；
2. 收盘时市场处于看涨情绪中，这是由于买压暂时处于主导地位，（也有可能已经平衡？）

但是其并不能作为趋势反转的信号，因为仅凭借价格还没有足够的信息量，去判断当前买压的剩余力量是多少，还是已经达到平衡。如果需要得到这个信息，就需要分析在反转过程中发生了什么，这里就可以借助量价分析 VPA 中的 价量分布分析 VAP 即Volume at Price.

通过在价格变动中的成交量变化，我们就可以基于成交量来衡量买压和卖压的大小，两股力量是否达到平衡，也能利用成交量的变化速度，变化加速度，即一阶导和二阶导，去评估这个力量的平衡价位等。(需要考虑市场是动态的，而不是不变的系统)

下面这个上影线的例子，和下影线的例子的分析是一样的：

1. 市场情绪出现了反转
2. 收盘时市场处于看跌情绪中

这种 k 线图可以是跳动点图上的，可以是五分钟、日线、周线，都是一样的，当我们在日线图和周线图上评估趋势，并在 1、5 分钟图上结合成交量去分析价格行为时，意义更大。

这两种 k 线图是非常重要的价格形态，后面还会反复回顾；目前在分析上还欠缺的是：

• 价格行为的强度，即上述说的是否达到平衡，可能需要借助 VAP 分析；
• 这种价格行为是否有效：即是否是真实的符合市场的价格运动。
• 后续如何发展。

这些就需要结合成交量去分析了。

VPA 的基本原则

Summary

本章节并不是具体的分析技术和细节，而是涉及分析过程中的行动纲领，以及对整个方法的基本认知。

VPA 是艺术并非科学

在量价分析中，我们要做的通常是如下的两点：

1. 对比分析价格行为和对应的成交量，寻找相互印证或者异常；
2. 对比历史成交量判断当前成交量的大小；

因此主要的成本是如何获取实际的成交量。

而在这个过程中，作者认为相互印证或者成交量的相对大小的判断，没有一个准确的标准，大部分的判断都是主观的，因此不具备主观能力的软件程序无法胜任量价分析的任务，即 VPA 是艺术而非科学。

但是考虑到当前 AI 技术的发展，无论是适用 DPO、强化学习、偏好模仿、还是针对单独的股票进行独立建模在使用 moe 进行统一分析，我认为都能模拟人类的主观偏好以及后续自我进化的特点，因此我认为其并非无法适用软件去替代进行决策。

就算对应完全替代的路线难度很大，适用软件去获取置信度较高，或者需要警惕的信号做保底策略来简化人类监管也是大有可为的。

耐心等待转变

金融市场犹如一艘巨大的游轮，他不会戛然而止又迅速启动，市场通常拥有动量；反转终究会到来，但不是在某根 k 线图发出信号后立即到来，在它准备好反转之前，将首先完成清理的工作。

耐心原则：当 K 线图形态预示潜在的反转或异常时，市场的趋势仍然会继续持续一段时间。

这可能也是量价分析会 Work 的原因：信号提前于趋势的发生，通过类似加速度正负转变的方式，在利用 delay 时间清楚原有势力或者说动量后，才实现趋势的反转，整个过程好比趋势曲线是 S，发展方向取决于 V，转变信号则是 a 的正负转换，示例如下：

Todo

复习一下动量理论，可以参考动量的定律来对市场进行一个基本的建模，单纯考虑 S-V-A-t 的运动理论就类似 PAT，其中的成因 Volume 就好比 F=ma ，而作为 F 的 Volume 还能以动量的形式来对市场的运动产生影响，两者之间是能相互印证的。

回到具体的市场数值上而言，即从价格行为上看，买压或卖压在 Volume 和 Price 上的压倒性优势并非是瞬间形成的，而是一种逐渐转变的过程，通常可以看到下面这种流程：

1. 部分卖家坚信市场还会下行，继续坚持，市场下行了一小段后开始上行，越来越多的卖家离场
2. 市场再一次下行到更低点位后开始反弹，通过这种方式将固执的卖家清洗出局
3. 最后，清理完最后的卖家（“扫尾”）之后，市场做好了上行至更高点位的准备。

这种拉锯过程（犹豫情绪）正是一段延伸行情中的价格震荡区间的成因，在这种即将反转的情况下，通常会遇到强力的支撑位和阻力位；

是否包含如下的结构才是一个完整的趋势形成的信号?

flowchart LR
A[PAT 得到变动信号] --> B[Volume 验证] --> C[Volume 获取有效的
											支撑或着阻力]
C -->  D[趋势将会到来]
  

成交量的核心在于相对性

由于我们关注的是成交量的相对变化，因此无需纠结于成交量获取的数据有多么的准确，但是数据的一致性是十分重要的，只要在我们分析的阶段数据的来源和统计方法是一致的即可。

这里通过作者的长时间实践和纠结发现是正确且可行的，一个普通 MT4 平台的免费跳动点成交量数据也能满足我们的需求，且其还是免费的，作者已经使用了多年。

熟能生巧

历久弥新的熟能生巧四字真言；保持耐心，投入时间和精力，数周或者数月后会发现自己有预测市场反转的能力。

上述提及，该方式适用于各种时间跨度的交易，因此在做实验的时候，可以：

1. 投资：从较长周期的日线图和周线图进行分析，寻找买入和持有的机会
2. 投机：适用跳动点图或者短时间周期图进行日内交易；

技术分析

量价分析只是技术分析的一部分，通常结合其他的工具和方式对我们的预测进行确认，其中最重要的就是上述提到的支撑位和阻力位，该指标能描述市场在反转之前进行扫尾工作的阶段，又或者只是一段长期趋势的停顿点，都可以在后续的成交量分析中得到验证，但价格突破整理区间，伴随着适当的成交量，常常是一个强烈的信号。

趋势分析、价格形态分析同样重要，都是技术分析的这门艺术的组成部分。

VPA 的主要行为：确认或异常

flowchart LR
A[开始] -->B[价格被成交量确认]
A --> C[价格中存在异常现象]
B--> D[价格的连续性被确认]
C-->E[存在潜在变化的信号]
  

量价分析实际上寻找的就是上述的两种情况，核心在于如何判断确认和异常，下面通过单一 K 线和多 K 线来介绍如何区分两种情况：

单根 k 线图：从微观出发

价格确认信号

首先介绍价格被确认的例子：

长阳线的例子，根据上述 PAT 的理解，我们可以看出价格强劲上涨，收盘价略低于最高价，同时存在较高的成交量来匹配这一较大的价格变化（威科夫第三定律，投入产出匹配），由此价格被成交量确认，因此可以假设两种情况：

1. 价格的变动是真实的，未收到操控；
2. 市场处于牛市阶段，直到我们发现异常信号之前，都可以持有手中的长头寸；

短阳线的例子，这是一个伴随较低成交量的短阳线，具备幅度较小的价格变动（略微上涨），上影线和下影线也比较低，成交量也大幅低于平均水平，同样符合投入产出定义，较低的成交量促成较小的变动。（较低的投入只能促成较小的市场变动）。

价格异常信号

接下来看下异常的例子：

长阳线异常的例子，其不符合威科夫的第三定律，有较大的价格变化（产出），但是仅有很少的市场参与（即成交量，即投入），这种异常出现时，我们需要考虑是否是市场或者做市商设下的多头陷阱。这种形态常常发生于：

1. 股票开盘，做市商基于夜盘中的信息判断市场的情绪处于牛市或熊市，然后通过抬高/降低价格来测试买家的兴趣，如果没有买家有兴趣，价格将会下跌，仅在买方会在高价进入市场时，他们才会继续抬高价格。后面再继续测试；通过这种方式来确定盘后九分钟的价格水平

因此在开盘后的几分钟内盯紧图表，有助于我们明确当天的一个交易基调，同时我们也应密切关注相关的突发行为，因为做市商"不会放过每一个制造危机的机会"，他们会通过新闻的机会来测试市场，根据新闻抬升或拉低价格，都有可能使得类似的图表出现。

这是一种标志且明确的陷阱信号，这种价格的上涨会迅速的发生反转，市场相反方向运动。

🔥 短阳线异常的例子，其同样不符合威科夫的第三定律，这里小幅度的价格变化却由着大量的成交量造成，这种典型的 K 线图形态往往发生于牛市的顶部，或者熊市的底部。是一种市场趋于弱势的信号。举个例子来分析：

假设：牛市情况 情形分析：持续了一段时间的上涨，主力多头开始了结利润，开始清仓卖出，而此时持有 FOMO 情绪的个人投资者拥入市场买入，此时由于主力在退出，个人投资者没有足够的能量来推动价格继续上涨，因此有大量的成交量却仅有较小的价格变动。此时买方仅稍胜卖方，但是如果趋势再往下后，可能也会出现反转，因为如果卖方十分坚定（强势）则会表现出阴线。 卖出对象分析：个人投资者通常存在追涨杀跌以及 FOMO 的特性，因此卖出的主要是了结利润的长期投资者，局内人，做市商，内幕交易者等； 剩余买家没法推动价格上涨，价格的上涨会引来更多的卖出，下跌则会有更多的买家，在该价位拉扯。

因此这是一个市场走弱，而挣扎于保持现有水平的一个典型信号，如果原先持有头寸，就应该收拾收拾卖出，或者准备在趋势反转的时候建立头寸。

了解信号的趋势背景

Summary

在 k 线图的解读中，对所处趋势的认知影响解读的方向，趋势对于信号的解读是必不可少的环节即：K线图在趋势中所处的位置不同具有的意义也不同

趋势对 k 线图分析的影响主要有以下的几类：

• 时间跨度：信号是在 5 分钟图中，小时图，日图等发生的，对应的趋势周期和长度是不一样的，并非只有长期趋势才叫做趋势；
• 趋势中的位置定位：需要明确价格异常的信息具体引导向建立头寸还是卖出，需要借助趋势信息来明确我们在价格变动中所处的位置，

而要分析趋势，明确信号带来的引导，寻找潜在的反转点，需要使用支撑位和阻力位、 K线图形态、单根K线图，以及趋势线进行分析。上述工具可以为我们提供我们的“方位”帮助我们确认价格变动中我们所处的位置。

多根 k 线图：宏观分析，由点到线

趋势确认信号

以下图为例，这是一个连续上涨的 k 线：价格逐日上涨，且实体也逐日扩大，同样的成交量也满足一样的规律，逐日扩大。

可以看出曲线上整体是符合威科夫第三定律的，较低的价格变化实体对应较小的成交量，同时较高的价格变换实体也具备更高的成交量的确认。从单线和多线上都印证了这是一个市场参与（受到了市场情绪和专业人士的共同支持）的正常价格变动，形成了一个成交量在增加的趋势的价格上涨趋势；

这里说明的是投入产出不仅适用于单线，也适用于多线的情况，这可以是我们进行双重确认；同时这里成交量和价格的变动也能用第二定律来解释即：此处结果的变动程度（趋势中的价格变动）和原因的规模（成交量在特定时间单位中的变动）是相关的，即上涨的价格与放大的成交量正相关。

假设上述的价格上升过程没有影线，我们可以认为，成交量均为买入的成交量（如果有卖出市场应该有所体现），市场坚定的上行，是一个低风险的交易机会。

无需赘言，下跌的例子也可同样使用威科夫第三定律来确认价格变动是否是有效的，与上涨和下跌无关，同样，我们从两个层次去确认价格变动的合理性。

Warning

后续需要确认一下这个逻辑是否是正确的

graph LR
    A[开始] --> B{单 K 线分析}
    B --> C[对比平均情况]
    C --> D[实体和 V 的所处相对位置是否匹配]
    D -->|是| E[进入多 K 线分析阶段]
    E --> F[观察整个趋势中的价格变化]
    F --> G[检查价格和成交量的变化是否一致]
    G -->|是| H[确认价格走势]
    H --> I[结束]
    D -->|否| J[分析单 K 线异常]
  

量价异常信号

以下图为例，价格在上涨，同时实体逐渐略微扩大，第一根 K 线的价格和成交量相互印证，但是其余 k 线却均有一些问题。

1. k 线图 2 中实体较低却伴随着巨大的成交量，这是市场弱势的信号，这意味着主要操盘手（做市商）正在卖出，因为大量的投入没有产生对应的上涨效果。
2. k 线图 3 是一个连续异常，在趋势上他实体相对于 2 更高，但是成交量却更低，这也清楚的印证了 k 线图 2 中的异常
3. k 线图 4 再一次异常，实体更高了，但是成交量却更低，该趋势中明确存在异常行为。

通过上述图的表现，可以有下面的结论：

首先 k 线图 2 中成交量的投入和价格产出的不匹配，体现了一个市场处于弱势的信号，市场处于"超买"的情况，做市商和专业人士感受到了市场的弱势，卖家享受做空机会，在这个点位大量卖出，等待价格下跌，同时继续抬高价格来创造盈利而非推动上涨，但是买方市场显然已经没有足够的能量推动价格继续上涨，下跌的成交量可以印证这一点，这是市场处于弱势的一个信号。

这也可能只是一个短暂停驻，并非趋势的大型变动，进一步的我们需要在更大的背景下分析图表，决定我们看到的是一个小幅度的回落还是趋势改变的征兆。这一点上就需要借助因果定律，从时间跨度和量的起因来分析这是一个小幅度的回落还是一个大的趋势的转向。

这另一个多根柱状图异常下跌的趋势：价格持续下跌，实体逐渐扩大，成交量的变化却并不与之匹配，这里的分析和上述超买的情况类似，在第二个 k 线处开始发生异常。

同上述分析，可以有以下的结论：

k 线图 2 中低实体却对应的大量的成交，意味着市场拒绝向更低点位运动，卖压正在枯竭，做市商感受到了这个市场情绪，即越来越多的买家涌入开始买入，因此做市商在这一水平也开始执行买入，因此市场难以继续向更低点位运动，k3 和 k4 则是做市商继续调低价格，试图欺骗卖方市场仍处于熊市，使其继续卖出，从而自己能在更低价位买入，建立头寸。

由于做市商和专业人士转向了买方市场，从空头转向了买入，因此卖压开始枯竭，卖方不够支持成交量的上涨，来使得市场运行到更低的点位，因此也构成了一个信号。

同样，有了这样的异常信号以后，我们还需分析进一步的信号，从因果定律出发，判断市场发生趋势反转的程度：是短暂回调还是大幅反转。

即使这是一个小插曲，也为我们提供了一个低风险的短期交易的机会。

至此，我们从微观（单 K 线）出发建立成交量的相对状态的感知，然后从宏观分析（多 k 线），得到小级别的趋势，或者潜在的小级别反转的确认，而还缺失的就是全局视角，了解价格在这个长期趋势中的位置，这也是后面要介绍的内容

全局视角 Intro

我们从一根 k 线开始变焦到局部 k 线趋势，最终我们还需要看到更长时间上的大趋势，能够进一步的帮助我们理解市场运动，完善我们的局部分析，从而做出最终的决策，在这一部分，威科夫的第二定律：因果定律，就会大肆发挥作用。

理解全局视角

正如耐心等待转变原则所言，市场并非是获取转向信号后就立即转向，从全局视角出发，我们可以知道这正是由于：

“市场就像一艘油轮——在局内人、专业人士以及做市商准备好前，市场需要花一定的时间消化买盘或卖盘以完成转向。在他们确认实施下一步计划之前，不希望市场成为他的阻碍。”

上述两个例子就像是"扫尾"行动，这种扫尾行动可能在日线图上会间歇性的持续在数天、数周、数月中出现，市场持续震荡整理，出现多次连续的反转信号，来使得扫尾更加彻底，清楚市场的阻碍，但是我们不知道合适反转会发生，而威科夫的第二定律告诉我们，当整理的时间越长，幅度越大，反转就越可能发生，准备的周期越长，最后转变的趋势也会更加持久。

以上述的例子而言，当我们发现这 4 个例子反复在同个价格水平出现，而非单次出现，那么就可能不是一个小插曲，而是一个较大的趋势了，在这种时候我们应该耐心等候支撑位和阻力位的信号（后续）。

实际策略操作举例

（日内交易为例）：结合 5 分钟、15 分钟、30 分钟图表进行市场分析：

• 15 分钟图进行日内交易；
• 5 分钟图来获取靠近市场的视角；
• 30 分钟图来获取长期视角；

一个趋势如果在 5 分钟图中发生，随机传导到 15 分钟、30 分钟图中，那么他就会发展成为一个较为长期的趋势，（判断信号用多长的时间来蓄势？从而判断反转发生的趋势的持续水平？）

FI

[!summary+] 量价分析Volume Price Analysis，基于所有的金融市场都被幕后操作的假设，利用成交量是不可被隐藏和作假的特性，使用成交量来确认和预测价格运动。

Intro 市场的基本行为

从威科夫量价交易之父提出的集散概念和价量至上原则开始："价格和成交量是决定股价波动的最重要因素"。此外查尔斯·道技术分析之祖的道氏理论中的一条基本原则也说"成交量可以确定价格变化的趋势"

因此进行相应分析时需要包含成交量和价格的图表。

From 《盘口解读》:

在根据市场自身的表现来判断市场的时候，短期波动或长期波动都由价格、成交量、活跃度 、支撑位和阻力位 所反映。从海里一滴水的成分可以推断海的成分，反之亦然；

There is nothing new in trading. 适用性

适用性：“日光底下无新事”，目前可以认为基于成交量进行的量价交易，到今天仍然是适用的，且适用于各种市场（不同投资类型），各种交易或投资策略中。

Daw’s Rule 1 成交量确定趋势的有效性

Daw‘s ’Rule1：成交量可以确定价格变化的趋势； Detail 具体而言：

• 当一个股票的波动伴随着较低的成交量，那么其变动的原因是多样且不能被确定的，其将不能被认定为存在一个有效的趋势；
• 而当一个股票的价格变动伴随着很高的或者逐渐增大的成交量，那么该变动是一个有效的变动，或者说，可以假设其具备构成一个趋势的基本条件（必要非充分）
• 在第二点的前提下，如果价格继续向着同一个方向变动，且拥有相应的成交量支撑，那么将是一段趋势开启的信号；

flowchart LR
A[成交量] --确认-->B[价格行为/价格变动]--形成-->C[趋势] 
  

Expand 理论延续：当满足条件的趋势形成，Daw 认为接下来的趋势会具备一下的三个阶段（Daw 的趋势理论）：

timeline
title 成交量趋势的三个阶段
吸筹阶段: 更强趋势的起点
公众参与阶段: 趋势最终的阶段
		 : 最长的一个阶段
派筹阶段: 投资者蜂拥买入的 FOMO 阶段
	   : Daw's 止盈的时机
  

理解一个趋势的不同阶段，对后续做出决策还是有所帮助的。

Note

成交量逐渐上升，是否就会形成一个供求关系的强烈变动，具体是如何 work 的呢？

• 和流通量有什么关系？ 买>卖 => 上涨？因此最好在第三阶段卖出？

股票指数的概念也是 Daw 提出的，通过行业指数等，可以追踪一个行业的整体状况从而了解宏观经济的运行情况；（大盘？）

Wyckoff’s 供需关系决定趋势

Wyckoff’s Opinion：价格完全是由经济学中最基本的供求关系决定的，通过观察价格和成交年的关系，完全可以预测未来市场的方向。

他在对行业大师的采访中发现了共同点：行情纸带都是他们投资决策的依据，而行情纸带可通过其包含的信息：价格、成交量、时间、核心趋势来为我们揭示最基本的供求规律。

Three Basic Laws 威科夫的三大基本定律：

一、供求定律：

当需求 > 供给时，为了满足这样的需求，价格会上涨；相反地，当供给 > 需求时，价格会下跌，结果就是超额的供给会被吸收；

二、因果定律：

有果必先有因，且因果之前呈现正比例相关，即：小规模的成交量变化将引起小范围的价格波动，重大的起因会导致重大的结果。

该因果定律并不只是指代变化规模上的，同样也能指代时间跨度上的，短时间图表上的成交量变化和长时间图表上的成交量变化，将会引导的是不同跨度和规模的趋势。

三、投入产出定律：

价格变动和成交量的变动呈现作用力和反作用力的关系，两者的变动应该有一种和谐统一的关系，即通过投入（成交量）即可预计相应的产出（相应的价格行为）。

分析每一条价格柱状图，看时候持续成立，如果是持续成立的，那么就可以继续适用该方法，进行预测，否则需要找到其背后的原因，分析异常，否则就不能在该股票上适用该方法。

简单的总结如下：在验证符合定律的情况下，关注异常疲软的需求或者异常强劲的需求，在供需适配的地方会发生相应水平的价格变动。

flowchart LR
A[投入产出定律]--验证有效-->B[供求定律]--确定趋势-->C[因果定律]-->D[从需求中估计幅度]
  

Richard Ney 内幕交易永流传

“我们参与的投资市场或多或少的被操纵，包括做市商遮遮掩掩的行为，公开的一些政策干预等等”，但是成交量是无法被隐藏的，成交量反应交易行为，反应价格变化背后的真实情况，检验价格变动的真实性。

操纵：通过一些内幕消息和影响力（假消息等），来使得在各种交易中获利（根据自己的买入或卖出意愿来操纵价格），而不管股票的真实价值如何。

• 这里有个专业人士的卖空之道的八大法则，目前没明白意义在哪，可能能帮助我们理解操纵行为吧，后续补充

做市商的永恒存在可能也是对该点的一个佐证？金融基本术语 中参考做市商。

Volume Matters 利用成交量跟随内幕

关键之处就在于获取比其他人更多的信息，然后正确地分析并使用他们 ——沃伦巴菲特

Get Info 通过成交量来洞察内幕者的操作

作为股票投资者，我们无法如同做市商一样获取市场的供给和需求水平，但是我们可以通过成交量间接了解这一情况，去间接的获取做市商的资讯。

这里成交量分析具备局限性：做市商会在交易发生数小时后才报告大众交易的数据，不过仍然是我们窥探市场的最好工具。

由于做市商对应的操作会影响该信息的时效性，因此可能会影响量化交易策略的执行，不过也可以考虑其中的价值和成交量的失配是否会带来一些新的信息。

无论做市商是否执行了某些操纵行为，成交量分析都是可以 Work 的，以下面这个分析为例：

---
title: 牛市前提下
---
flowchart LR

A[期货价格上涨] --交易规模大&--> B[成交量扩张] --> C[Valid]
A --> E[成交量没有对应趋势]
D[期货价格下跌] --> B
D --> E
E --> G[警惕市场/做市商的欺骗]
  

在期货市场中，量价分析同样的也有验证价格变动真实性的能力，揭露市场中卖家和买家的真实情绪：

---
title: 期货市场
---
flowchart LR
A[量价分析] --> B[揭露情绪] --> C[趋势反转时发出信号] -->D[实现对内幕操盘手的跟随]
  

这里其实引出了量价分析的核心逻辑：

1. 假设内幕操盘者存在
2. 跟随内幕操盘者进行操作

在没有真实成交量数据的外汇现货市场，可以使用跳动点数据来做成交量的替代分析工具；跳动点可以按照拍卖报价来理解，报价跳动得越快，说明市场的成交量，活跃程度更高，情绪也更高涨。

外汇交易市场是内幕操作最多的市场，“汇率战争”这个术语就可以证明。

Volume Rule 利用成交量的方式和基本准则

在使用成交量的时候，需要注意以下的三个方面：

• 成交量的大小是相对的：要考虑均值，也就是相对规模，相对性上的关系才是重中之重；
• 离开价格谈成交量是毫无意义的
• 时间也是关键因素之一，

下面有一个例子，后面再细细体会：

1. 当熊市中市场以较大角度向下运行，而价格如瀑布般暴跌，伴随着巨大成交量，这就是买入高峰；（此时散户由于恐慌大量抛售，而主力正在低价买入，这时对我们而言就是一个机会。）
2. 在牛市的顶点，我们发现成交量急剧放大，那么这就是一个抛售高峰。（主力向散户派发手中的股票，但是散户却认为价格就一步登天）

!! 此外作者认为，这是一个"酌情"做出决策的策略，因此永远不具备自动化实施的可能，这点我需要质疑一下，看下后面具体的执行方法。

Summary

对于投资者和投机者而言，研究成交量的原因是为了洞察内部人士，或者说专业人士的举动，跟随他们的方向。

Summary

前文中选择了 Kopia 作为笔者的备份工具，本文记录具体的备份执行方案以便后续查阅；

🌐 备份文件存储位置选择

基于笔者的现实条件约束，最终没有完全遵循 3-2-1 去管理自己的备份，而是利用 kopia 以如下的 2-1-1 作为替代：

• 2：除了原始数据，最终有 2 份分处不同位置的备份；
• 1：使用 kopia 在链接本机的移动 SSD 硬盘上存储第一份备份；
• 1：使用 kopia 和 Webdav 在阿里云盘上存储加密的第二份备份；

此处考虑类似阿里云盘的第三方服务本身做了备份处理，具备一定的容灾能力，因此使用第三方存储服务去做一个备份点就相当于将部分备份任务转嫁出去了。

而对于第三方网盘可能出现的数据泄露的担忧，由于 kopia 本身备份和上传的是加密的内容，无法被直接查看，相当于在平台外还添加了一层隐私安全的保险，不用担心隐私泄露问题。

📌 备份内容选择

Immich 的备份和恢复

---
title: Immich的备份构成
---
flowchart TD
A[immich Server]--> B[(user-Databse)]
A --> C[(filesystem )]

B --> D[AssertPath]
B --> E[User Info]

C --> F[Origin Assert]
C --donot need backup--> G[Generate Assert]
  

受限于 Immich 的机制，文件和用户的关联是在上传过程中建立的，对应的关联信息是存储在数据库中（上图的 user-Database）backup-and-restore，如果仅对原始的 Assets 进行备份，没有备份数据库的话，会导致无法将图片和账号进行绑定，就会需要重新对大量的图片数据重新走上传/外部库导入流程；

重复的上传/外部库流程由于 1. 导入服务端原有的图片；2. 移动端设备的自动上传；会导致出现大量的重复图片，增加存储负担和查看体验；再加上其本身带来的时间和性能消耗，是非常得不偿失的。

如果不幸陷入了此等境地，上传建议使用外部库External Library的方式来导入原有文件夹，这样可以迅速的对多个用户的多个目录去处理，然后等待其后台处理完毕；

标准备份流程

言归正传，接下来分别介绍一下基于 Kopia 如何去实现一个正常的备份流程：

---
title: 一、Kopia 备份Immich User-Dataset
---
flowchart LR

A[Immich] --> B[AutoBackup-Process]
A --> C[optional: Manual Backup Process]

B --> D[Kopia Backup Process]
C --> D
  

也就是说只需要在当天的数据库备份之后启动 kopia 对 immich 的备份任务即可，无论是定时的自动备份还是手动备份；

为了便于备份，新版本的 Immich 每天会自动生成数据库的备份到 UPLOAD_LOCATION/backups 目录中

手动备份的指令如下，执行手动任务的话可以使用 crontab 定时：

docker exec -t immich_postgres pg_dumpall --clean --if-exists --username=postgres | gzip > "/path/to/backup/dump.sql.gz"

二、备份完数据库后，仅需备份/恢复对应的原始资源文件夹即可，原始资源文件夹如下：

1. UPLOAD_LOCATION/library
2. UPLOAD_LOCATION/upload
3. UPLOAD_LOCATION/profile

具体不同类别的存放路径会基于是否开启了 Storage template 有一些细微的区别参见 asset-types-and-storage-locations

也就是说，只需要在指定的系统备份时间之后，启动 kopia 备份，并包含上述提到的 4 个目录，即可实现对 immich server 的充分备份。

标准还原流程

---
title: 还原immich资源和设置
---
flowchart LR
A[("Kopia
Snapshort")] --> B["Restore 
					Assert 
					Organize"]
B --> C[CreateImmich 
		WithoutRun]
C --> D[Restore 
		Datast]
D --> E["Run 
		 Immich"] --update backup path--> A
  

简而言之，这里最主要需要注意的就是在构建 Immich 之后，正式运行之前，就需要执行数据库的还原，避免运行后和生成的新数据库出现键值等的冲突；

这里资产的位置还原可能没有说那么紧急，但是如果需要修改资产在 Upload_location 中的位置的话，可能需要手动对备份的数据库进行修改，不建议。

还原脚本如下：

docker compose down -v  # CAUTION! Deletes all Immich data to start from scratch
## Uncomment the next line and replace DB_DATA_LOCATION with your Postgres path to permanently reset the Postgres database
# rm -rf DB_DATA_LOCATION # CAUTION! Deletes all Immich data to start from scratch
docker compose pull             # Update to latest version of Immich (if desired)
docker compose create           # Create Docker containers for Immich apps without running them
docker start immich_postgres    # Start Postgres server
sleep 10                        # Wait for Postgres server to start up
# Check the database user if you deviated from the default
gunzip < "/path/to/backup/dump.sql.gz" \
| sed "s/SELECT pg_catalog.set_config('search_path', '', false);/SELECT pg_catalog.set_config('search_path', 'public, pg_catalog', true);/g" \
| docker exec -i immich_postgres psql --username=postgres  # Restore Backup
docker compose up -d            # Start remainder of Immich apps

上面注释掉的 rm -rf DB_DATA_LOCATION # CAUTION! Deletes all Immich data to start from scratch 这一行就是在并非初次启动 Immich 的时候执行时，如果遇到 Postgres 的冲突，才需要执行，通过直接删除数据库来还原初始状态。

恢复后记得修改自己的 Kopia 中 immich 的新路径。

Docker Volume 的备份和恢复

如何对Docker的volume文件在主机间迁移 | sealhuang’s blog

Linkstack 的备份和恢复

⚙️ Kopia 设置

Basic Setting 基础设置

• 设置备份时间和频率
• 其他的使用默认的即可

Kopia 连接阿里云盘

要将阿里云盘作为 Kopia 的一个备份仓库，需要使用 Webdav 去使得 Kopia 连接阿里云盘，但是由于阿里云盘官方第三方服务包提供的 Webdav 仅支持文件的读取，并不支持文件的写入，因此官方的 webdav 服务无法满足该需求；

因此需要使用开源的第三方服务来挂载阿里云盘，并通过第三方服务映射出来的较为完备的 webdav 功能来连接 kopia ，进而使其作为存储仓库；这里有较多的选择，可以自行查阅其他选择，此处笔者使用的是家庭服务中提及的 Alist ，下面简单介绍一下相关的参数配置：

基于ip的url: https://{ip}:{port}/dav/{specific_path}
基于domain的url: https://{domain}/dav/{specific_path}
基于二级域名alist的url: https://{domain}/alist/dav/{specific_dirctory_path}

账号和密码同 Alist 的登录账号名和密码即可

一些常见的托管平台 PaaS Platform as a Service 平台及服务 ，旨在使用户专注于应用代码开发 的免费情况如下；

其实对于这些小型的静态网页的项目部署，大多都是免费的，整体部署的流程也是相对简单，选择一个顺眼，便于国内访问用即可，但是无论是哪个方案，都建议绑定一下自己的域名，一来是更便于记，二来也能便于国内访问。

Todo

了解一下 Coolify，是否是类似一个公网转发平台的方案，将特定端口的服务使用 Coolify 转发到公网上，然后可以绑定自己的域名，这样的话也不失为一个好东西，我之前的服务也就都能部署出去了；

最终选择的时候可以考虑以下都是谁在访问自己的博客，然后测一下对应地区平台访问的速度来做决定，国内的话 vercel 好像是被 DNS 污染了，如果要部署在 Vercel 上的的话，考虑在域名解析的地方更换为CF 的解析服务 原因：【多图预警】vercel部署及国内访问 | VuePress Theme Gungnir 具体方案：一招解决Vercel站点在国内无法访问的问题 | 程序猿DD | 如何在国内访问vercel部署应用？我个人觉得vercel是做前端的大家都应该去了解并且掌握的一个非常方便的部署工具，能 - 掘金 ；

直接使用 Public 文件夹进行部署

作为静态网页生成器，hugo 通过部署模式生成的 public 文件夹可以很轻松的在包括 Github pages 和 Vercel 等第三方平台上的各个托管平台进行部署，部署起来相当简单，只需要将 Publish 文件夹推到github 上，后面的都比较简单了

• Github Page 直接在Setting-Pages 中设置选择源 Branch 即可，不需手动去写Github Action；
• Vercel, Netfily 也是直接绑定对应的Github 仓库的指定分支即可，framework 选择Other；

且均能根据 Publish 的变更对网页重新构建，这里就不再赘述。

基于源码直接部署

基于源码部署主要是考虑到同时将博文本身推送上去，一是使用 git 做版本管理，二是可以不再额外管理一个仓库；因此也可以采用此种方式；

但实际上如果要和本地的 Editor 如 Obsidian 做无缝集成的话，还是会需要一些额外的脚本去做处理，包括写完后自动更新 repo 和推送这些，后续如果笔者记得的话可能也会更新一下相应的脚本；

部署到 Github Page

参考 hugo官方教程 使用 Github Action 进行在线构建和实现 Github Page 的发布，修改其中自己需要进行构建的分支名称和部署命令等，然后直接 push 上去即可。

这里我对部署命令的修改部分如下：

run: |
  hugo \
    --gc \
    --minify \
    --environment papermod \
    --baseURL "${{ steps.pages.outputs.base_url }}/"    

使用非 Master 分支进行构建可能会遇到以下的问题（build 成功，deploy 部分显示如下错误）

Error

Branch “x” is not allowed to deploy to github-pages due to environment protection rules.

解决方案：Github community · Discussion #39054 ，Repo 的 Setting 中找到 Environments 中的 github-pages 项中的 Deployment branches and tags 新增自己想要部署的分支即可；

Error

Static 中的资源加载出现 404，导致界面表现不合预期的情况

此外，如果个人之前已经对其他的 GithubPage 绑定了域名（例如 http://aikenh.cn/ ），这样可能会导致由于网页部署在域名的子目录下( http://aikenh.cn/hugoblog/ )，导致一些资源的 url 绑定到域名上（资源被绑定到 http://aikenh.cn/ 中导致 404 ），无法获取到，这里的解决方式是，通过绑定子域名/二级域名 或者新的域名。

这里简单讲一下子域名的添加 Github Docs ，首先在 Github-Repo-Setting-Pages 中设置 Custom domain 如下

添加后去自己的域名控制台添加对应的 cname 子域名记录，然后稍后即可

添加子域名解析后可能会发现反而 CSS 等样式表加载不出来的问题（上一步的时候没问题），这时候就要考虑是不是 BaseURL 忘记更新了；记得修改项目配置（非 GithubAction 配置）中自己的 baseURL 再推上去使其重新构建，避免存在部分解析问题即可；

部署到其他 PaaS

Error

由于我们本地开发使用的 Git Submodule 中的地址通常是 git@github ,可能会导致第三方平台在拉取 Submodule 的时候出现一些权限错误导致拉取失败

因此当我们部署 Netlify 之前可以按照下面的方式更新 Submodule 为 http 链接，首先更改 .gitmodules 中子模块的URL

[submodule "themes/PaperMod"]
  path = themes/PaperMod
  url = https://github.com/AikenH/papermod-sidebar.git

然后执行下列命令来更新子模块的URL

git submodule sync
git submodule update --init --recursive

更新完以后将其推送到部署分支，例如 netlify

git checkout -b netlify
git add . 
git commit -m "[Conf] update submodule for third-party deploy"
git push origin netlify:netlify

部署到 Netlify

做完上述 Submodule 的准备之后，在 Netlify 的dashboard 上导入Repo 进行发布：

• 导入仓库，选择好发布的分支

可以参考下列命令来设置自己的发布参数以及环境变量（hugo 版本）

环境变量的Key-Value 分别为：HUGO_VERSION 还有你本地的 hugo 版本，可以通过下列命令获取

hugo version

域名绑定：主要是参考官方指引，将需要的域名填入后，按照如下指引，在购买域名处添加CName 即可；

随后记得更新网站的 BaseURL 以便网站正常工作;

部署到 Vercel

做完上述 Submodule 的准备之后，同样在 Vercel 处的设置也是比较简单的，导入指定的仓库后，将模版指定为Hugo，并修改部署配置如下：

同样添加环境变量：

但是 Vercel 中指定分支的方式相对较麻烦一些，在部署后，进入project 的dashboard 中，选择Setting

其中的 Git -> Production 跳转到指定页面去设置分支，设置完记得选择保存，同时下面有个环境变量也可以在设置一次。

到此为止的话其他分支上的提交也会导致触发build，为此我们还需要进一步设置，在刚刚 Git 页面的最底下，选择 only build production 即可，这里参考 oragekk ：

后面再触发一次 Deploy 任务以后就可以看到分支切换到指定的分支即可

添加域名：待补充；

TroubleShooting 问题解决

部署时 CSS 样式不显示问题

hugo 部署时遇到像 CSS 和 JS 或者图像等不显示的问题，可能有以下的两种原因：

一、假如图像, JS, CSS 都不显示，可以通过浏览器的开发者模式中的网络选项等去检查资源的对应地址是否是正确的，然后检查 hugo.yaml 中的 base_url 是否设置正确；

二、假如仅 CSS 不显示，只显示图像和文字，可以打开开发者模式中的控制台，看是否有如下报错：

Error

Failed to find a valid digest in the ‘integrity’ attribute for resource

如果是如下报错的话，可能是由于 minify 生成静态网页时，去掉了 html,js,css 等文件的部分空格和格式，来缩小文件的体积，但是修改后会导致文件校验失败，从而阻止加载，因此就会有两种解决方式：

hugo 设置中关闭校验 bj-Space : 在 hugo.yaml 中添加，（使用toml 配置的情自行修改对应选项）

params:
	assets:
		disableFingerprinting: true

关闭 minify 选项 3rd’s blog

还有一些其他的可能问题：http 和 https 混用

FI

Important

本文为了避免 hugo 直接将 shortcode 渲染出来，在所有的 {{ 和 < 或 >，% 之间添加空格，具体使用的时候记得去掉。

What’s ShortCode in Hugo Mean 啥是简码

Hugo 中的短代码 后续用简码来表示 可以理解成一种使用固定方式引用的 Template(或者说 Alias)，通过使用预先定义模版，避免在 markdown 中直接添加大量 html 或者 go templates 代码

通常通过 {{ < shortcode > }} 的方式来调用模版，定义的简码可以为如下的三种形式：

来支持不同类型的模版代码，将一些比较复杂的 html 代码通过简码的形式嵌入，可以使得我们的静态博客支持更多的拓展样式；官方文档

Benefits and Limitation 利弊分析

Summary

简码存在什么好处和弊端，应该在什么时候使用简码，什么情况下定义为简码，什么时候将其定义为内置的渲染类型；

正如上文所说，ShortCode 其实本质上可以理解为 Hugo 内置的一种模版功能，通过模版用于在 Markdown 中快速的调用额外的样式，因此优势也就显而易见：

• 模版的角度：简化书写，具备良好的可重用性，统一管理；
• 拓展的角度：丰富样式，增强功能

例如我们可以使用简码为文章添加 sidenote(边注)，可以让文章的主体更加简洁，更为美观，效果如下：

虽然使用简码确实能够使得 blog 更加的美观，拓展一些额外的功能，但是相应的会使得本地软件编写时的所见即所得的特性被破坏，同时对文档或者说博客平台迁移的时候也会增加一些额外的工作量对文档进行处理；

当然这里也可以通过对一些开源的笔记软件进行适配去维持所见即所得的效果，但是工作量的增加是实打实的；

为此，退而求其次的，为了保持原 markdown 的可迁移的特性不要被严重破坏，同时能够较好的维持所见即所得的可以考虑使用一下的流程去处理 笔者使用 Obsidian 编写文档：

---
title: 文档处理流程
---
flowchart LR
	subgraph source
		MD["Md + ez-HTML"]
		Obs["Obsidian"] --- MD
	end
	subgraph Publish
		Pub["Publish Dir"]
		Hugo["Hugo"] --- Pub
	end
	source --Cond--> Scr["Convert Md"]
	Scr --> Publish
	Publish --> Tri["Tiggle Publish"]	
  

在源文件中尽可能的使用原生的 markdown 和一些简单的 html 去编写，然后触发转换脚本之后，根据各种不同的条件（例如发布平台）去进行 markdown 的转换（html 转换为短代码，或删除多余部分）并发布到对应的路径上去触发发布任务；

以边注为例，这里可以使用 <small> content <small> 在 Obsidian 中显示其脚注的特性，然后当发布到 Hugo 的时候，利用脚本将 small 转换为 sidenote 的形式即可，这里替换起来还是很简单的；

import re
content = re.sub(r'<small>', '<sidenote>', content)
content = re.sub(r'</small>', '</sidenote>', content)

整体而言，笔者认为尽量少用那些比较特异的样式来破坏 markdown 的所见即所得的特性，但是可以通过这这种简单的 html 格式来保持的倒是无所谓，像是一些时间轴之类的，或者一些比较复杂的样式，建议还是少用，或者在一些场景将其转换为图片嵌入，主要的部分还是要让博客回归内容本身；

Some Default ShortCode 默认简码

hugo 本身支持了部分的 ShortCode，这里简单列举记录，便于需要的时候调用，同时避免重复造轮子：

这些具体的参数或者更多默认的一些 Shortcode 可以去官网 查阅，这里就不在多说。

How To Design a ShortCode 编写简码

主要的流程如下，如果需要自己定义，建议还是去官网 查看详细的文档、参数和优先级说明。

一、创建简码文件

在 Hugo 项目的 layout/shortcodes 中新建 【keyword】.html 文件，这里文件名的 keyword 会成为后续调用简码时的关键词；

二、编写简码文件

使用 Go template 和 html 编写你所需要的拓展样式，并通过 Go template 获取调用简码时传入的内容和参数进行处理和渲染；

下面简单列一些获取采位置参数，设定参数的写法：

{{ .Get "class" }}
{{ .Get 0 }}

获取 Paired 中填写的内容则可以使用 .Inner 去获取，如下：

{{ if strings.ContainsNonSpace .Inner }}
  Inner is not empty
{{ end }}

更多参数和内置变量和方法请参见官网文档和说明。

三、调用简码

使用 {{ < keyword > }} 或者 {{ % keyword % }} 的方式，或是上述提及的 paired 的方式进行调用。

What I Support In My Website

Summary

本章节主要分享&感谢一些本博客中使用的短代码的来源，并简单介绍部分我修改或者编写的短代码，包括加密还有边注的短代码；

主题中引入的大部分 Shortcode 来自以下几位博主，这里简单整理了一下，这里就不再重复，如果需要的话可以转到博主的文章中查看，感谢几位博主的分享!!：

部分博主使用的是 Scss，使用的时候可以去网上搜索一下 Scss 转 css 的去转换成自己熟悉的格式，再根据自己主题的配色和习惯去简单调整一下 css 样式即可。

接下来介绍一下自己修改或者编写的一些简码，这里也分享出来供大家参考：

Sidenote 边注简码

笔者希望博客能够充分利用视区的宽度，因此将 Papermod 的 Nav 和 Toc 都改到了侧边，但是通常使用宽屏阅读的时候，感觉还是有一部分空间没有被利用，决定通过简码支持 MarginNote 这里受台运鹏 该博客的启发，感谢其分享

最终参考 KF KF: Marginal Notes 和 a Scripter Sidenotes using only CSS ❚ A Scripter’s Notes 的实现，编写 hugo 的 shortcode，其核心就在于

• 使用 relative 和 float 进行 postion 控制
• 然后通过-值的 margin 来校准位置
• 考虑响应式的要素再去启用侧边注释，否则就嵌入正文中
• 使用 counter 做脚注

最终 shortcode 在本博客中呈现的效果和对应的 html 和 css 如下：

<span class="sidenote-number"><small class="sidenote">{{ .Inner | markdownify }}</small></span>

.sidenote {
  font-size: 80%;
  position: relative;
}
/* Wide viewport */
@media (min-width: 1500px) {
  .sidenote {
    float: left;
    clear: left;
    margin-left: -16vw;
    text-align: right;

    top: 0rem;
    width: 13vw;
    margin-top: 1rem;
    
    border-top: 2px solid rgb(0, 0, 0);
  }
  .dark .sidenote{
    border-top: 2px solid rgb(255, 98, 0);
  }
}

/* Sidenote counter */
main {
  counter-reset: sidenote-counter;
}
.sidenote-number {
  counter-increment: sidenote-counter 1;
  
}
/* Counter before the sidenote in the margin. */
.sidenote::before {
  content: counter(sidenote-counter) ".";
  position: relative;
  vertical-align: baseline;
  font-size: 0.9em;
  font-weight: bold;
}
/* Counter in the main body. */
.sidenote-number::after {
  content: counter(sidenote-counter);
  vertical-align: super;
  font-size: 0.7em;
  font-weight: bold;
  margin-right: 0.5rem;
}
@media (min-width: 1400px) {
  /* Highlight the sidenote when mouse hovers on the sidenote number in body. */
  .sidenote-number:hover .sidenote {
    -webkit-backdrop-filter: blur(30px);
    backdrop-filter: blur(30px);
    background-color: #ffffff7a;
    border-radius: 5px;
    font-weight: bold;
    padding: 5px;
    box-shadow: 5px 5px 10px rgb(25, 25, 25),
                -5px -5px 10px rgb(60, 60, 60);
  }
  .dark .sidenote-number:hover .sidenote {
    background-color: rgba(0, 0, 0, 0.5);
  }
}
.dark .sidenote-number small.sidenote,
.dark .sidenote-number small.sidenote a {
  color: rgb(255, 179, 0);
}
.sidenote-number + p {
  display: inline;
}

p:has(+ .sidenote-number) {
  display: inline;
}

也遇到了一些小问题：

Error

counter 计数混乱

一开始使用 body 去做 counter-reset ，后续改为 main 去做 counter-reset 后就好，没有找到中间哪里触发了 body 的 reset，如果有了解的希望指点一二，感恩；

还有一些其他可以借鉴的 MarginNote 的实现如下，感兴趣的大家可以去看看：

• Rongbin’s Blog
• Sidenotes in Hugo | dongheenam.info

Encrypt 加密简码实践

由于博客难免会写一些只想自己看或者说，只想和朋友分享的内容，因此在之前的 hexo 中支持了加密的功能，于是在 hugo 上找替代品的时候，目前发现的都是需要外部的代码|二进制执行，或是使用 submodule，这里为了更简单一些就尝试将其改为简码的模式；

参考 Li4n0的hugo_encryptor 借助 Gpt4o 将其改为纯 html+js 的形式，由此实现利用简码对文章加密，效果如下：

但是这个方法的加密实际上是一个伪加密，存在以下的问题：

1. 一篇文章仅能加密一次，否则会使得密码出错;
2. 无法加密源文件，文章的内容仍能通过开发者模式中的源文件进行查看未加密的 html，只是无法直观的获取。

这是由于该脚本仅仅是对加载过程中的网页进行加密，但是对对应的 html 内容是没有加密的

这是由于 hugo 静态站点生成的本质，如果需要完全的加密的话，可能还是要考虑外部对生成的 html 进行处理，或者看能不能想办法干预 hugo 本身生成静态文件的过程，这里由于笔者本身对相应的技术栈还不是特别熟悉，因此暂且搁置。

这里还尝试了 Li4n0的hugo_encryptor 和 hugoArticleEncryptor 都会对我的主题样式产生严重的影响，导致无法使用，如果有需要彻底加密的还是建议去参考他们的实现；

这里分享一下笔者基于 Li4n0 将加密过程改到 shortcode 中的代码如下，：

<head>
    <!-- Other head elements -->
    <script src="https://mirrors.sustech.edu.cn/cdnjs/ajax/libs/crypto-js/3.1.9-1/crypto-js.js"></script>
</head>

{{ $_hugo_config := `{ "version": 1 }` }}
{{/*
    ## Hugo Encrypt
    ### Params:
    - `password`:
        require param
    - Simple
*/}}
{{/* DEFAULTS */}}

<div class="hugo-encryptor-container">
  <div class="hugo-encryptor-prompt">
    {{ if eq .Site.Params.hugoEncryptorLanguage "en-us" }}
      <p>Part of this article is encrypted with password:</p>
    {{ else }}
      <p>文章的部分内容被密码保护：</p>
    {{ end }}
  </div>
  <div class="hugo-encryptor-form">
    <input
      class="hugo-encryptor-input"
      placeholder='{{ if eq .Site.Params.hugoEncryptorLanguage "en-us" }}Please input the password{{ else }}请输入密码{{ end }}'
    />
    <input
      class="hugo-encryptor-button"
      type="button"
      value='{{ if eq .Site.Params.hugoEncryptorLanguage "en-us" }}Click to verify{{ else }}CLICK{{ end }}'
      onclick="_click_handler(this)"
    />
  </div>
  <div
    class="hugo-encryptor-cipher-text"
    data-password="{{ .Get 0 }}"
    style="display: none;"
  >
    <span style="display: none;">--- DON'T MODIFY THIS LINE ---</span>
    {{ .Inner }}
  </div>
</div>

<script>
    // This script should be included in your Hugo templates
// Make sure to include the crypto-js library in your HTML

function sanitizeContent(content) {
    // Remove unwanted characters (like control characters)
    return content.replace(/[\x00-\x1F\x7F]/g, '').trim(); // Remove control characters and trim whitespace
}

function encryptContent(password, content) {
    const key = CryptoJS.MD5(password).toString();
    const iv = key.substring(16); // Use the second half of the key as IV
    const paddedContent = padContent(content);
    const encrypted = CryptoJS.AES.encrypt(paddedContent, CryptoJS.enc.Utf8.parse(key), {
        iv: CryptoJS.enc.Utf8.parse(iv),
        mode: CryptoJS.mode.CBC,
        padding: CryptoJS.pad.Pkcs7
    });
    return CryptoJS.enc.Base64.stringify(encrypted.ciphertext);
}

function padContent(content) {
    const blockSize = 32; // AES block size
    const padlen = blockSize - (content.length % blockSize);
    // const padding = String.fromCharCode(padlen).repeat(padlen);
    // return content + padding;
    return content;
}

function processEncryptedBlocks() {
    const blocks = document.querySelectorAll('.hugo-encryptor-cipher-text');
    blocks.forEach(block => {
        const password = block.getAttribute('data-password');
        const content = block.innerHTML.trim(); // Trim whitespace
        const sanitizedContent = sanitizeContent(content); // Sanitize content
        const encryptedContent = encryptContent(password, sanitizedContent);
        block.innerHTML = encryptedContent;
        block.removeAttribute('data-password');
    });

    // Append the decrypt.js script
    const script = document.createElement('script');
    script.src = '/js/decrypt.js';
    document.body.appendChild(script);
}

// Call the function to process the blocks after the DOM is fully loaded
document.addEventListener('DOMContentLoaded', processEncryptedBlocks);
</script>

对应的样式设置如下

/* change the style of the encrypt button & input */
/* only encrypt once in one posts. */

.hugo-encryptor-container:has(>.hugo-encryptor-prompt) {
    border-top: 2px solid black;
    border-bottom: 2px solid black;
    /* background: rgb(0 0 0 / 20%); */
    backdrop-filter: blur(5px);
    padding: 5px;   
    margin-bottom: 10px;
}
.dark .hugo-encryptor-container:has(>.hugo-encryptor-prompt) {
    border-top: 2px solid #5cbd63;
    border-bottom: 2px solid #5cbd63;
}

.hugo-encryptor-prompt {font-weight: bold;}

input.hugo-encryptor-input {
    border: 2px solid black;
    color: var(--primary);
}

input.hugo-encryptor-button {
    border: unset;
    background: black;
    border-radius: 20px;
    padding: 0px 5px;
    box-shadow: 0px 0px 2px 2px rgb(0,0,0);
    color:azure
}

input.hugo-encryptor-button:hover {
    background-color:#5cbd63;
    transition: 0.7s;
}

input.hugo-encryptor-button:focus {
    outline-color: transparent;
    outline-style:solid;
    box-shadow: 0 0 0 4px #5cbd63;
}

input.hugo-encryptor-input:focus{
    outline-color: transparent;
    outline-style:solid;
    box-shadow: 0 0 0 1px #0e0912;
}
.dark input.hugo-encryptor-input:focus{
    box-shadow: 0 0 0 1px #5cbd63;
}

.post-single:has(.post-content .hugo-encryptor-prompt) #toc-container{
    display: none;
}

此外当你有加密的需求，记得把你的 repo 改为 Private，不然图啥呢是吧🔒；

FI

我可以不用，但是我得有啊，你说是不?

Summary

利用 hugo 主题的 render hook 的功能，修改 markdown 转换为 html 的样式，通过这种方法更改特定 Markdown 元素的渲染；

What’s Render Hook In Hugo 啥是渲染钩子

Render Hook 是 Hugo 给希望增强 Markdown 渲染功能的开发者留出的工具，通过 Render Hook 可以使开发者为各种 Markdown 元素创建自定义的渲染模版，满足不同用户对于渲染的不同需求；

具体而言，当编辑/创建如下这些特定路径的文件，其会覆盖默认的 markdown 渲染成 html 的方式，具体路径为 Render Hooks Introduction ：

layouts/
└── _default/
    └── _markup/
        ├── render-blockquote.html  # 渲染引用快
        ├── render-codeblock.html   # 渲染代码块
        ├── render-image.html       # 图片
        ├── render-link.html        # 链接
        └── render-table.html       # 表格

具体的参数和各种类型的具体文件，请在修改的时候参考对应的官方文档即可，如：codeBlock

Why ？为啥使用它呢

简单介绍 Render Hook 后，其实其优点就呼之欲出了：

• 灵活 | 可自定义 | 增强功能：可以根据自己的需求随意的更改渲染的样式，甚至嵌入 js 引入复杂功能（收起，复制等）；
• 无需对博文做任何调整，不破坏 markdown 本身的可迁移性；
• 一劳永逸，统一管理；

同时默认的样式在功能和外观上都比较基础，很多特性不被支持，如：

• 外部打开链接
• 代码块的复制和折叠
• 图片的大小限制和位置限制等

而为了支持这些特性，相比借助简码使用支持原生 markdown 的 render hook 去实现新特性，保持文章的简洁和完整性，那当然是最好不过；

Define Personal Render 定义自己的渲染

Mermaid 流程图支持

官方文档 已经给出了对应的支持方案，主要分为三步：

一、在 layouts/_default/_markup/render-codeblock-mermaid.html 中添加

<pre class="mermaid">
    {{- .Inner | htmlEscape | safeHTML }}
  </pre>
  {{ .Page.Store.Set "hasMermaid" true }}

二、在内容模版的底部添加如下内容（这里我是添加到 ``layouts/_default/single.html` 中）

{{ if .Store.Get "hasMermaid" }}
  <script type="module">
    import mermaid from 'https://cdn.jsdmirror.com/npm/mermaid/dist/mermaid.esm.min.mjs';
    // import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/+esm'
    mermaid.initialize({ 
      startOnLoad: true,
      'theme': 'dark',
     });
  </script>
  {{ end }} 

可以修改 CDN 来加速 mermaid 的加载 感谢blog.jsdmirror.com 的镜像站

三、可以在 markdown 中通过代码块的方式调用 mermaid ：

四、如果 mermaid 仍然渲染失败，或者没有开始渲染，尝试将 guessSyntax 设置为 false 如下 Mermaid doesn’t work 从零开始搭建Hugo博客：

markup:
  highlight:
    guessSyntax: true

最终应该可正常渲染 mermaid，下面是一个随机例子

从零开始搭建Hugo博客 中还有两种其他的支持 mermaid 的方式，感兴趣的也可以参考；

Image 自适应图片大小 & FancyBox 查看原图

多年图像不居中就难受症候群，对原始的图片渲染确实是十分不满意，同时一些比较大/长的图片也会很破坏整个页面的结构和阅读体验，为了避免用 html 逐个调整，因此修改图像的默认 render hook 这里感谢夜云泊 分享的十分完整的解决方案 ；

这里我针对 PaperMod 主题对夜云泊 提供的代码做了简单的改动，具体原因已不可考，依稀记得是由于原始的 markdown 中有部分用 html 呈现的图像会有一些问题：

修改后的 render-image.html 如下：

{{- $u := urls.Parse .Destination -}}
{{- $src := $u.String -}}
{{- if not $u.IsAbs -}}
  {{- $path := strings.TrimPrefix "./" $u.Path }}
  {{- with or (.PageInner.Resources.Get $path) (resources.Get $path) -}}
    {{- $src = .RelPermalink -}}
    {{- with $u.RawQuery -}}
      {{- $src = printf "%s?%s" $src . -}}
    {{- end -}}
    {{- with $u.Fragment -}}
      {{- $src = printf "%s#%s" $src . -}}
    {{- end -}}
  {{- end -}}
{{- end -}}
{{- $attributes := merge .Attributes (dict "alt" .Text "src" $src "title" (.Title | transform.HTMLEscape) "loading" "lazy") -}}
{{if .Page.Site.Params.fancybox }}
<div class="post-img-view">
  <a data-fancybox="gallery" href="{{ .Destination | safeURL }}">
    <img {{- with $attributes -}}
    {{- range $k, $v := . -}}
      {{- if $v -}}
        {{- printf " %s=%q" $k $v | safeHTMLAttr -}}
      {{- end -}}
    {{- end -}}
  {{- end -}}  class="responsive-image" src="{{ .Destination | safeURL }}" style="display: block; margin: 0 auto;"
      alt="{{ .Text }}" {{ with .Title}} title="{{ . }}" {{ end }} />
  </a>
</div>
{{else}}
<img
  {{- range $k, $v := $attributes -}}
    {{- if $v -}}
      {{- printf " %s=%q" $k $v | safeHTMLAttr -}}
    {{- end -}}
  {{- end -}} style="display: block; margin: 0 auto; " class="responsive-image">
{{- /**/ -}}
{{ end }}

<script>
  document.addEventListener("DOMContentLoaded", function() {
      var images = document.querySelectorAll(".responsive-image");
      var maxHeight = window.innerHeight / 2.5;
      images.forEach(function(image) {
          image.style.maxHeight = maxHeight + "px";
      });
  });
</script>

然后去 Hugo 配置文件 hugo.yml 中新增一项：

params:
  fancybox: true

具体的代码介绍请转向原作者 👍，最终效果如下：

开启 fancybox：

Link 默认新窗口打开网页

参考： How to open plain URL links in a new tab? - support - HUGO 实现如下 render-link.html：

<a href="{{ .Destination | safeURL }}" {{ with .Title}} title="{{ . }}" {{ end }}{{ if strings.HasPrefix
    .Destination "http" }} target="_blank" rel="noopener" {{ end }}>{{ .Text | safeHTML }}</a>

Code Block 代码折叠

由于有时会分享一些较长的代码，如果始终使代码完整呈现的话，其实页面不是那么的美观，而且也废滚轮，因此感觉折叠功能还是很必要的🔥，同时由于默认的样式怎么看都有些变扭，因此也顺便的加上标签栏来优化对应的样式。

实现代码折叠主要是如下思路：

1. 将原本的代码渲染包含在 <div class="code-content"> 中；
2. 新增同级别元素 <div class="code-title"> 用于存放标题，同时作为开关控制折叠；

接着话不多说开始实现，首先获取原本的基础实现和一些基本参数 Code block render hooks | Hugo 如下：

{{ $result := transform.HighlightCodeBlock . }}
{{ $result.Wrapped }}

该代码置于 render-codeblock.html 中，为默认的代码块渲染样式，如果需要修改特定语言的渲染，可以参考官方文档和 mermaid 的方式去处理；

接着就很简单了，通过 {{.Type}} 可以获取语言类型信息用作 title，然后通过 js 和 css 实现折叠效果和样式调整即可，最终实现效果如下：

折叠后：

具体代码如下：

<div class="code-block">
    <div class="code-title" onclick="toggleCode(this)">
        <span class="code-block-open"><ion-icon name="code-slash-outline"></ion-icon></span>
        <span>{{.Type}}</span>
    </div>
    <div class="code-content">
        {{ $result := transform.HighlightCodeBlock . }}
        {{ $result.Wrapped }}
    </div>
</div>

<script>
function toggleCode(element) {
    const codeContent = element.nextElementSibling;
    if (codeContent.style.display === "none" || codeContent.style.display === "") {
        codeContent.style.display = "block"; // Show the code block
        codeContent.parentNode.classList.remove("code-has-hidden-child");
    } else {
        codeContent.style.display = "none"; // Hide the code block
        codeContent.parentNode.classList.add("code-has-hidden-child");

    }
}
</script>

.code-block {
    background: var(--code-block-bg);
    box-shadow: 0px 4px 30px rgba(0, 0, 0, 0.5);
    border-radius: 8px;
    position: relative;
    /* padding: 2px; */
    margin: 8px 0px;
}

.code-title {
    display: flex;
    align-items: center;
    justify-content: space-between;
    margin: 10px;
    border-bottom: 1px solid rgba(255, 255, 255, 0.602);
    cursor: pointer;

}

.code-title span {
    letter-spacing: 1.57px;
    color: rgb(212 212 212);
    /* width: 90%; */
    /* align-items: center; */
    font-size: 1rem;
    padding: 5px;
    padding-left: 10px;
    text-transform: capitalize;
}

.code-has-hidden-child {
    border: 1px solid salmon;
}

此外这里也将 copy-code 按钮挪到了标题栏上，主要是修改 copy 的样式和渲染位置 可以参考 [Feat] update default code style · AikenH 剩余部分的修改，感兴趣的也可以点个 star，感谢。

Alert-Blockquote 特殊引用块

在之前简码部分的博客已经介绍了一些特殊的引用块样式和实现，可以根据官网 Blockquote render hooks | Hugo 将其改为自己的默认引用块即可，即可 markdown 中按照如下方式引用实现：

> [!{alert-keywork}]
> {alert-content}

这是本博客中部分样式展示：

Note 样式：

Note

test note block’s style.

important 样式

Important

重要内容

Error 样式

Error

Error

该部分可以发现大家都参考了 hugo-notice ，而本博客则是在其他博主分享 感谢 tom’s blog 感谢绅士喵 的样式之上根据本人的 Obsidian 调整了一下样式和默认值，具体实现如下：

{{ $alertTypes := dict
  "note" "<path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path>"
  "tip" "<path d=\"M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z\"></path>"
  "important" "<path d=\"M0 1.75C0 .784.784 0 1.75 0h12.5C15.216 0 16 .784 16 1.75v9.5A1.75 1.75 0 0 1 14.25 13H8.06l-2.573 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25Zm1.75-.25a.25.25 0 0 0-.25.25v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25Zm7 2.25v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 9a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path>"
  "warning" "<path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path>"
  "caution" "<path d=\"M4.47.22A.749.749 0 0 1 5 0h6c.199 0 .389.079.53.22l4.25 4.25c.141.14.22.331.22.53v6a.749.749 0 0 1-.22.53l-4.25 4.25A.749.749 0 0 1 11 16H5a.749.749 0 0 1-.53-.22L.22 11.53A.749.749 0 0 1 0 11V5c0-.199.079-.389.22-.53Zm.84 1.28L1.5 5.31v5.38l3.81 3.81h5.38l3.81-3.81V5.31L10.69 1.5ZM8 4a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path>"
  "error" "<path d=\"M4.47.22A.749.749 0 0 1 5 0h6c.199 0 .389.079.53.22l4.25 4.25c.141.14.22.331.22.53v6a.749.749 0 0 1-.22.53l-4.25 4.25A.749.749 0 0 1 11 16H5a.749.749 0 0 1-.53-.22L.22 11.53A.749.749 0 0 1 0 11V5c0-.199.079-.389.22-.53Zm.84 1.28L1.5 5.31v5.38l3.81 3.81h5.38l3.81-3.81V5.31L10.69 1.5ZM8 4a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path>"
}}

{{
  $default := "<path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path>"
}}
  
  
{{ if eq .Type "alert" }}
<blockquote class="alert-blockquote alert-{{ .AlertType }}">
  <p class="alert-heading">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
      {{- $alertType := index $alertTypes .AlertType | default $default }}
      {{ $alertType | safeHTML }}
    </svg>
    <span>{{ or (i18n .AlertType) (title .AlertType) }}</span>
  </p>
  {{ .Text | safeHTML }}
</blockquote>
{{ else }}
<blockquote>
  {{ .Text | safeHTML }}
</blockquote>
{{ end }}

.alert-blockquote {
  --title-color: #fff;
  --content-color: inherit;
  padding: 18px 18px 10px 18px !important;
  line-height: 24px;
  margin: 1rem 0;
  border-radius: 4px;
  color: var(--content-color);
  /* border-left: none !important; */
  /* border: 1px solid black; */
}

.dark .alert-blockquote *,
.alert-blockquote * {
  color: var(--content-color) !important;
}

.post-content blockquote%3Ep>p{
    padding: unset;
}

.alert-blockquote .alert-heading {
  margin: -18px -18px 12px;
  padding: 10px 18px;
  border-radius: 4px 4px 0 0;
  font-weight: 600;
  color: var(--title-color) !important;
  display: flex;
  align-items: center;
}

.alert-blockquote .alert-heading svg {
  width: 1em !important;
  height: 1em !important;
  margin-right: 0.5rem !important;
  fill: currentColor !important;
}

.alert-blockquote p:last-child {
  margin-bottom: 0;
}

/* Light theme */
/* default */
.alert-blockquote {
  border-top:unset;
  /* border: 1px solid #166dd0; */
  /* --title-background-color: rgba(221, 233, 244, 0.631); */
  --content-background-color: rgba(221, 233, 244, 0.602);
}
.alert-blockquote > .alert-heading {
  /* border-bottom: 1px dashed #166dd07c; */
  color: #0969da !important;
}

/* note */
.alert-blockquote.alert-note {
  /* border: 1px solid #166dd0; */
  /* border-left-color: #0969da !important; */
  /* --title-background-color: rgba(221, 233, 244, 0.631); */
  --content-background-color: rgba(221, 233, 244, 0.602);
}
.alert-blockquote.alert-note .alert-heading {
  color: #0969da !important;
}

/* tip */
.alert-blockquote.alert-tip {
  /* border: 1px solid #1a7f37; */
  /* --title-background-color: rgb(173,193,182); */
  --content-background-color: rgba(222, 240, 223, 0.7);
}
.alert-blockquote.alert-tip .alert-heading {
  color: #1a7f37 !important;
  /* border-bottom: 1px dashed #1a7f37; */
}

/* important */
.alert-blockquote.alert-important {
  /* border: 1px solid #8250df; */
  /* border-left-color: #8250df !important; */
  /* --title-background-color: #6843ae7c; */
  --content-background-color: rgba(235, 227, 245, 0.9);
}

.alert-blockquote.alert-important .alert-heading {
  color: #8250df !important;
  /* border-bottom: 1px dashed #8250df; */
}

/* warning */
.alert-blockquote.alert-warning {
  /* border: 1px solid #9a6700; */
  /* border-left-color: #9a6700 !important; */
  /* --title-background-color: rgb(232, 198, 140); */
  --content-background-color: rgba(243, 232, 222);
}
.alert-blockquote.alert-warning .alert-heading {
  color: #9a6700 !important;
  /* border-bottom: 1px dashed #9a6700; */
}

/* caution */
.alert-blockquote.alert-error,
.alert-blockquote.alert-caution {
  /* border: 1px solid #cf222e; */
  /* border-left-color: #cf222e !important; */
  /* --title-background-color: rgb(244, 224, 223,0.5); */
  --content-background-color: rgba(243, 207, 205, 0.9);
}
.alert-blockquote.alert-error .alert-heading,
.alert-blockquote.alert-caution .alert-heading {
  color: #cf222e !important;
  /* border-bottom: 1px dashed #cf222e; */
}

/* Dark theme */
.dark .alert-blockquote {
  border-top:unset;
  /* --content-color: #d0d7dd; */
  /* --title-background-color: #5151527c; */
  --content-background-color: rgba(22, 37, 50, 0.8);
}

.dark .alert-blockquote .alert-heading {
  color: #58a6ff !important;
}

.dark .alert-blockquote.alert-note {
  /* --title-background-color: #58a6ff7c; */
  --content-background-color: rgba(22, 37, 50, 0.8);
}
.dark .alert-blockquote.alert-note .alert-heading {
  color: #58a6ff !important;
}

.dark .alert-blockquote.alert-tip {
  /* --title-background-color: #82bd8a7c; */
  --content-background-color: rgba(55, 84, 56, 0.7);
}
.dark .alert-blockquote.alert-tip .alert-heading {
  color: #3fb950 !important;
}

.dark .alert-blockquote.alert-important {
  /* --title-background-color: #9173c57c; */
  --content-background-color: rgba(46, 32, 62, 0.9);
}
.dark .alert-blockquote.alert-important .alert-heading {
  color: #8d62d8 !important;
}

.dark .alert-blockquote.alert-warning {
  /* --title-background-color: #d1b068a0; */
  --content-background-color: rgb(84, 68, 55);
}
.dark .alert-blockquote.alert-warning .alert-heading {
  color: #d1b271 !important;
}

.dark .alert-blockquote.alert-error,
.dark .alert-blockquote.alert-caution {
  /* --title-background-color: #c94a43; */
  --content-background-color: rgba(108, 57, 54, 0.9);
}
.dark .alert-blockquote.alert-error .alert-heading,
.dark .alert-blockquote.alert-caution .alert-heading {
  color: #ff9791 !important;
}

.alert-blockquote .alert-heading {
  background: var(--title-background-color);
}

.alert-blockquote {
  background: var(--content-background-color);
}


blockquote:not(.alert-blockquote){
  color: #a02222c2;
  border-top: 2px solid  #9c1e1ec2;
  font-size: 0.9rem;
  font-style: italic;
}

源码也都已经在 Github 中分享。

Change Default Renders’ Style 改变一些默认样式

除了上述 markdown 基本单元的渲染调整，表格的样式也不是特别美观，但是由于表格本身的 html 模版已经不在需要调整，因此这里仅对其 css 样式做调整。

Tables 表格样式调整

默认的表格本身主要存在以下的一些问题：

• 非全宽&不居中：这里考虑直接调整为全宽；
• 样式单调：可以按照需求调整为三线表或者调整一下标题栏等；
• 可以添加 Hover 效果来优化交互；

这里通过将 display 调整为 table 来支持全宽，同时通过 overflow 和 wordbreak 等属性来自适应格子宽度避免溢出 Responsive tables in markdown - support - HUGO html - Horizontal scroll on overflow of table - Stack Overflow ；

样式代码如下，编写的时候要避免 table 属性对其他元素的影响，特别是代码块，因此需要用 not 属性做一些排除：

/* make the table fully wide  & style */
.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight){
  display: table;
  background-color: transparent;
  border-radius: 6px;
  border: 1px solid black;
  outline: 2px solid black;
  overflow-x: auto;
  table-layout: fixed;
  word-break: break-all;
}
/* responsive ref */
/* ref: https://discourse.gohugo.io/t/responsive-tables-in-markdown/10639/8 */
/* ref: https://stackoverflow.com/questions/19794211/horizontal-scroll-on-overflow-of-table/62451601#62451601 */

.dark .post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight){
  outline: 2px solid rgb(54, 156, 95);
}

.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) thead{
  background-color: #545d7b8a;
}

.dark .post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) thead{
  background-color: rgb(62, 62, 62);
}

.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) td,
.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) tr,
.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) th{
  border-bottom: unset;
  border: 1px solid black,
}

.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) td:hover,
.post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) td:focus{
  background-color: rgba(170, 217, 248, 0.8);
  /* transform: scale(1.1); */
  /* border: 2px solid black; */
}

.dark .post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) td:hover,
.dark .post-content table:not(.lntable .highlighttable,.highlight table,.gist .highlight) td:focus{
  background-color: rgb(0, 0, 0, 0.7);
  /* transform: scale(1.1); */
  /* border: 2px solid black; */
}

Fi

有错误欢迎指正和交流，感兴趣的也欢迎去 github 上点个 star，不胜感激；

Summary

除了基础的样式和功能，本篇介绍一些会改变原本页面结构的样式调整，或是支持一些除了 markdown 渲染外的一些额外的功能。

Assign Unique ClassName for Pages 给页面注册单独的类名

在进行一些比较复杂的样式设置之前，为了避免样式会影响到预期之外的页面，因此通过 hugo 中的 go-template 语法判断页面类型后，通过修改原有模版，给搜索，时间线，profile 等页面注册一个单独的类名。

修改 themes/PaperMod/layouts/_default/baseof.html，将其中对应部分替换为如下内容：

<body class="
{{- if (or (ne .Kind `page` ) (eq .Layout `archives`) (eq .Layout `search`)) -}}
{{- print "list" -}}
{{- end -}}
{{- if eq .Type `linklog` -}}
{{- print "-linklog-" -}}
{{- end -}}
{{- if eq .Layout `search` -}}
{{- print " search" -}}
{{- end -}}
{{- if (eq .Layout `archives`) -}}
{{- print "-archive" -}}
{{- end -}}
{{- if .IsHome -}}
{{- print "-profile" -}}
{{- end -}}
{{- if not .IsHome | and .Title | and .Description }}
{{- print "post" -}}
{{- end -}}
{{- if eq site.Params.defaultTheme `dark` -}}
{{- print " dark" }}
{{- end -}}
" id="top">

替换即可通过如下的 class 对页面进行索引：

在上述页面选择器之后添加 .dark 即可定位对应的深色主题样式，这部分可以按照自己的习惯去随便修改即可。

Background Image 设置背景

可以参考笔者的设置，给背景添加一层简单的遮罩，具体代码如下：

#top,
.list,
.list-profile {
  background-image: url(/cover/cover1.jpeg);
  background-size: cover;
  background-repeat: no-repeat;
  background-attachment: fixed;
}

#top.dark,
.list.dark,
.list-profile.dark {
  background-image: url(/cover/cover0.jpeg);
}

#top::after,
.list::after,
.list-profile::after {
  background: inherit;
  filter: blur(5px);
  content: "";
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  min-height: 100%;
  background-size: cover;
  z-index: -1;
  background-attachment: fixed;
}

如果后续由于背景图像的色块比较杂乱，会导致文本模糊不清，可以给文本区域添加底色和对应的毛玻璃特效如下：

.list-archive .main,
.list-linklog-post .main,
#top article.post-single {
  -webkit-backdrop-filter: blur(30px);
  backdrop-filter: blur(30px);
  background-color: rgba(104, 152, 191, 0.45);
}

完成了基础设置之后就可以开始对页面结构做调整了，接下来主要介绍一下侧边目录、侧边导航栏，以及新建分享页面三个部分的页面调整和页面新增。

Support LinkLog Page 添加博文收藏界面

受到 Xiaofei Ge Linklog | Xiaofei Ge 的启发，确实希望能有一个页面来专门存放一些自己喜欢或者希望存档的文章，通过直接跳转或者表明转载（防止原博挂掉）的方式进行收藏，避免和自己的文章混在一起。

参考 Using Hugo as a redirect service - Dan North & Associates Limited ，设计对应收藏博文的 markdown 元信息应该如下：

title: 「特别篇」在关闭光猫、路由器IPv6防火墙后可能遇到的安全问题
url: "www.bilibili.com/opus/825167559504429056"
date: 2023-11-05
draft: false
type: "linklog"
author: "ce-12"

通过 type 定义页面类型，日期存储我们收藏的时间，url 则是核心的跳转页面，还有一些作者和 title 的展示信息，并在 archive 按照日期展示每一条链接。

因此借助 GPT 快速实现了一版，并调整了一下搜索代码，使得搜索到 Linklog 文章的时候，会有符号&样式去标识其为外部跳转的博文。

Add LinkLog Page 添加博文收藏界面

上述说到希望以 archive 界面的形式来收藏博文，通过简单的标题和简介来记录对应的博文，以及存放博文的时间，因此参考 /layouts/_default/archives.html 创建 layouts/linklog/list.html 如下，定义 LinkLog 的界面.

{{- define "main" }}

<header class="page-header">
  <h1>{{ .Title }}</h1>
  {{- if .Description }}
  <div class="post-description">{{ .Description }}</div>
  {{- end }}
</header>

{{- $linklogPages := where site.RegularPages "Type" "linklog" }} <!-- Adjust this if necessary -->

{{- range $linklogPages.GroupByPublishDate "2006" }}
{{- if ne .Key "0001" }}
<div class="archive-year">
  {{- $year := replace .Key "0001" "" }}
  <h2 class="archive-year-header" id="{{ $year }}">
    <a class="archive-header-link" href="#{{ $year }}">
      {{- $year -}}
    </a>
    <sup class="archive-count">&nbsp;{{ len .Pages }}</sup>
  </h2>
  {{- range .Pages.GroupByDate "January" }}
  <div class="archive-month">
    <h3 class="archive-month-header" id="{{ $year }}-{{ .Key }}">
      <a class="archive-header-link" href="#{{ $year }}-{{ .Key }}">
        {{- .Key -}}
      </a>
      <sup class="archive-count">&nbsp;{{ len .Pages }}</sup>
    </h3>
    <div class="archive-posts">
      {{- range .Pages }}
      <div class="archive-entry">
        <h3 class="archive-entry-title">
          {{- if .Params.url}}
            <span class="jump-icon"><ion-icon name="link-outline"></ion-icon></span>
            <a href="https://{{ .Params.url }}" target="_blank" rel="noopener noreferrer">{{ .Title }}</a> <!-- Prepend the protocol -->
          {{- else}}
            <a href="{{ .Permalink }}" >转) {{ .Title }}</a> <!-- Prepend the protocol -->
          {{- end}}
        </h3>
        {{- if .Params.description }} <!-- Check if description exists -->
        <div class="archive-entry-description">
          {{ .Params.description }} <!-- Display the description -->
        </div>
        {{- end }}
        <div class="archive-meta">
          {{- partial "post_meta.html" . -}} <!-- Optional: Include meta info -->
        </div>
      </div>
      {{- end }}
    </div>
  </div>
  {{- end }}
</div>
{{- end }}
{{- end }}

{{- end }}{{/* end main */}}