إنتقل إلى المحتوى الرئيسي

سير العمل من Microsoft Word إلى ويكي GitHub باستخدام Writage

مقدمة​

يوضح هذا الدليل كيفية كتابة صفحات ويكي GitHub وتحريرها في Microsoft Word باستخدام الوظيفة الإضافية Writage. استخدم سير العمل هذا إذا كنت تفضل أدوات التحرير في Word وتريد أن يتتبع GitHub كل تعديل على الصفحة.

تضيف Writage دعم Markdown إلى Microsoft Word. يمكنك فتح ملفات Markdown وتحريرها وحفظها داخل Word. كل ملف Markdown تدفعه إلى مستودع الويكي يصبح صفحة على الويكي، ويحدد اسم الملف اسم الصفحة.

المتطلبات الأساسية​

التعليمات​

ملاحظة

تستخدم الخطوات اختصارات Windows. على macOS، اضغط على Cmd حيث تشير الخطوات إلى Ctrl.

إعداد Writage​

  1. شغّل برنامج تثبيت Writage واتبع المطالبات.

    برنامج تثبيت Writage مع خيارات التثبيت الافتراضية

  2. افتح Microsoft Word وتأكد من ظهور علامة التبويب Writage على الشريط.

Writage في Microsoft Word​

بعد تثبيت الوظيفة الإضافية، يتعامل Word مع ملفات Markdown مثل أي مستند آخر. يمكنك فتح ملف Markdown موجود أو إنشاء ملف جديد.

  1. انقر فوق File > Save As.
  2. حدد Markdown في قائمة تنسيقات الملفات.
  3. سمِّ الملف باسم صفحة الويكي التي تريد إنشاءها.

علامة تبويب Writage على شريط Word مع أنماط Markdown

استنساخ ويكي GitHub إلى GitHub Desktop​

لا يستنسخ GitHub Desktop ملفات الويكي مع المستودع. استنسخ الويكي بنفسك.

  1. افتح الويكي في المتصفح، ثم انسخ العنوان من قسم Clone this wiki locally.

    صفحة ويكي GitHub مع عنوان استنساخ الويكي

  2. في GitHub Desktop، اضغط على Ctrl+Shift+O لفتح مربع حوار Clone a repository.

  3. الصق عنوان الويكي، ثم انقر فوق Clone.

    مربع حوار Clone a repository في GitHub Desktop مع حقل العنوان

دفع مستند Markdown إلى ويكي GitHub​

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

  1. احفظ ملف Markdown في المجلد المحلي الذي استنسخت فيه مستودع الويكي.

  2. افتح GitHub Desktop وحدد مستودع الويكي.

  3. أدخل ملخص تثبيت موجزًا، ثم انقر فوق Commit to main. إذا كان الويكي يستخدم فرعًا افتراضيًا آخر، يعرض الزر اسم ذلك الفرع.

    ملاحظة

    اكتب ملخصًا يشرح التغيير، حتى لا يحتاج الآخرون إلى فتح الملف.

    حقل ملخص التثبيت وزر التثبيت في GitHub Desktop

  4. اضغط على Ctrl+P، أو انقر فوق Push origin، لدفع التغييرات.

  5. افتح الويكي في المتصفح للتحقق من الصفحة الجديدة.

كرر هذه الخطوات لكل مستند جديد أو لكل تعديل على صفحة موجودة.

تحويل مستند Markdown إلى ملف PDF​

  1. افتح مستند Markdown في Word.
  2. انقر فوق File > Save As.
  3. حدد PDF في قائمة تنسيقات الملفات.
  4. اختر مجلد الوجهة، ثم انقر فوق Save.