공개 페이지

이 페이지는 영어에서 번역되었습니다. 영어 페이지 읽기

public으로 표시된 Screen은 로그인한 적 없는 방문자를 포함해 누구나 열 수 있습니다. 랜딩 페이지, 가격표, 도움말 센터가 그 예입니다. Zeyn은 이런 페이지를 전달 비용이 낮고 캐시와 검색 엔진이 처리하기 쉽게 제공합니다.

방문자에게는 쿠키 없음

세션이 없는 요청이 연 공개 Screen은 쿠키를 설정하지 않습니다. 페이지에는 빈 CSRF 토큰이 들어 있으므로 같은 언어와 테마의 모든 방문자가 같은 바이트를 받습니다.

브라우저 런타임은 토큰이 필요한 첫 호출(폼, action, 언어 선택기) 직전에 GET /_zeyn/csrf로 토큰을 요청합니다. 이 호출은 zeyn_csrf 쿠키를 설정하며 캐시되지 않습니다. 모든 POST는 다른 페이지와 똑같이 검사됩니다. 일치하는 토큰이 없으면 403으로 거부되며, 조용히 재시도하는 일은 없습니다.

로그인한 사용자는 이전과 같이 항상 쿠키와 페이지 안의 토큰을 받습니다.

HTTP 캐싱

#[screen(route = "/pricing", public, cache = 300)]
pub fn pricing() -> Screen {
    Screen::new("Pricing")
}

cache = N은 브라우저와 공유 캐시가 페이지를 N초(1에서 86400) 동안 보관하도록 허용합니다. 세션이 없는 요청에는 페이지가 다음을 받습니다.

일치하는 If-None-Match가 있는 요청은 본문 없이 304 Not Modified를 받습니다. 앱 내 탐색으로 불러오는 Screen도 자체 태그와 함께 같은 방식으로 캐시됩니다.

세션이 있는 요청은 공개 캐시 헤더를 받지 않습니다. 페이지는 Cache-Control: private, no-store와 함께 전송됩니다. public이 아닌 Screen에 cache를 쓰면 컴파일되지 않습니다.

서버에 도달하는 모든 요청에 대해 Screen은 여전히 만들어지고 렌더링됩니다. 태그는 전송을 줄이고, 앱 앞단의 캐시는 요청을 줄입니다. 캐시되는 Screen에는 방문자에 따라 달라지는 것을 넣지 마십시오. 하루 중의 시각, 카운터, 무작위 선택이 그 예입니다.

검색 엔진과 링크 미리 보기

#[screen(route = "/pricing", public, cache = 300)]
pub fn pricing() -> Screen {
    Screen::new(t!("pricing.title"))
        .description(t!("pricing.description"))
        .canonical("/pricing")
        .og_image("https://cdn.example.com/pricing.png")
        .robots(Robots::Index)
        .json_ld(serde_json::json!({
            "@context": "https://schema.org",
            "@type": "Product",
            "name": "Team plan",
        }))
}

모든 값은 이스케이프됩니다. JSON-LD는 <, >, &를 <, >, &으로 써서 기록하므로, </script>를 담은 값이 요소를 끝낼 수 없습니다. 브라우저는 이를 실행하지 않으며 콘텐츠 보안 정책은 다른 모든 페이지만큼 엄격하게 유지됩니다. JSON-LD의 주소 속성(url, @id, image, logo, item 등)에 있는 앱 경로는 깊이와 관계없이 검색 엔진이 기대하는 대로 App::site_url을 붙인 절대 주소로 기록됩니다.

URL은 https URL이거나 /로 시작하는 앱 경로여야 합니다. 그 밖의 것(http:, //host, javascript:, 공백, 따옴표)은 로그에 경고를 남기고 제외됩니다. 앱 경로는 사이트 URL과 기본 경로 뒤에 기록됩니다.

App::new(t!("app.name")).site_url("https://shop.example.com")

site_url이 없으면 head 태그에는 앱 경로가 그대로 남으며, 브라우저는 이를 해석하지만 일부 크롤러는 해석하지 못합니다.

앱 내 탐색은 페이지 로드 없이 제목과 이 모든 태그를 갱신합니다.

사이트맵

#[action(public)]
pub async fn site_pages(part: SitemapPart, db: Db) -> Result<Vec<SitemapUrl>> {
    let rows = db.products_after(part.offset, part.limit).await?;
    Ok(rows.into_iter().map(|p| SitemapUrl::new(format!("/products/{}", p.slug)).lastmod(p.changed)).collect())
}

Feature::new("site").sitemap(site_pages)

/sitemap.xml은 action에 한 번에 1,000개의 URL(part.offset, part.limit)을 요청하고 XML을 스트리밍하므로 큰 사이트도 메모리에 올라오지 않습니다. URL이 50,000개까지는 하나의 urlset입니다. 그보다 많으면 /sitemaps/1.xml, /sitemaps/2.xml 등의 사이트맵 인덱스가 되며 각각 URL을 50,000개씩 담습니다. action은 public이어야 하고 URL을 안정적인 순서로 반환해야 합니다. 사이트맵은 절대 URL을 담으므로 앱 경로에는 App::site_url이 필요하며, https URL이나 앱 경로가 아닌 항목은 제외됩니다. 공개 페이지만 나열하십시오. 검색 엔진은 나머지를 열 수 없습니다. 앱당 하나의 Feature만 사이트맵을 가집니다.

robots.txt와 llms.txt

App::new(t!("app.name"))
    .robots_txt("User-agent: *\nAllow: /\nSitemap: https://shop.example.com/sitemap.xml\n")
    .llms_txt(include_str!("../llms.txt"))

둘 다 모든 사람에게 일반 텍스트로 제공됩니다.