Метаподаци странице
ДевСите страница је једна јединица садржаја на сајту. Страница може имати наслов, тело, елементе заглавља и атрибуте метаподатака који контролишу функције сајта. Када корисник посети УРЛ за страницу, сајт приказује комплетну веб страницу на основу својстава странице са садржајем, додајући динамичке елементе као што су заглавље, подножје и бочна трака. Подразумевана понашања су оптимизована за странице техничке документације, али страница може да се конфигурише и за друге намене, као што су маркетинг и одредишне странице.
Структура странице
ДевСите страница је веб страница чијим општим изгледом и функцијама управља сајт. Приказује се страница на Гоогле Девелоперс са неколико заједничких области. (Не подржавају све локације све функције.) Задржите показивач миша преко дијаграма за ознаке.
site header
Лого сајта, виџет за пријављивање, оквир за претрагу и горња навигација. Уобичајено на целом сајту.
project bar
Назив пројекта или производа и виџети специфични за пројекат (као што је веза „Повратне информације“). Ова област је дефинисана метаподацима пројекта .
sidebar
Хијерархијска навигација у читавој књизи. Ова област је дефинисана метаподацима књиге .
body
Наслов странице и садржај странице.
page footer ("last updated")
Виџети специфични за страницу (као што је обавештење „Последње ажурирано“). Такође може да садржи обавештење о ЦЦ лиценци, што је атрибут метаподатака пројекта.
site footer
Везе у подножју сајта, виџет за избор језика. Уобичајено на целом сајту.
ХТМЛ изворне датотеке
<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>
Атрибут devsite елемента <html> говори ДевСите-у да ово треба да буде приказано као ДевСите страница, а не дословно као ХТМЛ средство. Ако се ваша страница појављује без форматирања или заглавља или подножја, проверите да ли се <html devsite> појављује при врху датотеке.
Елементи <html> , <head> и <body> су обавезни и морају имати ознаке за отварање и затварање.
Типична страница такође мора имати елемент <title> унутар <head> . Погледајте наслов странице .
Специфичне <meta> ознаке контролишу функције странице. Они су описани у овој референци. Типична страница има мета ознаку "project_path" , која се односи на датотеку метаподатака _project.yaml , и мета ознаку "book_path" , која се односи на датотеку метаподатака _book.yaml . Погледајте Пројекти и књиге . <meta> ознаке које препознаје ДевСите обично се не појављују на последњој страници.
Остали елементи у <head> и сви елементи у <body> боди> се приказују на последњој страници.
Маркдовн изворне датотеке
Project: /path/to/_project.yaml
Book: /path/to/_book.yaml
# Page title
Body content, specified in Markdown, goes here.
Типична страница мора имати наслов (нпр. # Page title ). Погледајте наслов странице .
Специфичне мета ознаке контролне функције странице. Они су описани у овој референци. Типична страница има Project: мета ознаку, која се односи на _project.yaml датотеку метаподатака, и Book: мета ознаку, која се односи на датотеку метаподатака _book.yaml . Погледајте Пројекти и књиге. Мета ознаке које препознаје ДевСите обично се не појављују на последњој страници.
Пројекти и књиге
Пројекат је описан датотеком метаподатака пројекта под називом _project.yaml . Књига је описана датотеком метаподатака књиге под називом _book.yaml . Ове датотеке се објављују на сајту заједно са датотекама страница и средстава и могу се превести на више језика. Погледајте метаподатке пројекта и метаподатке књиге за информације о структури и атрибутима ових датотека.
Да бисте повезали страницу са пројектом, наведите атрибут project_path . Његова вредност је путања садржаја до датотеке _project.yaml .
ХТМЛ
<meta name="project_path" value="/path/to/_project.yaml" />
Маркдовн
Project: /path/to/_project.yaml
Ако страница нема атрибут project_path , биће приказана без региона траке пројекта и његових карактеристика. Страница се неће сматрати делом пројекта.
Да бисте повезали страницу са књигом, наведите атрибут book_path . Његова вредност је путања садржаја до датотеке _book.yaml .
ХТМЛ
<meta name="book_path" value="/path/to/_book.yaml" />
Маркдовн
Book: /path/to/_book.yaml
Наслов странице
<head>
<title>Page title</title>
...
</head>
Или користите елемент <h1> са класом page-title у <body> боди> странице.
ХТМЛ
<h1 class="page-title">Page title</h1>
Маркдовн
# Page title
Почетна страницама пројекта нису потребни наслови,
ХТМЛ
<meta name="no_page_title" value="true" />
Маркдовн
no_page_title: true
У посебним случајевима када аутоматски <h1> није пожељан за посебан изглед, али страници и даље треба наслов прозора, можете задржати наслов, али сакрити наслов помоћу атрибута "hide_page_heading" :
ХТМЛ
<title>Page title</title>
<meta name="hide_page_heading" value="true" />
Маркдовн
hide_page_heading: true
# Page title
Опис заглавља
Многе ДевСите локације имају опис у заглављу. Ово се поставља у датотеци метаподатака _project.yaml и аутоматски се приказује на одредишним страницама ДевСите-а. Другим речима, странице које су креиране коришћењем шаблона _index.yaml аутоматски ће приказати опис у заглављу, који је постављен у датотеци _project.yaml .
Овај опис се може заменити за страницу постављањем description у корен датотеке _index.yaml или потиснути подешавањем hide_description: true унутар објекта header landing_page објекта.
Распоред пуне ширине
Ако је потребна већа контрола над изгледом, можете рећи ДевСите-у да се одрекне контроле над изгледом за област испод заглавља сајта и траке пројекта и изнад подножја сајта. Да бисте то урадили, поставите атрибут метаподатака "full_width" на "true" .
ХТМЛ
<meta name="full_width" value="true" />
Маркдовн
full_width: true
Датум последњег ажурирања
Подразумевано, осим на страницама full-width , регион подножја странице укључује аутоматско обавештење „последње ажурирано“. У већини случајева, ово корисницима даје директан сигнал о свежини садржаја на страници.
У неколико случајева, ове информације могу бити збуњујуће или их тим производа може сматрати поверљивим. Да бисте онемогућили последње ажурирано обавештење на страници, поставите атрибут hide_last_updated на true :
ХТМЛ
<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" />
Маркдовн
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
hide_last_updated: true
Можете заменити аутоматски израчунати датум „последњег ажурирања“ тако што ћете поставити метаознаку рефресх_дате на датум у ISO 8601 формату:
ХТМЛ
<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" />
Маркдовн
Project: /time-travel/_project.yaml
Book: /time-travel/_book.yaml
refresh_date: 2017-03-27
Опис странице
Опис странице је текстуални сажетак садржаја странице. Да бисте поставили опис за страницу, наведите елемент <meta name="description" content="DESCRIPTION" /> . Приметите да текст описа иде у атрибут под називом content , а не value ; ово одговара атрибуту веб стандарда.
ХТМЛ
<meta name="description" content="It was the best of times, it was the blurst of times..." />
Маркдовн
description: It was the best of times, it was the blurst of times...
Подешавање описа странице доводи до тога да ознака <meta> буде укључена на последњу страницу
Путања слике
image_path је путања до слике која представља ову страницу у друштвеним медијима и ДевСите функцијама као што су recommendations и dynamic content . Када је постављена, ова слика ће се користити као ОпенГрапх слика странице, надјачавајући подешавања social media пројекта и подешавања бренда tenant site's .
ХТМЛ
<meta name="image_path" value="/site-assets/developers_64dp.png" />
Маркдовн
image_path: /site-assets/developers_64dp.png
Кључне речи
Поље keywords је листа стрингова раздвојених зарезима који описују страницу и користе се у функцијама претраге и откривања као што су претрага сајта и Dynamic Content .
Поље keywords подржава равне кључне речи без асоцијације на димензије (на пример, gettingstarted ) и структуриране кључне речи које користе димензионалне просторе имена да представљају однос између докумената и ентитета из стварног света као што су програмски језици, производи и догађаји (на пример, product:ComputeEngine или language:Python3 ). Можете додати обе врсте keywords у било које поље за кључне речи.
Ако поставите кључну реч која није у складу са захтевима за форматирање, видећете упозорење са исправно форматираном верзијом ваше кључне речи у излазу алата који сте користили (обично ДевСите алатка командне линије или ДевСите Цонтент Публисхер).
ХТМЛ
<meta name="keywords" value="spacetime,timetravel,product:Delorean" />
Маркдовн
keywords: spacetime, timetravel, product:Delorean