KategorilerBilişimGenelİnternetProgramlarPythonYazılımlar

MkDocs ile Kolay ve Hızlı Dökümanlar Oluşturun

Çok hoş, aşırı basit, tamamen MarkDown destekleyen, Python ile yazılmış gerçekten hoş (biliyorum tekrar ettim ama gerçek bu yani :)) bir döküman hazırlama betiği.

Nedir Bu?

Eğer siz de benim gibi birden çok proje ile ilgileniyor, ve bir sürü döküman hazırlıyorsanız, HTML ile uğraşmanın tam bir sorun olduğunu biliyorsunuzdur. WYSIWYG editörleri de bir süre sonra bocalamaya, karışıklaşmaya başlıyor. İşte bu yüzden ya MarkDown geliştirildi. Hızlı, basit ama aşırı etkili. Ve döküman yazarken gerekebilecek bütün stillere de sahip. İşte MarkDown’ın gücünü, MkDocs ile birleştirince de ortaya çok hoş, hızlı ama kaliteli dökümanlar çıkıyor.

Kısaca Özellikleri

Sistem düzenlemelerinizi yaparken aynı zamanda hızlıca ön-izlemelere olanak sağlayan bir modüle de sahip, sizin yerinize hemen bir sunucu kuruyor. Yaptığınız güncellemeler anlık orada da güncelleniyor. İşiniz bitince de tek bir komutla ne gördüyseniz onun aynısını size bir klasörde hazırlıyor. Hazırladığı site statik, bu, onu Arduino da bile barındırabilirsiniz demek oluyor 🙂

Ayrıca MkDocs; eklenti, tema ve dil desteğine de sahip. Türkçe çevirisi de mevcut.

Nasıl Kurabilirim?

Kurulabilmesi için öncelikle sisteminizde Python bulunmalı. Ve PiP yani Python için çeşitli modülleri hızlıca kurmanıza yarayan bir arabirim, onun da kurulu ve güncel olması lazım. Eğer değilse hemen yardımcı olalım.

Hazırlıklar

pip install --upgrade pip

Eğer kullanıcı izinleri ile ilgili bir sorun alıyorsanız şu komutu çalıştırın

pip install --upgrade pip --user

Bu komut ile sorunsuz bir şekilde PiP’i güncelleyebilirsiniz.

Esas Kurulum

pip install mkdocs

Bu komut ile PiP MkDocs’u hızlıca kuracak. Çok beklemeniz de gerekmeyecek zaten.

Kullanım

Kullanımı çok basit, öncelikle hangi dizinde bir döküman oluşturmak istiyorsanız, orada bir terminal açın ve aşağıdaki komutu girin

mkdocs new benim-dokumanim
cd benim-dokumanim

Şimdi ise bütün dizini favori editörünüz ile açabilirsiniz, ben VS Code kullanıyorum

code .

Dosya Yapısı

Tek bir yml dosyası ile kontrol edilen bir yapıya sahip. Diğer her şey MarkDown dosyaları ile kontrol ediliyor.

Tek bir yml dosyası ile kontrol edilen bir yapı karşımıza çıkıyor. site_name yazan yere döküman adını yazıyorsunuz. Ve bu kadar; isterseniz nav ile Üst Navigasyon ayarlarını, isterseniz de çeşitli ayarlar ile eklenti ve dil ayarlarını da halledebiliyorsunuz.

Üst Navigasyonu Yönetme

Çok basit bir şekilde nav: başlangıcından sonra bir alt satırda (gerekli girintileri unutmadan) Sayfa Adı : sayfa-adi.md şeklinde istediğiniz kadar sayfa ekleyebilir, benim yaptığım gibi markdown vermek yerine direk bir site adresi yazarak da yönlendirme sağlayabilirsiniz.

Serve Komutu

Bu komut ile az önce bahsettiğim sunucu kurma olayını yapıyorsunuz. Bu sunucu sayesinde değişiklikleriniz anında önünüze geliyor.

mkdocs serve

Büyük olasılıkla http://127.0.0.1:8000/ adresine bir sunucu kuracak, port çakışması varsa sizi zaten uyarır kendisi.

Build Komutu (Dışarı Aktarma)

Ve son olarak Build komutu ile dışarı aktarabiliyoruz dökümanımızı.

mkdocs build

Bu komut ile döküman dizininizin içerisine site/ adlı bir ek dizin açılacak. İçindeki tüm kodları kopyalayıp bir sunucuya attığınızda dökümanınızın çok hoş bir şekilde hazır olduğunu göreceksiniz.

Örnek

Örnek olarak yaptığım bu dökümana sizi yönlendirebilirim. CodeCanyon üzerinde sattığım bir betiğe ait bir döküman.

MkDocs ile İyi kodlamalar 🙂

KategorilerGenelProgramlarPythonYazılımlar

Python ile Komut Satırından Güçlü Parolalar Oluşturun

Linux veya Windows kullanmanız fark etmez, güçlü parolalar oluşturmak ve bunların sizin bilgisayarınızda kalmasını sağlamak çok önemli.

Bu sebeple Pyton ile kendi küçük betiğimi yazdım. İstediğiniz özelliklerde, istediğiniz uzunlukta ve istediğiniz kadar parola oluşturmanızı sağlayan betik 33 satır koddan ibaret.

