Veri Veri Anadolu

İllere göre verilerin sınıflandırıldığı bir websitesi. Açık kaynaklı bu proje her türlü katılıma açıktır. Katkıda bulunmak isteyenler istedikleri verileri ekleyebilir, gönülleri isterse verinin gösterim biçimini dahi istedikleri şekilde düzenleyebilirler.

Site içeriği Markdown formatında yazılır. _posts klasörü içerisinde .md uzantısıyla saklanır. Bu klasöre ekleme yapabileceğiniz gibi var olan dosyalar içerisinde de değişiklik yapabilirsiniz. Bu dosyalar Jekyll ile html sayfalara otomatik olarak dönüştürülür.

Bu projede Doğukan Güven Nomak tarafından hazırlanan Türkiye haritası ve Özgür Özer tarafından hazırlanan site tasarımı kullanılmıştır.

Site

https://anadolu.otomatikmuhendis.com

API

Site örnek olması amacıyla bir adet de API endpoint içermektedir. YAML formatlı bir veriyi otomatik olarak JSON haline dönüştürerek kolay erişimi sağlanmıştır.

GET https://anadolu.otomatikmuhendis.com/api/cities.json

[
    {"id":1,"name":"Adana","plateNumber":"01"},
    {"id":2,"name":"Adıyaman","plateNumber":"02"},
    ...
]

Katkıda bulunmak

Site üzerinden

1. Değişiklik yapmak istediğiniz sayfada Bu sayfayı düzenle bağlantısına tıklayın.
2. Açılan github sayfasında değişikliğinizi yaptıktan sonra kaydedin bu işlem projeyi kendi hesabınıza kopyalamayı (fork) sağlar.
3. Açılan yeni sayfada Create a pull-request butonunu tıklayın ve yaptığınız değişiklik hakkında kısa bir açıklama girerek işlemi sonladırın.

Bilgisayar üzerinden

1. Bu kod deposunu (repository) kendi hesabınıza kopyalayın (fork).
2. Github Desktop aracını veya Git komut satırı aracını kullanarak projeyi bilgisayarınıza indirin (clone).
3. İstediğiniz değişikliği gerçekleştirip kaydedin.
4. Git aracınızı kullanarak değişikliği kendi hesabınızdaki kopyaya gönderin (commit ve push).
5. Github sitesi üzerinden kendi hesabınızda ki kopyayı açın ve Create a pull-request butonunu tıklayın. Yaptığınız değişiklik hakkında kısa bir açıklama girerek işlemi sonladırın.

Local'de Çalıştırmak

1. Konsolda bu komutu kullanarak gerekli pluginleri yükleyin gem install github-pages GitHub Pages tarafından kullanılan pluginler yüklenir. Bunlara Jekyll da dahildir. Tam listesi için tıklayınız.
2. Kodu indirin veya bu komut ile klonlayın git clone https://github.com/otomatikmuhendis/anadolu.git
3. Siteyi artık local'de çalıştırabilirsiniz jekyll serve
4. Bu adreste ulaşılabilir http://127.0.0.1:4000/ ve dosya/stil değişiklikleri için tekrar çalıştırmanız gerekmez.
5. Değişikliklerinizi ana branchinize pushladığınızda Github Pages sayfaları oluşturacak ve websitenizi yayınlayacaktır.

Teşekkürler

• Jekyll - Dinamik şekilde statik sayfa üretimini sağladıkları için
• ozgrozer - Tasarım için
• dnomak - Harita için

Soru

Bir konu açın ve konuşalım.

Telif

Kaynak gösterilerek istenilen her yerde kullanılabilir.