GitHub için Prose.io ile İşinizi Yazın ve Revize Edin

İlan

Geleneksel olarak, yazı yalnız bir olaydır. Sadece sen ve ekran ya da bir kağıt parçası. Aniden, işiniz bitene kadar insan, vasiyet, akıl ve duygu savaşında metne karşı. Şimdi dünyayı göstermenin, metninizi oraya koymanın ve neler olduğunu izlemenin zamanı geldi. Ancak bu dijital zamanlarda, yazmaya devam etmenin tek yolu bu değil.

Ya olsaydı herşey başından sonuna kadar açık mı? Ya dünya revizyonlarınızı görebilir ve takip ederek önerilerde bulunabilirse? Yüzünde, bu korkunç bir fikir gibi görünebilir - ancak bazı metin türleri (ve bazı yazarlar için), böyle açık işbirliği bir nimet olabilir. Nesir Metni çevrimiçi düzenlemenize ve kullanarak revizyonları sürdürmenize izin vermek için GitHub ile arayüz oluşturan basit bir çevrimiçi yayıncılık platformudur Git Git Nedir ve Geliştirici iseniz Neden Sürüm Denetimi Kullanmalısınız?Web geliştiricileri olarak, çoğu zaman yerel geliştirme sitelerinde çalışma eğilimindeyiz ve işimiz bittiğinde her şeyi yüklüyoruz. Sadece sen ve değişiklikler küçük olduğunda bu iyi, ... Daha fazla oku .

Başlangıç

Prose ile çalışmak için önce bir GitHub hesabınızın olması gerekir. Git'e giriş yaptığınızı varsayarsak, Düzyazı Yetkilendirme düğmesini tıklamanız yeterlidir:

Git daha sonra Prose'ye yetki vermek istediğinizden emin olup olmadığınızı soracaktır. Düzyazı oldukça az izin gerektirir, ancak hepsi mantıklıdır:

Ardından, Git depolarınızın bir listesini inceleyerek kendinizi Prose'de bulacaksınız:

Benim gibiyseniz, mevcut depolarınızın hiçbiri bir grup metin için uygun değildir. Tabii ki, bu sizin için doğru olmayabilir: Örneğin, Jekyll yayınlamak için, zaten metin bekleyen bir havuzunuz olabilir. Aslında, Prose'nin çoğu Jekyll kullanıcıları göz önünde bulundurularak oluşturulmuş gibi görünüyor: Prose, Jekyll'de yayınlamanıza bile izin veriyor. Dedi ki, sen değilsin ihtiyaç Jekyll, Prose'den faydalanmak için, ben de başka bir şeye bağlamadan baktım.

Başlamak için metnimiz için yeni bir yuva yapalım.

Yeni GitHub Deposu Oluşturma

Yeni bir GitHub deposu oluşturmak için GitHub'ın kendisine geri dönmeniz gerekir - bu, Prose üzerinde yapabileceğiniz bir şey değildir. Prose yeni deponuza “belgelerinizi” isimlendirmenizi önerir, ben de öyle yaptım.

Depoyu oluşturduktan hemen sonra, Prose içinde ortaya çıktı:

Bir Belgeyi Düzenleme

Yeni Belgeler havuzumu tıklattığımda GitHub’ın varsayılan README.md dosyası tarafından karşılandım. MD, bu durumda, Markdown anlamına gelir - aynı basit format Dillinger.io Dillinger: Markdown'u Gerçek Zamanlı Olarak Düzenleme ve Görüntüleme Daha fazla oku , TextDown TextDown: Google Chrome'da Dahili Bir Markdown Editör edinin Daha fazla oku , WriteMonkey WriteMonkey - Kolayca dikkati dağılanlar için basit bir metin editörü Daha fazla oku ve sayısız editör. Herhangi bir süredir çevrimiçi kullanım için metin oluşturuyorsanız, Markdown ile bir kereden fazla karşılaşmış olma olasılığınız yüksektir.

Belgeye tıklandığında, basit bir düzenleme arayüzü geldi:

Mutlaka herhangi bir reklam içermez ve gözleri kolay bir sessiz renk şemasına sahiptir. Ayrıca Markdown için sözdizimi vurgulama özelliğine sahiptir ve anında önizleme bölmesi yerine (Dillinger.io'da kullanılan gibi) HTML'ye dönüştürülen metninizi önizlemek için hızlı bir araç çubuğu tıklaması gerekir:

Ctrl + Shift + sağ ok tuşlarını kullanarak önizleme ekranına ulaşabilirsiniz. Ctrl + Üst Karakter + sol ok, belleğinizi yenilemek istiyorsanız sizi bir Markdown hile sayfasına götürür.

Editör zevkli, ancak canlı bir kelime sayımı özelliği sunmuyor, yazarlara yönelik herhangi bir araçtan beklediğim bir şey. Ayrıca, Chrome’un yerleşik yazım denetleyicisini devre dışı bırakarak metninizi yazım hatalarına daha yatkın hale getirir.

Yayınlama (Veya Kaydetme)

Jekyll'i kullanmadığınız sürece, yayınlamak ve kaydetmek hemen hemen aynı şeydir: Kaydettiğiniz anda metniniz bir GitHub deposuna bağlıdır. Ücretli bir GitHub kullanıcısı değilseniz ve özel bir havuz seçmediyseniz, bu, artık herkesin metninizi görebileceği anlamına gelir. İlk taahhüt şu şekilde görünüyordu:

Birkaç hızlı karalama işleminden sonra, GitHub’ın depo için taahhüt geçmişi şuna benziyordu:

Çok şeffaf ama aynı zamanda güvenli: Revizyonlar işinizi kaybetmeyi neredeyse imkansız hale getiriyor. Belgenizin büyük bir bölümünü kaydedebilir, ardından kaldırabilirsiniz, ancak her zaman geri alabilirsiniz. Bilgisayarınızı kapatsanız veya başka bir bilgisayara geçseniz bile çalışmaya devam eden sınırsız bir Geri Al özelliği gibidir.

Bu, Prose'nin yapabileceği her şeyden uzaktır: Örneğin, başka bir kişinin belgesini düzenlemek ve düzeltmelerinizi kabul etmeleri için tıpkı kodlayıcıların yaptığı gibi bir çekme isteği göndermek için Prose'yi kullanabilirsiniz. Prose ile yapabileceğiniz başka birçok şey var, ancak temel prensibi aynı kalıyor: Yazmak için Git.

Son düşünceler

Bana göre, Prose bir araçtan çok bir davet gibi hissediyor. Düşünme, oluşturma, taslak, açıkta bir davet. Yazarken sürekli yayınlayarak “yayın korkusunun” üstesinden gelmek, böylece tek “Gerçeğin anı” - düşünceleriniz tüm dünyada orada, yazım hataları, tutarsızlıklar, ve tüm. Wiki'lerden standart Git istemcilerine kadar bunu yapmanın başka yolları da var, ancak Prose özel bir fikir gibi davranmıyor - kavramın öne çıkması için işleri düzgün bir şekilde paketliyor. Yazmanızın doğru yolu olsun ya da olmasın kişisel bir seçimdir - yorumlarda söylerseniz, duymayı merak ettiğim bir seçim.