Hogyan lehet közzétenni a freeCodeCamp Medium kiadványban

Frissítés: A Mediumon való közzététel helyett most egy saját, saját tulajdonú nyílt forráskódú eszközt futtatunk, ahol cikkeket teszünk közzé még nagyobb közönség számára.

Ezen a fórumszálon elolvashatja többet lépésünkről, amely utasításokat tartalmaz arra vonatkozóan, hogyan lehet jelentkezni szerzővé, olvassa el ezt a stílus útmutatót.

A következők történeti célokra szolgálnak, ha kíváncsi vagy.

Nyílt forráskódú közösségünk üzemelteti a Medium legnagyobb műszaki kiadványát. Ha fejlesztésről, tervezésről vagy adattudományról ír - és hallgatóságot keres -, ez jó hely a publikálásra.

A freeCodeCamp egy nyílt forráskódú közösség, több ezer közreműködővel, mentorral, tanárral és rendezvényszervezővel.

Több mint egymillió ember tanul meg kódolni havonta a freeCodeCamp használatával, és ezrével dolgoztuk át az 1200 órás tananyagot, és megszereztük első fejlesztői munkájukat.

Mi nonprofit szervezet vagyunk. Támogatóvá válással segíthet nekünk a szerverek és egyéb költségek kifizetésében.

Íme, mit jelent ez az Ön számára íróként:

  • Nem ragasztjuk el a történetét reklámokkal, és nem tesszük egy fizetőfal (vagy „e-mail fal” vagy bármi más mögé - semmi furcsa trükk).
  • Hozzáadhat linkeket saját blogjához vagy szolgáltatásához, sőt társult linkeket is, feltéve, hogy ízlésesen és átláthatóan történik.
  • A történeteid a tied. Nem állítunk igényt rájuk. Kereszthelyezheti őket, ahol csak akarja. Más újságok és webhelyek akár kapcsolatba léphetnek velük a szindikálás vagy fordítás miatt. Ez rendben van velünk. Csak azt kérjük, hogy - mivel sok időt fordítunk a történeteid szerkesztésére és népszerűsítésére - ne távolítsd el őket a Medium kiadványunkból, miután közzétettük őket.

Szerkesztõink tapasztalattal rendelkeznek az újságok vezetésével és a mûszaki publikációk szerkesztésével kapcsolatban. Elolvassuk a beadványát, és ha úgy gondoljuk, hogy ígéretes, őszinte visszajelzést adunk arról, hogyan javíthatja. Ezután végleges szerkesztést hajtunk végre a történeteden, közzétesszük, majd segítünk nyilvánosságra hozatalában.

Amióta 18 hónappal ezelőtt elindítottuk ezt a Medium kiadványt:

  • körülbelül 1000 történetet tettünk közzé
  • amelyek átlagosan 23 000 megtekintést kaptak
  • mediánja 6500 megtekintés (vagyis a történetek fele legalább 6500 megtekintést kapott)

Tehát, ha a technológiáról ír, mi segíthetünk sokkal nagyobb közönség elérésében.

Tartalomjegyzék

  • Hogyan értékeljük, szerkesztjük és közzétesszük a történeteket
  • Gyors alapozó, hogy jól írhasson a Medium-ra
  • A jó címsor minden különbséget jelent
  • Letartóztatás képekkel
  • Építsen lendületet erős vezetéssel
  • Biztosítsa a hitelességet
  • Írj okosan
  • Adja meg a forrásait
  • Mutassa be a kódját
  • Tegye a linkeket természetesnek
  • Média beágyazása
  • Magyarázza el a rövidítéseket
  • Megjelenés és stílus
  • Adjon hozzá 5 címkét
  • Tegye közzé történeteit a közösségi médiában
  • Végső tanács

Hogyan értékeljük, szerkesztjük és közzétesszük a történeteket

Megjegyzés: Elrejtettem a beküldési utasításokat, a titkos szót és az e-mail címet az alábbi szövegben, hogy elolvassa mindezt. ?

