Осмысленный коммит

Индекс собирают по одному файлу. Какой командой отметить только index.html?

Что войдёт в коммит, показывает сравнение индекса с последним коммитом. Короткий вариант — с ключом --stat.

git add index.html → git diff --staged --stat → git commit -m "…"; затем то же для site.conf. HEAD~1 — коммит перед HEAD.

Перед главой 2

Конец главы 1: два коммита, working tree clean. Папки ~/git-course/site быть не должно.

bash <<'SETUP'
rp_before2() {
  # --- Проверки: ничего не меняют ---
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  course_repo() {
    [ -d "$1/.git" ] || { fail "$1 — нет такого репозитория Git"; return 1; }
    git -C "$1" log --max-parents=0 --format=%s 2>/dev/null | grep -qx 'Первая версия учебного сайта' \
      || { fail "$1 — не учебный репозиторий курса"; return 1; }
  }
  quiet() {  # папка, ожидаемая ветка, разрешённые неотслеживаемые файлы через пробел
    local x f
    [ "$(git -C "$1" symbolic-ref --short -q HEAD)" = "$2" ] || { fail "в $1 текущая ветка не $2"; return 1; }
    for x in MERGE_HEAD REVERT_HEAD CHERRY_PICK_HEAD REBASE_HEAD; do
      git -C "$1" rev-parse -q --verify "$x" >/dev/null && { fail "в $1 не завершена операция Git ($x) — завершите или отмените её"; return 1; }
    done
    for x in rebase-merge rebase-apply; do
      [ -e "$(git -C "$1" rev-parse --git-path "$x")" ] && { fail "в $1 не завершён rebase"; return 1; }
    done
    [ -z "$(git -C "$1" status --porcelain --untracked-files=no)" ] || { fail "в $1 есть незакоммиченные изменения"; return 1; }
    for f in $(git -C "$1" ls-files --others --exclude-standard); do
      case " $3 " in *" $f "*) ;; *) fail "в $1 лишний неотслеживаемый файл $f"; return 1 ;; esac
    done
  }
  last_is() { [ "$(git -C "$1" log -1 --format=%s)" = "$2" ] || { fail "в $1 последний коммит не «$2»"; return 1; }; }
  no_branch() { ! git -C "$1" show-ref --verify -q "refs/heads/$2" || { fail "в $1 уже есть ветка $2"; return 1; }; }
  absent() { [ ! -e "$1" ] || { fail "$1 уже существует — переименуйте её сами, если хотите начать заново"; return 1; }; }
  command -v git >/dev/null || { fail "не найден git"; return 1; }
  absent ~/git-course/site || return 1
  # --- Подготовка: после первой записи при ошибке скрипт останавливается ---
  (
    set -e
mkdir -p ~/git-course/site
cd ~/git-course/site
git init -q -b main
git config user.name "Анна (учебный)"
git config user.email "anna@example.invalid"
cat > index.html <<'EOF'
<!doctype html>
<html lang="ru">
<head><meta charset="utf-8"><title>Учебный сайт</title></head>
<body>
<h1>Учебный сайт</h1>
<p>Здесь будет расписание занятий.</p>
</body>
</html>
EOF
cat > site.conf <<'EOF'
# Настройки учебного сайта
PORT=8081
NAME=site
TITLE=Учебный сайт
EOF
cat > README.md <<'EOF'
# Учебный сайт

Запуск для проверки: python3 -m http.server 8081
EOF
git add index.html site.conf README.md
git commit -q -m "Первая версия учебного сайта"
cat > about.html <<'EOF'
<!doctype html>
<html lang="ru">
<head><meta charset="utf-8"><title>О нас</title></head>
<body>
<h1>О нас</h1>
<p>Учебный сайт курса «Git: основы».</p>
</body>
</html>
EOF
git add about.html
git commit -q -m "Добавить страницу «О нас»"
  )
  if [ $? -ne 0 ]; then
    echo "Ошибка после начала подготовки: часть шагов могла выполниться."
    echo "Посмотрите git status и git log --oneline --all -5. Начать заново: переименуйте ~/git-course"
    echo "(mv ~/git-course ~/git-course-old) и выполните блоки этого файла с начала."
    return 1
  fi
  git -C ~/git-course/site log --oneline
  echo "Готово: конец главы 1, два коммита."
}
rp_before2 </dev/null
SETUP

Практика главы 2

Конец разбора главы 2: три коммита, в папке изменены index.html и site.conf, индекс пуст. Выполняется после блока «Перед главой 2».

