KISA KULLANIM KILAVUZU

Notların, senin düzenin.

Kurulum, yeni kaynak ekleme ve telefondan güncelleme. Derleme, üyelik veya veritabanı gerektirmez.

1. Cloudflare Pages’e ilk yükleme

1. Verilen r4bi-date-android-hafif.zip dosyasını telefonunun Dosyalar / İndirilenler bölümüne kaydet. ZIP’in kökünde index.html vardır; ek klasör ekleme.
2. Cloudflare panelinde Workers & Pages → Create application → Pages → Upload assets yolundan doğrudan yükleme projesi oluştur. Paneldeki adlar zamanla değişebilir.
3. ZIP dosyasını seç, proje adını belirle ve dağıtımı başlat. Derleme komutu veya framework seçmek gerekmez. ZIP seçici telefonda görünmezse tarayıcının “Masaüstü site” seçeneğini dene.
4. Verilen pages.dev adresini aç. Derslerim → Türkçe ÖABT → Halk Edebiyatı yolunu kontrol et.
5. r4bi.date bağlantısını kendi hesabındaki Custom domains bölümünden sen kurabilirsin. Bu teslimde hesabına, DNS’e veya alan adına müdahale edilmedi.

2. Telefondan metin, PDF veya bağlantı ekleme

1. Yayımlanan siteden Kaynak ekle bağlantısını aç veya adresin sonuna /yonet.html yaz.
2. Not veya kaynak ekle bölümünde konuyu seç. İlk dosyan için Türkçe ÖABT → Halk Edebiyatı seçili olabilir.
3. Başlık, kısa açıklama ve virgülle ayrılmış etiketleri gir. İçeriği analiz etmek zorunda değilsin; dosyanın adını ve kısa kaynak bilgisini yazman yeterli.
4. Sayfada okunacak not için Sayfada okunacak metin seçip notun tamamını yaz. Ayrı HTML sayfası ZIP hazırlanırken otomatik oluşturulur. PDF için PDF dosyası → PDF seç ile telefondaki dosyayı seç. Haricî bir not için Haricî bağlantı seçip tam https://… adresini gir. Kaynağı ekle düğmesine dokun.
5. Güncel siteyi ZIP indir düğmesine dokun. Eski PDF’ler ile yeni PDF’ler aynı pakete alınır. Dosyalar / İndirilenler bölümünde ZIP’in oluştuğunu kontrol et.

Düzenleyici dosyayı yalnızca bu sekmede tutar. Sekmeyi kapatmak veya yenilemek indirilmemiş taslağı kaybettirebilir; özellikle mobil tarayıcılar arka plandaki sekmeleri kapatabilir. İşin biter bitmez ZIP indir. Bu sayfayı başkası açsa bile canlı sitene yazamaz; sadece kendi cihazına bir paket indirebilir.

PDF’nin adı otomatik üretilir ve pdf/ klasörüne yerleşir. Dosya başına 25 MiB sınırı uygulanır. Büyük arşivler telefonda bellek sorunu yaşayabilir; böyle bir durumda bilgisayarda aynı düzenleyiciyi kullan. Haricî bağlantının erişim izni ve çalışır durumda olması kaynak sahibine bağlıdır. “İndir” bazı mobil tarayıcılarda PDF görüntüleyiciyi açabilir; oradan Paylaş → Dosyalara Kaydet ile kaydet.

3. Yeni ders veya konu oluşturma

1. /yonet.html sayfasında Ders oluştur bölümüne adı, açıklamayı ve istersen üst etiketi yaz. Örneğin “Matematik” bir örnek ders adıdır; mevcut derslerin dışında yeni bir ders oluşturabilirsin.
2. Konu oluştur bölümünde yeni dersi seç, konu adını ve açıklamasını gir.
3. Yeni konuyu not formunda seçip PDF’leri veya bağlantıları ekle. Güncel ZIP’i indir.

4. Aynı siteyi güncelleme

