تستخدم دوكويكي وسوم بسيطة لجعل المحتوى أكثر مقروئية. في هذه المقالة سنستعرض جميع التراكيب المتوفرة والممكن استخدامها لتحرير صفحات الويكي. يمكنك مشاهدة كيفية تنسيق هذه المقالة عبر النقر على زر تحرير المتكرر في عدة فصول. لتجربة بعض من هذه التراكيب، يمكنك زيارة صفحة الكيس الرملي. لاحظ أنه يمكنك استخدام بعض اختصارات لوحة المفاتيح لاستخدام التراكيب الأكثر بساطة.
تقبل دوكويكي تنسيق النص الغليظ، المائل، المسطر و الثابت العرض
.
تقبل دوكويكي تنسيق النص **الغليظ**، //المائل//، __المسطر__ و ''الثابت العرض''.
وبالطبع, يمكن دمج
كل هذه التنسيقات مع بعض.
وبالطبع, يمكن **__//''دمج''//__** كل هذه التنسيقات مع بعض.
كما يمكن استخدام خاصية الخط المنخفض أو المرتفع.
كما يمكن استخدام خاصية الخط <sub>المنخفض</sub> أو <sup>المرتفع</sup>.
بالاضافة الى ذلك يمكن تحرير نص واعتباره محذوفا.
بالاضافة الى ذلك يمكن تحرير نص واعتباره <del>محذوفا</del>.
أما الفقرات فيتم انشاؤها انطلاقا من سطور فارغة. اذا كنت ترغب في العودة اليدوية الى السطر دون فقرة جديدة، يمكنك استخدام شرطتين خلفيتين مائلتين متبوعتين بمسافة او بنهاية السطر.
هذا نص يحتوي على عودة يدوية الى السطر
لاحظ أنه لا يتم
الأخذ بالاعتبار للشرطتين المائلتين إلاّ في نهاية السطر
أو عندما تكونان متبوعتين بـ
مسافة. \\هذا ما سيحدث في الحالات الأخرى.
هذا نص يحتوي على عودة الى السطر\\ لاحظ أنه لا يتم الأخذ بالاعتبار للشرطتين المائلتين إلاّ في نهاية السطر\\ أو عندما تكونان متبوعتين بـ\\ مسافة. \\هذا ما سيحدث في الحالات الأخرى.
عمليا لا تحتاج للعودة اليديوية الى السطر إلا للضرورة القصوى.
تسمح دوكويكي بالعديد من الطرق لانشاء روابط.
تتعرف دوكويكي « آليا » على الروابط الخارجية: http://www.google.com أو بشكل أبسط www.google.com . كما يمكن اعطاء اسم للرابط : هذا رابط محرك جوجل. تستطيع الويكي كذلك التعرف على عناوين البريد الالكتروني مثل هذا : wahaproject [at] gmail [dot] com .
تتعرف دوكويكي « آليا » على الروابط الخارجية: http://www.google.com أو بشكل أبسط www.google.com . كما يمكن اعطاء اسم للرابط : [[http://www.google.com|هذا رابط محرك جوجل]]. تستطيع الويكي كذلك التعرف على عناوين البريد الالكتروني مثل هذا : <wahaproject@gmail.com> .
يتم انشاء الروابط الداخلية باستخدام القوسين المربعين. يمكن الحصول على رابط داخلي بهذه الطريقة اسم الصفحة أو بالطريقة التالية عنوان الصفحة. اسم الصفحة (pagenames) يتم تحويله آليا الى حروف صغيرة ولا يُسمح بالرموز الخاصة.
يتم انشاء الروابط الداخلية باستخدام القوسين المربعين. يمكن الحصول على رابط داخلي بهذه الطريقة [[doku>ar:pagename|اسم الصفحة]] أو بالطريقة التالية [[doku>ar:pagename|عنوان الصفحة]]. اسم الصفحة (//pagenames//) يتم تحويلها آليا الى حروف صغيرة ولا يُسمح بالرموز الخاصة.
كذلك يمكن استخدام فئة (namespaces) عبر استعمال النقطتين (:
) في اسم الصفحة pagename.
كذلك يمكن استخدام [[doku>ar:namespaces|فئة]] (//namespaces//) عبر استعمال //النقطتين// ('':'') في اسم الصفحة //pagename//.
للمزيد من المعلومات حول الفئات (namespaces) راجع الفئات.
يمكن انشاء رابط نحو فصل محدد داخل المقالة. وذلك عبر اضافة اسم الفصل المقصود مسبوقا بالعلامة (#) كما هو الحال في لغة اتش تي ام ال (html). الرابط التالي سيحيلك الى فصل الروابط الداخلية اي هذا الفصل بالتحديد هذا الفصل.
الرابط التالي سيحيلك الى فصل الروابط الداخلية اي هذا الفصل بالتحديد [[syntax#الروابط الداخلية|هذا الفصل]].
ملاحظات :
تسمح دوكويكي بالروابط مع مجموعات الويكي انترويكي. على سبيل المثال، هذا رابط شرح معنى ويكي على ويكيبيديا العربية : ويكي.
تسمح دوكويكي بالروابط مع مجموعات الويكي [[doku>ar:interwiki|انترويكي]]. على سبيل المثال، هذا رابط شرح معنى ويكي على ويكيبيديا العربية : [[wp>ar:Wiki|ويكي]].
المقصود بشبكة وندوز شيئ كهذا هناهنا وهو غير ممكن الاّ ضمن مجموعة متجانسة من المستخدمين كما في الشبكة المحلية شبكة محلية
يمكن استخدام الصور لانشاء روابط نحو صفحات داخلية أو خارجية عبر دمج مفردات صياغة الروابط و الصور (انظر في الأسفل) كهذا المثال:
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
تنبيه : الصياغة الوحيدة المقبولة كرابط هي التنسيق صورة.
يمكن استخدام عبارات الصياغة الخاصة بــ الصور كلها وبـ الروابط (ومن ضمنها تعديل حجم الصورة والصور الداخلية أو الخارجية وروابط الانترنت وروابط انترويكي).
يمكن اضافة هامش في آخر الصفحة أو تذييل 1) وذلك عبر استخدام زوجين من الاقواس.
يمكن اضافة هامش في آخر الصفحة أو تذييل ((هذا هامش سفلي)) وذلك عبر استخدام زوجين من الاقواس.
يمكنك استخدام ما يصل إلى خمسة مستويات مختلفة من العناوين لتنظيم المحتوى الخاص بك. إذا كان لديك أكثر من ثلاثة عناوين، يتم إنشاء جدول المحتويات تلقائيا - وهذا يمكن تعطيله عبر اضافة العبارة التالية الى الصفحة : ~~NOTOC~~
==== عنوان المستوى 3 ==== === عنوان المستوى 4 === == عنوان المستوى 5 ==
اذا استخدمت 4 مطات أو أكثر ستتحول الى سطر أفقي :
----
يمكن إدارج صور خارجية أو داخلية بواسطة القوسين المعقوفين. كما يمكن اختياريا تحديد قياساتها.
التعديل الى عرض وارتفاع محددين2) :
الحجم الحقيقي : {{wiki:dokuwiki-128.png}} التعديل الى عرض محدد : {{wiki:dokuwiki-128.png?50}} التعديل الى عرض وارتفاع محددين((إذا لم يتم احترام التناسب بين العرض والارتفاع، فالصورة ستكون <<مقتطعة>> قبل تعديلها الى القياسات الجديدة)) : {{wiki:dokuwiki-128.png?200x50}} صورة خارجية معدّلة : {{http://de3.php.net/images/php.gif?200x50}}
يمكن اختيار الازاحة عبر اضافة مسافات على اليمين أو على الشمال أو كليهما.
{{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
كما يمكن اضافة نص أو عنوان للصورة (يظهر عند تقريب الفأرة في شكل تلميح على أغلب المتصفحات).
{{ wiki:dokuwiki-128.png |هذه تلميحة مرافقة للصورة}}
ويمكن وضع صورة للتحميل دون عرضها عبر استخدام ?linkonly
بعد اسم الصورة
{{ wiki:dokuwiki-128.png?linkonly|لوقو دوكويكي}}
إذا لم يكن الملف من نوع الصور المعروفة (gif, jpeg, png
) فسيتم عرضه كرابط وليس كصورة.
لربط صورة بصفحة أخرى يرجى مراجعة روابط الصور المذكور أعلاه.
تقبل دوكويكي القوائم المرتبة وغير المرتبة. لإنشاء عنصر من القائمة أضف مسافتين ثم نجمة *
لقائمة غير المرتبة أو مطة -
لقائمة مرتبة.
* هذه قائمة غير مرتبة * هذا العنصر الثاني في القائمة * يمكن انشاء قائمة داخل القائمة * هذا العنصر الثالث في القائمة - نفس القائمة لكن مرتبة - العنصر الثاني في القائمة - بنفس الطريقة يتم انشاء قائمة فرعية داخل قائمة رئيسية - وهكذا...
راجع صفحة الأسئلة المتكررة (FAQ) للمزيد من المعلومات الأسئلة المتكررة حول القوائم
تستطيع دودويكي تحويل محارف وسلاسل نصية محددة الى صور أو الى نص آخر أو الى صيغة html.
يُستخدم التحويل الى صور لاظهار الابتسامات خاصة (smileys)، أما التحويل الى صيغةhtml فهو يُستخدم لأسباب متعلقة بتحسين طباعة النص على الشاشة، لكن يمكن تعديل ذلك لاستخدام وسوم html أخرى.
تستطيع دوكويكي تحويل التعابير الانفعالية Emoticon المعروفة الى رسوم سمايلي. يمكن اضافة المزيد من هذه الابتسامات (smileys) في مجلد smiley
ثم ضبطها في ملف conf/smileys.conf
. هذه نظرة عن الابتسامات المدمجة مع دوكويكي.
تستطيع دوكويكي تحويل رموز بسيطة الى ما يقابلها من العلامات التيبوغرافية مطبوعة على الشاشة بشكل صحيح. هذا مثال من الرموز المعروفة
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
يمكن عمل مثل هذا لأي وسم html عبر تحرير ملف ملف الأنماط واضافة سطر لكل وسم جديد.
لكن يوجد ثلاثة استثناءات نذكرها. علامة الضرب (640×480), والظفر '' و “الظفرين”. رغم أنه من الممكن تعطيل ذلك عبر ملف ضبط الاعدادات.
الاقتباس لا يعمل بشكل صحيح باللغة العربية
قد ترغب أحيانا في تمييز نص للاشارة الى أنه جواب أو تعليق أو غير ذلك. يمكنك استخدام الصياغة التالية:
أعتقد أننا يجب أن نقوم بذلك > لا ! لا يجب ذلك >> كلاّ، لازلت أعتقد أننا يجب أن نقوم بذلك > حقّا ؟ >> أجل ! >>> لنقم به إذًا !
أعتقد أننا يجب أن نقوم بذلك
> لا ! لا يجب ذلك
» كلاّ، لازلت أعتقد أننا يجب أن نقوم بذلك
> حقّا ؟
» أجل !
»> لنقم به إذًا !
تستخدم دوكويكي لغة صياغة سهلة لإنشاء الجداول.
العـنـوان 1 | العنـوان 2 | العنـوان 3 |
---|---|---|
سطر 1 عمود 1 | سطر 1 عمود 2 | سطر 1 عمود 3 |
سطر 2 عمود 1 | أعمدة مدمجة : لاحظ الشريطين العموديين المزدوجين | |
سطر 3 عمود 1 | سطر 2 عمود 2 | سطر 2 عمود 3 |
سطور الجدول يجب أن تبدأ وتنتهي بـ شريط عمودي |
للسطور العادية أو بـ ^
للعناوين.
^ الـعـنـوان 1 ^ الـعـنـوان 2 ^ الـعـنـوان 3 ^
| سطر 1 عمود 1 | سطر 1 عمود 2 | سطر 1 عمود 3 |
| سطر 2 عمود 1 | أعــــمـــدة مـــدمــجـة : || لاحظ الشريطين المزدوجين هنا
| سطر 3 عمود 1 | سطر 2 عمود 2 | سطر 2 عمود 3 |
لدمج خانتين أفقيا، يكفي افراغ الخانة الموالية كما تم توضيحه في المثال السابق. تأكد أن عندك دائما نفس عدد الشرطات العمودية التي تقوم بدور الفصل بين الخانات.
يمكن ايضا اضافة عناوين عموديا كما يلي:
العنوان 1 | العنوان 2 | |
---|---|---|
العنوان 3 | سطر 1 عمود 2 | سطر 1 عمود 3 |
العنوان 4 | لا دمج هنا | |
العنوان 5 | سطر 2 عمود 2 | سطر 2 عمود 3 |
كما يمكنك أن تلاحظ،الرمز الذي يسبق الخانة ('|' أو '^') هو الذي يحدد وظيفتها كخانة عادية ('|') أو عنوان ('^') :
| ــــــــــــ ^ الـعـنــوان 1 ^ الـعـنــوان 2 ^
^ الـعـنـوان 3 | سطر 1 عمـود 2 | سطر 1 عمـود 3 |
^ الـعـنـوان 4 | لا دمــج هـنـا | ـــــــــــــ |
^ الـعـنـوان 5 | سطر 2 عمـود 2 | سطر 2 عمـود 3 |
يمكن دمج خانات عموديا عبر اضافة ::: في الخانات التي تأتي تحت تلك التي ستُدمج معها.
هذه الخاصية غير متوفرة سوى في دوكويكي الأحدث من 2009-02-14b
العنوان 1 | العنوان 2 | العنوان 3 |
---|---|---|
سطر 1 عمود 1 | هذه الخانة ستمتد عموديا | سطر 1 عمود 3 |
سطر 2 عمود 1 | سطر 2 عمود 3 | |
سطر 3 عمود 1 | سطر 3 عمود 3 |
لا يجب أن تحتوي الخانات المدمجة عل أي شيء آخر عدى رمز الدمج :::
الحروف اللاتينية هنا للتنسيق فقط وليست من قواعد الصياغة.
h ^ العنوان 1 ^ العنوان 2 ^ العنوان 3 ^ r | سطر 1 عمود 1 | هذه الخانة ستمتد\\ عموديا | سطر 1 عمود 3 | r | سطر 2 عمود 1 | ::: | سطر 2 عمود 3 | r | سطر 3 عمود 1 | ::: | سطر 3 عمود 3 |
يمكن كذلك ترصيف محتوى الجدول أفقيا فقط، وذلك عبر اضافة مسافتين في حافة النص المعاكسة: فاذا كنت ترغب في ترصيف المحتوى علي اليمين، أضف مسافتين على يسار النص، أو اضف مسافتين على اليمين لترصيف النص من الجهة اليسرى. أما اذا كنت ترغب في ترصيف المحتوى في الوسط فأضف مسافتين على الأقل في كل جهة.
جدول يشرح الترصيف | ||
---|---|---|
يمين | وسط | يسار |
يسار | يمين | وسط |
^ Header: جدول يشرح الترصيف ^^^ | right يمين| center وسط |left يسار | |left يسار | right يمين| center وسط |
العنوان يظهر دوما مرصوفا على اليمين باللغة العربية
قد ترغب في ادراج نص دون الرغبة في تنسيقه. يمكنك ذلك عبر اضافة فراغين على الاقل في بداية كل سطر (مثلما تراه في الأمثلة السابقة) أو عبر استخدام وسوم code
أو file
.
هذا نص يرغب صاحبه في المحافظة على جميع المسافات بين الكلمات : مثل <-هذا
هذا تقريبا نفس الشيئ، لكن صاحب النص يريد استخدامه ليبين أنه يقتبس من ملف.
اذا أردت أن يتجاهل محلل دوكويكي مقطعا من النص بالكامل (كالرغبة في عدم تنسيق الخط مثلا)، فأحط مقطع النص ذاك بالوسم nowiki
أو بطرقة ابسط بواسطة زوجين من رمز النسبة المائوية %%
<nowiki> هذا نص يحتوي على عنوان موقع : http://www.debian.org وعلى **خط غليظ**, لكن لاشيئ يحدث. </nowiki>
هذا نص يحتوي على عنوان موقع : http://www.debian.org وعلى **خط غليظ**, لكن لاشيئ يحدث.
راجع الملف النصي لهذه الصفحة لترى كيفية تعطيل التنسيق .
تسمح لك دوكويكي بتنسيق الكود المصدري باستخدام التلوين مما ييسر قراءته، وهي تستخدم Generic Syntax Highlighter GeSHi، وهي بالتالي تدعم جميع اللغات المعروفة من GeSHi. تتم الصياغة بنفس الطريقة المذكورة في الفصل السابق حول تعطيل التنسيق، لكن مع اضافة لغة البرمجة المستخدمة في النص، مثلا : <code java>
.
/** * تنفذ الفئة * HelloWorldApp * تطبيقة تعرض بشكل مبسط عبارة * "Hello World!" . */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //عرص السلسلة النصية. } }
اللغات المدعومة حاليا :
4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc,
عندما تستخدم الوسوم <code> أو <file>, يمكنك أن تجعل مقطع الكود المعروض قابل للتنزيل. في هذذه الحالة يجب تحديد اسم الملف في الوسم مباشرة بعد اسم لغة البرمجة.
<?php echo "hello world!"; ?>
<file php hello_world.php> <?php echo "hello world!"; ?> </file>
اذا كنت لا ترغب في تلوين الكود البرمجي، ضع مطة (-) مكان اللغة :
<code - myfile.foobar>.
تتيح لك دوكويكي تجميع مواضيع XML الخارجية وهي تستخدم لهذا الغرض SimplePie. كل الصيغ المعروفة من SimplePie يمكن استخدامها في دوكويكي. يمكن تعديل طريقة التعامل مع مواضيع RSS / ATOM عبر اضافة عديد المعاملات (parameters) مع فصل كل واحدة بفراغ
المُعامل | دوره |
---|---|
أيّ عدد | سيستخدم كأقصى عدد من المواضيع التي سيتم عرضها. العدد القياسي هو 8 |
reverse | لعرض آخر المواضيع أولا |
author | لعرض معرف كاتب الموضوع |
date | لعرض تواريخ المواضيع |
description | عرض اوصاف المواضيع، هذه الخاصية معطلة |
n[dhm] | زمن التحديث، حيث d=days (ايام), h=hours (الساعات), m=minutes (الدقائق). (مثلا 12h = 12 ساعة). |
زمن التحديث افتراضيا 4 ساعات . كل قيمة اقل من 10 دقائق سيتم اعتبارها 10 دقائق. ستحاول دوكويكي عرض الصفحة انطلاقا من المحتوى المخزن (cache) . هذا بالطبع غير مناسب اذا كان محتوى الصفحة ديناميكي خارجي. معامل زمن التحديث سيعلم دوكويكي أن عليها تحديث الصفحة اذا مر زمن أطول من المحدد منذ آخر تحديث.
مثال :
{{rss>http://feeds.feedburner.com/itwadi/ 5 author date 1h }}
تحذير: ادارج كود HTML أو PHP معطل قياسيا لدواعي أمنية. لا تفعله الاّ اذا كنت تعرف ما تفعل.
يمكن ادراج كود HTML أو PHP في صفحة باستخدام وسوم HTML أو PHP كما يلي:
<html> هذا كود <font color="red" size="+1">HTML</font> </html>
<html> هذا كود <font color=“red” size=“+1”>HTML</font> </html>
<php> echo 'هذا لوقو مبرمج بواسطة لغة PHP :'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />'; </php>
<php> echo 'هذا لوقو مبرمج بواسطة لغة PHP :'; echo '<img src=“' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '” alt=“Logo PHP !” />'; </php>
ملاحظة : عندما تكون خاصية ادراج كود HTML أو PHP معطل كما هو الحال هنا، سيتم عرض الكود نفسه بدون تنفيذ.
تغير بعض الكلمات المفاتيح طريقة انتاج دوكويكي لصفحة بدون اضافة أي محتوى. عدد 2 ماكرو متوفرتان افتراضيا:
الماكرو | تعريفها |
---|---|
~~NOTOC~~ | هذه الماكرو تمنع انشاء فهرس عندما تضاف الى صفحة. |
~~NOCACHE~~ | افتراضيا تقوم دوكويكي بتخزين الصفحات التي تنتجها. أحيانا لا يكون هذا المطلوب (مثلا عندما يكون الوسم php مفعّل). باضافة هذه الماكرو الى الصفحة سيتم اجبار دوكويكي على اعادة انتاج الصفحة من جديد عند كل طلب لها. |
يمكن اثراء لغة الصياغة في دوكويكي بـالعديد من اضافات. لمعرفة كيفية استخدام احدى تلك الاضافات، يرجى مراجعة صفحتها الخاصة. الاضافات التالية متوفرة في النسخة المثبتة حاليا بين يديك: