Sayfa meta verisi
DevSite sayfası, sitedeki tek bir içerik birimidir. Bir sayfada, sitenin özelliklerini kontrol eden başlık, gövde, üstbilgi öğeleri ve meta veri özellikleri bulunabilir. Kullanıcı bir sayfanın URL'sini ziyaret ettiğinde site, üstbilgi, altbilgi ve kenar çubuğu gibi dinamik öğeler ekleyerek, içerik sayfasının özelliklerine dayanarak web sayfasının tamamını oluşturur. Varsayılan davranışlar, teknik doküman sayfaları için optimize edilmiştir ancak bir sayfa, pazarlama ve açılış sayfaları gibi başka kullanımlar için de yapılandırılabilir.
Bir sayfanın yapısı
DevSite sayfası, genel görünümü ve özellikleri site tarafından yönetilen bir web sayfasıdır. Google Developers'da, birkaç ortak alanı içeren bir sayfa görüntülenir. (Tüm siteler tüm özellikleri desteklemez.) Farenizi etiket şemasının üzerine getirin.
site header
Site logosu, oturum açma widget'ı, arama kutusu ve üst gezinme. Tüm sitede ortak.
project bar
Proje veya ürün başlığı ve projeye özel widget'lar ("Geri Bildirim" bağlantısı gibi). Bu alan, proje meta verileri tarafından tanımlanır.
sidebar
Kitap genelinde hiyerarşik gezinme. Bu alan, kitap meta verileri tarafından tanımlanır.
body
Sayfa başlığı ve sayfanın içeriği.
page footer ("last updated")
Sayfaya özel widget'lar ("Son güncelleme" bildirimi gibi). Bir proje meta veri özelliği olan CC lisans bildirimi de içerebilir.
site footer
Site altbilgisi bağlantıları, dil seçme widget'ı. Tüm sitede ortak.
HTML kaynak dosyaları
<html devsite>
<head>
<title>Page title</title>
<meta name="project_path" value="/path/to/_project.yaml" />
<meta name="book_path" value="/path/to/_book.yaml" />
</head>
<body>
<p>Body content goes here, implemented as HTML.</p>
</body>
</html>
<html> öğesinin devsite özelliği, DevSite'ye bunun bir DevSite sayfası olarak oluşturulması gerektiğini, HTML öğesi olarak tam olarak gerçekleşmeyeceğini bildirir. Sayfanız biçimlendirme veya üstbilgi ya da altbilgi olmadan görünüyorsa dosyanızın üst kısmına yakın bir yerde <html devsite> göründüğünden emin olun.
<html>, <head> ve <body> öğeleri zorunludur ve açılış ve kapanış etiketlerine sahip olmalıdır.
Tipik bir sayfada, <head> içinde bir <title> öğesi de olmalıdır. Sayfa başlığı bölümüne bakın.
Belirli <meta> etiketleri, sayfa özelliklerini kontrol eder. Bunlar, bu referansta açıklanmaktadır. Tipik bir sayfada, _project.yaml meta veri dosyasını ifade eden "project_path" meta etiketi ve _book.yaml meta veri dosyasını ifade eden "book_path" meta etiketi bulunur. Projeler ve kitaplar başlıklı makaleye göz atın. DevSite tarafından tanınan <meta> etiketleri genellikle son sayfada görünmüyor.
<head> içindeki diğer öğeler ve <body> içindeki tüm öğeler son sayfada oluşturulur.
Markdown kaynak dosyaları
Project: /path/to/_project.yaml
Book: /path/to/_book.yaml
# Page title
Body content, specified in Markdown, goes here.
Tipik bir sayfanın bir başlığı olmalıdır (ör. # Page title) bilgileri gösterilir. Bkz. Sayfa başlığı.
Belirli meta etiketler, sayfa özelliklerini kontrol eder. Bunlar, bu referansta açıklanmaktadır. Tipik bir sayfada, _project.yaml meta veri dosyasını ifade eden Project: meta etiketi ve _book.yaml meta veri dosyasını ifade eden Book: meta etiketi bulunur. Projeleri ve kitapları inceleyin. DevSite tarafından tanınan meta etiketler genellikle son sayfada görünmez.
Projeler ve kitaplar
Projeler, _project.yaml adlı proje meta veri dosyasıyla tanımlanır. Bir kitap, _book.yaml adlı bir kitap meta veri dosyasıyla tanımlanır. Bu dosyalar, sayfa ve öğe dosyalarıyla birlikte sitede yayınlanır ve birden fazla dile çevrilebilir. Bu dosyaların yapısı ve özellikleri hakkında bilgi edinmek için Proje meta verileri ve Kitap meta verileri bölümlerine bakın.
Bir sayfayı projeyle ilişkilendirmek için project_path özelliğini sağlayın. Bu alanın değeri, _project.yaml dosyasının içerik yoludur.
HTML
<meta name="project_path" value="/path/to/_project.yaml" />
Markdown
Project: /path/to/_project.yaml
Bir sayfada project_path özelliği yoksa proje çubuğu bölgesi ve özellikleri olmadan oluşturulur. Sayfa, projenin bir parçası olarak kabul edilmez.
Bir sayfayı kitapla ilişkilendirmek için book_path özelliğini sağlayın. Bu alanın değeri, _book.yaml dosyasının içerik yoludur.
HTML
<meta name="book_path" value="/path/to/_book.yaml" />
Markdown
Book: /path/to/_book.yaml
Sayfa başlığı
<head>
<title>Page title</title>
...
</head>
Alternatif olarak, sayfanın <body> içinde page-title sınıfıyla bir <h1> öğesi kullanabilirsiniz.
HTML
<h1 class="page-title">Page title</h1>
Markdown
# Page title
Proje ana sayfalarında başlıklar gerekmez,
HTML
<meta name="no_page_title" value="true" />
Markdown
no_page_title: true
Özel bir düzen için otomatik <h1> işlevinin istenmediği ancak yine de bir sayfada pencere başlığının gerekli olduğu özel durumlarda, başlığı koruyup "hide_page_heading" özelliğiyle gizleyebilirsiniz:
HTML
<title>Page title</title>
<meta name="hide_page_heading" value="true" />
Markdown
hide_page_heading: true
# Page title
Başlık açıklaması
Birçok DevSite sitesinin başlığında açıklama bulunur. Bu değer, _project.yaml meta veri dosyasında ayarlanır ve DevSite açılış sayfalarında otomatik olarak gösterilir. Diğer bir deyişle, _index.yaml şablonu kullanılarak oluşturulan sayfaların başlıkta, _project.yaml dosyasında ayarlanan bir açıklama otomatik olarak oluşturulur.
Bu açıklama, _index.yaml dosyasının kök konumuna bir description ayarlanarak sayfa için geçersiz kılınabilir veya landing_page nesnesinin header nesnesinde hide_description: true ayarlanarak gizlenebilir.
Tam genişlikte düzen
Düzen üzerinde daha fazla kontrol sahibi olmanız gerekiyorsa DevSite'a site başlığı ve proje çubuğu ile site alt bilgisinin üst kısmındaki düzen üzerinde kontrolü bırakmasını söyleyebilirsiniz. Bunun için "full_width" meta veri özelliğini "true" olarak ayarlayın.
HTML
<meta name="full_width" value="true" />
Markdown
full_width: true
Son güncellenme tarihi
Varsayılan olarak, full-width sayfaları dışında sayfa altbilgisi bölgesi otomatik bir "son güncelleme" öğesi içerir dikkat edin. Çoğu durumda bu, kullanıcılara sayfadaki içeriğin güncelliği hakkında net bir sinyal verir.
Bazı durumlarda bu bilgiler kafa karıştırıcı olabilir veya ürün ekibi tarafından gizli olarak değerlendirilebilir. Bir sayfada son güncelleme bildirimini devre dışı bırakmak için hide_last_updated özelliğini true olarak ayarlayın:
HTML
<meta name="project_path" value="/time-travel/_project.yaml" />
<meta name="book_path" value="/time-travel/_book.yaml" />
<meta name="hide_last_updated" value="true" />
Markdown
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
hide_last_updated: true
Otomatik olarak hesaplanan "son güncelleme"yi geçersiz kılabilirsiniz. yenileme_tarihi meta etiketini ISO 8601 biçimindeki bir tarihe ayarlayarak istediğiniz tarihi girin:
HTML
<meta name="project_path" value="/time-travel/_project.yaml" />
<meta name="book_path" value="/time-travel/_book.yaml" />
<meta name="refresh_date" value="2017-03-27" />
Markdown
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
refresh_date: 2017-03-27
Sayfa açıklaması
Bir sayfanın açıklaması, sayfa içeriğinin metin biçimindeki özetidir. Bir sayfanın açıklamasını ayarlamak için <meta name="description" content="DESCRIPTION" /> öğesi sağlayın. Açıklama metninin value değil, content adlı bir özelliğe gittiğine dikkat edin. bu, web standardı özelliğiyle eşleşir.
HTML
<meta name="description" content="It was the best of times, it was the blurst of times..." />
Markdown
description: It was the best of times, it was the blurst of times...
Sayfa açıklamasının ayarlanması, <meta> etiketinin son sayfaya dahil edilmesine neden olur
Görüntü yolu
image_path, bu sayfayı sosyal medyada ve recommendations ile dynamic content gibi DevSite özelliklerinde temsil eden resmin yoludur. Ayarlandığında bu resim, sayfanın OpenGraph resmi olarak kullanılır ve projenin social media ayarlarını ve tenant site's marka ayarlarını geçersiz kılar.
HTML
<meta name="image_path" value="/site-assets/developers_64dp.png" />
Markdown
image_path: /site-assets/developers_64dp.png
Anahtar kelimeler
keywords alanı, sayfayı tanımlayan ve site arama ile Dynamic Content gibi arama ve keşif özelliklerinde kullanılan dizelerin virgülle ayrılmış bir listesidir.
keywords alanı, boyutsal ilişkilendirme olmayan düz anahtar kelimeleri (ör. gettingstarted) ve dokümanlar ile programlama dilleri, ürünler ve etkinlikler (ör. product:ComputeEngine veya language:Python3) arasındaki ilişkiyi temsil etmek için boyutsal ad alanları kullanan yapılandırılmış anahtar kelimeleri destekler. Herhangi bir anahtar kelime alanına her iki keywords türünü de ekleyebilirsiniz.
Biçimlendirme gereksinimlerine uymayan bir anahtar kelime hazırlarsanız kullandığınız aracın çıktısında (genellikle DevSite komut satırı aracı veya DevSite Content Publisher) anahtar kelimenizin doğru biçimlendirilmiş sürümünü içeren bir uyarı görürsünüz.
HTML
<meta name="keywords" value="spacetime,timetravel,product:Delorean" />
Markdown
keywords: spacetime, timetravel, product:Delorean