تنسيق التعليمات البرمجية

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

تنسيق التعليمات البرمجية يدويًا

  1. افتح ملفًا مدعومًا.

  2. حدد Edit > Code > Apply Source Formatting.

    أو حدد Apply Source Formatting من Common Toolbar > Format Source Code.

تنسيق التعليمات البرمجية المحددة في ملف يدويًا

  1. افتح التعليمات البرمجية.

  2. حدد التعليمة البرمجية.

  3. حدد Edit > Code > Apply Source Formatting To Selection.

    أو حدد Apply Source Formatting للتحديد من Common toolbar-> Format Source Code.

    ملاحظة:

    إذا قمت باختيار تعليمات برمجية بين أي علامة وقمت بتطيق تنسيق المصدر على التحديد، يتم تطبيق التنسيق حتى العلامة الأصل.

تحرير القواعد الافتراضية لتنسيق التعليمات البرمجية

يمكنك تنسيق التعليمات البرمجية بلغات CSS وJS وPHP من خلال إضافة قواعد التنسيق في ملفjsbeautifyrc الموجود في المجلد الجذر للموقع.

ولإضافة ملف .jsbeautifyrc اتبع الخطوات التالية:

ملاحظة:
  • يتم تطبيق التعليمات التالية لمستندات CSS وJS وPHP فقط.
  • يتم تنسيق علامات HTML في مستند PHP حسب التفضيلات في مكتبات العلامات.  ويمكن تنسيق التعليمات البرمجية داخل مقاطع PHP من خلال التعليمات التالية.
  1. قم بإنشاء ملف جديد في جذر الموقع بحيث يكون اسم الملف .jsbeautifyrc

  2. انسخ قواعد التنسيق الافتراضية أدناه للغات CSS وJS وPHP والصقها في ملف .jsbeautifyrc ثم احفظ الملف.

    { 
     
        "js": { 
     
            "eol": "\n", 
     
            "preserve_newlines": true, 
     
            "max_preserve_newlines": 3, 
     
            "space_after_anon_function": true, 
     
            "keep_array_indentation": false, 
     
            "space_before_conditional": true, 
     
            "break_chained_methods": false, 
     
            "unescape_strings": false, 
     
            "wrap_line_length": 0, 
     
            "end_with_newline": true, 
     
            "comma_first": false, 
     
            "operator_position": "after-newline" 
     
        }, 
     
        "css": { 
     
            "preserve_newlines": false, 
     
            "selector_separator_newline" : false, 
     
            "end_with_newline": false, 
     
            "newline_between_rules": false, 
     
            "space_around_selector_separator": true 
     
        }, 
     
        "php": { 
     
            "eol": "\n", 
     
            "preserve_newlines": true, 
     
            "max_preserve_newlines": 3, 
     
            "space_after_anon_function": true, 
     
            "brace_style": "collapse", 
     
            "keep_array_indentation": false, 
     
            "space_before_conditional": true, 
     
            "break_chained_methods": false, 
     
            "unescape_strings": false, 
     
            "wrap_line_length": 0, 
     
            "end_with_newline": false, 
     
            "comma_first": false, 
     
            "space_in_paren":true 
     
        } 
     
    }
  3. قم بتحرير القواعد الافتراضية لتغيير قواعد تنسيق التعليمات البرمجية الافتراضية حسب الجدول أدناه وقم بحفظ التغييرات.

ملاحظة:

إذا كنت تريد تخصيص تنسيق التعليمات البرمجية لملفات PHP وCSS وJS في مواقع Dreamweaver أخرى، فستكون بحاجة إلى وضع الملف المخصص .jsbeautifyrc في المجلد الجذر للموقع.

قواعد تنسيق CSS وJS وPHP:

CSS القواعد القيم الافتراضية في Dreamweaver الوصف
  preserve_newlines false لتحديد الاحتفاظ بالسطور الفارغة من عدمه.
selector_separator_newline false

لتحديد وضع سطر جديد بين المحددات المفصولة بفاصلة من عدمه.

