بعد آخر ، الفوقية الفوقية. نتعلم الكتابة على هبر

- مدرب ، ولكن أبعد ما يكون عن الإفراج؟
- نعم ، بضع التنضيد.

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

سأتحدث عن كيفية الانتقال من ترميز HTML في محرر Habra إلى تخطيط ذي مغزى وتصميم النشر السريع والتعاون المثمر. هنا عن تجربتي في Yandex.Money وكيف قمت بتنظيم العمل على habratexts بحيث لا يكون مؤلمًا بشكل مؤلم.

الأنماط هي كل شيء لدينا

سأبدأ بشيء ليس الأكثر وضوحًا لمثل هذا المنشور.

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

القائمة التي لا أحد يعرف كيفية استخدامها

خلاصة القول بسيطة - تقوم بإعداد جزء من النص بالطريقة الصحيحة ، وحفظ القالب ثم قم بتطبيقه حيثما تريد. يسمى هذا القالب نمطًا في Word و Google Docs. الطلاب الذين يشكلون الدبلوم في الأنماط أكثر سعادة بنسبة 90٪ من أولئك الذين قاموا بتغيير الخط والمسافة البادئة وكل شيء آخر يدويًا لكل فقرة ويتجهون إلى مائة صفحة من النص.

مع Habr ، بالطبع ، كل شيء أبسط - إنه يكفي لفهم بنية مقالك وترتيب عناوين المستوى المطلوب. التعامل مع هذا أمر بسيط للغاية - h1 و h2 و h3 و h4 - كما في html.

تعامل مع marcdown

إذا لم تكن فجأة بعد.

تخفيض السعر هو كيان أخافني منذ ظهوره في محرر هابرا. بدا الأمر وكأنه شيء معادي وعلى عكس علامات HTML المعتادة وصد بالكامل من نفسه. لقد أظهرت الممارسة أنه من الأفضل اختيار أحد الخيارين.

حتى إذا كنت تكتب في محرر Habr المدمج (على الرغم من أن الإدارة لا تنصح بالقيام بذلك) ، فسوف يوفر لك تخفيض السعر الكثير من الوقت والجهد. على الرغم من أنه من الأفضل بالطبع اختيار أداة أخرى. محرر Habra مناسب للمعاينة الصحيحة وهذا كل شيء.

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

أين تكتب؟

اكتب المكان المناسب لك. الشيء الوحيد الذي يجب تذكره: إنه ملائم للكتابة! = ملائم للطباعة على حبر. إذا كانت vim ملائمة لك ، فاستمر في الحديث ، وسأتحدث عن طرق أكثر تحفظًا لكتابة النصوص وكيف يمكن تطبيقها على Habré.

في Yandex.Money ، نكتب بطرق مختلفة - لدى المؤلفين المختلفين محررات نصية مألوفة مختلفة ، وأحاول ألا أجبرهم كثيرًا. يرسل بعض المؤلفين مستندات نصية على Yandex.Disk أو عن طريق البريد ، بينما يكتب آخرون على الفور في السوق أو في خدمات للتحرير المشترك.

مرئي ستوديو رمز (أو سامية)

اكتب هذا النص (ومعظم النصوص الأخرى) في رمز VS ، مباشرة في السوق. النصف الأيسر من الشاشة مخصص للنص ، والنصف الأيمن هو عرض النص المكوّن في Markdown من خلال المكون الإضافي المقابل. يسمى البرنامج المساعد Markdown MPE Preview - وهو يدعم تنزيل الصور من جهاز كمبيوتر لتخيل وإدراج روابط في المكان المناسب في النص.

بعد آخر ، الفوقية الفوقية

يمكن أن يلومني بعض الرجال الذين يكتبون - يقولون ، النص السامي 3 أفضل. أعرف بالتأكيد أن هناك أيضًا كل شيء هناك للعمل مع marqdown - استخدمه إذا كنت تفضل ذلك. حسنًا ، بشكل عام ، هناك العشرات ، إن لم يكن مئات المحررين ، لجميع المنصات ولكل ذوق. الشيء الرئيسي هو أن تكتب جيدا :)

مايكروسوفت وورد

إذا كان لديك جهاز كمبيوتر يعمل بنظام Windows ، فعلى الأرجح يكون Word مثبتًا هناك. والمؤلفون المشاركون (إذا كان لديك مؤلفين مشاركين) ، على الأرجح أيضًا. هذه أداة عادية ومألوفة بالنسبة لمعظم الناس ، وإن كانت مدفوعة.

المشكلة هي أنه في Word (إذا لم يكن لديك اشتراك ملكي) ، لا يمكنك تحرير المستندات معًا ، مما يعني أنه سيتم تقليل العمل إلى Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx. هذا الألم ، حسب علمي ، يطارد بعض المصممين والرسامين وغيرهم من الرجال "المصححين".

ولكن حتى هذا ليس مخيف جدا. المشكلة الرئيسية هي أنه بدون الرقص الشعائري لن ترى النص بالطريقة التي سيبدو بها على الموقع. في البداية يبدو أن هذه ليست مشكلة كبيرة. يأتي الوعي بالكوارث بعد الساعات القليلة الأولى التي قضاها في نقل النص من ملف Word.

