Pardus Bireysel

Not: Bu sayfa gönüllü bir topluluğa aittir. Resmi Pardus Sitesini veya GitHub sayfasını ziyaret etmek istemiş olabilirsiniz

Bireysel Pardus kullanımı için geliştirme/eğitim faaliyetleri gösteren ve bu neticede topluluk tarafından geliştirilen bireysel Pardus sürümü/araçları.

Biz Kimiz

Bireysel kullanıcıların Pardus'u daha rahat kullanabilmesi için çeşitli alanlarda çalışan gönüllü bir topluluğuz.

Misyonumuz

Bireysel kullanıcıların Pardus ekosistemini daha rahat kullanabilmesi ve bu ekosisteme alışabilmesi için gerekli geliştirme, dokümantasyon, eğitim, sorun giderme, teknik destek vb. süreçleri yürütmek. Resmi Pardus ekibi ile yarı-işbirlikçi bir şekilde çalışarak topluluk olarak Pardus'un gelişimine katkı vermek. Topluluğu bilinçlendirmek, Pardus'un bilinirliğini ve kullanım oranını arttırmak.

Projelerimiz

• PardusBireysel (Pardus XFCE sürümünü KDE sürümüne dönüştüren betik)
• docs (Dokümantasyon sayfası)

SSS (Sıkça Sorulan Sorular)

Projenin Durumu

Proje şu anda aktif geliştirme aşamasındadır ve günlük kullanıma uygun DEĞİLDİR

Contributing

1. Conventional Commits dokümantasyonuna uygun şekilde commit mesajları oluşturun.
2. Eğer bir hata bulursanız veya bir sorunuz varsa lütfen GitHub sayfası üzerinden issue oluşturun.
3. Eğer yeni bir fikriniz varsa lütfen GitHub sayfası üzerinden yeni bir discussion oluşturun.
4. Değişikliklerinizi main koluna PR olarak ekleyebilirsiniz.
   1. Eğer değişiklikleriniz hâlihazırda geliştirilen bir kolu ilgilendiriyorsa lütfen o kolu çatallayın ve gerekli değişiklikleri o kola PR olarak gönderin.
   2. Eğer ilgili kollar için yetkiniz varsa direkt geliştirme aşamasındaki PR'e ekleme yapın.
5. Eğer oluşturduğunuz PR'ı ilgilindiren bir issue varsa lütfen hem commit mesajında hem de PR açıklamasında belirtin
6. PRları olabildiğince kısa ve üzerinde çalıştığınız geliştirme ile ilgili olacak şekilde tutunuz. Binlerce satırlık PRlardan kaçınınız
7. İlginiz ve desteğiniz için teşekkürler :)

Prepare Development Environment

1. Comment Anchor eklentisini kullanın (veya kodlar içinde TODO/REVIEW/NOTE/FIXME anahtar kelimelerini aratın)
2. Spellcheck eklentisini kurun (veya terminalden çalıştırın), dosyalar arası çalışmak için -x argümanını kullanmayı unutmayın!
3. Bash IDE eklentisini kurun

Dil Yönetimi

Daha okunaklı kodlar ve dokümantasyonlar için olabildiğince dilleri aşağıda gösterildikleri uygun yerlerde kullanmaya özen gösteriniz:

• Kod İçi Yorumlar, Fonksiyon açıklamaları vb: ENG
• Kod İçi Geçici Yorumlar (TODO/REVIEW/FIXME/NOTE): TR/ENG karışık
• Commit Yorumları: ENG (Conventional commits)
• Issue'lar: çoğunluk TR
• Pull Request Başlığı: ENG
• Pull Request Açıklamaları: TR/ENG
• Issue / PR Yorumları: TR/ENG
• Dokümantasyon: TR (mdbook multilanguage destekleyince ek olarak ENG)

About This Documentation

1. Dokümantasyonu düzenlerken commit mesajlarınızın conventional commits şekline uyduğundan ve sadece ilgili bir alan için tek commit attığınızdan emin olunuz
2. Onay Listesi oluştururken arada boşluk bırakmamaya dikkat ediniz, aksi takdirde onay kutusu ile yazı arasında boş satır kalmakta!

Roadmap

Betik

Komut satırından çalıştırılabilen betiğimiz

• Uygulamaların Düzenlenmesi
  • Gereksiz görülen uygulamaların silinmesi
  • Daha kullanıcı dostu uygulamaların yüklenmesi
