20230330 afternoonn

文档/新人加入流程.md

@@ -0,0 +1,72 @@
+# 新组员环境配置流程
+
+## 软件准备(以win10以上windows环境为例)
+
+1. `git`: `https://www.git-scm.com/`
+2. `texlive`: `https://tug.org/texlive/`
+3. `vscode`: `https://code.visualstudio.com/`
+4. `python`环境: `https://www.anaconda.com/`
+
+## 软件安装
+
+以上四个软件可以按任意顺序安装, 其中`git`, `vscode`安装时间较短, `anaconda`安装时间稍长, `texlive`安装时间最长.
+
+所有的四个软件全部按照默认选项一路Next即可.
+
+## 环境配置
+
+### 确定自己在Gitlabtest项目里
+
+在浏览器里输入`http://wwylss.asuscomm.com:30000/wangweiye/gitlabtest`, 登录(记得邮箱)后如果能打开, 就是在项目里, 否则请及时联系管理员(王伟叶)
+
+### git环境配置
+
+1. 新建一个要用来工作的文件夹, 建议用某盘根目录下的`test01`文件夹.
+2. 在该文件夹中按鼠标右键, 选择`Git Bash Here`, 将弹出一个`git`的终端.
+3. 在终端中分两行输入以下代码("Your Name"随便起, "Your Email"就是上一步的那个登录用的邮箱, 输入的时候都**不要带双引号**.
+
+`git config --global user.name "Your Name"`
+
+`git config --global user.email "Your Email"`
+
+#### 获得rsa公钥
+
+为了以后能用`vscode`不用每次输入密码登录服务器进行同步, 继续在刚才的终端中执行以下两行命令(这里的"comment"可以是前面的那个Email, 也可以是别的标识):
+1. `ssh-keygen -t rsa -b 2048 -C "comment"`
+2. 不断回车, 选择默认选项.
+3. `cat ~/.ssh/id_rsa.pub | clip`
+
+#### 在服务器上粘贴公钥
+
+1. 登录`http://wwylss.asuscomm.com:30000`(如果是按顺序操作的话现在应该已经登录了)
+2. 点击右上角的头像, 在弹出下拉列表中选择"Preferences".
+3. 在左侧的列表中选择"SSH密钥".
+4. 在"密钥(Key)"下的大型矩形框中按`ctrl-v`, 将上一步复制得到的公钥内容粘贴到框里.
+5. 点击"添加密钥(Add key)".
+
+### 开荒vscode
+
+1. 打开`vscode`(稍等一会儿, 如果右下角跳出中文提示的话可以确认, 之后自动重启`vscode`后菜单会变成中文的).
+2. 按`ctrl-shift-x`键, 在左边的"扩展"栏第一行输入`latex workshop`并安装使用人数最多的一个.
+3. 按`ctrl-shift-x`键, 在左边的"扩展"栏第一行输入`python`并安装使用人数最多的一个.
+4. 安装完毕以后按`ctrl-shift-p`键, 在上方出现的框里输入`jupyter`, 选择`Create: New Jupyter Notebook`
+5. 在界面上的第一个输入栏中输入`print(2 ** 16)`, 然后按`ctrl-enter`, 看看得到了什么.
+
+
+### 设置和服务器测试项目的同步
+1. 在文件(File)菜单中选择"打开文件夹", 选择刚才新建的那个空文件夹, 并点击"信任作者".
+2. 点击左侧图标的第三个(`git`), 并选择"初始化仓库". 
+3. 选择菜单中的"查看"-"终端".
+4. 在下方的终端中输入`git remote add origin ssh://git@wwylss.asuscomm.com:30001/wangweiye/gitlabtest.git`(一行)并回车, 如果有提示的话输入yes.
+5. 随后在终端中输入`git pull origin master`, 随后输入"yes"(以后同步就不用输入了).
+6. 点击左侧图标栏的第一个, 不出意外的话, 现在空文件夹已经不空了, 随便编辑一个文件试试.
+7. 编辑完成后保存, 这时第三个图标下会有个小蓝圈, 点击第三个图标, 在"更改"下面的文件旁按"+"符号进行暂存.
+8. 所有更改的文件都到"暂存的更改"中之后在上方的"消息"中输入任意文字后按"提交"按钮.
+9. "提交"按钮变成了"发布Branch", 按"发布Branch"按钮.
+10. 这时刷新浏览器上的`gitlab`页面, 看一下文件是不是真的已经修改过了.
+11. 以后用7-9的操作后"发布Branch"按钮会被"同步"按钮替代.
+12. 可以自由地作一些测试.
+
+## 和正式项目同步(待续)
+
+## 具体配置LaTeX环境和Python环境(待续)