كيفية تنسيق المادة

zh:如何设置格式文章 fr:Comment formater son article

هام: تمت ترجمة هذه المقال باستخدام برامج للترجمة الآلية أنقر على الرابط لية أنقر على الرابط

توضح هذه المقالة كيفية تنسيق البرنامج التعليمي الخاص بك. من بعد، وهذا دليل نمط الكتابة، سيتم تطبيق البرنامج التعليمي الخاص بك التوصيات إيكولا.

بناء جملة ويكي

دروس إيكولا يجب أن تكون مهيأة باستخدام ويكي بناء الجملة. هذه المادة سوف أعطيكم أمثلة بناء الجملة هذا الأكثر شيوعاً. يمكنك العثور على مزيد من التفاصيل في قسم المساعدة ميدياويكي أما بالنسبة لتنسيق ويكي.

الفصول

لقص الدروس الخاصة بك إلى فصول، يمكنك استخدام مستويات العنوان. بمجرد وضع عنوان في الصفحة، كل من البنود التالية سينظر كجزء من الفصل الجديد، حتى العنوان التالي من نفس المستوى.
وهذا يمكن أن تكون مفيدة جداً لتحسين إمكانية قراءة المقال الخاص بك عن طريق الاستغناء عن المراحل المختلفة لتحقيق.

مستويات مختلفة من العنوان

عنوان مستوى 1 يتوافق مع عنوان المقال. يتم إنشاؤه تلقائياً عندما تقوم بإنشاء الصفحة الخاصة بك. المسارات مبنية حول العنوان الخاص بعلامات "=". عنوان مستوى 2 يتوافق مع عنوان الفصل أو القسم الأول.
مثال للعنوان هذا المقطع :

==Chapitres==

أكثر سوف تقوم بتسجيل حول العنوان الخاص بك، كلما تذهب إلى أسفل الشجرة.

مثال	النتيجة
===Titre de niveau 3=== ====Titre de niveau 4==== =====Titre de niveau 5=====	Titre de niveau 3 Titre de niveau 4 Titre de niveau 5

تجدر الإشارة إلى أن جدول محتويات يظهر تلقائياً في رأس المقالة بمجرد أن هناك على الأقل 4 الفصول أو الفصول.

أنماط

يمكنك تنسيق النص الخاص بك باستخدام بناء الجملة ويكي وعدد قليل من علامات HTML.

جريئة

هنا كيفية إنهاء جريئة في المادة الخاصة بك.

مثال	النتيجة
'''نص غامق '''	texte en gras

إليك قائمة بالبنود التي ينبغي أن تكون بخط غامق.

• النص مرئية من واجهة المستخدم الرسومية
• تغير السياق لعنصر تحكم، مثل تغيير المستخدم أو الملقم
• أسماء المضيفين ك الملقم-1
• المستخدمين مثل عكلة
• سريعة
• قائمة المصطلحات، ك :
  • الخلية : مشغل قاعدة بيانات
  • أباتشي : خادم الويب
• العناصر التي يجب أن لا تفوت اللاعب، تجعل من دون الكثير.

الخط المائل

يجب استخدام خط مائل فقط لإدخال المصطلحات التقنية. مثل : nginx سوف تستخدم خادم ك عكس الوكيل .

مثال	النتيجة
''النص المائل ''	texte en مائل

الملاحظات والتحذيرات

قد يلزم استخدام بعض علامات HTML لتسليط الضوء على بعض العناصر مثل الملاحظات أو تحذيرات.

مثال	النتيجة
<div style="background-color: #FFCC99;"> '''ملاحظة ''': هذا ملاحظة. </div> <div style="background-color: #FF9999;"> '''تحذير ''': وهذا تحذير. </div>	Note: Ceci est une note. Warning: Ceci est un avertissement.

Blockquotes

blockquotes لبنات حيث يتم تنسيق النص الخاص بك بشكل مختلف. للقيام بهذا، ببساطة وضع مسافة في بداية الجملة، أو قم بإحاطة النص الخاص بك من العلامات  <pre>. Votre texte sera alors formaté dans un cadre avec une police différente.

مثال	النتيجة
النص الهام ''italique'' ou <pre>Texte important ''italique''</pre>	Texte important italique ou Texte important ''italique''

كما أشرتم، استخدام العلامة <pre> fait que tout autre formatage à l'intérieur du bloc sera ignoré et considéré comme du texte à afficher. Si vous utilisez la première méthode, avec l'espace en début de ligne, sachez qu'un retour à la ligne fermera le cadre.
Nous préconisons d'استخدم العلامة GeSHi ou la méthode des notes et avertissements pour afficher du code source ou des informations importantes.

Code source

Lorsque vous publiez un code source, vous devez appliquer la balise <syntaxhighlight>. Cela permettra à votre code de bénéficier d'une coloration syntaxique, le rendant plus lisible. Afin d'adapter la coloration au langage utilisé, ajoutez l'option lang="langage" dans la balise.

