İ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.
https://anadolu.otomatikmuhendis.com
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"},
...
]
- Değişiklik yapmak istediğiniz sayfada
Bu sayfayı düzenle
bağlantısına tıklayın. - 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.
- 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.
- Bu kod deposunu (repository) kendi hesabınıza kopyalayın (fork).
- Github Desktop aracını veya Git komut satırı aracını kullanarak projeyi bilgisayarınıza indirin (clone).
- İstediğiniz değişikliği gerçekleştirip kaydedin.
- Git aracınızı kullanarak değişikliği kendi hesabınızdaki kopyaya gönderin (commit ve push).
- 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.
- 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. - Kodu indirin veya bu komut ile klonlayın
git clone https://github.com/otomatikmuhendis/anadolu.git
- Siteyi artık local'de çalıştırabilirsiniz
jekyll serve
- Bu adreste ulaşılabilir http://127.0.0.1:4000/ ve dosya/stil değişiklikleri için tekrar çalıştırmanız gerekmez.
- Değişikliklerinizi ana branchinize pushladığınızda Github Pages sayfaları oluşturacak ve websitenizi yayınlayacaktır.
- Jekyll - Dinamik şekilde statik sayfa üretimini sağladıkları için
- ozgrozer - Tasarım için
- dnomak - Harita için
Bir konu açın ve konuşalım.
Kaynak gösterilerek istenilen her yerde kullanılabilir.