Documentation 0.1

Common Content

نسخة 0

Dude McDude

My Org Best Div in the place

ملاحظة قانونية

Copyright © 2009 Red Hat, Inc.. This material may only be distributed subject to the terms and conditions set forth in the Open Publication License, V1.0, (the latest version is presently available at http://www.opencontent.org/openpub/).
Fedora and the Fedora Infinity Design logo are trademarks or registered trademarks of Red Hat, Inc., in the U.S. and other countries.
Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat Inc. in the United States and other countries.
All other trademarks and copyrights referred to are the property of their respective owners.
Documentation, as with software itself, may be subject to export control. Read about Fedora Project export controls at http://fedoraproject.org/wiki/Legal/Export.

(preface title goes here)

1. أعراف الوثيقة

هذا الكتيب يستخدم عدد من الأعراف لإبراز كلمات أو جملة معينة ولجلب الانتباه لمعلومة معينة.
نسخة PDF والنسخة المطبوعة تستخدم خطوط من Liberation Fonts (لا تدعم العربية). وقد تم تحديدها كي تستخدم في نسخة HTML إن كانت مثبتة على حاسبك. وإلا فإنها تعرض بخطوط بديلة لكن من نفس السمة العامة. ملاحظة: تتوفر هذه الخطوط في ريدهات إنتربرايز لينكس 5.

1.1. الأعراف الطباعية

هناك أربع أعراف طباعية تستخدم في جلب الانتباه لكلمات أو عبارات معينة. إليك تاليا الأعراف والظروف التي تنطبق عليها.
ثخين ثابت العرض Mono-spaced Bold
يستخدم في توضيح مدخلات إلى النظام. بما في ذلك الأوامرـ أسماء الملفات والمسارات. كما وتستخدم في إظهار المفاتيح. مثلا:
لمشاهدة محتويات الملف my_next_bestselling_novel الموجود في الدليل (المجلد) الحالي اكتب الأمر‪ cat my_next_bestselling_novel ‬في المحث واضغط Enterلتنفيذ الأمر.
ما ذكر أعلاه يشتمل على اسم الملف file name مسبوقا بأمر shell command متبوعا بضغط مفتاح key capتظهر كلها بخط ثخين ثابت العرض mono-spaced ونستطيع التمييز بينها بفضل السياق.
يمكن تمييز تركيب المفاتيح Key-combinations من المفتاح المفردة عبر الشرطة التي تربط كل مفتاح من المجموعة المركبة. مثلا:
اضغط ENTER لتنفيذ الأمر.
اضغط ‪Ctrl+Alt+F1‬ للتبديل إلى الطرفية الافتراضية الاولى. اضغط ‪Ctrl+Alt+F7‬ للعودة إلى جلسة نظام نوافذ إكس.
الجملة الأولى تحدد المفتاح الذي تضغطه. الثانية توضح مجموعتين من تركيب المفاتيح كل تركيب تضغط مفاتيحه معا.
إن كنا نتحدث عن كود مصدري فإن أسماء الصنوف والطرق والدوال والمتغيرات والقيم المعادة داخل الفقرة ستظهر كما ظهرت أعلاه بحظ ثابت العرض ثخين Mono-spaced Bold. مثلا:
الصنوف المتعلقة بالملفات تتضمن filesystem لنظام الملفات، file للملفات، و dir للأدلة (المجلدات)، وكل صنف له ما يرتبط به من الصلاحيات.
ثخين متناسب
هذا يرمز لكلمات أو عبارات تواجهك في النظام بما في ذلك أسماء التطبيقات النص الموجود في صناديق الحوار أو عناوين الازرار أو القوائم مثلا
اختر نظام > تفصيلات > الفأرة من القائمة الرئيسيةلتشغيل تفضيلات الفأرة.وفي تبويب أزرار الفأرة،ضع علامة على فأرة أعسر ثم انقر إغلاق لتبديل زر الفأرة الأساسي من الأيسر إلى الأيمن (مما يجعل الفأرة مناسبة للإنسان الأعسر).
لإضافة محرف خاص إلى ملف على gedit، اختر تطبيقات > ملحقات > خارطة المحارف من شرط القائمة الرئيسية.ثم، اختر بحث > بحث… من قائمة برنامج خارطة المحارف ثم اكتب اسم المحرف في حقل بحث ثم انقر التالي. المحرف الذي تبحث عنه سيتم تحديده في جدول المحارف. انقر على المحرف المحدد نقرا مزدوجا لوضعه في حقل النص المطلوب نسخه و انقر على زر نسخ. الآن انتقل إلى الوثيقة واختر تحرير > لصق من قائمة برنامج gedit.
النص أعلاه يتضمن أسماء تطبيقات قوائم النظام ومدخلاتها وقوائم خاصة بكل تطبيق وأزرار ونصوص أخرى في الواجهة الرسومية كلها ظهرت بخط ثغين متناسب ونميز بينها من السياق.
لاحظ أن العلامة > لبيان النتقال من قائمة إلى قائمة فرعية. لأنه من الصعب تتبع الإرشادات التي تكون على شاكلة 'اختر الفأرة من قائمة تفضيلات المتفرعة عن قائمة النظام الموجودة في شريط القوائم الرئيسية'.
ثخين ثابت العرض مائل Mono-spaced Bold Italic أو ثخين متناسب مائل Proportional Bold Italic
سواء كان ثخين ثايت العرض أو ثخين متناسب، إن كان مائلا فإنه يعبر عن جزء يجب تبديله أو نص متغيّر. فالمائل لا تكتبه كما هو أو لا يعرض كما هو بل يعتمد على الظروف مثلا:
للاتصال بجهاز بعيد عبر ssh، اكتب ssh username@domain.name في محث سطر الأوامر. فإن كان الجهاز البعيد هو example.com واسمك عليه هو john، اكتب ssh john@example.com.
الأمر mount -o remount file-system يعمل على إعادة ضم نظام الملفات المسمى. مثلا، لإعادة ضم نظام الملفات ‪ /home ‬ الأمر هو mount -o remount /home.
لمعرفة إصدار حزمة مثبتة استخدم الأمر rpm -q packageوهو يعطيك: package-version-release.
لاحظ الكلمات الثخينة المائلة أعلاه مثل — username و domain.name و file-system و package و version و release. كل واحدة منها توضح لك المكان الذي تضع فيه تلك القيم أو الذي يظهر فيه.
وبعيدا عن الاستخدام القياسي لتمثيل العناوين، المائل يستخدم لتعين أول ظهور لحد (أي مصطلح) جديد. مثلا:
عندما يستقبل خادم HTTP أباتشي طلبا، فإنه يفرع عمليات child processes أو خيوط معالجة threads. هذه المجموعة من العمليات أو الخيوط تعبر باسم server-pool. في الإصدار 2.0 من خادم HTTP أباتشي فإن مهمة إنشاء هذه البرك pools تم تجريدها في مجموعة من الوحدات تسمى Multi-Processing Modules (أو MPMs للاختصار). وبعكس الوحدات الاخرى لا يمكن تحميل إلا واحدة واحدة من بين وحدات هذه المجموعة.

1.2. أعراف الاقتباسات المقتطعة Pull-quote

إثنان من الأنواع الشائعة متعددة الأسطر تظهر بصريا مختلفة عن النص المحيط
مخرجات مرسلة للطرفية تُصف بالخط الرومي ثابت العرض c Mono-spaced Roman لذا تظهر هكذا:
books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs
الكود المصدري يظهر يُصف أيضا بالخط الرومي ثابت العرض Mono-spaced Roman لكنه قد يعرب ويميز هكذا:
package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient
{
   public static void main(String args[]) 
       throws Exception
   {
      InitialContext iniCtx = new InitialContext();
      Object         ref    = iniCtx.lookup("EchoBean");
      EchoHome       home   = (EchoHome) ref;
      Echo           echo   = home.create();

      System.out.println("Created Echo");

      System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
   }
   
}

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

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

ملاحظة

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

مهم

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

تحذير

يجب أن لا نهمل التحذيرات. إهمالها غالبا ما يؤدي إلى خسارة بيانات.

2. راسلونا!

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