مثال	النتيجة
<syntaxhighlight lang="php"> <?      $hello = "Hello World";      echo $hello; // comment ?> </syntaxhighlight>	<? $hello = "Hello World"; echo $hello; // comment ?>

Vous trouverez sur le site de l'extension GeSHi la liste des langages supportés et quelques options supplémentaires, telle l'ajout de numéros de ligne ou la mise en évidence d'une ligne dans le code.

Référence à une application

Lorsque vous mentionnez une application, préférez utiliser la capitalisation du site officiel. Si le site web n'est pas consistent, choisissez une forme et essayez de l'être dans votre article.
Par contre, ne capitalisez pas les noms de paquets ou des commandes, si ces derniers ne le sont pas.
مثال :

A MySQL database vs. the mysql command or the mysql-server package.

Listes

A chaque type de liste son utilisation.

Listes non-ordonnées

Ces listes sont utiles pour :

• les prérequis
• les checklists

مثال	النتيجة
* élément 1 * élément 2	élément 1 élément 2

Listes de définitions

Ces listes sont utiles pour :

• les termes et explications
• explications pour les variables dans une ligne de commande ou un fichier

Exemple	Résultat
;mot 1 : définition 1 ;mot 2 : définition 2-1 : définition 2-2	mot 1 définition 1 mot 2 définition 2-1 définition 2-2

Listes ordonnées

Les listes ordonnées sont à utiliser avec parcimonie. Elles peuvent s'avérer pratiques pour lister l'ordre d'un processus, tel que le traitement d'une requête DNS.

Exemple	Résultat
# élément 1 # élément 2	élément 1 élément 2

Ces listes sont utiles pour :

• décrire un processus de traitement

Dans certains cas, l’utilisation d'un tableau sera préférable aux listes.

Tableaux

Voici un exemple simple de tableau. Cela peut être utile pour présenter plus facilement un code exemple et son résultat. Les tableaux sont structurés comme suit.

{|	début de tableau
|+	descriptif du contenu, optionnel; un seul par tableau positionné entre le début du tableau et la première ligne
|-	début de ligne, optionnel sur la première ligne -- le moteur de wiki prend en charge la première ligne
!	cellule entête, optionnel. Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
|	cellule de donnée , requis! Les cellules de données consécutives d'un tableau peuvent être soit mises sur la même ligne séparées par une double barre verticale (||), soit sur des lignes séparées, chacune ayant son unique barre verticale (|).
|}	fin de tableau

Exemple	Résultat
{| |أورانج |أبل |- |الخبز |فطيرة |- |زبدة |الآيس كريم |}	Orange Apple Bread Pie Butter Ice cream

للحصول على مزيد من المعلومات حول جداول، يرجى الرجوع ويكيميديا اليدوي

البرامج النصية والملفات

من المؤكد أن تصف دور الملفات أو البرامج النصية التي ذكرتها. وبهذه الطريقة سوف يكون القارئ على نفس المستوى من المعلومات التي يمكنك وسوف يكون أكثر قدرة على فهم النهج الخاص بك.

البرامج النصية

عند إعطاء محتويات برنامج نصي أو ملف تكوين، تأكد من أنه علق، يفضل أن تكون على مستوى البنود المعنية. والهدف أن القارئ فهم كل من الإجراءات المذكورة، ولذلك فمن المهم أن تكون تعليمية أكثر قدر الإمكان. وبهذه الطريقة، سيكون أكثر قدرة على تخصيص أو تحديث أو تشخيص المشاكل مع الخادم في الأجل الطويل.

إذا كان للملفات التي تقوم بنشر أجزاء طويلة و /أو عدم اهتمام للبرنامج التعليمي الخاص بك، يمكنك حذف هذه الأطراف مع القطع الناقص (...).
نوصي بالاستخدام Balise GeSHi لعرض محتويات البرامج النصية أو الملفات. هذا الأخير سوف يسمح لك، بالإضافة إلى تسليط الضوء على بناء الجملة، ببساطة الإشارة إلى أرقام الأسطر وتسليط الضوء على أهمية أكبر. من المستحسن أن تستخدمها تسليط الضوء على للإشارة إلى الخطوط حيث توجد تغييرات لأداء.

Exemple	Résultat
<syntaxhighlight lang="apache" line start="10" highlight="5"> <VirtualHost *:80> DocumentRoot /www/example1 ServerName www.example.com # Other directives here </VirtualHost> </syntaxhighlight>	10<VirtualHost *:80> 11 DocumentRoot /www/example1 12 ServerName www.example.com 13 # Other directives here 14</VirtualHost>

الملف

لديك إمكانية إدراج ملف أو صورة في البرنامج التعليمي الخاص بك. أن أبسط طريقة لتحقيق الشيء ناهيك عن الوثيقة في المادة الخاصة بك، ثم وضعت على الإنترنت مرة إكمال الكتابة. إذا كان الملف غير موجود مسبقاً، سيتم أشار إلى جانب وصلة حمراء. بالنقر على هذا الارتباط، سوف تأتي إلى صفحة التي تسمح لك لتحميل الملف الخاص بك.

