Git-GitHub学习资源

项目简介

本项目提供Git和GitHub的完整学习材料，包括教程、幻灯片和实践指南。

快速开始

1. 克隆仓库

   git clone https://gitcode.com/gh_mirrors/gi/git-github
   

2. 浏览slides-aulas目录查看教学幻灯片
3. 阅读manuais-PDF目录中的指南文档

核心内容

• 基础Git命令使用
• GitHub协作流程
• 分支管理策略
• 项目安全最佳实践

### 案例二：Issue模板设计

创建标准化的Issue模板可以帮助团队收集一致的信息，提高问题处理效率。在`.github/ISSUE_TEMPLATE/`目录下创建`bug_report.md`：

```markdown
---
name: 错误报告
about: 创建错误报告以帮助我们改进
title: '[BUG] '
labels: 'bug'
assignees: ''
---

## 描述错误
清晰简洁地描述错误是什么

## 复现步骤
复现该错误的步骤:
1. 前往 '...'
2. 点击 '....'
3. 滚动到 '....'
4. 看到错误

## 预期行为
清晰简洁地描述您期望发生的事情

## 截图
如果适用，添加截图以帮助解释您的问题

## 环境信息
 - 操作系统: [例如 Windows 10, macOS 11]
 - 浏览器: [例如 Chrome 90, Safari 14]

案例三：Pull Request描述模板

创建PR模板可以确保代码提交包含必要的信息，便于代码审查：

## 变更描述
简要描述本次PR的主要变更内容

## 相关Issue
关联的issue: #

## 变更类型
- [ ] 新功能
- [ ] Bug修复
- [ ] 性能改进
- [ ] 代码风格更新
- [ ] 重构
- [ ] 文档更新
- [ ] 测试相关
- [ ] 其他

## 测试
- [ ] 添加了新的测试用例
- [ ] 现有测试全部通过

## 截图（如适用）

## 特别说明
任何审查者应特别注意的事项

小结：通过实际案例应用Markdown，可以有效提升项目文档质量和团队协作效率，是每个开发者必备的技能。

五、常见问题解决：Markdown实战答疑

在使用Markdown的过程中，开发者经常会遇到一些格式问题或平台兼容性问题。以下是一些常见问题的解决方案。

格式显示异常

问题：在本地编辑器中显示正常的Markdown，在GitHub上显示格式错乱。

解决方案：

1. 检查是否使用了GitHub不支持的扩展语法
2. 确保表格语法正确，表头分隔线不能省略
3. 代码块使用三个反引号，并指定正确的语言

图片路径问题

问题：本地图片在GitHub上无法显示。

解决方案：

1. 使用相对路径引用图片，确保图片文件已提交到仓库
2. 图片路径区分大小写，确保与实际文件路径一致
3. 避免使用中文文件名，可能导致兼容性问题

特殊符号处理

问题：Markdown特殊符号（如#、*、_）需要显示为普通文本。

解决方案：

1. 在特殊符号前添加反斜杠\进行转义

   \# 这不是一个标题
   \* 这不是斜体文本