Hetente több mint 100 beadványt kapunk, és védjük olvasóink idejét. Csak olyan történeteket szeretnénk közzétenni, amelyek:

  • jól megírt
  • érdekes témákról, amelyekről az emberek még nem írtak túl sokat
  • relevánsak a közönség fejlesztők , tervezők , és az adatok a tudósok .

Ha úgy gondoljuk, hogy a története jól illik, íróként felvesszük Önt a freeCodeCamp kiadványba, és elfogadó levelet küldünk Önnek további utasításokkal.

Ezután a történetet szerkesztés és közzététel céljából sorba állítjuk. (Itt van a szerkesztő kézikönyvünk, ha kíváncsi erre a folyamatra). Ez a folyamat eltarthat egy ideig, ezért előre is köszönjük türelmét. A szerkesztéseket a Medium verzióelőzményeiben tekintheti meg. Továbbra is teljes ellenőrzése alatt tarthatja cikkét, ha frissítéseket kell végrehajtania.

Ha úgy gondoljuk, hogy a története nem felel meg a freeCodeCamp kiadványnak, küldünk Önnek egy e-mailt, amelyben tájékoztatjuk erről. Semmi gond. Ez nem fogja negatívan befolyásolni a későbbi történetek itt való közzétételének képességét.

Ne feledje, hogy minden szerkesztőnknek más feladatai vannak a nyílt forráskódú közösségen belül, ezért több napba telhet, mire válaszolunk Önnek. De mindaddig, amíg betartja az alább rejtett beküldési utasításokat, válaszolunk Önnek.

Gyors alapozó, hogy jól írhasson a Medium-ra

Íróként háborút vív a közöny ellen. El kell érnie, hogy az emberek eléggé gondoskodjanak arról, hogy átkattintsanak a történetéhez. Meg kell győznöd őket, hogy kockáztassanak veled.

Csak két fegyvere van a hírcsatornák könyörtelen görgetése ellen: címsor és kép.

Így néz ki egy történet a Medium hírcsatornájában:

Így néz ki a Facebookon:

És így néz ki a Twitteren:

A címsor és a nyitókép az egyetlen dolog, ami alapján az embereknek meg kell ítélniük a történetet. Mielőtt elolvasnák a történet első bekezdését, válaszolniuk kell egy kérdésre. Ugyanaz a kérdés, amelyet mindannyian felteszünk magunknak minden nap: megéri-e ez az időmet?

Első írói feladata az, hogy olyan címsort és képet válasszon, amely az embereket igennel válaszolja.

A jó címsor minden különbséget jelent

A címsor a történet legfontosabb része. Töltsön időt finomításával.

Ne használja a clickbait: "Nem fogja elhinni ezt az egy nevetségesen hatékony címsor sötét mintázatát"

Ne használjon listákat: "11 felháborító címsor, amely arra kényszeríti az embereket, hogy elolvassák a közepes történetét"

Mondd meg az igazat: „Okos, de tényszerű címsor érdekes témáról”

Meddig legyen a címsorod? A HubSpot 6000 blogbejegyzést elemzett, és megállapította, hogy a 8–14 szavas címsorokkal rendelkező történetek több közösségi média-megosztást kapnak.

Ennek ellenére ellenőrizze, hogy a címsor legfeljebb 80 karakterből áll-e . Ellenkező esetben a cím megcsonkul a hírcsatornákban, amikor az emberek megosztják cikkedet a Facebookon és a Twitteren.

Egy másik szempont az, hogy mennyire érzelmi egy cím. Minél érzelmesebb (pozitív vagy negatív) egy címsor, annál valószínűbb, hogy az emberek rákattintanak.

Ez egy eszköz, amely segít egyensúlyban tartani a címsorok hosszát és hangulatát.

A címsorokat hagyományosan „címben” írják. Az Associated Press szerint “minden szó első betűjét nagybetűkkel írják, kivéve a cikkeket, az összehangoló kötőszavakat és a három vagy kevesebb betűs elöljárókat”

A Medium-on gyakran kidobom a címbetűket az ablakon, és csak címsorokat írok, mint egy normális mondatot. Szükség szerint még írásjeleket is felveszek. Ez a formátum beszélgetőbb és könnyebben olvasható.

