# مقدمة

أهلاً بك في ghostwriter! يعطي هذا المرجع السريع أمثلةً عن الكتابة بماركداون، صيغة رمزية تكتب نصاً عادياً أنشأها John Gruber. للمساعدة ومزيدٍ من المعلومات، فضلاً زُر موقع John Gruber http://www.daringfireball.net. يمكن الوصول إلى الموقع الرسمي لـ ghostwriter عبر الرابط http://www.github.com/wereturtle/ghostwriter.

يتضمن ghostwriter معالج Sundown داخلياً. لكنه يمكن تلقائياً أن يكتشف معالجات Pandoc، MultiMarkdown، Discount، cmark، cmark-gfm. ثبّت ما تريد استعماله من أيًّ من الثلاث الماضيات، أو جميعَها، وتأكّد أن يكون مسار البرامج مُضافاً للمتغير البيئيّ `PATH`. سيقوم ghostwriter بالكشف التلقائي عن تثبيتهم عند بدء تشغيله، وسيقوم بتشغيل معاينة HTML وخيارات التصدير بناءً على ذلك.

# العناوين

    # عنوان مستوى 1
    ## عنوان مستوى 2 ##
    ###### عنوان مستوى 6

    عنوان مستوى 1
    ===============
    نصٌ ما

    عنوان مستوى 2
    ---------------
    نصٌ ما إضافي

# الفقرات

    هذه فقرة.
    هذا سطرٌ يتبع الفقرة ذاتها، يفصل بينهما سطرٌ يدوي.

    هذه فقرةٌ جديدة.

# التنسيق الموضعي

يمكنك تنسيق المائل أو حتى الغامق بطريقتين. الأولى بإحاطة النص بالنجمة (*)، والثانية باستعمال الشرطات التحتية (_).

    هذا *مائل* باستعمال النجمتين.
    هذا _مائل_ باستعمال الشرطتين.

    هذا **الغامق** باستعمال النجوم.
    هذا __الغامق__ باستعمال الشرطات.

يمكنك أيضاً عمل غامقٍ مائل بمزجها ومطابقتها، كما يلي:

    هذا ***غامق مائل*** باستعمال النجوم.
    هذا **_غامق مائل_** باستعمال المزيج.
    هذا *__غامق مائل__* آخر.
    الخ.

# الروابط

