1   语言编码的区别

• zh-CN：中国大陆区域的中文。包括各种大方言、小方言、繁体、简体等等都可以被匹配到。
• zh-Hans：简体中文。适用区域范围是全宇宙用中文简体的地方，内容包括各种用简体的方言等。

2   linux和windows之间的文件换行符

windows中的换行符（dos）是\r\n，而linux中的换行符（unix）是\n。若不转换，git可能会视作为被更改的文件，从而造成大量无意义的commit。此外，windows中bat脚本文件要求换行符为\r\n，否则cmd解释器无法正确解析，导致无法正确执行脚本。

单文件转换：

• \r\n转\n：dos2unix test.c
• \n转\r\n：unix2dos test.c

批量转换：

• \r\n转\n：find . -type f -exec dos2unix {} \;
• \n转\r\n：find . -type f -exec unix2dos {} \;

详细命令解释：

1
2
3
4
5
6
7
8
9
10

find .: Find anything in this directory, including its subdirectories, and anything in those subdirectories as well (recursion)
-type f: Only return 'regular file' names. Exclude folder names from the results.
-exec: Execute the following command for every result. Everything beyond this point should be treated as part of that command until the ; character is found.
dos2unix: dos2unix will be executed with the following options...
-k: Keep the date stamp of the output file the same as the input file
-s: Skip binary files (images, archives, etc.). This option is included by default, but I use it anyway in case that default were different on some systems (e.g. OS X v. Debian v. CentOS v. Ubuntu v. ...).
-o: Write the changes directly to the file, rather than creating a new file with the data in the new format.
{}: This tells find to insert the filename it has found as a parameter of the dos2unix call.
';': Tell find that the params for dos2unix have ended. Anything beyond this point will again be treated as a parameter of find. 反斜杠\是用于转移分号;
'{}' is a placeholder which indicates where in the command you want the filename(s) to be inserted, and '+' terminates the said command. You can also run dos2unix once for each filename (by changing '+' with ';'), but since dos2unix accepts an arbitrary number of input arguments, it’s better to use it (as it avoids spawning many processes).

2.1   换行符问题导致git同步错误

若出现本地仓库文件和远程仓库文件出现crlf和lf不相同的问题，会导致git代码同步报错。

解决方法：使用editorconfig文件规定文档。

3   Git配置

3.1   编辑git特定的config项

打开%USERPROFILE%\.gitconfig文件，编辑特定的设置项即可。

3.2   代理设置

1
2
3
4
5
6
7
8

git config --global http.proxy http://127.0.0.1:1080
git config --global https.proxy https://127.0.0.1:1080
git config --global http.proxy 'socks5://127.0.0.1:1080'
git config --global https.proxy 'socks5://127.0.0.1:1080'

# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

3.3   关于git的重命名操作

git默认对大小写不敏感，一般可通过两种方式避免git未识别大小写操作。

方式1：中间文件方法

1
2
3

# git mv（重命名索引，文件夹直接大小写重命名可能无法成功，可以用tmp做中间处理，文件直接大小写无问题）
git mv myfolder tmp
git mv tmp MyFolder

方式2：设置git配置

1

git config core.ignorecase false

4   pull（拉取）

4.1   github从远程仓库拉取

1

git pull origin master # 相当于fetch后merge

4.2   github从上游拉取未并入主干的拉取请求(pull request)

1
2
3
4
5
6
7
8

# 添加远程上游，仓库地址填写需要拉取的上游
git remote add upstream https://github.com/USER/repository.git
# ID 填pull-request id，BRANCHNAME填准备拉取到本地的某个分支名
git pull upstream pull/ID/head:BRANCHNAME
# 切换到分支目录
git checkout BRANCHNAME
# push到自己fork之后的上游
git push -u origin BRANCHNAME

5   clone（克隆）

5.1   常规克隆

git clone http链接（可以不包含.git后缀）

5.2   wget从Github仓库下载特定的文件夹

1
2
3