1. Önceki ZIP’i yedek olarak sakla. Cloudflare’de mevcut Pages projesini aç; her güncellemede yeni proje oluşturma.
2. Create deployment / Yeni dağıtım ile güncel ZIP’i yükle. Canlı siteyi değiştirmek için üretim / production dağıtımını seç. Yalnızca content.json dosyasını yükleme; güncel sitenin tamamını yükle.
3. Dağıtım tamamlanınca aynı r4bi.date veya pages.dev adresinde yeni içeriği kontrol et. Eski görünüyorsa sayfayı yenile.
4. Sonraki düzenlemeye başlamadan /yonet.html sayfasını yenile; böylece en son yayımlanmış içerik yüklenir.

“Tam içerik JSON yedeği indir” içerik yedeğidir; PDF’leri içermez ve tek başına tam bir site değildir. JSON yedeği yüklerken ilgili PDF’ler mevcut sitede bulunmalıdır. Eksik PDF varsa ZIP hazırlama işlemi durur. Canlı sitede henüz bulunmayan bir PDF için en güvenilir yedek, düzenleyiciden indirdiğin tam ZIP’tir.

5. İstersen içerik dosyasını elle düzenle

Yayımlanan pakette content.json hafif kataloğu; data/topics/ konu metinlerini; data/metadata.json kaynak ve kontrol kayıtlarını içerir. Elle düzenleme için önce /yonet.html içindeki Tam içerik JSON yedeği indir düğmesini kullan. Bu tek yedekte bütün dersler ve notlar bulunur. Yedeği metin düzenleyicide değiştir, aynı düzenleyiciye geri yükle ve tam ZIP indir. HTML sayfaları ve konu veri dosyaları yeniden üretilir; derleme komutu gerekmez. ZIP’teki katalog dosyasını tek başına değiştirmek konu metinlerini güncellemez.

• courses: id, title, description ve isteğe bağlı label.
• topics: id, courseId, title, description.
• notes: id, topicId, title, description, tags dizisi, kind ve kaynağa göre url veya blocks.

Her id tüm kayıtlar arasında benzersizdir; küçük Latin harfi, rakam, tire ve alt çizgi kullan. Düzenleyici kalıcı kimlikleri otomatik üretir. Var olan kaydın başlığını değiştirirken kimliğini koru. Konuyu silmeden önce bağlı notları, dersi silmeden önce bağlı konuları kaldır veya başka bir kayda bağla.

Örnek kayıt — başlangıç içeriğine ekli değildir: Aşağıdaki yerel PDF adresi ancak gerçek dosyayı aynı yola koyarsan çalışır.

{
  "id": "not-ornek-001",
  "topicId": "halk-edebiyati",
  "title": "Örnek — Kaynak başlığı",
  "description": "Örnek — Kısa kaynak açıklaması.",
  "tags": ["Örnek", "halk edebiyatı"],
  "kind": "pdf",
  "url": "pdf/ornek-kaynak.pdf"
}

Haricî not için kind değerini link, url değerini tam bir HTTP(S) adresi yap. PDF dosya adlarında yalnızca Latin harfleri, rakam, nokta, tire ve alt çizgi kullan; uzantı .pdf olsun. Arama tüm derslerdeki notların başlık, açıklama, etiket ve blocks içindeki tam metnini tarar. Büyük/küçük harf ve Türkçe karakter farklarına toleranslıdır; birden fazla sözcük yazarsan hepsini içeren notlar gösterilir.

6. Teknik ve gizlilik bilgisi

Site düz HTML, CSS ve JavaScript’tir. Haricî CDN, font, reklam, analiz veya takip betiği yoktur. Açık/koyu tema tercihi yalnızca bu tarayıcının yerel depolamasında saklanır. Arama ve ZIP üretimi tarayıcıda yapılır. Ana sayfa önce hafif kataloğu yükler; tam metinler arama sırasında ve düzenleyici açıldığında konu dosyalarından alınır. Kaynak bağlantıları kullanıcı tıkladığında açılır.