Ne bontsa részekre a történeteket. Az olyan címkék, mint az „1. ​​rész”, elriasztják az embereket, mert ki tudja, mikor jut el a 2. rész megírásához zavar az olvasás sem. Tehát sokkal jobb, ha csak egyetlen mélyreható történetet publikálunk.

Letartóztatás képekkel

A történet második legfontosabb szempontja a kiemelt kép.

A Medium automatikusan elkészíti a cikk első képét a kiemelt képével. Ez azt jelenti, hogy a cikked og-image meta tulajdonsága ez a kép lesz. Ez a kép történetének nagyköveteként szolgál majd mindenhol: a közösségi média hírcsatornái, a Reddit, a Google News - még az RSS olvasói is.

Manuálisan kényszerítheti a Mediumot arra, hogy egy adott képet a cikk kiemelt képének kezeljen. Szerkesztés módban kattintson a képre, majd:

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

Az írási folyamat elején kezdje el mérlegelni a képeket. És soha ne publikáljon legalább egy kép nélkül. Ellenkező esetben a története csak láthatatlan lesz a hírcsatornákban.

Hosszú történeteket kell felbontanod képekkel. Mary Poppins megfogalmazása érdekében egy kanál kép segíti a szöveg lefelé haladását.

A Medium négy különböző képszélességet kínál. Ne feledje, hogy ezek mind ugyanúgy fognak kinézni mobilon.

A legtöbb esetben érdemes ragaszkodnia az oszlopszélességhez:

Ha van olyan diagramja, amelyet kicsiben nehéz elolvasni, akkor lépjen nagyobbra:

És ha igazán büszke vagy egy képre, vagy ha érdekes adatokkal van tele, akkor légy teljes vérzéses:

… És akkor van oldalsó kocsi. Ne használja ezt a méretet egyáltalán, mert az kevésbé olvashatóvá teszi a szöveget.

Az is kínos, ha befejezted a fotó beszélgetését, és a szöveged továbbra is oldalra tolódik.

Igen. Még mindig itt vagyok.

Mindig tartalmazzon egy nagy felbontású képet a történet tetején a címsor alatt. Ennek a következő előnyei vannak:

  1. Amikor az emberek megosztják a történetedet a Facebookon és a Twitteren, ez a hírcsatornákban hangsúlyosabbá válik, így az emberek nagyobb valószínűséggel kattintanak rá.
  2. Jobban fog kinézni a Medium saját hírcsatornáiban.
  3. Az emberek vizuális lények, és kattintson a képekre.

Építsen lendületet erős vezetéssel

Miután az olvasó rákattint a történetére, megkezdődik a tárgyalás. Bármilyen ürügyet keresnek, hogy visszatérjenek a hírcsatornájukhoz. Az olvasás sokkal több erőfeszítést igényel, mint a macskafotók görgetése.

Ne pazarolja az idejét olyan bevezetőkkel vagy frissítésekkel, mint a „Ezt közzétettem a blogomon a [blog URL] -én” vagy a „Frissítés: ezt közzétettük a Hacker News-on” címmel. Ezeket a dolgokat a történet aljára teheti.

Ehelyett azonnal kezdjen el pontozni és elmondani a történetét.

Biztosítsa a hitelességet

Az első bekezdésekben találjon ki egy módszert hitelességének megalapozására. Ha a szakterületed legjobb szakértője vagy, mondd el. Ne feltételezd, hogy az emberek időt szakítanak arra, hogy google-t keressenek.

- Aki vagy, olyan hangosan beszél, hogy nem hallom, amit mondasz. - Ralph Waldo Emerson

Bármely olyan eredmény vagy megkülönböztetés, amely az embereket komolyabban veszi, segít az olvasókban azt a benyomást kelteni, hogy „ez a személy tudja, miről beszélnek”.

Erősítse meg hitelességét a története során. Támogassa érveit adatokkal. Használjon belső linkeket a (nem fizetős) kutatáshoz.

