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

Update outdated examples and versions in README

未关闭 适合新手
#165 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
88/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
docker, github-actions, shell
领域
documentation

调研方向

更新 README 中的示例、生成的 TOC、action 和 Docker 版本、测试数量文本、tested-on 说明以及 Combo URL。首先阅读相关的 README 部分,并比较 tests/tests.bats 中的缩进和测试预期。保持标题不变,然后运行测试,以确认 README 标题列表和更新后的文档正确无误。

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

描述

documentation

README contains several outdated examples and versions.

Outdated items

  • Usage and "Auto insert and update TOC" examples show TOC output in an old
    format (2 and 8 space indents). The current default is --indent 3: top-level
    entries have no indent, nested ones use 3, 6, ... spaces (see tests/tests.bats).
  • README's own TOC between <!--ts--> and <!--te--> was generated by an older
    version: its indentation differs from the current output.
  • "TOC generation with Github Actions" uses actions/checkout@v2 and
    stefanzweifel/git-auto-commit-action@v4. The latest releases are v7.0.1 and
    v7.2.0.
  • Docker / Public pulls evkalinin/gh-md-toc:0.7.0. Docker Hub has tags up to
    0.10.0, which matches gh_toc_version.
  • Tests shows an old run with 6 tests, including "TOC for remote README.md" and
    "TOC for mixed README.md (remote/local)", which are commented out now. The suite
    has 11 tests.
  • "Tested on" statements: "macOS High Sierra (gh-md-toc release 0.4.9)" in the
    intro and "Ubuntu 14.04/14.10 in bash/zsh" in Dependency. CI runs on
    ubuntu-latest.
  • Combo example has a typo in the URL: sitemap.s instead of sitemap.js.

Notes

  • tests/tests.bats asserts README's heading list, so headings should stay
    unchanged.
主要语言
Shell
星标
3.3k
派生
2.7k
平均合并
20 分钟
30 天内合并 PR
7

环境准备

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

从这里开始

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

ekalinin/github-markdown-toc 的其他 Issue

查看 ekalinin/github-markdown-toc 的全部 Issue

相似的 Issue

更多 Shell/Bash Issue

把新 issue 发到你的邮箱

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