diff --git a/README.en.md b/README.en.md deleted file mode 100644 index 4ab7931431591bf949ff4f5cc9a8525450d1fc53..0000000000000000000000000000000000000000 --- a/README.en.md +++ /dev/null @@ -1,36 +0,0 @@ -# Article - -#### Description -{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**} - -#### Software Architecture -Software architecture description - -#### Installation - -1. xxxx -2. xxxx -3. xxxx - -#### Instructions - -1. xxxx -2. xxxx -3. xxxx - -#### Contribution - -1. Fork the repository -2. Create Feat_xxx branch -3. Commit your code -4. Create Pull Request - - -#### Gitee Feature - -1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md -2. Gitee blog [blog.gitee.com](https://blog.gitee.com) -3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore) -4. The most valuable open source project [GVP](https://gitee.com/gvp) -5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help) -6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git a/README.md b/README.md index 6ae29d59d827803ffeb9907e9ca4d777dc67c1a4..f23714b91f258e4672bd1d0b16c74f30ff21929e 100644 --- a/README.md +++ b/README.md @@ -1,39 +1,8 @@ # Article -#### 介绍 -{**以下是 Gitee 平台说明，您可以替换此简介** -Gitee 是 OSCHINA 推出的基于 Git 的代码托管平台（同时支持 SVN）。专为开发者提供稳定、高效、安全的云端软件开发协作平台 -无论是个人、团队、或是企业，都能够用 Gitee 实现代码托管、项目管理、协作开发。企业项目请看 [https://gitee.com/enterprises](https://gitee.com/enterprises)} +本仓库为 AgentExplorer 文章仓库，提交文章及 Review 均在此仓库完成 -#### 软件架构 -软件架构说明 +新加入的同学请阅读基础操作文件夹阅读提交、Review等流程 -#### 安装教程 -1. xxxx -2. xxxx -3. xxxx - -#### 使用说明 - -1. xxxx -2. xxxx -3. xxxx - -#### 参与贡献 - -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request - - -#### 特技 - -1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md -2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 -5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/AgentExplorer \350\264\241\347\214\256\346\214\207\345\215\227.md" "b/\345\237\272\347\241\200\346\223\215\344\275\234/AgentExplorer \350\264\241\347\214\256\346\214\207\345\215\227.md" new file mode 100644 index 0000000000000000000000000000000000000000..c6e954cac014a363c52e7f4c206233629d407ec7 --- /dev/null +++ "b/\345\237\272\347\241\200\346\223\215\344\275\234/AgentExplorer \350\264\241\347\214\256\346\214\207\345\215\227.md" @@ -0,0 +1,8 @@ +# AgentExplorer 贡献指南 + +AgentExplorer 小组目前是申请加入制，凝聚机器人及人工智能相关领域优秀开发者，共同探索有趣的应用。 + +大家可以通过 [Article](https://gitee.com/agent-explorer/article) Repo 发布博客 + +### 在博客中插入视频 + diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\345\205\245\351\227\250\357\274\232\345\246\202\344\275\225\345\217\221\345\270\203\350\207\252\345\267\261\347\232\204\347\254\254\344\270\200\347\257\207\345\215\232\345\256\242.md" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\345\205\245\351\227\250\357\274\232\345\246\202\344\275\225\345\217\221\345\270\203\350\207\252\345\267\261\347\232\204\347\254\254\344\270\200\347\257\207\345\215\232\345\256\242.md" new file mode 100644 index 0000000000000000000000000000000000000000..08c72743e2db93cc1e5c5c079f2c65933dbf6c80 --- /dev/null +++ "b/\345\237\272\347\241\200\346\223\215\344\275\234/\345\205\245\351\227\250\357\274\232\345\246\202\344\275\225\345\217\221\345\270\203\350\207\252\345\267\261\347\232\204\347\254\254\344\270\200\347\257\207\345\215\232\345\256\242.md" @@ -0,0 +1,15 @@ +# 入门：如何发布自己的第一篇博客 + +首先，要简单了解以下几个工具 + +- markdown +- git +- github + +我们希望能把 Article Repo 当成一本电子书，每个参与者都可以在这本书中书写自己的文章并发布 + +1. 先复制 Repo 到自己的 Repo (fork it) +2. git clone 这个 Repo 到自己的电脑上 +3. 按规定的格式（暂无，慢慢完善）添加自己的新文章，并上传到自己的 Repo (git commit并git push) +4. 创建 PR 提交管理员审核（create pull requests） +5. 大家投票，并给文章提建议 \ No newline at end of file diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/104854_b40c8831_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/104854_b40c8831_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..3dd20f15c93165be035c47f4b434c478373b3c69 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/104854_b40c8831_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164517_e10e1804_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164517_e10e1804_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..a448ddae9ad70443b88960c2fab195762dd44b13 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164517_e10e1804_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164606_3fcf9c33_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164606_3fcf9c33_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..e193929141052fa1b0e29cac8e15771b1246a740 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164606_3fcf9c33_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164637_6771ee95_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164637_6771ee95_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..4a9c6c970236f329a76f9688752c89f703dbc633 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164637_6771ee95_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164707_972474b4_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164707_972474b4_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..931b3d10850989f3b9829a4f6c0c577f576cfa0c Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164707_972474b4_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164728_7b8688d1_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164728_7b8688d1_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..8ecbf5a3d21cef17127abb7f4085d16a0b215c2c Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164728_7b8688d1_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164959_93e45f79_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164959_93e45f79_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..2c8404769f8ba6ab3051d45b24947b7fece9542a Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/164959_93e45f79_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165029_3c9e3830_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165029_3c9e3830_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..6e26fe8b3d26cc7337565df7536aef874fcf5ff5 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165029_3c9e3830_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165212_0c184280_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165212_0c184280_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..02a8510d981d4d0f82684825329a5d734e568f99 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165212_0c184280_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165228_8bd4de55_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165228_8bd4de55_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..ab70a7892b354021712ba9772cff9355c510a68c Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165228_8bd4de55_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165311_a7f62ab6_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165311_a7f62ab6_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..3ae061dee57ffe51ab728a3fb4345d051d884d4e Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165311_a7f62ab6_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165345_b2702358_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165345_b2702358_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..e0fc1dcbc6f695d4b12e1362517432845b071e78 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165345_b2702358_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165406_01300336_2301581.png" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165406_01300336_2301581.png" new file mode 100644 index 0000000000000000000000000000000000000000..49f834534f140bc54601f32a8a9202b5c065d673 Binary files /dev/null and "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.assets/165406_01300336_2301581.png" differ diff --git "a/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.md" "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.md" new file mode 100644 index 0000000000000000000000000000000000000000..328de79ddcd7e273f4fb951fb7f4a6bec0831723 --- /dev/null +++ "b/\345\237\272\347\241\200\346\223\215\344\275\234/\346\267\273\345\212\240SSH\345\205\254\351\222\245.md" @@ -0,0 +1,209 @@ +### Gitee 基础功能上手教程 + +1. **配置Gitee平台远程免密SSH公钥** +2. **同步 Gitee 仓库内容到本地（无需打开网页）** +3. **本地新建文件并同步至 Gitee（无需打开网页）** +4. **删除远程仓库中的指定文件（无需打开网页）** + +直奔主题！四步学习，掌握“乾坤大挪移”！ + +本教程以windows操作系统为例，其他操作系统及Git高手可忽略。 + +## Gitee 神功修炼四步走 + +### **第一步 配置Gitee平台SSH公钥——本地文件夹与 Gitee 仓库连接可免登录** + +要建立本地电脑与此仓库的连接，我们可以建立一个SSH公钥提升效率。 + +这个公钥相当于人脸识别门锁录制的一个人脸数据，之后访问远程仓库就可以不用再输入账号密码，省时省力。 + +#### **> 创建SSH公钥步骤** + +1. **本地新建一个文件夹，命名为：gitee** + + --- + +2. **进入 gitee 文件夹，鼠标或触控板右击文件夹内空白处，点击“Git Bash Here”** + ![Gitee之Gitbashhere](添加SSH公钥.assets/164517_e10e1804_2301581.png "gitbash.png") + +--- + +3. **输入下方框中的代码以生成SSHkey，输入完成后敲击回车 Enter 键，出现冒号（共三个）就回车，询问（y/n）？就输入 y 。** + +```plain +ssh-keygen -t rsa -C "xxxxx@xxxxx.com" #输入个人邮箱 +``` + +提示：*#及后面内容是注释说明，不要把这些内容输入代码行* + +![Gitee新建SSH公钥](添加SSH公钥.assets/164606_3fcf9c33_2301581.png "仓库部署公钥2.png") + +--- + +4. **继续输入以下命令，可以看到下图所示 ssh-rsa 开头的一串代码，说明生成 SSH 公钥成功** + +```plain +cat ~/.ssh/id_rsa.pub +``` + +![Gitee之SSH创建成功](添加SSH公钥.assets/164637_6771ee95_2301581.png "仓库部署公钥3.png") + +--- + +5. **通过点击 Gitee 主页右上角头像 「设置」->「安全设置」->「SSH公钥」进行公钥添加 ，复制(全部选中后，鼠标右键 copy），将复制的 ssh-rsa 开头的内容添加到下图公钥框中。并点击确认按钮** + +![Gitee部署SSH](添加SSH公钥.assets/164707_972474b4_2301581.png "仓库部署公钥4.png") + +--- + +6. **在弹出窗口中输入 Gitee 账户的登录密码点击验证并出现“您已成功添加SSH公钥”字样即可** + +![Gitee确认添加SSH公钥](添加SSH公钥.assets/164728_7b8688d1_2301581.png "仓库部署公钥5.png") + +恭喜，SSH公钥已经配置完成！ + +未来您在本地操作 Gitee 注册账户下的远程仓库时就无需再单独输入 Gitee 的账号密码了。 + +--- + +--- + +### 第二步 同步 Gitee 仓库内容到本地 + +若没有创建示例仓库，可在Gitee.com页面右上角+号处新建仓库，默认选择+选中“使用Readme文件初始化这个仓库”即可； + +新建仓库时**若没有**使用readme文件初始化，会出现如下代码提示界面（#部分为命令行中文解释）： + +![新建仓库代码提示说明](添加SSH公钥.assets/104854_b40c8831_2301581.png "shuoming.png") + +接下来的内容是以入门教程中的 `hello-gitee` 仓库为例，我们可以通过建立文件夹 gitee 与 `hello-gitee` 仓库的连接，然后通过 git 命令把远程仓库内容下载克隆到本地。 + +#### >**建立连接与克隆步骤** + +1. 【**重要**】**设置用户名与邮箱，继续在 Git Bash Here 的命令行中继续输入以下命令，每输入一行回车一次** + +```plain +git config --global user.name "您的 Gitee 账户姓名" +git config --global user.email "您注册/绑定的邮箱地址" +``` + +如果您仅有一个 Gitee 账号，可以在 Git 全局配置时使用 --global ，此后默认操作都是使用这里设置的用户名与密码进行配置 + +--- + +2. **找到 `hello-gitee` 远程仓库的SSH连接，仓库页面点击克隆/下载，选择 SSH 并点击复制** + +![Gitee复制SSH地址](添加SSH公钥.assets/164959_93e45f79_2301581.png "ssh地址复制.png") + +--- + +3. **初始化本地仓库并克隆远程 `hello-gitee` 仓库，命令如下所示：** + +```plain +git init #初始化仓库 +git remote add origin 粘贴复制的SSH地址 #建立远程连接 +git clone 粘贴复制的SSH地址 #克隆远程仓库 +``` + +提示：初始化仓库后会在本地文件夹中新建一个隐藏文件夹 .git ，windows查看设置中可以设置隐藏文件可见即可看到此文件夹 +![复制Gitee仓库的SSH地址](添加SSH公钥.assets/165212_0c184280_2301581.png "远程克隆.png") + +--- + +4. **进入 gitee 文件夹查看，再点击 `hello-gitee` 可以看到同步到本地的文件** + +![Gitee克隆后文件夹](添加SSH公钥.assets/165228_8bd4de55_2301581.png "克隆完毕.png") + +![Gitee进阶之本地文件夹](添加SSH公钥.assets/165029_3c9e3830_2301581.png "仓库原始内容.png") + + + +庆祝一下，您已经掌握了“乾坤大挪移”第一式——远程克隆！ + +--- + +--- + +### 第三步 **本地新建文件并同步至 Gitee** + +本节我们将要学习通过 git 命令新建文件，并同步到远程仓库，这就行动起来吧！ + +#### >**新建文件并同步操作步骤** + +1. **在仓库 `hello-gitee` 中新建一个“记录.doc”的文档，添加至暂存区，确认添加到数据目录并命名为“新纪录”，同步到远程仓库** + +```plain +cd hello-gitee #定位到 hello-gitee 文件夹 +touch 记录.doc #新建一个记录.doc文件 +git add 记录.doc #新增“记录.doc”至暂存区 +git commit -m "新纪录" #确认新增“记录.doc”至数据目录 +git push -u origin master #推送新增文件到远程仓库 +``` + +> 工作原理示意图： + +![Gitee之本地操作命令行示意图](添加SSH公钥.assets/165311_a7f62ab6_2301581.png "命令行示意图.png") + + + +说明：原先 Git Bash Here 定位的是 gitee 的文件夹，克隆操作后，此文件夹内生成了 `hello-gitee` 的文件夹，我们要新增内容并同步到远程仓库，需要在 `hello-gitee` 文件夹中进行。 + +--- + +2. **确认远程仓库中是否新增了“记录.doc”的内容** + +![Gitee上传新文件纪录](添加SSH公钥.assets/165345_b2702358_2301581.png "确认上传新文件记录.png") + +--- + +3. **修改新增的文件后，继续执行 `git add` 开始的命令即可同步至远程仓库** + +太棒了，还剩一步您就可以完成本教程，获得功力精进了！ + +--- + +--- + +### 第四步 **删除远程仓库中的指定文件** + +如果仓库中有多余文件想要删除，如何远程删除呢？ Git 提供了非常简单的操作指令 `git rm + 文件名`。 + +我们创建的 hello-gitee 仓库中有一个 README.en.md的文档，我们就以它为例，看看如何来删除吧！ + +#### >**删除仓库指定文件操作步骤** + +1. 确保本地仓库与远程仓库内容一致 +2. 在本地用命令删除想要删除的文件 “README.en.md”并确认本次删除操作 +3. 推送到远程仓库，完成指定文件删除 + +具体操作可按下方代码操作： + +```plain +git pull #同步远程仓库到本地 +rm README.en.md #删除本地文件 +git commit -m "delete" #确认删除并备注“delete” +git push #删除操作同步到远程仓库 +``` +![Gitee删除远程文件命令行示意](添加SSH公钥.assets/165406_01300336_2301581.png "实操截图.png") + + + +作为实用主义接班人，您现在已经可以自由使用 Gitee 进行想要的远程同步操作了。 + +md是markdown的缩写，此类文档支持非常简单的语法，可以轻松在线编辑。 + +MD编辑**软件推荐**： + +软件名：Typora，官网地址：http://typora.io/ 打不开可看下方链接 + +国内下载地址传送门：https://gitee.com/sameblue/gitdownload/attach_files + +其他MD工具可选：https://blog.csdn.net/davidhzq/article/details/100815332 + +Markdown文档的语法入门：https://www.jianshu.com/p/191d1e21f7ed/ + +**布置一个小作业**：本地直接编辑 “记录.txt” 文档，同步至远程仓库，检查一下是否已经掌握“乾坤大挪移”！ + +如果对于 Git 的“一阳指”心法不过瘾，还可以继续修炼更上乘的“六脉神剑”，传送门：https://www.cnblogs.com/best/archive/2017/09/07/7474442.html + +Gitee官方 git 帮助文档：https://gitee.com/help/articles/4104 \ No newline at end of file