# -O为输出到指定文件，-和-O配合，不输出到具体文件，而是标准输出。可通过管道符|直接给其他命令。
# -x为解压，-z为gzip解压缩，移除目录，-C指定解压路径，--strip根据数字移除后面给定目录结构参数
wget -O - https://github.com/Mister-Kin/PublicResources/archive/refs/heads/main.tar.gz | tar -xz -C path --strip=2 PublicResources-main/test

5.3   克隆特定分支

1
2
3

# 克隆特定分支，-b（--branch）支持输入tag，--recursive包含子仓库
git clone --recursive -b v1.0 url
git clone --recursive -b branch—name url

5.4   克隆远程仓库中的指定文件或者文件夹

以克隆blender手册翻译的简中为例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

mkdir locale
cd locale
# 为当前目录初始化一个git仓库
git init
# 添加上游git链接
git remote add -f origin https://projects.blender.org/blender/blender-manual-translations.git
# 设置稀疏检出的筛选目录，sparse-checkout文件里写入要拉取的文件或者文件夹。匹配规则类似.gitignore
echo "zh-hans" >> .git/info/sparse-checkout
# 或者使用sparse-checkout set命令设置设置稀疏检出的筛选目录
git sparse-checkout set 'zh-hans'
# 开启稀疏检出
git config core.sparsecheckout true
# 最后执行拉取获得特定文件或者文件夹
git pull origin main

6   commit（提交）

6.1   commit信息的规范化

规范编写的commit message可通过auto changelog发布release：

• chore
• fix
• feat
• docs

7   release（发布）

7.1   常规发布

github release create -a ../learngit/README.md -m "release my first program" v1.0.1

7.2   release note的规范化

• Breaking Changes
• Changes
• New Features
• Features
• Bug Fixes
• Improvements
• Documentation（可缩写 Docs）

注：支持……版本，英文用 Support for …… 表示

8   添加子仓库

1
2
3
4

git submodule add https://github.com/Mister-Kin/actions.git

# 启动如下功能，更新主仓，同时会执行submodule update
git config --global submodule.recurse true

9   重写历史

9.1   删除所有commit

1
2
3
4
5
6

rm -rf .git
git init
git remote add origin url（仓库地址） # git remote -v
git add .
git commit -m 'commit message'
git push --force origin master

注意如果使用这种方式，强制推送到远程github仓库的话，实际查看github网站的信息，貌似并没有缩小，可能数据更新有延迟。

还有另外一种方式，在github网站上删除该reop，并重新建立同名repo再推送。

9.2   从所有commit中清除特定文件

1
2
3
4
5

git filter-branch --index-filter 'git rm --cached --ignore-unmatch filename' HEAD #（*.pdf）
rm -rf .git/refs/original #删除git的备份
git reflog expire --all --expire=now  #使所有散落的object失效
git fsck --unreachable #检查是否有散落的object, 验证数据库中对象的连接性和有效性
git gc --aggressive --prune=now #git的垃圾清理车最终删除那些对象, --aggressive 此选项将导致git gc更积极地优化存储库

10   分支管理

10.1   常规操作

1

git branch -M master # 创建分支

10.2   多人协作的工作流

多人协作注意版本控制，分支把控好，不能污染上游，开发者每个人单独分支。

10.3   常规分支管理项目

dev分支常规开发，hotfix分支临时修复

1
2
3
4
5
6
7
8
9
10

# Switched to a new branch "dev"
git checkout -b dev
# Switched to a new branch "hotfix"
git checkout -b hotfix
# 切换到主分支
git checkout master
# 合并hotfix分支
git merge hotfix
# 删除hotfix分支
git branch -d hotfix

11   切换分支时有未提交的文件

应用场景：在dev分支进行开发编写，突然发现master分支有bug，想checkout分支（切换分支），但此时dev分支上有未提交的文件，并且也并不想现在提交。

解决方案：

1. 在dev分支上git stash，储藏当前工作区
2. checkout到master分支进行bug修复（新建bugfix分支时，完成后合并，删除）
3. checkout到dev分支，git stash list
4. git stash pop，恢复工作区（该方式恢复的同时也把stash内容删除）。（另一种方式是git stash apply（恢复）后git stash drop（删除））

12   远程仓库

