اختلافات

عرض الاختلافات بين النسخة المختارة و النسخة الحالية من الصفحة.

--- docs:الصياغة [2011/08/27 03:01] – [إدراج الصور] ihab
+++ docs:الصياغة [2015/04/23 03:19] (حالي) – تحرير خارجي 127.0.0.1
@@ سطر 1: / سطر 1: @@
+====== صياغة المستندات ======
+===== الصياغة بطريقة الويكي =====
+==== التصنيف والتصدير ====
+نحن نستخدم الويكي لصياغة المقالات القصيرة
+حتّى نتمكّن من تصنيف الكتب والمقالات أضف سطرا يشبه
+  {{tag>tag1 tag2}}
+حيث tag1 و tag2 هما تصنيفات كما في هذا المثال
+  {{tag>مقالات مترجمة برمجة بيرل}}
+أمّا التصانيف الرسمية فهي
+  * مقالات - توضع على كل المقالات
+  * كتب - توضع على كل الكتب
+  * مترجمة - توضع على المقالات والكتب المترجمة
+  * تم - توضع على الوثائق المكتملة
+وما تبّقى يعتمد على الوثيقة.
+==== بداية المقالة واستيرادها ====
+يجب أن تبدأ أي مقالة بفصل "حول هذه المقالة" يحتوي سطر واحد عن موضع المقالة واسم المؤلف ورابط المصدر ومن قام بالترجمة واسم الرخصة
+وبعد ذلك يجب وضع كامل نص المقالة الأصلية ثم تنسيقها بصيغة الويكي كأن يتم تحديد أماكن الفصول وفروعها
+وبعد حفظها تبدأ الترجمة
+==== التنسيقات الأساسية ====
+<box green 40% left| هذا صندوق عائم>
+هذا الصندوق العائم لا يظهر عند التصدير
+مثله مثل بعض الإضافات في الويكي.
+</box>
+إنّ التنسيقات الأساس يمكن القيام بها عبر لوح الأدوات في أعلى واجهة التحرير.
+أهم تلك التنسيقات هي وضع العناوين الرئيسة عبر علامة المساواة المكرّرة هكذا
+<code>
+===== First level header ======
+===== Second level header =====
+==== Third level header ====
+</code>
+فعنوان المقالة يكون من المستوى الأول وعنوان أول فصل فيها يكون من المستوى الثاني وعنوان فصل فرعي يكون من المستوى الثالث وهكذا.
+الويكي يدعم التنسيقات التالية **ثخين** و //مائل// و __مسطر__ و ''ثابت-العرض'' وبالتأكيد يمكنك **//__''مزجها''__//** جميعها
+مصدر السطر السابق هو: \\
+<nowiki>الويكي يدعم التنسيقات التالية **ثخين** و //مائل// و __مسطر__ و ''ثابت-العرض'' وبالتأكيد يمكنك **__//''مزجها''//__** جميعها.</nowiki>
+يمكنك استخدام <sub>النص المنخفض</sub> و <sup>النص المرتفع</sup>, أيضاً.
+مصدر السطر السابق: \\
+<nowiki>يمكنك استخدام <sub>النص المنخفض</sub> و <sup>النص المرتفع</sup>، أيضاً.</nowiki>
+يمكن تحديد نص ليكون <del>مشطوب</del> أيضاً.
+مصدر السطر السابق: \\
+<nowiki>يمكن تحديد نص ليكون <del>مشطوب</del> أيضاً.</nowiki>
+**الفقرات** تنشأ من الأسطر الخالية أي اترك سطراً خالياً بين أي فقرتين لأن الأسطر المتتالية تُجمع في فقرة واحدة. إذا كنت تريد **إلزام نزول سطر جديد** دون عمل فقرة جديدة ، تستطيع وضع سلاش عكسي مزدوج متبوع بمسافة خالية في آخر السطر. كما في المثال التالي
+This is some text with some linebreaks\\ Note that the
+two backslashes are only recognized at the end of a line\\
+or followed by\\ a whitespace \\this happens without it.
+  This is some text with some linebreaks\\ Note that the
+  two backslashes are only recognized at the end of a line\\
+  or followed by\\ a whitespace \\this happens without it.
+لكن لا تستخدم الإلزام إلا عند الحاجة.
+إذا أردت كتابة نص صرف ولا ترغب في تطبيق تنسيقات الويكي عليه استخدم الواسمة nowiki حوله مثلا لعمل <nowiki>**</nowiki>
+وليس تحديد نص ثخين استخدم <nowiki><nowiki>**</nowiki></nowiki>
+==== الملاحظات ====
+هناك 4 أنواع من الملاحظات
+  * التلميح
+  * الملاحظة
+  * هام
+  * تحذير
+<note tip>هذا شكل التلميح</note>
+<note>هذا شكل الملاحظة العادية</note>
+<note important>هذا شكل الملاحظة المهمة</note>
+<note warning>هذا شكل التحذير</note>
+ويتم توليدها بالكود التالية
+<code>
+<note tip>
+هذا شكل التلميح
+</note>
+<note>
+هذا شكل الملاحظة العادية
+</note>
+<note important>
+هذا شكل الملاحظة المهمة
+</note>
+<note warning>
+هذا شكل التحذير
+</note>
+</code>
+==== إدراج الصور ====
+استخدم زر الصورة الموجود في شريط الأدوات الموضّح أدناه في رفع الصورة أو الملفات المرفقة
+{{ :docs:img.png?480 |زر الصورة في شريط الأدوات}}
+يُفضّل أن يحمل اسم الصورة اسم الوثيقة ثم - ثم اسم يدل على الصورة حتى لا تختلط بصور من وثائق أخرى.
+يمكن إدراج الصورة يدويا عبر حاصرتين مزدوجتين هكذا
+<code>
+{{filename.png}}
+</code>
+يمكن إعادة تحجيم الصورة عبر وضع علامة سؤال ثم عرض الصورة هكذا
+<code>
+{{filename.png?480}}
+</code>
+يمكن التحكم في مكان الصورة بالمسافات قبل وبعد اسم الصورة مثلا لتوسيط الصورة
+<code>
+{{ filename.png?480 }}
+</code>
+يمكن إعطاء الصورة عنوانا عبر علامة الأنبوب | هكذا
+<code>
+{{ filename.png?480 |title}}
+</code>
+كذلك يمكن وضع الصور في جدول
+<code>
+|  {{ filename.png?150 |title}}  |  {{ filename.png?150 |title}}  |  {{ filename.png?150 |title}}  |
+</code>
+==== التنسيقات المتقدّمة ====
+لعمل تذييل في الهامش أحطها بأقواس هلالية مزدوجة هكذا
+<nowiki>((هذا التعليق سيظهر في الهامش))</nowiki>
+الروابط يتم التعرّف عليها تلقائيًا، لعمل رابط لصفحة ويكي استخدم الأقواس المربّعة المزدوجة واكتب بداخله اسم الصفحة
+  [[Page Name]]
+هذه الطريقة تصلح مع مواقع الإنترنت أيضاً إذا كنت تريد عمل رابط بنص مخصّص مثل [[http://www.ojuba.org|click here]] اكتبه بعد الأنبوب | هكذا
+  [[http://www.ojuba.org|click here]]
+لإدراج صورة يمكن استخدام مدير الملفات من الواجهة والنقر على الصورة. أو استخدام الحاصرة المزدوجة هكذا
+  {{image.png}}
+تستطيع وضع مسافة بين الحاصرتين قبل الاسم أو بعده أو كلاهما حتى تجعل الصورة على الطرف أو في الوسط
+لعمل قائمة استعمل مسافتين (لكل مستوى) ثم * أو - وهذه الأخيرة للعدّ مثلاً
+  * First, they ignore you
+  * then they laugh at you
+  * then they fight you
+  * then you win
+<code>
+  * First, they ignore you
+  * then they laugh at you
+  * then they fight you
+  * then you win
+</code>
+لإدراج كود استعمل حوله الواسمة code ويمكنك تحديد اللغة مثلاً
+<file>
+<code python>
+#! /usr/bin/python
+def sum(a,b):
+  print "sum" , a+b
+  return a+b
+</code>
+</file>
+كي تظهر هكذا
+<code python>
+#! /usr/bin/python
+def sum(a,b):
+  print "sum" , a+b
+  return a+b
+</code>
+===== الصياغة بطريقة دوكبوك DocBook =====
+نعمل الآن على توفير دعم أنيق لدوكبوك داخل الويكي مع دعم اللغة العربية
+يُفضّل استخدام دوكبوك للمقالات الكبيرة خصوصاً عند ترجمة كتاب كُتِب أصلا بواسطة DocBook
+فضلا اقرأ المزيد عن docbook في صفحة [[docbook]] وانظر [[القالب]] لمعرفة كيف يتم دمج دوكبوك في الويكي