- Kusir, tetapi jauh dari rilis?
- Ya, beberapa pengaturan huruf.
Telah sampai akhir - saya menulis di Habr tentang cara menulis di Habr. Meskipun ada alasan - saya sudah melakukan ini selama lima tahun, saya telah melihat dan mencoba banyak alat, jadi sekarang saya berbagi yang terbaik dengan Anda.
Saya akan berbicara tentang cara beralih dari markup HTML di Habra Editor ke tata letak yang bermakna, desain pos cepat, dan kolaborasi produktif. Di sini adalah tentang pengalaman saya di Yandex.Money dan bagaimana saya mengatur bekerja pada habratexts sehingga tidak akan sangat menyakitkan.
Gaya adalah segalanya bagi kita
Saya akan mulai dengan sesuatu yang bukan yang paling jelas untuk pos seperti itu.
Gaya - hal yang secara aktif saya tanamkan pada kolega dan mahasiswa saya. Ini bukan tentang infostil atau ilmiah dan artistik di sana, tetapi tentang bagaimana teks Anda terlihat. Jika suatu hari Anda belajar membuat gaya , tidak akan ada jalan untuk kembali. (Orang-orang LaTex dengan licik mencibir di tempat ini - kamu terlalu keren, mari kita manusia biasa bersenang-senang dengan desainnya.)
Menu yang tidak ada yang tahu cara menggunakannya
Intinya sederhana - Anda membuat sepotong teks dengan cara yang benar, menyimpan template dan kemudian menerapkannya di mana pun Anda butuhkan. Templat ini disebut gaya di Word dan Google Documents. Siswa yang membuat ijazah dalam gaya adalah 90% lebih bahagia daripada mereka yang secara manual mengubah font, lekukan dan yang lainnya untuk setiap paragraf dan menuju seratus halaman teks.
Dengan Habr, tentu saja, semuanya lebih sederhana - cukup memahami struktur artikel Anda dan mengatur judul pada level yang diinginkan. Berurusan dengan ini cukup sederhana - h1, h2, h3 dan h4 - seperti dalam html.
Berurusan dengan marcdown
Jika Anda tiba-tiba belum melakukannya.
Penurunan harga adalah entitas yang membuatku takut sejak muncul di habra editor. Itu tampak seperti sesuatu yang bermusuhan dan tidak seperti tag HTML biasa dan sepenuhnya ditolak dari dirinya sendiri. Praktek telah menunjukkan bahwa lebih baik memilih salah satu dari dua opsi.
Bahkan jika Anda menulis di editor Habr bawaan (walaupun pemerintah tidak merekomendasikan melakukan hal ini), penurunan harga akan menghemat banyak waktu dan usaha. Meskipun, tentu saja, lebih baik memilih alat lain. Editor Habra cocok untuk pratinjau yang benar, dan itu saja.
Penurunan harga sedikit berbeda dari kasus ke kasus. Habr memiliki penurunan harga dengan seleranya sendiri - tautannya adalah panduan yang dapat dimengerti, yang darinya layak memulai jalan menuju dunia tanpa penderitaan dengan tata letak habrapost.
Di mana menulis?
Tulis di tempat yang nyaman bagi Anda. Satu-satunya hal yang perlu diingat: lebih mudah menulis! = Lebih mudah untuk mengeset untuk Habr. Jika vim nyaman bagi Anda, silakan, dan saya akan berbicara tentang cara-cara menulis teks yang lebih konservatif dan bagaimana mereka berlaku di Habré.
Di Yandex.Money, kami menulis dengan cara yang berbeda - penulis yang berbeda memiliki editor teks yang akrab, dan saya mencoba untuk tidak terlalu memaksa mereka. Beberapa penulis mengirim dokumen teks pada Yandex.Disk atau melalui surat, yang lain menulis segera di pasar atau dalam layanan untuk mengedit bersama.
Visual Studio Code (atau Sublime)
Saya menulis teks ini (dan sebagian besar lainnya) dalam VS Code, tepat di marketdown. Setengah bagian kiri layar untuk teks, dan bagian kanan adalah tampilan teks yang dibuat dalam Markdown melalui plug-in yang sesuai. Plugin ini bernama Markdown MPE Preview - mendukung unduhan gambar dari komputer untuk meningkatkan dan menyisipkan tautan di tempat yang tepat dalam teks.
Post-post, meta-meta
Beberapa orang menulis dapat menyalahkan saya - mereka mengatakan, Sublime Text 3 lebih baik. Saya tahu pasti bahwa ada juga semua yang ada di sana untuk bekerja dengan marqdown - gunakan jika Anda mau. Secara umum, ada lusinan, jika bukan ratusan editor, untuk semua platform dan untuk setiap selera. Yang utama adalah menulis dengan baik :)
Microsoft Word
Jika Anda memiliki komputer Windows, kemungkinan besar Word diinstal di sana. Dan rekan penulis Anda (jika Anda memiliki rekan penulis), kemungkinan besar juga. Ini adalah alat normal dan akrab bagi sebagian besar, meskipun dibayar.
Masalahnya adalah bahwa di Word (jika Anda tidak memiliki langganan royal) Anda tidak dapat mengedit dokumen bersama-sama, yang berarti bahwa pekerjaan akan dikurangi menjadi Draft_Habr_Testing_development_final_2_c_references_from_head_3_notesPR.docx. Rasa sakit ini, sejauh yang saya tahu, menghantui beberapa desainer, ilustrator, dan orang-orang "terkoreksi" lainnya.
Tetapi bahkan ini tidak begitu menakutkan. Masalah utama adalah bahwa tanpa tarian ritual Anda tidak akan melihat teks seperti yang terlihat di situs. Pada awalnya tampaknya ini bukan masalah besar. Kesadaran akan bencana datang setelah beberapa jam pertama dihabiskan untuk mentransfer teks dari file Word.
Jujur, saya tidak mengetahui adanya konverter publik dari doc ke markdown, yang biasanya diterima Habr. Saya tidak ragu bahwa mereka ada, tetapi Yandex.Money habratexts di Word, jika ditulis, hanya oleh beberapa penulis, dan kemudian mereka dengan cepat berubah menjadi penurunan harga.
Google docs
Hal luar biasa yang terkenal, juga gratis. Sebisa mungkin siap untuk karya bersama banyak penulis, editor dan simpatisan lainnya. Fungsionalitas sudah cukup untuk apa saja. Membutuhkan akun Google, tetapi siapa yang tidak memilikinya sekarang?
Lebih nyaman bekerja di Google Dock jika beberapa orang menulis bagian berbeda dari teks yang sama - misalnya, tentang pekerjaan API pembayaran di iOS dan Android. Pengembang berbeda, blok berbeda, paragraf, tetapi semua orang melihat semuanya, dan tidak ada yang hilang di mana pun. Nilai tambah yang terpisah adalah riwayat pengeditan.
Di sini, seperti pada Word, cukup untuk menempatkan judul, dan kemudian ketika mengekspor Anda tidak perlu melakukan banyak pekerjaan yang tidak perlu.
Kontra - jika Anda membagikan tautan ke file, maka jauh lebih mudah untuk membocorkannya di tempat yang salah. Tetapi jika Anda tidak menulis apa pun yang mengandung NDA, maka tidak apa-apa. Semuanya masih rumit di sini dengan pratinjau yang diunggah, tetapi ada plus - mentransfer teks dari google-dock ke hub jauh lebih mudah.
Apa lagi yang terjadi
Masih ada dunia teks yang luar biasa dalam file txt dengan lekukan dalam tiga hingga lima ruang. Untuk alasan etis, saya tidak dapat menunjukkannya (saya takut membukanya sendiri), tetapi percayalah - semua opsi di atas pasti lebih baik.
Bagaimana cara lain untuk meningkatkan hidup Anda
Typographer
Teks Anda akan seratus kali lebih baik jika ada tanda kutip yang benar, tanda hubung dan spasi ganda acak menghilang. Untuk melakukan ini, ada juru ketik studio Lebedev - unggah teks di sana, dan dalam sedetik Anda akan mendapatkan hasil yang indah.
Di sini satu lagi plus penurunan harga ditampilkan di sini - jika Anda menjatuhkan seluruh Google Dock atau file Word yang dibuat-buat ke dalam printer, hasilnya akan tetap mendapatkan teks biasa. Gambar juga akan hilang. Dan tidak ada masalah dengan penurunan harga - tata letak dihasilkan setelah, dan gambar adalah tautan, sehingga Anda dapat melakukan ini dalam jumlah berapa pun, cukup tekan Ctrl + A.
Tentu saja, ini tidak menghilangkan kebutuhan untuk verifikasi teks oleh korektor yang baik. Di sisi lain, jika Anda tidak menulis di blog perusahaan dan hanya berbagi hal-hal di Habré, maka ini adalah bantuan yang baik dalam pekerjaan Anda.
Habraconverters
Teks dari Google Documents dapat ditransfer dengan cara yang berbeda - dengan tangan atau melalui konverter yang berbeda. Saya belum menemukan yang ideal, jadi biasanya saya menggabungkan fungsionalitas dua yang bagus.
Yang pertama adalah https://shirixae.imtqy.com/habraconverter-v2/ . Salin seluruh Google Dock ke dalam kotak teks - itu saja. Ini menghasilkan penurunan harga yang layak jika Anda ingat untuk mengatur header. Ini juga bagus karena menarik tautan ke gambar dari google-dock - mereka, tentu saja, harus dimuat ulang di Habrastorage, tetapi lebih baik daripada tidak sama sekali.
Yang kedua adalah ekstensi Docs To Markdown . Menghasilkan kode penurunan harga terbaik, bekerja dengan baik dengan jeda baris, tetapi tidak tahu tentang gambar.
Mengapa ini penting - jika lima orang menulis teks dengan gambar, maka ternyata cukup sulit untuk mendapatkan dari semua file, yang kemudian perlu disortir, ditata dalam urutan yang benar dan diterbitkan.
Tentu saja, jika Anda menulis sendiri dan semuanya diberi nomor dengan cermat dan diatur dalam ayah, maka cukup unggah ke Habrastorage.
Ketika saya mengedit teks beberapa penulis, saya melakukan ini - saya mengambil teks dari konverter kedua, dan mengunggah kembali gambar ke Habrastorage menggunakan tautan dari yang pertama. Kedengarannya tidak super sederhana, tetapi menghemat waktu yang tak terbatas.
Kiat bermanfaat tentang penurunan harga dan lainnya
- Bagi teks menjadi paragraf . Tolong!
- Gambar di Habrastorage . Ini jelas, tetapi lebih baik diulang. Tidak ada yang lebih buruk daripada membuka posting yang bermanfaat lima tahun lalu dan menyadari bahwa tautan ke gambar sudah lama rusak. Omong-omong, HS memberikan tautan siap pakai yang dibungkus dengan Markdown.
- Dalam penomoran daftar, hanya elemen pertama yang penting, masukkan sisanya sesuka Anda. Ini berguna jika Anda memutuskan untuk mengatur ulang elemen daftar dengan 10 elemen, tetapi terlalu malas untuk mengubah angka.
- Tabel - gambar . Dalam marqdown, tabel lucu yang memecah otak untuk beberapa kali pertama, tetapi Habr tidak tahu cara menampilkannya dengan indah - teks dalam sel ditransfer ke baris baru. Lebih baik menggambar mereka di tempat lain dan menanamkan PNG.
upd. Tip yang baik dari opanas dari komentar adalah "disarankan untuk menempatkan spoiler di dekat meja gambar (di mana tabel akan berupa teks dan pembaca akan dapat menyalin, dan robot akan mengatasi pengindeksan)". - Google dock baru dibuat menggunakan tautan doc.new baru - menambahkannya ke bilah bookmark untuk menghemat waktu setiap kali.
- Simpan konsep - sinkronkan dengan beberapa cloud. Tentu saja, Anda selalu bisa mendapatkan tata letak dari publikasi di Habré, tetapi, seperti yang ditunjukkan oleh praktik, itu lebih dapat diandalkan.
- Lekukan antara heading dari level yang berbeda adalah hal yang paling acak di dunia, setidaknya untuk 30 kali pertama. Pastikan untuk memeriksa ulang sebelum publikasi bahwa Anda memiliki lekukan normal dalam teks.
- HTML yang dicampur dengan Habr-markdown dapat membuat bug lucu di editor pihak ketiga. Misalnya, jika Anda menggunakan
<code/> dan lupa menutupnya dengan benar. Ternyata seperti ini:
Kesimpulan
Semua tips dalam posting ini diambil dari pengalaman pribadi. Mereka hanya akan membantu menghemat waktu dan kegelisahan pada pekerjaan tambahan yang perlu dilakukan dalam mempersiapkan posting - dan tidak ada yang membatalkan penulisan teks yang menarik.
Praktik menunjukkan bahwa jika Anda tertarik untuk menulis tentang sesuatu, tata letak, atau html, atau kompleksitas konversi tidak akan menghentikan Anda. Anda akan berhasil mengisi semua gambar, menempatkan tajuk dan tag dengan tangan Anda, memformat kode, dan kiriman akan tetap bagus - karena, jelas, teks lebih penting daripada desain. Tapi tidak ada yang mengganggu untuk membuat pembaca menjadi cantik dan menyenangkan. Jadi, Anda perlu melakukannya.
Jadi menang.