Как да бъдем публикувани в публикацията freeCodeCamp Medium

Нашата общност с отворен код управлява най-голямото техническо издание на Medium. Ако пишете за разработка, дизайн или наука за данни - и търсите публика - това е добро място за публикуване.

Нашите статистически данни от последните 90 дни. Те са достатъчно високи, за да разбият CSS на ос Y на средните класации.

freeCodeCamp е общност с отворен код с хиляди сътрудници, ментори, учители и организатори на събития.

Повече от милион хора се учат да кодират с помощта на freeCodeCamp всеки месец, а хиляди от нас са работили през 1200-часовата учебна програма и са получили първите си работни програми.

Ние сме с нестопанска цел. Можете да ни помогнете да платим за сървъри и други разходи, като станете поддръжник.

Ето какво означава всичко това за вас като писател:

  • Няма да измажем вашата история с реклами, нито да я поставим зад платена стена (или „стена по имейл“ или нещо друго - без странни трикове).
  • Можете да включите връзки към вашия собствен блог или услуга и дори партньорски връзки, стига да е направено с вкус и прозрачност.
  • Вашите истории са ваши. Не предявяваме претенции към тях. Можете да ги публикувате, където искате. Други вестници и уебсайтове дори могат да се обърнат към вас относно синдикацията им или превода. Това е добре с нас. Просто искаме това - тъй като инвестираме много време в редактиране и популяризиране на вашите истории - вие не ги премахвате от нашата медийна публикация, след като ги публикуваме.

Нашите редактори имат опит да ръководят вестници и да редактират технически публикации. Ще прочетем вашето изявление и ако сметнем, че е обещаващо, ще ви дадем откровена обратна връзка за това как можете да го подобрите. Тогава ще извършим окончателно редактиране на вашата история, ще я публикуваме и след това ще ви помогнем да я огласите.

Откакто стартирахме тази медийна публикация преди 18 месеца:

  • публикувахме около 1000 истории
  • които са получили средно 23 000 гледания
  • със средна стойност от 6500 гледания (тоест половината от тези истории са получили поне 6500 гледания)

Така че, ако пишете за технологиите, можем да ви помогнем да достигнете до много по-голяма аудитория.

Съдържание

  • Как оценяваме, редактираме и публикуваме истории
  • Бърз грунд за писане добре на Medium
  • Доброто заглавие прави всичко различно
  • Арест с изображения
  • Изградете инерция със силна преднина
  • Установете достоверност
  • Пишете умно
  • Приписвайте източниците си
  • Покажете кода си
  • Направете връзките да изглеждат естествено
  • Вградете медия
  • Обяснете съкращенията
  • Поглед и стил
  • Добавете 5 маркера
  • Публикувайте вашите истории в социалните медии
  • Краен съвет

Как оценяваме, редактираме и публикуваме истории

Забележка: Скрих инструкциите за изпращане, тайната дума и имейл адреса в текста по-долу, така че да прочетете всичко това.

Всяка седмица получаваме 100+ публикации и защитават времето на нашите читатели. Ние се стремим да публикуваме само истории, които са:

  • добре написано
  • за интересни теми, за които хората вече не са писали твърде много
  • от значение за нашата аудитория от разработчици, дизайнери и учени по данни.

Ако смятаме, че историята ви е подходяща, ще ви добавим като писател към публикацията freeCodeCamp и ще ви изпратим писмо за приемане с допълнителни инструкции.

Тогава ще поставим вашата история на опашката, която ще бъде редактирана и публикувана. (Ето нашия наръчник за редактор, ако се интересувате от този процес). Този процес може да отнеме известно време, така че предварително ви благодарим за търпението. Ще можете да видите редакции в историята на редакциите на Medium. Все още ще имате пълен контрол върху статията си, ако трябва да правите актуализации.

Ако не смятаме, че историята ви е подходяща за публикацията freeCodeCamp, ще ви изпратим имейл, с който ще ви уведомим за това. Няма проблем. Това няма да повлияе негативно на способността ви да публикувате последващи истории, публикувани тук.

Обърнете внимание, че всички наши редактори имат други отговорности в общността с отворен код, така че може да отнеме няколко дни, за да ви отговорим. Но докато следвате инструкциите за изпращане, скрити по-долу, ние ще ви отговорим.

Бърз грунд за писане добре на Medium

Като писател вие водите война срещу безразличието. Трябва да накарате хората да се грижат достатъчно, за да кликнат върху вашата история. Трябва да ги убедите да рискуват върху вас.

Имате само две оръжия срещу безмилостното превъртане на новинарски емисии: заглавие и изображение.

Ето как изглежда една история в емисиите за новини на Medium:

Ето как изглежда във Facebook:

И ето как изглежда в Twitter:

Вашето заглавие и началното изображение са единствените неща, които хората трябва да преценят по вашата история. Преди дори да могат да прочетат първия параграф на историята ви, те трябва да отговорят на въпрос. Това е един и същ въпрос, който всички си задаваме всеки ден: това ще струва ли ми времето?

Първата ви работа като писател е да изберете заглавие и изображение, което ще накара хората да отговорят „да“.

Доброто заглавие прави всичко различно

Вашето заглавие е най-важната част от вашата история. Прекарайте време, усъвършенствайки го.

Не използвайте clickbait: „Няма да повярвате на този нелепо ефективен тъмен шаблон на заглавието“

Не използвайте списъци: „11 възмутителни заглавия, които ще принудят хората да четат вашата медийна история“

Кажете истината: „Умно, но всъщност заглавие по интересна тема“

Колко дълго трябва да е заглавието ви? HubSpot анализира 6000 публикации в блога и откри, че историите с 8 до 14 думи заглавия получават повече споделяния в социалните медии.

Това каза, уверете се, че заглавието ви е 80 знака или по-малко. В противен случай заглавието ще бъде осезано в емисиите на новини, когато хората споделят статията ви във Facebook и Twitter.

Друго съображение е колко емоционално е заглавието. Колкото по-емоционален (положителен или отрицателен) е заглавието, толкова по-вероятно е хората да го щракнат.

Ето инструмент, който ви помага да балансирате дължината и настроенията на заглавията си.

Екранна снимка на анализа на инструмента на едно от заглавията ми. Вашият пробег може да варира.

Заглавията традиционно се пишат в "заглавие." Асошиейтед прес пише, че "изписва главна буква от всяка дума с изключение на статии, координиращи връзки и предлози от три или по-малко букви."

На Medium често изхвърлям случай от заглавието през прозореца и просто пиша заглавия като нормално изречение. Дори включвам пунктуация, ако е необходимо. Този формат е по-разговорен и по-лесен за четене.

Не разбивайте истории на части. Етикети като "част 1" плашат хората, защото кой знае кога ще стигнете до написването на част 2. И ако хората срещнат "част 2" и не са прочели част 1, има голям шанс те просто да не притеснявайте четене или. Така че е много по-добре да публикувате един-единствен задълбочен разказ.

Арест с изображения

Вторият най-важен аспект на вашата история е нейният представен образ.

Медиумът автоматично ще направи първото изображение в статията ви. Това означава, че мета свойството og-image на вашата статия ще бъде това изображение. Това изображение ще служи като посланик на вашата история навсякъде: емисии за новини в социалните медии, Reddit, Google News - дори и RSS четци.

Можете ръчно да принудите Media да обработва конкретно изображение като изображението на вашата статия. Докато сте в режим на редактиране, щракнете върху изображението, след което:

  • Mac: ⌘ + Opt + 8
  • PC: Ctrl + Alt + 8

Започнете да разглеждате изображения в началото на процеса на писане. И никога не публикувайте без поне едно изображение. В противен случай вашата история ще бъде почти невидима в емисиите на новини.

Трябва да разбиете дълги истории с изображения. За да перифразирам Мери Попинз, лъжица изображения помага на текста да намалее.

Medium предлага четири различни ширини на изображението. Имайте предвид, че всички те ще изглеждат еднакво на мобилни устройства.

През повечето време ще искате да се придържате с ширина на колоната:

Ако имате диаграма, която е трудно да се чете, когато е малка, отидете по-голяма:

