Nakon što sam proveo više od 1.000 sati pišući i uređujući priče za našu publikaciju Medium, odlučio sam stvoriti ovaj vodič za stil života za suradnike. Slobodno ga upotrijebite i za svoju publikaciju.
Naslovi
To su najvažniji dijelovi vaše priče i trebali biste u njih ozbiljno razmisliti.
Ne koristite mamac za klik:
"Nećete vjerovati ovom smiješno učinkovitom naslovu tamnog uzorka"
Ne koristite popise:
"11 nečuvenih naslova koji će natjerati ljude da pročitaju vašu Medium priču"
Govorite istinu:
"Pametan, ali stvarni naslov o zanimljivoj temi"
Ne označavajte priče koje su dio 1. serije "1. dijelom". To ljude plaši, jer će čitanje smatrati većom vremenskom predanošću. I tko zna kad ćete ionako prijeći na pisanje 2. dijela.
Također, ako je naslov predugačak, Medium će ga skratiti. Dugi naslovi također mogu spriječiti da se vaša gornja slika pojavi u feedovima vijesti.
Slike
Medium nudi četiri različite širine slike. Imajte na umu da će sve to izgledati jednako na mobilnim uređajima.
Većinu vremena želite se pridržavati širine stupca:

Ako imate grafikon koji je teško pročitati kad je mali, idite veći:

A ako ste zaista ponosni na sliku ili ako je prepuna zanimljivih podataka, idite potpuno:


... i tu je bočno razaranje. Uopće nemojte koristiti ovu veličinu jer tekst čini manje ugodnim za čitanje.
Također je neugodno kad završite s razgovorom o fotografiji, a vaš je tekst i dalje gurnut u stranu.
Da. Još uvijek sam zaglavio ovdje.
Uvijek uključite sliku visoke rezolucije na vrh priče ispod svog naslova. To ima sljedeće prednosti:
- Kad ljudi podijele vašu priču na Facebooku i Twitteru, bit će istaknutija u feedovima vijesti, što će vjerojatnije učiniti da je ljudi kliknu.
- Izgledat će bolje u medijskim vijestima.
- Ljudi su vizualna bića i klikću na slike.
Pripisivanje
Najjednostavniji način atribuiranja slike je stavljanje riječi "Priznanje slike" ispod slike i povezivanje ovog teksta s izvornim izvorom.
U nekim slučajevima to možda neće biti dovoljno za nositelja prava na sliku. U praksi, međutim, većina časopisa i filmskih studija ima bolje stvari nego slati pisma o prestanku i odustajanju od ljudi koji su samo pripisali svoje zaštićene slike.
Ako tražite slike koje možete sigurno koristiti bez dopuštenja, pogledajte Peksele, Unsplash ili potražite na Googleu slike s oznakom za ponovnu upotrebu.

Plagiranje - pogrešno predstavljanje tuđeg pisanja kao vašeg vlastitog - ozbiljan je prekršaj na fakultetu, a jednako je ozbiljan i na Mediumu. Citate uvijek pripisujte ljudima koji su ih prvotno rekli. Ako se radi o citati s više redaka, trebali biste koristiti povučene citate Medium:
"Kad imate vlastitu pamet, zadovoljstvo je pripisati drugima priznanje njihovom."- Criss Jami
Imajte na umu da ni pod kojim drugim okolnostima ne biste trebali upotrebljavati povučene citate jer tekst otežava čitanje. Oduprite se iskušenju da koristite povučene citate kako biste citirali vlastitu priču ili kako biste zadirkivali nešto što ćete ionako reći. Ovo se samo uvećava i troši vrijeme vaših čitatelja.
Kodirati
Gdje je to moguće, kôd bi trebao biti u tekstualnom obliku, a ne u slikama. To čini kod pristupačnijim čitačima zaslona i lakšim za kopiranje i lijepljenje. Evo kako to možete učiniti:
Kako dodati blokove koda u Medium i koristiti alate za ugrađivanje za isticanje sintakse
Medium ima skriveni prečac koji će tekst pretvoriti u običan tekst ... medium.freecodecamp.com
Veze
Osmislite način na koji ćete povezati rečenicu. Ako je veza od vitalne važnosti za priču, stavite je na svoju liniju i pritisnite enter. Ovo će stvoriti karticu za pregled, poput ove:
Kako stati na ramena divova
Osvojite sindrom koji nije izumljen ovdje, a zatim učinite nešto novo. medium.freecodecamp.com
Podcrtavanje teksta otežava čitanje, pa samo hipervezu nekoliko riječi.
Ne lijepite URL-ove izravno, poput ovog: //www.example.com
Koristite njihove domene najviše razine ako je to dio njihove marke, poput art.com.
Ugrađivanje medija
Možete ugraditi tweetove, YouTube videozapise i druge medije tako da zalijepite njihove URL-ove u Medium u novi redak, a zatim pritisnete enter.
Koristite ih štedljivo jer vam čitatelja mogu odvratiti od završetka vaše priče.
Skraćenice
Nemojte koristiti kraticu ako se skraćenica ne razumije šire od onoga što predstavlja. Na primjer, HTTP je šire priznat od protokola za prijenos hiperteksta.
Ako kratica već nije široko razumljiva, a pozivat ćete se na nju više od nekoliko puta, možete je definirati kao kraticu čineći ovo:
"Raščlanimo kod na apstraktno sintaksno stablo (AST)."
Ovdje sam se također povezao s člankom na Wikipediji, radi čitatelja. Ipak, nemojte pretpostavljati da će ljudi čitati ove vanjske poveznice. Još uvijek trebate definirati koncepte ili ih ilustrirati kroz primjer.
Izbjegavajte definirati kraticu u uvodnim odlomcima, jer usporava čitatelja i smanjuje vjerojatnost da će nastaviti čitati.
Evo vrlo kratkog popisa tehnoloških kratica koje ne trebate definirati: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, LAN, RAM, REST, USB, WWW, XML. Za sve ostalo trebali biste to dobro napisati.
Uvijek izgovarajte kratke višedijelne riječi poput JavaScript i front-end. Nemojte ih skraćivati - kratkoća ne vrijedi zbog moguće zabune.
Oblikovanje teksta
Možete koristiti podebljano ili kurziv - nikad oboje - kako biste stavili naglasak na nekoliko riječi. Oni usporavaju čitač i trebaju se koristiti štedljivo. Na vezama nemojte koristiti podebljano ili kurziv. Oni se već ističu zbog podcrtavanja.
Nemojte koristiti kapice. Izgledaju elegantno u starim knjigama, ali glupo na webu.