12.1   重命名分支并推送到远程仓库

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# Rename the local branch to the new name
git branch -m <old_name> <new_name>

# Delete the old branch on remote - where <remote> is, for example, origin
git push <remote> --delete <old_name>

# Or shorter way to delete remote branch [:]
git push <remote> :<old_name>

# 删除失败时，请更改默认分支

# Prevent git from using the old name when pushing in the next step.
# Otherwise, git will use the old upstream name instead of <new_name>.
git branch --unset-upstream <new_name>

# Push the new branch to remote
git push <remote> <new_name>

# Reset the upstream branch for the new_name local branch
git push <remote> -u <new_name>

12.2   删除已经推送到远程仓库中的包含在.gitignore中的文件

.gitignore文件中添加新的文件过滤，但是该文件在之前已经提交到远程仓库分支里，我们需要将远程分支代码中的这个文件移除。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 1.为避免冲突，同步已下远程仓库最新代码
git pull

# 2.在本地项目目录下删除git缓存
git rm -r --cached .

# 3.add所有文件：输入以下命令，再次将项目中所有文件添加到本地仓库缓存中
git add .

# 4.本地commit
git commit -m "filter new files"

# 5.push到远程仓库
git push

12.3   unable to access github: OpenSSL SSL_read: Connection was reset, errno 10054

这是由于Http协议错误，刷新缓存即可解决

1

ipconfig /flushdns

1
2

sudo killall -HUP mDNSResponder
sudo dscacheutil -flushcache

12.4   更改已提交到远程仓库的commit消息（修改错别字或添加信息）

1. git rebase -i HEAD~n(N为最近n个提交)
2. git会生成一个文件在编辑器打开，在需要修改的commit那一行中，将pick修改为reword，保存关闭
3. 之后会弹出一个文件，在编辑器修改后保存关闭
4. 之后强制push到远程仓库

12.5   RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly: CANCEL (err 8)

因为git文件过大造成的错误，默认缓冲区是1M大小。

解决方法：

1

git config --global http.postBuffer 524288000 # 设置为500M

13   Github LFS

Github LFS是收费产品，免费账户只有1G的存储空间和带宽流量（本人已弃用）。

仓库一旦使用LFS存储，无法直接通过wget或者curl工具下载原文件，只会下载到一个文本指针文件，指向LFS的存储云地址。

13.1   为Git启用LFS

Windows Git LFS大文件管理：windows上使用Git for windows客户端程序时，LFS启用命令：git lfs install。

ubuntu安装LFS包：sudo apt install git-lfs。

13.2   LFS基本使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# 添加LFS需要管理的大文件，如果文件名就是*.txt，则需要用双引号""包含
# 若无引号，通配符*会被shell扩展，导致LFS跟踪所有txt文件
git lfs track test.txt
git lfs track *.txt
git lfs track "*.txt"
# 取消LFS跟踪文件
git lfs untrack *.txt
# 常规git操作都可以处理LFS文件，显式指定lfs命令可提高速度
git clone
git pull origin main
# git lfs clone是检出（checkout）完成后再批量下载所有必需的 Git LFS 文件。利用并行下载的优势，显著减少产生的 HTTP 请求和进程的数量
git lfs clone
# 同样地，lfs提供拉取速度
git lfs pull origin main

# 移除lfs，然后手动删除.gitattribute中关于lfs的条目
git lfs uninstall
# 重组织所有文件，可以使标记为lfs文件恢复到正常状态，但不会影响到不关联的文件。
git add --renormalize .
# 重新提交
git push origin master

14   CI/CD

重复繁琐的工作交予自动CI/CD完成。

15   参考文献

