Τρόπος δημοσίευσης στην έκδοση FreeCodeCamp Medium

Ενημέρωση: Αντί να δημοσιεύουμε στο Medium, τώρα τρέχουμε το δικό μας εργαλείο φιλοξενίας ανοιχτού κώδικα όπου δημοσιεύουμε άρθρα σε ακόμη μεγαλύτερο κοινό.

Μπορείτε να διαβάσετε περισσότερα σχετικά με τη μετάβαση σε αυτό το νήμα φόρουμ, το οποίο περιλαμβάνει οδηγίες για το πώς μπορείτε να υποβάλετε αίτηση για να γίνετε συγγραφέας, διαβάστε αυτόν τον οδηγό στυλ.

Αυτό που ακολουθεί είναι για ιστορικούς σκοπούς εάν είστε περίεργοι.

Η κοινότητα ανοιχτού κώδικα εκτελεί τη μεγαλύτερη τεχνική έκδοση της Medium. Εάν γράφετε για την ανάπτυξη, το σχεδιασμό ή την επιστήμη δεδομένων - και αναζητάτε κοινό - αυτό είναι ένα καλό μέρος για να δημοσιεύσετε.

Το freeCodeCamp είναι μια κοινότητα ανοιχτού κώδικα με χιλιάδες συνεισφέροντες, μέντορες, εκπαιδευτικούς και διοργανωτές εκδηλώσεων.

Περισσότεροι από ένα εκατομμύριο άνθρωποι μαθαίνουν να κωδικοποιούν χρησιμοποιώντας το freeCodeCamp κάθε μήνα, και χιλιάδες από εμάς έχουμε εργαστεί μέσω του προγράμματος σπουδών των 1.200 ωρών και πήραν τις πρώτες δουλειές τους για προγραμματιστές.

Είμαστε μη κερδοσκοπικός οργανισμός. Μπορείτε να μας βοηθήσετε να πληρώσουμε διακομιστές και άλλα κόστη γίνοντας υποστηρικτής.

Δείτε τι σημαίνει αυτό για εσάς ως συγγραφέας:

  • Δεν θα επικαλύψουμε την ιστορία σας με διαφημίσεις, ούτε θα την βάλουμε πίσω από ένα paywall (ή "email wall" ή οτιδήποτε άλλο - χωρίς περίεργα κόλπα)
  • Μπορείτε να συμπεριλάβετε συνδέσμους στο δικό σας ιστολόγιο ή υπηρεσία, ακόμη και συνδέσμους συνεργατών, αρκεί να γίνεται με γούστο και διαφάνεια.
  • Οι ιστορίες σας είναι δικές σας. Δεν τους ισχυριζόμαστε. Μπορείτε να τα διασταυρώσετε όπου θέλετε. Άλλες εφημερίδες και ιστότοποι μπορεί να σας προσεγγίσουν ακόμη και για τη διανομή τους ή τη μετάφρασή τους. Αυτό είναι εντάξει μαζί μας. Απλώς ζητάμε - επειδή επενδύουμε πολύ χρόνο στην επεξεργασία και την προώθηση των ιστοριών σας - δεν τις καταργείτε από τη δημοσίευση Medium όταν τις δημοσιεύσουμε.

Οι συντάκτες μας έχουν εμπειρία στη διαχείριση εφημερίδων και στην επεξεργασία τεχνικών δημοσιεύσεων. Θα διαβάσουμε την υποβολή σας και αν πιστεύουμε ότι είναι πολλά υποσχόμενη, θα σας δώσουμε ειλικρινή σχόλια σχετικά με τον τρόπο βελτίωσής της. Στη συνέχεια, θα πραγματοποιήσουμε την τελική επεξεργασία της ιστορίας σας, θα τη δημοσιεύσουμε και, στη συνέχεια, θα σας βοηθήσουμε να τη δημοσιεύσετε.

Από τότε που ξεκινήσαμε αυτήν τη δημοσίευση Medium πριν από 18 μήνες:

  • έχουμε δημοσιεύσει περίπου 1.000 ιστορίες
  • που έχουν λάβει κατά μέσο όρο 23.000 προβολές
  • με μέσο όρο 6.500 προβολών (δηλαδή, οι μισές από αυτές τις ιστορίες έχουν λάβει τουλάχιστον 6.500 προβολές)

Αν λοιπόν γράφετε για την τεχνολογία, μπορούμε να σας βοηθήσουμε να προσεγγίσετε ένα πολύ μεγαλύτερο κοινό.

