Bu website Degz Robotik tarafından üretilen ve satışu yapılan ürünler hakkında dokümanları içerir. Bu repository'de yapılan değişiklikler wiki.degzrobotics.com üzerinde yayınlanacaktır. Eğer dokümantasyonu yazarken kırık link vermediyseniz commit kabul edildikten sonra birkaç dakika sonra websitesinde yayımlanmış olacaktır.
This website contains documents about products manufactured and sold by Degz Robotics. Changes made to this repository will be published on wiki.degzrobotics.com. If you did not provide a broken link when writing the documentation, it will be published on the website a few minutes after the commit is accepted.
Github Pages üzerinden hostlanan wiki.degzrobotics.com'e sizde katkı sağlayabilirsiniz. Bu sayfadaki adımları inceleyerek hızlıca düzenleyebilirsiniz.
You can also contribute to wiki.degzrobotics.com hosted on Github Pages. You can quickly edit it by following the steps on this.
wiki.degzrobotics.com(dokümanlar) Degz Robotik Sanayi tarafından üretilen araçlar ve ürünler için herkesin hızlı bilgiye ve doğru şekilde ulaşmasını hedeflemektedir.
Her dokümanın altındaki Bu sayfayı düzenle
butonuna basarak sayfanın bulunduğu github reposuna gidebilirsiniz.
- VSCode linkten indirip kurun.
- Git (versiyon takip yazılımı) linkten indirip kurun.
- GitHub Desktop (versiyonları takip etmenize yarar.) indirip kurunuz.
- Node.js kurulması
- Yarn kurulması
VSCodeda eklenti kısımına gelip. Aşağıdaki eklentileri kurunuz.
- İlk olarak GitHub Desktop uygulamasını açın.
- Kayıtlı olduğunuz repolardan
degzrobotics/wiki
reposunu arayıp tıklayın. - Kurulacak dizini kontrol edip. Clone butonuna basınız.
- Gelen arayüzde projede değişiklik olduğunda güncelleme olup olmadığını gösterir.
Open in Visual Studio Code
butonuna basarak vscode ile dokümanları düzenleyebilirsiniz.- VSCode açılacaktır. Sol kısımdaki dosyalardan
docs
klasörüne tıklayıp genişletin. - Açılan klasörde daha önceden oluşturulmuş olan sayfalar bulunmaktadır.
- Örnek olarak birini düzenleyelim.
- Projenin gereksinimlerini kurunuz. Ayrıca derlenme adımlarını uygulayınız. Çünkü doğru derlenmeyen bir proje GitHub'da çalışmayacaktır. Commit etmeden önce kendi bilgisayarınızda denemeniz tavsiye edilir. Eğer sorun yoksa commit edip güncelleyebilirsiz. Derleme ve kurulum adımları
- Düzenledikten sonra dosyayı
CTRL + S
butonu ile kaydetmeyi unutma. Ve Github Desktop uygulamasını aç. - Yaptığın değişikliklere ait bir yorum yap ve
Commit to Main
butonuna basarak yaptığın değişiklere yorum yap. - Son olarak yaptığın değişikleri
push
butonuna basarak githuba gönder.
Not: Herhangi bir sorun yoksa birkaç dakika için websayfası güncellenecektir.
yarn
Bu komutla daha önceki eklenen tüm kütüphaneleri indirmenizi sağlar.
Local(kendi) bilgisayarınızda yaptığınız değişikleri görmek için canlı bir server oluşturun.
yarn start
Sunucuya commit etmeden önce projeyi build
edip localde build edilen dosyayı run
etmeniz gerekmektedir. Şu şekilde yapılır.
yarn build
Şimdi build edilen dosyalarla serveri başlatalirsin.
yarn run serve
Eğer çalışan serverdaki sitede hata gözükmüyorsa websitesine ilgili değişiklikleri iletebilirsin.
Sitede içerik paylaşmak için markdown bilmeniz gerekmektedir. Markdown, metinleri basit bir şekilde biçimlendirmek için kullanılan bir işaretleme dilidir. Web içeriği yazarken kullanılır ve metni başlıklar, listeler, bağlantılar gibi öğelere dönüştürmek için basit işaretler ve semboller kullanır. Örneğin, *içerik*
-> içerik şeklinde italik metin, **metin**
-> metin ise kalın metin yapar. Markdown, okunabilirliği ve yazım kolaylığını ön planda tutar.
Markdown öğrenmenin en hızlı yolu denemektir. Kaynak olarak gruntwork.io sitesinde bu dokümanı takip edebilirsin.
Bu websitesi docusaurus kullanıyor. Docusaurus ile uyumlu özellikleri efektif şekilde kullanmak için bu Markdown Özellikleri sayfasını takip edebilirsin.
Siteye tablo eklerken hızlıca oluşturabilmek adına tablo kulanabiliriz. Markdown Table Generator
wiki bir Degz Robotik ve topluluğunun ürünüdür.