[1] How do I rename both a Git local and remote branch name?[EB/OL]. https://stackoverflow.com/questions/30590083/how‑do‑i‑rename‑both‑a‑git‑local‑and‑remote‑branch‑name.
[2] Git 中 submodule 的使用[EB/OL]. https://zhuanlan.zhihu.com/p/614114699.
[3] Why is git submodule not updated automatically on git checkout?[EB/OL]. https://stackoverflow.com/questions/1899792/why‑is‑git‑submodule‑not‑updated‑automatically‑on‑git‑checkout.
[4] git lfs安装及使用方法[EB/OL]. https://blog.csdn.net/michaelshare/article/details/83183806.
[5] Git克隆远程仓库中的指定文件或者文件夹[EB/OL]. https://blog.csdn.net/fsfsdgsdg/article/details/127177631.
[6] How to run dos2unix on all files with all extensions in a directory and its sun-directories?[EB/OL]. https://stackoverflow.com/questions/67254229/how-to-run-dos2unix-on-all-files-with-all-extensions-in-a-directory-and-its-sun.
[7] How to pull a pull request from upstream in github[EB/OL]. https://stackoverflow.com/questions/54033842/how-to-pull-a-pull-request-from-upstream-in-github.
[8] 详解 Git 大文件存储（Git LFS）[EB/OL]. https://zhuanlan.zhihu.com/p/146683392.
[9] Git Sparse Checkout使用指南[EB/OL]. https://blog.csdn.net/shelutai/article/details/123116973.
[10] git-sparse-checkout[EB/OL]. https://www.git-scm.com/docs/git-sparse-checkout.
[11] Simple steps to uninstall Git LFS from your repository[EB/OL]. https://github.com/git-lfs/git-lfs/issues/3026.
[12] zh-cn 与 zh-hans 是什么关系、有什么区别？[EB/OL]. https://www.zhihu.com/question/21980689.

1   Bash 的简介

Shell是一种特殊的交互式工具，它为用户提供了启动程序、管理文件系统中的文件以及运行在Linux系统上的进程的途径。通过命令行提示符$，它允许用户输入文本命令，然后解释命令，并在内核中执行。

Bash是GNU项目的shell，即Bourne Again SHell。这是一个由Bourne shell（sh）发展而来的shell，并且兼容sh，包含不少korn shell（ksh）和c shell（csh）的优点。大部分Linux发行版都预装了bash，并且大多数sh脚本（由多个shell命令组成的文件）无需修改即可通过bash运行。

2   shell提示符

shell命令行界面（CLI）

3   bash的配置

source ~/.bashrc
source ~/.profile
echo 'export APP=/opt/tinyos-2.x/apps' >> ~/.bashrc

3.1   删除Git Bash历史记录

在%USERPROFILE%（用户配置路径）下找到.bash_history删除即可。

4   参数表达式

4.1   前缀和后缀的获取