Πίνακας περιεχομένων

  • Πώς αξιολογούμε, επεξεργαζόμαστε και δημοσιεύουμε ιστορίες
  • Ένα γρήγορο αστάρι για καλή γραφή στο Medium
  • Ένας καλός τίτλος κάνει όλη τη διαφορά
  • Σύλληψη με εικόνες
  • Δημιουργήστε δυναμική με ισχυρό προβάδισμα
  • Καθιερώστε την αξιοπιστία
  • Γράψτε έξυπνα
  • Αποδώστε τις πηγές σας
  • Δείξτε τον κωδικό σας
  • Κάντε τους συνδέσμους να φαίνονται φυσικοί
  • Ενσωμάτωση μέσων
  • Εξηγήστε τις συντομογραφίες
  • Κοίτα και στυλ
  • Προσθέστε 5 ετικέτες
  • Δημοσιεύστε τις ιστορίες σας στα κοινωνικά μέσα
  • Τελική συμβουλή

Πώς αξιολογούμε, επεξεργαζόμαστε και δημοσιεύουμε ιστορίες

Σημείωση: Έχω κρύψει τις οδηγίες υποβολής, τη μυστική λέξη και τη διεύθυνση ηλεκτρονικού ταχυδρομείου στο παρακάτω κείμενο, ώστε να διαβάσετε όλα αυτά. ;

Λαμβάνουμε 100+ υποβολές κάθε εβδομάδα και προστατεύουμε τον χρόνο των αναγνωστών μας. Επιδιώκουμε να δημοσιεύουμε μόνο ιστορίες που είναι:

  • καλογραμμένο
  • για ενδιαφέροντα θέματα για τα οποία οι άνθρωποι δεν έχουν ήδη γράψει πολλά
  • σχετικό με το κοινό μας προγραμματιστών , σχεδιαστών και επιστημόνων δεδομένων .

Εάν πιστεύουμε ότι η ιστορία σας ταιριάζει, θα σας προσθέσουμε ως συγγραφέα στη δημοσίευση του FreeCodeCamp και θα σας στείλουμε μια επιστολή αποδοχής με περαιτέρω οδηγίες.

Τότε θα βάλουμε την ιστορία σας στην ουρά για επεξεργασία και δημοσίευση. (Εδώ είναι το εγχειρίδιο του επεξεργαστή μας αν είστε περίεργοι για αυτήν τη διαδικασία). Αυτή η διαδικασία μπορεί να διαρκέσει λίγο, επομένως σας ευχαριστούμε εκ των προτέρων για την υπομονή σας. Θα μπορείτε να προβάλετε τροποποιήσεις στο ιστορικό αναθεωρήσεων του Medium. Θα εξακολουθείτε να έχετε τον πλήρη έλεγχο του άρθρου σας, εάν χρειάζεται να κάνετε ενημερώσεις.

Αν δεν πιστεύουμε ότι η ιστορία σας είναι κατάλληλη για τη δημοσίευση του FreeCodeCamp, θα σας στείλουμε ένα email που θα σας ενημερώνει. Μην ανησυχείς. Δεν θα επηρεάσει αρνητικά την ικανότητά σας να δημοσιεύετε επόμενες ιστορίες εδώ.

Λάβετε υπόψη ότι όλοι οι συντάκτες μας έχουν άλλες ευθύνες εντός της κοινότητας ανοιχτού κώδικα, επομένως μπορεί να χρειαστούν αρκετές ημέρες για να σας απαντήσουμε. Ωστόσο, όσο ακολουθείτε τις οδηγίες υποβολής που κρύβονται παρακάτω, θα σας απαντήσουμε.

Ένα γρήγορο αστάρι για καλή γραφή στο Medium

Ως συγγραφέας, πολεμάτε έναν πόλεμο ενάντια στην αδιαφορία. Πρέπει να κάνετε τους ανθρώπους να φροντίζουν αρκετά για να κάνουν κλικ στην ιστορία σας. Πρέπει να τους πείσετε να σας κάνουν μια ευκαιρία.

Έχετε μόνο δύο όπλα ενάντια στον ατελείωτο κύκλο των ειδήσεων: μια επικεφαλίδα και μια εικόνα.

Δείτε πώς μοιάζει μια ιστορία στη ροή ειδήσεων του Medium:

Δείτε πώς φαίνεται στο Facebook:

Και εδώ φαίνεται στο Twitter:

