Firefly

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

test

Sat, 11 Apr 2026 00:00:00 GMT

用来测试一级标题#

测试正文。

二级标题#

正文。

test mermaid

graph TD; A-->B; A-->C; B-->D; C-->D;

深度工作读书笔记

Tue, 07 Apr 2026 12:10:00 GMT

深度工作#

分为两个部分：

一、理论部分

深度工作的价值，意义.

二、实践部分

如何进行深度工作.

理论#

深度工作的价值#

有价值的原文摘抄：

越来越多的科学家认为刻意练习有效的原因与髓磷脂相关，它是在神经元周围生长的一层脂肪组织，起到绝缘保护的作用，可保持神经元干净和正常运转。要理解髓磷脂在提升能力方面的作用，首先要记住，不管是智力还是体力方面的技能，最终都要追溯到大脑回路上。这种新的性能科学认为，如果相关神经元周围汇集了更多的髓磷脂，相应的大脑回路就能更轻松有效地运转，你在某方面的技能就会更强。想要在某方面有了不起的成就，就需要有更多髓磷脂的协助。

因此，要想高度专注于当前任务，避免干扰非常重要，因为这是充分隔离相关神经回路、促进髓磷脂鞘形成的唯一途径

注意力残留解释：

当你从某项任务 A 转移到任务 B 时，你的注意力并没有即时转移，你的注意力残留仍然在思考原始任务。如果在转移工作之前，你对任务 A 缺乏控制且关注度较低，残留会尤其浓厚，但即使你在转移工作之前已经完成了任务 A，你的注意力还是会有一段分散的时间。

总结：

要达到个人巅峰的产出效率，你需要长时间、无干扰地高度专注于单一任务。换一种说法，使你的表现最优化的做法是深度工作。如果你无法做到长时间深度工作，就很难使你的表现达到质量和数量的巅峰，而这种巅峰状态对于你的职业成功越来越重要。除非你的才能和技能全面压制对手，否则对手中的深度工作者定将超越你的表现

反面例子：部分职业，例如秘书官等，不需要深度工作，恰恰相反，这类职业需要大量的零散的交际，因此，深度工作并非唯一的准则，但不需要深度工作的岗位不多。

除非你有充分的证据证明在你所属的职业领域分散精力是重要的，否则根据本章前述论证，若你能够认真考虑深度工作，肯定会得到最好的效果。

为什么深度工作少见？#

忙碌代表生产能力（Busyness as Proxy for Productivity）：在工作中，对于生产能力和价值没有明确的指标时，很多知识工作者都会采用工业时代关于生产能力的指标，以可视的方式完成很多事情。

人们怀着忙起来就是生产力的观念工作，进行了很多浮浅的工作。

我们开始自以为是地认定，只要是高科技就是好的，而不用再做探讨。他将这种文化称作技术垄断 Technopoly

深度工作在当今的商业气候下应该成为优先考虑的事情,但现实却并非如此。我们在上文中总结了出现这种矛盾现象的各种原因。包括深度工作很难，浮浅工作更简单；当工作中没有明确目标时，围绕浮浅工作的表面忙碌会成为一种本能；还有在我们的文化中已经形成了一种信念，认为与“网络”相关的行为都是好的，不论其对我们创造有价值事物之能力有何影响。由于深度工作价值以及忽略深度工作所造成的损失很难直接衡量，这些潮流才会大行其道

如果你相信深度工作的价值，那么对商业整体而言将是一个坏消息，因为这种信念会他们失去价值产出的巨大增长潜力。但对你个人而言，这却是好消息。同伴和雇主的短视，使你获得了巨大的个人优势。假定上文列出的潮流继续下去，深度工作将变得愈发罕有，其价值也因此会愈来愈高

深度工作的意义#

。在工作中（特别是在知识工作中），增加深度工作时间可以有效影响人脑这台复杂的机器，多种不同的神经学理论表明，此种影响将使你对工作生活的意义和满意度得到最大的提升。

契克森米哈赖有很多创举，而在经验抽样法方面的努力帮助他证实了此前十多年中一直研究的理论：“一个人的身体或头脑在自觉努力完成某项艰难且有价值的工作过程中达到极限时，往往是最优体验发生的时候。”契克森米哈赖将这种心理状态称作“心流”（这个术语因他在 1990 年出版的同名著作而广为人知）。

实践#

如何进行深度工作?

一年中部分时间处理零散的事情，另一部分时间无人打扰工作。或者是某些天处理零散，某些天处理深度工作。最后，也可以细分到按小时为单位的划分浮浅零散工作与深度工作。
习惯化：固定的位置、固定时间、固定方式，专注于深度工作。
大手笔

大手笔举例：JK罗琳写哈利波特最后一本书时，住在豪华酒店的故事。

罗琳决定入住爱丁堡城堡附近的一家豪华酒店套房，在深度工作的世界里是一种有趣但却有效的策略：要有大手笔。这个理念很简单：对周围惯常环境做出巨大改变，辅以可观的精力或金钱投入，都只为支持一项深度工作任务，由此你也提升了这项任务的外现重要性。这种重要性的提升，降低了你的大脑继续拖延的本能，并注入了激励和能量。

比尔盖茨：有思考周，会在这期间，放弃日常工作，来上一堆白纸和书隐居，思考公司相关的重大事务。

远离社交媒体，不要用网络来消遣。

比较好的实验，摘抄原文：

如今大量的调查——罗伊·鲍迈斯特在写作一系列首创论文时发起的——显示出有关意志力的重要事实：你的意志力是有限的，它在使用的过程中会被不断消耗.

换言之，你的意志力并非性格的展现，可以无限制地使用；相反，它恰如肌肉一般，会疲劳。这也是霍夫曼和鲍迈斯特的实验中，实验对象很难抵抗欲望的原因——经过一段时间，这些烦扰会榨干他们的意志力，直到最后无法抵抗。同样的事情也会发生在你身上，不管你的主观意愿如何坚定，除非你很讲究个人习惯.

由此我得出了一种令人振奋的想法：培养深度工作的习惯，关键在于越过良好的意图，在工作生活中加入一些特别设计的惯例和固定程序，使得进入并保持高度专注状态消耗的意志力最小化。

Python GUI

Fri, 03 Apr 2026 23:34:27 GMT

图形化#

pysimplegui 5.0 版本开始收费,所以只能安装 5.0 之前的版本.

Terminal window

1
pip uninstall PySimpleGUI
2
pip install PySimpleGUI==4.70.1

1
import PySimpleGUI as sg
2
import os
3

4
def main():
5
    # 定义历史记录文件路径
6
    history_file = 'history.txt'
7

8
    # 创建布局
9
    layout = [
10
        [sg.Text('File 1:'), sg.InputText(key='file1'), sg.FileBrowse(initial_folder=get_last_path(history_file, 0))],
11
        [sg.Text('File 2:'), sg.InputText(key='file2'), sg.FileBrowse(initial_folder=get_last_path(history_file, 1))],
12
        [sg.Text('File 3:'), sg.InputText(key='file3'), sg.FileBrowse(initial_folder=get_last_path(history_file, 2))],
13
        [sg.Text('File 4:'), sg.InputText(key='file4'), sg.FileBrowse(initial_folder=get_last_path(history_file, 3))],
14
        [sg.Button('OK')],
15
    ]
16

17
    # 创建窗口
18
    window = sg.Window('File Selector', layout)
19

20
    while True:
21
        event, values = window.read()
22

23
        if event == sg.WINDOW_CLOSED:
24
            break
25

26
        if event == 'OK':
27
            # 保存历史记录
28
            save_history(history_file, values['file1'], values['file2'], values['file3'], values['file4'])
29

30
            # 弹出消息框
31
            sg.popup('Hello World!')
32
            break
33

34
    window.close()
35

36
def get_last_path(history_file, index):
37
    # 从历史记录文件中获取上次保存的路径
38
    if os.path.exists(history_file):
39
        with open(history_file, 'r') as file:
40
            history = file.readlines()
41
            if len(history) > index:
42
                return history[index].strip()
43
    return ''
44

45
def save_history(history_file, *paths):
46
    # 将当前选择的路径保存到历史记录文件中
47
    with open(history_file, 'w') as file:
48
        for path in paths:
49
            file.write(f'{path}\n')
50

51
if __name__ == '__main__':
52
    main()

展开收起

1
import PySimpleGUI as sg
2

3
sg.theme('Default1')   # 设置当前主题
4
# 界面布局，将会按照列表顺序从上往下依次排列，二级列表中，从左往右依此排列
5
layout = [  [sg.Text('Some text on Row 1')],
6
            [sg.Text('Enter something on Row 2'), sg.InputText()],
7
            [sg.Button('Ok'), sg.Button('Cancel')] ]
8

9
# 创造窗口
10
window = sg.Window('Window Title', layout)
11
# 事件循环并获取输入值
12
while True:
13
    event, values = window.read()
14
    if event in (None, 'Cancel'):   # 如果用户关闭窗口或点击`Cancel`
15
        break
16
    print('You entered ', values[0])
17

18
window.close()
19

20
text_input = values[0]
21
sg.popup('You entered', text_input) # 弹出窗口

展开收起

1
# 进度条显示
2
import PySimpleGUI as sg
3

4
layout = [[sg.Text('A custom progress meter')],
5
          [sg.ProgressBar(1000, orientation='h', size=(20, 20), key='progressbar')],
6
          [sg.Cancel()]]
7

8
window = sg.Window('Custom Progress Meter', layout)
9
progress_bar = window['progressbar']
10
# loop that would normally do something useful
11
for i in range(1000):
12
    # check to see if the cancel button was clicked and exit loop if clicked
13
    event, values = window.read(timeout=10)
14
    if event == 'Cancel'  or event is None:
15
        break
16
  # update bar with loop value +1 so that bar eventually reaches the maximum
17
    progress_bar.UpdateBar(i + 1)
18
# done with loop... need to destroy the window as it's still open
19
window.close()

展开收起

1
import PySimpleGUI as sg
2
sg.theme('Default1')
3
# sg.popup('demo ok')
4
# sg.popup_ok_cancel('PopupOKCancel')
5
# sg.popup_error('PopupError')  # Shows red error button
6
# sg.popup_timed('PopupTimed')  # Automatically closes
7
# 例子：
8
text = sg.popup_get_file('Please enter a file name')
9
print(text)

1
import PySimpleGUI as psg
2
psg.set_options(font=('Arial Bold', 16))
3
layout = [
4
   [psg.Text('Enter a num: '), psg.Input(key='-FIRST-')],
5
   [psg.Text('Enter a num: '), psg.Input(key='-SECOND-')],
6
   [psg.Text('Result : '), psg.Text(key='-OUT-')],
7
   [psg.Button("Add"), psg.Button("Sub"), psg.Exit()],
8
]
9
window = psg.Window('Calculato1r', layout, size=(715, 180))
10
while True:
11
   event, values = window.read()
12
   print(event, values)
13
   if event == "Add":
14
      result = int(values['-FIRST-']) + int(values['-SECOND-'])
15
   if event == "Sub":
16
      result = int(values['-FIRST-']) - int(values['-SECOND-'])
17
   window['-OUT-'].update(result)
18
   if event == psg.WIN_CLOSED or event == 'Exit':
19
      break
20
window.close()

展开收起

1
import PySimpleGUI as psg
2
psg.set_options(font=('Arial Bold', 16))
3
layout = [
4
   [psg.Text('Name ', size=(15, 1)),
5
   psg.Input(key='-NM-', expand_x=True)],
6
   [psg.Text('Address ', size=(15, 1)),
7
   psg.Input(key='-AD-', expand_x=True)],
8
   [psg.Text('Email ID ', size=(15, 1)),
9
   psg.Input(key='-ID-', expand_x=True)],
10
   [psg.Text('You Entered '), psg.Text(key='-OUT-')],
11
   [psg.OK(), psg.Exit()],
12
]
13
window = psg.Window('Form', layout, size=(715, 200))
14
while True:
15
   event, values = window.read()
