Blog yazılarımı Linux kılavuz sayfası olarak sunmak

Blog gönderilerini Linux kılavuz sayfası olarak sunmak

• Linux bilgisayarlarda, belirli komutların nasıl kullanılacağını açıklayan kılavuz sayfaları önceden yüklü gelir.
• Kılavuz sayfalarını okumak için terminale man <command> yazabilirsiniz.
• Yüklediğiniz komut satırı yazılımları da bazen kılavuz sayfaları ekler.
• Linux kılavuz sayfaları roff sözdizimi kullanılarak biçimlendirilir.
• roff, Unix için geliştirilen ilk dizgi komut satırı yazılımıdır ve Bell Labs tarafından geliştirilmiştir.
• Blog gönderilerini Linux kılavuz sayfası olarak sunma fikri inceleniyor.

Sistem tasarımı: içerik uzlaşması

• Kullanıcıların HTTP içerik uzlaşması yoluyla blog gönderilerinin roff sürümünü isteyebilmesi amaçlanıyor.
• İçerik uzlaşması, belirli bir dosya biçiminin istenebilmesini sağlayan HTTP'nin bir parçasıdır.
• Sunucudan belirli bir biçimde içerik istemek için HTTP başlıkları kullanılır.
• Accept başlığı gönderen kullanıcı istekleri yönlendirilebilir.
• text/roff belgesi istenirse, man komutuyla açılabilen bir kılavuz sayfası döndürülebilir.

Kılavuz sayfası yazımı

• Kılavuz sayfaları roff sözdizimi kullandığı için, blog gönderilerinin bu biçimde de bulunması gerekir.
• Site güncellenerek her blog gönderisi için bir man sayfası üretiliyor.
• Kılavuz sayfasını oluşturmak için alan adı başlık olarak ayarlanıyor ve başlık, yazar, yayın tarihi, gönderi içeriği ve gönderi URL'sinden oluşan beş bölüm hazırlanıyor.
• Özgün içerik Markdown biçiminde ve bazen boşluklar kılavuz sayfasında doğru görüntülenmeyebiliyor.
• Markdown, HTML'ye göre daha okunaklı ve daha az bilgi kaybına yol açıyor.

Kılavuz sayfası isteme

• Bir blog gönderisinin roff biçimini istemek için şu komut kullanılabilir:

  curl -sL -H "Accept: text/roff" https://jamesg.blog/2024/02/28/programming-projects/ > post.page && man ./post.page
  

• Sonuç, bir Linux kılavuz sayfası olarak açılabilir.
• Tarayıcı HTML sürümünü isterken, curl komutu text/roff sürümünü ister.
• NGINX yapılandırmasına birkaç satır eklenerek sunucunun text/roff isteğine verdiği yanıt değiştiriliyor.
• NGINX yapılandırma dosyasında, belirli bir içerik türü algılandığında bir bayrak ayarlayan değişken tanımlanıyor.
• Sitenin NGINX ayarlarında, roff sayfası istendiğinde isteği farklı ele alan kod kullanılıyor.
• Artık bu web sitesindeki blog gönderileri Linux kılavuz sayfaları olarak okunabiliyor.
• Bu, NGINX'te içerik uzlaşmasının nasıl kullanılabileceğine ve dizgi teknolojisinin ne kadar ilerlediğine dair bir inceleme.

GN⁺ görüşü

• Bu yazı, blog içeriğini Linux kılavuz sayfaları üzerinden sunmanın özgün bir yolunu tanıttığı için teknoloji meraklılarının ilgisini çekebilir.
• NGINX ile içerik uzlaşmasının gerçek bir kullanım örneğini sunarak web sunucusu yöneticileri ve geliştiriciler için faydalı bilgiler veriyor.
• Eleştirel açıdan bakıldığında, Markdown biçimi kılavuz sayfalarında her zaman iyi görünmeyebilir; bunu iyileştirmek için ek çalışma gerekebilir.
• Benzer işlev sunan başka projeler arasında, çeşitli belge biçimleri arasında dönüşüm sağlayan pandoc gibi araçlar bulunur.
• Bu tekniği benimserken kullanıcı gereksinimleri ve uyumluluk dikkate alınmalıdır.
• Bu yaklaşımın avantajı, mevcut web içeriğini Linux kullanıcılarına tanıdık bir biçimde sunabilmesidir; dezavantajı ise ek bakım ve uyumluluk sorunları doğurabilmesidir.