اكتب ودع العالم يراجع عملك مع Prose.io لـ GitHub

الإعلانات

تقليديا ، الكتابة هي شأن منفرد. أنت فقط والشاشة ، أو قطعة من الورق. الرجل مقابل النص في معركة الوصايا ، الذكاء ، والعاطفة ، حتى فجأة - لقد انتهيت. حان الوقت الآن لإظهار العالم ووضع نصك هناك ومشاهدة ما يحدث. ولكن في هذه الأوقات الرقمية ، ليست هذه هي الطريقة الوحيدة لبدء الكتابة.

ماذا لو كان الكل في العراء ، طوال الوقت؟ ماذا لو استطاع العالم رؤية مراجعاتك ومتابعتها مع تقديم الاقتراحات؟ في الظاهر ، قد تبدو هذه فكرة رهيبة - ولكن بالنسبة لبعض أنواع النصوص (وبعض الكتاب) ، قد يكون مثل هذا التعاون المفتوح نعمة. النثر عبارة عن منصة نشر بسيطة عبر الإنترنت تتفاعل مع GitHub للسماح لك بتحرير النص عبر الإنترنت والاحتفاظ بالمراجعات باستخدامه شخص سخيف ما هو Git ولماذا يجب عليك استخدام التحكم في الإصدار إذا كنت مطورًاكمطورين على الويب ، نميل في كثير من الأحيان إلى العمل على مواقع التطوير المحلية ثم تحميل كل شيء عند الانتهاء. هذا جيد عندما تكون أنت والتغييرات صغيرة ، ... اقرأ أكثر .

ابدء

للعمل مع Prose ، يجب أن يكون لديك أولاً حساب GitHub. بافتراض أنك قمت بتسجيل الدخول إلى Git ، ما عليك سوى النقر فوق زر تفويض Prose:

سيسألك Git بعد ذلك عما إذا كنت متأكدًا من رغبتك في تفويض Prose. يتطلب النثر عددًا قليلاً جدًا من الأذونات ، ولكن جميعها منطقية:

بعد ذلك ، ستجد نفسك مرة أخرى في نثر ، بالنظر إلى قائمة بجميع مستودعات Git الخاصة بك:

إذا كنت مثلي ، فلن يكون أي من مستودعاتك الحالية مناسبًا لمجموعة من النصوص. بالطبع ، قد لا يكون هذا صحيحًا بالنسبة لك: على سبيل المثال ، إذا كنت تستخدم جيكل إطار النشر ، قد يكون لديك بالفعل مستودع ينتظر النص فقط. في الواقع ، يبدو أن الكثير من النثر تم تصميمه مع وضع مستخدمي Jekyll في الاعتبار: يتيح لك Prose النشر إلى Jekyll. قال ذلك ، لا تفعل بحاجة إلى Jekyll للاستفادة من النثر ، ولقد نظرت إليها دون ربطها بأي شيء آخر.

لذا ، لنبدأ ، دعونا نصنع منزلًا جديدًا لنصنا.

إنشاء مستودع جيثب جديد

لإنشاء مستودع GitHub جديد ، يجب عليك العودة إلى GitHub نفسه - وهذا ليس شيئًا يمكنك القيام به على Prose. يقترح النثر تسمية "مستندات" المستودع الجديدة ، وهذا ما فعلته.

فور إنشاء المستودع ، ظهر في Prose:

تحرير مستند

عند النقر على مستودع المستندات الجديد ، يتم الترحيب بي من خلال README.md الافتراضي لـ GitHub. MD ، في هذه الحالة ، تشير إلى Markdown - نفس التنسيق البسيط المستخدم من قبل Dillinger.io Dillinger: تحرير وعرض تخفيض السعر في الوقت الفعلي اقرأ أكثر , TextDown TextDown: احصل على محرر Markdown المدمج في Google Chrome اقرأ أكثر , اكتب Monkey WriteMonkey - محرر نص بسيط للمشتتين بسهولة اقرأ أكثر وعدد لا يحصى من المحررين الآخرين. إذا كنت تكتب نصًا للاستخدام عبر الإنترنت لأي فترة زمنية ، فمن المحتمل أنك صادفت Markdown أكثر من مرة.

بالنقر على المستند ، ظهرت واجهة تحرير بسيطة:

إنه خالٍ من أي إعلانات ، وله نظام ألوان صامت يكون سهلًا على العين. يحتوي أيضًا على تمييز بناء الجملة لـ Markdown ، وبدلاً من جزء المعاينة الفورية (مثل ذلك المستخدم في Dillinger.io) ، تتطلب معاينة النص المقدم في HTML نقرة سريعة على شريط الأدوات:

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

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

النشر (أو التوفير)

ما لم تكن تستخدم Jekyll ، فإن النشر والحفظ هو نفس الشيء إلى حد كبير: بمجرد الحفظ ، يكون النص الخاص بك ملتزمًا بمستودع GitHub. ما لم تكن مستخدمًا مدفوعًا في GitHub واخترت مستودعًا خاصًا ، فإن هذا يعني أنه يمكن للجميع رؤية النص الخاص بك. بدا الالتزام الأول على النحو التالي:

وبعد بعض الشيفرات السريعة ، بدا سجل التزام GitHub للمستودع كما يلي:

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

هذا بعيد عن كل شيء يمكن أن يفعله Prose: على سبيل المثال ، يمكنك استخدام Prose لتعديل مستند شخص آخر وإرسال طلب سحب له لقبول المراجعات - تمامًا كما يفعل المبرمجون. هناك العديد من الأشياء الأخرى التي يمكنك القيام بها باستخدام Prose ، ولكن مبدأها الأساسي لا يزال هو نفسه: Git للكتابة.

افكار اخيرة

بالنسبة لي ، يبدو النثر وكأنه دعوة أكثر من كونه أداة. دعوة للتفكير والتأليف والصياغة في العراء. للتغلب على "الخوف من النشر" من خلال النشر المستمر أثناء الكتابة ، بحيث لا يوجد أحد "لحظة الحقيقة" - كانت أفكارك موجودة في العالم طوال الوقت ، الأخطاء المطبعية والتناقضات ، وكل. هناك طرق أخرى للقيام بذلك ، من الويكي إلى عملاء Git القياسيين ، لكن Prose لا تدعي أنها فكرة حصرية - إنها فقط تعبئ الأشياء بدقة بحيث يبرز المفهوم. سواءً كانت الطريقة الصحيحة لك للكتابة هي خيار شخصي - خيار سأكون فضوليًا لسماعه ، إذا أخبرتني في التعليقات.