Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Arabic version with some fixed links #169

Open
wants to merge 2 commits into
base: gh-pages
Choose a base branch
from
Open

Arabic version with some fixed links #169

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c826d77
Arabic version with some fixed links
Jun 21, 2019
1000908
Adding english language link, translating cheat sheet
MohammadKhashashneh Jul 5, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions css/style.css
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
@import url('https://fonts.googleapis.com/css?family=El+Messiri&display=swap');

body {
background: #FFF;
font-family: Georgia, Times New Roman, Times, serif;
Expand All @@ -11,7 +13,7 @@ h1 {
font-size: 60px;
font-weight: normal;
margin: 0;
font-family: 'Chelsea Market', Georgia, serif;
font-family: 'Chelsea Market', 'El Messiri', Georgia, serif;
color: #000;
line-height: 1;
}
Expand All @@ -21,7 +23,7 @@ h2 {
font-weight: normal;
margin: 0;
color: #FFB000;
font-family: 'Chelsea Market', Georgia, serif;
font-family: 'Chelsea Market', 'El Messiri', Georgia, serif;
text-transform: lowercase;
}

Expand Down
Binary file added files/git_cheat_sheet.ar.pdf
View file
Open in desktop
Binary file not shown.
Binary file added img/branches-ar.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/trees-ar.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
273 changes: 273 additions & 0 deletions index.ar.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,273 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>جت (git) - الدليل المبسط - من دون تعقيد</title>
<link href='http://fonts.googleapis.com/css?family=Chelsea+Market' rel='stylesheet' type='text/css'>
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/normalize/0/normalize.min.css" type="text/css">
<link rel="stylesheet" href="css/style.css" type="text/css">
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-652147-13']);
_gaq.push(['_trackPageview']);

(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();

function recordOutboundLink(link, category, action) {
_gat._getTrackerByName()._trackEvent(category, action);
setTimeout('document.location = "' + link.href + '"', 100);
}
</script>
</head>
<body>
<div class="scrollblock block-title">
<h1>جت <bdi>(git)</bdi> الدليل المبسط - من دون تعقيد</h1>
<p>:) فقط، دليل بسيط لتعلم كيفية استخدام اداة ال<bdi>git</bdi> بسرعة و من دون تفاصيل</p>
<a href="https://twitter.com/share" class="twitter-share-button" data-via="rogerdudler" data-size="large" data-url="http://rogerdudler.github.com/git-guide" data-related="rogerdudler" data-hashtags="git">Tweet</a>
<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
<p class="meta">
<a href="http://www.twitter.com/rogerdudler">Roger Dudler</a> تأليف
<br /><a href="http://www.twitter.com/tfnico">@tfnico</a> و <a href="http://www.twitter.com/fhd">@fhd</a>, <a href="http://www.namics.com">Namics</a> بمساهمة من
<br><a href="https://twitter.com/rasmi_mohammad">Mohmmad Rasmi Khashashneh</a> ترجمة<br>

:هذا الدليل متوفر باللغات التالية<br>
<a href="index.de.html">english</a>,
<a href="index.de.html">deutsch</a>,
<a href="index.es.html">español</a>,
<a href="index.fr.html">français</a>,
<a href="index.id.html">indonesian</a>,
<a href="index.it.html">italiano</a>,
<a href="index.nl.html">nederlands</a>,
<a href="index.pl.html">polski</a>,
<a href="index.pt_BR.html">português</a>,
<a href="index.ru.html">русский</a>,
<a href="index.tr.html">türkçe</a>,
<br/>
<a href="index.my.html">မြန်မာ</a>,
<a href="index.ja.html">日本語</a>,
<a href="index.zh.html">中文</a>,
<a href="index.ko.html">한국어</a>
<a href="index.vi.html">Vietnamese</a>
<br />
<a href="https://github.com/rogerdudler/git-guide/issues">github</a> الرجاء الابلاغ عن المشاكل على
</p>
<script async type="text/javascript" src="//cdn.carbonads.com/carbon.js?zoneid=1673&serve=C6AILKT&placement=gitguide" id="_carbonads_js"></script>
<img src="img/arrow.png" alt="" />
</div>
<!-- setup -->
<a name="setup"></a>
<div class="scrollblock block-setup">
<h2>التثبيت</h2>
<p>
<a href="https://git-scm.com/download/mac">تحميل جت على نظام <bdi>(OSX)</bdi> الماك أو إس</a>
</p>
<p>
<a href="https://git-scm.com/download/win">تحميل جت على نظام <bdi>(WINDOWS)</bdi> الويندوز</a>
</p>
<p>
<a href="https://git-scm.com/download/linux">تحميل جت على نظام <bdi>(LINUX)</bdi> اللينوكس</a>
</p>
</div>
<a name="create"></a>
<div class="scrollblock block-create">
<h2>انشاء مستودع <bdi>(repository)</bdi> جديد</h2>
<p>
انشاء وفتح مجلد <bdi>(Directory)</bdi> جديد ومن ثم القيام بالاجراء <br />
<code>git init</code><br />
لعمل مستودع جت جديد
</p>
</div>
<a name="checkout"></a>
<div class="scrollblock block-checkout">
<h2>استنساخ <bdi>(clone)</bdi> مستودع</h2>
<p>
استخدام الامر التالي لانشاء نسخة للعمل <bdi>(working copy)</bdi> من مستودع موجود على الجهاز (اي محلي)<br />
<code>git clone /path/to/repository</code><br />
او الامر التالي في حال الاستنساخ عن بعد <bdi>(remotely)</bdi> من خادم<br />
<code>git clone username@host:/path/to/repository</code>
</p>
</div>
<a name="trees"></a>
<div class="scrollblock block-trees">
<h2>طريقة سير العمل</h2>
<p>
يتكون المستودع المحلي من ثلاث "شجرات" يتم التعامل معها كلها عن طريق جت,
الاولى و تدعى بمجلد العمل <code><bdi>Working Directory</bdi></code> و هي تحوي الملفات الفعليةاللتي يتم العمل عليها,
و الثانية تدعى بالفهرس <code><bdi>Index</bdi></code> و هي تقوم باحتواء الملفات المعدلة و المدرجة للتغيير,
واخيرا الرأس <code><bdi>HEAD</bdi></code> وهو مؤشر على أخر التغييرات اللتي تم القيام بها
</p>
<img src="img/trees-ar.png" alt="" />
</div>
<a name="add"></a>
<div class="scrollblock block-add">
<h2>الاضافة <bdi>(add)</bdi> و التغيير <bdi>(commit)</bdi> على الملفات</h2>
<p>
يمكن اقتراح التغييرات (اضافتها و ادراجها ضمن <b>الفهرس</b>) باستخدام<br />
<code>git add &lt;filename&gt;</code><br />
<code>git add *</code><br />
و تعتبر هذه اولى الخطوات في طريقة سير العمل الاساسية للجت. ولاكن لإجراء التغيير فعلا فإنه يتم استخدام الامر التالي<br />
<code>git commit -m "Commit message"</code><br />
الان وفي هذه الحالة, فقد تم اجراء التغييرات فعلا و سيكون <b>الرأس</b> مؤشرا عليها, لاكنها ليست مصدرة الى المستودع الخارجي <bdi>(the remote repository)</bdi> بعد
</p>
</div>
<a name="push"></a>
<div class="scrollblock block-remote">
<h2>دفع <bdi>(push)</bdi> التغييرات</h2>
<p>
جميع التعديلات اللتي تمت على النسخة المحلية محفوظة و مؤشر عليها عن طريق <b>الرأس</b>. ولارسال هذه التغييرات للمستودع الخارجي يتم استخدام الامر التالي<br />
<code>git push origin master</code><br />
الرجاء تعديل كلمة <bdi><i>master</i></bdi> لأي اسم فرع بديل تريدون دفع التغييرات اليه<br /><br />
اذا لم تقومو باستنساخ مستودع خارجي موجود من قبل, و اردتم ربط مستودعكم المحلي مع آخر خارجي, فعليكم اضافته عن طريق مايلي<br />
<code>git remote add origin &lt;server&gt;</code><br />
الآن يمكنكم الدفع بالتغييرات للمستودع الخارجي اللذي اضفتموه بالخطوة السابقة<br />

</p>
</div>
<a name="branching"></a>
<div class="scrollblock block-branching">
<h2>التفرع <bdi>(branching)</bdi></h2>
<p>
يتم استخدام الفروع لتطوير خصائص و ميزات المشروع بمعزل تام عن باقي الافرع الاخرى. إذ يعتبر الفرع الرئيسي و اللذي يدعى بال<bdi><i>master</i></bdi> هو الفرع الاساسي واللذي يتم عمله تلقائيا عند انشاء المستودع في المرة الاولى, لذا عليكم عمل فروع جديدة من الفرع الرئيسي واستخدامها للتطوير واخير دمجها مجددا مع الفرع الرئيسي حال الإنتهاء منها
</p>
<img src="img/branches-ar.png" alt="" />
<p>
لعمل فرع جديد تحت اسم <bdi>"feature_x"</bdi> و من ثم التحويل اليه <br />
<code>git checkout -b feature_x</code><br />
للعودة مجددا للفرع الرئيسي<br />
<code>git checkout master</code><br />
و للتخلص من الفرع اذا لم يعد له حاجة<br />
<code>git branch -d feature_x</code><br />
لن تكون الفروع متوفرة للآخرين تلقائيا إلا في حال قمتم بالدفع بها للمستودع الخارجي عن قصد<br />
<code>git push origin &lt;branch&gt;</code>
</p>
</div>
<a name="update"></a>
<div class="scrollblock block-merging">
<h2>التحديث (<bdi>updating</bdi>) و الدمج من فروع اخرى (<bdi>merging</bdi>)</h2>
<p>
لتحديث المستودع المحلي ليتوافق مع آخر التغييرات استخدموا الامر<br />
<code>git pull</code><br />
على نسختكم المحلية لاستدعاء (<bdi><i>fetch</i></bdi>) و دمج (<bdi><i>merge</i></bdi>) التعديلات القادمة من المستودع الخارجي<br />
للدمج من فرع آخر قادم مع الفرع الفعال الحالي (الماستر مثلا) عليكم استخدام<br />
<code>git merge &lt;branch&gt;</code><br />
في كلا الحالتين سيحاول جت الدمج تلقائيا ما بين الفرع القادم و الفرع الفعال المحلي, إلا انه و للأسف قد لا يكون ذلك ممكنا خاصة في حال وجود تغييرات على نفس الاسطر من كلا الطرفين, مما يسبب بما يسما بالتعارض (<bdi><i>conflict</i></bdi>)
وفي هذه الحالات يكمن معالجة هذه التعارضات على عاتق المطور. و يكون ذلك يدويا من خلال تعديل السطور للحالة الصحيحة و من ثم دمجها عن طريق الامر<br />
<code>git add &lt;filename&gt;</code><br />
يمكنم معاينة التعديلات قبل دمجها عن طريق الامر<br />
<code>git diff &lt;source_branch&gt; &lt;target_branch&gt;</code>
</p>
</div>
<a name="tagging"></a>
<div class="scrollblock block-tagging">
<h2>وسم (<bdi>tagging</bdi>) التغييرات</h2>
<p>
ننصحكم بتعليم اصدارات برامجكم عن طريق وسمها بأسام مميزة. وتعتبر هذه ممارسة جيدة, كوسم الاصدارات بأسماء مثل (<i>1.0.0</i>), و يتم ذلك عن طريق الامر<br />
<code>git tag 1.0.0 1b2e1d63ff</code><br />
المعني ب<bdi><i>1b2e1d63ff</i></bdi> هي اول 10 رموز من رقم (<bdi>commit id</bdi>) التغيير المراد وسمه<br />
يمكنكم التعرف غلى رقم التغييرات عن طريق القسم التالي
</p>
</div>
<a name="log"></a>
<div class="scrollblock block-log">
<h2>سجل (<bdi>log</bdi>) التغييرات</h2>
<p>
يمكنكم عرض و تأريخ سجل التغييرات لدراستها عن طريق<br>
<code>git log</code><br />
و يمكنكم اضافة العديد من عوامل التغيير (<bdi><i>parameters</i></bdi>) لذلك الامر لجعل عرض السجل اكثر تحديدا كعرض جميع التغييرات اللتي قام احدهم بكتابتها مثلا<br />
<code>git log --author=bob</code><br />
او لعرض سجل مختصر بحيث يكون كل سطر عبارة عن تغيير واحد<br />
<code>git log --pretty=oneline</code><br />
او قد تريدون عرض سجلات جميع الفروع بطريقة مزخرفة و منسقة و ايضا عرض اسامي الاوسمة المتوفرة عليها<br />
<code>git log --graph --oneline --decorate --all</code><br />
او اذا اردتم الاكتفاء بعرض اسماء الملفات المعدلة فقط<br />
<code>git log --name-status</code><br />
هذه تعتبر عينة فقط مما هو متوفر من عوامل التغيير لهذا الامر. لمعرفة المزيد, الرجاء الاطلاع على<br>
<code>git log --help</code><br />
</p>
</div>
<a name="checkout-replace"></a>
<div class="scrollblock block-checkout-replace">
<h2>اعادة تغيير التعديلات المحلية</h2>
<p>
في بعض (او الكثير) من الاحيان قد تكونوا قد اخطأتم في تعديلات احدى الملفات و تريدون التراجع عنها, يمكنك ذلك عن طريق استبدال التعديلات المحلية باستخدام الامر التالي<br />
<code>git checkout -- &lt;filename&gt;</code><br />
يقوم هذا الامر باستبدال التعديلات المحلية للملف بآخر نسخة محفوظة في المستودع و مشار عليها من قبل الرأس.
بالطبع التعديلات المضافة للفهرس او الملفات الجديدة و الغير خاضعة لمراقبة جت ستبفى و لن يتم العبث بها
</p>
<p>
وفي المقابل, ان اردتم الاستغناء عن جميع التعديلات المحلية لكل الملفات, فبإمكانكم استدعاء آخر التغييرات المضافة للمستودع المحلي او الخارجي. و من ثم اعادة توجيه رأس الفرع الحالي لآخر تغيير كما هو موضح ادناه<br />
<code>git fetch origin</code><br />
<code>git reset --hard origin/master</code>
</p>
</div>
<a name="hints"></a>
<div class="scrollblock block-hints">
<h2>بعض الاوامر و الحيل المفيدة</h2>
<p>
تطبيقات جت مدمجة مع واجهة رسومية (<bdi>GUI</bdi>) ان كنتم تفضلون ذلك<br />
<code>git-gui</code><br />
<code>gitk</code><br />
تلوين مخرجات الاوامر المختلفة<br />
<code>git config color.ui true</code><br />
اظهار السجل بشكل سطر واحد لكل تغيير<br />
<code>git config format.pretty oneline</code><br />
اضافة الملفات للفهرس بشكل تفاعلي<br />
<code>git add -i</code>
</p>
</div>
<a name="resources"></a>
<div class="scrollblock block-resources">
<h2>روابط و مراجع اخرى</h2>
<h3> واجهات امامية رسومية</h3>
<p>
<ul>
<li><a href="https://github.com/pieter/gitx/wiki">GitX (L) (OSX, open source)</a></li>
<li><a href="http://www.git-tower.com/">Tower (OSX)</a></li>
<li><a href="http://www.sourcetreeapp.com/">Source Tree (OSX & Windows, free)</a></li>
<li><a href="http://mac.github.com/">GitHub for Mac (OSX, free)</a></li>
<li><a href="https://itunes.apple.com/gb/app/gitbox/id403388357?mt=12">GitBox (OSX, App Store)</a></li>
</ul>
</p>
<h3>المراجع</h3>
<p>
<ul>
<li><a href="https://git-scm.com/book/en/v2">Pro Git</a></li>
<li><a href="http://think-like-a-git.net/">Think like a git</a></li>
<li><a href="http://help.github.com/">GitHub Help</a></li>
<li><a href="http://marklodato.github.com/visual-git-guide/index-en.html">A Visual Git Guide</a></li>
</ul>
</p>
<h3>للمساعدة</h3>
<p>
<ul>
<li><a href="http://groups.google.com/group/git-users/">Git User Mailing List</a></li>
<li><a href="http://jk.gs/git/">#git on irc.freenode.net</a></li>
</ul>
</p>
</div>
<a name="comments"></a>
<div class="scrollblock block-comments">
<h2>التعليقات</h2>
<div id="disqus_thread"></div>
<script type="text/javascript">
/* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
var disqus_shortname = 'git-the-simple-guide'; // required: replace example with your forum shortname

/* * * DON'T EDIT BELOW THIS LINE * * */
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
</div>
<a href="http://www.git-tower.com/?source=rd" onClick="recordOutboundLink(this, 'Outbound Links', 'git-tower.com');return false;" class="tower"></a>
<a href="files/git_cheat_sheet.ar.pdf" onClick="recordOutboundLink(this, 'Cheat Sheet', 'git-guide');return false;" class="cheatsheet"></a>
</body>
</html>
1 change: 1 addition & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ <h1>git - the simple guide</h1>
<a href="index.zh.html">中文</a>,
<a href="index.ko.html">한국어</a>
<a href="index.vi.html">Vietnamese</a>
<a href="index.ar.html">العربية</a>
<br />
please report issues on <a href="https://github.com/rogerdudler/git-guide/issues">github</a>
</p>
Expand Down