github

Posted 2021-01-24 luwanlin

Github

0.1.1 understanding the github Flow

Create a branch(建立分支)

建立分支是相对于Git默认建立的Master主分支来讲的，建立了一个分支就相当于复制了一个master分支，你可以安全在新分支上进行修改，测试，而不用担心主master受影响。

Add commits（提交修改）

在建立了新的分支之后，你就在该分支上进行你需要的修改，来完成你需要的新功能。重要的一点，你要在每次提交新的改动到工作分支上时，都要注释一定的信息，来解释你的行为，方便团队成员能够看懂你的操作。

Open a Pull Request(开启一个合并请求)

在你完成了你的修改，并经过测试、验证之后，你就可以提出合并请求。项目相关成员会查看你的改动、新功能，看是否具有合并到master分支上的条件。

Discuss and review your code(讨论和探讨新的代码)

你提出合并请求之后，项目相关人员可能会就一些疑问等和你进行一些沟通。这些沟通就是项目合作的重点，是思想和创意碰撞的展现，或许会有火花哦。

Deploy(部署测试)

在你的新代码讨论通过后，就可以部署到项目产品中，进行测试。

Merge(合并)

在部署测试后，没有发现问题的话，就可以把你的改动合并到master分支上。同时这个新开的分支也就完成了使命，该分支删除后会留下记录，别人会从这些记录看出这个项目是如何一步一步建立起来的。

0.1.2 Hello World

‘hello，world’这是一个在计算机编程领域里面的传统项目，意思好像就是指在学习了一种新的知识后，向这个新世界打招呼，宣示你的到来一样。同样学习GitHub也是一样的。

首先GitHub是一个世界上使用人数最多的也是最好分散式的版本控制和协作开发的代码平台，使用它你可以和其他人一起协作完成一个项目或者分享知识和观点。

按照GitHub的工作程序（如上）就可以创建个人的第一个GitHub仓库（repository）。

0.1.3 Getting started with github pages

在GitHub的设置中有一个GitHub pages的个人网页设置选项，可以展示你的项目！

0.1.4 git hand book

配合GitHub使用Git的一些例子。

0.1.5 Forking progects

你可以复制一份别人的项目，而且你的改动都可以提交到原来项目的拥有者那里，帮助他（她）改善原项目，这是在GitHub的沟通和合作基础。当然也可以只是自己用。。。。

0.1.6 Be social

在GitHub上有很多大佬和牛人，你可以通过follow和watch关注他们或者他们的项目，或许有机会参与到他们的项目中，学习学习。

0.1.7 Marking your code Citalbe

通过Zennodo可以为你在GitHub上的项目申请一个DOI，貌似可以保护你的产权。

0.1.8 Mastering the issues

Github上的bug追踪处理系统，特色是更加关注合作和处理过程记录。

0.1.9 Mastering markdown

Markdown文档是一种轻量级重点关注内容一种文档，是github上主要使用的文档。
Markdown语法说明
Markdown文本案例

• inline html
• Automatic escaping for special characters
• block element
  • paragraphs and line breaks
  • Headers
  • Blockquotes
  • Lists
  • Code Blocks
  • Horizontal Rules
• Span elements
  • links
  • Emphasis
  • Code
  • Images
• Miscellaneous
  • Automatic Links
  • Backslash Escapes

Markdown-Html转换练习
sublime Text-3 plugin:MarkdownEditing

0.1.10 Documenting your projects on github

通过添加一个README文档或者在项目中添加一个wiki页面，帮助别人更快、更好的了解你的项目，这样可以提高合作的可能。