🚀 نحوه ادغام تعهدات (`cz`) در راه اندازی NVCHAD برای تعهدات بهتر GIT

✅ پیام های متعهد خود را تمیز ، سازگار و متعارف کنید – درست در Neovim!

وقتی نوبت به مدیریت پایگاه کد می رسد ، پیام های متعهد خوب نوشته شده به اندازه کد تمیز مهم هستند. آنها زمینه را فراهم می کنند ، به اشکال زدایی کمک می کنند و به همکاران (و خود آینده شما) در درک تکامل پروژه شما کمک می کنند. این جایی است که ابزارها دوست دارند متعهد شدن درخشش – هدایت شما در روند نوشتن تعهدات متعارف و استاندارد با سهولت

اگر از NVCHAD ، پیکربندی Neovim مدرن و حداقل استفاده می کنید ، ادغام می شود cz به گردش کار خود می تواند بهداشت GIT خود را به طرز چشمگیری بهبود بخشید بدون اینکه هرگز راحتی ویرایشگر خود را ترک کنید.

این راهنما چندین رویکرد بهترین عمل برای ادغام را بررسی می کند cz CLI به NVCHAD-از نگاشتهای کلید ساده گرفته تا پایانه های پلاگین. این که آیا شما یک مینیمالیستی هستید یا عاشق پایانه های شناور خود هستید ، در اینجا یک راه اندازی برای شما وجود دارد.

📌 پیش نیازها

قبل از شروع ، اطمینان حاصل کنید که محیط لازم را تنظیم کرده اید.

✅ 1. Node.js و NPM را نصب کنید

COMPEIZEN یک ابزار CLI مبتنی بر Node.js است.

node -v
npm -v

در صورت نصب ، node.js را از nodejs.org دریافت کنید یا از مدیر بسته بندی خود استفاده کنید.

✅ 2. نصب تعهد در سطح جهان

npm install -g commitizen

نصب را با:

cz

این باید سریع تعهدات تعاملی را در ترمینال شما باز کند.

🧠 چرا از Commitizen در Neovim استفاده می کنید؟

ادغام کننده cz مستقیماً با NVCHAD مزایای مختلفی را ارائه می دهد:

• 🧘‍♂ گردش کار با محوریت ویرایشگر – بدون تعویض زمینه
• 📋 تعهدات استاندارد – ساختار اجباری مانند تعهدات متعارف
• 🚫 اشتباهات کمتری – دیگر پیام های متعهد ناقص وجود ندارد
• ⚡ سرعت و کارآیی – یک کلید برای انجام

اگر در حال حاضر از Neovim به عنوان IDE خود استفاده می کنید ، چرا تعهدات Git را به اندازه کد نوشتن صاف نکنید؟

📁 کار با NVCHAD

NVCHAD یک روش پیکربندی مدولار را تشویق می کند. پیکربندی سفارشی شما در:

~/.config/nvim/lua/custom/

شما عمدتا ویرایش خواهید کرد:

• chadrc.lua – پیکربندی اصلی برای نقشه ها ، ترفندهای UI و غیره.
• mappings.lua – برای نگاشتهای کلید سفارشی
• plugins/ – برای مدیریت افزونه های اضافی مانند toggleterm.nvim

🛠 روش 1: ترمینال شناور سبک (بهترین برای سادگی)

این روش از ترمینال بومی Neovim در درون یک تقسیم افقی-ساده ، سریع و بدون وابستگی استفاده می کند.

🔧 راه اندازی

1. این عملکرد را در mappings.lua یا chadrc.lua:

local function commitizen_commit()
  vim.cmd("belowright split | resize 15 | terminal cz")
  end

1. نقشه را به یک کلید ، مانند cz:

  local map = vim.keymap.set
  map("n", "cz", commitizen_commit, { desc = "Commit using Commitizen" })

✅ نتیجه:

ضربه cz و یک ترمینال تقسیم شده در پایین باز می شود و در حال اجرا است cz سریع فوق العاده تمیز و به طور طبیعی در neovim ادغام می شود.

🧩 روش 2: ترمینال بازشو پیشرفته با ToggleTerm (بهترین UI)

آیا می خواهید یک پاپ آگهی ترمینال شناور با همبستگی خودکار و حواس پرتی حداقل؟ وارد کردن toggleterm.nvimبشر

📦 گام به گام

1. اضافه کردن toggleterm.nvim به عنوان یک افزونه سفارشی در custom/plugins/commitizen.lua:

  return {
    {
      "akinsho/toggleterm.nvim",
        config = function()
          require("toggleterm").setup()

          local Terminal = require("toggleterm.terminal").Terminal
          local cz_term = Terminal:new({
              cmd = "cz",
              hidden = true,
              direction = "float",
              })

      vim.keymap.set("n", "cz", function()
          cz_term:toggle()
          end, { desc = "Commit with Commitizen" })
        end,
    }
  }

1. سپس آن را وارد کنید custom/plugins/init.lua:

require("custom.plugins.commitizen")

✅ نتیجه:

مطبوعات cz، و یک ترمینال شناور براق با آن باز می شود czبشر یکی از بهترین پیشرفت های UX که می توانید به گردش کار GIT خود اضافه کنید.

🔁 روش 3: تقسیم ترمینال ساده (بدون افزونه ، مشکلی نیست)

این روش بدون پلاگین و حتی حداقلی تر است.

vim.keymap.set("n", "cz", function()
    vim.cmd("split | terminal cz")
    end, { desc = "Commitizen simple split" })

✅ نتیجه:

یک تقسیم عمودی سریع با آن باز می شود czاگر پیکربندی یا وابستگی اضافی را ترجیح نمی دهید ، عالی باشد.

🎨 جایزه: ادغام پالت فرمان (سبک NVCHAD)

NVCHAD شامل یک منوی به سبک پالت فرمان با جستجوی فازی است. برای ساخت می توانید دستور سفارشی خود را ایجاد کنید cz حتی در دسترس تر

💡 این را به اضافه کنید chadrc.lua:

vim.api.nvim_create_user_command("Commitizen", function()
    vim.cmd("split | terminal cz")
    end, {})

✅ استفاده:

فقط تایپ کنید :Commitizen در حالت فرمان برای راه اندازی cz در یک تقسیم سریع. برای کاربران صفحه کلید بسیار مفید است.

🧼 نکته PRO: از ماندگاری بافرها جلوگیری کنید

گاهی اوقات ، استفاده cz ترک یک .git/COMMIT_EDITMSG بافر در Neovim. در حالی که بی ضرر است ، می تواند لیست بافر شما را به هم بزند.

برای تمیز نگه داشتن چیزها:

• استفاده کردن cz به جای git commit مستقیم.
• در صورت لزوم ، AutoCommands را تنظیم کنید تا بافر را به طور خودکار ببندید.
• نقشه q برای بستن سریع بافرهای پیام متعهد.

📦 پیشرفت های آینده

• 🤖 ادغام با gitmoji-cli برای تعهدات ایموجی.
• 🧠 دستورات زنجیره به مرحله خودکار ، تعهدات را اجرا کنید و فشار دهید.
• 🧰 به lazygit.nvim و ابزارهای شناور را ترکیب کنید.
• 📑 الگوهای تعهد را اضافه کنید با تعهدات متعارف + دامنه.

🧭 خلاصه روشها

thoughts افکار نهایی

برای انجام تعهدات متعارف و با کیفیت بالا نیازی به ترک Neovim ندارید. این که آیا شما مینیمالیسم تیمی هستید یا عاشق یک رابط کاربری جلا هستید ، ادغام می کنید cz به Nvchad Will در وقت خود صرفه جویی کنید ، بهترین شیوه ها را اجرا کنید و تاریخچه Git خود را بدرخشیدبشر

این راهنما چندین مسیر را ارائه می دهد – یکی را انتخاب کنید که متناسب با گردش کار شما باشد یا همه آنها را امتحان کنید. در هر صورت ، تیم آینده شما (یا خود) از شما تشکر خواهد کرد.

💬 سوالات دارید؟

احساس راحتی کنید تا روابط عمومی را باز کنید ، پیشرفت ها را پیشنهاد دهید یا سؤال کنید! بازخورد شما این را برای همه بهتر می کند.

تعهد مبارک! 🎉