И ако наистина се гордеете с изображение или ако е пълен с интересни данни, отидете на пълен обем:

... и след това има странично краче. Изобщо не използвайте този размер, защото прави текста по-малко удобен за четене.

Освен това е неудобно, когато сте готови да говорите за снимката и текстът ви все още е изтласкан отстрани.

Да. Все още съм заседнал тук.

Винаги включвайте изображение с висока разделителна способност в горната част на историята под заглавието си. Това има следните предимства:

  1. Когато хората споделят вашата история във Facebook и Twitter, тя ще бъде по-изявена в емисиите на новини, което прави хората по-склонни да кликнат върху нея.
  2. Ще изглежда по-добре в собствените емисии на медиите.
  3. Хората са визуални създания и кликнете върху изображения.

Изградете инерция със силна преднина

След като вашият читател премине към вашата история, изпитанието започва. Те търсят извинение, за да се върнат към тяхната емисия новини. Четенето изисква много повече усилия от превъртането през снимки на котки.

Не губете време с представяне или актуализации като „Това беше публикувано в моя блог на [блог URL]“ или „Актуализация: това е публикувано в Hacker News.“ Можете да поставите тези неща в дъното на вашата история.

Вместо това започнете да правите точки и да разказвате веднага своята история.

Установете достоверност

Измислете начин да установите доверието си в първите няколко абзаца. Ако сте топ експерт в своята област, кажете така. Не приемайте, че хората ще отделят време да ви погледнат.

„Кой си ти говори толкова силно, че не мога да чуя какво говориш.“ - Ралф Уолдо Емерсън

Всяко постижение или отличие, което кара хората да ви приемат по-сериозно, ще помогне да се създаде впечатление на читателите, че „този човек знае за какво говори“.

Засилете своята достоверност в цялата си история. Подкрепете вашите аргументи с данни. Използвайте вградени връзки към (неплатени) изследвания.

Това не е вестникът на New England of Medicine. Това е средно. Затова не използвайте бележки под линия.

Пишете умно

Доброто писане е трудно. Както всяко умение, това изисква практика. Няма преки пътища да станеш силен писател.

Направи си услуга: напиши това, което знаеш.

Случвало ли ви се е да чуете термина „писатели блокират?“ Блокът на писателя се случва, когато не знаете достатъчно за тема, за да напишете по нея.

Ако имате проблеми с измислянето на поне 5 минути неща, които да кажете по дадена тема - или ако историята ви се превърне в списък с точки от куршуми - не знаете достатъчно за нея.

Антидотът е изследване. Изучаване на. Излизане на полето.

Не публикувайте нещо, с което не се гордеете. Средният не е игра с числа. Това е социален договор. Хората те следват. От своя страна показвате уважение към оскъдното им време.

Добрите средни истории не идват естествено. За всяка минута продължителност на историята очаквайте да отделите поне един час за писане, пренаписване и редактиране на вашата история.

Приписвайте източниците си

Технически като писател вие носите отговорност за нарушаване на авторски права, а носителят не е такъв. Най-простият начин за приписване на изображение е да поставите думите „Кредитно изображение“ под изображение и да свържете този текст с неговия първоначален източник.

Ако търсите изображения, които можете безопасно да използвате без разрешение, проверете Pexels, Unsplash или потърсете в Google изображения, обозначени за повторна употреба.

Заявка за търсене на изображение в Google с избраната опция „Етикетиран за повторна употреба“.

Плагиатството - погрешно представяне на писането на някой друг като ваше собствено - е сериозно нарушение в колежа, а в Medium е също толкова сериозно. Винаги приписвайте цитати на хората, които първоначално са ги казали. Ако това е многоредов цитат, трябва да използвате изтеглящите кавички на Medium:

„Когато имате остроумие, е удоволствие да кредитирате други хора за техните.“
- Крис Джами

Трябва да използвате само изтеглящите кавички на Medium като начин да подчертаете действителните цитати - а не да стилизирате свой собствен текст.

Покажете кода си

Където е възможно, кодът трябва да бъде в текстова форма, а не в изображения. Това прави кода по-достъпен за екранните четци и по-лесен за хората да копират и поставят.

