first commit in doc

CVS version numbers

persian/doc/Makefile: INITIAL -> 1.1 
persian/doc/index.wml: INITIAL -> 1.1

2 files changed, 228 insertions, 0 deletions

diff --git a/persian/doc/Makefile b/persian/doc/Makefile
new file mode 100644
index 00000000000..7a03a720bf2
--- /dev/null
+++ b/persian/doc/Makefile
@@ -0,0 +1 @@
+include $(subst webwml/persian,webwml/english,$(CURDIR))/Makefile
diff --git a/persian/doc/index.wml b/persian/doc/index.wml
new file mode 100644
index 00000000000..176523dc313
--- /dev/null
+++ b/persian/doc/index.wml
@@ -0,0 +1,227 @@
+#use wml::debian::template title="مستندسازی"
+#use wml::debian::translation-check translation="1.92" maintainer="Mohammad Rafiee"
+
+<p>یک بخش مهم از هر سیستم‌عاملی مستندسازی است
+، راهنماهای فنی که نحوه عملکرد و استفاده از نرم‌افزارها را تشریح می‌کند.
+به عنوان بخشی از تجربه‌ٔ ایجاد یک سیستم‌عامل آزاد باکیفیت، 
+پروژه دبیان حداکثر تلاش خود را می‌کند تا کلیه کاربران و درگیران در پروژه به خوبی
+فعالیتها را مستندسازی کرده و به راحتی در دسترس قرار دهند.</p>
+
+<h2>شروع ضربتی</h2>
+
+<p>در صورتی که <em>کاربر جدید<em>  پروژه دبیان هستید به شما پیشنهاد میکنم از موارد زیر شروع به مطالعه نمایید :</p>
+
+<ul>
+  <li><a href="$(HOME)/releases/stable/installmanual">راهنمای نصب</a></li>
+  <li><a href="manuals/debian-faq/">پرسش‌های رایج گنو/لینوکس دبیان</a></li>
+</ul>
+
+<p>با در دست داشتن اینها شما هنگامی که برای اولین بار دبیان را نصب می‌کنید 
+پاسخ سولات زیادی را خواهید یافت و در کاربرد سیستم جدید دبیان به شما کمک‌های شایانی خواهد شد.
+. بعدها شاید بخواهید پیشتر روید :</p>
+
+<ul>
+  <li><a href="manuals/debian-reference/">مرجع دبیان</a></li>
+  <li><a href="$(HOME)/releases/stable/releasenotes">نکات انتشار</a>،
+      برای افرادی که به دنبال بروز رسانی هستند</li>
+  <li><a href="http://wiki.debian.org/">ویکی‌ دبیان </a>، منبع خوبی از
+      اطلاعات برای تازه واردهاست</li>
+</ul>
+
+
+<p>در نهایت، مطمئن شوید که  <a href="http://tangosoft.com/refcard/">مرجع گنو/لینوکس</a>
+را که شامل مهمترین دستورات سیستم عامل دبیان است را چاپ کرده و در دست دارید .</p>
+
+<p>در صورتی که می‌خواهید در ایجاد بسته‌های نرم‌افزاری دبیان مشارکت نمایید ما  لینکهای زیر را معرفی می‌کنیم :</p>
+
+<ul>
+  <li><a href="manuals/maint-guide/">راهنمای نگهدارندگان جدید دبیان</a></li>
+  <li><a href="manuals/developers-reference/">مرجع توسعه دهندگان دبیان</a></li>
+</ul>
+
+<p>یکسری مستندات مفید دیگر نیز در این قسمت لیست شده است</p>
+
+<h2>انواع مستندات</h2>
+
+<p>اکثر مستنداتی که پروژه دبیان مورد استفاده قرار گرفته است در حقیقت برای گنو/لینوکس تدوین گردیده است.
+همچنین برخی مستندات وجود دارند که به صورت اختصاصی برای دبیان تولید گردیده‌اند
+این مستندات در دسته‌های کلی زیر عنوان می‌گردند :</p>
+
+<ul>
+  <li><a href="#manuals">راهنما‌ها</a></li>
+  <li><a href="#howtos">چگونگی‌ها</a></li>
+  <li><a href="#faqs">پرسش‌های رایج</a></li>
+  <li><a href="#other">مستندات کوتاهتر دیگر</a></li>
+</ul>
+
+<h3 id="manuals">راهنماها</h3>
+
+<p>راهنماها از حیص اینکه به تشریح موضوعات کلی و شکافتن آنها می‌پردازند، شبیه کتابها می‌باشند.</p>
+
+<h3>راهنماهای اختصاصی شده برای دبیان</h3>
+
+  <div id="lefthalfcol">
+    
+    <h4>راهنمای کاربران</h4>
+    <ul>
+      <li><a href="user-manuals#faq">پرسش‌های رایج در مورد گنو/لینوکس دبیان</a></li>
+      <li><a href="user-manuals#install">راهنمای نصب دبیان</a></li>
+      <li><a href="user-manuals#relnotes">نکات انتشار دبیان</a></li>
+      <li><a href="user-manuals#quick-reference">مرجع دبیان</a></li>
+      <li><a href="user-manuals#securing">راهنمای ایمنی در دبیان</a></li>
+      <li><a href="user-manuals#java-faq">پرسش‌های رایج در مورد گنو/لینوکس دبیان و جاوا</a></li>
+    </ul>
+
+  </div>
+
+  <div id="righthalfcol">
+
+    <h4>راهنماهای توسعه ‌دهندگان</h4>
+    <ul>
+      <li><a href="devel-manuals#policy">راهنمای سیاست دبیان</a></li>
+      <li><a href="devel-manuals#devref">مرجع توسعه دهندگان دبیان</a></li>
+      <li><a href="devel-manuals#maint-guide">راهنمای نگهدارندگان جدید دبیان</a></li>
+      <li><a href="devel-manuals#menu">سیستم منوی دبیان</a></li>
+      <li><a href="devel-manuals#i18n"> معرفی بین المللی سازی یا i18n</a></li>
+    </ul>
+    
+    <h4>راهنماهای گوناگون</h4>
+    <ul>
+      <li><a href="misc-manuals#history">تاریخچه پروژه دبیان</a></li>
+      <li><a href="misc-manuals#markup">Debiandoc-SGML راهنمای نشانه‌گذاری شده</a></li>
+      <li><a href="misc-manuals#sgml-howto">دبیان SGML/XML چگونگی</a></li>
+    </ul>
+
+  </div>
+
+
+<p class="clr">لیست کامل راهنماها و مستندات مربوط به دبیان را میتوانید
+درصفحات <a href="ddp">مستندات پروژه دبیان</a> بیابید.</p>
+
+<p>همچنین راهنماهی متعددی وجود دارند که توسط کاربران برای گنو/لینوکس دبیان نوشته شده‌اند،
+ و در قسمت <a href="books">کتابهای چاپ شده</a> موجودند.</p>
+
+<h3>راهنماهای عمومی گنو/لینوکس</h3>
+
+<p>اکثر مستندات و راهنماهای محبوب و پر کاربرد لینوکس 
+<a href="http://www.tldp.org/LDP/gs/gs.html">نصب لینوکس وشروع کار </a>، 
+<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/">\
+راهنمای کاربران لینوکس</a>، 
+<a href="http://www.tldp.org/LDP/nag/nag.html">راهنمای مدیران شبکه</a>، 
+<a href="http://www.tldp.org/LDP/sag/">راهنمای کاربران سیستمی</a> و موارد دیگر می‌باشد.</p>
+
+<p>مستندات لینوکس با مستندات LDP ‌هماهنگ است
+LDP همان <a href="http://www.tldp.org/">پروژه مستندات لینوکس است</a>.
+شما میتوانید یک سری کامل از راهنماهای LDP را در 
+<a href="http://www.tldp.org/guides.html">صفحات وب آنها </a> بیابید، 
+این مستندات هم به شکل چاپ شده و هم الکترونیکی موجودند.</p>
+
+<h3 id="howtos">چگونگی‌ها</h3>
+
+<p><a href="http://www.tldp.org/docs.html#howto">مستندات چگونگی‌ها</a>،
+همانگونه که از نامش پیداست، <em>چگونگی</em>انجام کار را تشریح کی‌کند،
+ و اینگونه مستندات معمولا بر روی موضوع خاص‌تر تمرکز دارند .</p>
+
+<p>برخی از مهمترین مستندات چگونگی در لینوکس عبارت است از :</p>
+
+<ul>
+  <li><a href="http://www.tldp.org/HOWTO/Hardware-HOWTO/">چگونگی سازگاری سخت‌افزارها</a>،</li>
+  <li><a href="http://www.tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/">\
+      اصول و چارچوب چگونگی یونیکس و اینترنت</a>،</li>
+# currently not available
+#  <li><a href="http://www.tldp.org/HOWTO/Kernel-HOWTO.html">چگونگی کرنل</a>،</li>
+  <li><a href="http://www.tldp.org/HOWTO/Filesystems-HOWTO.html">چگونگی سیستم مدیریت فایل</a>،</li>
+  <li><a href="http://www.tldp.org/HOWTO/Config-HOWTO.html">چگونگی تنظیمات</a>،</li>
+  <li><a href="http://www.tldp.org/HOWTO/Net-HOWTO/">چگونگی کارکرد شبکه</a>،</li>
+  <li>و <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html">بسیاری دیگر</a>.</li>
+</ul>
+
+<p>آنها حتی جهت نصب بر روی رایانه شما نیز آماده می‌باشند می‌توانید آنها را در بسته‌های
+<a href="http://packages.debian.org/stable/doc/doc-linux-text">\doc-linux-text</a> و
+<a href="http://packages.debian.org/stable/doc/doc-linux-html">\doc-linux-html</a> بیابید.</p>
+
+# TODO: make a note about the translated doc-linux-* packages...
+
+
+<h3 id="faqs">پرسش‌های رایج</h3>
+
+<p>FAQ مخفف <em>Frequently Asked Questions</em>. پرسش‌های رایج مجموعه‌ای از پاسخ به سوالات مطرح شده 
+می‌باشد.</p>
+
+<p>مستند <a href="http://www.tldp.org/FAQ/Linux-FAQ/">پرسش‌های رایج لینوکس </a>
+ .شامل طلاعات عمومی حول حوزه لینوکس است</p>
+ 
+<p>سوالاتی که  به صورت ویژه در مورد دبیان مطرح می گردند معمولا در قسمت 
+<a href="FAQ/">پرسش‌های رایج دبیان</a> پاسخ داده شده‌اند .
+همچنین یک بخش مجزای دیگری تحت عنوان <a href="../CD/faq/">پرسش‌های رایج در مورد فایلهای سی‌دی و دی‌وی‌دی دبیان</a>
+نیز وجود دارد .</p>
+
+<p>لطفا به  <a href="http://www.tldp.org/FAQ/">پرسش‌های رایج LDP</a>
+جهت اطلاع بیشتر نگاهی بیاندازید</p>
+
+
+
+<h3 id="other">دیگر، مستندات کوتاهتر</h3>
+
+<p>اینگونه مستندات شامل دستورالعملهای سریعتر و کوتاهتری می‌شوند :</p>
+
+<dl>
+
+  <dt><strong><a href="http://www.tldp.org/docs.html#man">صفحات راهنماها</a></strong></dt>
+    <dd>به صورت سنتی کلیه‌ی برنامه‌های بونیکس دارای 
+		<em>صفحات راهنما</em> می‌باشد، این راهنماها با استفاده از دستور <tt>man</tt>
+		در دسترس کاربران قرار می‌گیرد. این راهنماها معمولا برای تازه‌ کارها بدون معنی است.
+		شما می‌توانید صفحات وب موجود در رابطه با راهنماهای دبیان را مطالعه نمایید این مستندات در لینک 
+		You can search for and read the manual pages available in Debian
+	    <a href="http://manpages.debian.net/cgi-bin/man.cgi">http://manpages.debian.net/</a> موجود می‌باشند.
+    </dd>
+
+  <dt><strong><a href="http://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html"> فایل‌های info</a></strong></dt>
+    <dd>بسیاری از نرم‌افزارهای گنو از طریق <em>فایل‌های info</em>
+	به جای صفحات راهنما مستند سازی شده‌اند. 
+	این فایلها شامل اطلاعات کاملی از خود نرم‌افزار، گزینه‌ها و نمونه‌های استفاده می‌باشند که
+	از طریق دستور <tt>info</tt>
+    در دسترس قرار می‌گیرند .
+    </dd>
+
+  <dt><strong>فایل‌های متنوع README</strong></dt>
+    <dd>فایلهای <em>مرا بخوانید</em> خیلی رایجند &mdash; آنها به صورت متن ساده می‌باشند
+        که یک موضوع را که معمولا هم یک بسته نرم‌افزاری است تشریح می‌کند.
+		شما می‌توانید بسیاری از این فایل‌ها را در <tt>/usr/share/doc/</tt> و زیر پوشه‌های دبیان بیابید.
+		هربسته نرم‌افزاری  یک پوشه شامل فایل‌های مرا بخوانید خود دارد
+		که ممکن است شامل نمونه‌هایی از تغییرات نیز می‌باشد .
+		توجه کنید که برای برنامه‌های بزرگتر مستندات ممولا در بسته‌های مجزایی گردآوری می‌شوند
+		(تحت همان عنوانی که نام بسته دارد با این تفاوت که در انتهای نام آن عبارت <em>-doc</em> آورده می‌شود .)
+    </dd>
+
+  <dt><strong>کارتهای مرجع برای دسترسی سریع</strong></dt>
+    <dd>
+        <p>کارتهای مرجع سریع مختصری در مورد اصل سیستم می‌باشند .
+		معمولا، این کارتهای مرجع دستوراتی را که عموما 
+		مورد استفاده قرار می‌گیرند را بر روی یک کاغذ شامل می‌شود.
+        برخی از دسته کارتها و مجموعه‌ها شامل  موراد زیر می‌گردند :</p>
+        <dl>
+          <dt><a href="http://tangosoft.com/refcard/">کارت مرجع گنو/لینوکس دبیان</a></dt>
+	    <dd>این کارت ، که میتواند بر روی یک صفحه معمولی چاپ گردد ،
+		لیستی از مهمترین دستورات را به کاربران ارائه می‌کند
+		و مرجع خوبی برای کاربران جدید دبیان است که می‌خواهند با این مفاهیم آشنا گردند.
+		در نهایت دانش پایه‌ای در رابطه با کامپیوتر ، فایل‌ها
+		شاخه‌ها و خط فرمان نیاز می‌باشد .
+		کاربران تازه‌کار شاید بخواهند  ابتدا در مورد 
+		<a href="user-manuals#quick-reference">مرجع دبیان</a>
+		بیشتر بدانند .</dd>
+
+	  <dt><a href="http://refcards.com/">refcards.com</a></dt>
+	    <dd>یک مجموعه از کارتهای مرجع می‌باشد که بر روی نرم‌افزارهای آزاد متن‌باز تمرکز نموده است.</dd>
+
+	  <dt><a href="http://www.digilife.be/quickreferences/quickrefs.htm">کارتهای مرجع سریع</a></dt>
+	    <dd>مجموعه‌ای از کارتهای مرجع سریع  در رابطه با برنامه‌ها و وزبانهای برنامه‌نویسی می‌باشد</dd>
+	</dl>
+    </dd>
+
+</dl>
+
+<hrline />
+
+<p>در صورتی که شما مطالب بالا را مطالع کرده اید و مشکلتان در رابطه با دبیان حل نگردیده است و یا
+راه‌حل مناسبی برای مشکلتان نیافته اید به <a href="../support">صفحه پشتیبانی</a> مراجعه نمایید.</p>