بصراحة ، لست على دراية بأي محولات عامة من doc إلى تخفيض السعر ، والتي يقبلها Habr عادةً. لا أشك في وجودها ، لكن كتابات Yandex.Money في Word ، إذا كانت مكتوبة ، هي فقط من قبل بعض المؤلفين ، ثم تتحول بسرعة إلى تخفيض.

مستندات جوجل

شيء ممتاز معروف ، مجانا أيضا. قدر الإمكان جاهز للعمل المشترك للعديد من المؤلفين والمحررين وغيرهم من المتعاطفين. الوظيفة كافية لأي شيء. يتطلب حساب Google ، ولكن من ليس لديه حساب الآن؟

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

هنا ، كما في Word ، يكفي وضع العناوين ، ثم عند التصدير لن تضطر إلى القيام بالكثير من العمل غير الضروري.

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

ماذا يحدث

لا يزال هناك عالم لا يصدق من النصوص في ملفات النص مع المسافة البادئة في ثلاثة إلى خمسة مسافات. لأسباب أخلاقية ، لا يمكنني إظهارها (أخشى أن أفتحها بنفسي) ، لكن صدقوني - جميع الخيارات المذكورة أعلاه أفضل بالتأكيد.

كيف لتحسين حياتك

مصور

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

يتم عرض ميزة إضافية إضافية من marqdown هنا - إذا قمت بإسقاط قاعدة بيانات Google بالكامل أو ملف Word مكتمل في الطابعة ، فسيظل الإخراج يحصل على نص عادي. سوف تضيع الصور أيضا. ولكن لا توجد مشكلة في تخفيض السعر - يتم إنشاء التخطيط بعد ذلك ، وتكون الصور روابط ، لذلك يمكنك القيام بذلك بأي كمية ، فقط لديك الوقت للضغط على Ctrl + A.

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

الخافرون

يمكن نقل النص من محرّر مستندات Google بطرق مختلفة - باليد أو من خلال محولات مختلفة. لم أتطابق مع المثالية حتى الآن ، لذلك عادةً ما أقوم بدمج وظائف اثنين جيدين.

الأول هو https://shirixae.imtqy.com/habraconverter-v2/ . انسخ Google Dock بالكامل في مربع النص - هذا كل شيء. يقوم بإنشاء تخفيض سعر مناسب إذا كنت تتذكر تعيين الرؤوس. من الجيد أيضًا سحب الروابط إلى الصور من google-dock - بالطبع ، يجب إعادة تحميلها على Habrastorage ، ولكن أفضل من لا شيء.

والثاني هو ملحق Docs To Markdown . يولِّد أفضل كود تخفيض ، ويعمل بشكل جيد مع فواصل الأسطر ، لكنه لا يعرف عن الصور.

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

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

عندما أقوم بتحرير نص العديد من المؤلفين ، أقوم بذلك - أقوم بنقل النص من المحول الثاني ، وأعد تحميل الصور إلى Habrastorage باستخدام الروابط من الأول. لا يبدو الأمر بسيطًا للغاية ، ولكنه يوفر مقدارًا غير محدود من الوقت.

نصائح مفيدة حول تخفيض السعر والمزيد

1. تقسيم النص إلى فقرات . من فضلك!
2. الصور على Habrastorage . هذا واضح ، ولكن من الأفضل أن أكرر. لا يوجد شيء أسوأ من فتح منشور مفيد قبل خمس سنوات وإدراك أن روابط الصور قد سئت منذ وقت طويل. بالمناسبة ، HS يوفر روابط جاهزة ملفوفة في تخفيض السعر.
3. في ترقيم القوائم ، يكون العنصر الأول هو المهم فقط ؛ ضع الباقي كما تريد. يعد هذا مفيدًا إذا قررت إعادة ترتيب عناصر القائمة بعشرة عناصر ، لكنك كسول جدًا في تغيير الأرقام.
   
4. الجداول - الصور . في marqdown ، طاولات مضحكة تكسر الدماغ لأول مرة عدة مرات ، لكن هبر لا يعرف كيفية عرضها بشكل جميل - يتم نقل النصوص الموجودة في الخلايا إلى سطر جديد. أفضل رسمها في مكان آخر وتضمين PNG.
   تحديث. نصيحة جيدة من opanas من التعليقات هي "من المستحسن وضع المفسد بالقرب من جدول الصورة (حيث سيكون الجدول نصًا وسيكون القارئ قادرًا على النسخ ، وسوف يتعامل الروبوت مع الفهرسة)".
5. يتم إنشاء رصيف Google جديد باستخدام رابط doc.new - إضافته إلى شريط الإشارات المرجعية لتوفير الوقت في كل مرة.
6. حافظ على المسودات - قم بمزامنتها مع بعض السحابة. بالطبع ، يمكنك دائمًا الحصول على التصميم من المنشور على Habré ، ولكن ، كما تبين الممارسة ، هو أكثر موثوقية.
7. المسافة البادئة بين العناوين ذات المستويات المختلفة هي الشيء الأكثر عشوائية في العالم ، على الأقل لأول 30 مرة. تأكد من التحقق قبل النشر من وجود مسافة بادئة عادية في النص.
8. HTML مختلطة مع Habr-markdown يمكن أن تنشئ أخطاء مضحكة في برامج تحرير الجهات الخارجية. على سبيل المثال ، إذا استخدمت <code/> ونسيت إغلاقها بشكل صحيح. اتضح مثل هذا:
   

النتائج

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

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

فز.