Github 将图像添加到自述文件 - Shell-Bash

如果您想在您的 Github 个人资料或项目的 README 文件中添加图片，那么您来到了正确的地方。在本教程中，您将学习如何在 Shell-Bash 命令行中使用 Github 的 API 上传和嵌入图片，并在项目的 README 文件中展示它。

步骤 1 - 生成 Github Token

在使用 Github API 时，您需要生成 Github Token。如果您已经拥有一个 Github Token，请跳过此步骤。

1. 登录您的 Github 账户。

2. 单击您的个人资料照片，然后单击Settings。

3. 在左侧侧边栏中，单击 Developer settings，然后单击 Personal access tokens。

4. 单击 Generate new token。

5. 输入一个描述您的 Token 的名称（例如“Github API Token”），然后勾选 repo，read:user 和 user:email。 这将授予 Token 访问您的仓库和账户信息的权限。

6. 单击 Generate token，并记录下您的 Token。

步骤 2 - 上传图片到 Github

现在，您已经拥有了 Github 的 API 访问权限，可以使用 Shell-Bash 命令行上传图片到您的 Github。

1. 打开 Shell-Bash 命令行终端。

2. 安装 cURL 命令行工具。 您可以使用以下命令：

   sudo apt-get install curl
   

3. 使用以下命令获取您的 Github 用户名：

   USERNAME=$(curl -s -H "Authorization: token YOUR_GITHUB_TOKEN" https://api.github.com/user | grep -w login | awk '{print $2}' | sed 's/"//g' | sed 's/,//g')
   

   将YOUR_GITHUB_TOKEN替换为您在第一步中生成的 Github Token。

4. 使用以下命令创建一个新的 Github 仓库：

   REPO=$(curl -s -H "Authorization: token YOUR_GITHUB_TOKEN" -d '{"name": "YOUR_REPO_NAME"}' https://api.github.com/user/repos | grep -w clone_url | awk '{print $2}' | sed 's/"//g' | sed 's/,//g' | sed 's/github.com/'$USERNAME:${YOUR_GITHUB_TOKEN}@github.com/g')
   

   将YOUR_REPO_NAME更改为您创建的仓库的名称。

5. 在您的本地存储库中创建一个新文件夹，并将您的图像文件添加到该文件夹中。

6. 使用以下命令将图像上传到 Github：

   curl -s -u $USERNAME:$YOUR_GITHUB_TOKEN -X PUT -H "Content-Type: application/octet-stream" --data-binary @/path/to/your/image.jpg https://api.github.com/repos/$USERNAME/$YOUR_REPO_NAME/contents/PATH%2FTO%2FIMAGE.jpg -d '{"message": "add image"}'
   

   请注意，您需要替换以下内容：

   • YOUR_GITHUB_TOKEN - 您在第一步中生成的 Github Token。

   • USERNAME - 您的 Github 用户名。

   • YOUR_REPO_NAME - 您创建的 Github 存储库的名称。

   • /path/to/your/image.jpg - 图像文件的本地路径。

   • PATH%2FTO%2FIMAGE.jpg - 图像文件的 Github 存储路径。将文件夹和文件名添加到 PATH%2FTO%2F 中。

7. 当您收到以下响应时，表示文件上传成功：

   {
     "content": {
       "name": "IMAGE.jpg",
       "path": "PATH/TO/IMAGE.jpg",
       "sha": "SHA_HASH"
     }
   }
   

   记下"sha"值，您需要在下一步中使用它。

8. 切换到您的 Github 存储库，并在 README 文件中添加以下 markdown 代码：

   ![IMAGE](IMAGE_URL)
   

   将 IMAGE 替换为您的图像文件名，将 IMAGE_URL 替换为步骤 2.7 中获得的 Github URL。使用以下格式：

   https://raw.githubusercontent.com/YOUR_USERNAME/YOUR_REPO_NAME/SHA_HASH/PATH/TO/IMAGE.jpg
   

   将YOUR_USERNAME和YOUR_REPO_NAME替换为您的 Github 用户名和存储库名称。将SHA_HASH替换为步骤 2.7 中获得的 sha 值。将PATH/TO/IMAGE.jpg替换为您的图像文件在 Github 存储库中的路径。

9. 提交更改并推送到 Github。

结论

现在，您已经在您的 Github 个人资料或存储库的 README 文件中成功添加了图片。这使得您的页面更加生动和丰富，同时也向其他用户展示了您的技能和成果。