bash <<'SETUP'
rp_practice2() {
  # --- Проверки: ничего не меняют ---
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  course_repo() {
    [ -d "$1/.git" ] || { fail "$1 — нет такого репозитория Git"; return 1; }
    git -C "$1" log --max-parents=0 --format=%s 2>/dev/null | grep -qx 'Первая версия учебного сайта' \
      || { fail "$1 — не учебный репозиторий курса"; return 1; }
  }
  quiet() {  # папка, ожидаемая ветка, разрешённые неотслеживаемые файлы через пробел
    local x f
    [ "$(git -C "$1" symbolic-ref --short -q HEAD)" = "$2" ] || { fail "в $1 текущая ветка не $2"; return 1; }
    for x in MERGE_HEAD REVERT_HEAD CHERRY_PICK_HEAD REBASE_HEAD; do
      git -C "$1" rev-parse -q --verify "$x" >/dev/null && { fail "в $1 не завершена операция Git ($x) — завершите или отмените её"; return 1; }
    done
    for x in rebase-merge rebase-apply; do
      [ -e "$(git -C "$1" rev-parse --git-path "$x")" ] && { fail "в $1 не завершён rebase"; return 1; }
    done
    [ -z "$(git -C "$1" status --porcelain --untracked-files=no)" ] || { fail "в $1 есть незакоммиченные изменения"; return 1; }
    for f in $(git -C "$1" ls-files --others --exclude-standard); do
      case " $3 " in *" $f "*) ;; *) fail "в $1 лишний неотслеживаемый файл $f"; return 1 ;; esac
    done
  }
  last_is() { [ "$(git -C "$1" log -1 --format=%s)" = "$2" ] || { fail "в $1 последний коммит не «$2»"; return 1; }; }
  no_branch() { ! git -C "$1" show-ref --verify -q "refs/heads/$2" || { fail "в $1 уже есть ветка $2"; return 1; }; }
  absent() { [ ! -e "$1" ] || { fail "$1 уже существует — переименуйте её сами, если хотите начать заново"; return 1; }; }
  command -v git >/dev/null || { fail "не найден git"; return 1; }
  course_repo ~/git-course/site || return 1
  quiet ~/git-course/site main || return 1
  last_is ~/git-course/site "Добавить страницу «О нас»" || return 1
  # --- Подготовка: после первой записи при ошибке скрипт останавливается ---
  (
    set -e
cd ~/git-course/site
sed -i 's/^PORT=8081/PORT=8082/' site.conf
git commit -q -am "Перенести сайт на порт 8082" -m "Порт 8081 на учебном сервере занят сервисом greeter."
sed -i 's|<p>Здесь будет расписание занятий.</p>|<p>Занятия: вторник и четверг, 19:00.</p>|' index.html
sed -i 's/^TITLE=.*/TITLE=Учебный сайт курса Git/' site.conf
git status --short
  )
  if [ $? -ne 0 ]; then
    echo "Ошибка после начала подготовки: часть шагов могла выполниться."
    echo "Посмотрите git status и git log --oneline --all -5. Начать заново: переименуйте ~/git-course"
    echo "(mv ~/git-course ~/git-course-old) и выполните блоки этого файла с начала."
    return 1
  fi
  echo "Готово: изменены index.html и site.conf, индекс пуст."
}
rp_practice2 </dev/null
SETUP

Ожидаемый результат — Готово, затем git status --short покажет M index.html и M site.conf.

Практика

Папка: ~/git-course/site.

git add index.html
git diff --staged --stat

 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

В индексе только index.html — можно сохранять.

git commit -m "Добавить расписание занятий на главную"
git add site.conf
git diff --staged

diff --git a/site.conf b/site.conf
index d881499..537eb36 100644
--- a/site.conf
+++ b/site.conf
@@ -1,4 +1,4 @@
 # Настройки учебного сайта
 PORT=8082
 NAME=site
-TITLE=Учебный сайт
+TITLE=Учебный сайт курса Git

Порт уже в истории, поэтому в diff только заголовок.

git commit -m "Уточнить заголовок сайта"
git log --oneline

ba1c983 Уточнить заголовок сайта
a4045c5 Добавить расписание занятий на главную
e722969 Перенести сайт на порт 8082
f6d4ea3 Добавить страницу «О нас»
be0a128 Первая версия учебного сайта

Хеши у вас другие. git status → working tree clean.

Воспроизведено: Git 2.43.0, Ubuntu 24.04.

Проверка понимания

1. Та, что лежит в индексе, — версия на момент последнего git add. Вторая правка (правая M) останется в рабочей папке и после коммита будет видна как M site.conf.
2. «Правки» не отвечает ни на «что», ни на «зачем»: чтобы понять коммит, придётся читать diff, а причину (порт занят greeter) не восстановить вовсе. Конкретное сообщение помогает найти коммит в истории и решить, можно ли его отменить (главы 3 и 7).