1   Qt语法

Qt信号与槽使用方法最完整总结

2   Qt学习资料

• Qt6系列教程汇总
• Qt学习资料汇总

3   Qt程序发布的流程

1. Qt Creator开发程序
2. 选择release编译后，在源码文件夹之外会生成构建的文件夹，带有-Release尾缀，在这个目录下拷贝程序的exe二进制文件到一个新建的文件夹中。
3. 运行windeployqt工具打包动态链接文件：windeployqt program_name.exe。确保提前添加环境变量PATH：C:\Qt\qt6release\bin，否则找不到windeployqt程序。P.S. 使用vs cl终端运行windeployqt会同时拷贝vc_redist.x64.exe安装包（Microsoft Visual C++ 2015-2022 Redistributable (x64) - 14.36.32532，可以解决目标系统缺少dll动态链接库的报错），使用普通的终端运行windeployqt则不会拷贝这个文件（Warning: Cannot find Visual Studio installation directory, VCINSTALLDIR is not set.），但实际上可以手动拷贝dll动态链接库文件到程序根目录，可免去用户再次运行安装运行库。
4. NSIS打包生成安装包：创建快捷方式、创建卸载程序、界面美化（模仿网易云音乐安装包）、判断是否正在运行、判断并安装VC运行库。

3.1   单文件封包流程

除了静态编译可以单文件的打包，动态链接编译开发也可以实现，这个需要使用三方封包工具了，一般都是使用Enigma Virtual Box进行单文件的打包。

单文件打包流程：

1. 新建文件夹，拷贝qt程序exe，运行windeployqt.exe打包动态链接文件，拷贝额外的MS VC++ DLL文件
2. 打开Enigma Virtual Box，选择打包的程序
3. 选择好打包程序后会自动生成一个打包后的程序名
4. 在增加文件选项里面选择 增加文件夹[递归] ，把前面创建存放文件的文件夹包含进去
5. 在文件选项 选择压缩文件
6. 执行封包

缺点：使用Enigma Virtual Box打包的单文件，有可能会被杀毒软件识别为病毒，比如Windows Defender。

4   Qt下载

5   Qt Creator的总结

5.1   安装Qt Creator提示要求联网登录帐号

断网再打开Qt Creator的安装包，等跳过检测联网帐号的界面后就可以启用网络继续安装。

5.2   修改模板文件以便新建工程时默认支持C++20

使用程序完成批量修改：modify_qt_creator_template_files_to_support_c++20.bat

6   Qt国际化多语言的总结

QT官方多语言编程wiki参考：How to create a multi language application

1. 创建工程文件时，勾选国际化选项。
2. 打开CMakeLists.txt文件，修改${TS_FILES}对应的文件和手动生成需要的ts文件，找到if(${QT_VERSION_MAJOR} GREATER_EQUAL 6)语句，在该if语句内添加如下内容，其中untitled为项目名称。如果还需要创建对应资源文件的话，就创建languages.qrc并有qt资源编辑器打开编辑。

1
2
3
4
5
6
7

qt_create_translation(QM_FILES ${CMAKE_SOURCE_DIR} ${TS_FILES})
qt_add_executable(untitled
    MANUAL_FINALIZATION
    ${PROJECT_SOURCES}
    ${TS_FILES}
    ${QM_FILES}
)

3. 编辑ui文件，编辑程序界面文本。
4. 构建工程，ts文件会自动生成对应的文本（无需使用QT Creator的工具->外部->Linguist->Update/Release Translations(lupate)，这个工具运行会报错）

6.1   创建工程提示找不到合适的套件

问题：安装Qt Creator之后，在创建工程提示No suitable kits found.

解决：点击管理，手动设置构建套件kit的qt版本，这是通过选择qmake.exe或者qmake6.exe的路径确认。（不用重装，网上的教程都是重装或者安装在线版本包，但直接重装是无效）。

6.2   旧项目的套件配置文件中的CL编译器路径不正确

原因：更新MSVC CL后，老版本编译器就被删除了，旧项目的套件配置文件中的CL编译器路径仍然是老版本的路径，导致路径错误无法识别最新版本的编译器。

解决方法：删除项目父路径中生成的构建配置文件夹，例如build-untitled-x64-Release，然后重新构建新的配置文件夹。

7   Qt源码编译

7.1   个人编译使用的模块

以下是我个人使用到的模块（按编译顺序列出）

• qtbase（基础库）
• qtshadertools（编译qtdeclarative所需的依赖库）
• qtdeclarative（qt quick和QML）
• qttools（CMakeLists文件中指明要Qt Linguist包，因此即使在qt creator中没用上「工具」->「外部」->「Linguist」也要编译）
• qtsvg（FluentUI库所需）
• qt5compat（FluentUI库所需）
• qttranslation（如果不编译这个库，运行windeployqt会出现警告：Warning: Translations will not be available due to the following error. Cannot open C:/Qt/qt6release/translations/catalogs.json。但这个错误实际不影响程序的翻译状态，可以不编译）

7.2   环境配置和编译步骤

环境变量：一定要确保系统PATH环境变量含有CMake和Ninja路径。关于如何详细设置，可以参见MSVC CL编译器的安装和环境设置。

注意不能使用ninja直接构建源码，会报错：build.ninja not found。构建是使用CMake。