Ο τίτλος και η αρχική εικόνα σας είναι τα μόνα πράγματα που πρέπει να κρίνουν οι άνθρωποι την ιστορία σας. Για να μπορέσουν ακόμη να διαβάσουν την πρώτη παράγραφο της ιστορίας σας, πρέπει να απαντήσουν σε μια ερώτηση. Είναι το ίδιο ερώτημα που όλοι αναρωτιόμαστε κάθε μέρα: αυτό θα αξίζει τον χρόνο μου;

Η πρώτη σας δουλειά ως συγγραφέας είναι να επιλέξετε έναν τίτλο και μια εικόνα που θα κάνει τους ανθρώπους να απαντήσουν «ναι».

Ένας καλός τίτλος κάνει όλη τη διαφορά

Ο τίτλος σας είναι το πιο σημαντικό μέρος της ιστορίας σας. Περάστε χρόνο για να το βελτιώσετε.

Μην χρησιμοποιήσετε το clickbait: "Δεν θα το πιστέψετε αυτό το γελοία αποτελεσματικό τίτλο σκούρο μοτίβο"

Μην χρησιμοποιείτε λίστες: «11 εξωφρενικά πρωτοσέλιδα που θα αναγκάσουν τους ανθρώπους να διαβάσουν τη μεσαία ιστορία σας»

Πείτε την αλήθεια: "Έξυπνος αλλά ουσιαστικός τίτλος για ένα ενδιαφέρον θέμα"

Πόσο καιρό πρέπει να είναι ο τίτλος σας; Το HubSpot ανέλυσε 6.000 αναρτήσεις ιστολογίου και διαπίστωσε ότι οι ιστορίες με τίτλους 8 έως 14 λέξεων λαμβάνουν περισσότερες κοινοποιήσεις στα μέσα κοινωνικής δικτύωσης.

Ωστόσο, βεβαιωθείτε ότι ο τίτλος σας είναι 80 χαρακτήρες ή λιγότεροι . Διαφορετικά, ο τίτλος θα περικοπεί στις ροές ειδήσεων όταν οι χρήστες μοιράζονται το άρθρο σας στο Facebook και το Twitter.

Ένα άλλο ζήτημα είναι πόσο συναισθηματικός είναι ένας τίτλος. Όσο πιο συναισθηματική (θετική ή αρνητική) είναι μια επικεφαλίδα, τόσο πιο πιθανό θα κάνουν κλικ σε αυτόν.

Εδώ είναι ένα εργαλείο που σας βοηθά να ισορροπήσετε το μήκος και το συναίσθημα των τίτλων σας.

Οι επικεφαλίδες γράφονται παραδοσιακά σε "υπόθεση τίτλου". Το Associated Press λέει ότι «κεφαλαιοποιεί το πρώτο γράμμα κάθε λέξης εκτός από άρθρα, συντονιστικούς συνδυασμούς και προθέσεις τριών γραμμάτων ή λιγότερων».

Στο Medium, πετάω συχνά την υπόθεση του τίτλου έξω από το παράθυρο και γράφω μόνο τίτλους σαν μια κανονική πρόταση. Περιλαμβάνω ακόμη και σημεία στίξης όπως είναι απαραίτητο. Αυτή η μορφή είναι πιο συνομιλητική και πιο ευανάγνωστη.

Μην χωρίζετε ιστορίες σε μέρη. Ετικέτες όπως το "μέρος 1" φοβίζουν τους ανθρώπους, γιατί ποιος ξέρει πότε θα φτάσετε να γράψετε το μέρος 2. Και αν οι άνθρωποι συναντήσουν το "μέρος 2" και δεν έχουν διαβάσει το μέρος 1, υπάρχει μια καλή πιθανότητα απλά ενοχλήστε είτε να διαβάσετε. Επομένως, είναι πολύ καλύτερο να δημοσιεύσετε μια μόνο σε βάθος ιστορία.

Σύλληψη με εικόνες

Η δεύτερη πιο σημαντική πτυχή της ιστορίας σας είναι η επιλεγμένη εικόνα της.

Το Medium θα κάνει αυτόματα την πρώτη εικόνα στο άρθρο σας την επιλεγμένη εικόνα. Αυτό σημαίνει ότι η μετα-ιδιότητα og-image του άρθρου σας θα είναι αυτή η εικόνα. Αυτή η εικόνα θα χρησιμεύσει ως πρεσβευτής της ιστορίας σας παντού: ροές ειδήσεων στα μέσα κοινωνικής δικτύωσης, Reddit, Ειδήσεις Google - ακόμη και αναγνώστες RSS.