Ez nem a New England Journal of Medicine. Ez közepes. Tehát ne használjon lábjegyzeteket.

Írj okosan

A jó írás nehéz. Mint minden készség, ez is gyakorlást igényel. Nincsenek gyorsbillentyűk az erős íróvá váláshoz.

Tegyen meg magának egy szívességet: írja meg, amit tud .

Hallottál már valaha „írók blokkolni” kifejezést Az írói blokk akkor következik be, ha nem tudsz eleget egy témáról ahhoz, hogy írj róla.

Ha problémája van legalább 5 percnyi mondanivalóval előállni egy témában - vagy ha a története felsorolódik a pontok listájába -, akkor nem tud róla eléggé.

Az ellenszer kutatás. Tanulás. Kimenni a mezőre.

Ne tegyen közzé semmit, amire nem vagy büszke. A közepes nem számjátszma. Társadalmi szerződés. Az emberek követnek téged. Viszont tiszteletet mutatsz szűkös idejük iránt.

A jó közepes történetek nem természetes módon jönnek létre. A mese minden percére számítson arra, hogy legalább egy órát eltöltsen a történet megírásával, újraírásával és szerkesztésével.

Adja meg a forrásait

A kép tulajdonításának legegyszerűbb módja, ha a kép alá helyezi a „Kép jóváírása” szavakat, és ezt a szöveget összekapcsolja az eredeti forrással.

Ha olyan képeket keres, amelyeket engedély nélkül biztonságosan használhat, nézze meg a Pexels, az Unsplash webhelyet, vagy keressen a Google-on újrafelhasználáshoz címkézett képeket.

A plágium - valakinek a sajátjaként való félrevezetése - súlyos bűncselekmény az egyetemen, és ugyanolyan súlyos a Mediumban is. Mindig tulajdonítson idézeteket azoknak az embereknek, akik eredetileg mondták őket. Ha többsoros idézetről van szó, használja a Medium húzós idézeteket:

"Ha van eszed saját, öröm, hogy más embereket hitelt érdemel a sajátjaikért."

- Criss Jami

Csak a Közepes húzó idézeteket használja a tényleges idézetek kiemelésére - a saját szövegének megformázására nem.

Mutassa be a kódját

Ahol lehetséges, a kódnak szöveges formában kell lennie, nem pedig képeknek. Ezáltal a kód könnyebben elérhetővé válik a képernyőolvasók számára, és az emberek könnyebben másolhatják és beilleszthetik őket.

A médiumnak van egy rejtett parancsikonja, amely a következő szöveget alakítja át:

if (fejlesztő === igaz) {

kövesse (this.mediumPublication);

}

… Formázott kódblokkba:

if (developer === true) {
 follow(this.mediumPublication);
}

Ehhez válassza ki a szöveget, majd nyomja meg:

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

Kódblokkot is indíthat hármas visszaütéssel. Ha három backticket ("") ír be egy új sorba, a Medium átvált kódbeviteli módba.

A soron belüli kód kiemeléséhez válassza ki, majd nyomja meg a backtick gombot. Így a szöveget kódként formázhatja freeCodeCamp()a mondat közepén.

Akár futható alkalmazásokat is beágyazhat közvetlenül a Közepesbe. Arra az esetre, ha ezek nem megfelelően jelennek meg a Medium mobilalkalmazásaiban, azt javaslom, hogy tartalékként adjon meg linkeket az egyes beágyazások alatt.

Illesszen be egy CodePen.io URL-t a Médiumba, majd nyomja meg az Enter billentyűt:

Itt tekintheti meg a CodePen-t.

Ezt megteheti a JSFiddle.net webhelyen is:

Itt tekintheti meg a JSFiddle-t.

Előfordul, hogy az emberek a kódsorokat egy, $ha terminálparancsokkal kezdik . Ne csináld ezt. Összezavarja a kezdőket, és megnehezíti a parancsok másolását és beillesztését. Ehelyett csak mondjon valamit: „Írja be a következő parancsokat a terminálba.”

Tegye a linkeket természetesnek