编译步骤：

1. 将源码解压到分区的根目录下，例如：G:\qtbase-everywhere-src-6.8.2
2. 在源码文件夹外新建一个文件夹，如qtbasebuild，拷贝该编译脚本进文件夹，打开cmd窗口，执行该脚本（不建议直接双击运行编译脚本，因为脚本编译出错或者执行完毕都会关闭窗口，这样无法得知编译详情）。
3. 编译完成后添加环境变量PATH配置：C:\Qt\qt6release\bin

7.3   单模块逐个编译的BAT脚本

附加编译子模块的方式：运行Qt安装路径下的/bin/qt-configure-module.bat + 附件模块源码解压路径。

一般普通开发编译release版本即可，debug版本是是编译用来开发调试qt源码的。

7.3.1   编译release版本

7.3.1.1   编译qtbase(release)

1
2
3
4

@chcp 65001>nul
@echo off
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x64
..\qtbase-everywhere-src-6.8.2\configure.bat -prefix C:\Qt\qt6release -c++std c++20 -release -optimize-size -shared && cmake --build . --parallel && cmake --install .

7.3.1.2   附加编译其他子模块（release）

1
2
3
4

@chcp 65001>nul
@echo off
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x64
C:\Qt\qt6release\bin\qt-configure-module.bat G:\qtshadertools-everywhere-src-6.8.2 && cmake --build . --parallel && cmake --install .

7.3.2   编译debug版本

7.3.2.1   编译qtbase(debug)

1
2
3
4

@chcp 65001>nul
@echo off
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x64
..\qtbase-everywhere-src-6.8.2\configure.bat -prefix C:\Qt\qt6debug -c++std c++20 -debug -shared && cmake --build . --parallel && cmake --install .

7.3.2.2   附加编译其他子模块（debug）

1
2
3
4

@chcp 65001>nul
@echo off
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" x64
C:\Qt\qt6debug\bin\qt-configure-module.bat ..\qtshadertools-everywhere-src-6.8.2 && cmake --build . --parallel && cmake --install .

1   推荐链接

• 微软文档：代码页标识符（chcp）
• CMD命令例程索引：该网站的教程索引比微软官方文档好用。

2   检测并获取管理员权限

2.1   方式一：使用cacls工具检测权限

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

@REM 检测权限：根据系统版本尝试访问系统文件路径
if "%PROCESSOR_ARCHITECTURE%" equ "amd64" (
    "%SYSTEMROOT%\SysWOW64\cacls.exe" "%SYSTEMROOT%\SysWOW64\config\system" >nul 2>&1
) else (
    "%SYSTEMROOT%\system32\cacls.exe" "%SYSTEMROOT%\system32\config\system" >nul 2>&1
)

@REM 根据权限情况跳转标签
if "%errorlevel%" neq "0" (
    echo 当前检测无管理员权限。正在请求管理员权限...
    echo.
    goto uac_prompt
) else (
    goto got_admin
)

@REM 获取管理员权限
:uac_prompt
powershell -Command "Start-Process -Verb RunAs -FilePath '%0' -ArgumentList 'am_admin'"
exit /b

@REM "已获取管理员权限，存储当前目录并切换到脚本程序目录"
:got_admin
pushd "%cd%"
cd /d "%~dp0"

1   语言编码的区别

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

2   三维模型等二进制文件的版本控制

git和svn适合管理文本类的代码文件，perforce更适合管理像游戏资产3D模型、psd图像文件等的大型文件。

Perforce Helix Core官网下载：点击跳转

3   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).

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

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

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

4   Git配置

4.1   编辑git特定的config项

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

4.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

4.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

5   pull（拉取）

5.1   github从远程仓库拉取

1

git pull origin master # 相当于fetch后merge

5.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

6   clone（克隆）

6.1   常规克隆

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

6.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

6.3   克隆特定分支

1
2
3

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

6.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

7   commit（提交）

7.1   commit信息的规范化

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

• chore
• fix
• feat
• docs

8   release（发布）

8.1   常规发布

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

8.2   release note的规范化

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

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

9   添加子仓库

1
2
3
4

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

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

10   重写历史

10.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再推送。

10.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更积极地优化存储库

11   分支管理

11.1   常规操作

1

git branch -M master # 创建分支

11.2   多人协作的工作流

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

11.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

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

应用场景：在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（删除））

13   远程仓库

13.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>

13.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

13.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

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

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

13.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.6   已经提交Pull Request的如何二次修改覆盖

1. 本地git reset撤销提交，然后重新完成二次修改
2. push -f强行覆盖掉你远程的commit
3. 上游仓库的PR会自动更新相关内容（例如xx强制push commit）
4. 有其他的新内容commit，push普通推送也能自动追加到上游仓库的PR中。

14   Github LFS

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

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

14.1   为Git启用LFS

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

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

14.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

15   CI/CD

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

16   参考文献

[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.
[13] github 提交pull request操作后, 如果想对代码再次进行修改，该如何操作？[EB/OL]. https://segmentfault.com/q/1010000012129041.

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   文本编辑

9.1   编辑并同时备份的命令

• set -i.bak：编辑并同时创建一个.bak后缀的备份文件
• sed -i_orig：编辑并同时创建一个_orig后缀的备份文件

10   参考文献

[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.