Μπορείτε να αναγκάσετε με μη αυτόματο τρόπο το Medium να αντιμετωπίζει μια συγκεκριμένη εικόνα ως την επιλεγμένη εικόνα του άρθρου σας. Ενώ βρίσκεστε σε λειτουργία επεξεργασίας, κάντε κλικ στην εικόνα και μετά:

  • Mac: ⌘ + Opt + 8
  • Υπολογιστής: Ctrl + Alt + 8

Ξεκινήστε να εξετάζετε εικόνες νωρίς στη διαδικασία γραφής. Και ποτέ μην δημοσιεύετε χωρίς τουλάχιστον μία εικόνα. Διαφορετικά, η ιστορία σας θα είναι σχεδόν αόρατη στις ειδήσεις.

Πρέπει να χωρίσετε μεγάλες ιστορίες με εικόνες. Για να παραφράσω τη Mary Poppins, μια κουταλιά εικόνων βοηθά το κείμενο να μειωθεί.

Το Medium προσφέρει τέσσερα διαφορετικά πλάτη εικόνας. Σημειώστε ότι όλα αυτά θα φαίνονται τα ίδια στο κινητό.

Τις περισσότερες φορές, θα θέλετε να διατηρήσετε το πλάτος της στήλης:

Εάν έχετε ένα γράφημα που είναι δύσκολο να διαβαστεί όταν είναι μικρό, μεγαλώστε:

Και αν είστε πραγματικά περήφανοι για μια εικόνα ή εάν είναι γεμάτη από ενδιαφέροντα δεδομένα, πηγαίνετε πλήρως:

… Και μετά υπάρχει πλαϊνό καπάκι. Μην χρησιμοποιείτε καθόλου αυτό το μέγεθος, επειδή καθιστά το κείμενο λιγότερο άνετο στην ανάγνωση.

Είναι επίσης αμήχανο όταν τελειώσετε να μιλάτε για τη φωτογραφία και το κείμενό σας εξακολουθεί να ωθείται στο πλάι.

Ναι. Είμαι ακόμα κολλημένος εδώ.

Να συμπεριλαμβάνετε πάντα μια εικόνα υψηλής ανάλυσης στην κορυφή μιας ιστορίας κάτω από τον τίτλο σας. Αυτό έχει τα ακόλουθα οφέλη:

  1. Όταν οι άνθρωποι μοιράζονται την ιστορία σας στο Facebook και το Twitter, θα είναι πιο εμφανές στις ροές ειδήσεων, κάνοντας τους ανθρώπους πιο πιθανό να κάνουν κλικ σε αυτήν.
  2. Θα φαίνεται καλύτερα στις ροές ειδήσεων του Medium.
  3. Οι άνθρωποι είναι οπτικά πλάσματα και κάνουν κλικ σε εικόνες.

Δημιουργήστε δυναμική με ισχυρό προβάδισμα

Μόλις ο αναγνώστης σας κάνει κλικ στην ιστορία σας, ξεκινά η δοκιμή. Ψάχνουν οποιαδήποτε δικαιολογία για να επιστρέψουν στη ροή ειδήσεων. Η ανάγνωση απαιτεί πολύ περισσότερη προσπάθεια από την κύλιση σε φωτογραφίες γάτας.

Μην χάνετε χρόνο με εισαγωγές ή ενημερώσεις όπως "Αυτό δημοσιεύθηκε στο ιστολόγιό μου στο [blog URL]" ή "Ενημέρωση: αυτό δημοσιεύτηκε στο Hacker News." Μπορείτε να βάλετε αυτά τα πράγματα στο κάτω μέρος της ιστορίας σας.

Αντ 'αυτού, ξεκινήστε να κάνετε πόντους και να λέτε την ιστορία σας αμέσως.

Καθιερώστε την αξιοπιστία

Βρείτε έναν τρόπο για να αποδείξετε την αξιοπιστία σας μέσα στις πρώτες παραγράφους. Εάν είστε κορυφαίος ειδικός στον τομέα σας, πείτε το. Μην υποθέτετε ότι οι άνθρωποι θα αφιερώσουν χρόνο για να σας google.

"Ποιος μιλάς τόσο δυνατά, δεν μπορώ να ακούσω τι λες." - Ralph Waldo Emerson

Οποιοδήποτε επίτευγμα ή διάκριση που κάνει τους ανθρώπους να σας παίρνουν πιο σοβαρά θα σας βοηθήσει να δώσετε στους αναγνώστες σας την εντύπωση ότι «αυτό το άτομο ξέρει τι μιλάει».

Ενισχύστε την αξιοπιστία σας σε όλη την ιστορία σας. Υποστηρίξτε τα επιχειρήματά σας με δεδομένα. Χρησιμοποιήστε ενσωματωμένους συνδέσμους για έρευνα (χωρίς paywall).