16
   print(event, values)
17
   out = values['-NM-'] + ' ' + values['-AD-'] + ' ' + values['-ID-']
18
   window['-OUT-'].update(out)
19
   if event == psg.WIN_CLOSED or event == 'Exit':
20
      break
21
window.close()

展开收起

1
import PySimpleGUI as psg
2
text = psg.popup_get_text('Enter your name', title="Textbox")
3
print ("You entered: ", text)
4
file=psg.popup_get_file('Select a file',  title="File selector")
5
print ("File selected", file)
6
folder=psg.popup_get_folder('Get folder', title="Folder selector")
7
print ("Folder selected",folder)
8
ch = psg.popup_yes_no("Do you want to Continue?",  title="YesNo")
9
print ("You clicked", ch)
10
ch = psg.popup_ok_cancel("Press Ok to proceed", "Press cancel to stop",  title="OkCancel")
11
if ch=="OK":
12
   print ("You pressed OK")
13
if ch=="Cancel":
14
   print ("You pressed Cancel")
15
psg.popup_no_buttons('You pressed', ch, non_blocking=True)
16
psg.popup_auto_close('This window will Autoclose')

展开收起

1
# 选择主题
2
import PySimpleGUI as sg
3
theme_name_list = sg.theme_list()
4
sg.theme_previewer()
5
sg.theme('Default1')
6
layout = [[sg.Text('Theme Browser')],
7
          [sg.Text('Click a Theme color to see demo window')],
8
          [sg.Listbox(values=sg.theme_list(), size=(20, 12), key='-LIST-', enable_events=True)],
9
          [sg.Button('Exit')]]
10
window = sg.Window('Theme Browser', layout)
11

12
while True:  # Event Loop
13
    event, values = window.read()
14
    if event in (None, 'Exit'):
15
        break
16
    sg.theme(values['-LIST-'][0])
17
    sg.popup_get_text('This is {}'.format(values['-LIST-'][0]))
18

19
window.close()

展开收起

Python 零散脚本

Fri, 03 Apr 2026 11:10:00 GMT

test#

1
# 生成正弦波 wav 250
2
import wave
3
import math
4
import array
5

6
# 音频参数
7
sample_rate = 44100  # 采样频率
8
duration = 60*10  # 音频时长（秒）
9

10
# 创建一个新的WAV文件
11
output_file = wave.open('output.wav', 'w')
12
output_file.setnchannels(1)  # 单声道
13
output_file.setsampwidth(2)  # 2字节，16位
14
output_file.setframerate(sample_rate)
15

16
# 生成250Hz的音频数据
17
samples = array.array('h', [0] * (sample_rate * duration))
18
amplitude = 2 ** 15 - 1  # 振幅
19

20
for i in range(len(samples)):
21
    t = float(i) / sample_rate  # 当前时间（秒）
22
    samples[i] = int(amplitude * math.sin(2 * math.pi * 250 * t))
23

24
# 将音频数据写入WAV文件
25
output_file.writeframes(samples)
26

27
# 关闭WAV文件
28
output_file.close()

展开收起

1
# 生成指定的bin
2
import os
3
import binascii
4
import random
5

6
file_path = 'example.bin'
7
# file_size = 0x3150
8
file_size = 1024*8
9

10
with open(file_path, 'wb') as f:
11
    remaining_bytes = file_size
12
    buffer_size = 1024  # 每次写入的字节数
13
    while remaining_bytes > 0:
14
        buffer = bytearray(random.getrandbits(8) for _ in range(min(buffer_size, remaining_bytes)))
15
        f.write(buffer)
16
        remaining_bytes -= buffer_size

展开收起

1
#! /usr/bin/env python
2
#coding=utf-8
3
import os
4
import time
5
from ctypes import *
6
import numpy as np
7

8
class USBI2C():
9
    ch341 = windll.LoadLibrary("C:/WCH.CN/CH341PAR/CH341DLLA64.dll")
10
    def __init__(self, usb_dev = 0, i2c_dev = 0):
11
        self.usb_id   = usb_dev
12
        self.dev_addr = i2c_dev
13
        if USBI2C.ch341.CH341OpenDevice(self.usb_id) != -1:
14
            USBI2C.ch341.CH341SetStream(self.usb_id, 0x80)
15
            USBI2C.ch341.CH341CloseDevice(self.usb_id)
16
        else:
17
            print("USB CH341 Open Failed!")
18

19
    def read(self, addr,len):
20
        if USBI2C.ch341.CH341OpenDevice(self.usb_id) != -1:
21
            obuf = (c_byte * 2)()
22
            ibuf = (c_byte * len)()
23
            obuf[0] = self.dev_addr
24
            obuf[1] = addr
25
            USBI2C.ch341.CH341StreamI2C(self.usb_id, 2, obuf, len, ibuf)
26
            USBI2C.ch341.CH341CloseDevice(self.usb_id)
27
            # return ibuf[0] & 0xff
28
            return ibuf
29
        else:
30
            print("USB CH341 Open Failed!")
31
            return 0
32

33
    def write(self, addr, dat):
34
        if USBI2C.ch341.CH341OpenDevice(self.usb_id) != -1:
35
            obuf = (c_byte * 3)()
36
            ibuf = (c_byte * 1)()
37
            obuf[0] = self.dev_addr
38
            obuf[1] = addr
39
            obuf[2] = dat & 0xff
40
            USBI2C.ch341.CH341StreamI2C(self.usb_id, 3, obuf, 0, ibuf)
41
            USBI2C.ch341.CH341CloseDevice(self.usb_id)
42
        else:
43
            print("USB CH341 Open Failed!")
44

45
if __name__ == '__main__':
46

47
    regs_add = [0x0b,0x0f,0x24,0x25,0x26,0x2e,0x2f]
48
    for i in range(len(regs_add)):
49
        i2cDevice = USBI2C(0,0x32)
50
        buf = i2cDevice.read(regs_add[i],1)
51
        print(hex(regs_add[i]),hex(c_uint8(buf[0]).value))

展开收起

Life

Fri, 03 Apr 2026 11:06:34 GMT

这是一篇隐藏文章，用来记录生活零散的感悟。

I2C_pull_up_reg

Thu, 02 Apr 2026 17:55:40 GMT

I2C上拉电阻选择#

I²C 总线是开漏/开集结构，需要外部上拉电阻（Rp）将信号线（SDA/SCL）拉高。上拉电阻的取值由总线电容（Cb） 和目标通信速率共同决定，核心在于满足信号上升时间（tr）的要求。

计算公式#

RC 充电公式：信号从 30% VDD 上升到 70% VDD 所需的时间（即上升时间 tr）由以下公式决定：
tr=0.8473×Rp×Cbt_r = 0.8473 \times R_p \times C_btr=0.8473×Rp×Cb
常数 0.8473 的来源：这个常数是数学推导的结果。它来源于一阶 RC 充电电路方程，计算电压从 30% VDD 升至 70% VDD 所需时间的精确解：
tr=RpCb×ln⁡(0.70.3)≈0.8473×Rp×Cbt_r = R_p C_b \times \ln\left(\frac{0.7}{0.3}\right) \approx 0.8473 \times R_p \times C_btr=RpCb×ln(0.30.7)≈0.8473×Rp×Cb
结论：0.8473 是理论计算出的固定常数，用于描述在标准工程定义下的上升时间。
取值范围的约束：
- 下限约束（电阻不能太小）：由 GPIO 引脚的最大灌电流（Sink Current）能力决定，以防止损坏引脚。计算公式为： Imax=VDDRpI_{max} = \frac{V_{DD}}{R_p}Imax=RpVDD 此电流值应小于 GPIO 的规格（通常为 4-8 mA）。
- 上限约束（电阻不能太大）：由总线电容和通信速率决定，确保上升时间满足协议要求。电阻太大，RC 充电慢，上升沿过缓，会导致高速通信失败。

计算示例：假设总线电容 Cb 为 200 pF，需要在 400 kHz 模式下满足 tr < 300 ns 的要求。根据公式计算 Rp 的理论最大值：

Rp=tr0.8473×Cb=300×10−90.8473×200×10−12≈1.77kΩR_p = \frac{t_r}{0.8473 \times C_b} = \frac{300 \times 10^{-9}}{0.8473 \times 200 \times 10^{-12}} \approx 1.77 k\OmegaRp=0.8473×Cbtr=0.8473×200×10−12300×10−9≈1.77kΩ

考虑到余量，应选取比此值更小的电阻，例如 1.5 kΩ。

二、快速选型速查表#

对于大多数应用，可以基于以下经验表格快速选择：

通信模式	速率	典型 Rp 值 (3.3V 系统)	典型 Rp 值 (5V 系统)	备注
标准模式 (Standard-mode)	100 kbps	4.7 kΩ - 10 kΩ	2.2 kΩ - 4.7 kΩ	最常用，兼顾速度与功耗。
快速模式 (Fast-mode)	400 kbps	1.5 kΩ - 3.3 kΩ	1.0 kΩ - 2.2 kΩ	需减小电阻以保证上升沿速度。
快速模式+ (Fast-mode Plus)	1 Mbps	680 Ω - 1.5 kΩ	470 Ω - 1.0 kΩ	功耗较大，需确认主从设备支持。

核心原因：

在相同速率下，5V 系统可以使用更小的 Rp，因为在相同电流下，5V 系统产生的电压变化（dV/dt）更快，更容易满足上升时间要求。
高速模式必须用更小的 Rp 来对抗总线电容的影响，加速 RC 充电。

注：实际取值应比计算值略小（留 20%-30% 裕量），以应对 PCB 寄生参数和温度漂移。

三、总结与决策路径#

常规情况：3.3V 系统选用 4.7 kΩ，5V 系统选用 2.2 kΩ。这是最稳妥的起点。
高速/多负载情况：如果通信距离长、挂载设备多（总线电容 Cb 大），或使用快速模式（400k/1M），应选用更小的电阻（如 1.5kΩ 或 1kΩ）。
低功耗场景：如果对速度不敏感，可选用更大的电阻（如 10kΩ）以降低静态电流。
最终验证：最可靠的方法是使用示波器观察 SCL 信号，确保上升沿陡峭、无过冲。如果上升沿圆滑，说明 Rp 太大或 Cb 太大，需要减小 Rp 或优化布线。

补充说明: 0.8473 的数学推导（RC 充电方程）#

I²C 总线的上升沿被建模为一个一阶 RC 充电电路。其电压随时间变化的公式为：

V(t)=VDD⋅(1−e−t/τ)V(t) = V_{DD} \cdot (1 - e^{-t/\tau})V(t)=VDD⋅(1−e−t/τ)

其中 τ=Rp⋅Cb\tau = R_p \cdot C_bτ=Rp⋅Cb 是 RC 时间常数。

1. 定义工程阈值 在数字电路中，我们并不关心信号从 0% 充到 100% 的完整过程，而是关心它何时进入“有效逻辑区间”。标准定义如下：

V_IL（输入低电平阈值）：0.3⋅VDD0.3 \cdot V_{DD}0.3⋅VDD
V_IH（输入高电平阈值）：0.7⋅VDD0.7 \cdot V_{DD}0.7⋅VDD

2. 求解时间点 我们需要计算电压到达这两个阈值的时间差，即上升时间 trt_rtr。

到达 30% 的时间 t1t_1t1： 0.3VDD=VDD(1−e−t1/τ)0.3V_{DD} = V_{DD}(1 - e^{-t_1/\tau})0.3VDD=VDD(1−e−t1/τ) e−t1/τ=0.7e^{-t_1/\tau} = 0.7e−t1/τ=0.7 t1=−ln⁡(0.7)⋅τ≈0.3567⋅τt_1 = -\ln(0.7) \cdot \tau \approx 0.3567 \cdot \taut1=−ln(0.7)⋅τ≈0.3567⋅τ
到达 70% 的时间 t2t_2t2： 0.7VDD=VDD(1−e−t2/τ)0.7V_{DD} = V_{DD}(1 - e^{-t_2/\tau})0.7VDD=VDD(1−e−t2/τ) e−t2/τ=0.3e^{-t_2/\tau} = 0.3e−t2/τ=0.3 t2=−ln⁡(0.3)⋅τ≈1.2040⋅τt_2 = -\ln(0.3) \cdot \tau \approx 1.2040 \cdot \taut2=−ln(0.3)⋅τ≈1.2040⋅τ

