Menulis, Dan Biarkan Dunia Merevisi Pekerjaan Anda Dengan Prose.io Untuk GitHub

Iklan

Secara tradisional, menulis adalah urusan soliter. Hanya Anda dan layar, atau selembar kertas. Manusia versus teks dalam pertempuran kemauan, kecerdasan, dan emosi, sampai tiba-tiba - Anda selesai. Sekarang saatnya untuk menunjukkan kepada dunia, untuk meletakkan teks Anda di sana dan menonton apa yang terjadi. Tetapi di masa digital ini, itu bukan satu-satunya cara untuk menulis.

Bagaimana jika itu semua di tempat terbuka, selama ini? Bagaimana jika dunia dapat melihat revisi Anda dan mengikuti, membuat saran? Di depannya, ini mungkin tampak seperti ide yang mengerikan - tetapi untuk beberapa jenis teks (dan untuk penulis tertentu), kolaborasi terbuka seperti itu mungkin merupakan keuntungan. Prosa adalah platform penerbitan online sederhana yang berinteraksi dengan GitHub untuk memungkinkan Anda mengedit teks online dan tetap menggunakan revisi Git Apa itu Git & Mengapa Anda Harus Menggunakan Kontrol Versi Jika Anda PengembangSebagai pengembang web, seringkali kita cenderung bekerja di situs pengembangan lokal kemudian mengunggah semuanya ketika kita selesai. Ini bagus jika itu hanya Anda dan perubahannya kecil, ...

Baca lebih banyak .

Mulai

Untuk bekerja dengan Prosa, Anda harus terlebih dahulu memiliki akun GitHub. Dengan asumsi Anda masuk ke Git, cukup klik tombol Otorisasi Prosa:

Git kemudian akan bertanya apakah Anda yakin ingin mengesahkan Prosa. Prosa membutuhkan beberapa izin, tetapi semuanya masuk akal:

Selanjutnya, Anda akan menemukan diri Anda kembali di Prosa, melihat daftar semua repositori Git Anda:

Jika Anda menyukai saya, tidak ada repositori Anda yang ada yang cocok untuk banyak teks. Tentu saja, ini mungkin tidak benar untuk Anda: Misalnya, jika Anda menggunakan Jekyll kerangka kerja penerbitan, Anda mungkin sudah memiliki repositori hanya menunggu teks. Bahkan, banyak Prosa tampaknya dibangun dengan mempertimbangkan pengguna Jekyll: Prose bahkan memungkinkan Anda menerbitkan ke Jekyll. Karena itu, Anda tidak perlu Jekyll memanfaatkan Prosa, dan saya telah melihatnya tanpa menghubungkannya dengan hal lain.

Jadi, untuk memulai, mari buat rumah baru untuk teks kita.

Membuat Repositori GitHub Baru

Untuk membuat repositori GitHub baru, Anda harus kembali ke GitHub sendiri - ini bukan sesuatu yang dapat Anda lakukan di Prosa. Prosa menyarankan penamaan "dokumen" repositori baru Anda, jadi itulah yang saya lakukan.

Segera setelah membuat repositori, itu muncul dalam Prosa:

Mengedit Dokumen

Mengklik ke dalam repositori Dokumen baru saya, saya disambut oleh README.md default GitHub. MD, dalam hal ini, adalah singkatan dari Markdown - format sederhana yang sama yang digunakan oleh Dillinger.io Dillinger: Edit & Lihat Penurunan Harga Secara Real Time Baca lebih banyak , TextDown TextDown: Dapatkan Editor Markdown Dibangun di Google Chrome Baca lebih banyak , WriteMonkey WriteMonkey - Editor Teks Sederhana Untuk Orang yang Mudah Teralihkan Baca lebih banyak , dan banyak editor lainnya. Jika Anda telah menulis teks untuk penggunaan online untuk jangka waktu yang lama, kemungkinan Anda telah menemukan penurunan harga lebih dari sekali.

Mengklik pada dokumen, antarmuka pengeditan sederhana muncul:

Ini benar-benar bebas dari iklan apa pun, dan memiliki skema warna tidak aktif yang mudah dilihat. Ia juga memiliki penyorotan sintaks untuk Markdown, dan alih-alih panel pratinjau instan (seperti yang digunakan di Dillinger.io), pratinjau teks yang diterjemahkan ke dalam HTML memerlukan klik bilah alat cepat:

Anda dapat membuka layar pratinjau menggunakan Ctrl + Shift + panah kanan. Ctrl + Shift + panah kiri membawa Anda ke lembar cheat Markdown, jika Anda ingin menyegarkan ingatan Anda.

Editornya enak, tetapi tidak menawarkan fitur penghitungan kata langsung, sesuatu yang saya harapkan dari alat apa pun yang ditujukan untuk penulis. Itu juga menonaktifkan pemeriksa ejaan internal Chrome, membuat teks Anda jauh lebih rentan terhadap kesalahan ketik.

Penerbitan (Atau Hemat)

Kecuali jika Anda menggunakan Jekyll, penerbitan dan penyimpanan adalah hal yang hampir sama: Begitu Anda menyimpan, teks Anda dikomit ke repositori GitHub. Kecuali jika Anda adalah pengguna GitHub yang membayar dan memilih repositori pribadi, ini berarti semua orang sekarang dapat melihat teks Anda. Komit pertama terlihat seperti ini:

Dan setelah beberapa coretan cepat, riwayat komit GitHub untuk repositori tampak seperti ini:

Sangat transparan, tetapi juga aman: Revisi membuatnya hampir tidak mungkin kehilangan pekerjaan Anda. Anda dapat menyimpan, lalu menghapus sebagian besar dokumen Anda, tetapi Anda selalu bisa mendapatkannya kembali. Ini seperti fitur Undo yang tidak terbatas yang tetap berfungsi meskipun Anda mematikan komputer atau pindah ke yang lain.

Ini jauh dari semua yang dapat dilakukan Prosa: Misalnya, Anda dapat menggunakan Prosa untuk mengedit dokumen orang lain dan mengirimkan permintaan tarik agar mereka menerima revisi Anda - seperti yang dilakukan oleh pembuat kode. Ada banyak hal lain yang dapat Anda lakukan dengan Prosa, tetapi prinsip intinya tetap sama: Git untuk menulis.

Pikiran terakhir

Bagi saya, Prosa terasa lebih seperti undangan daripada alat. Undangan untuk berpikir, menulis, konsep, di tempat terbuka. Untuk mengatasi "ketakutan publikasi" dengan terus-menerus menerbitkan saat Anda menulis, sehingga tidak ada satu pun "Saat Kebenaran" - pemikiran Anda telah ada di luar sana di dunia selama ini, kesalahan ketik, inkonsistensi, dan semua. Ada cara lain untuk melakukan ini, dari wiki hingga klien standar Git, tetapi Prosa tidak berpura-pura menjadi ide eksklusif - hanya mengemas segala sesuatunya dengan rapi sehingga konsepnya menonjol. Apakah ini cara yang tepat bagi Anda untuk menulis atau tidak adalah pilihan pribadi - pilihan yang saya ingin tahu tentangnya, jika Anda memberi tahu saya di komentar.