Αυτό δεν είναι το New England Journal of Medicine. Αυτό είναι μεσαίο. Μην χρησιμοποιείτε λοιπόν υποσημειώσεις.

Γράψτε έξυπνα

Η καλή γραφή είναι δύσκολη. Όπως κάθε δεξιότητα, χρειάζεται εξάσκηση. Δεν υπάρχουν συντομεύσεις για να γίνετε δυνατός συγγραφέας.

Κάντε μια χάρη: γράψτε ό, τι γνωρίζετε .

Έχετε ακούσει ποτέ τον όρο "συγγραφείς μπλοκ;" Το μπλοκ του συγγραφέα συμβαίνει όταν δεν γνωρίζετε αρκετά για ένα θέμα για να το γράψετε.

Εάν αντιμετωπίζετε προβλήματα με πράγματα που αξίζουν τουλάχιστον 5 λεπτά για να πείτε σε ένα θέμα - ή εάν η ιστορία σας καταλήγει σε μια λίστα με κουκκίδες - δεν γνωρίζετε αρκετά για αυτό.

Το αντίδοτο είναι η έρευνα. Μάθηση. Βγαίνοντας στο γήπεδο.

Μην δημοσιεύετε τίποτα για το οποίο δεν είστε περήφανοι. Το Medium δεν είναι παιχνίδι αριθμών. Είναι ένα κοινωνικό συμβόλαιο. Οι άνθρωποι σας ακολουθούν. Με τη σειρά του, δείχνετε σεβασμό για τον λιγοστό χρόνο τους.

Οι καλές μεσαίες ιστορίες δεν έρχονται φυσικά. Για κάθε λεπτό διάρκειας ιστορίας, περιμένετε να αφιερώσετε τουλάχιστον μία ώρα για να γράψετε, να ξαναγράψετε και να επεξεργαστείτε την ιστορία σας.

Αποδώστε τις πηγές σας

Ο απλούστερος τρόπος για να αποδώσετε μια εικόνα είναι να βάλετε τις λέξεις "Image credit" κάτω από μια εικόνα και να συνδέσετε αυτό το κείμενο με την αρχική του πηγή.

Εάν αναζητάτε εικόνες που μπορείτε να χρησιμοποιήσετε με ασφάλεια χωρίς άδεια, ρίξτε μια ματιά στο Pexels, το Unsplash ή αναζητήστε στο Google εικόνες με ετικέτα για περαιτέρω χρήση.

Η λογοκλοπή - παραπλανητική γραφή κάποιου άλλου ως δική σας - είναι ένα σοβαρό αδίκημα στο κολέγιο και είναι εξίσου σοβαρό στο Medium. Να αποδίδετε πάντα εισαγωγικά στα άτομα που τα είπαν αρχικά. Εάν πρόκειται για μια προσφορά πολλαπλών γραμμών, θα πρέπει να χρησιμοποιήσετε τα εισαγωγικά pull Medium:

«Όταν έχετε το δικό σας πνεύμα, είναι ευχαρίστηση να πιστώσετε τους άλλους για τα δικά τους».

- Κρίσε Τζαμί

Θα πρέπει να χρησιμοποιείτε μόνο τα εισαγωγικά μεσαίου μεγέθους ως έναν τρόπο για να επισημάνετε τα πραγματικά αποσπάσματα - όχι για να διαμορφώσετε το δικό σας κείμενο.

Δείξτε τον κωδικό σας

Όπου είναι δυνατόν, ο κώδικας πρέπει να είναι σε μορφή κειμένου και όχι σε εικόνες. Αυτό καθιστά τον κώδικα πιο προσβάσιμο στους αναγνώστες οθόνης και είναι πιο εύκολο για τους χρήστες να αντιγράψουν και να επικολλήσουν.

Το Medium έχει μια κρυφή συντόμευση που θα μετατρέψει το απλό κείμενο ως εξής:

εάν (προγραμματιστής === true) {

ακολουθήστε (this.mediumPublication);

}

… Σε ένα μορφοποιημένο μπλοκ κώδικα:

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

Για να το επιτύχετε αυτό, επιλέξτε το κείμενο και, στη συνέχεια, πατήστε:

  • Windows : Control + Alt + 6
  • Mac : Εντολή + Επιλογή + 6
  • Linux : Control + Alt + 6

Μπορείτε επίσης να ξεκινήσετε ένα μπλοκ κώδικα με τριπλά πίσω. Εάν πληκτρολογήσετε τρία backticks ("") σε μια νέα γραμμή, το Medium θα μεταβεί σε λειτουργία εισαγωγής κώδικα.

