Rocky‘s Blog - Doc

CMake

Suchaharcan — Thu, 15 Oct 2026 00:00:00 +0000

定期更新该博客

总结CMake常用命令之前，先明确为什么要使用CMake?

C++ 源码编译链接的原理，在代码膨胀到多文件，项目复杂度，代码文件管理难度，跨平台等问题，需要一个更智能更现代的构建工具。因为以上的问题和缺陷，所以需要CMake;

rmbuild

cmake ..
cmake --build .
cmake --build . -j 9 # 并行构建

Markdown

Suchaharcan — Thu, 15 Oct 2026 00:00:00 +0000

`同步翻译整理 Markdown 官方和其他优秀归纳文章即可

参考 Ametrine主题开发者本人网站，博客源码参照而主题内置的样例博客可作为重要参考

对自身的要求仅是熟练使用，无迁移晋升的空间

Markdown

Text can be bold, italic, ~~strikethrough~~, and ~~all at the same time~~.
Link to another page^[1].

标题

There should be whitespace between paragraphs^[2].

| 段落 |

要创建段落，请使用空行分隔一行或多行文本。

换行

借助 Alfred 的快捷文本 mkbr进行快速触发 <br/>

“Original content is original only for a few seconds before getting old”

Rule #21 of the internet 加粗字体

**

引用块 ✅

嵌套引用块 要创建引用块，请在段落前添加 >。

引用块可以嵌套。在要嵌套的段落前添加 >>。

包含其他元素的引用块

引用块可以包含其他 Markdown 格式的元素。并非所有元素都可以使用——你需要进行实验以查看哪些元素有效。

Useful information that users should know, even when skimming content.

Helpful advice for doing things better or more easily.

Key information users need to know to achieve their goal.

Urgent info that needs immediate user attention to avoid problems.

Advises about risks or negative outcomes of certain actions.

有序列表

添加带有数字和句号的行项目。数字不必按数字顺序排列，但列表应从数字一开头。

无序列表

在行项目前添加破折号 (-)、星号 (*) 或加号 (+)。
缩进一个或多个项目以创建嵌套列表。

为了兼容性，请不要在同一列表中混合和匹配分隔符——选择一个并坚持使用它。

第一项
第二项
第三项
- 缩进项
- 缩进项
第四项
Item 1
Item 2
- Item 2.1
- Item 2.2
Item 3
Item 4

Perform step #1
Proceed to step #2
Conclude with step #3

Milk
Eggs
Flour
Coffee
Combustible lemons

要在列表中添加另一个元素，同时保留列表的连续性，请将元素缩进四个空格或一个制表符，如下例所示。

This is the first list item.
Here’s the second list item.

A blockquote would look great below the second list item.
And here’s the third list item.

代码

Character	Show	Quotes
Derpy Hooves	My Little Pony	I just don’t know what went wrong
Gir	Invader ZIM	GUESS WHO MADE WAAAAFFLES?!!
WALL-E	WALL-E	Ooooo 0.0
Taco	Inanimate Insanity	SOUR CREAM!

let highlight = true;

10pre mark {
12  display: block;
13  color: currentcolor;
14}
15pre table td:nth-of-type(1) {
17  color: #6b6b6b;
18  font-style: italic;
19}

水平线 ✅

单独的一行上使用三个或更多星号 (***)、破折号 (—) 或下划线 (___)^[3]。

Components - 组件

Ametrine provides a few useful components that simplify some tasks. They can be used on all pages.

As of version 0.21.0, Zola supports GitHub flavored alerts natively, without this component. It can be enabled by adding the following to zola.toml:
[markdown]
github_alerts = true

Required variables are:

icon: Icon from phosphoricons.com that will be used in the alert.
title: Title of the alert.

Optional variables are:

color: Color that the alert should be colored into. Available colors are: red, orange, yellow, green, blue, and purple.

Hi, I’m a fake custom alert.

I’m a list with an inline link.

链接 ⭐

必须是英文引号填充悬浮提示
添加标题您可以选择为链接添加标题。当用户将鼠标悬停在链接上时，它将显示为工具提示。要添加标题，请在 URL 后用引号将其括起来。

eg: Duck Duck Go.

[Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").
[Spotify](https://open.spotify.com/playlist/7zbBvAvpb9NJfkO0e7lJx3)

Images and Videos

By default images and videos come with some generic styling, such as rounded corners and shadow. To fine-tune these, you can use components with different argument combinations.

Available variables are:

url: URL to an image.
url_min: URL to compressed version of an image, original can be opened by clicking on the image.
alt: Alt text, same as if the text were inside square brackets in Markdown.
full: Forces image to be full-width.
start: Float image to the start of paragraph and scale it down.
end: Float image to the end of paragraph and scale it down.
pixels: Uses nearest neighbor algorithm for scaling, useful for keeping pixel-art sharp.
has_alpha: Removes rounded corners and shadow, useful for images with transparency.
drop_shadow: Uses drop shadow instead of box shadow, useful for images with transparency.
no_hover: Removes zoom on hover. 悬停取消缩放
spoiler: Blurs image until hovered over/pressed on, useful for plot rich game screenshots. 模糊图像，直到悬停/点击适用内容丰富敏感的内容
spoiler with solid: Ditto, but makes the image completely hidden.

{{ <image src="graph.png" alt="This is an image" class="no-hover"/> }}

Image with an alt text and without zoom on hover

Image with compressed version, an alt text, and without zoom on hover

Image with an alt text, hidden behind a spoiler

Alternatively, you can append the following URL anchors. It can be more handy in some cases, e.g. such images will render normally in any Markdown editor, opposed to the Zola components.

#full: Forces image to be full-width.
#start: Float image to the start of paragraph and scale it down.
#end: Float image to the end of paragraph and scale it down.
#pixels: Uses nearest neighbor algorithm for scaling, useful for keeping pixel-art sharp.
#has-alpha: Removes rounded corners and shadow, useful for images with transparency.
#drop-shadow: Uses drop shadow instead of box shadow, useful for images with transparency.
#no-hover: Removes zoom on hover.
#spoiler: Blurs image until hovered over/pressed on, useful for plot rich game screenshots.
#spoiler with #solid: Ditto, but makes the image completely hidden.

Full-width image with an alt text, pixel-art rendering, drop shadow, and with no rounded corners and zoom on hover

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim aeque doleamus animo, cum corpore dolemus, fieri tamen permagna accessio potest, si aliquod aeternum et infinitum impendere malum nobis opinemur.

For videos it’s all the same except for a few differences: no_hover and url_min variables are not available.

Additionally, the following attributes can be set:

autoplay: Start playing the video automatically.
controls: Display video controls such as volume control, seeking and pause/resume.
loop: Play the video again once it ends.
muted: Turn off the audio by default.
playsinline: Prevent the video from playing in fullscreen by default (depends on the browser).

{{ <video sources={["video.webm"]} alt="This is a video" controls={true}/> }}

Duckling preening

CRT

Alright, this one doesn’t simplify anything, it just puts ASCII art into a CRT-like box.

As this element is intended to be purely decorative (e.g. for displaying ASCII art), it is hidden from screen readers unless a label is supplied. Ensure that no vital content is wrapped in it.

{% <crt label="ASCII illustration of public library halls."> %}
-> ASCII art <-
{% </crt> %}


---

|.'', Public_Library_Halls ,''.|
|.'.'', ,''.'.|
|.'.'.'', ,''.'.'.|
|.'.'.'.'', ,''.'.'.'.|
|.'.'.'.'.| |.'.'.'.'.|
|.'.'.'.'.|===; ;===|.'.'.'.'.|
|.'.'.'.'.|:::|', ,'|:::|.'.'.'.'.|
|.'.'.'.'.|---|'.|, _______ ,|.'|---|.'.'.'.'.|
|.'.'.'.'.|:::|'.|'|???????|'|.'|:::|.'.'.'.'.|
|,',',',',|---|',|'|???????|'|,'|---|,',',',',|
|.'.'.'.'.|:::|'.|'|???????|'|.'|:::|.'.'.'.'.|
|.'.'.'.'.|---|',' /%%%\ ','|---|.'.'.'.'.|
|.'.'.'.'.|===:' /%%%%%\ ':===|.'.'.'.'.|
|.'.'.'.'.|%%%%%%%%%%%%%%%%%%%%%%%%%|.'.'.'.'.|
|.'.'.'.',' /%%%%%%%%%\ ','.'.'.'.|
|.'.'.',' /%%%%%%%%%%%\ ','.'.'.|
|.'.',' /%%%%%%%%%%%%%\ ','.'.|
|.',' /%%%%%%%%%%%%%%%\ ','.|
|;________****/%%%%%Spicer%%%%%%\_****_______;|

Alternatively, if you have syntax highlighting enabled and you need to preserve whitespace, you can use a code block with crt=true added right after three backticks.

The downside of this approach is that it will keep the ASCII art accessible to screen readers, which is bad for accessebility. Whitespace issue should hopefully be fixed with the release of Zola 0.23.0. See #116.

```crt=true
  /\
 /  \
/____\
```

  /\
 /  \
/____\

Audio

Places a useless audio button with a funny hover animation. Needs extra.audio_button to be enabled on page, section, or config level for it to work.

{{ <audio name="Party!" url="party-horn.mp3"/> }}

Hi everyone! You know what I like doing? That’s right, throwing ! Actually I don’t I just wanted to show off audio button.

YouTube

Allows to embed a YouTube video using youtube-nocookie.

Available variables are:

autoplay: Whether the video should autoplay.
start: On which second video should start.

{{ <youtube id="0Da8ZhKcNKQ"/> }}

Vimeo

Allows to embed a Vimeo video.

Available variables are:

autoplay: Whether the video should autoplay.

{{ <vimeo id="869483483"/> }}

BiliBili

[!NOTE] B站版本的视频调用方式我要仿写实现

Overflow Auto

Sometimes, an element gets too wide, and it’s not possible to make it adaptive in any sensible way (think tables), this is when this component comes in.

{% <overflow_auto> %}
Table (for example)
{% </overflow_auto> %}

Accepts either of the two optional arguments:

overshoot: Adds a vertical overshoot, to make the cutoff visually nicer.
overshoot_row: Ditto, but horizontal.

{% <overflow_auto overshoot_row={true}> %}
| #   | Song                          | Artist        | Duration | Popularity | Genres | Year | Added      |
| --- | ----------------------------- | ------------- | -------- | ---------- | ------ | ---- | ---------- |
| 1   | Good Morning                  | gifting guide | 03:22    | 2          |        | 2025 | 2026-01-30 |
| 2   | On Little Cat Feet            | Nightmargin   | 02:35    | 46         |        | 2016 | 2025-12-21 |
| 3   | Take Responsibility (Hear Me) | Koa           | 03:25    | 11         |        | 2024 | 2025-12-21 |
{% </overflow_auto> %}

#	Song	Artist	Duration	Popularity	Year	Added
1	Good Morning	gifting guide	03:22	2	2025	2026-01-30
2	On Little Cat Feet	Nightmargin	02:35	46	2016	2025-12-21
3	Take Responsibility (Hear Me)	Koa	03:25	11	2024	2025-12-21

Description List

<dl>
  <dt>Something</dt>
  <dd>And its description</dd>
</dl>

Name: Godzilla
Born: 1952
Birthplace: Japan
Color: Green

Form Input

<input type="checkbox" /> <label>Checkbox</label>

Milk
Eggs
Flour
Coffee
Combustible lemons

With switch class:

<input class="switch" type="checkbox" /> <label>Checkbox</label>

Milk
Eggs
Flour
Coffee
Combustible lemons

With switch and big classes:

<input class="switch big" type="checkbox" /> <label>Checkbox</label>

Milk
Eggs
Flour
Coffee
Combustible lemons

With radio type:

<input type="radio" name="test" /> <label>Radio</label>

Milk
Eggs
Flour
Coffee
Combustible lemons

With color type:

<label>Color:</label> <input type="color" value="#000000" />

Color:

Disabled:

With range type:

<input type="range" max="100" value="33" />

Figure Captions

<figure>
  -> Whatever content <-
  <figcaption>Caption of content above</figcaption>
</figure>

The Office where Stanley works, it has yellow floor and beige walls

Accordion

<details>
  <summary>Accordion title</summary>
  -> Contents here <-
</details>

Reveal accordion

Get it? I know, it’s an awful pun.

Side Comment

<small>Small, cute text that doesn't catch attention.</small>

Small, cute text that doesn’t catch attention.

Abbreviation

<abbr title="American Standard Code for Information Interchange">ASCII</abbr>

The ASCII art is awesome!

Aside

<aside>-> Contents here <-</aside>

A quill is a writing tool made from a moulted flight feather (preferably a primary wing-feather) of a large bird. Quills were used for writing with ink before the invention of the dip pen, the metal-nibbed pen, the fountain pen, and, eventually, the ballpoint pen.

As with the earlier reed pen (and later dip pen), a quill has no internal ink reservoir and therefore needs to periodically be dipped into an inkwell during writing. The hand-cut goose quill is rarely used as a calligraphy tool anymore because many papers are now derived from wood pulp and would quickly wear a quill down. However it is still the tool of choice for a few scribes who have noted that quills provide an unmatched sharp stroke as well as greater flexibility than a steel pen.

Keyboard Input

<kbd>⌘ Command</kbd>.

To switch the keyboard layout, press ⌘ Super + Space.

Mark Text

<mark>Marked text</mark>

You know what? I’m gonna say some very important stuff, so important that even bold is not enough.

Deleted and Inserted Text

<del>Something deleted</del> <ins>Something added</ins>

~~Text deleted~~ Text added

Progress Indicator

<progress></progress> <progress value="33" max="100"></progress>

Sample Output

<samp>Sample Output</samp>

Sample Output

Inline Quotation

<q>Someone said something</q>

Blah blah Inline Quote hmm.

Unarticulated Annotation

<u>Gmarrar mitsakes</u>

Yeet the sus drip while vibing with the TikTok fam on a cap-free boomerang.

Titles

<strong class="title">Title-Looking Text</strong>

Title-Looking Text

External Links

<a class="external" href="https://example.org">External link</a>

Link to site

Spoilers

<span class="spoiler">Some spoiler</span>

You know, Ametrines are very pretty. I know, crazy.

With solid class:

<span class="spoiler solid">Some spoiler</span>

You know, Ametrines are very pretty. I know, crazy.

Buttons

<div class="buttons">
  <a href="#top">Go to Top</a>
  <a class="suggested external" href="https://example.org">Example</a>
</div>

Go to Top Example

With centered and big classes:

<div class="buttons centered big">
  <button class="suggested">Do Something…</button>
</div>

Standalone:

<button class="suggested">Do Something…</button>
<a class="button external" href="https://example.org">Example</a>

Example

Disabled:

<button disabled class="suggested">Do Something…</button>
<a aria-disabled="true" class="button external" href="https://example.org"
  >Example</a
>

Example

Accent Color

For demo purposes only, usually it should be changed from the config file.

hsl(, , )

下载指定路径中的文件

例如当前博客文件夹中的playlist.csv

若图片文件能索引到，可以更好的显示
<a id="download-csv" class="card" href="playlist.csv"> playlist.csv • 9.1 kB</a>

URL 和电子邮件地址

Spotify

要快速将 URL 或电子邮件地址变成链接，请用尖括号将其括起来^[4]。

http://markdownguide.cn fake@example.com

呈现的输出如下所示

http://markdownguide.cn

格式化链接 ⭐✅

[!WARNING] > [!WARNING] 警告要强调链接，请在方括号和圆括号前后添加星号。要将链接表示为代码，请在方括号中添加反引号。

引用式链接

⚠️ 文内引用跨文引用，找更直观的理解

引用式链接是一种特殊的链接，它使 URL 在 Markdown 中更易于显示和阅读。引用式链接由两部分构成：一部分与文本保持一致，另一部分存储在文件中的其他位置，以保持文本易于阅读。

图像^[5]

添加一个感叹号 (!)，后跟方括号中的备用文本，以及括号中图片资源的路径或 URL。您可以在路径或 URL 后添加引号中的标题（可选）。 ![图片名称](图片URL "图片悬浮信息")
路径是相对于该博客路径为基础，相对于图片的位置，若图片和博客为同一路径，直接书写图片名称即可
推荐png格式

标题 ID \

许多 Markdown 处理器支持标题的自定义 ID——一些 Markdown 处理器会自动添加它们。添加自定义 ID 允许您直接链接到标题并使用 CSS 修改它们。要添加自定义标题 ID，请在与标题同行的花括号中括起自定义 ID。

My Great Heading \

HTML 如下所示

My Great Heading

链接到标题 ID 您可以通过创建带有数字符号 (#) 和自定义标题 ID 的标准链接来链接到文件中带有自定义 ID 的标题。这些通常称为锚链接。

Markdown HTML 呈现的输出标题 ID 标题 ID

标题 ID 其他网站可以通过将自定义标题 ID 添加到网页的完整 URL 来链接到标题（例如，标题 ID）。

UML等图

前置条件: 项目中需要引入指定的js文件实现渲染转换，后续再引入该功能

Footnote (link) ↩
Footnote ↩
https://genius.com/37573135 ↩
https://genius.com/29300699 ↩
Update: between first revision of this post and the time I write this at we played it again after such a ↩

Zola

Suchaharcan — Thu, 15 Oct 2026 00:00:00 +0000

本文受众：Zola博客引擎， ametrine博客主题，复现本博客网站的爱好者，以及 ¯\(°_o)/¯ me

单独说明，若是我个人针对ametrine博客主题添加的网站特写会单独说明
tldr： 直接去主题开发者或你熟知的 github.io 参考 workflows中的部署yml文件进行本地部署复现
然后根据文档和 AI 进行逐行熟悉源项目再魔改成自己的

Blog-md 标签头

颜色

色相（Hue）‌：颜色在色轮上的位置，范围 0–360 度。0 是红色、120 是绿色、240 是蓝色。
饱和度（Saturation）‌：颜色的鲜艳程度，0% 是灰色，100% 是最鲜艳的纯色。
亮度（Lightness）‌：颜色的明暗程度，0% 是黑色，100% 是白色。‌‌

可借助Snipaste-截图贴图中的取色器获取到RGB值，在RGB转HSL在线网站转换即可

accent_color = ["red", "blue", "orange","green"] # 懒惰写法
accent_color = ["hsl(123, 33%, 60%)", "hsl(27.567572, 87%, 67%)"] # 更符合人类感知

hsl(123, 86%, 33%) # 柔和草绿

# Has several modes:
# - Use one of the presets (applies to both light and dark modes):
#   accent_color = "<red, orange, yellow, green, blue, purple>"
# - Use a single HSL color for both light and dark modes:
#   accent_color = "hsl(270, 50%, 60%)"
# - Use separate colors for light and dark modes (it's possible to mix both
# presets and HSL colors):
#   Presets:    accent_color = ["red", "blue"]
#   Preset + HSL:   accent_color = ["red", "hsl(270, 50%, 60%)"]
#   HSLs: accent_color = ["hsl(270, 50%, 60%)", "hsl(27.567572, 87%, 67%)"]
#
# Custom colors must be in HSL format. You can also define your own color

RSS/Atom订阅

updated = 2026-10-15
date = 2026-10-15 # 该字段必须要有的

归类

优先使用现有归类，除非后续博客产出过多，否则不单独新增归类

categories = ["Doc","Tracking"] # 需要持续迭代更新的帮助文档

字体字号

全局字体位置：sass/fonts.scss (line 5)

:root {
  --font-sans-serif: "Golos Text";
  --font-monospace: "Commit Mono";
}

主题的 body 直接消费它（themes/ametrine/sass/citrine/sass/base/_base.scss:33）：

body {
  font-family: var(--font-sans-serif), var(--font-system-ui), var(--font-emoji);
}

所以改 –font-sans-serif 就能改全站默认正文/UI 字体；代码块仍走 –font-monospace。如果换成新字体，先在同一个文件里补 @font-face，再把变量指过去

+++
title = "文章标题"
date = 2026-10-21
[extra]
body_font_size = "19px"  # 可选，不写则继承全局 21px
body_font = "pop"
+++

#	body_font取值	字体字典	Duration
1	golos Golos Text	golos Golos Text	主题默认字体
2	`pop`	华康 POP1 体	Identify-V 中文
3	essay	Essay Text	Identify-V 英文
4	mono	Commit Mono	等宽
1	wenkai	霞鹜文楷	主题默认字体
2	fangsong	仿宋	Identify-V 中文
3	sarasa	纱黑体	Identify-V 英文
4	pingfang	系统 PingFang SC（Apple 设备）	等宽

加解密

个人功能

跳转链接查看示例效果

+++
title = "通过 Little Snitch 屏蔽网站"
description = "基础教程"
updated = 2026-06-21
date = 2026-06-20
[taxonomies]
tags = ["Network"]
[extra]
accent_color = ["hsl(145 22% 34%)", "hsl(145 28% 50%)"]
[extra.encryption]
encrypt = true
+++

屏蔽RSS/Atom订阅

个人功能正确写法是放在 front matter 顶层（不要放进 [extra]）该文章会从根 feed 和所在板块 feed 中消失，文章本身仍能正常访问。它只影响订阅源，不影响页面发布；如果还想让它不进搜索，再另加 in_search_index = false

encrypt = true 的文章因为 post-build.mjs 的过滤，本身已经不会出现在 feed 里；include_in_feeds = false 更适合“不加密、但就是不想进 RSS”的普通文章。两者都写时也不冲突，include_in_feeds = false 会在 Zola 生成 feed 阶段就先排除。

+++
title = "不进入 RSS 的文章"
date = 2026-10-20
include_in_feeds = false
+++

+++
title = "Untitled 2025.m3u"
description = "My musical preferences of 2025, in a playlist form."
updated = 2026-07-04
[taxonomies]
tags = ["Music", "Playlist"]
[extra]
accent_color = ["hsl(209.49, 35.76%, 32.35%)", "hsl(200.0, 15.19%, 69.02%)"]
banner = "banner.webp"
styles = ["blog/2025-playlist/style.css"]
+++

Blog-md 内容主体

[!WARNING] > [!WARNING] 警告

看板

主题更新 -ametrine

以ametrine主题为当前核心主题

cd ~/00BlogZola

# ① 先回到主仓库当前记录的提交，确保是干净基线（可选但推荐）
git submodule update themes/ametrine

# ② 拉取新版主题：main 分支最新 + 初始化并递归更新嵌套子模块
#    （--init --recursive 会拉取 sass/citrine，这是新版能编译的关键）
git submodule update --remote --init --recursive themes/ametrine

# ③ 先编译验证（与 CI 完全一致的完整流程用 ./build-site.sh）
zola build

# ④ 编译失败 → 撤销本次拉取，回到主仓库记录的旧提交
git submodule update themes/ametrine
git diff                # themes/ametrine 应不再出现
git submodule status    # 前面无 + / - 符号即已回到记录提交

#如果第 ④ 步提示本地有改动不让覆盖，加 --force：
git submodule update --force themes/ametrine

# 上述是给读者详解，以下是 个人一键命令使用的
cd ~/00BlogZola

git submodule update --remote --init --recursive themes/ametrine

if zola build; then
  echo "✅ 新版主题编译通过（尚未记录，确认保留后再提交）"
else
  echo "❌ 编译失败，自动撤销本次拉取"
  git submodule update themes/ametrine
fi

关键提醒

回退为什么有效：主仓库「记录的」子仓库提交始终是旧的 fc6f62c217ae，只要你在成功之前不执行 git add themes/ametrine，git submodule update themes/ametrine（不带 –remote）就能把工作区拉回这个记录提交，相当于放弃新版。
确认保留新版时才提交：

git add themes/ametrine
 git commit -m "upgrade ametrine theme"
 提交之后，「记录提交」就变成新版了，此后第 ④ 步会回退到新版而不是旧版。

citrine 残留无害：回退后 themes/ametrine/sass/citrine 这个目录可能还留在本地，旧版主题不引用它，不影响编译，不用特意删。
更确定的拉取方式（可选）：如果不想依赖 –remote 对嵌套子模块的自动行为，也可以进子仓库手动拉取，与 CI 完全一致

cd ~/00BlogZola/themes/ametrine git fetch origin main git checkout origin/main git submodule update –init –recursive cd ~/00BlogZola

 之后的编译验证和回退步骤同上。

ASCII - 表情符号在博客文章

Suchaharcan — Thu, 15 Oct 2026 00:00:00 +0000

rocket菜单栏常驻双击``触发可模糊搜索

博客文章编写，代码注释，聊天通讯均可使用，但含义必须明确通用

技术性博客编写：基于场景需求约束目标步骤验证复现这6点顺序编写

字典映射规则集合

关键字	图标含义	图标
star	重点醒目提示	⭐
white-check-mark	可行性提醒完成状态安全	✅
interrobang	有疑问	⁉️
pushpin	置顶提醒	📌
gear	配置规则	⚙️
warning		⚠️

Git

Suchaharcan — Tue, 29 Sep 2026 00:00:00 +0000

定期更新该博客

日常开发中遇到的 git场景，在搜索应用后，总结到这里来，便于后续积累迁移

clone - 初次拉取

单分支无历史提交式

场景描述：只获取最新，分支标签关联仓库历史提交全部舍弃

git clone --depth 1 --single-branch --branch main --no-tags \
  https://mirrors.tuna.tsinghua.edu.cn/git/llvm-project.git \
  ~/00CXX_GitRes/llvm-project

–depth 1 只取最新一条提交
–single-branch 不抓其它分支（LLVM 有几千个分支，不限制会多几百 MB）
–no-tags 不抓 tag（LLVM 的 tag 极多，这是体积大头之一）

好习惯

克隆完立刻把“只更新 main、永不抓 tag、自动清理“固化进本地配置：

cd ~/00CXX_GitRes/llvm-project
## 良好习惯，后续每次拉取都要针对该本地仓库的基础配置进行优先设置
## bat .git/config ##进行查看该本地仓库的配置
git config --local remote.origin.fetch '+refs/heads/main:refs/remotes/origin/main'
git config --local remote.origin.tagOpt --no-tags
git config --local fetch.prune true
git config --local fetch.pruneTags true
git config --local gc.pruneExpire now

常用别名

# 一条命令完成"取最新快照 + 丢弃本地提交/改动"
git config --local alias.update \
  '!git fetch --depth 1 --no-tags --prune origin main && git reset --hard origin/main && git log --oneline -1'

# 定期瘦身
git config --local alias.slim \
  '!git reflog expire --expire=now --all && git gc --prune=now --quiet && git count-objects -vH'

注意：Git 没有持久化的“默认浅深度“配置项（fetch.depth 不是有效键，我查了本机 git 2.55 的配置文档确认过）。
所以 –depth 1 必须每次 fetch 时显式带上——这正是 git update 别名帮你固化的事，
别直接敲裸 git pull。

后续更新：永远只有一份快照

cd ~/00CXX_GitRes/llvm-project

git update # = fetch --depth 1 + reset --hard，等价于下面两行

验证“确实没在攒历史“

# 任何时候三条命令自检：
git rev-parse --is-shallow-repository   # 必须是 true
git rev-list --count HEAD               # 必须恒等于 1
git tag | wc -l                         # 必须恒等于 0
git count-objects -vH                   # size-pack 明显膨胀时跑一次 git slim

如果 is-shallow-repository 变成 false，说明中间某次更新用了不带 –depth 的命令（或镜像不支持 shallow 而返回了全量），最省事的处理是删掉重克隆一次。
额外网络优化（可选）：git config –global http.version HTTP/1.1 和 git config –global http.postBuffer 524288000 能缓解大包传输偶发卡死；如果你本机有代理（看到你装过 Geph），可以只给 GitHub 走代理、国内镜像直连

代码提交跟踪管理 - .gitignore

忽略整个文件夹‌：logs/ 或 logs/**，匹配该目录及子目录下的所有文件。
仅忽略文件夹内文件，保留文件夹本身‌：logs/*，不会忽略空目录，但会忽略其直接子文件和子目录。
取消对已跟踪文件的忽略‌：.gitignore 只对未跟踪文件生效；若文件已提交，需先执行 git rm –cached <路径>，再提交删除记录

build/*  #cmake搭建的C++项目，编译文件不提交，但该空目录是编译构建路径，建议提交，可采用该写法
logs/** # 日志在项目运行实时产生，无需提交到仓库中进行跟踪管理

add - 添加到仓库

add .

commit - 提交

git commit -m "Update File md"

push - 推送

git push origin mian

status - 状态

git status

额外常见命令

cloc - 统计代码量

cloc . # 在当前目录下按文件类型进行代码量统计

Rocky‘s Blog - Doc

CMake

Markdown

Markdown

标题

引用块 ✅

引用块可以嵌套。在要嵌套的段落前添加 >>。

Components - 组件

链接 ⭐

Images and Videos

CRT

Audio

YouTube

Vimeo

BiliBili

Overflow Auto

Description List

Form Input

Figure Captions

Accordion

Side Comment

Abbreviation

Aside

Keyboard Input

Mark Text

Deleted and Inserted Text

Progress Indicator

Sample Output

Inline Quotation

Unarticulated Annotation

Titles

External Links

Spoilers

Buttons

Accent Color

下载指定路径中的文件

URL 和电子邮件地址

格式化链接 ⭐✅

引用式链接

图像[5]

标题 ID \

My Great Heading \

My Great Heading

UML等图

Zola

Blog-md 标签头

颜色

RSS/Atom订阅

归类

字体字号

加解密

屏蔽RSS/Atom订阅

Banner

Blog-md 内容主体

看板

主题更新 -ametrine

ASCII - 表情符号在博客文章

字典映射规则集合

Git

clone - 初次拉取

单分支无历史提交式

好习惯

常用别名

后续更新：永远只有一份快照

验证“确实没在攒历史“

代码提交跟踪管理 - .gitignore

add - 添加到仓库

commit - 提交

push - 推送

status - 状态

额外常见命令

cloc - 统计代码量

引用块可以嵌套。在要嵌套的段落前添加 `>>`。

图像^[5]