Exemple	Résultat
[[Media:mon_fichier.txt]]

تجدر الإشارة إلى أن الارتباط إلى الملف يعتمد حصرا على اسم الملف. من المستحسن استخدام أسماء وصفية، كالملفات الممكنة. لا تنسى أن تتضمن وصفاً للملف عند وضعها على الإنترنت.

الصور

صور يعاملون كملفات. ولذلك يمكنك تضمينها ووضعها على الإنترنت بنفس الطريقة كملفات.
والفرق الوحيد مع ملف أنه سيتم عرض الصورة في النص. ما يمنحك المزيد من الخيارات لعرض.

يكون بناء الجملة للامتثال :

[[File:sample_image.jpg|options|description]]

خيارات ووصف اختيارية.

Exemple	Résultat
[[File:sample_image.jpg|200px|thumb|right|modèle image]] 200px : الحجم لعرض thumb : هو وقع الصورة في إعداد الذي سيتم عرض الوصف right : محاذاة الصورة الصحيحة	modèle image

يمكنك العثور على مزيد من المعلومات حول الخيارات المختلفة المتاحة في التلاعب بالصورة على دليل ميدياويكي.
تجنب استخدام الصور ثقيلة جداً ويفضلون استخدام تنسيقات jpg و jpeg و png.

لوحة المفاتيح مفاتيح

لوصف مفاتيح لوحة المفاتيح، اتبع هذه التوصيات :

• كتابتها بالأحرف الكبيرة
• utiliser la balise <span>
• utiliser le symbole + si elles doivent être pressées simultanément

Exemple	Résultat
دعم <span style="background-color: #E6E6E6;">CTRL</span>+<span style="background-color: #E6E6E6;">ALT</span>+<span style="background-color: #E6E6E6;">وت </span> ثم '''إدارة المهام '''	Appuyer sur CTRL+ALT+SUPP puis Gestionnaire des tâches

استضافة أسماء

من المستحسن استخدام أسماء المضيف الممكن الأكثر تحديداً، والذي بالنسبة لدور الخادم.
Exemple :

• dns_serveur
• bdd_master
• proxy_nginx
• إلخ.

أسماء النطاقات

عند التعامل مع أسماء النطاقات، يفضل استخدام الحقل domain.tld كالمجال الافتراضي. إذا كان لديك أسماء متعددة الإشارة، يمكنك اختيار استخدام أسماء مثل المجال-1.tld, المجال-2.tldإلخ. |

للمجالات الفرعية، ونحن ننصح باستخدام اسم فيما يتصل بالدور الذي سوف يتم إرفاق هذا المجال الفرعي، ك  master.Domaine.tld , slave.Domaine.tld , BDD.Domaine.tld إلخ. |

عناوين IP

لتجنب الكشف عن الملكية الفكرية الخاصة بك في الدروس الخاصة بك وتكون واضحة قدر الإمكان، ونحن ندعوك لتلبية العناوين المحفوظة للوثائق. وفي حالتنا، نحن نفضل استخدام عناوين كتلة 203.0.113.0/24 لكل ما عنوان عمومي. أما 203.0.113.0 à 203.0.113.255.

لعناوين الشبكات المحلية ومضيف محلي، يمكنك الاحتفاظ بالملكية الفكرية التي تستخدمها عادة. وهذا يعني :

• 10.0.0.0/8 - 10.0.0.0 – 10.255.255.255
• 172.16.0.0/12 - 172.16.0.0 – 172.31.255.255
• 192.168.0.0/16 - 192.168.0.0 – 192.168.255.255
• 127.0.0.0/8 - 127.0.0.0 – 127.255.255.255

الروابط

Créer un lien

لقطات

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

ونحن نوصي التي قمت بوضع العناصر التي ذكرتها في الدهون، والتي هي في الواجهة الرسومية، أن هو زر، ارتباط، وخانة اختيار، إلخ. |

لا تنس أن تضيف وصفاً عند تشغيل الصورة على الإنترنت.

الاستنتاج

يرجى إدراج خاتمة قصيرة للبرنامج التعليمي الخاص بك الذي سيتم تلخيص ما تم إنجازه، والأخذ بما يمكن القيام به في وقت لاحق.
لديك كل ما تحتاجه لإنشاء المقالات الخاصة بك ! وبالإضافة إلى ذلك، يمكنك أيضا استشارة لدينا المادة على نمط عكلة، والكتابة الجيدة !

هذه المادة يبدو لك أن تكون مفيدة ?

0

تصويت

رتب حسب التاريخ الترتيب حسب النتيجة

تمكين المحدث التلقائي للتعليق

ليس مسموح لك بأن تنشر تعليقا.