Για να επισημάνετε τον κώδικα ενσωματωμένο, επιλέξτε τον και, στη συνέχεια, πατήστε το πλήκτρο backtick. Με αυτόν τον τρόπο, μπορείτε να μορφοποιήσετε κείμενο ως κώδικα freeCodeCamp()ακριβώς στη μέση μιας πρότασης.

Μπορείτε ακόμη και να ενσωματώσετε εφαρμογές με δυνατότητα εκτέλεσης απευθείας στο Medium. Σε περίπτωση που αυτές δεν αποδίδονται σωστά στις εφαρμογές για κινητά του Medium, προτείνω να συμπεριλάβετε συνδέσμους κάτω από καθεμία από τις ενσωματώσεις ως εναλλακτικό.

Επικολλήστε ένα URL CodePen.io στο Medium και, στη συνέχεια, πατήστε enter:

Δείτε το CodePen μου εδώ.

Μπορείτε επίσης να το κάνετε αυτό με το JSFiddle.net:

Δείτε το JSFiddle εδώ.

Μερικές φορές οι άνθρωποι ξεκινούν γραμμές κώδικα με ένα $αν είναι τερματικές εντολές. Μην το κάνεις αυτό. Θα προκαλέσει σύγχυση στους αρχάριους και δυσκολεύει την αντιγραφή και επικόλληση εντολών. Αντ 'αυτού, απλώς πείτε κάτι όπως "Εισαγάγετε τις ακόλουθες εντολές στο τερματικό σας."

Κάντε τους συνδέσμους να φαίνονται φυσικοί

Βρείτε έναν τρόπο για να επεξεργαστείτε έναν σύνδεσμο σε μια πρόταση. Ένα πράγμα που δεν συνιστώ να κάνω είναι να βάζεις έναν σύνδεσμο στη δική του γραμμή και να πατάς enter. Αυτό θα δημιουργήσει μια ωραία κάρτα προεπισκόπησης, όπως αυτή:

Πώς να στέκεστε στους ώμους των γιγάντων

Κατακτήστε το σύνδρομο που δεν εφευρέθηκε εδώ και κάντε κάτι νέο. medium.freecodecamp.com

… Αλλά οι αναγνώστες συχνά υποθέτουν ότι είναι διαφημίσεις και δεν τις βλέπουν καν.

Η μόνη φορά που θα συνιστούσα να το χρησιμοποιήσετε είναι στο τέλος της ιστορίας σας, εάν θέλετε να συνδεθείτε με περαιτέρω ανάγνωση.

Η υπογράμμιση του κειμένου καθιστά δυσκολότερη την ανάγνωση, οπότε μόνο υπερσύνδεση λίγων λέξεων.

Μην επικολλάτε απευθείας διευθύνσεις URL, όπως αυτό: www. //www.freecodecamp.com ❌

Αντ 'αυτού, συνδέστε με ιστότοπους όπως το FreeCodeCamp μεσαία πρόταση, όπως το έκανα εδώ.

Ενσωμάτωση μέσων

Μπορείτε να ενσωματώσετε Tweets, βίντεο YouTube και άλλα μέσα, επικολλώντας τα URL τους στο Medium σε μια νέα γραμμή και, στη συνέχεια, πατώντας enter.

Χρησιμοποιήστε τα με φειδώ, καθώς ενδέχεται να αποσπάσουν τον αναγνώστη από το να ολοκληρώσει την ιστορία σας.

Εξηγήστε τις συντομογραφίες

Μην χρησιμοποιείτε συντομογραφία εκτός εάν η συντομογραφία είναι ευρύτερα κατανοητή από ό, τι σημαίνει. Για παράδειγμα, το HTTP είναι ευρύτερα αναγνωρισμένο από το Hypertext Transfer Protocol.

Εάν μια συντομογραφία δεν είναι ήδη ευρέως κατανοητή και πρόκειται να την αναφέρετε περισσότερες από μερικές φορές, μπορείτε να την ορίσετε ως συντομογραφία κάνοντας αυτό:

«Ας σπάσουμε τον κώδικα σε ένα Abstract Syntax Tree (AST).»

Εδώ συνδέθηκα επίσης με το άρθρο της Wikipedia, για την ευκολία των αναγνωστών. Μην υποθέτετε ότι οι άνθρωποι θα διαβάσουν αυτούς τους εξωτερικούς συνδέσμους, ωστόσο. Πρέπει ακόμη να ορίσετε έννοιες ή να τις επεξηγήσετε μέσω παραδείγματος.