يمكنك الربط إلى عدة مواقع:

    اضغط [هنا](http://url.com "عنوان") لزيارة موقع.

يمكنك كذلك استعمال الإشارات المرجعية:

    [هذه][المعرف] إشارة مرجعية ستعرف أدناه.

    [المعرف]: http://url.com "عنوان"

# الصور

يمكنك تضمين الصور كالتالي:

    ![النص البديل](./image.jpg "عنوان")

يمكنك أيضاً استعمال صيغة الإشارة المرجعية ذاتها:

    ![النص البديل][المعرف] إشارة مرجعية ستعرف أدناه.

    [المعرف]: ./image.jpg "عنوان"

# القوائم

يمكنك استعمال القوائم المرتبة:

    1. العنصر الأول.
    2. العنصر الثاني.
    3. العنصر الثالث.

أو يمكنك استعمال القوائم النقطية:

    * العنصر الأول.
    + العنصر الثاني.
    - العنصر الثالث.

يمكنك مزج القوائم وتداخلها:

    1. العنصر الأول.
        * العنصر الداخلي الأول.
        * العنصر الداخلي الثاني.
    2. العنصر الثاني.
        - العنصر الداخلي الأول.
        - العنصر الداخلي الثاني.
    3. العنصر الثالث.
        1. العنصر الداخلي الأول.

# البرامج الحاسبية

يمكنك إنشاء كتلة برنامج باستعمال تشذيب بأربع مسافات أو أكثر أو محرف جدولة:

    هذه فقرة عادية، متبوعةٌ ببرنامج.

        for (int i = 0; i < 10; i++) {
            System.out.println("i = " + i);
        }

    ستُعرض الكتلة السابقة على نسَقها الذي كُتبت فيه.

يمكنك استعمال صيغة الفواصل العُليا المائلة لماركداون Github في بعض محولات ماركداون مثل Pandoc أو Github، لتعيين كتلة البرنامج، بدلاً من تشذيب الكتلة، كالتالي:

    ```
    for (int i = 0; i < 10; i++) {
        System.out.println("i = " + i);
    }
    ```

ستُعرض الكتلة السابقة كذلك على نسَقها الذي كُتبت فيه.

# الرموز البرمجية

يمكنك استعمال الفواصل العُليا المائلة في أثناء الفقرات لتعيين رمز برمجي، مثلاً هذا وسم ``<html>``. ويمكنك ذكر الفاصلة العُليا ذاتها في الرمز البرمجي باستعمال أكثر من فاصلة، كما في هذا المثال: ``` `فاصلة حرفية` ```.

# الاقتباسات

يمكنك استعمال أسلوب أقواس زوايا البريد الإلكتروني لتعيين الاقتباسات، كالتالي:

    > هذا اقتباس.
    >
    >> هذا اقتباس مضمن داخل اقتباس.

# الأسطر

استعمل ثلاثاً أو أكثر من الشرطات (-)، أو الشرطات التحتية(_)، أو النجوم(*) لإنشاء سطر أفقي، كالتالي:

    ---

    ***
    ___

يمكنك أيضاً ترك فراغات بين كل محرف:

    - - -

# إضافات ماركداون

تضيف بعض معالجات ماركداون صيغ للجداول، والحواشي، وغيرها، لإضافة وظائف لمعايير ماركداون الأصلية التي وضعها John Gruber. في الأسف مثال عن استعمال حاشية لـ Pandoc، MultiMarkdown، وغيرها من المعالجات التي تدعم الإضافة:

    هذا النص الأصلي الذي يحتوي الحاشية.[^id]

    [^id]:  هنا نص الحاشية.

أدناه نموذج عن جدول Pandoc:

    العمود الأول     العمود الثاني
    ----------     ----------
    نص السطر 1     نص السطر 2
    نص السطر 1     نص السطر 2

    جدول:  نموذج جدول Pandoc.

أدناه نموذج عن جدول Sundown أو MultiMarkdown:

العمود الأول | العمود الثاني
--- | ---
نص السطر 1 | نص السطر 2
نص السطر 1 | نص السطر 2

هناك المزيد من صيغ الجداول التي يمكن أن تدعمها معالجات ماركداون هذه. وهناك الكثير من الإضافات الأخرى. لمزيد من المعلومات عن هذه المعالجات، زُر المواقع التالية:

- Sundown: http://github.com/vmg/sundown/
- Pandoc: http://johnmacfarlane.net/pandoc/
- MultiMarkdown: http://fletcherpenney.net/multimarkdown/
- Discount: http://www.pell.portland.or.us/~orc/Code/discount/
- cmark: http://github.com/jgm/cmark/
- cmark-gfm: http://github.com/github/cmark

يمكن الاطلاع على المعايير الأصلية لماركداون John Gruber على الرابط http://daringfireball.net/projects/markdown/.

# اختصارات Ghostwriter

يدعم ghostwriter عدة مفاتيح اختصارات لتحرير ماركداون:

`Ctrl+B` : تطبيق تنسيق الغامق (الثخين).

`Ctrl+I` : تطبيق تنسيق المائل (التوكيد).

`Ctrl+K` : تطبيق تنسيق في وسطه خط.

`Ctrl+/` : مفتاح التحكم `Ctrl` مع مفتاح `/` يُضيف تعليق HTML عند موضع المُشيرة، أو سيحول النص المحدد إلى تعليق HTML.

`Tab` : عند ضغط مفتاح الجدولة بوجود نص محدد سيُباعد الأسطر عن أوائلها.

`Shift+Tab` : عند ضغط مفتاح الجدولة مع مفتاح `Shift` معاً بوجود نص محدد سُقارب الأسطر إلى أوائلها.

`Shift+Enter` : إدراج فاصل أسطر ماركداون.

`Ctrl+Enter` : إدراج فاصل أسطر كالعادة، غير أن مباعدة الأسطر لن تُأخذ بالحُسبان. بعبارة أخرى، لو أنك تكتب في نص مُشذب ثم ضغطت `Ctrl+Enter`، لن يُشذب السطر الجديد. لاحظ أنك يمكنك مزج المفتاحين `Ctrl` و `Shift` لإنتاج سطر ماركداون غير مُشذّب.

`Ctrl+.` : ضغط مفتاح `Ctrl` مع رمز `.` سيحول السطر أو الأسطر المحددة إلى كتلة اقتباس.

`Ctrl+,` : ضغط مفتاح `Ctrl` مع رمز `,` سيحذف جميع صيغ الاقتباس من السطر أو الأسطر المحددة من النص.

`Ctrl+8` : ضغط المفتاح `Ctrl` مع رمز `8` سيحول السطر أو الأسطر المحددة إلى قائمة نقطية باستعمال العلامة `*`. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        عنصر القائمة الأول.
        عنصر القائمة الثاني.

    فضغط `Ctrl+8`  سيحول الأسطر المحددة إلى قائمة نقطية كالتالي:

        * عنصر القائمة الأول.
        * عنصر القائمة الثاني.

`Ctrl+Shift+-` : ضغط متاحي `Ctrl` و `Shift` معاً مع رمز `-` سيحول السطر أو الأسطر المحددة إلى قائمة نقطية باستعمال العلامة `-`. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        عنصر القائمة الأول.
        عنصر القائمة الثاني.

    فضغط `Ctrl+Shift+-` سيحول الأسطر المحددة إلى قائمة نقطية كالتالي:

        - عنصر القائمة الأول.
        - عنصر القائمة الثاني.

`Ctrl+Shift+=` : ضغط متاحي `Ctrl` و `Shift` معاً مع رمز `=` سيحول السطر أو الأسطر المحددة إلى قائمة نقطية باستعمال العلامة `+`. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        عنصر القائمة الأول.
        عنصر القائمة الثاني.

    فضغط `Ctrl+Shift+=` سيحول الأسطر المحددة إلى قائمة نقطية كالتالي:

        + عنصر القائمة الأول.
        + عنصر القائمة الثاني.

`Ctrl+1` : ضغط المفتاح `Ctrl` مع رمز `1` (الرقم 1) سيحول السطر أو الأسطر المحددة إلى قائمة مرتبة باستعمال العلامة `.`. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        عنصر القائمة الأول.
        عنصر القائمة الثاني.

    فضغط `Ctrl+1` سيحول الأسطر المحددة إلى قائمة مرتبة كالتالي:

        1. عنصر القائمة الأول.
        2. عنصر القائمة الثاني.

`Ctrl+0` : ضغط المفتاح `Ctrl` مع رمز `0` سيحول السطر أو الأسطر المحددة إلى قائمة مرتبة باستعمال العلامة `)`. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        عنصر القائمة الأول.
        عنصر القائمة الثاني.

    فضغط `Ctrl+0` سيحول الأسطر المحددة إلى قائمة مرتبة كالتالي:

        1) عنصر القائمة الأول.
        2) عنصر القائمة الثاني.

