Ubuntu 17.10 Üzerinde Raneto Kurulumu

• Ön şartlar
• Giriş
• Node.js ve PM2'yi Yükleme
• Raneto Kurulumu
• Diğer Yapılandırma
• Sayfa Ekleme
• Kategori Ekleme

Raneto, Node.js üzerine kurulmuş, kurulumu ve kullanımı kolay, aynı zamanda yönetimi kolay olan ücretsiz ve açık kaynaklı bir bilgi tabanıdır. Kategoriler ve sayfalar, düzenlemeyi kolaylaştıran Markdown'da yazılmıştır. Markdown sizin işiniz değilse, Raneto ayrıca HTML kullanmanıza izin verir.

Ön şartlar

• Ubuntu 17.10 kurulu bir VPS.
• VPS'nize SSH erişimi.
• Linux terminalinin temel anlayışı.

Giriş

Öncelikle SSH kullanarak sunucumuza giriş yapmamız gerekiyor. Bunu yapmak için favori SSH istemcinizi açın.

ssh root@SERVER_IP

Şifrenizi girdikten sonra (Vultr kontrol panelinden alabilirsiniz) VPS'nize giriş yapacaksınız.

Node.js ve PM2'yi Yükleme

Raneto, bir javascript çalışma zamanı ve çerçevesi olan Node.js üzerinde çalışır. Bu eğitimde, uzun vadeli desteği nedeniyle Node.js v8'i kullanacağız. Aşağıdaki komutu yazarak kurulumu başlatın.

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

Bu komut dosyasının çalışması bittikten sonra ana yüklemeyi çalıştırabilirsiniz.

sudo apt-get install -y nodejs

Bu yükleyici tamamlandıktan sonra, VPS'nize Node.js'nin güncel bir kopyasını yükleyeceksiniz. Ardından, Raneto'nun (ve diğer birçok Node.js uygulamasının) çalıştırılmasını kolaylaştıran Node.js için bir işlem yöneticisi olan PM2'yi yükleyeceğiz.

npm install pm2 -g

Artık Raneto'yu kurmak için ihtiyacımız olan tüm yazılımlara sahibiz.

Raneto Kurulumu

Git'i Raneto deposunu sunucumuza klonlamak için kullanacağız.

git clone https://github.com/gilbitron/Raneto.git

Bu adlı bir klasör oluşturur Raneto. Klasörü girin.

cd Raneto

NPM'yi yükleyin.

npm install

Aşağıdakileri yazarak Gulp'i çalıştırın.

npm run gulp

Gulp çalışmayı bitirdiğinde, aşağıdaki iki komuttan birini kullanarak uygulamamıza başlayabiliriz.

npm start
# or
npm example/server.js

Artık şuraya giderek yeni Raneto kurulumunuza erişebileceksiniz SERVER_IP:3000. Bu öğreticinin geri kalanı Raneto'yu nasıl yapılandıracağınızı, yeni sayfalar oluşturacağınızı, kategoriler ekleyeceğinizi, sıralamayı ayarlayacağınızı, özel bir ana sayfa ekleyeceğinizi ve şablonu nasıl düzenleyeceğinizi öğretecektir.

Diğer Yapılandırma

Artık VPS'nizde varsayılan bir Raneto yüklemesi var. Başka bir şey yapmaya başlamadan önce, varsayılan yapılandırma ve kurulumda birkaç değişiklik yapmanızı öneririm.

Klasörde config.default.jsbulunan bir göz atalım example. Bu yapılandırma dosyası oldukça uzun, ancak çok yorumlandığı için lütfen bunalmayın. Düzenlemeniz gereken özellikler şunlardır:

• site_title - Bunu web sitenizin başlığına değiştirin.
• base_url- Bu, sitenizin URL'sine ayarlanmalıdır. Sayfaları düzenlerken değişken olarak kullanılabilir.
• support_email- Bunu geçerli bir e-posta ile değiştirin. Sitenin altbilgisinde gösterilir.
• copyright - Altbilgi metni.
• analytics - Buraya bir Google Analytics izleme kodu ekleyin.
• allow_editing - Web düzenleyicisini kullanarak dosyaları düzenleyebilmek ister misiniz?
• authentication_for_read - Kullanıcıların web sitesini görüntülemek için giriş yapmasını ister misiniz?
• credentials - Oturum açma etkinse kullanıcıları buraya ekleyin.
• locale - Dil.
• datetime_format - Tarih ve saat biçimi.
• home_meta - Ana sayfanızın meta bilgilerini değiştirmek için bunu düzenleyin.
• table_of_content - Raneto içindekiler tablosu görüntülenmeli mi?