Αποφύγετε να ορίσετε μια συντομογραφία στις αρχικές παραγράφους σας, καθώς επιβραδύνει τον αναγνώστη σας και τους καθιστά λιγότερο πιθανό να συνεχίσουν να διαβάζουν.

Ακολουθεί η πολύ σύντομη λίστα της συντομογραφίας τεχνολογίας που δεν χρειάζεται να ορίσετε: API, AJAX, BIOS, CPU, CSS, HTML, HTTPS, JSON, LAN, RAM, REST, USB, WWW, XML. Για οτιδήποτε άλλο, πρέπει να το εξηγήσετε.

Πάντα να γράφετε σύντομες λέξεις πολλαπλών τμημάτων, όπως JavaScript και front-end. Μην τα συντομεύσετε. Η συντομία δεν αξίζει την πιθανή σύγχυση.

Κοίτα και στυλ

Εάν θέλετε να τονίσετε κάτι, χρησιμοποιήστε τολμηρά , αλλά χρησιμοποιήστε το με φειδώ . Τα πλάγια είναι πιο δύσκολο να διαβαστούν. Μην τολμηρές υπερσυνδέσεις - η γραμμή από κάτω τους δίνει ήδη αρκετή έμφαση.

Μην χρησιμοποιείτε πτώση. Φαίνονται κομψά σε παλιά βιβλία, αλλά ανόητα στο διαδίκτυο.

Χρησιμοποιείτε μόνο ένα θαυμαστικό κάθε φορά, συνήθως μόνο μετά από θαυμαστικά όπως: Γκόλυ! Λουκάνικο!

Βάλτε κόμματα και τελείες μέσα σε εισαγωγικά, εκτός εάν μπορεί να προκαλέσει σύγχυση στον αναγνώστη (όπως με μεταβλητά ονόματα ή τίτλους βιβλίων).

Σε ορισμένα μέρη του κόσμου, οι άνθρωποι τοποθετούν κενά πριν από άνω και κάτω τελεία ή ερωτηματικά, όπως αυτό: παράδειγμα. Μην το κάνεις αυτό.

Χρησιμοποιήστε αγγλικά αντί για λατινικά:

  • Χρησιμοποιήστε το "για παράδειγμα" αντί για "EG"
  • Χρησιμοποιήστε το "that is" αντί για "IE"
  • Χρησιμοποιήστε το "σημειώστε ότι" αντί για "NB"
  • Αντί να τερματίζουμε λίστες με "κ.λπ." Ξεκινήστε τα με "like": "Ο Elvis τρώει φαγητό όπως ψωμί, φυστικοβούτυρο και μπανάνες."

Σύμφωνα με τα Βιβλία Google, τα ερωτηματικά πεθαίνουν με αργό θάνατο. Ας τα βάλουμε από τη δυστυχία τους. Απλώς χρησιμοποιήστε μια τελεία και διαχωρίστε τις ρήτρες σε ξεχωριστές προτάσεις.

Χρησιμοποιήστε το Oxford Comma όταν είναι δυνατόν. Κάνει τα πράγματα πιο εύκολα, πιο καθαρά και πιο όμορφα για ανάγνωση.

Χρησιμοποιήστε την εφαρμογή Hemingway. Δεν υπάρχει τίποτα μαγικό για αυτό το απλό εργαλείο, αλλά θα εντοπίσει αυτόματα ζητήματα στυλ που έχουν συμφωνηθεί ευρέως:

  • παθητική φωνή
  • περιττά επιρρήματα
  • λέξεις που έχουν πιο κοινά ισοδύναμα

Η εφαρμογή Hemingway θα εκχωρήσει ένα «επίπεδο βαθμού» για το γράψιμό σας. Ακόμη και οι τεχνικές ιστορίες μπορούν να ξεπεράσουν ένα επίπεδο βαθμού 6. Και πρέπει να φιλοδοξούν.

Οι περισσότεροι άνθρωποι δεν είναι εγγενείς αγγλόφωνοι και αυτοί που δεν κάθονται συνήθως διαβάζοντας το Chaucer όλη την ημέρα. Θέλουν τις πληροφορίες τους προσβάσιμες και στο σημείο.

Σφάλμα από την πλευρά της διάσπασης μακρών προτάσεων και παραγράφων σε μικρότερες.

Παρά τα όσα έχετε μάθει στην τάξη σύνθεσης στα αγγλικά, οι άνθρωποι προτιμούν τις μικρές παραγράφους από τους «τοίχους κειμένου».

Δεν υπάρχει τίποτα λάθος με παραγράφους μίας πρότασης.

