2. Toolkit'i tanıyın

​

Etrafa bir göz atma

Artık Toolkit’in yerel bir kopyasına sahip olduğunuza göre, ls komutunu kullanarak deponun yapısına bir göz atalım.

Run this

ls -l

ls -l komutu, bir dizinin içeriğini ayrıntılı uzun liste görünümünde gösterir ve izinler, sahiplik ve boyut gibi ek dosya bilgileri sağlar.

Her şey başarıyla klonlandıysa şuna benzer bir çıktı görmelisiniz:

drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 bin
-rw-r--r-- 1 fry fry  6465 Aug 30 14:16 CHANGELOG.md
drwxr-xr-x 2 fry fry  4096 Sep  6 12:43 config
drwxr-xr-x 5 fry fry  4096 Aug 30 14:22 data
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 doc
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 lib
-rw-r--r-- 1 fry fry 34520 Aug 30 14:16 LICENSE
-rw-r--r-- 1 fry fry  1178 Aug 30 14:16 README.md

Kullanıcıya ait tüm yapılandırma dosyaları config/ dizininde bulunur. Bu dizin git sürüm kontrol sisteminden hariç tutulmuştur, bu nedenle Toolkit güncellendiğinde değiştirilmez.

​

Depo düzeni

Ad	Açıklama
bin	Bu klasör, Overleaf sunucu örneğinizi yönetmenize yardımcı olan bir dizi betik içerir. Bu betikler hakkında daha fazla bilgiyi aşağıdaki Komutlar bölümümüzde okuyabilirsiniz.
config	Bu klasör kendi yerel yapılandırma dosyalarınızı içerir.
lib	Bu klasör, Toolkit tarafından kullanılan temel yapılandırma dosyalarını içerir.
data	Varsayılan olarak bu klasör MongoDb, Redis ve Overleaf için depolama konumunu içerir. Daha fazla bilgi için aşağıdaki Kalıcı veriler bölümüne bakın.

/config klasörü dışındaki dosyaları doğrudan değiştirmemenizi öneririz. Bunun yerine, değişiklik yapmanız gerekiyorsa bunlar config/variables.env veya config/overleaf.rc dosyalarında ayarlanan ortam değişkenleri aracılığıyla yapılabilir.
Örneğin, mongo hizmet imajını ayarlamak için lib/docker-compose.mongo.yml dosyasını doğrudan düzenlemek yerine, imajı config/overleaf.rc içindeki MONGO_IMAGE ortam değişkeniyle ayarlayın. Daha fazla bilgi için Toolkit ayarları sayfasına bakın.

Toolkit, izniniz olmadan config/ dizinindeki hiçbir veriyi değiştirmez.

​

Komutlar

Bu betikleri Toolkit dizininden çalıştırın. Her biri seçeneklerini --help ile gösterir.

Komut	Ne yapar
bin/init	config/ içindeki yapılandırma dosyalarını ilk kez oluşturur. bin/init --tls, NGINX TLS proxy yapılandırmasını ekler.
bin/up	Konteynerleri oluşturur ve başlatır (bin/docker-compose up). Günlükleri izlemek yerine arka planda çalıştırmak için -d ekleyin. config/ içindeki her değişiklikten sonra çalıştırın: yapılandırması değişen konteynerleri yeniden oluşturur.
bin/start	Mevcut konteynerleri yeniden başlatır (bin/docker-compose start). Yapılandırma değişikliklerini uygulamaz.
bin/stop	Konteynerleri durdurur ve korur (bin/docker-compose stop).
bin/docker-compose	docker compose komutunu Toolkit dosyalarıyla çalıştırır, örneğin bin/docker-compose ps veya bin/docker-compose restart sharelatex.
bin/logs	Bir veya daha fazla hizmetin günlüklerini gösterir veya izler, örneğin bin/logs -f web.
bin/error-logs	bin/logs gibidir, ancak yalnızca hataları gösterir.
bin/shell	sharelatex konteyneri içinde bir kabuk açar.
bin/mongo	sharelatex veritabanında bir MongoDB kabuğu açar.
bin/run-script	sharelatex konteynerinin içinde gelen bir betiği çalıştırır.
bin/doctor	Ana makineyi ve yapılandırmayı denetler ve yardım isterken paylaşmak için bir rapor yazdırır.
bin/images	Ana makinedeki Overleaf Docker imajlarını listeler.
bin/backup-config	config/ dizinini bir yedekleme konumuna kopyalar (copy, zip veya tar).
bin/upgrade	Toolkit’i ve Overleaf imajını adım adım günceller; bkz. Dağıtımınızı yükseltme.
bin/rename-env-vars-5-0, bin/rename-rc-vars	Eski SHARELATEX_* değişken adlarının OVERLEAF_* olarak tek seferlik taşınması.

bin/up bir konteyneri yeniden oluşturduğunda, içinde yapılan her değişiklik kaybolur; örneğin bin/shell üzerinden kurulan paketler veya düzenlenen dosyalar. Yalnızca veri dizinleri (varsayılan olarak data/) ve config/ korunur. Kalıcı değişiklikleri bunun yerine config/variables.env, config/overleaf.rc veya config/docker-compose.override.yml üzerinden yapın.

Her bin/up tüm kullanıcıların oturumunu kapatıyorsa OVERLEAF_SESSION_SECRET değerini ayarlayın. Bu değer olmadan oturum çerezleri, konteyner her yeniden oluşturulduğunda yeniden üretilen bir secret ile imzalanır; bkz. Ortam Değişkenleri sayfasındaki Soru&Cevap bölümü.