`Ctrl+T` : ضغط `Ctrl+T` سيحول السطر أو الأسطر المحددة إلى قائمة مهمات صيغة ماركداون Github. مثلاً، إن كان النص المحدد لديك الأسطرُ التالية:

        شيءٌ هام للقيام به.
        شيءٌ هام آخر للقيام به.

    فضغط `Ctrl+T` سيحول الأسطر المحددة إلى قائمة مهمات كالتالي:

        - [ ] شيءٌ هام للقيام به.
        - [ ] شيءٌ هام آخر للقيام به.

`Ctrl+D` : عندما يكون السطر الحالي من قائمة مهمات صيغة ماركداون Github، ضغط `Ctrl+D` سيبدّل حالة اكتمال المهمة بوضع `x` في صندوق الاختيار، أو حذف الـ `x` في حال عدم اكتمالها. مثلاً:

        - [ ] هذه مهمة غير مكتملة.
        - [x] `Ctrl+D` سيجعل هذه المهمة مكتملة!

`"`, `'`, `(`, `[`, `{`, `*`, `_`, ```, `<` : عند استعمال أحد هذه الرموز بوجود نص محدد في سطر وحيد، سيقوم البرنامج بإحاطة النص المحدد بالرمز ومطابقه. مثلاً، لو حددت الكلمة `dog` ثم ضغطت الرمز `(`، فستُحاط الكلمة `dog` بقوسين لتصير `(dog)`. يُظهر الجدول أدناه كل محرفٍ ومطابقه:

الافتتاح | الإغلاق
--- | ---
`"` | `"`
`'` | `'`
`(` | `)`
`[` | `]`
`{` | `}`
`*` | `*`
`_` | `_`
``` | ```
`<` | `>`

لتشغيل المطابقة التلقائية أثناء الكتابة، اختر “مطابقة الأقواس تلقائياً” من لسان “المحرر” في نافذة التفضيلات. يمكنك كذلك تخصيص المحارف المتطابقة بنقر “تخصيص المحارف المتطابقة…” من نافذة التفضيلات.

سحب وإفلات ملفات الصور: : بدلاً من اختيار “إدراج صورة…” من قائمة تحرير، يمكنك سحب وإفلات أي ملف صورة من نظام الملفات في نافذة المحرر. سيدرج التطبيق صورة مضمنة مسارها نسبيّ بالنسبة إلى مسار المستند الحالي، أو بمسارٍ مُطلق إلى كان المستند بدون عنوان. مثلاً:

        ![](../../relative/path/to/your/file.png)

    أو إذا كان الملف بدون عنوان:

        ![](file:///full/path/to/your/file.png)

Copyright © 2014-2017 wereturtle