Ako želite nešto naglasiti, upotrijebite podebljano . Kurziv je teže čitati. Ne podebljavajte hiperveze - crta ispod njih već daje dovoljno naglaska.
Koristite samo jedan uskličnik, obično samo nakon uzvika poput: Golly gee! Hot dog!
Stavite zareze i točke unutar navodnika, osim kada to može zbuniti čitatelja (na primjer s imenima varijabli ili naslovima knjiga).
U nekim dijelovima svijeta ljudi stavljaju razmake ispred dvotočke, poput ovog: primjer. Ne radi to.
Upotrijebite engleski umjesto latinskog:
- Upotrijebite "na primjer" umjesto "EG"
- Upotrijebite "to je" umjesto "IE"
- Upotrijebite "note that" umjesto "NB"
- Umjesto da popisi završavaju s "itd." započnite ih s "like": "Elvis je jeo hranu poput kruha, maslaca od kikirikija i banana."
Prema Google Booksu, zarez sa zarezom umire polaganom smrću. Izbacimo ih iz bijede. Umjesto toga samo upotrijebite tačku i rastavite klauzule u zasebne rečenice.

Koristite oxfordsku zarez kad je to moguće. Čini stvari jednostavnijima, preglednijima i ljepšima.
Stil
Upotrijebite aplikaciju Hemingway. U ovom jednostavnom alatu nema ničeg čarobnog, ali automatski će otkriti široko dogovorene probleme sa stilom:
- pasivni glas
- nepotrebni prilozi
- riječi koje imaju zajedničke ekvivalente
Aplikacija Hemingway dodijelit će "razinu ocjene" za vaše pisanje. Čak i tehničke priče mogu izvući razinu 6. I trebale bi težiti tome.
Većina ljudi nije izvorni govornik engleskog jezika, a oni koji to nisu obično čitav dan sjede okolo i čitaju Chaucera. Žele da im informacije budu dostupne i precizne.
Pogreška na strani razbijanja dugih rečenica i odlomaka na kraće.
Koristite kontrakcije. Oni će učiniti da vaša proza djeluje razgovornije. To je uvijek plus.
Držite svoje vrijeme dosljednim. Ako govorite o nečemu što se dogodilo u prošlosti, upotrijebite prošlo vrijeme.
Nazovite svog čitatelja kao "vi", a ne "mi" ili "mi". "Mi" nećemo raditi ovaj tutorial, vaš će čitatelj pročitati vaš tutorial i to samostalno.
Također, razvoj na prednjoj strani (oblik pridjeva s crticom) je kada radite na prednjem kraju (oblik imenice bez crtice). Isto vrijedi i za stražnji kraj, full stack i mnoge druge složene izraze.
Završni savjet
Zapamtite da kada objavljujete na Medijumu, tražite od tisuća ljudi da vam poklone nekoliko minuta svog života. Ne uzimajte čitatelje zdravo za gotovo.
Prije nego što objavite priču, preporučujem vam da spavate, probudite se, a zatim je ponovno pročitate.
Ako niste izvorni engleski jezik, a pišete na engleskom, zamolite izvornog govornika da vam pročita priču prije nego što je predate publikaciji.
Kad predate svoju priču publikaciji, trebali biste očekivati da će je urednici zapravo urediti. Imajte na umu da ti ljudi provode puno više vremena uređujući priče od vas i imaju razvijeniji osjećaj "što djeluje". Ali, neka vas ovo ne zaustavi u postavljanju pitanja i ispravljanju činjeničnih netočnosti koje bi mogle uvesti.
Budite oprezni prema publikacijama koje objavljuju vašu priču bez bilo kakvih uređivanja. Ako se nisu potrudili urediti je (ili je čak pročitati?), Vjerojatno se neće ni puno truditi oko toga da je objave.
Oh, i ne otvarajte svoju priču s "Ovo je objavljeno na mom blogu na" ili "update: ovo je objavljeno na Hacker News." Ako odlučite dodati ovakve bilješke, stavite ih na samo dno vaše priče. Ljudi nisu kliknuli na vašu priču samo da bi ih odmah poslali - došli su pročitati vašu priču.
Imajte na umu da se sam freeCodeCamp više ne objavljuje na Mediumu. Umjesto toga objavljujemo ovdje. Evo kako se objaviti u publikaciji freeCodeCampa.
Ako želite saznati više o učinkovitom pisanju na samom Medijumu, pročitajte Kako pisati srednje vijesti koje će ljudi zapravo čitati.