3. 得出系数 tr=t2−t1=[−ln⁡(0.3)+ln⁡(0.7)]⋅τ=ln⁡(0.70.3)⋅τt_r = t_2 - t_1 = [-\ln(0.3) + \ln(0.7)] \cdot \tau = \ln\left(\frac{0.7}{0.3}\right) \cdot \tautr=t2−t1=[−ln(0.3)+ln(0.7)]⋅τ=ln(0.30.7)⋅τ tr≈0.8473⋅Rp⋅Cb\boxed{t_r \approx 0.8473 \cdot R_p \cdot C_b}tr≈0.8473⋅Rp⋅Cb

结论：0.8473 是计算 ln⁡(0.7/0.3)\ln(0.7/0.3)ln(0.7/0.3) 得到的纯数学常数，它精确描述了在 30%-70% 区间内的 RC 充电速度。

在工程中，时间常数 τ=R×C\tau = R \times Cτ=R×C 是一个基准单位，它衡量了电容充电/放电的“惯性”。

为什么 I²C 不直接用 τ\tauτ 而用 0.8473τ\tauτ？

τ\tauτ (63%)：是物理学的通用度量，用于描述“变化快慢”的基准。
0.8473τ\tauτ (30%-70%)：是数字逻辑的特定定义。因为芯片的输入引脚只有在电压超过 V_IH (70%) 时才确认为高电平，低于 V_IL (30%) 确认为低电平。0.8473τ\tauτ 直接决定了信号能否被正确采样，是时序约束的直接体现。

git基础教程与常用操作

Mon, 19 Aug 2024 00:21:52 GMT

git 快速入门教程#

git 是版本控制软件。

版本控制的概念#

版本控制是什么，为什么需要版本控制？

版本指若干文件内容所构成的整体，而控制指记录个整体以及变化。

举个例子：当你再写一篇文章，写完之后就保存到电脑里面了。过了很久之后，再次打开发现措辞不当，进行了若干处修改。然后又过去一段时间，觉得上一次考虑不周，也许还是第一次的更好，此时你想回到第一次的版本。

而版本控制就是为了实现这样的目的：即可以保存任意状态下的文件内容，并且可以给出任意两种状态下差异。

有了版本控制，你就可以随心所欲的创作和修改。不用担心记不住的问题，版本控制可以帮你想要保存的任何状态，你可以回到任意的状态中。简而言之，在版本控制中，你可以任意拨弄“时间线”，回到“过去”，从“过去”穿越到“未来”。

版本控制软件不只有 git 还有其他的,例如 SVN，CVS 等，但最常用的就是 git。

安装配置#

在电脑上安装 git 软件，并配置好 git 环境变量。

安装 git#

git 官方地址：https://git-scm.com/downloads

git 镜像源地址：https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/

gitextension 软件网址(可选)： https://gitextensions.github.io/

配置 git#

推荐首先配置如下 git 全局参数：

Terminal window

1
# 全局配置
2
git config --global user.name "name"
3
git config --global user.email "name@xxx.com"

下面的是可选配置：

Terminal window

1
# 配置默认编辑器
2
git config --global core.editor vim
3
# 配置颜色
4
git config --global color.ui true
5
# 配置别名
6
git config --global alias.br branch
7
git config --global alias.ci commit
8
git config --global alias.co checkout
9
# 配置文件编码为 utf-8
10
git config --global i18n.commitEncoding utf-8
11
git config --global i18n.logOutputEncoding utf-8

配置 SSH (可选)#

生成密钥步骤，在 git bash 中输入：

Terminal window

1
ssh-keygen -t rsa -C 'yourEmail@xx.com'

一直回车过去，在系统默认路径 C:\Users<user name>.ssh 下生成 id_rsa.pub 和 id_rsa 文件。

然后将 id_rsa.pub 文件内容复制到 gitlab 网站上，添加 ssh key。

最后在本机执行：

Terminal window

1
ssh -T git@gitlab.com

验证是否成功，就可以正常使用 git 命令了。

配置文件设置 (可选)#

除了这种方式外，还可以直接在配置文件中设置参数。

类型	优先级	路径
仓库路径	高	`.git\config`
用户级别路径	中	`C:\Users\<user-name>\.gitconfig`
系统级别路径	低	`C:\Program Files\Git\etc\config`

典型的配置文件内容如下：

Terminal window展开收起

1
[user]
2
name = name
3
email = name@xxx.com
4
[color]
5
ui = true
6
[alias]
7
br = branch
8
ci = commit
9
co = checkout
10
type = cat-file -t
11
dump = cat-file -p
12
st = status
13
unstage= reset HEAD --
14
last = log -1 HEAD
15
visual = !gitk
16
hist = log --pretty=format:\"%h %ad | %s%d [%an]\" --graph --date=short
17
Encoding = utf-8

展开收起

常用命令#

Terminal window展开收起

1
git add file_name
2
git commit -m "some comment"
3
git status
4
git cnfig --list
5
git clone [url]
6
git push origin HEAD:refs/for/master
7
#str: hash author_name author_date comment
8
git log --pretty=format:"%h - %an, %ar : %s" --graph
9
git log --since=2.weeks
10
git push [remote-name] [branch-name]
11
git config --global alias.ci commit #alias
12
git config --global alias.last 'log -1 HEAD' #alias
13
git checkout -b branch_name #创建分支并切换过去,等价于下面两行
14
git branch branch_name
15
git checkout branch_name
16
#创建修复分支并合并
17
git checkout -b hotfix
18
#做一些修复工作
19
git add .
20
git commit -m "做了一些修复工作"
21
git checkout master
22
git merge hotfix
23
git branch -d hotfix //master 移动到 hotfix 后，hotfix 就要删除掉
24
git branch -f main HEAD~3
25
git cherry-pick <提交号>
26
git rebase --interactive
27
//拉取远程仓库并合并到本地，然后上传
28
git pull --rebase
29
git push
30

31
git reflog # 当使用 reset 后，使用 reflog 查看丢失的 log，可以根据哈希值回到 reset 之前
32
git tag tage_name hash_id # 打标签

展开收起

Terminal window

1
# 代码带子模块
2
git clone --recursive [address]
3
# 已经下载仓库
4
git submodule init
5
git submodule update

git 多账户配置 (可选)#

Terminal window展开收起

1
# 为公司生成一对秘钥 ssh key
2
ssh-keygen -t rsa -C 'yourEmail@xx.com' -f ~/.ssh/gitlab-rsa
3
# 为 github 生成一对秘钥 ssh key
4
ssh-keygen -t rsa -C 'yourEmail2@xx.com' -f ~/.ssh/github-rsa
5
# 在~/.ssh 目录下新建名称为 config 的文件（无后缀名）。用于配置多个不同的 host 使用不同的 ssh key，内容如下：
6
# gitlab
7
Host gitlab.com
8
HostName gitlab.com
9
PreferredAuthentications publickey
10
IdentityFile ~/.ssh/gitlab_id-rsa
11
# github
12
Host github.com
13
HostName github.com
14
PreferredAuthentications publickey
15
IdentityFile ~/.ssh/github_id-rsa
16
# 配置文件参数说明
17
# Host : Host 可以看作是一个你要识别的模式，对识别的模式，进行配置对应的的主机名和 ssh 文件
18
# HostName : 要登录主机的主机名
19
# User : 登录名
20
# IdentityFile : 指明上面 User 对应的 identityFile 路径
21
# 按照上面的步骤分别往 gitlab 和 github 上添加生成的公钥 gitlab_id-rsa.pub 和 github_id-rsa.pub
22
# OK，大功告成，再次执行 git 命令验证是不是已经不需要再次验证权限了。
23
# 再次查看~/.ssh 目录下的文件,会有 gitlab_id-rsa、gitlab_id-rsa.pub 和 github_id-rsa、github_id-rsa.pub 四个文件

展开收起

工作流程#

首先克隆远程仓库：git clone [url]，或从本地创建新仓库：git init 然后，在本地编辑文件，并提交到本地仓库：git add [file-name]，git commit -m "commit message"，最后，推送到远程仓库：git push origin master，或其他分支：git push origin [branch-name]

仓库目录说明： .git 文件夹是索引文件，存放着版本信息，包括提交历史、暂存区、远程仓库等。

工作区：就是你在电脑里能看到的目录，通过编辑器打开的文件都在工作区。

.gitignore 文件：忽略不需要提交的文件的说明文件

FAQ#

Q：克隆带子模块的仓库,如何下载子模块? A：git clone 命令默认不会下载子模块，需要使用 —recursive 参数来下载子模块。例如：git clone --recursive [address],如果已经下载了仓库，那么只需要进入仓库，执行git submodule update --init --recursive,或者执行git fetch [url]

项目	URL
git 官网	https://git-scm.com/
git 镜像网址	https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/
gitextension	https://gitextensions.github.io/

常见问题#

Q: 带模块的仓库,下载出错如何继续? A: 进入仓库,执行=git submodule update —init —recursive=,或者执行=git fetch [url]= A: 使用 hash 切换分支 git checkout <hash>

Q: 跳过检验,直接提前. A: git commit --no-verify -m "aaa"

Windows电脑入门教程

Mon, 12 Aug 2024 23:38:32 GMT

电脑入门教程#

计划：录制一个视频加上本篇文章，视频用来介绍，文章用来标记重点。以及方便大家访问相关网址。

写在前面的话，学会使用电脑并不是一件很难的事情，但是因为有点复杂，且对于新手而言，不知道如何获取资料，加剧了这一个难度。

请耐心且细心，一定可以学会使用电脑的。

如何解决电脑问题？#

因为电脑本身的构造比较复杂，所以出现问题时，一些只言片语很难定位问题，一定要先把问题描述清楚。能够把问题描述清楚后，再去搜索引擎搜索出现问题的原因。

上网搜索
软件自带帮助(F1)
询问别人

电脑组成说明#

电脑有多种形态，对于普通的大众来说，最常用的有两种，一种是笔记本，另一种是台式机。下面以台式机和笔记本举例：输入部分：触摸板、键盘、鼠标输出部分：屏幕主机部分：一般来说就是键盘下面的部分，里面有 CPU，内存，硬盘等部件。

flowchart LR A["电脑"] B["主机"] C["键鼠"] D["显示"] E["CPU：中央处理器"] F["GPU：图形处理器"] G["RAM: 内存"] H["ROM: 硬盘"] A ----> C A ----> B A ----> D B ----> E B ----> F B ----> G B ----> H

认识键盘和鼠标#

键盘教程

鼠标操作

Windows 系统介绍#

系统自带功能#

Windows 系统快捷键

功能	快捷键	说明
截图	Win+PtrSC 或者 Win+Shift+s
磁盘管理	Win+x,K	硬盘，U 盘等存储设备
设备管理器	Win+x,M	电脑与插到电脑上的设备
搜索功能	Win+S	单击 Win 键也可以

常用软件介绍#

文件资源管理器#

功能	快捷键	说明
打开文件资源管理器	Win+E	助记是 Explore 的缩写
关闭标签页	Ctrl+W
创建标签页	Ctrl+T
复制粘贴文件	Ctrl+C/V	复制文件
剪切粘贴文件	Ctrl+X/V	移动文件

网络浏览器#

Edge 浏览器，系统自带。
Chrome
FireFox

压缩解压软件#

7Z
系统自带

文档编辑#

Office
WPS
Adobe Acrobat DC (PDF 阅读编辑工具)

网盘同步软件#

WSP 云(搭配文档同步使用)
百度云(用来下载资源)

