Patch chapter 4

Author: Davoodeh

TRANSLATION_NOTES.asc

@@ -127,4 +127,11 @@
 |برچسب توضیحی |Annotated tag
 |برچسب سبک |Lightweight tag
 |نام‌های مستعار |Aliases
+|مخزن بر |Bare repository
+|خلاصه |Summary
+|گواهی |Credential
+|دستگاه/سیستم |Machine
+|دیمن |Daemon
+|دیمنیزه |Daemonize
+|هندلر |Handler
 |===

book/04-git-server/sections/generating-ssh-key.asc

@@ -1,14 +1,13 @@
 [[_generate_ssh_key]]
-=== ساخت کلید عمومی SSH
+=== ساختن کلید عمومی SSH
 
 (((SSH keys)))
-
 بسیاری از سرور‌های گیت به وسیله کلید عمومی SSH تصدیق هویت می‌کنند.
-برای تهیه کردن یک کلید عمومی، هر کاربر در سیستم شخصی خود باید یکی از آن را اگر ندارد بسازد.
-این فرایند در همه‌ی سیستم‌های عامل یکسان است.
-اول، شما باید بررسی کنید که از قبل کلید عمومی نساخته باشید.
-به صورت پیش فرض، کلید SSH هر کار در پوشه `ssh./~` ذخیره‌ می‌شود.
-شما می‌توانید به سادگی پوشه را چک کنید محتوای پوشه را لیست کنید:
+برای تهیه کردن یک کلید عمومی، هر کاربر در سیستمتان، در صورتی که ندارد، ملزم است یکی بسازد.
+این فرایند در همهٔ سیستم‌عامل‌ها یکسان است.
+اول، باید اطمینان حاصل کنید که از قبل کلید کلیدی ندارید.
+به صورت پیش فرض، کلید SSH هر کاربر در پوشه `~/.ssh` ذخیره‌ می‌شود.
+شما می‌توانید به سادگی با رفتن به آن پوشه و لیست کردن محتویات آن را بررسی کنید:
 
 [source,console]
 ----
@@ -18,10 +17,10 @@ authorized_keys2  id_dsa       known_hosts
 config            id_dsa.pub
 ----
 
-شما به دنبال یک فایل با نامی شبیه به `id_dsa` یا `id_rsa` هستید و فایل با پسوند `pub.`.
-فایل `pub.` کلید عمومی شما است و بقیه فایل‌ها با کلید خصوصی ارتباط دارند.
-اگر این فایل‌ها(و یا حتی پوشه `ssh.`) را ندارید، می‌توانید آن‌ها را با اجرای برنا‌مه‌ای به نام `ssh-keygen` بسازید،
-که همراه پکیج SSH در سیستم‌‌عامل‌های لینوکس/مک موجود است و همچنین همراه بسته نصبی گیت در ویندوز موجود است.
+شما به دنبال یک جفت فایل با نام‌هایی شبیه به `id_dsa` یا `id_rsa` و فایلی مشابه با پسوند `.pub` هستید.
+فایل `.pub` کلید عمومی شما است و فایل دیگر کلید خصوصی نظیر آن است.
+اگر این فایل‌ها (و یا حتی پوشه `.ssh`) را ندارید، می‌توانید آن‌ها را با اجرای برنا‌مه‌ای به نام `ssh-keygen` بسازید،
+که همراه پکیج SSH در سیستم‌‌عامل‌های لینوکس/مک و همراه «گیت برای ویندوز» ارائه می‌شود:
 
 [source,console]
 ----
@@ -37,14 +36,14 @@ The key fingerprint is:
 d0:82:24:8e:d7:f1:bb:9b:33:53:96:93:49:da:9b:e3 [email protected]
 ----
 
-اول از شما می‌خواهد که تایید کنید تا فایل (`ssh/id_rsa.`) کجا ذخیر شود و سپس از شما دوباره عبارت رمزی را خواهد پرسید،
-که شما می‌توانید آن را خالی رها کنید اگه نیاز به رمزعبور ندارید، مطمئن شوید که از آپشن `o-` در دستور استفاده کرده‌اید؛
-این کار کلید خصوصی را به نحوی ذخیره می‌کند در برابر حمله‌های بروت‌فورس مقاومت کند که این فرمت پیش‌فرض فایل کلید خصوصی است.
-و دیگر اینکه می‌توانید از ابزار `ssh-agent` برای اجتناب از وارد کردن از رمزعبور هر بار برای آن استفاده کنید.
+ابتدا از شما می‌پرسد که کلید را کجا می‌خواهید ذخیره کنید (`.ssh/id_rsa`)، سپس دو بار از شما یک رمز (Passphrase) می‌خواهد،
+که می‌توانید آنرا خالی بگذارید اگر مایل نیستید هر بار که از کلید استفاده می‌کنید رمز وارد کنید.
+هرچند، اگر از رمزی استفاده می‌کنید، مطمئن شوید که از آپشن `-o` در دستور استفاده می‌کنید؛
+این کار کلید خصوصی را به نحوی ذخیره می‌کند که در برابر حملات شکستن رمز Brute-force مقاوم‌تر است که فرمت پیش‌فرض فایل کلید خصوصی است.
+همچنین می‌توانید از ابزار `ssh-agent` برای اجتناب از هر بار رمزعبور وارد کردن رمز عبور استفاده کنید.
 