Çevrimiçi Düzenleyiciyi Kullanma

Raneto sayfaları, kategorileri ve daha fazlasını yönetmek için kullanımı kolay bir çevrimiçi arayüzle birlikte gelir. Her şeyi yapmanıza izin vermese de, hareket halindeyken hızlı bir düzenleme yapmanız gerekirse kesinlikle yararlıdır.

Ayarı etkinleştirerek config.default.js(yukarıda belirtildiği gibi) ve ardından VPS'nizi ziyaret edip sağ üst köşedeki giriş düğmesini tıklayarak erişebilirsiniz . Kullanıcı adınızı ve şifrenizi girin (bunları değiştirebilirsiniz config.default.js) ve giriş'i tıklayın. Düzenlemek istediğiniz sayfayı tıklayın, Actionsaçılır menüyü tıklayın ve tamamlamak istediğiniz işlemi seçin. +Kategori adının yanındaki düğmeye basarak sayfa ekleyebilir ve sol üst köşedeki giriş alanını kullanarak kategoriler oluşturabilirsiniz.

Sayfa Ekleme

Sayfa eklemek .md, example/contentklasörde yeni bir Markdown ( ) belgesi oluşturmak kadar basittir .

Yeni bir Markdown dosyası oluşturduktan sonra, dosyanın üstüne bazı temel bilgiler eklemeniz önemlidir. Dosyayı favori metin düzenleyicinizde açın. Dosyanın üstüne aşağıdakileri eklememiz gerekiyor.

/*
 Title: Enter your page title here, if none is added, the file-name will be used
 Description: Enter your page's description here (for search engines and the site search feature)
 ShowOnHome: true/false
 */

Gerekirse, sayfalarınızda aşağıdaki değişkenleri de kullanabilirsiniz:

• %base_url% - Bu, web sitenizin URL'sinden bahsetmenizi sağlar.
• %image_url% - Bu, resim dizininizin temel URL'sini almanızı sağlar.

Kategori Ekleme

Bilgi tabanınıza kolayca kategoriler ekleyebilirsiniz. Dizinde yeni bir klasör oluşturun example/contentve o kategoride olmasını istediğiniz sayfaları bu klasöre yerleştirin. Örneğin , ve helpadlı sayfalarla adlandırılan bir kategori istediğimizi düşünelim . Dosyalar şöyle görünür:contacthelp-meawesome

/example/content/help/contact.md
/example/content/help/help-me.md
/example/content/help/awesome.md

Kategorilerin içine istediğiniz kadar alt klasör ekleyebilirsiniz.

Kategoriler meta bilgilere de sahip olabilir. metaKategori klasöründe adlı bir dosya oluşturun . Aşağıdaki öznitelikler desteklenir (tümü isteğe bağlı):

• Başlık - Klasör adına göre başlığı geçersiz kılar.
• Sırala - Kategorilerin sırasını sıralamanızı sağlar, sayfaları sıralamakla aynı şekilde çalışır.
• ShowOnHome - doğru / yanlış.

Özel Ana Sayfa

Özel bir ana sayfasını eklemek istiyorsanız, yapmanız gereken tek şey adlı bir markdown dosyası eklemek olduğunu index.mdsizin için example/contentklasörünün.

Sayfaları Sıralama

Raneto sayfaları otomatik olarak alfabetik olarak sıralar, ancak Sortsayfa meta alanına bir öğe ekleyerek manuel sıralama uygulayabilirsiniz . Sıralama değeri bir tamsayı olmalıdır, örneğin:

Sort: 7

Bu sayfa artık sıralama değeri 8 veya daha fazla olan sayfalardan önce, ancak değeri 6 veya daha az olan sayfalardan sonra görünecektir.

Şablonu Değiştirme

HTML veya CSS hakkında bilginiz varsa, Raneto kurulumunuzun görünümünü kolayca değiştirebilirsiniz. Raneto, HTML düzenlemesini modüle eden bir JavaScript şablon dili olan Gidon kullanır. Tema dosyalarını themes/defaultklasörde bulabilirsiniz. Renato şablonlarını düzenleme hakkında daha fazla bilgi edinmek için yardım bölümlerini ziyaret edebilirsiniz . Şablonu düzenlemeyi bitirdikten sonra uygulamayı yeniden başlattığınızdan emin olun.