Tüm HTML sayfalarında noindex, Cloudflare Pages’in _headers dosyasında PDF’leri de kapsayan X-Robots-Tag vardır. robots.txt taramaya izin verir; böylece arama motoru noindex talimatını okuyabilir. Bu ayarlar parola, giriş veya yetkilendirme sağlamaz. Daha önce indekslenmiş sayfaların arama sonuçlarından kaybolması zaman alabilir.

Çift tıklayarak file:// üzerinden açıldığında tarayıcı JSON ve modül dosyalarını engelleyebilir. İnternete yayımlamak gerekmeden yerelde denemek için Python bulunan bilgisayarda site klasöründe python3 -m http.server 8080 çalıştır, ardından http://localhost:8080 adresini aç. Siteyi kullanmak için sunucu uygulaması veya derleme gerekmez; bu komut yalnızca yerel dosyaları önizler.

Test kapsamı ve kalan sınırlar ZIP içindeki TESTLER.md dosyasında listelenmiştir. Gerçek Cloudflare dağıtımını sen yapacaksın.

7. TXT aktarımı, açık kontroller ve takip

Önce dosyanın tamamından konu envanteri çıkarıldı. İlk envanterin bekliyor durumları sources/envanter-ilk.json ve sources/envanter-ilk.md içinde tarihsel kayıt olarak saklanır; güncel ilerleme TAKIP.md ve takip.json içindedir. Kaynak sırasıyla 202 bölüm aktarıldı; aktarımda kalan bölüm yoktur.

Açıklamalar, kişi/eser adları, şiirler, örnek hikâyeler ve istisna ifadeleri korundu. Son isteğin doğrultusunda sorular, seçenekler ve yıllara göre soru listesi okuma sayfalarından kaldırıldı; ham TXT yedeği değişmedi. 8 tekrar, ilk veya daha kapsamlı parçaya bağlantı verilerek birleştirildi. Şiir içindeki nakaratlar ile farklı araştırmacıların benzer sınıflama maddeleri korundu. Başlıksız realist hikâye parçaları tamamlanmış hikâye gibi sunulmadı.

Kontrol listesinde Halk Edebiyatına ait 112 açık kayıt vardır: yazım/dizgi, boş bırakılmış yerler, olası çelişkiler ve bağımsız kaynakla doğrulanması gereken iddialar. Bunların tespiti düzeltildikleri anlamına gelmez. Kısa sayfa başlıkları gezinmek için düzenlendi; kaynak başlıkları ve ifadeleri sayfa içinde korunur. Özgün TXT yedeği aynen saklanır.

Sayfadaki “Satır numaralarını göster” düğmesiyle her parçanın TXT içindeki yerini görebilirsin. Birleştirilmiş tekrarlar bağlantı ile asıl parçayı açar. Yazım hatası veya çelişkiyi çözerken özgün metni ve kontrol kaydını karşılaştır. Bilimsel doğrulama, şiirlerin vezin taraması, eksik ara olaylar kalan işlerdir.

Yeni kişisel metin ekleme: düzenleyicide kaynak türü article olarak üretilir. Elle eklemek için kind: article ve blocks: [{id: metin-001, type: source, text: notun tam metni, sourceRanges: []}] alanlarını geçerli JSON biçiminde kullan. Mevcut kaydın id değerini koru. İçe aktarılan notlardaki kaynak satırları ve reviewIssueIds alanları izlenebilirlik içindir; kullanıcı metnine sahte kaynak satırı yazma.

8. AGS konu anlatımları

Bu Android hafif paketinde kaynak tarama görselleri bulunmaz. 102 AGS sayfasının metinleri ve kaynak sayfa numaraları korunur. Görseller önceki büyük ZIP’te saklıdır.