Medium има скрит пряк път, който ще превърне текста обикновен текст по този начин:

ако (разработчик === вярно) {

следват (this.mediumPublication);

}

… Във форматиран код от блок:

ако (разработчик === вярно) {
  следват (this.mediumPublication);
}

За да направите това, изберете текста и натиснете:

  • Windows: Control + Alt + 6
  • Mac: Command + Option + 6
  • Linux: Control + Alt + 6

Можете също така да стартирате кодов блок с тройни бек-тикове. Ако напишете три заден план (`` `) на нов ред, Medium ще премине в режим на въвеждане на код.

За да маркирате вграден код, изберете го, след което натиснете клавиша за обратно избиране. По този начин можете да форматирате текст като код freeCodeCamp () точно в средата на изречението.

Можете дори да вграждате приложения, които могат да се изпълняват направо в Medium. Само в случай, че те не се представят правилно в мобилните приложения на Medium, препоръчвам да включите връзки под всяко от вгражданията като резервен.

Поставете URL адрес на CodePen.io в Medium и натиснете Enter:

Вижте моя CodePen тук.

Можете също да направите това с JSFiddle.net:

Вижте моя JSFiddle тук.

Понякога хората започват редове с код с $, ако са терминални команди. Не правете това. Това ще обърка начинаещите и ще затрудни копирането и поставянето на команди. Вместо това просто кажете нещо като „Въведете следните команди в терминала си.“

Направете връзките да изглеждат естествено

Измислете начин да работите връзка в изречение. Едно нещо, което не препоръчвам да правите, е да поставите връзка в своя собствен ред и да натиснете Enter. Това ще създаде хубаво изглеждаща визуална карта, като тази:

… Но читателите често приемат, че това са реклами и дори не ги гледат.

Единственият път, когато бих препоръчал да използвате това, е в края на вашата история, ако искате да се свържете с по-нататъшно четене.

Подчертаването на текст затруднява четенето, така че само хипервръзка няколко думи.

Не залепвайте директно URL адреси, като този: https://www.freecodecamp.com

Вместо това линк към сайтове като freeCodeCamp средно изречение, като току-що направих тук.

Вградете медия

Можете да вградите туитове, видеоклипове в YouTube и други медии, като поставите URL адресите им в Medium на нов ред, след което натиснете Enter.

Използвайте ги пестеливо, тъй като те могат да отвлекат вниманието на вашия читател от завършване на историята ви.

Обяснете съкращенията

Не използвайте абревиатура, освен ако съкращението не е по-широко разбрано от това, което представлява. Например HTTP е по-широко разпознат от Hypertext Transfer Protocol.

Ако абревиатурата вече не е широко разбрана и ще се отнасяте към нея повече от няколко пъти, можете да я определите като абревиатура, като направите това:

„Нека разбием кода в абстрактно синтаксично дърво (AST).“

Тук също свързах със статията в Уикипедия, за удобство на читателите. Не приемайте обаче, че хората ще четат тези външни връзки. Все още трябва да дефинирате понятия или да ги илюстрирате чрез пример.

Избягвайте да дефинирате съкращение в отварящите си абзаци, тъй като това забавя вашия читател и ги прави по-малко вероятно да продължат да четат.

Ето много краткия списък на съкращението на технологиите, което не е необходимо да определяте: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. За всичко останало трябва да го изпишете.

Винаги изписвайте кратки думи от много части като JavaScript и предния край. Не ги скъсявайте Краткото не струва възможното объркване.

Поглед и стил

Ако искате да подчертаете нещо, използвайте смело, но го използвайте пестеливо. Курсивите са по-трудни за четене. Не поставяйте смели хипервръзки - линията под тях вече дава достатъчно ударение.

Не използвайте капки за капки Те изглеждат елегантно в стари книги, но глупаво в мрежата.

Няколко капки за печат на готини училища

Използвайте само една възклицателна точка наведнъж, обикновено само след възклицания като: Голи боже! Хот дог!

Поставете запетаи и периоди вътре в кавички, с изключение на случаите, когато това може да обърка четец (например с имена на променливи или заглавия на книги).

В някои части на света хората поставят интервали пред колони или въпросителни, като този: пример. Не правете това.

Използвайте английски вместо латински:

  • Използвайте „например“ вместо „E.G.“
  • Използвайте „това е“ вместо „I.E.“
  • Използвайте „отбележете, че“ вместо „N.B.“
  • Вместо да завършвате списъци с „и т.н.“, започнете с „като“: „Елвис яде храна като хляб, фъстъчено масло и банани.“

Според Google Books, запетайките умират бавна смърт. Нека ги извадим от мизерията си. Просто използвайте период вместо това и разбийте клаузите на отделни изречения.

Използвайте командата Oxford Comma, когато е възможно. Това прави нещата по-лесни, по-ясни и красиви за четене.

Използвайте приложението Хемингуей. Няма нищо вълшебно в този прост инструмент, но той автоматично ще открие широко съгласувани проблеми със стила:

  • страдателен залог
  • ненужни наречия
  • думи, които имат повече общи еквиваленти

Приложението Хемингуей ще присвои "степен" за вашето писане. Дори техническите истории могат да отнесат 6-та степен на оценка.

Повечето хора не са местни говорители на английски, а тези, които обикновено не седят по цял ден, за да четат Чосър. Те искат информацията им да е достъпна и до точката.

Грешка отстрани на разбиването на дълги изречения и абзаци на по-кратки.

Въпреки това, което може би сте научили в класа по английски състав, хората предпочитат кратки параграфи пред „стените на текста“.

Няма нищо лошо в параграфите с едно изречение.

Грешка от страна на създаването на нови параграфи.

Използвайте контракции. Те ще направят вашата проза да изглежда по-разговорлива. Това винаги е плюс.

Дръжте напрежението си постоянно. Ако говорите за нещо, което се е случило в миналото, използвайте минало време.

Също така, предно развитие (прилагателно форма с тире) е когато работите на предния край (съществителна форма без тире). Същото важи и за задния край, пълния стек и много други сложни термини.

Добавете 5 маркера

Medium ви позволява да добавите до пет маркера към вашата история. Използвай ги.

Хората следват конкретни теми в Medium. Най-популярните от тях са #tech, # life-уроци, #travel, #design и #startup.

Хората, които следват маркерите, които използвате, могат да видят историята ви в емисиите им за новини. Етикетите също улесняват хората да се натъкнат на вашата история в резултатите от търсенето.

И сега, когато прочетохте дотук, ето как да изпратите историята си към публикацията freeCodeCamp: изпратете имейл, който да изпратите на freecodecamp org. Включете URL адреса на вашата история в среда (за предпочитане непубликувана чернова) и думата „банани“, така че да знаем, че сте прочели всичко това. Изпращайте само един URL адрес на история на имейл. Няма нужда да добавяте нищо допълнително към имейла си - просто четем историите и ги преценяваме въз основа на техните собствени достойнства.

Публикувайте вашите истории в социалните медии

Можете да споделите историята си в Twitter, Facebook групи и съответните Subreddits. Ако имате пощенски списък, можете да го изтриете и на своите абонати.

Можете да видите статистическите данни на вашата история в реално време. Попитайте за обратна връзка от вашите приятели и последователи. Включете тази обратна връзка във вашата история.

Не правете нищо схематично, за да популяризирате вашата история. Най-вероятно ще бъдете хванати. Сайтове като Hacker News и Reddit са много добри в откриването на ненормално поведение при гласуване. Това ще се отрази зле не само върху вас, но и върху цялата общност на freeCodeCamp.

Краен съвет

Не забравяйте, че когато публикувате в Medium, вие молите хиляди хора да ви дадат няколко минути от живота си. Не приемайте читателите си за даденост.

Преди да публикувате история, препоръчвам ви да спите, да се събудите и след това да я прочетете отново.

Ако не сте местен говорител на английски език и пишете на английски език, помолете местния говорител да прочете историята си, преди да я изпратите в публикация.

Ще се радваме да прочетем вашите изявления. Надявам се, че можем да ви помогнем да подобрите по-нататък вашите истории и да достигнете до много по-широка аудитория.