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

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

مقدمة

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

يفيد سير العمل هذا الكتّاب الذين يفضلون واجهة Word وميزاته المألوفة مع الاستفادة من GitHub للتحكم في الإصدارات والتعاون الجماعي.

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

يظهر مستند Markdown الذي يتم دفعه إلى مستودع الويكي كصفحة جديدة على الويكي.

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

التعليمات

إعداد Writage

  1. اتبع مطالبات التثبيت لإعداد الوظيفة الإضافية Writage.

رسم يوضح عملية تثبيت Writage

استخدام Writage في Microsoft Word

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

رسم يوضح واجهة Writage في Microsoft Word

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

لا يقوم GitHub Desktop باستنساخ ويكي المستودع تلقائيًا. يجب استنساخ مستودع الويكي يدويًا.

  1. افتح الويكي على GitHub وانسخ عنوان URL للاستنساخ من الزاوية السفلية اليمنى للصفحة.

    لقطة شاشة للصفحة الرئيسية لهذا الويكي

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

  3. انقر فوق علامة التبويب URL.

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

    لقطة شاشة لمربع حوار الاستنساخ في GitHub Desktop

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

بعد كتابة مستند Markdown في Word، يمكنك دفعه مباشرة إلى مستودع ويكي GitHub الخاص بك. يغنيك ذلك عن نسخ ولصق وتنسيق المحتوى في محرر ويب GitHub.

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

  2. افتح تطبيق GitHub Desktop.

  3. حدد مستودع الويكي.

  4. أدخل ملخص تثبيت (commit) موجزًا، ثم انقر فوق Commit to main أو Commit to master.

    ملاحظة

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

    لقطة شاشة لمربع حوار التثبيت في GitHub Desktop

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

  6. افتح الويكي في متصفح الويب للتحقق من الصفحة المنشورة.

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

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

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