Σφάλμα από τη δημιουργία νέων παραγράφων.

Χρησιμοποιήστε συσπάσεις. Θα κάνουν την πεζογραφία σας να φαίνεται πιο συνομιλητική. Αυτό είναι πάντα ένα πλεονέκτημα.

Διατηρήστε την ένταση σας σταθερή καθ 'όλη τη διάρκεια. Εάν μιλάτε για κάτι που συνέβη στο παρελθόν, χρησιμοποιήστε το παρελθόν.

Επίσης, η ανάπτυξη front-end (επίθετη μορφή με παύλα) είναι όταν εργάζεστε στο front end (ουσιαστική φόρμα χωρίς παύλα). Το ίδιο ισχύει και για το πίσω μέρος, την πλήρη στοίβα και πολλούς άλλους σύνθετους όρους.

Προσθέστε 5 ετικέτες

Το Medium σας επιτρέπει να προσθέσετε έως και πέντε ετικέτες στην ιστορία σας. ΧΡΗΣΙΜΟΠΟΙΗΣΕ τους.

Οι χρήστες ακολουθούν συγκεκριμένα θέματα στο Medium. Τα πιο δημοφιλή είναι τα #tech, # life-سبق, #travel, #design και #startup.

Τα άτομα που ακολουθούν τις ετικέτες που χρησιμοποιείτε ενδέχεται να δουν την ιστορία σας στη ροή ειδήσεων. Οι ετικέτες διευκολύνουν επίσης τα άτομα να βρουν την ιστορία σας στα αποτελέσματα αναζήτησης.

Και τώρα που έχετε διαβάσει μέχρι τώρα, δείτε πώς μπορείτε να υποβάλετε την ιστορία σας στη δημοσίευση του FreeCodeCamp: στείλτε ένα email για υποβολή στο freecodecamp org. Συμπεριλάβετε τη διεύθυνση URL για την ιστορία σας στο Medium (κατά προτίμηση ένα μη δημοσιευμένο πρόχειρο) και τη λέξη "μπανάνες", ώστε να γνωρίζουμε ότι έχετε διαβάσει όλα αυτά. Στείλτε μόνο ένα URL ιστορίας ανά email. Δεν χρειάζεται να προσθέσετε τίποτα περισσότερο στο email σας - απλώς διαβάζουμε τις ιστορίες και τις κρίνουμε με βάση τη δική τους αξία.

Δημοσιεύστε τις ιστορίες σας στα κοινωνικά μέσα

Μπορείτε να μοιραστείτε την ιστορία σας στο Twitter, στις ομάδες Facebook και σε σχετικά Subreddits. Εάν έχετε μια λίστα αλληλογραφίας, μπορείτε επίσης να την εκτοξεύσετε στους συνδρομητές σας.

Μπορείτε να δείτε τα στατιστικά στοιχεία της ιστορίας σας σε πραγματικό χρόνο. Ζητήστε σχόλια από τους φίλους και τους οπαδούς σας. Ενσωματώστε αυτά τα σχόλια στην ιστορία σας.

Μην κάνετε κάτι περιγραμματικό για να προωθήσετε την ιστορία σας. Πιθανότατα θα πιαστείτε. Ιστότοποι όπως το Hacker News και το Reddit είναι πολύ καλοί στον εντοπισμό μη φυσιολογικής συμπεριφοράς ψηφοφορίας. Αυτό θα αντικατοπτρίζει άσχημα όχι μόνο σε εσάς, αλλά και ολόκληρη την κοινότητα του FreeCodeCamp.

Τελική συμβουλή

Να θυμάστε ότι όταν δημοσιεύετε στο Medium, ζητάτε από χιλιάδες άτομα να σας δώσουν αρκετά λεπτά από τη ζωή τους. Μην θεωρείτε τους αναγνώστες σας δεδομένους.

Προτού δημοσιεύσετε μια ιστορία, σας προτείνω να κοιμηθείτε, να ξυπνήσετε και να το διαβάσετε ξανά.

Εάν δεν είστε εγγενής ομιλητής στα Αγγλικά και γράφετε στα Αγγλικά, ζητήστε από έναν εγγενή ομιλητή να διαβάσει με προσοχή την ιστορία σας πριν την υποβάλετε σε μια δημοσίευση.

Ανυπομονούμε να διαβάσουμε τις υποβολές σας. Ελπίζω να σας βοηθήσουμε να βελτιώσετε περαιτέρω τις ιστορίες σας και να προσεγγίσετε ένα πολύ ευρύτερο κοινό.