Manifold Scholar Kurulumu ve Yapılandırması: Kapsamlı Bir Rehber
Manifold Scholar, akademik yayıncılığın geleneksel sınırlarını zorlayan, açık kaynaklı ve etkileşimli bir yayın platformudur. Metin tabanlı yayınların ötesine geçerek multimedya içerikleri, veri setleri ve topluluk odaklı etkileşimleri bir araya getirme potansiyeli sunar. Bu kapsamlı rehber, Manifold Scholar’ı kendi sunucunuza nasıl kuracağınızı ve temel yapılandırmalarını nasıl yapacağınızı adım adım açıklayarak, akademik yayıncılıkta yeni bir çağın kapılarını aralamanıza yardımcı olmayı hedeflemektedir.
Manifold Scholar Nedir ve Neden Önemlidir?
Manifold Scholar, University of Minnesota Press ve Cast Iron Coding tarafından geliştirilen, modern akademik yayıncılık ihtiyaçlarına cevap veren yenilikçi bir platformdur. Geleneksel basılı kitapların veya statik PDF’lerin aksine, Manifold, yayınları dinamik, etkileşimli ve zenginleştirilmiş dijital deneyimler olarak sunar. Temel amacı, okuyucuların içerikle daha derinlemesine etkileşim kurmasını sağlamak, araştırmacıların eserlerini daha geniş kitlelere ulaştırmasına olanak tanımak ve akademik diyaloğu teşvik etmektir.
Neden Manifold Scholar Kullanmalısınız?
* Etkileşimli Okuma Deneyimi: Okuyucular, metinler üzerinde notlar alabilir, yorumlar yapabilir ve diğer okuyucularla etkileşime geçebilir. Bu, pasif okumadan aktif öğrenmeye geçişi sağlar.
* Multimedya Entegrasyonu: Metinlere ses dosyaları, videolar, interaktif grafikler ve veri setleri gibi zengin medya öğeleri kolayca entegre edilebilir. Bu sayede karmaşık konular daha anlaşılır ve çekici hale gelir.
* Açık Kaynak ve Esneklik: Manifold açık kaynaklı bir yazılımdır, bu da kurumların platformu kendi ihtiyaçlarına göre özelleştirmelerine ve geliştirmelerine olanak tanır. Lisans maliyeti yoktur ve geniş bir geliştirici topluluğu tarafından desteklenir.
* Sürüm Kontrolü ve İşbirliği: Yayınlar üzerinde yapılan değişiklikler takip edilebilir, bu da işbirliğini ve güncellemeleri kolaylaştırır.
* Topluluk Odaklılık: Platform, akademik topluluğun bir araya gelmesini, bilgi paylaşmasını ve ortak projeler üzerinde çalışmasını teşvik eder.
* Erişilebilirlik: Web tabanlı yapısı sayesinde, yayınlara her yerden ve her cihazdan erişilebilir. Ayrıca, farklı formatlarda (EPUB, PDF vb.) indirme seçenekleri sunar.
Üniversiteler, akademik yayınevleri ve araştırma merkezleri için Manifold Scholar, araştırmalarını ve yayınlarını daha geniş, daha etkileşimli ve daha modern bir şekilde sunmak için güçlü bir araçtır. Geleneksel yayıncılığın yavaşlığı ve sınırlamaları göz önüne alındığında, Manifold, bilginin hızlı ve etkili bir şekilde yayılmasını sağlayarak akademik iletişimi yeniden tanımlamaktadır.
Manifold Scholar Kurulum Öncesi Hazırlıklar
Manifold Scholar’ın başarılı bir şekilde kurulabilmesi için belirli sistem gereksinimlerinin karşılanması ve bazı ön hazırlıkların yapılması şarttır. Bu bölüm, kurulum sürecine başlamadan önce dikkat etmeniz gereken kritik noktaları ele almaktadır.
Sistem Gereksinimleri
Manifold, Docker ve Docker Compose kullanılarak dağıtıldığı için, temel gereksinimler bu teknolojileri çalıştırabilecek bir sunucu ortamıdır.
* İşletim Sistemi: Linux tabanlı bir işletim sistemi şiddetle tavsiye edilir. Ubuntu (18.04 LTS veya üstü) veya Debian (10 veya üstü) popüler ve iyi desteklenen seçeneklerdir. Windows veya macOS üzerinde geliştirme amaçlı çalıştırılabilir olsa da, üretim ortamları için Linux tercih edilmelidir.
* Donanım:
* CPU: En az 2 çekirdekli bir işlemci. 4 çekirdekli veya daha fazlası önerilir.
* RAM: Minimum 4 GB RAM. 8 GB veya daha fazlası, özellikle birden fazla yayını ve aktif kullanıcıyı barındıracak sistemler için önerilir.
* Disk Alanı: Minimum 40 GB boş disk alanı. Yayınların büyüklüğüne ve sayısına bağlı olarak bu miktar artabilir. Özellikle medya içeriği yoğun yayınlar için daha fazla alana ihtiyaç duyulacaktır. SSD diskler performans açısından büyük avantaj sağlar.
* Yazılım Bağımlılıkları:
* Docker Engine: Manifold’un tüm servislerini (veritabanı, Redis, uygulama) konteynerler içinde çalıştırmak için gereklidir.
* Docker Compose: Birden fazla Docker konteynerini tanımlamak ve yönetmek için kullanılır.
* Git: Manifold kaynak kodunu indirmek için gereklidir.
* Node.js ve npm/yarn (isteğe bağlı ama önerilir): Frontend bağımlılıklarını yönetmek ve frontend varlıklarını derlemek için kullanılır. Docker konteynerleri içinde bu adımlar otomatikleştirilebilir, ancak manuel derleme veya geliştirme için faydalıdır.
* PostgreSQL: Manifold’un birincil veritabanıdır. Docker içinde çalışacaktır.
* Redis: Önbellekleme ve arka plan işleri için kullanılır. Docker içinde çalışacaktır.
Alan Adı ve SSL Sertifikası
Manifold Scholar’ı internet üzerinden erişilebilir kılmak için bir alan adına (örneğin, manifold.kurumunuz.org) ihtiyacınız olacaktır. Ayrıca, kullanıcı verilerinin güvenliğini sağlamak ve arama motoru sıralamalarında avantaj elde etmek için bir SSL/TLS sertifikası (HTTPS) kullanmak zorunludur.
* Alan Adı: Bir alan adı sağlayıcısından (GoDaddy, Namecheap vb.) kaydedebilirsiniz. DNS kayıtlarını (A kaydı) sunucunuzun IP adresine yönlendirmeyi unutmayın.
* SSL Sertifikası: Let’s Encrypt, ücretsiz ve otomatikleştirilmiş SSL sertifikaları sunan popüler bir seçenektir. Certbot aracı ile kolayca kurulabilir ve yenilenebilir. Alternatif olarak, ücretli bir SSL sertifikası da kullanabilirsiniz.
Sunucu Seçimi
Manifold’u barındırmak için bir sanal özel sunucu (VPS) veya bulut sunucu (Cloud Server) kullanabilirsiniz. Popüler sağlayıcılar arasında DigitalOcean, AWS (EC2), Google Cloud (Compute Engine), Linode ve Vultr bulunmaktadır. Seçim yaparken, sunucunun donanım özelliklerinin yukarıda belirtilen minimum gereksinimleri karşıladığından ve veri merkezinin hedef kitlenize yakın olduğundan emin olun.
Güvenlik Önlemleri
Kurulumdan önce sunucunuzun güvenliğini sağlamak kritik öneme sahiptir.
* Güvenlik Duvarı (Firewall): Sunucunuzda bir güvenlik duvarı (örneğin, UFW – Uncomplicated Firewall) etkinleştirin. Sadece gerekli portlara (SSH için 22, HTTP için 80, HTTPS için 443) izin verin.
* SSH Anahtarları: Parola tabanlı SSH girişleri yerine SSH anahtarları kullanarak güvenliği artırın.
* Düzenli Güncellemeler: İşletim sisteminizi ve tüm yüklü paketleri düzenli olarak güncel tutun (sudo apt update && sudo apt upgrade).
* Sudo Kullanıcısı: Root kullanıcısı yerine, sudo yetkisine sahip ayrı bir kullanıcı hesabı oluşturun ve tüm işlemleri bu hesap üzerinden yapın.
Bu hazırlık adımları tamamlandığında, Manifold Scholar kurulumuna geçmeye hazırsınız demektir.
Manifold Scholar Kurulumu
Manifold Scholar’ın kurulum süreci, temel olarak sunucu hazırlığı, Docker entegrasyonu, Manifold kaynak kodunun indirilmesi ve yapılandırılması adımlarını içerir. Bu bölüm, her adımı detaylı bir şekilde açıklayacaktır.
Sunucu Hazırlığı
Öncelikle, taze bir Linux sunucunuz olduğundan emin olun ve temel sistem güncellemelerini yapın.
sudo apt update
sudo apt upgrade -y
Gerekli temel paketleri kurun:
sudo apt install -y git curl wget
Daha iyi güvenlik için sudo yetkilerine sahip yeni bir kullanıcı oluşturmanız önerilir:
sudo adduser manifolduser
sudo usermod -aG sudo manifolduser
su - manifolduser # Yeni kullanıcıya geçiş yapın
Bundan sonraki tüm komutları bu yeni kullanıcıyla çalıştırın.
Docker ve Docker Compose Kurulumu
Manifold, Docker konteynerleri içinde çalıştığı için Docker Engine ve Docker Compose’u kurmak zorunludur.
Docker Engine Kurulumu:
Resmi Docker belgelerini takip etmek en güvenli yoldur. Aşağıdaki adımlar Ubuntu için geçerlidir:
# Gerekli paketleri yükle
sudo apt install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common
Docker'ın resmi GPG anahtarını ekle
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Docker kararlı deposunu ekle
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
Paketi güncelle ve Docker Engine'i kur
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
Kullanıcınızı docker grubuna ekleyerek sudo olmadan Docker komutlarını çalıştırmasını sağlayın (bu adımı yeni kullanıcıya geçtikten sonra yapmalısınız):
sudo usermod -aG docker $USER
newgrp docker # Grubun hemen etkinleşmesini sağlar
Docker’ın doğru kurulduğunu test edin:
docker run hello-world
Docker Compose Kurulumu:
Docker Compose’u en son kararlı sürümünü yükleyin. Sürüm numarasını [Docker Compose GitHub deposundan](https://github.com/docker/compose/releases) kontrol edebilirsiniz.
# Örneğin, 1.29.2 sürümü için:
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
İzinleri ayarla
sudo chmod +x /usr/local/bin/docker-compose
Kurulumu doğrula
docker-compose --version
Manifold Kaynak Kodunu İndirme
Şimdi Manifold Scholar’ın kaynak kodunu sunucunuza klonlayın:
git clone https://github.com/ManifoldScholar/manifold.git
cd manifold
Genellikle belirli bir kararlı sürümü kullanmak daha iyidir. Manifold’un GitHub deposundaki “Releases” bölümünden en son kararlı sürümü kontrol edin ve o sürümün etiketine geçiş yapın. Örneğin, v6.0.0 sürümü için:
git checkout v6.0.0 # Kullanmak istediğiniz sürüm etiketini buraya yazın
Ortam Değişkenlerinin Yapılandırılması
Manifold’un davranışını kontrol eden ortam değişkenlerini ayarlamanız gerekir. Bu değişkenler .env dosyasında saklanır.
cp .env.example .env
Şimdi .env dosyasını bir metin düzenleyiciyle açın (nano .env veya vim .env) ve aşağıdaki değişkenleri yapılandırın:
* APP_URL: Manifold’unuzun erişilebilir olacağı alan adını belirtin (örn. https://manifold.kurumunuz.org). Bu çok önemlidir ve HTTPS kullanmanızı şiddetle tavsiye ederiz.
* SECRET_KEY_BASE: Manifold uygulaması için rastgele, uzun ve güvenli bir anahtar. Şunu kullanarak oluşturabilirsiniz:
docker-compose run --rm app mix phx.gen.secret
Çıktıyı kopyalayıp .env dosyasındaki SECRET_KEY_BASE değerine yapıştırın.
* DATABASE_URL: Varsayılan olarak Docker Compose ayarlarıyla uyumludur (ecto://postgres:password@db/manifold_prod). Genellikle değiştirmeye gerek yoktur, ancak password kısmını daha güçlü bir parola ile değiştirmeniz önerilir.
* REDIS_URL: Varsayılan olarak Docker Compose ayarlarıyla uyumludur (redis://redis:6379/0). Değiştirmeye gerek yoktur.
* MAILER_SENDER: Manifold’un e-posta gönderirken kullanacağı varsayılan gönderen adresi (örn. no-reply@kurumunuz.org).
* SMTP Ayarları (SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD): Manifold’un parola sıfırlama, kullanıcı davetleri vb. için e-posta gönderebilmesi için bir SMTP sunucusu yapılandırmanız gerekir. Kendi e-posta sunucunuzu veya bir e-posta hizmet sağlayıcısını (SendGrid, Mailgun, AWS SES vb.) kullanabilirsiniz.
* AWS S3 Ayarları (isteğe bağlı ama önerilir): Büyük dosyalar ve medya için S3 gibi bir bulut depolama hizmeti kullanmak performansı ve ölçeklenebilirliği artırır.
* AWS_ACCESS_KEY_ID
* AWS_SECRET_ACCESS_KEY
* AWS_BUCKET
* AWS_REGION
Bu ayarları, AWS hesabınızdan alacağınız bilgilerle doldurun. Yerel depolama kullanacaksanız bu kısmı boş bırakabilirsiniz, ancak üretim ortamları için S3 şiddetle tavsiye edilir.
.env dosyasını kaydettikten sonra devam edebilirsiniz.
Veritabanı ve Redis Ayarları
Docker Compose, veritabanı (PostgreSQL) ve Redis servislerini otomatik olarak başlatacaktır.
docker-compose up -d db redis # Sadece db ve redis servislerini başlatır
Servislerin çalışıp çalışmadığını kontrol edebilirsiniz:
docker-compose ps
Şimdi Manifold veritabanını oluşturun ve migrasyonları çalıştırın:
docker-compose run --rm app mix ecto.create
docker-compose run --rm app mix ecto.migrate
Bağımlılıkların Yüklenmesi ve Derleme
Manifold hem Elixir (backend) hem de Node.js (frontend) bağımlılıklarına sahiptir. Docker Compose, bu adımların çoğunu otomatikleştirir, ancak bazen manuel müdahale gerekebilir.
Frontend varlıklarını derlemek için:
docker-compose run --rm app npm install --prefix assets
docker-compose run --rm app npm run deploy --prefix assets
Backend bağımlılıklarını almak ve varlıkları derlemek için:
docker-compose run --rm app mix deps.get
docker-compose run --rm app mix assets.deploy
Bu adımlar biraz zaman alabilir.
Manifold Uygulamasını Başlatma
Tüm hazırlıklar tamamlandığında, Manifold uygulamasını ve diğer tüm servisleri başlatabilirsiniz:
docker-compose up -d
Uygulamanın loglarını kontrol ederek herhangi bir hata olup olmadığını gözlemleyebilirsiniz:
docker-compose logs -f
Uygulama genellikle 4000 portunda çalışır. Doğrudan IP adresiniz ve 4000 portu üzerinden erişmeyi deneyebilirsiniz (örn. http://YOUR_SERVER_IP:4000). Ancak, bu üretim ortamı için önerilmez.
Ters Proxy (Nginx/Caddy) Kurulumu
Manifold’u alan adınız üzerinden güvenli bir şekilde erişilebilir kılmak için bir ters proxy (Nginx veya Caddy) kurmanız gerekir. Bu, aynı zamanda SSL sertifikalarını yönetmek için de kullanılacaktır. Nginx en yaygın kullanılan seçenektir.
Nginx Kurulumu ve Yapılandırması:
sudo apt install -y nginx
Yeni bir Nginx yapılandırma dosyası oluşturun (örn. /etc/nginx/sites-available/manifold.conf):
sudo nano /etc/nginx/sites-available/manifold.conf
Aşağıdaki içeriği yapıştırın, manifold.kurumunuz.org yerine kendi alan adınızı yazın:
server {
listen 80;
server_name manifold.kurumunuz.org;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name manifold.kurumunuz.org;
ssl_certificate /etc/letsencrypt/live/manifold.kurumunuz.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/manifold.kurumunuz.org/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf;
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
location / {
proxy_pass http://localhost:4000; # Manifold'un çalıştığı port
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_buffering off;
proxy_read_timeout 90s;
proxy_redirect off;
}
}
Yapılandırma dosyasını etkinleştirin ve Nginx’i yeniden başlatın:
sudo ln -s /etc/nginx/sites-available/manifold.conf /etc/nginx/sites-enabled/
sudo nginx -t # Yapılandırma hatası kontrolü
sudo systemctl restart nginx
SSL Sertifikası (Let’s Encrypt ile Certbot):
Certbot’u kurun:
sudo apt install -y certbot python3-certbot-nginx
Sertifikayı alın (Nginx eklentisi otomatik yapılandırma yapacaktır):
sudo certbot --nginx -d manifold.kurumunuz.org
Certbot size birkaç soru soracak ve sertifikayı otomatik olarak yapılandıracaktır. Yenilemelerin otomatik olduğundan emin olun (sudo systemctl status certbot.timer).
Artık Manifold Scholar’a https://manifold.kurumunuz.org adresinden erişebiliyor olmanız gerekir.
Manifold Scholar Yapılandırması
Manifold Scholar’ın kurulumu tamamlandıktan sonra, platformu kurumunuzun veya projenizin özel ihtiyaçlarına göre yapılandırmanız gerekir. Bu bölüm, temel yönetimsel ayarlardan içerik yönetimine ve entegrasyonlara kadar çeşitli yapılandırma adımlarını ele alacaktır.
Yönetici Hesabı Oluşturma
Manifold’a ilk kez eriştiğinizde, platformu yönetebilmek için bir yönetici hesabı oluşturmanız gerekir. Bu işlemi komut satırı üzerinden yaparsınız:
docker-compose run --rm app mix manifold.create_admin
Bu komut, sizden bir e-posta adresi ve parola isteyecektir. Girdiğiniz bilgilerle yönetici hesabı oluşturulacak ve bu hesapla Manifold’un yönetim paneline giriş yapabileceksiniz.
Temel Sistem Ayarları
Yönetici hesabınızla giriş yaptıktan sonra, web arayüzü üzerinden çeşitli sistem ayarlarını yapılandırabilirsiniz. Genellikle bu ayarlar “Admin” veya “Settings” menüsü altında bulunur.
* Site Adı ve Açıklama: Manifold sitenizin adını ve kısa bir açıklamasını belirleyin. Bu bilgiler, sitenizin başlığında ve arama motorları için meta etiketlerinde kullanılacaktır.
* Dil ve Zaman Dilimi: Sitenin varsayılan dilini ve sunucunuzun zaman dilimine uygun zaman dilimini ayarlayın.
* Tema: Manifold, farklı temalar veya stil özelleştirmeleri sunabilir. Kurumunuzun görsel kimliğine uygun bir tema seçebilir veya CSS üzerinden özel stil tanımlamaları yapabilirsiniz.
* Kullanıcı Kayıt Ayarları: Kullanıcıların kendi kendilerine kayıt olmasına izin verilip verilmeyeceğini veya sadece davetle mi kayıt olabileceklerini belirleyin. Genellikle ilk başta açık bırakılır, ancak daha sonra kısıtlanabilir.
* E-posta Ayarları: SMTP sunucusu ayarlarınızı (host, port, kullanıcı adı, parola) web arayüzünden tekrar kontrol edip doğrulayın. Bu ayarlar, parola sıfırlama, bildirimler ve yeni kullanıcı davetleri için kritiktir.
* Depolama Ayarları: Eğer .env dosyasında S3 ayarlarını yapmadıysanız veya değiştirmek isterseniz, bu bölümden yerel depolama veya S3 gibi bulut depolama seçeneklerini yapılandırabilirsiniz. Üretim ortamları için S3’ü kullanmanız şiddetle tavsiye edilir.
İçerik Ayarları
Manifold, yayınlarınızı ve koleksiyonlarınızı düzenlemeniz için esnek bir yapı sunar.
* Koleksiyonlar: Yayınlarınızı temalarına, departmanlara veya projelere göre gruplandırmak için koleksiyonlar oluşturun. Her koleksiyonun kendi adı, açıklaması ve kapak görseli olabilir.
* Yayınlar (Publications): Her bir akademik eseri (kitap, dergi sayısı, tez vb.) bir yayın olarak Manifold’a ekleyin. Yayınlara başlık, yazar bilgileri, ISBN, DOI, özet ve kapak görseli gibi meta veriler ekleyin.
* Metinler (Texts): Yayınların ana içeriğini oluşturan metinleri (bölümler, makaleler) yükleyin. Manifold, Markdown, EPUB, PDF ve hatta HTML gibi farklı formatları destekler. Metinleri yükledikten sonra, Manifold’un kendi okuyucu arayüzünde doğru bir şekilde görüntülendiğinden emin olun. Etkileşimli özellikler (not alma, yorumlar) metinler üzerinde çalışır.
* Medya: Metinlerinizi zenginleştirmek için görseller, ses dosyaları, videolar ve diğer multimedya öğelerini yükleyin ve yayınlarınızla ilişkilendirin.
* Yorum ve Not Alma Ayarları: Okuyucuların yorum yapma ve metinler üzerinde not alma yeteneklerini etkinleştirin veya devre dışı bırakın. Yorumların moderasyon gerektirip gerektirmediğini ayarlayabilirsiniz.
Entegrasyonlar
Manifold, diğer akademik ve web hizmetleriyle entegrasyonlar sunarak işlevselliğini artırır.
* ORCID Entegrasyonu: Yazarların ve araştırmacıların ORCID kimliklerini Manifold profilleriyle ilişkilendirmelerine olanak tanıyın. Bu, akademik kimliklerin doğrulanmasına ve görünürlüğünün artırılmasına yardımcı olur.
* Sosyal Medya Paylaşımı: Yayınların kolayca sosyal medya platformlarında paylaşılabilmesi için düğmeler ve meta veriler sağlayın.
* Analitik Araçları: Google Analytics gibi araçları entegre ederek sitenizin trafik ve kullanıcı davranışları hakkında bilgi toplayın. Bu, yayınlarınızın ne kadar etkileşim aldığını anlamanıza yardımcı olur.
* DOI Entegrasyonu: Yayınlarınıza Digital Object Identifier (DOI) atayarak akademik görünürlüklerini artırın. Bu genellikle bir DOI kayıt ajansı (Crossref, DataCite) ile entegrasyon gerektirir.
Güvenlik ve Performans Optimizasyonları
Yapılandırma sürecinin bir parçası olarak, sisteminizin güvenliğini ve performansını sürekli olarak göz önünde bulundurmalısınız.
* Düzenli Yedeklemeler: Veritabanı ve yüklü dosyalarınızın düzenli yedeklemelerini otomatikleştirin. Felaket durumlarında veri kaybını önlemek için bu kritik bir adımdır.
* Güvenlik Duvarı Kuralları: Sunucunuzdaki güvenlik duvarının sadece gerekli portlara (SSH, HTTP, HTTPS) erişime izin verdiğinden emin olun.
* Performans İzleme: Sunucu kaynaklarını (CPU, RAM, disk I/O) ve uygulama performansını izlemek için araçlar kullanın. Bu, olası darboğazları erken tespit etmenizi sağlar.
* Güncellemeler: Manifold Scholar ve temel sistem bileşenlerini (işletim sistemi, Docker, Nginx) düzenli olarak güncelleyerek güvenlik açıklarını kapatın ve yeni özelliklerden faydalanın.
Bu yapılandırma adımları, Manifold Scholar platformunuzu tam işlevsel ve kurumunuzun hedeflerine uygun hale getirecektir.
Manifold Scholar Kullanımı ve Temel İşlevler
Manifold Scholar kurulumu ve temel yapılandırması tamamlandıktan sonra, platformu aktif olarak kullanmaya başlayabilir ve akademik yayınlarınızı yönetebilirsiniz. Bu bölümde, Manifold’un temel kullanım senaryoları ve işlevleri ele alınacaktır.
Yayın Oluşturma ve Yönetme
Manifold’un kalbi, yayınlarınızın ve koleksiyonlarınızın oluşturulduğu ve yönetildiği yerdir.
* Koleksiyonlar Oluşturma: Yönetici paneli üzerinden yeni koleksiyonlar oluşturarak yayınlarınızı mantıksal gruplara ayırın. Örneğin, “Tarih Bölümü Yayınları”, “Yıllık Konferans Bildirileri” veya “Açık Erişim Kitapları” gibi koleksiyonlar oluşturabilirsiniz. Her koleksiyon için bir başlık, açıklama ve isteğe bağlı olarak bir kapak görseli belirleyin.
* Yeni Yayın Ekleme: Bir koleksiyon içine veya bağımsız olarak yeni bir yayın ekleyin. Her yayın için aşağıdaki bilgileri girmeniz gerekecektir:
* Başlık ve Alt Başlık: Yayının tam adı.
* Yazar/Editör Bilgileri: Yazar(lar)ın veya editör(ler)in adları ve ORCID kimlikleri (varsa).
* Özet (Abstract): Yayının içeriğini özetleyen kısa bir metin.
* Meta Veriler: ISBN, DOI, yayın tarihi, anahtar kelimeler, diller gibi ek meta veriler. Bu bilgiler, arama motorları ve akademik indeksleme hizmetleri için önemlidir.
* Kapak Görseli: Yayını temsil eden bir görsel.
* Lisanslama: Yayının hangi açık erişim lisansı (Creative Commons gibi) altında yayınlandığını belirtin.
* Metinleri Yükleme ve Düzenleme: Yayının ana içeriğini oluşturan metinleri (kitap bölümleri, makaleler) yükleyin. Manifold, genellikle Markdown, EPUB ve PDF formatlarını destekler.
* Markdown: Metinlerinizi Markdown formatında yazıp doğrudan Manifold’a yapıştırabilir veya yükleyebilirsiniz. Markdown, basit ve güçlü bir biçimlendirme dilidir.
* EPUB/PDF: Mevcut EPUB veya PDF dosyalarınızı yükleyerek okuyuculara farklı formatlarda okuma seçenekleri sunabilirsiniz. Manifold, EPUB dosyalarını genellikle web tabanlı okuyucusuna dönüştürerek interaktif özelliklerini etkinleştirir.
* Metin Editörü: Manifold’un kendi web tabanlı editörünü kullanarak metinleri düzenleyebilir, başlıklar, paragraflar, listeler, bağlantılar ve görseller ekleyebilirsiniz.
* Medya Ekleme: Metinlerinizi zenginleştirmek için görseller, tablolar, ses dosyaları ve videolar gibi multimedya öğelerini yükleyebilir ve metin içinde uygun yerlere yerleştirebilirsiniz. Bu, karmaşık konuları daha anlaşılır hale getirir ve okuyucu deneyimini geliştirir.
Okuyucu Deneyimi
Manifold’un en güçlü yönlerinden biri, okuyuculara sunduğu zengin ve etkileşimli deneyimdir.
* Etkileşimli Not Alma: Okuyucular, yayınlar üzerindeki metinleri vurgulayabilir ve bu vurgulara kişisel veya herkese açık notlar ekleyebilir. Bu notlar, diğer okuyucular tarafından görülebilir ve tartışılabilir, böylece metin etrafında bir topluluk oluşur.
* Yorum Yapma: Yayınların genelinde veya belirli bölümlerinde yorumlar bırakılabilir. Bu, yazarlar ve okuyucular arasında doğrudan bir diyalog kurulmasını sağlar.
* Farklı Formatlarda Okuma: Okuyucular, web tarayıcısı üzerinden okumanın yanı sıra, yayınları EPUB veya PDF gibi formatlarda indirerek çevrimdışı okuma veya farklı cihazlarda görüntüleme imkanına sahip olurlar.
* Kişiselleştirilmiş Görünüm: Okuyucular, okuma deneyimlerini kendi tercihlerine göre ayarlayabilirler (örneğin, yazı tipi boyutu, arka plan rengi).
* Medya Entegrasyonu: Metin içinde yer alan görseller, videolar ve diğer medya öğeleri sorunsuz bir şekilde görüntülenir, bu da okuma deneyimini daha dinamik ve ilgi çekici hale getirir.
Kullanıcı ve Rol Yönetimi
Manifold, farklı kullanıcı rolleriyle platform üzerindeki erişim ve yetkilendirmeyi yönetmenizi sağlar.
* Kullanıcı Kaydı ve Yönetimi: Yeni kullanıcıları davet edebilir veya kendi kendilerine kayıt olmalarına izin verebilirsiniz. Kullanıcı profillerini yönetebilir, e-posta adreslerini değiştirebilir veya hesaplarını silebilirsiniz.
* Roller ve İzinler: Manifold genellikle “Okuyucu”, “Yazar”, “Editör” ve “Yönetici” gibi farklı roller sunar.
* Okuyucular: Sadece yayınları okuyabilir, not alabilir ve yorum yapabilir.
* Yazarlar: Kendi yayınlarını oluşturabilir, düzenleyebilir ve yönetebilir.
* Editörler: Birden fazla yayını veya koleksiyonu yönetebilir, yazarların çalışmalarını denetleyebilir.
* Yöneticiler: Tüm sistem ayarlarını, kullanıcıları, yayınları ve koleksiyonları yönetme yetkisine sahiptir.
* Moderasyon: Yorumlar ve notlar gibi kullanıcı tarafından oluşturulan içeriklerin moderasyonunu yaparak platformda uygun bir iletişim ortamı sağlayabilirsiniz.
Manifold Scholar’ın bu temel işlevlerini kullanarak, kurumunuzun akademik yayınlarını modern, etkileşimli ve erişilebilir bir platformda sunabilirsiniz. Platformun esnek yapısı, zamanla yeni özellikler ve entegrasyonlar eklemenize de olanak tanır.
Sıkça Sorulan Sorular ve Sorun Giderme
Manifold Scholar kurulumu ve kullanımı sırasında karşılaşabileceğiniz bazı yaygın sorunlar ve bunların çözümleri aşağıda listelenmiştir.
Kurulum Hataları
* Docker veya Docker Compose Bulunamadı:
* Sorun: docker: command not found veya docker-compose: command not found.
* Çözüm: Docker ve Docker Compose’un doğru şekilde kurulduğundan ve yürütülebilir dosyaların sistem PATH’inde olduğundan emin olun. Ayrıca, kullanıcınızın docker grubunda olup olmadığını ve newgrp docker komutunu çalıştırdığınızı kontrol edin.
* Bağımlılık Yükleme Hataları (mix deps.get, npm install):
* Sorun: mix veya npm komutları sırasında hatalar alınıyor.
* Çözüm: İnternet bağlantınızı kontrol edin. Manifold kaynak kodunun doğru klasörde olduğundan (cd manifold) emin olun. Docker konteynerleri içinde çalıştırırken, konteynerin internet erişimi olduğundan emin olun. Bazen Docker’ı yeniden başlatmak (sudo systemctl restart docker) sorunu çözebilir.
* Veritabanı Bağlantı Hataları:
* Sorun: mix ecto.create veya mix ecto.migrate sırasında veritabanına bağlanılamıyor.
* Çözüm: .env dosyasındaki DATABASE_URL ayarının doğru olduğundan ve db Docker servisinin çalıştığından emin olun (docker-compose ps). Veritabanı konteynerinin loglarını kontrol edin (docker-compose logs db).
* SECRET_KEY_BASE Hatası:
* Sorun: Uygulama başlarken SECRET_KEY_BASE‘in ayarlanmadığına dair bir hata.
* Çözüm: .env dosyasında SECRET_KEY_BASE değişkeninin ayarlandığından ve değerinin rastgele, uzun bir dize olduğundan emin olun. docker-compose run --rm app mix phx.gen.secret komutunu tekrar çalıştırıp çıktıyı kopyalayın.
E-posta Gönderme Sorunları
* Parola Sıfırlama veya Davet E-postaları Gelmiyor:
* Sorun: Manifold’dan gönderilen e-postalar ulaşmıyor.
* Çözüm:
1. .env dosyasındaki (veya yönetim panelindeki) SMTP ayarlarınızın (host, port, kullanıcı adı, parola) doğru olduğundan emin olun.
2. SMTP sunucunuzun güvenlik duvarı tarafından engellenmediğini kontrol edin.
3. SMTP sunucunuzun loglarını inceleyerek e-posta gönderme hatası olup olmadığını kontrol edin.
4. Gönderen e-posta adresinizin (MAILER_SENDER) doğru olduğundan ve spam filtrelerine takılmadığından emin olun.
5. Bazı sağlayıcılar TLS/SSL gerektirebilir, bu ayarların doğru olduğundan emin olun.
S3 Entegrasyonu Hataları
* Dosya Yükleme Sorunları (S3 kullanırken):
* Sorun: Görsel veya diğer medya dosyaları yüklenirken hata oluşuyor.
* Çözüm:
1. .env dosyasındaki AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_BUCKET ve AWS_REGION ayarlarının doğru olduğundan emin olun.
2. AWS IAM kullanıcınızın veya rolünüzün S3 bucket’ına dosya yükleme (PutObject) ve okuma (GetObject) izinlerine sahip olduğunu kontrol edin.
3. S3 bucket adınızın doğru olduğundan ve bölgenizin Manifold ayarlarıyla eşleştiğinden emin olun.
Performans Sorunları
* Uygulama Yavaş Çalışıyor:
* Sorun: Sayfalar yavaş yükleniyor, işlemler uzun sürüyor.
* Çözüm:
1. Sunucunuzun CPU, RAM ve disk I/O kullanımını izleyin. Kaynak yetersizliği varsa sunucunuzu yükseltmeniz gerekebilir.
2. Veritabanı sorgularını ve uygulamanın loglarını inceleyerek performans darboğazlarını tespit etmeye çalışın.
3. Redis’in düzgün çalıştığından emin olun, önbellekleme sorunları performansı etkileyebilir.
4. Nginx gibi ters proxy’nin doğru yapılandırıldığından ve performans ayarlarının optimize edildiğinden emin olun.
Güncelleme Süreci
* Manifold Scholar’ı Güncelleme:
* Sorun: Mevcut bir Manifold kurulumunu en son sürüme nasıl güncelleyeceğinizi bilmiyorsunuz.
* Çözüm:
1. Tüm veritabanı ve dosya yedeklerinizi alın.
2. Mevcut Docker konteynerlerini durdurun: docker-compose down.
3. Git ile en son sürümü çekin: git pull origin master (veya belirli bir sürüm etiketine geçin: git checkout vX.Y.Z).
4. .env dosyanızı kontrol edin, yeni bir sürümle eklenen yeni ortam değişkenleri olabilir. Gerekirse .env.example ile karşılaştırın.
5. Bağımlılıkları ve varlıkları yeniden yükleyin/derleyin:
docker-compose run --rm app mix deps.get
docker-compose run --rm app npm install --prefix assets
docker-compose run --rm app npm run deploy --prefix assets
docker-compose run --rm app mix assets.deploy
docker-compose run --rm app mix ecto.migrate
6. Uygulamayı yeniden başlatın: docker-compose up -d.
7. Logları kontrol edin.
Manifold Topluluğundan Yardım Alma
Yukarıdaki çözümler sorunlarınızı gidermezse, Manifold Scholar’ın aktif topluluğundan yardım alabilirsiniz:
* GitHub Issues: Manifold’un GitHub deposundaki “Issues” bölümünü kontrol edin. Benzer bir sorunla karşılaşmış başkaları olabilir veya yeni bir sorun açabilirsiniz.
* Manifold Scholar Forumları/Listeleri: Projenin resmi web sitesinde veya belgelerinde belirtilen topluluk forumlarına veya e-posta listelerine katılarak yardım isteyebilirsiniz.
Sorun giderme sürecinde, hatanın tam mesajını, yaptığınız adımları ve sistem yapılandırmanızı (işletim sistemi, Docker sürümü vb.) detaylı bir şekilde paylaşmak, daha hızlı ve doğru çözümlere ulaşmanızı sağlayacaktır.
Sonuç
Manifold Scholar, geleneksel akademik yayıncılığın statik doğasını dönüştürmeyi hedefleyen güçlü ve yenilikçi bir platformdur. Bu kapsamlı rehberde, Manifold Scholar’ı kendi sunucunuza kurmak için gerekli olan ön hazırlıklardan (sistem gereksinimleri, alan adı, SSL), adım adım kurulum sürecine (Docker entegrasyonu, kaynak kodu indirme, ortam değişkenleri, ters proxy), temel yapılandırma adımlarına (yönetici hesabı, sistem ayarları, içerik yönetimi) ve son olarak sıkça karşılaşılan sorunlara ve çözümlerine kadar her detayı ele aldık.
Manifold Scholar’ın kurulumu, özellikle Docker ve Linux ortamlarına aşina olmayanlar için ilk başta karmaşık görünebilir. Ancak, bu adımları dikkatlice takip ederek ve her bir bileşenin amacını anlayarak, kurumunuz için modern, etkileşimli ve açık erişimli bir yayıncılık altyapısı kurabilirsiniz. Bu platform, akademik metinlerinizi sadece okunabilir olmaktan çıkarıp, tartışılabilir, zenginleştirilebilir ve topluluk odaklı bir deneyime dönüştürme potansiyeli taşır.
Açık erişimli yayıncılığın geleceği, bilginin daha geniş kitlelere ulaşması, şeffaflığın artması ve akademik diyaloğun teşvik edilmesi üzerine kuruludur. Manifold Scholar, bu vizyonu gerçeğe dönüştürmek için tasarlanmış bir araçtır. Kurulumu tamamladığınızda, yayıncılar, yazarlar ve okuyucular için daha zengin bir akademik deneyim sunarak bilginin yayılımına önemli bir katkı sağlamış olacaksınız. Unutmayın ki, Manifold’un sunduğu esneklik ve açık kaynak yapısı, platformu kendi özel ihtiyaçlarınıza göre zamanla daha da geliştirmenize olanak tanır.
