Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

repo: 295 of 416 catalog entries have CRLF line endings and there is no .gitattributes

オープン
#140 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
52/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
git, javascript
領域
tooling

調査の方向性

Start by reading site/lib/frontmatter.mjs and markdown.mjs at the cited lines, then inspect validate.mjs, CONTRIBUTING, and .git-blame-ignore-revs. Add a line ending policy, renormalize tracked files, enforce it in validation, and document it. Done when git ls-files --eol shows no CRLF or mixed files and a CRLF fixture fails npm run validate with a clear message.

索引モデルが issue の本文から書いたものです。

説明

dx priority: medium

Why it matters

The parsers tolerate \r\n (site/lib/frontmatter.mjs:92, markdown.mjs:104), so nothing breaks today, but the repo has no line-ending policy: git ls-files --eol reports 295 files as i/mixed (CRLF body, LF final line) and 5 as i/crlf, next to 225 i/lf. Contributors on Linux and macOS get whole-file diffs when their editor normalises, npm run new-entry output and hand-edited files disagree, and a future helper that splits on \n alone will silently keep a \r in a field value. It is the kind of friction a first-time contributor hits and gives up on.

Evidence (at 69387df)

$ git ls-files --eol | awk '{print $1}' | sort | uniq -c
    5 i/crlf
  225 i/lf
  295 i/mixed

All 295 mixed files are under catalog/ (tools 65, 3d 60, 2d 49, audio 25, characters 24, fonts 23, shaders-vfx 15, video 13, environment 11, animation 10). No .gitattributes exists; core.autocrlf is unset.

Suggested approach

Add .gitattributes with * text=auto eol=lf plus binary for *.webp, *.png, *.woff2; run git add --renormalize . in one commit titled "Normalise line endings" and list it in .git-blame-ignore-revs. Add a one-line check in validate.mjs that rejects a \r in any catalog or docs file, so the policy is enforced rather than assumed.

Done when

git ls-files --eol shows no i/crlf or i/mixed; a CRLF fixture fails npm run validate with a clear message; CONTRIBUTING mentions the policy in one sentence.

主要言語
JavaScript
スター
58
フォーク
15
平均マージ
16時間 53分
マージ済み PR(30日)
14

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

TMHSDigital/Free-Game-Dev-Assets のほかの issue

TMHSDigital/Free-Game-Dev-Assets の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。