test

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. 忘记密码
+     • 在登录页面点击 “忘记密码”。
+     • 输入注册时使用的邮箱地址，系统会发送密码重置邮件，按照邮件提示操作即可重置密码。
+