diff --git a/Gitea使用文档(1).pdf b/Gitea使用文档(1).pdf new file mode 100644 index 0000000..64ee42b --- /dev/null +++ b/Gitea使用文档(1).pdf @@ -0,0 +1,114 @@ +Gitea 使用文档 + +一、访问 Gitea + +通过浏览器访问 http://49.232.210.78:3000/ 即可进入 Gitea 平台首页。 + +二、用户注册与登录 + +1. 注册 + • 在首页点击 “注册” 按钮。 + • 填写用户名、邮箱地址和密码。用户名需遵循一定规则,通常不能包含特殊字符且不能与已有用 + 户重复。邮箱地址用于接收通知和密码重置等信息。 + • 完成填写后,点击 “注册账号”。 + +2. 登录 + • 在首页点击 “登录” 按钮。 + • 输入注册时使用的用户名和密码,点击 “登录”。 + +三、创建仓库 + +1. 登录后,在页面右上角点击头像,选择 “你的仓库”。 +2. 在仓库列表页面,点击 “新建仓库” 按钮。 +3. 填写仓库名称,例如 “my - first - repo”。名称应简洁明了,能反映仓库的主要内容。 +4. 可以选择添加仓库描述,让其他用户更好地了解仓库用途。 +5. 选择仓库的可见性,有 “公开”“私有”“内部” 三种选项: + + • 公开:任何人都可以查看仓库代码和相关信息。 + • 私有:只有仓库所有者和被邀请的协作者可以访问。 + • 内部:仅特定组织或团队成员可访问(若在组织环境下)。 +6. 可根据需要初始化仓库,如添加 README 文件、选择.gitignore 模板和开源许可证等。完成设置后, + 点击 “创建仓库”。 + 四、克隆仓库到本地 + +1. 在仓库页面,点击右上角的 “克隆 / 下载” 按钮。 +2. 复制仓库的 URL 地址,例如 http://49.232.210.78:3000/用户名/my - first - repo.git。 +3. 打开本地命令行工具(如 Git Bash 或 Windows 命令提示符)。 +4. 切换到希望克隆仓库的本地目录,例如 cd /d C:\Users\YourUsername\Documents\GiteaRepos。 +5. 执行克隆命令 git clone 仓库URL,如 git clone http://49.232.210.78:3000/用户名/my - first - repo. + + git。等待克隆完成后,本地就有了该仓库的副本。 + +五、上传代码到仓库 + +1. 在本地仓库目录下,使用文本编辑器或 IDE 编写代码文件。 +2. 编写完成后,在命令行中执行以下命令: + + • git add.:将所有修改和新增的文件添加到暂存区。 + • git commit -m "提交说明":提交代码到本地仓库,提交说明应清晰描述本次提交的内容。 + • git push origin master(假设主分支是 master):将本地仓库的代码推送到远程 Gitea 仓库。若 + + 推送过程中提示输入用户名和密码,输入在 Gitea 平台注册的用户名和密码即可。 + +六、分支管理 + +1. 创建分支 + • 在本地仓库目录下,执行 git branch 分支名,如 git branch new - feature - branch。 + • 切换到新分支:git checkout new - feature - branch。 + +2. 切换分支 + • git checkout 分支名,例如要切换回 master 分支,执行 git checkout master。 + +3. 合并分支 + • 先切换到目标分支,如 master 分支 git checkout master。 + • 执行 git merge 要合并的分支名,如 git merge new - feature - branch。合并过程中可能会遇到冲 + 突,需要手动解决冲突后再继续提交合并结果。 + 七、协作开发 + +1. 邀请协作者 + • 进入仓库页面,点击 “设置”。 + • 在左侧菜单中选择 “协作”。 + • 输入协作者的用户名或邮箱地址,选择要赋予的权限(如 “读取”“写入”“管理员” 等),点 + 击 “添加协作者”。 + +2. 协作者接受邀请 + • 协作者登录 Gitea 平台,在通知中心会收到邀请通知。 + • 点击通知进入仓库页面,点击 “接受邀请” 即可成为仓库协作者,可对仓库进行相应权限的操作 + 。 + +八、仓库设置 + +1. 基本设置 + • 在仓库页面点击 “设置”。 + • 在 “基本设置” 中,可以修改仓库名称、描述、可见性等信息。 + +2. Webhooks 设置 + • 在 “Webhooks” 设置中,可以添加 Webhook,当仓库发生特定事件(如代码推送、创建分支等 + )时,自动向指定的 URL 发送 HTTP 请求,用于触发外部服务(如持续集成 / 持续部署流程)。 + • 填写 Webhook 的 URL 地址,选择要触发的事件类型(如 Push 事件、Create 事件等),点击 “ + 添加 Webhook”。 + +3. 管理标签和里程碑 + • 在 “标签” 和 “里程碑” 设置中,可以创建、编辑和删除标签与里程碑,用于项目管理和版本控 + 制。 + +九、搜索与浏览仓库 + +1. 在 Gitea 首页的搜索框中,可以输入仓库名称、用户名等关键词进行搜索。 +2. 在仓库列表页面,可以通过分类筛选(如按所有者、按可见性等)来浏览仓库。 +3. 进入仓库页面后,可以浏览仓库的文件结构、代码文件内容、提交记录、分支列表等信息。 + 十、常见问题与解决方法 + +1. 无法推送代码 + • 原因:可能是网络问题、用户名密码错误、权限不足等。 + • 解决方法:检查网络连接,确认用户名密码正确,若权限不足,联系仓库管理员提升权限。 + +2. 仓库克隆失败 + • 原因:可能是仓库 URL 错误、网络不稳定等。 + • 解决方法:仔细检查仓库 URL 是否正确,尝试重新克隆,若网络不稳定,等待网络恢复正常后再 + 试。 + +3. 忘记密码 + • 在登录页面点击 “忘记密码”。 + • 输入注册时使用的邮箱地址,系统会发送密码重置邮件,按照邮件提示操作即可重置密码。 +