MkDocs Site Yönetimi

Proje Konumu

~/Sync/KYNC

---

Sanal Ortam (Virtual Environment)

Oluşturuldu:

~/.venvs/mkdocs

Silinmemeli.

---

MkDocs Çalıştırma

Terminal aç:

source ~/.venvs/mkdocs/bin/activate.fish

Ardından:

cd ~/Sync/KYNC
mkdocs serve

Tarayıcı:

http://127.0.0.1:8000

---

Siteyi Derleme

source ~/.venvs/mkdocs/bin/activate.fish

cd ~/Sync/KYNC

mkdocs build

Oluşan çıktı:

site/

---

GitHub'a Gönderme

git add .

git commit -m "güncelleme"

git push

---

Düzenlenen Dosyalar

Tema:

mkdocs.yml

Ana sayfa:

docs/index.md

CSS:

docs/stylesheets/extra.css

Logo:

docs/assets/logo.png

Favicon:

docs/assets/favicon.png

---

Kesinlikle Silme

Sanal ortam

~/.venvs/mkdocs

Proje dosyaları

~/Sync/KYNC/mkdocs.yml
~/Sync/KYNC/docs/

CSS

docs/stylesheets/extra.css

---

Yeniden Kurulum Gerekirse

python -m venv ~/.venvs/mkdocs

source ~/.venvs/mkdocs/bin/activate.fish

pip install mkdocs mkdocs-material

---

Yayınlama Kontrol Listesi

• [ ] index.md güncel
• [ ] logo güncel
• [ ] CSS güncel
• [ ] mkdocs build başarılı
• [ ] git push yapıldı

---

Daha Kolay Çalıştırma

Her seferinde uzun komut yazma.

~/.config/fish/config.fish dosyasına şunu ekle:

alias kync='source ~/.venvs/mkdocs/bin/activate.fish; cd ~/Sync/KYNC; mkdocs serve'

Sonra:

source ~/.config/fish/config.fish

Artık sadece:

kync

yazacaksın.

---

Şu An Silinmemesi Gerekenler

Bunlar kritik:

~/.venvs/mkdocs/
~/Sync/KYNC/docs/
~/Sync/KYNC/mkdocs.yml

Bunlar silinebilir çünkü yeniden oluşur:

~/Sync/KYNC/site/

site/ derleme çıktısıdır. MkDocs yeniden üretir.

---