أدوات المستخدم

أدوات الموقع


docs:الصياغة

اختلافات

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

رابط إلى هذه المقارنة

جانبي المراجعة السابقة المراجعة السابقة
المراجعة التالية
المراجعة السابقة
docs:الصياغة [2011/07/17 06:25]
alsadi [التنسيقات الأساسية]
docs:الصياغة [2015/04/23 00:19] (حالي)
سطر 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]] وانظر [[القالب]] لمعرفة كيف يتم دمج دوكبوك في الويكي
 +
  
docs/الصياغة.txt · آخر تعديل: 2015/04/23 00:19 (تحرير خارجي)