Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Install instructions not detailed enough to work on a new Mac purchased from the store

未关闭
#789 0 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
30/100
Issue 类型
文档
描述清晰度
需要澄清
活跃度
停滞
技术栈
jekyll, ruby

调研方向

从 README 中的第一条安装说明开始,尤其是会产生所报告的 Gem::FilePermissionError 的 gem update bundler 命令。检查贡献指南和本地构建设置说明,然后将文档定义为在新的 Mac 用户能够按照设置步骤操作并在本地构建网站,且不会遇到所报告的权限错误时完成。

由索引模型根据 Issue 内容生成。

描述

Before submitting an issue, please be sure to
This issue affects
  • Building sites locally
What did you do (e.g., steps to reproduce)
  1. Go to Apple Store
  2. Buy new Mac
  3. Open README
  4. Follow first instruction on the page, type gem update bundler into Terminal
What did you expect to happen?

No error

What happened instead?

Error

Updating installed gems
Updating bundler
ERROR: While executing gem ... (Gem::FilePermissionError)


Notes

Please note that GitHub is used to host websites. Lots of people know how to edit HTML, they now teach this in middle school.

Not everybody knows how to set up a build environment, use git, set up Ruby, set up Ruby under Homebrew, set up Ruby under RVM under Homebrew. Not even starting on Jekyll yet.

It will be very empowering if the instructions here can help anybody get started running a website locally, with full and correct instructions.

主要语言
Ruby
星标
1.9k
派生
363
PR 合并指标
30 天内没有已合并 PR

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

github/pages-gem 的其他 Issue

查看 github/pages-gem 的全部 Issue

相似的 Issue

更多 Ruby Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。