好用软件推荐#

EveryThing搜索电脑中的文件
geek卸载程序
Freeplane思维导图
excalidraw草图绘制网页

Python相关知识

Mon, 12 Aug 2024 23:34:27 GMT

pyenv-win 命令列表安装命令

1
pyenv install <version>：安装指定版本的Python。
2
pyenv uninstall <version>：卸载指定版本的Python。
3
pyenv rehash：重新生成shims和重新加载环境变量。

版本管理命令

1
pyenv versions：列出所有已安装的Python版本。
2
pyenv version：显示当前激活的Python版本。
3
pyenv global <version>：设置全局Python版本。
4
pyenv local <version>：在当前目录设置局部Python版本。
5
pyenv shell <version>：在当前shell中设置Python版本。
6
pyenv which <command>：显示指定命令所对应的Python解释器路径。

其他命令

1
pyenv exec <command>：在特定版本的Python环境中执行命令。
2
pyenv virtualenv <version> <name>：创建一个新的虚拟环境。
3
pyenv activate <name>：激活指定名称的虚拟环境。
4
pyenv deactivate：停用当前虚拟环境。

注意事项

1
在使用pyenv之前，请确保已经正确安装并配置好了Python环境。
2
使用虚拟环境可以帮助您在不同项目之间隔离Python依赖。
3
使用pyenv global、pyenv local和pyenv shell可以轻松管理不同版本的Python。

Terminal window

