Merge pull request #2 from progit/chore/06-github-farsi

Chore/06 GitHub farsi

Author: YasinDehfuli

book/06-github/sections/1-setting-up-account.asc

@@ -1,98 +1,102 @@
-=== Account Setup and Configuration
+=== Account Setup and Configuration (ستاپ و کانفیگ کردن اکانت)
 
 (((GitHub, user accounts)))
-The first thing you need to do is set up a free user account.
-Simply visit https://github.com[], choose a user name that isn't already taken, provide an email address and a password, and click the big green ``Sign up for GitHub'' button.
+اولین کاری که باید انجام دهید، ایجاد یک حساب کاربری رایگان است.
+کافی است به نشانی https://github.com[] بروید، یک نام کاربری که قبلاً انتخاب نشده باشد وارد کنید، یک آدرس ایمیل و رمز عبور مشخص کنید و روی دکمه‌ی سبز بزرگ «Sign up for GitHub» کلیک کنید.
 
-.The GitHub sign-up form.
+فرم ثبت نام گیت هاب.
 image::images/signup.png[The GitHub sign-up form.]
 
-The next thing you'll see is the pricing page for upgraded plans, but it's safe to ignore this for now.
-GitHub will send you an email to verify the address you provided.
-Go ahead and do this; it's pretty important (as we'll see later).
+در مرحله‌ی بعد، صفحه‌ی قیمت‌گذاری پلن‌های ارتقاءیافته را مشاهده خواهید کرد، اما فعلاً می‌توانید با خیال راحت آن را نادیده بگیرید.
+گیت‌هاب یک ایمیل برای تأیید آدرسی که وارد کرده‌اید برایتان ارسال می‌کند.
+لطفاً این تأیید را انجام دهید؛ چون این مرحله اهمیت زیادی دارد (که در ادامه خواهیم دید).
 
 [NOTE]
 ====
-GitHub provides almost all of its functionality with free accounts, except some advanced features.
-Additionally, private repositories are limited to 3 collaborators.
+گیت‌هاب تقریباً تمام قابلیت‌های خود را به‌صورت رایگان در اختیار کاربران قرار می‌دهد، به‌جز برخی امکانات پیشرفته.
+همچنین، مخازن خصوصی در حساب‌های رایگان به حداکثر ۳ همکار محدود می‌شوند.
 
-GitHub's paid plans include advanced tools and features as well as increased limits for free services, but we won't be covering those in this book.
-To get more information about available plans and their comparison, visit https://github.com/pricing[].
+پلن‌های پولی گیت‌هاب شامل ابزارها و ویژگی‌های پیشرفته، و همچنین افزایش محدودیت‌ها برای خدمات رایگان هستند، اما ما در این کتاب به آن‌ها نخواهیم پرداخت.
+برای دریافت اطلاعات بیشتر درباره‌ی پلن‌های موجود و مقایسه‌ی آن‌ها، به آدرس https://github.com/pricing[] مراجعه کنید.
 ====
 
-Clicking the Octocat logo at the top-left of the screen will take you to your dashboard page.
-You're now ready to use GitHub.
+با کلیک روی لوگوی Octocat در بالای سمت چپ صفحه، به صفحه داشبورد خود منتقل می‌شوید.
+حالا آماده‌اید تا از GitHub استفاده کنید.
 
-==== SSH Access
+==== SSH Access (دسترسی SSH)
 
 (((SSH keys, with GitHub)))
-As of right now, you're fully able to connect with Git repositories using the `https://` protocol, authenticating with the username and password you just set up.
-However, to simply clone public projects, you don't even need to sign up - the account we just created comes into play when we fork projects and push to our forks a bit later.
+در حال حاضر، شما کاملاً قادر هستید با استفاده از پروتکل `https://` به مخازن Git متصل شوید و با نام کاربری و گذرواژه‌ای که همین حالا تنظیم کرده‌اید، احراز هویت کنید.
+اما برای کلون کردن پروژه‌های عمومی، حتی نیازی به ثبت‌نام هم ندارید — حساب کاربری که همین الان ساختیم زمانی به کار می‌آید که بعداً پروژه‌ها را فورک کنیم و تغییرات را به فورک‌های خود ارسال کنیم.
 