على سبيل المثال: ".div, .P"

end_with_newline false لتحديد إنهاء الملف بسطر فارغ أم لا.
newline_between_rules false لتحديد إضافة سطر جديد بعد كل قاعدة CSS من عدمه.
space_around_selector_separator true

لضمان وجود مسافة حول فواصل المحددات:  '>', '+', '~'

على سبيل المثال: "a>b" ستكون "a > b" عند تطبيق تنسيق المصدر.

JS القواعد القيم الافتراضية في Dreamweaver الوصف
  "eol" "\n" حرف يستخدم لبيان نهاية السطر.
preserve_newlines true لتحديد الاحتفاظ بالسطور الفارغة من عدمه.
max_preserve_newlines 3

لـ "max_preserve_newlines": N،

يتم الاحتفاظ بأسطر N-1 الفارغة عند تطبيق التنسيق، عند وجود أكثر من N-1 من الأسطر الفارغة في ملف JS.

ملحوظة: ينطبق max_preserve_newlines فقط إذا تم تعيين preserve_newlines إلى true.

space_after_anon_function true

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

على سبيل المثال:"function()" ستكون "function ()" عند تطبيق تنسيق المصدر.

keep_array_indentation false السماح بسطر جديد داخل نص الصفيف أو الاحتفاظ به.
space_before_conditional true

لتحديد إضافة مسافة قبل عبارة شرطية من عدمه

على سبيل المثال: "‎if(true)‎‏" ستكون "‎if (true)‎‏" عند تطبيق تنسيق المصدر.

break_chained_methods false

السماح بسطر جديد بين الدالات المتسلسلة أو الاحتفاظ به.

على سبيل المثال:

`foobar().baz()`

unescape_strings false

في حالة عدم تجاوز الحروف القابلة للطباعة في السلاسل التي تم ترميزها في علامة \xNN.

على سبيل المثال:

"\x65\x78\x61\x6d\x70\x6c\x65" ستكون "example" عند تطبيق تنسيق المصدر.

wrap_line_length 0 ينبغي التفاف السطور عند الفرصة التالية بعد عدد من الأحرف.
end_with_newline true

لضمان إضافة سطر جديد في نهاية الملف.

comma_first false أثناء عمل فاصل لسطر عند فاصلة، تستخدم هذه العلامة لضمان وجود الفاصلة عند أول حرف من السطر.
operator_position after-newline

إذا تم فصل عبارة شرطية طويلة إلى سطور عديدة، يستخدم هذه العلامة لتحديد موضع عوامل التشغيل في السطور.

ويمكنك تحرير العلامة من خلال القيم التالية:

  • before-newline
  • after-newline
  • preserve-newline
ملاحظة:

قواعد تنسيق PHP هي نفس قواعد تنسيق JS (الموضحة في الجدول أعلاه) من خلال قاعدتين إضافيتين موضحتين أعلاه:

PHP القواعد القيم الافتراضية في Dreamweaver الوصف
  brace_style collapse

يمكنك التحكم في موضع الأقواس المتعرجة من خلال هذا الخيار:

على سبيل المثال:

function f() {

// code

}

أو 

function f()

{

// Code

}

يمكنك تعيين القيم التالية:

  • "collapse" - لوضع الأقواس المتعرجة في نفس سطر عبارات التحكم
  • "expand" - لوضع الأقواس المتعرجة في سطر خاص بها (نمط Allman / ANSI)
  • "end-expand" - لوضع الأقواس المتعرجة في سطر خاص بها
  • "none" - لمحاولة الاحتفاظ بها في مكانها
  • يحاول أيّ من + ",preserve-inline"- preserve-inline السابقة الاحتفاظ بالمقاطع الضمنية للأقواس المتعرجة
space_in_paren true

لتحديد إضافة المسافات داخل الأقواس.

على سبيل المثال:

include('header.php')

ستكون

include( 'header.php' ) عند تطبيق التنسيق

احصل على مساعدة بشكل أسرع وأسهل

مستخدم جديد؟