1
[System.Environment]::SetEnvironmentVariable('PYENV',"C:\sw" + "\.pyenv\pyenv-win\","User")
2
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT',"C:\sw" + "\.pyenv\pyenv-win\","User")
3
[System.Environment]::SetEnvironmentVariable('PYENV_HOME',"C:\sw" + "\.pyenv\pyenv-win\","User")
4
[System.Environment]::SetEnvironmentVariable('path', "C:\sw" + "\.pyenv\pyenv-win\bin;" + "C:\sw" + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('path', "User"),"User")
5
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
6
Unblock-File (Join-Path $env:PYENV 'bin/pyenv.ps1')
7
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
8
poetry source add tsinghua https://pypi.tuna.tsinghua.edu.cn/simple
9
yadm工具了解一下，并且使用上。

Python 常用脚本#

CH341A 模块#

FTDI 模块#

1
import ft4222
2
import ft4222.I2CMaster
3
# 需要在命令行使用以下命令，安装库
4
# pip install ft4222
5
# list devices
6
nbDev = ft4222.createDeviceInfoList()
7
for i in range(nbDev):
8
    print(ft4222.getDeviceInfoDetail(i, False))

python venv#

这是 Python 自带的包管理器，下面介绍常用命令。

Terminal window

1
# 创建环境
2
python -m venv /path/to/your/venv
3
# 激活环境 Windows
4
/path/to/your/venv/Scripts/activate
5
# 激活环境 Linux
6
source /path/to/your/venv/bin/activate
7
# 退出环境
8
deactivate

pip set#

Terminal window

1
# 导出包
2
pip freeze > requirements.txt
3
# 导入包
4
pip install -r requirements.txt
5
# pip 安装到指定路径
6
pip install package_name -t /path/to/your/directory

pip package list#

Terminal window

1
pip install vcdvcd
2
pip install python-lsp-server

文档

https://docs.python.org/zh-cn/3/download.html

https://peps.python.org/

LearnPython#

模块#

安装#

Terminal window

1
pip install pyelftools PySimpleGUI lxml numpy chardet scipy matplotlib
2
pip install pyvisa pandas shutil
3
pip install shutil openpyxl

说明#

1
# 用来暂停
2
os.system("pause")

打包应用#

Terminal window

1
# -F 表示 打包为单个文件
2
# -w 表示为没有控制台
3
# -i .\favicon.ico 添加应用图标
4
pyinstaller.exe -F -w -i .\favicon.ico .\test.py

wav 250#

import wave import math import array

音频参数#

sample_rate = 44100 # 采样频率 duration = 60*10 # 音频时长（秒）

创建一个新的 WAV 文件#

output_file = wave.open(‘output.wav’, ‘w’) output_file.setnchannels(1) # 单声道 output_file.setsampwidth(2) # 2 字节，16 位 output_file.setframerate(sample_rate)

生成 250Hz 的音频数据#

samples = array.array(‘h’, [0] _ (sample_rate _ duration)) amplitude = 2 ** 15 - 1 # 振幅

for i in range(len(samples)): t = float(i) / sample*rate # 当前时间（秒） samples[i] = int(amplitude * math.sin(2 _ math.pi _ 250 _ t))

将音频数据写入 WAV 文件#

output_file.writeframes(samples)

关闭 WAV 文件#

output_file.close()

import numpy as np from scipy.io import wavfile import wave

def generatesine_wave(freq, duration, filename): # 采样率 sample_rate = 44100 # 生成时间轴 t = np.linspace(0, duration, int(duration * samplerate), endpoint=False) # 生成正弦波信号 wave_data = np.sin(2 * np.pi _ freq _ t) # 将信号归一化到 16 位范围内 wave_data_normalized = (wave_data * 32767).astype(np.int16)

1
# 创建并保存wav文件
2
with wave.open(filename, 'wb') as wav_file:
3
    wav_file.setnchannels(1)  # 设置为单声道
4
    wav_file.setsampwidth(2)  # 设置采样大小为2字节（16位）
5
    wav_file.setframerate(sample_rate)  # 设置采样率
6
    wav_file.writeframes(wave_data_normalized.tobytes())

示例：生成 1000Hz 频率，持续 2 秒的正弦波 wav 文件#

generate_sine_wave(1000, 2, “sine_wave.wav”)

Excel#

import as xl workbook = xl.load_workbook(filename=“D:\Documents\aa.xlsx”) workbook.sheetnames

pip#

方法一：打开网址,https://pypi.org/project/pip/#files

然后下载源码，解压，打开命令行，输入命令python setup.py install

输入pip --version，查看是否安装成功

方法二：打开终端，执行py get-pip.py

安装模块: pip install module-name 例如： pip install pyelftools

juypter
pillow
requests
pyinstaller

Terminal window

1
# 参数解释： F只产生一个exe，w是不使用控制台,i是图标
2
pyinstaller  -i xxx.icon -Fw demo.py

FAQ#

Q: 指定版本运行脚本？ A: py -3.7 a.py

1
#
2
import PySimpleGUI as sg
3
layout = [[sg.Text('Your typed chars appear here:'), sg.Text(size=(15,1), key='-OUTPUT-')],
4
          [sg.Input(key='-IN-')],
5
          [sg.Button('Show'), sg.Button('Exit')]]
6

7
window = sg.Window('Test', layout)
8

9
while True:  # Event Loop
10
    event, values = window.read()
11
    print(event, values)
12
    if event in  (None, 'Exit'):
13
        break
14
    if event == 'Show':
15
        # Update the "output" text element to be the value of "input" element
16
        window['-OUTPUT-'].update(values['-IN-'])
17

18
window.close()
19
#
20
import os
21
import re
22

23
def batch_rename_files(directory, regex_pattern, new_text):
24
    for filename in os.listdir(directory):
25
        if re.match(regex_pattern, filename):
26
            new_filename = re.sub(regex_pattern, new_text, filename)
27
            os.rename(os.path.join(directory, filename), os.path.join(directory, new_filename))
28

29
# 指定目录和正则表达式
30
directory = "D:/aaaa"
31
regex_pattern = r'FPGA_240109b(.*)'
32
new_text = r'FPGA_240109(-3_6)\1'   #\1指保留其他部分不变
33

34
# 执行批量重命名
35
batch_rename_files(directory, regex_pattern, new_text)
36

37

38
# 生成指定的bin
39
import os
40
import binascii
41
import random
42

43
file_path = 'example.bin'
44
# file_size = 0x3150
45
file_size = 1024*8
46

47
with open(file_path, 'wb') as f:
48
    remaining_bytes = file_size
49
    buffer_size = 1024  # 每次写入的字节数
50
    while remaining_bytes > 0:
51
        buffer = bytearray(random.getrandbits(8) for _ in range(min(buffer_size, remaining_bytes)))
52
        f.write(buffer)
53
        remaining_bytes -= buffer_size
54

55
# 音量
56
import PyAutoGUI
57
import time
58

59
while 1:
60
    pyautogui.press('volumeup')    #调大音量
61
    time.sleep(5)
62
    pyautogui.press('volumedown') #调小音量
63
    time.sleep(5)
64
#pyautogui.press('volumemute') #静音
65

66
# 图形化
67
import PySimpleGUI as sg
68
# sg.popup('demo ok')
69
# sg.popup_ok_cancel('PopupOKCancel')
70
# sg.popup_error('PopupError')  # Shows red error button
71
# sg.popup_timed('PopupTimed')  # Automatically closes
72
# 例子：
73
text = sg.popup_get_file('Please enter a file name')
74

75

76
import PySimpleGUI as sg
77
import json
78
sg.set_options(font=('Arial Bold', 16))
79
layout = [
80
   [sg.Text('Settings', justification='left')],
81
   [sg.Text('User name', size=(10, 1), expand_x=True),
82
   sg.Input(key='-USER-')],
83
   [sg.Text('email ID', size=(10, 1), expand_x=True),
84
   sg.Input(key='-ID-')],
85
   [sg.Text('Role', size=(10, 1), expand_x=True),
86
   sg.Input(key='-ROLE-')],
87
   [sg.Button("LOAD"), sg.Button('SAVE'), sg.Button('Exit')]
88
]
89
window = sg.Window('User Settings Demo', layout, size=(715, 200))
90
# Event Loop
91
while True:
92
   event, values = window.read()
93
   if event in (sg.WIN_CLOSED, 'Exit'):
94
      break
95
   if event == 'LOAD':
96
      f = open("settings.txt", 'r')
97
      settings = json.load(f)
98
      window['-USER-'].update(value=settings['-USER-'])
99
      window['-ID-'].update(value=settings['-ID-'])
100
      window['-ROLE-'].update(value=settings['-ROLE-'])
101
   if event == 'SAVE':
102
      settings = {'-USER-': values['-USER-'],
103
      '-ID-': values['-ID-'],
104
      '-ROLE-': values['-ROLE-']}
105
      f = open("settings.txt", 'w')
106
      json.dump(settings, f)
107
      f.close()
108
window.close()
109

110

111

112

113
import matplotlib.pyplot as plt
114
import numpy as np
115
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
116
import PySimpleGUI as sg
117
import matplotlib
118
matplotlib.use('TkAgg')
119
fig = matplotlib.figure.Figure(figsize=(5, 4), dpi=100)
120
t = np.arange(0, 3, .01)
121
fig.add_subplot(111).plot(t, 2 * np.sin(2 * np.pi * t))
122
def draw_figure(canvas, figure):
123
   tkcanvas = FigureCanvasTkAgg(figure, canvas)
124
   tkcanvas.draw()
125
   tkcanvas.get_tk_widget().pack(side='top', fill='both', expand=1)
126
   return tkcanvas
127
layout = [[sg.Text('Plot test')],
128
   [sg.Canvas(key='-CANVAS-')],
129
   [sg.Button('Ok')]]
130
window = sg.Window('Matplotlib In PySimpleGUI', layout, size=(715, 500), finalize=True, element_justification='center', font='Helvetica 18')
131

132
# add the plot to the window
133
tkcanvas = draw_figure(window['-CANVAS-'].TKCanvas, fig)
134
event, values = window.read()
135
window.close()
136

137

138
import PySimpleGUI as psg
139
psg.set_options(font=('Arial Bold', 16))
140
layout = [
141
   [psg.Text('Enter a num: '), psg.Input(key='-FIRST-')],
142
   [psg.Text('Enter a num: '), psg.Input(key='-SECOND-')],
143
   [psg.Text('Result : '), psg.Text(key='-OUT-')],
144
   [psg.Button("Add"), psg.Button("Sub"), psg.Exit()],
145
]
146
window = psg.Window('Calculato1r', layout, size=(715, 180))
147
while True:
148
   event, values = window.read()
149
   print(event, values)
150
   if event == "Add":
151
      result = int(values['-FIRST-']) + int(values['-SECOND-'])
152
   if event == "Sub":
153
      result = int(values['-FIRST-']) - int(values['-SECOND-'])
154
   window['-OUT-'].update(result)
155
   if event == psg.WIN_CLOSED or event == 'Exit':
156
      break
157
window.close()
158

159
import PySimpleGUI as sg
160

161
# 定义布局
162
layout = [[sg.Text('Hello PySimpleGUI!')],
163
          [sg.Button('OK')],
164
          [sg.Button('continue')]]
165

166
# 创建窗口
167
window = sg.Window('aa', layout,icon = 'edit_icon.ico')
168

169
# 事件循环
170
while True:
171
    event, values = window.read()
172

173
    if event == sg.WINDOW_CLOSED or event == 'OK':
174
        break
175
    elif event == 'continue':
176
        sg.popup("aaaaaaaaaaaaaa")
177

178
# 关闭窗口
179
window.close()
180

181
import PySimpleGUI as sg
182
import os
183

184
def main():
185
    # 定义历史记录文件路径
186
    history_file = 'history.txt'
187

188
    # 创建布局
189
    layout = [
190
        [sg.Text('File 1:'), sg.InputText(key='file1'), sg.FileBrowse(initial_folder=get_last_path(history_file, 0))],
191
        [sg.Text('File 2:'), sg.InputText(key='file2'), sg.FileBrowse(initial_folder=get_last_path(history_file, 1))],
192
        [sg.Text('File 3:'), sg.InputText(key='file3'), sg.FileBrowse(initial_folder=get_last_path(history_file, 2))],
193
        [sg.Text('File 4:'), sg.InputText(key='file4'), sg.FileBrowse(initial_folder=get_last_path(history_file, 3))],
194
        [sg.Button('OK')],
195
    ]
196

197
    # 创建窗口
198
    window = sg.Window('File Selector', layout)
199

200
    while True:
201
        event, values = window.read()
202

203
        if event == sg.WINDOW_CLOSED:
204
            break
205

206
        if event == 'OK':
207
            # 保存历史记录
208
            save_history(history_file, values['file1'], values['file2'], values['file3'], values['file4'])
209

210
            # 弹出消息框
211
            sg.popup('Hello World!')
212
            break
213

214
    window.close()
215

216
def get_last_path(history_file, index):
217
    # 从历史记录文件中获取上次保存的路径
218
    if os.path.exists(history_file):
219
        with open(history_file, 'r') as file:
220
            history = file.readlines()
221
            if len(history) > index:
222
                return history[index].strip()
223
    return ''
224

225
def save_history(history_file, *paths):
226
    # 将当前选择的路径保存到历史记录文件中
227
    with open(history_file, 'w') as file:
228
        for path in paths:
229
            file.write(f'{path}\n')
230

231
if __name__ == '__main__':
232
    main()
233

234

235
import PySimpleGUI as sg
236

237
sg.theme('Default1')   # 设置当前主题
238
# 界面布局，将会按照列表顺序从上往下依次排列，二级列表中，从左往右依此排列
239
layout = [  [sg.Text('Some text on Row 1')],
240
            [sg.Text('Enter something on Row 2'), sg.InputText()],
241
            [sg.Button('Ok'), sg.Button('Cancel')] ]
242

243
# 创造窗口
244
window = sg.Window('Window Title', layout)
245
# 事件循环并获取输入值
246
while True:
247
    event, values = window.read()
248
    if event in (None, 'Cancel'):   # 如果用户关闭窗口或点击`Cancel`
249
        break
250
    print('You entered ', values[0])
251

252
window.close()
253

254

255
import PySimpleGUI as sg
256

257
layout = [[sg.Text('My one-shot window.')],
258
                 [sg.InputText()],
259
                 [sg.Submit(), sg.Cancel()]]
260

261
window = sg.Window('Window Title', layout)
262

263
event, values = window.read()
264

265
window.close()
266
text_input = values[0]
267
sg.popup('You entered', text_input) # 弹出窗口
268

269

270

271
import PySimpleGUI as sg
272
layout = [[sg.Text('Your typed chars appear here:'), sg.Text(size=(15,1), key='-OUTPUT-')],
273
          [sg.Input(key='-IN-')],
274
          [sg.Button('Show'), sg.Button('Exit')]]
275

276
window = sg.Window('Pattern 2B', layout)
277

278
while True:  # Event Loop
279
    event, values = window.read()
280
    print(event, values)
281
    if event in  (None, 'Exit'):
282
        break
283
    if event == 'Show':
284
        # Update the "output" text element to be the value of "input" element
285
        window['-OUTPUT-'].update(values['-IN-'])
286

287
window.close()
288

289
import PySimpleGUI as sg
290

291
layout = [[sg.Text('A custom progress meter')],
292
          [sg.ProgressBar(1000, orientation='h', size=(20, 20), key='progressbar')],
293
          [sg.Cancel()]]
294

295
window = sg.Window('Custom Progress Meter', layout)
296
progress_bar = window['progressbar']
297
# loop that would normally do something useful
298
for i in range(1000):
299
    # check to see if the cancel button was clicked and exit loop if clicked
300
    event, values = window.read(timeout=10)
301
    if event == 'Cancel'  or event is None:
302
        break
303
  # update bar with loop value +1 so that bar eventually reaches the maximum
304
    progress_bar.UpdateBar(i + 1)
305
# done with loop... need to destroy the window as it's still open
306
window.close()
307

308
import PySimpleGUI as sg
309
sg.theme('Default1')
310
text = sg.popup_get_file('Please enter a file name',no_window=False)
311
print(text)
312

313
import PySimpleGUI as sg
314
theme_name_list = sg.theme_list()
315
sg.theme_previewer()
316
sg.theme('Default1')
317
layout = [[sg.Text('Theme Browser')],
318
          [sg.Text('Click a Theme color to see demo window')],
319
          [sg.Listbox(values=sg.theme_list(), size=(20, 12), key='-LIST-', enable_events=True)],
320
          [sg.Button('Exit')]]
321
window = sg.Window('Theme Browser', layout)
322

323
while True:  # Event Loop
324
    event, values = window.read()
325
    if event in (None, 'Exit'):
326
        break
327
    sg.theme(values['-LIST-'][0])
328
    sg.popup_get_text('This is {}'.format(values['-LIST-'][0]))
329

330
window.close()
331

332

333

334
import PySimpleGUI as psg
335
text = psg.popup_get_text('Enter your name', title="Textbox")
336
print ("You entered: ", text)
337
file=psg.popup_get_file('Select a file',  title="File selector")
338
print ("File selected", file)
339
folder=psg.popup_get_folder('Get folder', title="Folder selector")
340
print ("Folder selected",folder)
341
ch = psg.popup_yes_no("Do you want to Continue?",  title="YesNo")
342
print ("You clicked", ch)
343
ch = psg.popup_ok_cancel("Press Ok to proceed", "Press cancel to stop",  title="OkCancel")
344
if ch=="OK":
345
   print ("You pressed OK")
346
if ch=="Cancel":
347
   print ("You pressed Cancel")
348
psg.popup_no_buttons('You pressed', ch, non_blocking=True)
349
psg.popup_auto_close('This window will Autoclose')
350

351

352

353
import PySimpleGUI as psg
354
layout = [
355
   [psg.Text('Name '), psg.Input()],
356
   [psg.Text('Address '), psg.Input()],
357
   [psg.Text('Email ID '), psg.Input()],
358
   [psg.OK(), psg.Exit()]
359
]
360
window = psg.Window('Form', layout)
361
while True:
362
   event, values = window.read()
363
   if event == psg.WIN_CLOSED or event == 'Exit':
364
      break
365
   print (event, values)
366
window.close()
367

368
import PySimpleGUI as psg
369
psg.set_options(font=('Arial Bold', 16))
370
layout = [
371
   [psg.Text('Name ', size=(15, 1)),
372
   psg.Input(key='-NM-', expand_x=True)],
373
   [psg.Text('Address ', size=(15, 1)),
374
   psg.Input(key='-AD-', expand_x=True)],
375
   [psg.Text('Email ID ', size=(15, 1)),
376
   psg.Input(key='-ID-', expand_x=True)],
377
   [psg.Text('You Entered '), psg.Text(key='-OUT-')],
378
   [psg.OK(), psg.Exit()],
379
]
380
window = psg.Window('Form', layout, size=(715, 200))
381
while True:
382
   event, values = window.read()
383
   print(event, values)
384
   out = values['-NM-'] + ' ' + values['-AD-'] + ' ' + values['-ID-']
385
   window['-OUT-'].update(out)
386
   if event == psg.WIN_CLOSED or event == 'Exit':
387
      break
388
window.close()

展开收起

FTDI module#

1
import ft4222
2
import ft4222.I2CMaster
3

4

5
# 需要在命令行使用以下命令，安装库
6
# pip install ft4222
7

8
# list devices
9
nbDev = ft4222.createDeviceInfoList()
10
for i in range(nbDev):
11
    print(ft4222.getDeviceInfoDetail(i, False))

生成音频#

1
# wav 250
2
import wave
3
import math
4
import array
5

6
# 音频参数
7
sample_rate = 44100  # 采样频率
8
duration = 60*1  # 音频时长（秒）
9

10
# 创建一个新的WAV文件
11
output_file = wave.open('output.wav', 'w')
12
output_file.setnchannels(1)  # 单声道
13
output_file.setsampwidth(2)  # 2字节，16位
14
output_file.setframerate(sample_rate)
15

16
# 生成250Hz的音频数据
17
samples = array.array('h', [0] * (sample_rate * duration))
18
amplitude = 2 ** 15 - 1  # 振幅
19

20
for i in range(len(samples)):
21
    t = float(i) / sample_rate  # 当前时间（秒）
22
    samples[i] = int(amplitude * math.sin(2 * math.pi * 250 * t))
23

24
# 将音频数据写入WAV文件
25
output_file.writeframes(samples)
26

27
# 关闭WAV文件
28
output_file.close()

展开收起

打包的时候使用:#

Terminal window

1
pyinstaller --icon=edit_icon.ico --noconsole  --onefile demo.py

pyenv#

Terminal window

1
pyenv version
2
pyenv install
3
pyenv global
4
pyenv versions
5
# 切换分支
6
pyenv global 3.7.0

Python 学习笔记基础篇#

LearnPython#

模块#

安装#

Terminal window

1
pip install pyelftools PySimpleGUI lxml numpy chardet scipy matplotlib
2
pip install pyvisa pandas shutil
3
pip install shutil openpyxl

说明#

1
# 用来暂停
2
os.system("pause")

打包应用#

Terminal window

1
# -F 表示 打包为单个文件
2
# -w 表示为没有控制台
3
# -i .\favicon.ico 添加应用图标
4
pyinstaller.exe -F -w -i .\favicon.ico .\test.py

python venv#

这是 Python 自带的包管理器，下面介绍常用命令。

Terminal window

1
# 创建环境
2
python -m venv /path/to/your/venv
3
# 激活环境 Windows
4
/path/to/your/venv/Scripts/activate
5
# 激活环境 Linux
6
source /path/to/your/venv/bin/activate
7
# 退出环境
8
deactivate

pip set#

Terminal window

1
# 导出包
2
pip freeze > requirements.txt
3
# 导入包
4
pip install -r requirements.txt
5
# pip 安装到指定路径
6
pip install package_name -t /path/to/your/directory

pip package list#

Terminal window

1
pip install vcdvcd
2
pip install python-lsp-server

pip#

方法一：打开网址,https://pypi.org/project/pip/#files

然后下载源码，解压，打开命令行，输入命令python setup.py install

输入pip --version，查看是否安装成功

方法二：打开终端，执行py get-pip.py

安装模块: pip install module-name 例如： pip install pyelftools

juypter
pillow
requests
pyinstaller

Terminal window

1
# 参数解释： F只产生一个exe，w是不使用控制台,i是图标
2
pyinstaller  -i xxx.icon -Fw demo.py

FAQ#

Q: 指定版本运行脚本？ A: py -3.7 a.py

打包#

打包的时候使用:

Terminal window

1
pyinstaller --icon=edit_icon.ico --noconsole  --onefile demo.py

图形化#

pysimplegui 5.0 版本开始收费,所以只能安装 5.0 之前的版本.

Terminal window

1
pip uninstall PySimpleGUI
2
pip install PySimpleGUI==4.70.1

markdown入门

Mon, 12 Aug 2024 23:32:56 GMT

markdown#

代码添加行数

sequenceDiagram participant BT participant Register participant DSP BT ->> Register : bit0 = 1 BT -->> DSP : trigger interrupt BT ->> Register : bit1 = 1 DSP -->> Register : read 11,and write 11 BT -->> DSP : trigger interrupt DSP -->> Register : read 00,error?

Linux常用脚本

Sun, 11 Aug 2024 20:18:23 GMT

Linux 系统介绍#

环境搭建#

Terminal window

1
# 容易缺失的软件库
2
sudo apt install lib32z1 lib32ncurses5 lib32bz2-1.0
3

4
# tftp搭建
5

6
# nfs环境搭建

资源#

网站	网址
内核官网	https://kernel.org/
uboot 官网	https://www.denx.de/wiki/U-Boot
uboot 源码	https://github.com/u-boot/u-boot/tree/master
Uboot 下载	https://ftp.denx.de/pub/u-boot/
嵌入式 Linux WiKi	https://elinux.org/Main_Page
Buildroot	https://buildroot.org/
交叉打包工具	https://crosstool-ng.github.io/

软件列表#

Terminal window

1
# 必装软件
2
sudo apt install  build-essential vim git wget tldr unzip zip aptitude
3
# document
4
sudo apt install texlive-full emacs pandoc
5
# font
6
sudo apt install fonts-wqy-microhei fonts-wqy-zenhei
7
# python3 and pip
8
sudo apt install python-is-python3 python3-pip
9
# juypter
10
sudo apt install python3-ipykernel
11
# 小工具
12
sudo apt install ascii

常用命令#

Terminal window展开收起

1
# 开机启动命令行界面
2
sudo systemctl set-default multi-user.target
3
# 开机启动图形化界面
4
sudo systemctl set-default graphical.target
5
# 查看所有中文字体
6
fc-list :lang=zh
7

8
# 当脚本中需要root密码 "passwd"
9
# echo "passwd" | sudo -S <cmd_xxxx>
10

11
# 桌面安装
12
sudo apt-get install gnome-shell ubuntu-gnome-desktop unity-tweak-tool gnome-tweak-tool
13
# 编译环境配置
14
sudo apt install cmake build-essential python-is-python3
15
# 压缩解压
16
tar -cvf demo.tar
17
tar -zcvf demo.tar.gz
18
tar -jcvf demo.tar.bz2
19
tar -xvf demo.tar
20
tar -jxvf demo.tar.bz2
21
tar -zxvf demo.tar.gz

展开收起

压缩解压文件命令#

Terminal window

1
# 1. 使用 tar 压缩文件
2
# 该命令表示压缩当前文件夹下的文件夹 test，压缩后缀名为 test.tar.gz
3
tar -zcvf test.tar.gz ./test/
4
# 如果不需要压缩成 gz，只需要后缀为tar格式的，那么输入如下命令：
5
tar -cvf test.tar ./test/
6

7
# 1. 使用 tar 解压文件
8
# 该命令表示把后缀为.tar.gz 的文件解压到当前文件夹下。
9
tar -xzvf test.tar.gz
10
# 如果压缩文件的后缀是.tar，没有gz，则使用命令:
11
# tar -xvf test.tar

FAQ#

新安装的 debian 系统，如何添加用户并获取 root 权限#

首先切换到 root 用户，然后执行以下命令：

Terminal window

1
# 创建用户
2
sudo useradd -s /bin/bash -m {username}
3
# 设置密码
4
sudo passwd {username}
5
# 添加到root权限组
6
sudo usermod -aG sudo {username}

修改时区？#

tzselect 设置, ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

Linux 免密码登录#

Terminal window

1
mkdir .ssh
2
mv id_rsa.pub .ssh
3
cd .ssh
4
cat id_rsa.pub >> authorized_keys
5
sudo chmod 600 authorized_keys
6
service sshd restart

vnc 服务配置#

1
#!/bin/sh
2
unset SESSION_MANAGER
3
unset DBUS_SESSION_BUS_ADDRESS
4
startxfce4 &

在 /etc/systemd/system/vncserver@.service 文件中修改。

更改 Debian 12 bookorm 镜像源#

可能 https 存在认证问题先将源中的 https 改为 http，安装如下软件后再改回来，sudo apt install apt-transport-https ca-certificates

Terminal window

1
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
2
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
3
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
4
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
5
# deb https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
6

7
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
8
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
9
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
10
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
11
# deb-src https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware

资源#

网站	网址
内核官网	https://kernel.org/
uboot 官网	https://www.denx.de/wiki/U-Boot
Uboot ftp 下载地址	https://ftp.denx.de/pub/u-boot/
嵌入式 Linux WiKi	https://elinux.org/Main_Page
Buildroot	https://buildroot.org/
交叉打包工具	https://crosstool-ng.github.io/

Debian 12 bookorm 镜像源#

可能 https 存在认证问题先将源中的 https 改为 http，安装如下软件后再改回来 sudo apt install apt-transport-https ca-certificates

Terminal window

1
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
2
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
3
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
4
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
5
# deb https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
6

7
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
8
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
9
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
10
# deb-src https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
11
# deb-src https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware

软件列表#

Terminal window

1
# 必装软件
2

3
sudo apt install  build-essential vim git wget tldr unzip zip aptitude
4
# document
5
sudo apt install texlive-full emacs pandoc
6
# font
7
sudo apt install fonts-wqy-microhei fonts-wqy-zenhei
8
# python3 and pip
9
sudo apt install python-is-python3 python3-pip
10
# juypter
11
sudo apt install python3-ipykernel
12
# 小工具
13
sudo apt install ascii

常用命令#

Terminal window展开收起

1
# 开机启动命令行界面
2
sudo systemctl set-default multi-user.target
3
# 开机启动图形化界面
4
sudo systemctl set-default graphical.target
5
# 查看所有中文字体
6
fc-list :lang=zh
7

8
# 当脚本中需要root密码 " "
9
# echo " " | sudo -S <cmd_xxxx>
10

11
# 桌面安装
12
sudo apt-get install gnome-shell ubuntu-gnome-desktop unity-tweak-tool gnome-tweak-tool
13
# 编译环境配置
14
sudo apt install cmake build-essential python-is-python3
15
# 压缩解压
16
tar -cvf demo.tar
17
tar -zcvf demo.tar.gz
18
tar -jcvf demo.tar.bz2
19
tar -xvf demo.tar
20
tar -jxvf demo.tar.bz2
21
tar -zxvf demo.tar.gz

展开收起

FAQ#

Q	A
修改时区？	`tzselect`设置,`ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime`

Q: Linux 免登录? A:

Terminal window

1
mkdir .ssh
2
mv id_rsa.pub .ssh
3
cd .ssh
4
cat id_rsa.pub >> authorized_keys
5
sudo chmod 600 authorized_keys
6
service sshd restart

Linux Config#

vnc 配置#

1
#!/bin/sh
2
unset SESSION_MANAGER
3
unset DBUS_SESSION_BUS_ADDRESS
4

5
startxfce4 &

在/etc/systemd/system/vncserver@.service文件中，注意修改

Linux 学习记录#

常用命令说明#

使用 tar 压缩文件

tar -zcvf test.tar.gz ./test/

该命令表示压缩当前文件夹下的文件夹 test，压缩后缀名为 test.tar.gz

如果不需要压缩成 gz，只需要后缀为 tar 格式的，那么输入如下命令：

tar -cvf test.tar ./test/

使用 tar 解压文件

tar -xzvf test.tar.gz

该命令表示把后缀为.tar.gz 的文件解压到当前文件夹下。

如果压缩文件的后缀是.tar，没有 gz，则使用命令:

tar -xvf test.tar

嵌入式 Linux 开发#

网络资源#

环境搭建#

Terminal window

1
# 编译器等
2

3
# 容易缺失的软件
4
sudo apt install lib32z1 lib32ncurses5 lib32bz2-1.0
5

6
# tftp搭建
7

8
# nfs环境搭建

uboot#

Linux kernel#

rootfs#

常用脚本#

安装软件#

1
#!/bin/bash
2

3
# 升级系统
4
UPDATE_SYSTEM=true
5

6
# 安装常用软件
7
INSTALL_SOFTWARE=true
8

9
# 安装xfce4
10
INSTALL_XFCE=true
11

12
# 安装并配置远程桌面
13
INSTALL_XRDP=true
14

15
# 更新系统
16
if [ "$UPDATE_SYSTEM" = true ]; then
17
    sudo apt update && sudo apt upgrade -y
18
fi
19

20
# 安装常用软件
21
if [ "$INSTALL_SOFTWARE" = true ]; then
22
    sudo apt install -y vim   build-essential
23
    sudo apt install -y git wget neofetch
24
fi
25

26
# 安装xfce4
27
if [ "$INSTALL_XFCE" = true ]; then
28
    sudo apt install -y xrdp xfce4
29
fi
30

31
# 安装并配置远程桌面
32
if [ "$INSTALL_XRDP" = true ]; then
33
    # Configure XRDP to use Xfce
34
    sudo sed -i 's/^test -x/#test -x/' /etc/xrdp/startwm.sh
35
    sudo bash -c 'echo "startxfce4" >> /etc/xrdp/startwm.sh'
36
    # Restart XRDP service
37
    sudo systemctl restart xrdp
38
    # Enable XRDP to start on boot
39
    sudo systemctl enable xrdp
40
    # Allow RDP connections through the firewall
41
    sudo ufw allow 3389/tcp
42
    echo "XRDP installation and configuration completed."
43
fi
44

45
#
46
if [ "$INSTALL_TEXLIVE_FULL" = true ]; then
47
    sudo apt install texlive-full fonts-wqy-zenhei
48
fi

展开收起

常用软件的常用命令#

TMUX#

tmux 是一个终端复用软件，可以用来在一个终端窗口中创建多个会话，每个会话中可以运行多个命令，并且可以同时在多个窗口中进行交互。

显示帮助：Ctrl+b ?
新建会话：tmux new -s session_name
连接会话：tmux a -t session_name
断开会话：Ctrl+b d
新建窗口：Ctrl+b c
重命名窗口：Ctrl+b ,
切换窗口：Ctrl+b w
切换到上一个窗口：Ctrl+b p
切换到下一个窗口：Ctrl+b n
关闭窗口：Ctrl+b &
列出所有会话：tmux ls

VNC#

首先输入指令安装 vnc 服务器sudo apt install tightvncserver，如果没有 xfce4 桌面，还需要安装 xfce4 桌面环境。然后在用户加目录下面执行tightvncserver，会提示输入密码，要求至少六个字符。输入密码后，会自动创建.vnc文件夹。然后在终端中输入以下指令：

1
cat>.vnc/xstartup<<EOF
2
#!/bin/sh
3
unset SESSION_MANAGER
4
unset DBUS_SESSION_BUS_ADDRESS
5
startxfce4 &
6
EOF

此时直接输入vncserver :1即可运行服务端，默认端口为5901。关闭则输入命令：vncserver -kill :1。

每次都手动执行比较麻烦，所以可以按照以下方法设置 VNC 自启动设置：在 bash 中执行命令sudo vim /etc/systemd/system/vncserver@.service，将下面的内容写入其中。 注意修改用户名以及相应的群组和目录

Terminal window

1
[Unit]
2
Description=Start TightVNC server at %i startup
3
After=syslog.target network.target
4
[Service]
5
Type=forking
6
User=haps
7
Group=haps
8
WorkingDirectory=/home/haps
9
PIDFile=/home/haps/.vnc/%H:%i.pid
10
ExecStartPre=-/usr/bin/vncserver -kill :%i > /dev/null 2>&1
11
ExecStart=/usr/bin/vncserver -depth 24 -geometry 1024x768 :%i
12
ExecStop=/usr/bin/vncserver -kill :%i
13
[Install]
14
WantedBy=multi-user.target

然后执行下面的命令：

Terminal window

1
# 更改配置文件后需要重新加载
2
sudo systemctl daemon-reload
3
# 设置为开机自启动
4
sudo systemctl enable vncserver@1.service
5
# 立即启动
6
sudo systemctl start vncserver@1.service
7
# 查看状态
8
sudo systemctl status vncserver@1.service

关键在于系统服务配置文件中，ExecStartPre命令需要添加-，表示该命令执行失败后会继续执行。不加则会因为该命令执行失败，后续命令不执行。

VScode使用教程

Sun, 11 Aug 2024 20:05:18 GMT

安装#

卸载#

控制面板卸载 vscode
Win+r 输入%appdata%,删除 code 文件夹
用户文件夹删除.code 文件夹

Terminal window

1
rm C:\Users\G3\.vscode-insiders
2
rm C:\Users\G3\AppData\Roaming\Code - Insiders

插件列表#

Azure Repos
github repositor
learn-markdown
Markdown All in One
Markdown PDF
Markdown Preview Enhanced
Office Viewer(Markdown Editor)
prettier
remote
Sort lines
ToDo Tree
vscode-pandoc
vscode-pdf
Write Timestamp
WSL
XML

特殊操作#

关闭缓存，避免占用磁盘空间太大,json 文件中添加"C_Cpp.intelliSenseCacheSize": 0,
打开按键输入显示 screencast mode

操作说明#

删除重复行 打开命令台输入 lines，找到=delete duplicate lines= 删除含有某些关键字的行 .*(word1|word2|word3).* 自动折行 设置搜索 word wrap 或者快捷键 Alt+Z

Windows零散配置汇总

Thu, 13 Jun 2024 22:10:06 GMT

Windows 系统#

如何在安装 windows11 时跳过联网？ 安装界面+F10 进入 cmd，cmd 窗口输入 oobe\bypassnro 回车即可
微软账户连接慢，怎么解决？ 设置-网络和 Internet-高级网络设置-更多网络适配器选项 WLAN-属性-IPv4 DNS，服务器选择 4.2.2.1 和 4.2.2.2
windows 下进入恢复模式 在已经打开了 Windows 系统的情况下，可以直接输入shutdown /r /o /t 0
关闭 edge 广告 在 Edge 地址栏输入 edge://flags#,搜索 edge-show-feature-recommendations,设置为 Disabled
删除 edge 浏览器账户 改用本地（停止在线账户），然后在设置-账户-电子邮件账户里面删除账户
远程桌面连接错误 Win+R.msc 本地策略->安全选项帐户: 空白密码禁用
开启开机自动支持远程，不需要先登录 打开计算机管理-服务，Remote Desktop Services设置为自动
开始菜单图标不刷新 打开任务管理器搜索”开始”，然后关闭
Hiberfil.sys 文件占用大 这是系统休眠文件，如果在终端中输入powercfg -h off，会自动删除该文件，但也会关闭休眠模式
ssh-keygen 使用 ssh-keygen -t rsa -C "zhang.san@xxx.com"
如何免登录安装 store 软件？ 在官方网站搜索软件，找到软件链接粘贴到解析网站中下载,官方网站, 解析网站
在 powershell 中快速文件资源管理器在当前路径:ii .(是Invoke-Item的缩写)

Windows 系统变量#

名称	描述
%AppData%	指向当前用户的用户文件夹
%CommonProgramFiles%	指向共享的程序文件夹
%LocalAppData%	指向当前用户的本地应用程序数据文件夹
%ProgramData%	指向所有用户的共享程序数据文件夹
%ProgramFiles%	指向 C:\Program Files
%Public%	指向公共用户文件夹，可用于存放共享文件
%SystemRoot%	指向 Windows 操作系统的安装目录，通常为 C:\Windows
%Temp%	指向当前用户的临时文件夹，用于存放临时文件
%username%	用户名
%UserProfile%	`C:\Users\用户名`

powershell#

Terminal window

1
# 打印path，使用';'分割
2
$env:path -split";"
3

4
# 添加环境变量
5
$addPath=‘D:/Program Files/SEGGER/SEGGER Embedded Studio for RISC-V 6.22a/bin;D:/Program Files/SEGGER/SEGGER Embedded Studio for RISC-V 6.22a/gcc/riscv32-none-elf/bin;D:\Program Files\ArmGNUToolchain\arm-gnu-toolchain-13.2.Rel1-mingw-w64-i686-arm-none-eabi\bin;D:\Program Files\mingw64\bin;D:\Program Files\w64devkit\bin;’;
6
$target=‘User’;
7
$path = [Environment]::GetEnvironmentVariable(‘Path’, $target);
8
$newPath = $path + ‘;’ + $addPath;
9
[Environment]::SetEnvironmentVariable(“Path”, $newPath, $target)

winget#

Terminal window

1
# --accept-package-agreements 接受所有安装过程中的协议
2
winget install Google.Chrome --accept-package-agreements

WSL 安装与卸载#

安装链接

Terminal window展开收起

1
# 系统备份迁移步骤
2
wsl --update # 升级
3
wsl --shutdown # 关机
4
wsl -l -v # 查看 #导出系统
5
wsl --export Debian "D:\Linux\wsl-debian.tar"
6
# 卸载虚拟机
7
wsl --unregister Debian
8
# 导入虚拟机
9
wsl --import Debian "D:\Linux" "D:\wsl-debian.tar" --version 2
10
# 打开 "C:\Windows\System32" 目录，打开 powershell，切换到管理员
11
Start-Process powershell -Verb runAs
12
# 管理员权限运行
13
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
14
# 设置默认用户
15
# 先找到debian.exe的安装位置,可以用everthing找
16
# debian config --default-user {user-name}
17
debian.exe config --default-user debian
18
# 重启电脑然后执行升级命令
19
wsl --update
20
# 图形化
21
https://learn.microsoft.com/zh-cn/windows/wsl/tutorials/gui-apps

展开收起

挂载硬盘：

Terminal window

1
wmic diskdrive list brief
2
wsl --mount \\.\PHYSICALDRIVE0
3
sudo apt install ca-certificates

常见问题与答案#

ssh 相关#

在 windows terminal 中使用 ssh 连接远程主机的时候如果出现提示WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!，那么需要使用ssh-keygen -R XX.XX.XX.XX移除之前的主机信息，然后重新连接。

Powershell#

无法加载文件 xxx.ps1，因为在此系统上禁止运行脚本。解决办法: 输入get-executionpolicy查看策略,更改策略 set-executionpolicy remotesigned.

远程桌面相关#

没设置密码导致连接失败：按 win+R 输入secpol.msc,然后依次点击本次策略-安全选项，选择账户：使用空密码的本地账户只允许进行控制台登录,将其禁用即可。
远程桌面必须先登录才能远程：打开计算机管理，服务和应用程序，找到Remote Desktop Service,设置为自启动即可。

如何关闭休眠模式？#

关闭休眠模式：管理员权限运行 cmd，输入powercfg -h off，关闭休眠。

hexo搭建与使用

Mon, 10 Jun 2024 19:41:27 GMT

环境搭建(必选)#

总体来说，环境搭建首先是安装 git 等相关软件，以及拥有 github 帐号。然后设置 git 和 github 以及创建仓库，最后本地创建 hexo 的构建网页的环境，然后将其链接到 github 仓库上即可，下面分别介绍如何操作。

准备工具#

github 账户
git
nodejs
域名(可选)

首先安装 git 和 nodejs 软件，全部点击下一步，保持默认安装即可。然后在终端中(cmd 或 powershell)输入以下命令检测安装是否成功：

Terminal window

1
git  -v
2
node -v
3
npm  -v

git 与 github 账户设置#

首先创建 github 账户，这里不介绍如何创建，然后安装 git 软件。打开Git Bash，输入以下命令进行账户和邮件的配置。

Terminal window

1
git config --global user.name "用户名"
2
git config --global user.email "注册github的邮箱"

然后创建 ssh 密钥，用来给 hexo 程序进行上传和连接使用。

在Git Bash中输入：

Terminal window

1
ssh-keygen -t rsa -C "邮箱"

然后一直点击下一步知直到创建完成，打开C:\Users\用户名\.ssh目录下找到id_rsa.pub(如果没有，请打开隐藏文件显示)，然后使用记事本打开该文件并全选复制下来。

打开 github 网页，在Settings中选择SSH and GPG keys，点击New SSH key。名称自己定义一个，然后把刚刚复制的内容粘贴到Key中，保存即可。

切换到Git Bash中，输入ssh -T git@github.com检测是否连接成功。出现以下信息表示成功：

Terminal window

1
You've successfully authenticated, but GitHub does not provide shell access.

创建仓库#

打开 github 网页，在自己的主页上，点击repositories然后点击New，出现创建仓库的页面。

然后在Repository name*中输入用户名加上 github.io 的后缀，例如用户名为qwer，则实际仓库名填写qwer.github.io，填好后点击Create repository即可创建完成。

然后测试是否正确，在浏览器中输入网址并访问：https://qwer.github.io,注意这里的qwer需要替换为你的用户名。如果一切正常，将会显示用户名以及该网址和该仓库的描述信息。

hexo 本地构建网页#

在你想存放的位置创建一个文件夹用来保存 hexo 构建网页的环境，例如D:/hexo文件夹，然后打开Git Bash在此目录下。然后安装顺序执行以下命令：

Terminal window

1
# 安装hexo
2
npm install -g hexo-cli
3
# 初始化hexo
4
hexo init

如果一切正常，将输出以下信息：

Terminal window

1
INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
2
INFO  Install dependencies
3
INFO  Start blogging with Hexo!

接下来执行：

Terminal window

1
# 安装组件
2
npm install

如果一切正常，将输出以下信息：

Terminal window

1
added 1 package, and audited 227 packages in 1s
2

3
23 packages are looking for funding
4
  run `npm fund` for details
5

6
found 0 vulnerabilities

然后输入hexo g生成页面，log 如下所示：

Terminal window展开收起

1
INFO  Validating config
2
INFO  Start processing
3
INFO  Files loaded in 277 ms
4
INFO  Generated: archives/2024/06/index.html
5
INFO  Generated: archives/index.html
6
INFO  Generated: archives/2024/index.html
7
INFO  Generated: index.html
8
INFO  Generated: fancybox/jquery.fancybox.min.js
9
INFO  Generated: js/script.js
10
INFO  Generated: css/style.css
11
INFO  Generated: fancybox/jquery.fancybox.min.css
12
INFO  Generated: js/jquery-3.6.4.min.js
13
INFO  Generated: css/images/banner.jpg
14
INFO  Generated: 2024/06/10/hello-world/index.html
15
INFO  11 files generated in 310 ms

展开收起

然后执行hexo s命令，打开浏览器输入http://localhost:4000进行预览。

链接 hexo 本地环境与 github 仓库#

上面只是在浏览器中预览本地的内容，别人无法通过网络进行访问。所以还需要将 hexo 与 github 链接到一起。首先需要安装hexo-deployer-git插件，在上面打开的Git Bash中输入命令：

Terminal window

1
npm install -g hexo-deployer-git

然后修改D:\hexo\_config.yml（注意路径需要修改到你自己创建的目录），将该文件末尾的以下内容:

1
deploy:
2
  type: ""

改为如下：

1
deploy:
2
  type: git
3
  repo: git@github.com:qwer/qwer.github.io.git
4
  branch: gh-pages

然后在Git Bash中依次输入：

Terminal window

1
# 1. clean： 清除非必要文件
2
hexo c
3
# 2. deploy：先生成博客，然后将代码上传到github仓库中
4
hexo d -g

上传完毕后，打开浏览器，进入 github 网页，在该仓库的Settings中，点击Pages，将Branch改为gh-pages（来自上面修改的_config.yml文件）。

稍等片刻后，在浏览器中访问：https://qwer.github.io就可以访问到默认的内容。到这里就搭建好了。

但是目前只有一篇默认的文章，所以还需要说明一下如何进行创建新的文章。

发布文章(必选)#

参考官方文档

更改域名(可选)#

以阿里云为例#

首先打开阿里云的控制台，选择云解析 DNS-域名解析-解析设置，然后选择添加记录，记录类型选择CNAME，主机记录输入自己想要定义的域名前缀。然后点击确认即可保存该记录。官方参考

这个前缀结合后面的域名共同组成了一个完整地址，hexo 中会使用该地址。

hexo 部分设置#

在本地的目录下D:\hex\source,新建一个文件叫CNAME,注意没有后缀名称。然后输入域名(从上一小节中，添加的CNAME中的内容)。

github 部分的设置#

然后打开 github，参考以下内容修改 DNS 域名解析的相关设置。github 官方文档

到这里，域名更改就彻底结束，后面可以通过方位自己的域名，访问博客。

主题美化(可选)#

fluid主题仓库

常用功能#

关于草稿的使用#

Terminal window

1
# 新建草稿
2
hexo new draft <title>
3
# 预览本机草稿
4
hexo S --draft
5
# 发布草稿(只是将移动到post)，然后按照post去处理即可
6
hexo P <filename>
7
# 正式文章转草稿，可以直接将文章从post移动到draft即可
8

9
#  一条命令搞定：清除，生成，启动
10
hexo clean ; hexo s -g

Firefly 代码块示例

Sat, 03 Jan 1970 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log('此代码有语法高亮!')

渲染 ANSI 转义序列#

Terminal window

1
ANSI colors:
2
- Regular: Red Green Yellow Blue Magenta Cyan
3
- Bold:    Red Green Yellow Blue Magenta Cyan
4
- Dimmed:  Red Green Yellow Blue Magenta Cyan
5

6
256 colors (showing colors 160-177):
7
160 161 162 163 164 165
8
166 167 168 169 170 171
9
172 173 174 175 176 177
10

11
Full RGB colors:
12
ForestGreen - RGB(34, 139, 34)
13

14
Text formatting: Bold Dimmed Italic Underline

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log('标题属性示例')

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx展开收起

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

展开收起

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

展开收起

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

Firefly 布局系统详解

Sat, 03 Jan 1970 00:00:00 GMT

📖 概述#

Firefly 提供了灵活的布局系统，允许您根据内容需求和个人喜好自定义博客的视觉呈现方式。布局系统主要包括侧边栏布局和文章列表布局两个维度，它们相互配合，共同决定了页面的整体结构。

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

左侧边栏布局

右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

可以通过showBothSidebarsOnPostPage配置是否在文章详情页显示双侧边栏

当position为left或right时开启此项后，文章详情页将显示双侧边栏，主页等其他页面保持单侧边栏

适用在只想用单侧栏，但在文章详情页想用对侧栏的目录等组件的场景

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
  showBothSidebarsOnPostPage: true, // 是否在文章详情页显示双侧边栏
5
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list", // 列表模式
4
    allowSwitch: true,   // 允许用户切换
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    allowSwitch: true,
5
    grid: {
6
      masonry: true,      // 开启瀑布流
7
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
8
    },
9
  },
10
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
列表模式 -> 网格模式：当屏幕宽度小于 380px（超小屏设备）时，列表模式会自动切换为网格模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly 文章加密

Fri, 02 Jan 1970 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

KaTeX 数学公式示例

Fri, 02 Jan 1970 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

CHX4+2 OX2→COX2+2 HX2O\ce{CH4 + 2O2 -> CO2 + 2H2O}CHX4+2OX2COX2+2HX2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

MDX 格式文章示例

Fri, 02 Jan 1970 00:00:00 GMT

Tip

Firefly 支持 MDX 和 Markdown 两种类型的文章，你可以在文章中混合使用两种格式，如果没有特别复杂内容和需求，推荐使用 Markdown 格式就够了。

Markdown 和 MDX 的区别#

Markdown (MD) 是一种轻量级标记语言，允许用户使用纯文本格式编写文档，然后将其转换为格式化的HTML。它因其简洁易用的语法而广受欢迎，特别适合编写文档和博客文章。
MDX 是一种扩展了 Markdown 语法的格式，允许在 Markdown 文档中无缝地插入 JSX 代码。通过 MDX，用户可以在文档中嵌入 React 组件，从而实现更丰富的交互性和动态性。

特性	Markdown	MDX
基础语法	支持 (CommonMark)	支持 (CommonMark)
HTML 标签	支持	支持 (作为 JSX)
组件导入	不支持	支持 (import)
动态数据	不支持	支持 (JS 表达式)
样式定制	有限 (class/style)	灵活 (className/CSS-in-JS)

使用组件#

这是一个图标组件：

1
import { Icon } from 'astro-icon/components'
2

3
<div class="flex items-center gap-2 my-4">
4
  <Icon name="fa7-solid:rocket" class="text-4xl text-red-500" />
5
  <span>火箭发射！</span>
6
</div>

火箭发射！

使用 JSX#

你也可以直接写 HTML/JSX：

1
<div className="p-4 bg-blue-100 dark:bg-blue-900 rounded-lg my-4">
2
  这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。
3
</div>

这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。

简单的变量导出#

1
export const year = new Date().getFullYear()
2

3
今年是 {year} 年。

今年是 2026 年。

更多信息，请查看 MDX 文档

Markdown 扩展功能

Thu, 01 Jan 1970 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

Waiting for api.github.com...

00K

Waiting...

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了三种风格的提醒框主题：GitHub、Obsidian 和 VitePress。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

展开收起

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

展开收起

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

展开收起

VitePress

4. Docusaurus 风格语法#

仅支持语法，风格保持跟上面三个主题相同。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip important warning caution

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::important
10
用户成功所必需的关键信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::caution
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

展开收起

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](./images/firefly1.avif)
3
![示例图片二](./images/firefly2.avif)
4
![示例图片二](./images/firefly3.avif)
5
[/grid]