-If you'd like to use SSH remotes, you'll need to configure a public key.
-(If you don't already have one, see <<ch04-git-on-the-server#_generate_ssh_key>>.)
-Open up your account settings using the link at the top-right of the window:
+اگر می‌خواهید از اتصال‌های SSH استفاده کنید، باید یک کلید عمومی تنظیم کنید.
+(اگر هنوز کلیدی ندارید، به بخش <<ch04-git-on-the-server#_generate_ssh_key>> مراجعه کنید.)
+با استفاده از لینک بالای سمت راست پنجره، تنظیمات حساب خود را باز کنید:
 
 .The ``Account settings'' link.
 image::images/account-settings.png[The ``Account settings'' link.]
 
-Then select the ``SSH keys'' section along the left-hand side.
+سپس بخش «SSH keys» را از سمت چپ صفحه انتخاب کنید.
 
 .The ``SSH keys'' link.
 image::images/ssh-keys.png[The ``SSH keys'' link.]
 
-From there, click the "`Add an SSH key`" button, give your key a name, paste the contents of your `~/.ssh/id_rsa.pub` (or whatever you named it) public-key file into the text area, and click ``Add key''.
+از آنجا، روی دکمه "`Add an SSH key`" کلیک کنید، یک نام برای کلید خود وارد کنید، محتوای فایل کلید عمومی `~/.ssh/id_rsa.pub` (یا هر اسمی که برای آن گذاشته‌اید) را در کادر متن قرار دهید و سپس روی «Add key» کلیک کنید.
 
 [NOTE]
 ====
-Be sure to name your SSH key something you can remember.
-You can name each of your keys (e.g. "My Laptop" or "Work Account") so that if you need to revoke a key later, you can easily tell which one you're looking for.
+حتماً برای کلید SSH خود نامی انتخاب کنید که بتوانید به‌راحتی آن را به خاطر بسپارید.
+می‌توانید برای هر یک از کلیدهای خود نامی اختصاص دهید (مثلاً "لپ‌تاپ من" یا "حساب کاری") تا اگر در آینده نیاز داشتید کلیدی را غیرفعال کنید، بتوانید به‌راحتی تشخیص دهید کدام کلید مربوط به کجاست.
 ====
 
 [[_personal_avatar]]
-==== Your Avatar
+==== Your Avatar (آواتار شما)
 
-Next, if you wish, you can replace the avatar that is generated for you with an image of your choosing.
-First go to the ``Profile'' tab (above the SSH Keys tab) and click ``Upload new picture''.
+در مرحله بعد، اگر مایل باشید، می‌توانید تصویر آواتاری که به‌صورت خودکار برایتان ایجاد شده را با تصویری دلخواه جایگزین کنید.
+ابتدا به تب «Profile» (بالای تب SSH Keys) بروید و روی گزینه «Upload new picture» کلیک کنید.
 
 .The ``Profile'' link.
 image::images/your-profile.png[The ``Profile'' link.]
 
-We'll choose a copy of the Git logo that is on our hard drive and then we get a chance to crop it.
+ما یک نسخه از لوگوی Git را که روی هارد دیسک خود داریم انتخاب می‌کنیم و سپس این فرصت را خواهیم داشت که آن را برش (crop) دهیم.
 
 .Crop your avatar
 image::images/avatar-crop.png[Crop your uploaded avatar.]
 
-Now anywhere you interact on the site, people will see your avatar next to your username.
+اکنون در هر جایی از سایت که فعالیت داشته باشید، دیگران تصویر آواتار شما را در کنار نام کاربری‌تان خواهند دید.
 
-If you happen to have uploaded an avatar to the popular Gravatar service (often used for Wordpress accounts), that avatar will be used by default and you don't need to do this step.
+اگر قبلاً در سرویس محبوب Gravatar (که اغلب برای حساب‌های Wordpress استفاده می‌شود) یک آواتار بارگذاری کرده‌اید، همان تصویر به‌صورت پیش‌فرض استفاده خواهد شد و نیازی به انجام این مرحله ندارید.
 
-==== Your Email Addresses
+==== Your Email Addresses (آدرس ایمیل های  شما)
 
-The way that GitHub maps your Git commits to your user is by email address.
-If you use multiple email addresses in your commits and you want GitHub to link them up properly, you need to add all the email addresses you have used to the Emails section of the admin section.
+GitHub از طریق آدرس ایمیل، کامیت‌های Git شما را به حساب کاربری‌تان نسبت می‌دهد.
+اگر در کامیت‌های خود از چندین آدرس ایمیل مختلف استفاده می‌کنید و می‌خواهید GitHub آن‌ها را به‌درستی به هم متصل کند، باید تمام آدرس‌های ایمیلی را که استفاده کرده‌اید، در بخش Emails از قسمت تنظیمات حساب (admin section) اضافه کنید.
 
 [[_add_email_addresses]]
 .Add email addresses
 image::images/email-settings.png[Add all your email addresses.]
 
-In <<_add_email_addresses>> we can see some of the different states that are possible.
-The top address is verified and set as the primary address, meaning that is where you'll get any notifications and receipts.
-The second address is verified and so can be set as the primary if you wish to switch them.
-The final address is unverified, meaning that you can't make it your primary address.
-If GitHub sees any of these in commit messages in any repository on the site, it will be linked to your user now.
+در بخش <<_add_email_addresses>> می‌توانیم برخی از حالت‌های مختلف مربوط به آدرس‌های ایمیل را ببینیم:
 
-==== Two Factor Authentication
+آدرس بالایی، تأیید شده و به‌عنوان آدرس اصلی (Primary) تنظیم شده است؛ یعنی اعلان‌ها و رسیدها به این آدرس ارسال می‌شوند.
+آدرس دوم نیز تأیید شده و در صورت تمایل می‌توانید آن را به‌عنوان آدرس اصلی انتخاب کنید.
+آدرس آخر تأیید نشده است، بنابراین نمی‌توانید آن را به‌عنوان آدرس اصلی تنظیم کنید.
 
-Finally, for extra security, you should definitely set up Two-factor Authentication or ``2FA''.
-Two-factor Authentication is an authentication mechanism that is becoming more and more popular recently to mitigate the risk of your account being compromised if your password is stolen somehow.
-Turning it on will make GitHub ask you for two different methods of authentication, so that if one of them is compromised, an attacker will not be able to access your account.
+اگر GitHub یکی از این آدرس‌ها را در پیام‌های کامیت در هر مخزنی در سایت مشاهده کند، آن را به حساب کاربری شما لینک خواهد کرد.
 
-You can find the Two-factor Authentication setup under the Security tab of your Account settings.
+==== Two Factor Authentication (تایید دو مرحله ای)
+
+در نهایت، برای افزایش امنیت، حتماً باید احراز هویت دو مرحله‌ای یا همان «2FA» را فعال کنید.
+احراز هویت دو مرحله‌ای یک مکانیزم امنیتی است که این روزها بسیار رایج شده و به کاهش ریسک دسترسی غیرمجاز به حساب شما در صورت دزدیده شدن رمز عبور کمک می‌کند.
+با فعال کردن این قابلیت، GitHub هنگام ورود از شما دو روش مختلف برای احراز هویت درخواست می‌کند، بنابراین اگر یکی از آن‌ها به خطر بیفتد، مهاجم همچنان نمی‌تواند به حساب شما دسترسی پیدا کند.
+
+برای تنظیم احراز هویت دو مرحله‌ای، به تب «Security» در بخش تنظیمات حساب کاربری خود بروید.
 
 .2FA in the Security Tab
 image::images/2fa-1.png[2FA in the Security Tab]
 
-If you click on the ``Set up two-factor authentication'' button, it will take you to a configuration page where you can choose to use a phone app to generate your secondary code (a ``time based one-time password''), or you can have GitHub send you a code via SMS each time you need to log in.
+اگر روی دکمه «Set up two-factor authentication» کلیک کنید، به صفحه‌ای هدایت می‌شوید که در آن می‌توانید روش دلخواه خود را برای دریافت کد دومرحله‌ای انتخاب کنید:
+یا از یک اپلیکیشن موبایل برای تولید کد ثانویه استفاده کنید (کدی یک‌بارمصرف و مبتنی بر زمان)،
+یا این‌که GitHub هر بار هنگام ورود، یک کد از طریق پیامک (SMS) برایتان ارسال کند.
 
-After you choose which method you prefer and follow the instructions for setting up 2FA, your account will then be a little more secure and you will have to provide a code in addition to your password whenever you log into GitHub.
+پس از انتخاب روش مورد نظر و انجام مراحل راه‌اندازی 2FA طبق دستورالعمل‌ها، حساب شما کمی امن‌تر خواهد شد و از این پس باید هنگام ورود به GitHub، علاوه بر رمز عبور، آن کد امنیتی را نیز وارد کنید.