This repository has been archived on 2024-06-23. You can view files and clone it, but cannot push or open issues or pull requests.

7.4 KiB

Raw Blame History

新组员环境配置流程

软件准备(以win10以上windows环境为例)

git: https://www.git-scm.com/
texlive: https://tug.org/texlive/
vscode: https://code.visualstudio.com/
python环境: https://www.anaconda.com/

软件安装

以上四个软件可以按任意顺序安装, 其中git, vscode安装时间较短, anaconda安装时间稍长, texlive安装时间最长.

所有的四个软件全部按照默认选项一路Next即可.

注意所有的四个软件的安装目录中都不要有中文名

环境配置

确定自己在Gitlabtest项目里

在浏览器里输入http://wwylss.asuscomm.com:30000/wangweiye/gitlabtest, 登录(记得邮箱)后如果能打开, 就是在项目里, 否则请及时联系管理员(王伟叶)

git环境配置

新建一个要用来工作的文件夹, 建议用某盘根目录下的test01文件夹.
在该文件夹中按鼠标右键, 选择Git Bash Here, 将弹出一个git的终端.
在终端中分两行输入以下代码("Your Name"随便起, "Your Email"就是上一步的那个登录用的邮箱, 输入的时候都不要带双引号).

git config --global user.name "Your Name"

git config --global user.email "Your Email"

获得rsa公钥

为了以后能用vscode不用每次输入密码登录服务器进行同步, 继续在刚才的终端中执行以下两行命令(这里的"comment"可以是前面的那个Email, 也可以是别的标识):

ssh-keygen -t rsa -b 2048 -C "comment"
不断回车, 选择默认选项.
cat ~/.ssh/id_rsa.pub | clip

在服务器上粘贴公钥

登录http://wwylss.asuscomm.com:30000(如果是按顺序操作的话现在应该已经登录了)
点击右上角的头像, 在弹出下拉列表中选择"Preferences".
在左侧的列表中选择"SSH密钥".
在"密钥(Key)"下的大型矩形框中按ctrl-v, 将上一步复制得到的公钥内容粘贴到框里.
点击"添加密钥(Add key)".

开荒vscode

打开vscode(稍等一会儿, 如果右下角跳出中文提示的话可以确认, 之后自动重启vscode后菜单会变成中文的).
按ctrl-shift-x键, 在左边的"扩展"栏第一行输入latex workshop并安装使用人数最多的一个.
按ctrl-shift-x键, 在左边的"扩展"栏第一行输入python并安装使用人数最多的一个.
安装完毕以后按ctrl-shift-p键, 在上方出现的框里输入jupyter, 选择Create: New Jupyter Notebook
然后vscode会提示安装一些扩展, 全部同意.
安装好之后在界面上的第一个输入栏中输入print(2 ** 16), 然后按ctrl-enter, 看看得到了什么.

设置和服务器测试项目的同步

在文件(File)菜单中选择"打开文件夹", 选择刚才新建的那个空文件夹, 并点击"信任作者".
点击左侧图标的第三个(git), 并选择"初始化仓库".
选择菜单中的"查看"-"终端".
在下方的终端中输入git remote add origin ssh://git@wwylss.asuscomm.com:30001/wangweiye/gitlabtest.git(一行)并回车, 如果有提示的话输入yes.
随后在终端中输入git pull origin master, 随后输入"yes"(以后同步就不用输入了).
点击左侧图标栏的第一个, 不出意外的话, 现在空文件夹已经不空了, 随便编辑一个文件试试.
编辑完成后保存, 这时第三个图标下会有个小蓝圈, 点击第三个图标, 在"更改"下面的文件旁按"+"符号进行暂存.
所有更改的文件都到"暂存的更改"中之后在上方的"消息"中输入任意文字后按"提交"按钮.
"提交"按钮变成了"发布Branch", 按"发布Branch"按钮.
这时刷新浏览器上的gitlab页面, 看一下文件是不是真的已经修改过了.
以后用7-9的操作后"发布Branch"按钮会被"同步"按钮替代.
可以自由地作一些测试.

和正式项目同步

在任一盘符的根目录下建立一个新文件夹, 名字中不带有中文即可.
在资源管理器里进入新建的文件夹, 右键点击后选Git Bash Here(win11的系统需要先选择显示更多选项).
在弹出的窗口中输入git init后回车
继续输入git remote add origin ssh://git@wwylss.asuscomm.com:30001/wangweiye/mathdeptv2.git(一行)并回车, 如果有提示的话输入yes.
随后在终端中输入git pull origin master, 随后输入"yes"(以后同步就不用输入了).
打开vscode, 在文件菜单中选择关闭文件夹后, 再选择打开文件夹, 并选择刚才新建的文件夹
如果vscode的最下方的状态栏里没有Git Graph字样, 输入ctrl-shift-x, 在在应用商店中搜索扩展栏中输入Git Graph后回车, 找到后安装. 如果有Git Graph字样的话跳过本步骤.
点击下方状态栏中的Git Graph, 确定有粗体的master, 旁边有非粗体的origin.
关闭Git Graph窗口, 在vscode左下角的状态栏中找到master字样并点击, 在弹出的小窗中选择创建新分支, 随后输入一个你觉得别人不会用的名字, 作为你的个人分支(测试分支).
在vscode的左侧边栏中, 在工具文件夹(可以点开)下用鼠标右键新建临时文件文件夹.
在文本文件文件夹中找到metadata.txt文件, 任意编辑后保存.
点开最左侧边栏中有两根线和三个小圆的git图标, 点击更改右侧的加号.
在提交上方的小框中输入任意字符并按提交.
提交完成后点开git graph看看是不是提交的提示词已经被显示了? 这就说明修改和服务器同步了.
不用担心服务器上的master分支会被修改, 目前你没有修改master分支的权限, 所以可以随便玩这个新建的分支. 即使彻底玩坏了也能按照刚才的步骤马上重新从服务器上拉取一份master分支上最新的记录.

具体配置LaTeX环境和Python环境

LaTeX环境

在你用来放各种杂物的文件夹中用vscode建立一个新的文本文件, 复制(注意空行)下列代码后保存为test.tex

\documentclass[10pt,a4paper]{article}
\usepackage[UTF8, fontset = fandol]{ctex}
\begin{document}

测试

hello world

\end{document}

在资源管理器test.tex的文件夹中右键点击鼠标, 随后选在终端中打开.
在弹出的窗口中输入xelatex test.tex, 如果能够运行完, 会在刚才的文件夹下生成一个有两行字的pdf文件.
回到vscode, 按ctrl-shift-x, 搜索LaTeX workshop, 如果没有安装的话安装一下, 如果已经安装了的话忽略本步骤.
在vscode里找到或打开刚建立的test.tex文件, 将测试修改为成功测试, 按ctrl-alt-b编译, 下方状态栏中的转圈圈变成勾之后再按ctrl-alt-k预览pdf.

Python环境

在windows主菜单里找到anaconda prompt并运行.
输入conda create -n math python=3.10并回车, 在随后的提示之后输入y表示确认.
输入conda activate math并回车.
进入正式项目的文件夹. 比如你的正式项目的文件夹是E盘根目录下的mathdept文件夹, 就输入E:回车, 再输入cd \mathdept回车.
输入pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple(一行)并回车.
输入python并回车, 进入python命令行模式, 提示符变为>>>.
输入import pandas as pd并回车.
如果没有出现错误, 说明环境已经配置好了, 可以输入exit()退回到普通命令行模式.

7.4 KiB Raw Blame History