Markdown Mermaid 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、甘特图、类图和状态图。

流程图示例#

流程图非常适合表示流程或算法步骤。

graph TD A[开始] --> B{条件检查} B -->|是| C[处理步骤 1] B -->|否| D[处理步骤 2] C --> E[子过程] D --> E subgraph E [子过程详情] E1[子步骤 1] --> E2[子步骤 2] E2 --> E3[子步骤 3] end E --> F{另一个决策} F -->|选项 1| G[结果 1] F -->|选项 2| H[结果 2] F -->|选项 3| I[结果 3] G --> J[结束] H --> J I --> J

时序图示例#

时序图显示对象之间随时间的交互。

sequenceDiagram participant User as 用户 participant WebApp as 网页应用 participant Server as 服务器 participant Database as 数据库 User->>WebApp: 提交登录请求 WebApp->>Server: 发送认证请求 Server->>Database: 查询用户凭据 Database-->>Server: 返回用户数据 Server-->>WebApp: 返回认证结果 alt 认证成功 WebApp->>User: 显示欢迎页面 WebApp->>Server: 请求用户数据 Server->>Database: 获取用户偏好 Database-->>Server: 返回偏好设置 Server-->>WebApp: 返回用户数据 WebApp->>User: 加载个性化界面 else 认证失败 WebApp->>User: 显示错误消息 WebApp->>User: 提示重新输入 end