AGS konuları sayfasından mevzuat, Anayasa, yasama, yürütme ve yargı, idare hukuku ve insan hakları başlıklarını açabilirsin. İlköğretim ve Eğitim Kanunu, 1739 ve 7528 notları korundu. 057–102 devamı eklendi; 102 sayfanın okunabilen metinleri aktarıldı. Aynı 001–056 arşivinin kopyaları bir kez işlendi.

49 AGS konu anlatımı vardır. Anlatım maddeleri ve tam sayfa metinleri doğrudan okunur. Kaynak sayfa numaraları metnin yanında görünür. Önceki/sonraki konu bağlantılarıyla ilerleyebilirsin.

Anlatım maddeleri ve tam metinler kaynak sayfasını gösterir. Kaynak tarama görselleri bu hafif paketten çıkarıldı. Köşeli parantezler okuma/kontrol notudur; okunamayanlar tahminle tamamlanmamıştır. Notlardaki yaş, para cezası, görev unvanı, süre ve geçiş hükümleri yürürlükteki kesin bilgi olarak doğrulanmadı. Özellikle 01.09.2025 tarihli geçiş notu bugünkü alımlar için doğrudan kullanılmamalıdır.

AGS-TAKIP.md işlenen sayfalar ve kalan doğrulamaları; AGS-AKTARIM.md sayfa metinlerini; AGS-KONTROL.md 256 açık kaynak/güncellik kontrolünü listeler. Kullanıcının son isteği kapsamı tüm ZIP olarak genişlettiğinden ilk beş sayfalık başlangıç sınırının ötesine bu açık talep doğrultusunda geçildi.

9. Coğrafya ve Türkiye haritası

Coğrafya dizini51 konu anlatımı,361 kavram kartı,99 karşılaştırma ve 19 grafik/kavramsal şema içerir. Kartların başlığına dokunarak açıklamayı aç; geniş tabloları yana kaydır. Sayısal grafikler yalnız notta açıkça yazılan verilerdir; yıl/kapsam belirtilmemiş istatistikler güncel diye sunulmaz.

132 dosyanın 089–125 aralığındaki 37 görseli tamamen beyazdır. Kalan 95 sayfada okunabilen metinler aktarıldı.088 sayfada DOKAP görselinin örttüğü bakır notları tamamlanmadı. Ayrıntılar Coğrafya takibinde ve kontrol listesindedir.

Türkiye haritasında konu filtresinden katman seç veya birden fazla katmanı aç. Bir noktaya ya da altındaki yer listesine dokun; bilgi kartından kaynak anlatımına geç. +/− düğmeleriyle, telefonda iki parmakla yakınlaştır; yakınlaşınca sürükleyerek gezin. Görünümü sıfırla düğmesi başlangıca döndürür. Klavyeyle noktalara Tab ile ulaş, Enter ile aç.

8 katmandaki 83 nokta yaklaşık öğrenme konumlarıdır. Akarsu güzergâhları ve kesin iklim/bitki alanı sınırları çizilmedi. Natural Earth 110 mçerçevesinde küçük adalar bulunmayabilir. Harita navigasyon veya resmî sınır kaynağı değildir; verileri kendi sitenden yüklenir.

10. Android hafif paketini yükleme

Boyutun büyük kısmını oluşturan 197 tarama görseli çıkarıldı. Tüm konu metinleri, kaynak sayfa numaraları, kavramlar, tablolar, SVG grafikler ve etkileşimli Türkiye haritası korunur. Kaynak görselleri önceki büyük ZIP’te bulunur; bu pakette eksik görsellere bağlantı verilmez.

Bu ZIP derlenmiş statik dosyalar içerir; npm veyaNode.js çalıştırma. Tam ZIP'i mevcut Cloudflare Pages projenin Direct Upload alanından yeni production dağıtımı olarak yükle. Kök dizinde index.html kalmalı. Telefon düzenleyicisi yeni ZIP'i hazırlanırken parçalara ayrılmış tüm ders dosyalarını ve harita katmanlarını korur.