-حالا، هر کاربر باید کلید عمومی خود را به شما یا هرکسی که مدیریت سرور گیت را بر عهده دارد ارسال کند( با توجه به اینکه شما تنظیمات
-سرور را برپایه SSH انجام دادید پس به این ترتیب نیازمند کلیدهای عمومی است).
-تمام کاری باید همه آن را انجام دهند این است که محتوای فایل `pub.` برای شما ایمیل کنند.
+حالا، هر کاربر باید این کار را انجام دهد و کلید عمومی خود را به شما یا هرکسی که سرور گیت را مدیریت می‌کند ارسال کند (با فرض اینکه شما از سرور SSH استفاده می‌کند که نیازمند کلیدهای عمومی است).
+تمام کاری که آنها باید انجام دهند کپی کردن محتویات فایل `.pub` و ایمیل کردن آن به شما است.
 کلید عمومی چیزی شبیه به این است:
 
 [source,console]
@@ -58,5 +57,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
 NrRFi9wrf+M7Q== [email protected]
 ----
 
-برای آموزش عمیق‌تر درباره ساختن کلید SSH در سیستم‌عامل‌‌های مختلف، به صفحه راهنمای کلید SSH گیت‌هاب
-به آدرس https://help.github.com/articles/generating-ssh-keys[] مراجعه کنید.
+برای آموزش عمیق‌تر درباره ساختن کلید SSH در سیستم‌عامل‌‌های مختلف، به صفحه راهنمای کلیدهای SSH در گیت‌هاب به آدرس https://help.github.com/articles/generating-ssh-keys[] مراجعه کنید.

book/04-git-server/sections/git-daemon.asc

@@ -1,33 +1,30 @@
 === دیمن گیت
 
-(((serving repositories, پروتکل گیت)))
+(((serving repositories, git protocol)))
+در مرحله بعد یک دیمن میزبان مخازن را با پروتکل «گیت» راه خواهیم انداخت.
+این انتخاب رایج برای دسترسی سریع و تصدیق هویت نشده به داده‌های گیتتان است.
+یادتان باشد که از آنجایی که این یک سرویس تصدیق هویت شده نیست، هر چیزی که بر پایه این پروتکل در شبکه میزبانی شود، عمومی است.
 
-حالا با استفاده از پروتگل ‍«Git» می‌خواهیم سرویس‌دهنده دیمن مخازن را نصب و ران‌اندازی کنیم.
-این انتخاب بسیار معمول و سریع است، دسترسی تصدیق هویت نشده به اطلاعات گیت خودتان.
-یادتان باشد که این یک سرویس تصدیق هویت شده نیست، هر کاری بر پایه این پروتکل انجام‌ دهید در شبکه، عمومی است.
+اگر این پروتکل را روی سروری خارج از فایروال خود اجرا می‌کنید، بهتر است فقط برای پروژه‌هایی که به صورت عمومی برای تمام جهان قابل مشاهده است استفاده شود.
+اگر سروری که با آن سروکار دارید درون فایروالتان است، ممکن است از آن برای پروژه‌های که تعداد کثیری از مردم یا کامپیوترها (یکپارچه‌سازی مداوم یا سرورهای ساخت)
+به آن دارند دسترسی فقط-خواندن استفاده کنید، زمانی که نخواهید برای هر کدام یک کلید SSH اضافه کنید.
 
-اگر این پروتکل را خارج از فایروال خود بر روی سرور اجرا کنید، فقط قابل استفاده برای پروژه‌هایی است که به صورت عمومی برای تمام
-جهان قابل مشاهده است.
-اگر سروری که با آن سروکار دارید درون فایروالتان است، احتما شاید از آن برای پروژه‌های که تعداد کثیری از مردم یا کامپیوترها
-فقط دسترسی خواندن به آن دارند استفاده می‌کنید و در زمانی که نخواهید به هر کدام یک کلید SSH دهید.
-
-در هر صورت نصب و راه‌اندازی پروتکل گیت بسیار ساده است.
-اصولا، لازم است تا از این دستور استفاده شود که اسکرپیت در پشت صحنه اجرا شود:(((git commands, daemon)))
+در هر صورت نصب و راه‌اندازی پروتکل گیت نسبتاً آسان است.
+اصولاً، لازم است این دستور را مانند دیمن‌های دیگر (دیمنیزه) اجرا کنید:(((git commands, daemon)))
 
 [source,console]
 ----
 $ git daemon --reuseaddr --base-path=/srv/git/ /srv/git/
 ----
 