Kitalálja, hogyan lehet egy linket mondatba dolgozni. Egy dolgot nem ajánlok, hogy egy linket tegyek a saját vonalára, és megnyomják az Enter billentyűt. Ez egy szép megjelenésű előnézeti kártyát hoz létre, például:

Hogyan állhatunk az óriások vállára

Hódítsa meg az itt nem kitalált szindrómát, majd tegyen valami újat. medium.freecodecamp.com

... de az olvasók gyakran feltételezik, hogy ezek hirdetések, és nem is nézik meg őket.

Az egyetlen alkalom, amikor ezt javasolnám, a történet végén van, ha további olvasmányokhoz szeretne kapcsolódni.

Az aláhúzott szöveg megnehezíti az olvasást, ezért csak néhány szót linkeljen.

Ne illessze be közvetlenül az URL-eket, így: ❌ //www.freecodecamp.com ❌

Ehelyett linkeljen olyan oldalakra, mint a freeCodeCamp mondat közepe, mint ahogy itt tettem.

Média beágyazása

Beágyazhat tweeteket, YouTube-videókat és más médiákat úgy, hogy URL-jeit egy új sorba illeszti a Közepesbe, majd nyomja le az Enter billentyűt.

Használja ezeket kíméletesen, mivel ezek elvonhatják az olvasó figyelmét a történet befejezéséről.

Magyarázza el a rövidítéseket

Ne használjon rövidítést, hacsak a rövidítés nem érthetőbb, mint amit képvisel. Például a HTTP szélesebb körben elismert, mint a Hypertext Transfer Protocol.

Ha egy rövidítést még nem értenek széles körben, és többször is hivatkozni fog rá, akkor ezt rövidítésként definiálhatja:

"Bontsuk szét a kódot absztrakt szintaxisfára (AST)."

Itt linkeltem a Wikipedia cikkére is, az olvasók kényelme érdekében. Ne feltételezd, hogy az emberek elolvassák ezeket a külső linkeket. Még mindig meg kell határoznia a fogalmakat, vagy példákkal kell illusztrálnia őket.

Kerülje a rövidítés definiálását a kezdő bekezdésekben, mivel ez lelassítja az olvasót, és kevésbé valószínű, hogy folytatja az olvasást.

Itt van a nagyon rövid technológiai rövidítés, amelyet nem kell meghatároznia: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Minden mást meg kell fogalmaznia.

Mindig írjon rövid, több részből álló szavakat, például a JavaScriptet és a kezelőfelületet. Ne rövidítse le őket. A rövidség nem éri meg a lehetséges zavart.

Megjelenés és stílus

Ha valamit hangsúlyozni akar, használjon vastag betűt , de takarékosan . A dőlt betű nehezebben olvasható. Ne merészkedjen hiperhivatkozásokkal - az alattuk lévő vonal már elég hangsúlyt fektet.

Ne használjon kupakokat. A régi könyvekben elegánsnak tűnnek, de az interneten buták.

Egyszerre csak egy felkiáltójelet használjon, általában csak olyan felkiáltások után, mint: Golly gee! Hot dog!

Helyezzen vesszőket és pontokat idézőjelek közé, kivéve, ha az megzavarhatja az olvasót (például változó névvel vagy könyvcímmel).

A világ egyes részein az emberek kettőspontok vagy kérdőjelek előtt tesznek szóközt, például: példa. Ne csináld ezt.

Használjon angolul latin helyett:

  • Használjon „például” helyett „EG”
  • Az „IE” helyett használja a „azaz”
  • Az „NB” helyett használja a „note that” szót
  • Ahelyett, hogy a listákat „stb.” -Vel zárná kezdje őket a „like” kifejezéssel: „Elvis olyan ételeket eszik, mint a kenyér, a mogyoróvaj és a banán.”

A Google Könyvek szerint a pontosvesszők lassan halnak meg. Tegyük ki őket nyomorúságukból. Csak használjon pontot, és bontsa a mondatokat külön mondatokra.

Használja az Oxford vesszőt, ha lehetséges. Ez megkönnyíti, világosabbá és szebbé teszi az olvasást.

