Skip to content

Latest commit

 

History

History
189 lines (149 loc) · 6.96 KB

贡献方法.md

File metadata and controls

189 lines (149 loc) · 6.96 KB
Raw

贡献方法

如何成为贡献者

想要参与贡献的SEUer请加群883041564，或邮件[email protected] 并附上自己GitHub的user name，待审批成功后即可参与贡献。同时，也欢迎大家报名参与每个branch的管理。

贡献什么文件

欢迎广大SEUer贡献各个课程的历年试卷、笔记整理、作业解答及被允许外传的教师课件。再次声明，创建该项目的目的是为了帮助大家学习,而非促使大家堕落。上传作业解答的目的是使大家遇到作业上没有参考答案的难题时有一个能够及时参考的途径，从而避免出现在老师讲评作业的时候已经忘了不会做的题有哪些的情况。

如何贡献文件

对于仅上传少数文件的贡献者，进入要上传文件的文件夹对应的网页，点击Upload files，上传文件即可。

对于要上传大量文件的贡献者及管理者，建议在自己的电脑上建立相应的git托管，远程连接本GitHub仓库来进行管理。方法有命令行和带图形界面的应用程序两种，对于不熟悉命令行的同学可以使用带图形界面的应用程序。具体方法如下：

带图形界面的应用程序

Windows版

  1. 在https://desktop.github.com 中下载Windows版的GitHub Desktop.

macOS版

  1. 打开终端，运行

    git

    如果出现

    xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

    或者

    -bash: git: command not found

    的报错，请在终端中输入

    xcode-select --install

    如果没有出现这样的报错，而是出现

    usage: git [--version] [--help] [-C <path>] [-c <name>=<value>]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare]
           [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
           <command> [<args>]

    则说明该电脑已安装git.

  2. 在https://desktop.github.com 中下载macOS版的GitHub Desktop.

  3. 按照https://help.github.com/desktop/guides/ 的说明书进行操作。本repository名为seucourseshare

命令行

初次使用git时的配置

Windows版
  1. 在https://git-scm.com/downloads 中下载Windows版的git，按默认选项安装即可。
macOS版

  1. 打开终端，运行

    git

    如果出现

    xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

    或者

    -bash: git: command not found

    的报错，请在终端中输入

    xcode-select --install

    如果没有出现这样的报错，而是出现

    usage: git [--version] [--help] [-C <path>] [-c <name>=<value>]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare]
           [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
           <command> [<args>]

则说明该电脑已安装git.

  1. 在终端中继续输入

    ssh-keygen -t rsa -b 4096 -C "[email protected]"

    其中"[email protected]"填写自己注册GitHub时的邮箱。 当提示

    Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]

    时，直接按回车。接着会提示

    Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

    两个均按回车即可。 然后再输入

    pbcopy < ~/.ssh/id_rsa.pub

    此操作将生成的SSH公钥复制入电脑的剪贴板。

  2. 在GitHub网站中，点击自己头像，选择Settings->SSH and GPG keys, 点击New SSH key或Add SSH key, 将之前复制入剪贴板的公钥粘贴进去，title随便填写即可。

  3. 在自己的电脑中选择一个位置，创建文件夹seucourseshare，用于存放文件（该文件夹存放的是至少一个branch的所有文件，因此建议将文件夹放在可用储存空间较大的地方）。选中该文件夹，按下键盘上的option+command+C, 打开终端，在终端中输入

    cd xxxxxx

    其中xxxxx的地方使用command+V进行粘贴。

  4. 接着，在终端中输入

    git init

    此操作是在该文件夹中创建本地git托管

  5. 接着，再在终端中输入

    git remote add origin [email protected]:zjdx1998/seucourseshare.git

    此操作将你本地的git与远程的GitHub仓库进行连接。

  6. 假设你负责的branch名为57-网络空间安全学院，则在终端中输入（如果负责的branch名字中带有括号，则需要在括号前加反斜杠。如：大类通识基础(数学)）：

    git branch -b 57-网络空间安全学院

    本操作在本地新建了一个名为57-网络空间安全学院的branch 接着，输入

    git checkout 57-网络空间安全学院

    本操作将本地的branch切换到57-网络空间安全学院（对于负责多个branch的同学可以类似地checkout到别的branch中） 然后在终端中输入

    git pull origin 57-网络空间安全学院:57-网络空间安全学院

    然后该分支的所有文件均会拷贝到此文件夹中

对seucourseshare仓库的操作

首先clone 特定分支

git clone https://github.com/zjdx1998/seucourseshare.git -b branch-name --single branch

如通过

git clone https://github.com/zjdx1998/seucourseshare.git -b master --single branch

可获取master分支。

(以下以mac系统为示例，均假设负责的branch名为57-网络空间安全学院)

  1. 选中本地的seucourseshare文件夹，按下键盘上的option+command+C, 打开终端，在终端中输入

    cd xxxxxx

    其中xxxxx的地方使用command+V进行粘贴。

  2. 在每次向文件夹中添加并向远程仓库上传新的一批文件的时候，建议先在终端中输入

    git checkout 57-网络空间安全学院
git pull origin 57-网络空间安全学院:57-网络空间安全学院

    注意，如果此时readme出现冲突，则需要把原来的readme.md（可以在web端查看）覆盖至当前冲突的readme。

    这一步需要谨慎操作。

  3. 向文件夹中添加完文件后，输入

    git add .
git commit -m "your commit"
git push -u origin 57-网络空间安全学院:57-网络空间安全学院

    其中"your commit"填写的是本次上传的简介，如"update readme"等。