Dosyalar ve konumlar

Bu sayfa, Toolkit’in Overleaf’in şirket içi dağıtımını yapılandırmak için kullandığı yapılandırma dosyalarını açıklar.

​

Kalıcı Veriler

Overleaf Toolkit’in, LaTeX projelerini derlemek için gereken dosyalar ve MongoDB veritabanının içeriği gibi kalıcı verileri depolaması gerekir. Bu, ana makineden birkaç dizinin Docker konteynerlerine bağlanması ve verilerin bu dizinlere yazılmasıyla sağlanır.

​

Veri Dizinleri

sharelatex konteyneri, LaTeX derlemeleriyle ilgili verileri depolamak için bir dizine ihtiyaç duyar. Bu dizin config/overleaf.rc içindeki OVERLEAF_DATA_PATH değişkeniyle ayarlanır.

mongo konteyneri etkinse veritabanı dosyalarını depolamak için bir dizine ihtiyaç duyar; aynısı redis konteyneri için de geçerlidir. Bu dizinler de config/overleaf.rc içinde yapılandırılabilir.

​

Dosya İzinleri

Docker root olarak çalıştığından, Toolkit root olmayan bir kullanıcı tarafından kullanılıyor olsa bile veri dizinlerinin sahibi root kullanıcısı olur. Bu bir sorun değildir, ancak kalıcı verileri konteynerlerin dışından değiştirmeyi düşünüyorsanız bunu bilmenizde fayda vardır.

​

Yapılandırma dosyası konumu

Kullanıcıya ait tüm yapılandırma dosyaları config/ dizininde bulunur.

Bu dizin git sürüm kontrol sisteminin dışında tutulur, dolayısıyla Toolkit kodunun güncellenmesiyle değişmez. Toolkit, izniniz olmadan config/ dizinindeki hiçbir veriyi değiştirmez.

Yapılandırma dosyalarındaki değişiklikler, konteyner durdurulup yeniden başlatılsa bile (bin/stop ve bin/start ile) mevcut konteynerlere otomatik olarak uygulanmaz. Değişiklikleri uygulamak için bin/up komutunu çalıştırın; arka planda docker compose yapılandırma değişikliklerini yeni bir konteynere otomatik olarak uygular. (Ya da Docker günlüklerine bağlanmak istemiyorsanız bin/up -d komutunu çalıştırın.)

​

overleaf.rc dosyası

config/overleaf.rc dosyası, Toolkit tarafından kullanılan en önemli üst düzey yapılandırma ayarlarını içerir. VARIABLE_NAME=value biçiminde değişken atayan ifadeler içerir.

Kullanılabilir tüm yapılandırma seçeneklerinin ayrıntılı dökümünü görmek için ayarlar bölümümüze bakın.

​

variables.env dosyası

config/variables.env dosyası, sharelatex konteynerine yüklenen ve Overleaf mikro hizmetlerini yapılandırmak için kullanılan ortam değişkenlerini içerir. Bunlar arasında web arayüzünün üst bilgisinde görüntülenen uygulama adı, e-posta gönderme ayarları ve Server Pro ile kullanılan SSO gibi diğer premium ayarlar bulunur.

Kullanılabilir tüm ortam değişkenlerinin ayrıntılı dökümünü görmek için Ortam değişkenleri bölümüne bakın.

​

version dosyası

config/version dosyası, Overleaf sunucunuzun çalışan örneğini oluşturmak için kullanılacak Docker imajının sürüm numarasını içerir.

Bu yapılandırma dosyalarındaki değişiklikler, konteyner durdurulup yeniden başlatılsa bile (bin/stop ve bin/start ile) mevcut konteynerlere otomatik olarak uygulanmaz. Değişikliklerinizi uygulamak için bin/up komutunu çalıştırın; Toolkit, yapılandırma değişiklikleri uygulanmış yeni bir konteyneri sizin için otomatik olarak oluşturur.

​

docker-compose.override.yml dosyası

Varsa, config/docker-compose.override.yml dosyası docker compose çağrısına dahil edilir. Bu, Docker Compose’a özgü yapılandırmayı geçersiz kılmak için kullanışlıdır.

Daha fazla ayrıntı için docker-compose belgelerine bakın.