Használja a Hemingway alkalmazást. Ebben az egyszerű eszközben nincs semmi varázslat, de automatikusan észleli a széles körben elfogadott stílusproblémákat:

  • szenvedő szerkezet
  • felesleges határozószók
  • szavak, amelyeknek gyakrabban vannak megfelelőik

A Hemingway App hozzárendel egy „fokozatszintet” az írásához. Még a technikai történetek is elrugaszthatják a 6. osztályt. És erre törekedniük kell.

Az emberek többsége nem anyanyelvű, és általában nem ül egész nap Chaucert olvasva. Azt akarják, hogy információik hozzáférhetőek és a lényegre törekedjenek.

Hibás a hosszú mondatok és a bekezdések rövidebbre törése oldalán.

Annak ellenére, hogy az angol zeneszerzésen tanultál, az emberek inkább a rövid bekezdések helyett a „szöveg falai”.

Az egy mondatos bekezdésekkel nincs semmi baj.

Tévedés az új bekezdések létrehozása oldalán.

Használjon összehúzódásokat. Ezáltal prózája beszélgetőbbnek tűnik. Ez mindig plusz.

Tartsa feszült feszültségét mindvégig. Ha valamiről a múltban beszélt, használjon múlt időt.

Ezenkívül a front-end fejlesztés (kötőjeles melléknévi forma) az, amikor a kezelőfelületen dolgozik (főnévi alak kötőjel nélkül). Ugyanez vonatkozik a hátulra, a teljes stackre és sok más összetett kifejezésre.

Adjon hozzá 5 címkét

A Közepes lehetővé teszi akár öt címke hozzáadását a történetéhez. Használd őket.

Az emberek meghatározott témákat követnek a Médiumban. A legnépszerűbbek a #tech, # life-lessons, #travel, #design és #startup.

Azok az emberek, akik követik az Ön által használt címkéket, láthatják a hírüket a hírcsatornájukban. A címkék megkönnyítik az emberek számára, hogy a keresési eredmények között belebotljanak a történetébe.

Most, hogy idáig elolvasta, a következőképpen küldheti el történetét a freeCodeCamp kiadványhoz: küldjön egy e-mailt a freecodecamp org webhelyen történő elküldésre. Írja be történetének URL-jét a Médiumon (lehetőleg egy nem publikált vázlatot) és a „banán” szót, hogy megtudjuk, hogy mindezt elolvasta. E-mailenként csak egy történet URL-jét küldje el. Nincs szükség semmilyen további hozzáadásra e-mailjéhez - csak elolvassuk a történeteket, és a saját érdemeik alapján ítéljük meg őket.

Tegye közzé történeteit a közösségi médiában

Megoszthatja történetét a Twitteren, a Facebook-csoportokon és a releváns Subreddits-en. Ha van levelezőlistád, robbanthatod ki az előfizetőidnek is.

Valós időben megtekintheti történetének statisztikáját. Kérjen visszajelzést barátaitól és követőitől. Vesse be ezt a visszajelzést a történetébe.

Ne tegyen semmi vázlatos, hogy népszerűsítse történetét. Nagy valószínűséggel elkapnak. Az olyan webhelyek, mint a Hacker News és a Reddit, nagyon jól észlelik a rendellenes szavazási magatartást. Ez nem csak Önt, hanem az egész freeCodeCamp közösséget is rosszul fogja tükrözni.

Végső tanács

Ne feledje, hogy amikor a Mediumban publikál, több ezer embert kér arra, hogy adjon neked életükből néhány percet. Ne vegye magától értetődőnek az olvasókat.

Mielőtt közzétennél egy történetet, azt javaslom, hogy aludj, ébredj fel, majd olvasd el újra.

Ha Ön nem angol anyanyelvű és angolul ír, kérjen anyanyelvi beszélőt, hogy olvassa el a történetét, mielőtt kiadványba küldené.

Kíváncsian várjuk a beküldött anyagokat. Remélem, hogy segíthetünk a történetek továbbfejlesztésében és sokkal szélesebb közönség elérésében.