Gatsby, React üzerine inşa edilmiş ve GraphQL tarafından desteklenen son derece hızlı bir statik site oluşturucudur. Gatsby sitelerini inanılmaz derecede hızlı ve esnek yapan şeylerden biri de eklenti ekosistemidir. Gatsby eklentileri, işlevselliği genişletmek ve siteleri özelleştirmek için Gatsby API'lerini uygulayan NPM paketleridir. Bu makalede, görüntü optimizasyonu, çevrimdışı destek, stil oluşturma, meta veri yönetimi ve daha fazlası gibi görevler için en popüler ve kullanışlı Gatsby eklentilerinden bazılarını keşfedeceğiz.
HubSpot]'a göre (https://blog.hubspot.com/marketing/page-load-time-conversion-rates), müşterilerin %70'inin hızlı yüklenen bir web sitesine sahip bir şirketten satın alma olasılığı daha yüksektir. Bu, web sitenizin yüklenmesi çok uzun sürerse, insanların büyük olasılıkla siteyi terk edeceği anlamına gelir. Bu eklentiler, Gatsby eklenti mimarisinin sitenizi neredeyse tüm JavaScript kütüphanelerinden veya web özelliklerinden yararlanacak şekilde uyarlamanıza nasıl olanak sağladığını göstermektedir. Eklentileri karıştırıp eşleştirerek, tam olarak ihtiyaçlarınıza göre uyarlanmış bir Gatsby sitesi oluşturabilir ve React ile modern web teknolojilerinin performans ve yeteneklerinden yararlanabilirsiniz.
Bu makalede popüler eklentilerden bazılarını tartışacağız ve bunların nasıl kullanılacağına dair bazı bilgiler vermeye çalışacağız.
En popüler Gatsby eklentilerinden bazıları nelerdir?
İşte birkaç popüler Gatsby teması ve eklentisi:
-
Gatsby-plugin-image: Görüntü bileşenlerinin gelişmiş yanıt verebilirliği yoluyla web sitesi performansını artırmak gatsby-plugin-image'ın uzmanlık alanıdır.
-
Gatsby-plugin-sharp: Görüntü işleme ve optimizasyonunu ele alan gatsby-plugin-sarp, web sitesi performansını önemli ölçüde artıran bir eklenti olarak parlıyor.
-
Gatsby-plugin-manifest: Kullanıcıları Progresif Web Uygulamaları (PWA'lar) için web uygulaması manifestoları oluşturma konusunda güçlendiren Gatsby-plugin-manifest, gelişmiş bir mobil kullanıcı deneyimine katkıda bulunur.
-
Gatsby-plugin-offline: Ağ kesintileri sırasında devreye giren gatsby-plugin-offline, sorunsuz kullanıcı deneyimleri sağlamak için çevrimdışı destek ve hizmet çalışanları eklemeye yönelik bir çözümdür.
-
Gatsby-plugin-react-helmet: Bir belgenin başındaki önemli meta verileri ele alan gatsby-plugin-react-helmet, içeriği arama motorları için optimize etmede başı çeker.
-
Gatsby-plugin-sitemap: Arama motoru görünürlüğü için SEO site haritaları oluşturma sürecini basitleştiren gatsby-plugin-sitemap, değerini kanıtlıyor.
-
Gatsby-plugin-styled-components: CSS-in-JS yaklaşımını destekleyen gatsby-plugin-styled-components, zarif web sitesi düzenleri elde etmek için temel taş haline gelir.
-
Gatsby-source-filesystem: GraphQL verilerini sistem dosyalarından yararlanarak sorunsuz bir şekilde düzenleyen gatsby-source-filesystem, verimli veri yönetimi için başvurulacak bir eklentidir.
-
Gatsby-transformer-remark: Remark'ın gücünden yararlanan gatsby-transformer-remark, Markdown dosyalarını HTML'ye dönüştürerek web sitesi yapımını ve yönetimini kolaylaştırır.
-
Gatsby-plugin-google-analytics: Google Analytics kullanarak web sitesi performansına ilişkin içgörülerin kilidini açan gatsby-plugin-google-analytics vazgeçilmez bir varlık haline geliyor.
-
Gatsby-theme-docz: Gatsby siteleri için kapsamlı belgelerin oluşturulmasını basitleştiren gatsby-theme-docz, kullanıcı katılımını kolaylaştırır.
-
Docsie-gatsby-plugin: Web sitesi dokümantasyonu hazırlama sürecini kolaylaştıran docsie-gatsby-plugin, Docsie çalışma alanlarından verileri zahmetsizce içe aktarır.
Gatsby ile dokümantasyon web siteleri oluşturmak için gatsby-plugin-docsie'yi nasıl kullanabilirim?
Bu eklenti, GatsbyJs web sitenize Docsie içeriği ekler. Sayfaları otomatik olarak oluşturabilir veya sayfa oluşturma üzerinde daha fazla kontrole sahip olmak için graphql'i kendiniz sorgulayabilirsiniz.
gatsby-plugin-docsie Nasıl Kullanılır?
`{
resolve: require.resolve(`gatsby-source-docsie`),
seçenekler: {
deploymentId: "deployment_iigwE2dX4i7JVKmce", [required]
generatePages: true, [isteğe bağlı, varsayılan değer true]
path: "docs", [isteğe bağlı, tüm düğümlerin slug'ları için kök yol, eğik çizgi gerekmez, varsayılan olarak docs]
dil: "English", [isteğe bağlı, belirtilmezse varsayılan olarak birincil dil]
}
}`
Sayfa Oluşturma ile gatsby-plugin-docsie kullanın
Varsayılan olarak eklenti sayfaları otomatik olarak oluşturur.
Aşağıdaki CSS sınıflarını kullanarak varsayılan sayfaları şekillendirebilirsiniz:
-
.docsie-main-container
-
.docsie-nav-container
-
.docsie-page-container
-
.docsie-nav
-
.docsie-nav-items
-
.docise-nav-item
Sayfa Oluşturmadan gatsby-plugin-docsie kullanın
İçeriğin nasıl oluşturulacağı konusunda daha fazla kontrole ihtiyacınız varsa, yukarıdaki generatePages
seçeneğini false
olarak ayarlayabilir ve graphql kullanarak verileri doğrudan GatsbyJs'den alabilirsiniz.
Eklenti GatsbyJs'ye 4 graphql düğümü ekler:
-
DociseDoc
-
DociseBook
-
DocsieArticle
-
DocsieNav
Sayfaların nasıl oluşturulacağına dair bir örneği /plugin/createPages.js adresinde bulabilir ve React bileşenlerinin nasıl oluşturulacağına dair bir örnek için /plugin /DocsieTemplate.js adresine bakabilirsiniz.
Bir web uygulaması manifestosunu yapılandırmak için gatsby-plugin-manifest'i nasıl kullanırım?
gatsby-plugin-manifest eklentisi, Gatsby siteniz için bir web uygulaması bildirimini kolayca yapılandırmanıza ve oluşturmanıza olanak tanır. Web uygulaması bildirimi, web uygulamanız hakkında ad, simgeler, başlangıç URL'si, renkler ve daha fazlası dahil olmak üzere meta veriler sağlayan bir JSON dosyasıdır. Bu, sitenizin bir ana ekran simgesiyle mobil cihazlara aşamalı bir web uygulaması olarak yüklenmesini sağlar.
gatsby-plugin-manifest'i kullanmak için önce eklentiyi yükleyin:
`npm install --save gatsby-plugin-manifest`
Ardından gatsby-config.js dosyanızda eklentiyi yapılandırın. Name, short_name, start_url, background_color, theme_color, display, icons gibi özellikleri belirtebilirsiniz. Örneğin:
`{
çözün: `gatsby-plugin-manifest`,
seçenekler: {
isim: `GatsbyJS`,
short_name: `GatsbyJS`,
start_url: `/`,
background_color: `#f7f0eb`,
theme_color: `#a2466c`,
ekran: `standalone`,
icon: 'src/images/icon.png'
}
}`
Bu, Gatsby sitenizi oluşturduğunuzda bir manifest.webmanifest dosyası oluşturacaktır. Sitenizin HTML şablonuna manifesto ekleyerek referans verdiğinizden emin olun:
`<link rel="manifest" href="/manifest.webmanifest">`
gatsby-plugin-manifest'i yapılandırırken dikkat edilmesi gereken bazı önemli noktalar:
-
short_name, ana ekranda görüntülenen ad için gerekli bir özelliktir.
-
start_url, uygulama bir cihazın ana ekranından başlatılırken başlangıç sayfasını yapılandırır.
-
simgesi en az 512x512px boyutlarında kare bir png dosyasına işaret etmelidir.
-
Farklı boyutlar/yoğunluklar için bir dizi simge nesnesi yapılandırabilirsiniz.
-
ekran, uygulamanın tam ekran (bağımsız) veya tarayıcı sekmesinde (tarayıcı) başlatılıp başlatılmayacağını belirlemenizi sağlar.
-
theme_color ve background_color, uygulamanın renk düzenini tanımlar.
Genel olarak, gatsby-plugin-manifest, Gatsby sitenizi bir PWA olarak yüklenebilir hale getirmek için gereken manifesto dosyasını yapılandırmayı ve oluşturmayı gerçekten kolaylaştırır. Bu, mobil deneyimi geliştirir ve kullanıcıların sitenizi yerel bir uygulama gibi başlatmasına olanak tanır.
gatsby-plugin-offline nedir ve çevrimdışı özellikli bir site oluşturmak için nasıl kullanabilirim?
gatsby-plugin-offline, çevrimdışı özellikli web siteleri oluşturmak için destek ekleyen bir Gatsby eklentisidir. Aşamalı Web Uygulamaları oluşturmayı kolaylaştıran bir dizi kütüphane ve derleme aracı olan Workbox'ı kullanır.
Doğru şekilde kurulup yapılandırıldığında, gatsby-plugin-offline şunları yapacaktır:
-
HTML, JavaScript, CSS, medya ve web yazı tipleri** gibi uygulama kabuğu kaynaklarını önbelleğe alan bir hizmet çalışanı dosyası oluşturun. Bu, sitenizin tekrarlanan ziyaretlerde daha hızlı yüklenmesini sağlar.
-
Sitelerin çevrimdışı erişilebilir olmasını sağlamak için sayfa verilerini önbelleğe alın. Eklenti, kullanıcılar sayfaları ziyaret ettikçe önbelleğe alır.
-
"Ana Ekrana Ekle" kurulumu için bildirim desteği ekleyin.
Kullanmak için önce eklentiyi yükleyin:
`npm install gatsby-plugin-offline`
Ardından gatsby-config.js dosyanıza ekleyin:
`{
çözün: `gatsby-plugin-offline`,
seçenekler: {
precachePages: [`/about/`],
},
}`
Anahtar seçenekler şunlardır:
-
precachePages - Çevrimdışı destek için önbelleğe alınacak sayfaları belirtin. Ana sayfayı buraya dahil etmek önemlidir.
-
workboxConfig - Çalışma zamanı önbelleğe alma ve bildirim ayarları gibi Workbox seçeneklerini özelleştirin.
-
appendScript - Oluşturulan hizmet çalışanı dosyasına özel hizmet çalışanı kodu ekleyin.
gatsby-plugin-offline kullanımı için bazı en iyi uygulamalar:
-
Sorunları erkenden yakalamak için sitenizi Chrome DevTools Denetimleri paneliyle test edin.
-
API verileri ve sık güncellenen varlıklar için kısa bir önbellek sona erme süresi ayarlayın.
-
Kullanıcıların en son dosyaları almasını sağlamak için Workbox'ta "Yeniden yüklemede güncelle" seçeneğini kontrol edin.
-
Hizmet çalışanı yaşam döngüsünü kontrol etmek için gatsby-browser.js'de bir hizmet çalışanı kaydedin.
-
Kullanıcının bağlantısının olmadığı durumlar için bir yedek sayfa veya çevrimdışı kullanıcı arayüzü yapılandırmayı düşünün.
Vurgulu metin PWA puanınızı ölçmek için canlı sitenizi Lighthouse'a gönderin. Hedefiniz >90 olsun.
Genel olarak, gatsby-plugin-offline, Gatsby sitenizin çevrimdışı çalışmasını kolaylaştırır. Bu, internet bağlantılarını geri getiren veya kaybeden kullanıcılar için çok daha iyi, uygulama benzeri bir deneyim sağlar. Tam çevrimdışı desteği sağlamak için tarayıcılar ve cihazlar arasında düzenli olarak test yaptığınızdan emin olun.
gatsby-plugin-google-analytics ile bir Gatsby sitesinde Google Analytics'i nasıl uygularım?
Google Analytics, web sitenizdeki trafiği ve etkileşimi izlemenize ve takip etmenize olanak tanıyan popüler bir analiz aracıdır. gatsby-plugin-google-analytics, Google Analytics'i bir Gatsby sitesine entegre etmenin önerilen yoludur.
Google Analytics desteği eklemek için önce eklentiyi yükleyin:
`npm install --save gatsby-plugin-google-analytics`
Ardından, Google Analytics izleme kimliğinizi belirterek gatsby-config.js dosyasında yapılandırın:
`{
çözün: `gatsby-plugin-google-analytics`,
seçenekler: {
trackingId: 'YOUR_GOOGLE_ANALYTICS_TRACKING_ID',
},
}`
Bu, sitenizdeki tüm sayfalara gerekli Google Analytics izleme kodunu otomatik olarak ekleyecektir.
Bazı ek yapılandırma seçenekleri şunlardır:
-
head -
'e ekstra komut dosyaları eklemenizi sağlar. Ek analiz araçları için kullanışlıdır. -
anonymize - GDPR ile uyumlu olmanız gerekiyorsa IP adreslerini maskeler.
-
respectDNT - Kullanıcılar "Do Not Track" özelliğini etkinleştirmişse GA'yı yüklemez.
-
pageTransitionDelay - Sayfa değişikliği analiz olayları için zaman aşımını ayarlar.
-
optimizeId - A/B testi için Google Optimize'ı etkinleştirir.
-
experimentId - Google Optimize deney kimliğini ekler.
-
variationId - Google Optimize deneme varyasyonunu belirtir.
-
defer - Sayfa hızını artırmak için komut dosyası yüklenmesini geciktirir.
-
sampleRate - Örnekleme oranını ayarlar, yüksek trafikli siteler için kullanışlıdır.
Siteyi test ederek Google Analytics etkinliklerinin sorunsuz bir şekilde alındığından emin olabilirsiniz. Google Analytics'te sayfa görüntülemeleri gibi verileri doğrulayın. GA Debugger eklentilerini kullanarak izleme kodunun sitelere yüklenip yüklenmediğini kontrol edebilirsiniz.
Google Analytics'in gatsby-plugin-google-analytics uygulamasını kullanarak, bir Gatsby sitesine hiçbir çaba harcamadan güçlü analizler eklenebilir. Gatsby'nin kod bölme ve sunucu tarafı oluşturma özelliği, onu Google Analytics'i dahil etmek için ideal hale getirir. Sitenizin desteklediği her sayfada ve cihazda doğru şekilde görüntülendiğinden emin olun.
gatsby-plugin-react-helmet nedir ve belge başı meta verilerini yönetmek için nasıl kullanabilirim?
gatsby-plugin-react-helmet, React Helmet kullanarak Gatsby sitenizdeki belge başı meta verilerini yönetmenizi sağlar. React Helmet, belge başlığındaki başlık, meta etiketler, komut dosyaları vb. öğeleri kontrol etmenizi sağlayan c * vurgulanmış bir metin * bileşenidir.
gatsby-plugin-react-helmet kullanmak için bazı nedenler:
-
SEO için sayfa başlığı, açıklama, kanonik URL, JSON-LD vb. kolayca ayarlayın.
-
Meta etiketleri sahne, sorgu vb. öğelere göre dinamik olarak oluşturun.
-
Sosyal paylaşım için og:image, twitter:card meta etiketlerini ayarlayın.
-
Üçüncü taraf komut dosyalarını diğer sayfaları etkilemeden güvenli bir şekilde başlığa ekleyin.
-
Gatsby'nin sunucu tarafı görüntülemesiyle mükemmel çalışır.
Kullanmak için önce eklentiyi yükleyin:
`npm install --save gatsby-plugin-react-helmet react-helmet`Kodu kopyala
Ardından meta veri eklemek için sayfalarınızı bir
``
import React from "react"
import { Kask } from "react-helmet"
export default () => (
Unutulmaması gereken şeyler:
-
Sayfalarda, şablonlarda, bileşenlerde Helmet kullanın. gatsby-browser.js içinde değil.
-
Kask, üzerine yazmak yerine yinelenen etiketleri birleştirecektir.
-
Sunucu tarafından oluşturulan HTML doğru bir şekilde kafa meta verileri içerecektir.
-
İstemci tarafından oluşturulan HTML meta verileri de içerecektir.
-
Her sayfa için dinamik olarak oluşturulan başlıklar, açıklamalar ve kanonik URL'ler için mükemmeldir.
Genel olarak, gatsby-plugin-react-helmet size SEO, sosyal paylaşım, kullanıcı arayüzü kontrolü için belge başı meta verileri üzerinde muazzam kontrol sağlar. Her Gatsby sitesi için şiddetle tavsiye edilir. Sadece gatsby-browser.js gibi server-rendering'in çalışamayacağı yanlış yerlere eklememeye dikkat edin.
gatsby-plugin-sitemap kullanarak bir Gatsby sitesi için site haritasını nasıl uygulayabilirim?
Site haritası, sitenizdeki sayfaları listeleyen ve Google ve Bing gibi arama motorlarının içeriğinizi daha verimli bir şekilde taramasına ve dizine eklemesine yardımcı olan bir XML dosyasıdır. gatsby-plugin-sitemap, bir Gatsby sitesi için site haritası oluşturmanın en kolay yoludur.
Site haritası eklemek için önce eklentiyi yükleyin:
`npm install --save gatsby-plugin-sitemap`
Ardından gatsby-config.js dosyanıza ekleyin:
`{
çözün: `gatsby-plugin-sitemap`,
seçenekler: {
çıktı: `/sitemap.xml`,
},
}`
Bu, sitenizin kök klasöründe bir sitemap.xml dosyası oluşturacaktır.
Birkaç seçenek belirleyebilirsiniz:
-
çıktı - Site haritası dosyasının kaydedileceği yer.
-
exclude - Site haritasından hariç tutulacak yolların dizisi.
-
sorgu - Hangi düğümlerin dahil edileceğini filtrelemek için bir GraphQL sorgusu.
-
serialize - Site haritasındaki her url'yi biçimlendirmek için özel işlev.
Eklenti, Gatsby düğümlerinden oluşturulan tüm sayfaları otomatik olarak tarayacak ve bunları dahil edecektir.
Optimum kullanım için bazı ipuçları:
-
Site haritasını dizine eklenmesi için Google Search Console'a gönderin.
-
Site haritasını her güncellediğinizde arama motorlarına ping atın.
-
sitemapSize seçeneğini kullanarak makul bir site haritası önbellek süresi ayarlayın.
-
Kullanıcı profili sayfaları gibi dizine eklenmesini istemediğiniz sayfaları hariç tutun.
-
50k URL'yi aşıyorsa büyük site haritalarını sınırlamak için hariç tut veya sorgu kullanın.
-
Robots.txt dosyanıza site haritası url'si ekleyin.
-
Daha hızlı indeksleme için site haritasını gzip kullanarak sıkıştırın.
-
Tazelik için derleme zamanında dinamik olarak site haritası verileri oluşturun.
Genel olarak, gatsby-plugin-sitemap, Gatsby sitenizin arama motoru görünürlüğünü ve tarama verimliliğini artırmak için kapsamlı bir site haritası oluşturmanın kolay bir yolunu sunar. Kullanım durumunuz için seçenekleri özelleştirdiğinizden ve maksimum SEO değeri için arama motorlarına gönderdiğinizden emin olun.
gatsby-plugin-styled-components kullanarak Gatsby'de styled-components için nasıl destek ekleyebilirim?
Styled-components, şablon değişmezleri kullanarak bileşen kapsamındaki CSS yazmanıza olanak tanıyan popüler bir CSS-in-JS kütüphanesidir. gatsby-plugin-styled-components, bir Gatsby sitesine styled-components desteği eklemek için önerilen yoldur.
Gatsby'de styled-components kullanmak için önce bağımlılıkları yükleyin:
`npm install --save gatsby-plugin-styled-components styled-components babel-plugin-styled-components`
Ardından eklentiyi gatsby-config.js dosyanıza ekleyin:
`module.exports = {
eklentiler: [
`gatsby-plugin-styled-components`,
],
}`
Artık stilize bileşenleri içe aktarabilir ve sitenizin herhangi bir yerinde stilize öğeler oluşturabilirsiniz:
``
import styled from 'styled-components';
const Header = styled.headerbackground: kırmızı;
renk: beyaz;
;`
```
Gatsby ile styled-components kullanmanın faydaları:
-
Kapsamlı CSS çakışmaları ve özgüllük sorunlarını önler.
-
Temalandırma, mixinler, yuvalama gibi CSS-in-JS özellikleri ile çalışır.
-
React bileşen mimarisi ile sorunsuz bir şekilde entegre olur.
-
Yeniden kullanılabilir stilli bileşenler oluşturmanızı sağlar.
-
SSR'yi destekler - kritik CSS oluşturulur.
-
Stillerin özelleştirilmesi ve genişletilmesi kolaydır.
-
CSS içe aktarmalarından kaynaklanan istenmeyen kod bölmelerini önler.
Styled-components kullanırken bazı en iyi uygulamalar:*
-
TypeScript hatalarını önlemek için // @ts-ignore yorumlarını kullanın.
-
Adlandırılmış dışa aktarma kuralını etkinleştirin.
-
DOM'a aktarılan propları sınırlamak için shouldForwardProp kullanın.
-
Gerekirse labelFormat'ı özelleştirin.
-
Biraz daha iyi performans için duyguları göz önünde bulundurun.
Genel olarak, gatsby-plugin-styled-components, styled-components CSS-in-JS kütüphanesini kullanmak için Gatsby'nin derleme süreciyle mükemmel entegrasyon sağlar. React ve SSR ile güzel bir şekilde çalışan bileşen odaklı stil için harika bir seçenektir.
gatsby-plugin-sharp nedir ve Gatsby'de görüntülerin işlenmesine nasıl yardımcı olur?
gatsby-plugin-sharp, Sharp görüntü işleme kütüphanesini kullanarak görüntü işleme ve optimizasyonu gerçekleştiren resmi bir Gatsby eklentisidir. Statik sitelerinizdeki ve Gatsby uygulamalarınızdaki görüntü dosyalarını dönüştürmenize olanak tanır.
gatsby-plugin-sharp'ın sağladığı bazı temel özellikler:
-
Duyarlı tasarım için görüntüleri yeniden boyutlandırma. Bir görüntü için bir dizi boyut tanımlayabilirsiniz ve gatsby-plugin-sharp otomatik olarak uygun boyutta sürümler oluşturacaktır.
-
Görüntülerin bölümlerini kırpma ve seçme. Önemli alanlara odaklanmak ve küçük resim oluşturmak için kullanışlıdır.
-
JPEG, PNG, WebP ve GIF** gibi görüntü türleri arasında format dönüştürme. Bu, dosya boyutunu ve kalitesini optimize etmeye yardımcı olur.
-
Filigran ekleme ve görüntülerin üzerine kaplama uygulama.
-
Görüntü dosyası boyutlarını azaltmak için sıkıştırma, kalite ve meta verileri optimize etme.
-
Performans için derleme zamanında gatsby-transformer-sharp eklentisini ve GraphQL sorgularını kullanarak görüntüleri işleme.
-
Gatsby Image ve gatsby-image eklentileri ile entegrasyon yoluyla tembel yükleme desteği.
-
JPEG, PNG, TIFF, GIF, SVG gibi yaygın görüntü formatlarını kabul eder.
-
Yerel ve uzaktan barındırılan görüntüleri işleyebilir.
gatsby-plugin-sharp ve gatsby-transformer-sharp eklentilerini yükleyin ve gatsby-plugin-sharp'ın çalışması için bunları gatsby-config.js dosyanıza ekleyin. Sabit, akışkan veya duyarlı çözünürlüğe ve diğer özelliklere göre filtreleme daha sonra GraphQL sorguları aracılığıyla işlenen fotoğraflara uygulanabilir.
Özetle, gatsby-plugin-sharp, Sharp aracılığıyla sağlam görüntü işleme kaynaklarını serbest bırakır, bu da performansı ve yanıt verebilirliği artırabilir. Gatsby, görüntü işleme hattında büyük ölçüde buna güveniyor. Profesyonel, yüksek performanslı web siteleri geliştirmek için birçok görüntü işleme özelliği ile oynayın.
Gatsby ile dokümantasyon web siteleri oluşturmak için gatsby-theme-docz'u nasıl kullanabilirim?
gatsby-theme-docz, MDX ve React bileşenlerini kullanarak dokümantasyon web siteleri oluşturmanıza yardımcı olan resmi bir Gatsby temasıdır. Teknik yazım için bir araç seti olan Docz ile entegre olur.
Gatsby-theme-docz'un bazı temel özellikleri:
-
MDX ile doküman yazma - Markdown sözdizimini JSX bileşenleri ile birleştirir.
-
Tema UI desteği - Kısıtlama Tabanlı Tasarım Sistemi ile Stil Oluşturma.
-
Prism.js ile kod bloğu oluşturma - Sözdizimi vurgulama.
-
Mobil uyumlu duyarlı düzenler.
-
Sıcak Modül Değiştirme ile canlı yeniden yükleme.
-
react-helmet ile SEO optimizasyonu.
-
İç içe rotalar halinde düzenlenmiş dokümanlar.
-
Kenar çubuğu navigasyon oluşturma.
-
Hızlı arama dokümantasyon içeriği.
-
Karanlık mod desteği.
-
Özelleştirilebilir düzenler ve bileşenler.
Gatsby-theme-docz kullanmak için:
-
Tema ve Docz bağımlılıklarını yükleyin.
-
gatsby-config.js dosyasına gatsby-theme-docz yapılandırmasını ekleyin.
-
src/pages içinde MDX kullanarak dokümanlar oluşturun.
-
Bileşenleri gölgelendirerek temayı özelleştirin.
-
Dokümantasyon sitesini dağıtın.
React ve Markdown gibi tanıdık araçları kullanarak teknik ve bileşen belgeleri yazmak için harika bir geliştirici deneyimi sağlar. Ve bir Gatsby sitesi oluşturmak, dokümanların Gatsby'nin ön oluşturma gibi tüm performans ve yeteneklerine sahip olması anlamına gelir.
Genel olarak, gatsby-theme-docz, Gatsby hızından ve React bileşen mimarisinden yararlanarak dokümantasyon web siteleri oluşturmak için basit bir yol sunar. Teknik bileşen kütüphaneleri ve API'ler yazan geliştiriciler için idealdir.
gatsby-theme-docz'u nasıl özelleştirebilir ve yapılandırabilirim?
gatsby-theme-docz teması, stil, düzen, bileşenler ve davranışı dokümantasyon ihtiyaçlarınıza uyacak şekilde özelleştirmek için bir dizi seçeneğe sahiptir.
gatsby-theme-docz'u yapılandırmanın ve özelleştirmenin bazı temel yolları:
-
gatsby-config.js'de themeConfig'i ayarlayın - Renkleri, yazı tiplerini, stilleri değiştirin.
-
Gölge docz bileşenleri- src/gatsby-theme-docz/ içine değiştirmeler yerleştirerek dahili bileşenleri geçersiz kılın
-
Özel belge düzeni - docz/Wrapper.js düzen bileşenini gölgeleyin.
-
MDX bileşenleri ekleyin - MDX'te kullanılabilecek bileşenleri içe aktarın ve kaydedin.
-
Kenar çubuğu nav'ını değiştirin - Bağlantıları ve yapıyı ayarlayın.
-
Özel tema - themeConfig'e bir Theme UI tema nesnesi aktarın.
-
Global CSS ekleyin - gatsby-browser.js dosyasına bir CSS dosyası aktarın.
-
Eklenti seçenekleri - Eklentiyi yapılandırırken docgenConfig gibi seçenekleri ayarlayın.
-
Özel dizin sayfası - Dizin MDX sayfasını gölgelendirir.
-
Sayfa meta verilerini değiştirin - MDX sayfalarında ön maddeyi ayarlayın.
-
Üstbilgi/altbilgi ekleyin - docz/Layout sarmalayıcı bileşenlerini kullanın.
-
Kimlik doğrulamayı entegre edin - Kimlik doğrulama sağlayıcısı yapılandırmasını geçirin ve rotaları sarın.
-
Algolia entegrasyonu - Docz algolia eklentisi ile aramayı etkinleştirin.
-
Özel 404 sayfası - 404.mdx sayfası oluşturun.
-
GitHub Sayfalarına Dağıtım - gatsby-config.js'de pathPrefix kullanın.
-
Genişletilmiş Markdown özellikleri - Markdown-it eklentileri ekleyin.
-
Prism temasını değiştirin - themeConfig'e prismTheme'yi geçirin.
Genel olarak, gatsby-theme-docz, doküman sitenizin ihtiyaçlarına göre özelleştirilebilecek şekilde tasarlanmıştır. Gatsby ve MDX kullanarak gösterişli bir doküman deneyimi oluşturmak için bileşen gölgeleme ve düzen sarma gibi uzantı noktalarından yararlanın.
Gatsby.Js'yi Docsie.io ile Birleştirme
Docsie.io, tüm kurumsal dokümantasyon ihtiyaçlarınıza yardımcı olan bir platformdur. Farklı araçlara ihtiyaç duymadan tüm çalışmalarınızı tek bir yerde merkezileştirerek zamandan ve basitçe dokümantasyondan tasarruf edin. Markdown dosyalarından yararlanmak yerine, Gatsby ve Docsie, web sitelerinin yanı sıra dokümantasyonun verimli bir şekilde geliştirilmesini sağlamak için bir araya geliyor.
Verimli ve kullanışlı gatsby eklentileri, bu blogda belirtildiği gibi bir ton faydaya sahiptir. Bu eklentiler Docsie'de de kullanılabilir. Dolayısıyla, [docsie aracılığıyla bir gatsby belgesi oluşturmak] için bu bağlantıya tıklayın (https://github.com/LikaloLLC/gatsby-source-docsie).
Sonuç
Özetle, Gatsby eklentileri, React ekosisteminin ve JavaScript dilinin gücünden yararlanarak Gatsby sitelerini özelleştirmek ve genişletmek için muazzam bir işlevsellik yelpazesi sunar. Duyarlı görüntüler için gatsby-plugin-image, web uygulaması manifestoları için gatsby-plugin-manifest ve CSS-in-JS stil için gatsby-plugin-styled-components gibi popüler eklentiler, eklentilerin geliştiricilerin modern web yeteneklerini kolayca entegre etmelerini nasıl sağladığını göstermektedir. Canlı Gatsby eklenti topluluğu, birçok yaygın web geliştirme görevi için muhtemelen bir eklentinin zaten mevcut olduğu anlamına gelir. Gatsby eklentilerinden yararlanmayı öğrenmek, Gatsby ile oluşturmanın gerçek potansiyelini ve üretkenliğini ortaya çıkarır. Kullanım durumunuz için seçilen doğru eklenti setiyle, tam olarak ihtiyaçlarınıza göre uyarlanmış, son derece hızlı ve modern bir web sitesi oluşturabilirsiniz.
Temel Çıkarımlar
-
Gatsby için eklenti ekosistemi, geliştiricilerin yeni özellikler eklemesini ve mevcut özellikleri değiştirmesini kolaylaştırarak hızını ve çok yönlülüğünü artırır.
-
Web sitesi hızı, duyarlı tasarım için resimleri geliştiren gatsby-plugin-image ve gatsby-plugin-sharp gibi eklentilerle artırılır.
-
Ağ bağlantısı olmadığında bile kullanıcı deneyimini iyileştirmek için gatsby-plugin-offline, hizmet çalışanlarını kullanarak çevrimdışı özellikli web sayfaları oluşturmak için kullanılabilir.
-
gatsby-plugin-react-helmet, belgenin başındaki meta verilerle ilgilenerek arama motoru optimizasyonu ve sosyal medya paylaşımı için uygun hale getirir.
-
gatsby-plugin-sitemap, arama motorları tarafından daha iyi tarama ve indeksleme için XML site haritaları üretir.
-
Bileşen kapsamındaki CSS'yi birinci sınıf performansla kolaylaştırmak için gatsby-plugin-styled-components, styled-components'ı içerir.
-
Teknik Dokümantasyon için web sayfaları: gatsby-theme-docz, programcıların MDX ve React bileşenlerini kullanarak teknik dokümantasyon için web sayfaları oluşturmalarını mümkün kılar.
-
Gatsby eklentileri, temalandırmadan bileşen gölgelemeye kadar çok sayıda yapılandırma seçeneği sunarak çerçevenin çok çeşitli gereksinimlere uyum sağlamasına olanak tanır.
-
Aktif Gatsby eklenti topluluğu tarafından oluşturulan çok çeşitli eklentiler, web sitesi oluşturma sürecini kolaylaştırır ve basitleştirir.
-
Gatsby eklentileri, programcıların en son web özelliklerini kolayca dahil etmelerine olanak tanıyarak yıldırım hızında, hız için optimize edilmiş, kişiselleştirilmiş web siteleri sağlar.
Sıkça Sorulan Sorular
**S.1 Gatsby'de gatsby-plugin-sharp görüntü iyileştiricisini nasıl kullanabilirim?
Sharp kütüphanesi gatsby-plugin-sharp tarafından kullanılır. Yeniden boyutlandırabilir, kırpabilir, formatı değiştirebilir ve hatta bir filigran ekleyebilirsiniz. Gatsby-config.js'de yapılandırarak ve ardından GraphQL sorgularını kullanarak derleme süreci boyunca resimleri işleyebilirsiniz.
**Q2. Gatsby kullanırken Google Analytics izleme kodunu nasıl ekleyebilirim?
Google Analytics izlemeyi Gatsby sitenize entegre etmek istiyorsanız, gatsby-plugin-google-analytics'i kullanabilirsiniz. Kullanıcı etkinliğini izlemeye ve takip etmeye başlamak için gatsby-config.js dosyasını düzenleyin ve izleme kimliğinizi ekleyin.
**Q3. Gatsby-theme-docz dokümantasyon web sitesi şablonunu nasıl kullanabilirim?
MDX ve React bileşenlerini kullanan gatsby-theme-docz, dokümantasyon web sayfaları oluşturmak için onaylanmış bir Gatsby temasıdır. Esnek ve kapsamlı dokümantasyon sağlamak için temayı yüklemek, src/pages dizininde MDX sayfaları oluşturmak ve temayı değiştirmek gerekir.
**Q4. XML site haritası oluşturmak için gatsby-plugin-sitemap'i nasıl kullanabilirim?
SEO amaçları için XML site haritaları gatsby-plugin-sitemap yardımıyla oluşturulabilir. Eklenti kurulduktan ve ayarları gatsby-config.js'de yapıldıktan sonra, Gatsby düğümleri tarafından oluşturulan sayfalardan otomatik olarak kapsamlı bir site haritası oluşturulacaktır.
**Q5. Hangi Gatsby eklentileri var ve sitemi daha iyi ve daha büyük hale getirmek için bunları nasıl kullanabilirim?
Gatsby eklentileri ile resim optimizasyonu, bilgi yönetimi, çevrimdışı destek ve daha fazlası gibi birçok farklı özellik elde edebilirsiniz. Doğru araçlar ve ayarlarında yapacağınız dikkatli değişikliklerle hızlı, güvenilir bir web sitesi yapabilirsiniz.
**Q6. Gatsby'nin eklenti topluluğu, web sitesi tasarlama ve oluşturmanın geleceği için ne anlama geliyor?
Gatsby'nin geniş eklenti topluluğu, geliştiricilerin sitelerine fazla uğraşmadan son teknoloji web özellikleri eklemesini kolaylaştırır.