${file%.*}：移除最后一个点之后的内容
${file%%.*}：移除第一个点之后的内容
${file#*.}：移除第一个点之前的内容
${file##*.}：移除最后一个点之前的内容

5   test

test可以与&&组成一个条件判断，无需用if命令。

6   case

case命令，无法使用test命令。
case不能用正则表达，只用样式匹配。

7   删除特定目录下所有文件，但排除部分文件

find /path/to/directory -type f ! -name 'file_prefix*' | xargs rm -rf

8   Bash脚本加密解密

https://www.jb51.net/article/216095.htm
https://www.qcgzxw.cn/575.html

9   参考文献

[1] BLUM R, BRESNAHAN C. Linux 命令行与 shell 脚本编程大全[M]. 门佳, 武海峰, 译. 3 版. 北京: 人民邮电出版社, 2016.
[2] GNU Bash[EB/OL]. https://www.gnu.org/software/bash/.
[3] Test variable in a bash case statement[EB/OL]. https://unix.stackexchange.com/questions/205084/test‑variable‑in‑a‑bash‑case‑statement.
[4] Regular expressions in a Bash case statement[EB/OL]. https://stackoverflow.com/questions/9631335/regular‑expressions‑in‑a‑bash‑case‑statement.
[5] Adding suffix to filename during for loop in bash[EB/OL]. https://unix.stackexchange.com/questions/600051/adding‑suffix‑to‑filename‑during‑for‑loop‑in‑bash.

1   Latex环境的安装与配置

1.1   Texlive发行版的下载

• 官网导航下载地址，点击an ISO image or via torrent->download from a nearby CTAN mirror->下载最新的iso文件。
• 清华大学镜像下载地址，点击获取下载链接->应用软件->TeX 排版系统->TeX Live 2024 (Windows & Linux)。

1.2   Texlive的安装

1. 加载镜像，双击执行install-tl-windows.bat
2. 安装路径保持默认的C:/texlive/2024
3. 点击Advanced
   • N. of collections->Languages（全勾选无，然后只勾选下面三个，然后确认）
     • Chinese
     • Chinese/Japanese/Korean (base)
     • US and UK English
   • 取消勾选安装 Texworks 前端
4. 其他选项保持默认，然后点击开始安装。
5. 测试Tex安装情况。打开控制台（CMD或Powershell），输入命令测试tex -v、latex -v、xelatex -v。
   • P.S. 如果命令控制台显示找不到命令，在系统环境变量Path中添加texlive bin的路径：C:\texlive\2024\bin\windows。
6. Tex更新：控制台输入tlmgr update --all。

1.3   VS Code的相应配置

关于在VSC中建立latex的snippets 用户代码片段时，若需要输出 \ 换行命令，需要在 json 里输入六个 \\\ 才能真正输出\的，个人想法是VSC传递机制非标准化，不符合 标准的转义字符输出。

2   文档元素

2.1   图片

2.1.1   自适应缩放大小

使用width参数缩放到0.5倍的文本宽度，scale参数就是图片相对于原尺寸缩放，比较难以控制。

1
2
3
4
5
6
7
8
9
10
11
12
13

% 此处用textwidth文本宽度，或者也可以用linewidth线宽
\begin{figure}[h!]
    \includegraphics[width=0.5\linewidth]{figure}
    \caption{锚点文字}
    \label{图片注解}
\end{figure}

% 在minipage环境中，可以直接使用整倍线宽，就是minipage的宽度
\begin{minipage}[t]{0.48\linewidth}
    \includegraphics[width=\linewidth]{developer_hint}
    \caption{UI提示方案菜单：开发者模式}
    \label{开发者提示方案}
\end{minipage}

3   宏包

3.1   moderncv

moderncv的宏包是分文件编写的，具体语法参照texmf-dist\tex\latex\moderncv中的各个模块。

4   常见问题

4.1   reference.bib中参考文献中的title中写法

和LaTeX语法一样，如果有特殊符号，一样要使用反斜杠标注，例如_要写成_，不然编译会导致所有参考文献没有输出。

4.2   大型LaTeX文档中的input命令

编写大型的LaTeX文档，在子文件中的input命令的路径应输入完整，即从项目顶层路径。input命令仅仅是插入该文档，不会做其他工作。

例如项目文件夹为main，下设sub/subsub/两层文件夹，sub中的tex文件要想插入subsub中的tex文件，应为\input{sub/subsub/xxx.tex}，而非\input{subsub/xxx.tex}。原因就是input仅仅是做插入，当main中的tex文件插入sub中xxx.tex，如果仅仅输入\input{subsub/xxx.tex}，编译时main根本就找不到文件，路径缺失了sub。

5   参考文献

[1] 【latex】LaTeX调整图片大小的方法；自动调整合适的大小[EB/OL]. https://blog.csdn.net/weixin_39589455/article/details/128533896.

1   标题

• 一级标题：# 标题
• 二级标题：## 标题
• 三级标题：### 标题
• 四级标题：#### 标题
• 五级标题：##### 标题
• 六级标题：###### 标题

2   链接

链接中添加空格的方法

• 使用\&\#32
• 使用-替代空格

3   代码块

3.1   行内代码

反引号（位于tab键之上）包裹住代码内容：`代码内容`

3.2   多行代码（围栏代码块）

在代码内容前后使用三个反引号包裹住。

1
2
3

```语言关键字
代码内容
```

代码块支持语法高亮的语言关键字：

4   参考资料

[1] Markdown 官方教程[EB/OL]. https://markdown.com.cn/.
[2] MarkDown 支持高亮的语言[EB/OL]. https://blog.csdn.net/u012102104/article/details/78950290.

1   单个物体建模

2   综合场景全流程

• Blender练习总结：《CG Boost-Blender 2.8 Beginner Series》：苹果、小刀