• KDE Ortamı
  • KDE ortamının yüklenmesi (WIP) (pkde'den)
  • Kullanıcı dostu varsayılan KDE ayarları (pkde'den)
  • ...
• Ekstra
  • Advanced Argument/Flag Handling
    • see these
  • Help text (tr)
  • Man pages (tr-en)

GUI

Diğer Uygulamaların yüklenmesi, sürecin kontrol edilmesi adına hâlihazırdaki betiğin yaptığı işlemleri yapan GUI uygulamasının yazılması

• (WIP) GUI Toolkitine karar verilmesi: GTK, QT
  • İlgili GUI toolkitinin öğrenilmesi
• (WIP) Programlama diline karar verilmesi: Rust, Python, C, C++ ...
  • İlgili programlama dilinin öğrenilmesi ve basit GUI toolkit uygulamalarının denenmesi
• Kullanıcı ayarları yedekleme butonu
• Kurulum Butonu ...
• ...
• Komut satırı üzerinden kontrol için gerekli komutların sağlanması, betik içindeki tüm komutların uygulanabilmesi
  • Betik'in kullanım ömrünün dolması ve geliştirmelere GUI üzerinden devam edilmesi

Uygulamalar

Kullanım kolaylığı sağlayacak kullanıcı dostu uygulamalar yazmak, (MXLinux / Mint vb. distrolar içindeki faydalı araçların benzerleri ve daha fazlası!)

• KDE Hoşgeldin uygulaması (pardus-xfce-greeter benzeri)
• Pardus servis görüntüleyici (MXLinux forku) (ÖRNEKTİR)
• ...

Paket Deposu

Depo paketleri sunmak (öncelikli değil!)

• Firefox Güncel Sürümünün build edilmesi ve paket olarak sunulması
• Çeşitli uygulamaların v3 sürümlerinin sunulması
• ...

Ekstra

Dokümantasyon & Eğitim & Tanıtım amaçlı çeşitli içeriklerin oluşturulması (öncelikli değil!)

• Dokümantasyon
  • Geniş bir kullanıcı dokümantasyonunun oluşturulması
  • Geliştirici dokümantasyonunu sürekli güncellemek
• Eğitim
  • gonullu.pardus.org.tr üzerinde faydalı blog yazıları paylaşmak
  • Video içerikleri (Nasıl Yapılır / Sorun Çözme) hazırlamak (YouTube/PeerTube)
  • Ayrı bir blog sayfasının oluşturulması (gerek var mı?)
• Tanıtım
  • Pardus'un daha fazla kişiye ulaşmasını sağlayacak, Pardus/Özgür yazılım dünyası ile ilgili gelişmelerin aktarılacağı:
    • Instagram hesabı açmak.
    • Twitter hesabı açmak.
    • Fediverse hesabı açmak.
    • Platformlar arası otomatik paylaşım mekanizması oluşturulması

docs Roadmap

• Multilanguage Support (TR/EN)
• Index and 404 page support
• runnable bash scripts support
• Add useful tools like in https://rust-lang.github.io/mdBook/for_developers/backends.html
• Look https://rust-lang.github.io/mdBook/for_developers/preprocessors.html

pardus-bireysel Index

• Introduction

Introduction

Kurulum

Kararlı Sürüm Kurulumu

git clone https://github.com/pardus-bireysel/pardus-bireysel/
cd pardus-bireysel
./install.sh

Geliştirici Sürümü Kurulumu

./install.sh dev remote-run BRANCH
# BRANCH'ı geliştirmekte olduğunuz kol ile değiştirin

Yerel Kurulum

./install.sh dev local-run

Dosya Yapısı

├── common.sh # diğer kodlarda kullanılan genel fonksiyonlar ve değişkenler
├── development.sh # geliştirici fonksiyonları
├── install.sh # ana çalıştırılabilir dosya, diğer dosyaları kullanır/çağırır
└── src
    ├── config.conf # kalıcı konfigrasyonların olduğu dosya
    ├── kde_configurations.sh # kde konfigrasyonları (WIP)
    ├── kde_install.sh # kde yükleme ve kurma (WIP)
    └── remove_apps.sh # gereksiz uygulamaları silen betik

Fonksiyonlar ve İşlevleri

• common.sh

common.sh

_log
# feature rich logs with color support
# $1           : log text
# $2 (optional): v, i, ok, OK, warn, err, panic
# $3 (optional): nl 
# Example:

_log "Verbose" v
_log "Info" i
_log "Success" ok
_log "Success" OK
_log "Warning" warn
_log "Error" err
_log "Text with newline afterward" any-other-text nl
_log "Panic" panic

Output: