صياغة المستندات

نحن نستخدم الويكي لصياغة المقالات القصيرة

حتّى نتمكّن من تصنيف الكتب والمقالات أضف سطرا يشبه

{{tag>tag1 tag2}}

حيث tag1 و tag2 هما تصنيفات كما في هذا المثال

{{tag>مقالات مترجمة برمجة بيرل}}

أمّا التصانيف الرسمية فهي

• مقالات - توضع على كل المقالات
• كتب - توضع على كل الكتب
• مترجمة - توضع على المقالات والكتب المترجمة
• تم - توضع على الوثائق المكتملة

وما تبّقى يعتمد على الوثيقة.

يجب أن تبدأ أي مقالة بفصل “حول هذه المقالة” يحتوي سطر واحد عن موضع المقالة واسم المؤلف ورابط المصدر ومن قام بالترجمة واسم الرخصة

وبعد ذلك يجب وضع كامل نص المقالة الأصلية ثم تنسيقها بصيغة الويكي كأن يتم تحديد أماكن الفصول وفروعها

وبعد حفظها تبدأ الترجمة

إنّ التنسيقات الأساس يمكن القيام بها عبر لوح الأدوات في أعلى واجهة التحرير.

أهم تلك التنسيقات هي وضع العناوين الرئيسة عبر علامة المساواة المكرّرة هكذا

===== First level header ======
===== Second level header =====
==== Third level header ====

فعنوان المقالة يكون من المستوى الأول وعنوان أول فصل فيها يكون من المستوى الثاني وعنوان فصل فرعي يكون من المستوى الثالث وهكذا.

الويكي يدعم التنسيقات التالية ثخين و مائل و مسطر و ثابت-العرض وبالتأكيد يمكنك مزجها جميعها

مصدر السطر السابق هو:
الويكي يدعم التنسيقات التالية **ثخين** و //مائل// و __مسطر__ و ''ثابت-العرض'' وبالتأكيد يمكنك **__//''مزجها''//__** جميعها.

يمكنك استخدام _{النص المنخفض} و ^{النص المرتفع}, أيضاً.

مصدر السطر السابق:
يمكنك استخدام _{النص المنخفض} و ^{النص المرتفع}، أيضاً.

يمكن تحديد نص ليكون مشطوب أيضاً.

مصدر السطر السابق:
يمكن تحديد نص ليكون <del>مشطوب</del> أيضاً.

الفقرات تنشأ من الأسطر الخالية أي اترك سطراً خالياً بين أي فقرتين لأن الأسطر المتتالية تُجمع في فقرة واحدة. إذا كنت تريد إلزام نزول سطر جديد دون عمل فقرة جديدة ، تستطيع وضع سلاش عكسي مزدوج متبوع بمسافة خالية في آخر السطر. كما في المثال التالي

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>

هناك 4 أنواع من الملاحظات

• التلميح
• الملاحظة
• هام
• تحذير

ويتم توليدها بالكود التالية

<note tip>
هذا شكل التلميح
</note>
<note>
هذا شكل الملاحظة العادية
</note>
<note important>
هذا شكل الملاحظة المهمة
</note>
<note warning>
هذا شكل التحذير
</note>

استخدم زر الصورة الموجود في شريط الأدوات الموضّح أدناه في رفع الصورة أو الملفات المرفقة

يُفضّل أن يحمل اسم الصورة اسم الوثيقة ثم - ثم اسم يدل على الصورة حتى لا تختلط بصور من وثائق أخرى.

يمكن إدراج الصورة يدويا عبر حاصرتين مزدوجتين هكذا

{{filename.png}}

يمكن إعادة تحجيم الصورة عبر وضع علامة سؤال ثم عرض الصورة هكذا

{{filename.png?480}}

يمكن التحكم في مكان الصورة بالمسافات قبل وبعد اسم الصورة مثلا لتوسيط الصورة

{{ filename.png?480 }}

يمكن إعطاء الصورة عنوانا عبر علامة الأنبوب | هكذا

{{ filename.png?480 |title}}

كذلك يمكن وضع الصور في جدول

|  {{ filename.png?150 |title}}  |  {{ filename.png?150 |title}}  |  {{ filename.png?150 |title}}  |

لعمل تذييل في الهامش أحطها بأقواس هلالية مزدوجة هكذا ((هذا التعليق سيظهر في الهامش))

الروابط يتم التعرّف عليها تلقائيًا، لعمل رابط لصفحة ويكي استخدم الأقواس المربّعة المزدوجة واكتب بداخله اسم الصفحة

[[Page Name]]

هذه الطريقة تصلح مع مواقع الإنترنت أيضاً إذا كنت تريد عمل رابط بنص مخصّص مثل 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

  * First, they ignore you
  * then they laugh at you
  * then they fight you
  * then you win

لإدراج كود استعمل حوله الواسمة code ويمكنك تحديد اللغة مثلاً

<code python>
#! /usr/bin/python
def sum(a,b):
  print "sum" , a+b
  return a+b
</code>

كي تظهر هكذا

#! /usr/bin/python
def sum(a,b):
  print "sum" , a+b
  return a+b

نعمل الآن على توفير دعم أنيق لدوكبوك داخل الويكي مع دعم اللغة العربية

يُفضّل استخدام دوكبوك للمقالات الكبيرة خصوصاً عند ترجمة كتاب كُتِب أصلا بواسطة DocBook

فضلا اقرأ المزيد عن docbook في صفحة كتابة وثائق docbook وانظر القالب لمعرفة كيف يتم دمج دوكبوك في الويكي