İndir

Aşağıda bağlantısını verdiğim, GitHub üzerinden rnd.py dosyasını indirin.

GitHub Bağlantısı: https://github.com/altayevrim/smallpy

Basit Kullanım

Kullanabilmek için sisteminizde Python 3 yüklü olmalıdır. Python 2 desteklenmemektedir.

Çeşitli parametreler desteklenmekle beraber, hızlıca parola oluşturmak için aşağıdaki komutu kullanabilirsiniz.

Sistem size 3 adet 10 karakterli parola oluşturur.

python3 rnd.py

Yardım İçin

python3 rnd.py -h

Parola Tipi (-t)

Betik nasıl bir parola istediğinize bağlı olarak size rastgele parolalar oluşturuyor. Tip seçimi için -t komutunu kullanabilirsiniz. Varsayılan Değer: hs

Sadece Sayı (s)

python3 rnd.py -t s
9856713806
3145151230
2097544073

Sadece Harf (h)

python3 rnd.py -t h
nDFGoAGKUo
hClCsBNsDT
OVuheAJXGd

Harf & Sayı Karışık (hs)

python3 rnd.py -t hs
9Nm-DoU%!+
S_MHGi5-p8
mfBKIX1t52

Harf & Sayı & Sembol Karışık (t)

python3 rnd.py -t t
9Nm-DoU%!+
S_MHGi5-p8
mfBKIX1t52

Parola Uzunluğu (-u)

Parola uzunluğunu değiştirmek için -u komutunu kullanabilirsiniz. Sonraki değerin bir tam sayı olması gerekmektedir. Varsayılan Değer: 10

python3 rnd.py -u 32
T7NK4yPqWWNj09CLVr6t41zywkuXJ4G5
H00ZpbDNn2sXinP0dFPbR4CsCOQEUv9p
0hjojR0dhtK2RUhun6mH4WlyNvILJEez

Parola Adedi (-a)

Parola adedini değiştirmek için -a komutunu kullanabilirsiniz. Sonraki değerin bir tam sayı olması gerekmektedir. Varsayılan Değer: 3

python3 rnd.py -a 10
kGpx3FXi9i
xbAgyskjLW
9YzjtHp6wW
u0S59ZGmfa
ZEcpBlI6Wf
ScWs8dQnUc
8o6WVJmoUv
nSsEruQ5mb
Zz3E0XjM5C
4kMQppz94X

Parametreleri Karıştırın

Sistem birarada parametre kullanımını destekler örneğin; 5 adet 2 basamaklı sayı üretmek için

python3 rnd.py -a 5 -t s -u 2
18
67
84
42
08

Linux’a Kısayol Ekle

Linux kullanıcısı iseniz kendinize kısayol oluşturabilir ve konsolunuzda pyparola yazarak hızlıca parolalar oluşturabilirsiniz.

rnd.py dosyasını ana dizininize indirin ve çalıştırma izni verin.

$ cd ~ 
$ wget https://raw.githubusercontent.com/altayevrim/smallpy/master/rnd.py
$ chmod +x rnd.py

komut için kısayol oluşturun

$ echo "alias pyparola='python3 ~/rnd.py'" >> ~/.bashrc

kısayolun geçerli olabilmesi için terminali yeniden başlatın

$ exit

KategorilerBilişimProgramlarPythonYazılımlar

Rimtay Şifreleyici

Python ile kodlamış olduğum hızlı dosya şifreleme programıdır. Tek bir tıklama ile bütün bir klasördeki dosyaları ayrı ayrı otomatik olarak şifreler. Şifreler gelişmiş AES Şifreleme algoritması ve otomatik oluşturulmuş güçlü Şifreleme Anahtarı ile korunur.

Okumaya devam
KategorilerProgramlarPythonTanıtımYazılımlar

Python ile Morse Yayını Yapmak

Python’u yeni öğrenmeye başladım, öğrenirken kendi çapımda küçük bir şey yapayım derken birden aklıma Raspberry Pi’ımda kullanabileceğim bir Morse Yayımcısı yapmak geldi.

Sistem verdiğiniz kısa metni morse kodlarına dönüştürüyor ve ardından Pygame modülünü kullanarak ses ile Morse yayını yapmaya başlıyor. Ve bu yayını belirlediğiniz sayıda tekrarlıyor.

Terminal üzerinden çalışıyor, normalde kodlamada bir sıkıntı olduğunu düşünmüyorum fakat Pygame’in mixer’inden kaynaklanan gecikmeden ötürü bazen (genellikle çoklu tekrarlarda) morse kodları karışabiliyor, yani kısa ses vermesi gerekirken, yerinde duraklama yapamadığından uzun ses çıkartabiliyor. Bu sorunu ben çözemedim, çözen olursa kod zaten geliştirilmeye açıktır, paylaşırsanız burada da yayınlarım.

Yazılış amacından ötürü, tüm sistem Raspberry Pi ile uyumludur, tek yapmanız gereken; Pi’a bir kulaklık / hoparlör takmak veya onu HDMI ile bir televizyona bağlamak.

İndir

Dosyayı indirmek için aşağıdaki formu kullanın, dosya ücretsizdir. Mail adresleriniz kesinlikle kimseyle paylaşılmayacak olup; reklam/spam mailleri gönderilmeyecektir.