甘特图示例#

甘特图非常适合显示项目进度和时间线。

gantt title 网站开发项目时间线 dateFormat YYYY-MM-DD axisFormat %m/%d section 设计阶段需求分析 :a1, 2023-10-01, 7d UI设计 :a2, after a1, 10d 原型创建 :a3, after a2, 5d section 开发阶段前端开发 :b1, 2023-10-20, 15d 后端开发 :b2, after a2, 18d 数据库设计 :b3, after a1, 12d section 测试阶段单元测试 :c1, after b1, 8d 集成测试 :c2, after b2, 10d 用户验收测试 :c3, after c2, 7d section 部署生产环境部署 :d1, after c3, 3d 发布 :milestone, after d1, 0d

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

classDiagram class User { +String username +String password +String email +Boolean active +login() +logout() +updateProfile() } class Article { +String title +String content +Date publishDate +Boolean published +publish() +edit() +delete() } class Comment { +String content +Date commentDate +addComment() +deleteComment() } class Category { +String name +String description +addArticle() +removeArticle() } User "1" -- "*" Article : 写作 User "1" -- "*" Comment : 发表 Article "1" -- "*" Comment : 拥有 Article "1" -- "*" Category : 属于

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

stateDiagram-v2 [*] --> 草稿草稿 --> 审核中 : 提交审核中 --> 草稿 : 拒绝审核中 --> 已批准 : 批准已批准 --> 已发布 : 发布已发布 --> 已归档 : 归档已发布 --> 草稿 : 撤回 state 已发布 { [*] --> 活跃活跃 --> 隐藏 : 临时隐藏隐藏 --> 活跃 : 恢复活跃 --> [*] 隐藏 --> [*] } 已归档 --> [*]

饼图示例#

饼图非常适合显示比例和百分比数据。

pie title 网站流量来源分析 "搜索引擎" : 45.6 "直接访问" : 30.1 "社交媒体" : 15.3 "推荐链接" : 6.4 "其他来源" : 2.6

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了如何使用流程图、时序图、甘特图、类图、状态图和饼图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。Mermaid 会自动将这些描述转换为美观的可视化图表。

尝试在您的下一篇技术博客文章或项目文档中使用 Mermaid 图表 - 它们将使您的内容更加专业且更易理解！

Markdown 教程

Thu, 01 Jan 1970 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

在文章中嵌入视频

Thu, 01 Jan 1970 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

Firefly

Firefly 一款清新美观的 Astro 博客主题模板

🌟 项目概述#

🚀 技术架构#

📖 配置说明#

Firefly 简单使用指南

文章的 Front-matter#

文章文件的放置位置#

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 使用示例#

示例 1：使用文件名作为 URL#

示例 2：自定义 Slug#

示例 3：其他语言文件名使用Slug#

Slug 使用建议#

注意事项#

test

用来测试 一级标题#

二级标题#

深度工作 读书笔记

深度工作#

理论#

深度工作的价值#

为什么深度工作少见？#

深度工作的意义#

实践#

Python GUI

图形化#

Python 零散脚本

test#

Life

I2C_pull_up_reg

I2C上拉电阻选择#

计算公式#

二、快速选型速查表#

三、总结与决策路径#

补充说明: 0.8473 的数学推导（RC 充电方程）#

git基础教程与常用操作

git 快速入门教程#

版本控制的概念#

安装配置#

安装 git#

配置 git#

配置 SSH (可选)#

配置文件设置 (可选)#

常用命令#

git 多账户配置 (可选)#

工作流程#

FAQ#

相关资源链接#

常见问题#

Windows电脑入门教程

电脑入门教程#

如何解决电脑问题？#

电脑组成说明#

认识键盘和鼠标#

Windows 系统介绍#

系统自带功能#

常用软件介绍#

文件资源管理器#

网络浏览器#

压缩解压软件#

文档编辑#

网盘同步软件#

好用软件推荐#

Python相关知识

Python 常用脚本#

CH341A 模块#

FTDI 模块#

python venv#

pip set#

pip package list#

LearnPython#

模块#

安装#

说明#

打包应用#

wav 250#

音频参数#

创建一个新的 WAV 文件#

用来测试一级标题#

深度工作读书笔记