-آپشن `reuseaddr--` به سرور امکان دوباره اجرا شدن را می‌دهد؛ بدون اینکه لازم باشد تا اتصالات قدیمی قطع شوند، همچنین آپشن `base-path--`
-به مردم اجازه می‌دهد تا بدون وارد کردن مسیر ورودی پروژه را کلون کنند و مسیر در آخر به دیمن گیت خواهد گفت در کجا به دنبال مخازن برای
-خروجی گرفتن بگردد.
-اگر فایروال دارید، نیازدارید که تا راهی بر روی پرت ۹۴۱۸ باز کنید.
+آپشن `--reuseaddr` به سرور این امکان را می‌دهد که بدون اینکه لازم باشد تا اتصالات قدیمی تایم-اوت دهند ریسارت شود، مادامی که آپشن `--base-path`
+به مردم اجازه می‌دهد تا بدون وارد کردن کامل مسیر ورودی پروژه را کلون کنند و مسیر در آخر به دیمن گیت خواهد گفت در کجا به دنبال مخازن برای خروجی گرفتن بگردد.
+اگر فایروال دارید، مستلزم خواهید بود که تا راهی بر روی پورت ۹۴۱۸ روی آن باز کنید.
 
-با توجه به سیستم‌عاملی که از آن استفاده می‌کنید، شما چندین راه برای برای اجرای این فراید به صورت پشت صحنه یا دیمنایز شده دارید.
+با توجه به سیستم‌عاملی که استفاده می‌کنید، چندین راه برای دیمنیزه کردن این فرآیند دارید.
 
-از آنجایی که `systemd` یکی از معمول ترین سیستم‌ اولیه در بین توزیع‌های مدرن لینوکسی است،‌ می‌توانید از ان برای این کار استفاده کنید.
-به راحتی فایلی را با محتوای زیر در `etc/systemd/systemm/git-daemon.service/` جایگزاری کنید:
+از آنجایی که `systemd` یکی از رایج‌ترین اینیت‌سیستم‌ها بین توزیع‌های مدرن لینوکس است،‌ می‌توانید از آن برای این کار استفاده کنید.
+خیلی ساده، فایلی را با محتویات زیر در `/etc/systemd/systemm/git-daemon.service` قرار دهید:
 
 [source,console]
 ----
@@ -51,19 +48,20 @@ Group=git
 WantedBy=multi-user.target
 ----
 
-شاید لازم باشد توجه داشته باشید که دیمن گیت در همینجا با دستور `git` هم برای کابر و هم گروه کاربر در دسترس است.
+ممکن است متوجه شده باشید که دیمن گیت اینجا با `git`،‌ هم به عنوان گروه و کاربر، شروع شده است.
 آن را با توجه به نیاز خود اصلاح کنید و مطمئن شوید که کاربر نام برده در سیستم وجود دارد.
-همچنین، بررسی کنید تاباینری گیت در مسیر `usr/bin/git/` وجود دارد و اگر لازم است مسیرش را تغییر دهید.
+همچنین، چک کنید که باینری گیت در مسیر `/usr/bin/git` قرار داشته باشد و اگر لازم است مسیرش را تغییر دهید.
 
-در آخر، دستور `systemctl enable git-daemon` را اجرا کنید تا این سرویس به صورت اتوماتیک در موقع بوت سیستم نیز اجرا شود،
-و می‌توانید این سرویس را با دستور `systemctl start git-daemon` و `systemct stop git-daemon` اجرا یا متوقف کنید.
+در آخر، دستور `systemctl enable git-daemon` را اجرا خواهید کرد تا این سرویس به صورت خودکار در موقع بوت سیستم نیز اجرا شود،
+و همچنین می‌توانید این سرویس را، به ترتیب با دستورهای `systemctl start git-daemon` و `systemct stop git-daemon`، شروع یا متوقف کنید.
 
-بعد، باید به گیت بگویید که برای کدام مخازن اجازه دسترسی بدون تصدیق هویت وجود دارد.
-شما می‌توانید این کار را برای هر مخزن با ساخت یک فایل به نام `git-daemon-export-ok` انجام دهید.
+بعد، باید به گیت بگویید که برای کدام مخازن اجازه دسترسی بدون تصدیق هویت وجود داشته باشد.
+می‌توانید این کار را برای هر مخزن با ساخت یک فایل به نام `git-daemon-export-ok` انجام دهید.
 
 [source,console]
 ----
 $ cd /path/to/project.git
 $ touch git-daemon-export-ok
 ----
-حضور آن فایل به گیت می‌گوید که مشکلی برای پذیرش این پروژه بدون تصدیق هویت وجود ندارد.
+
+حضور آن فایل به گیت می‌گوید که میزبانی این پروژه بدون تصدیق هویت مشکلی ندارد.