feat: first take at M4
This commit is contained in:
474
crates/bds-core/src/render/routes.rs
Normal file
474
crates/bds-core/src/render/routes.rs
Normal file
@@ -0,0 +1,474 @@
|
||||
use std::collections::HashMap;
|
||||
|
||||
use chrono::{Datelike, TimeZone, Utc};
|
||||
use serde::Serialize;
|
||||
|
||||
use crate::i18n::normalize_language;
|
||||
use crate::model::{Post, ProjectMetadata};
|
||||
use crate::render::{RenderError, render_liquid_template};
|
||||
|
||||
const STARTER_SINGLE_POST_TEMPLATE: &str = include_str!("../../../../assets/starter-templates/single-post.liquid");
|
||||
const STARTER_POST_LIST_TEMPLATE: &str = include_str!("../../../../assets/starter-templates/post-list.liquid");
|
||||
const STARTER_HEAD_PARTIAL: &str = include_str!("../../../../assets/starter-templates/partials/head.liquid");
|
||||
const STARTER_MENU_PARTIAL: &str = include_str!("../../../../assets/starter-templates/partials/menu.liquid");
|
||||
const STARTER_LANGUAGE_SWITCHER_PARTIAL: &str = include_str!("../../../../assets/starter-templates/partials/language-switcher.liquid");
|
||||
|
||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||
pub struct RenderedPage {
|
||||
pub relative_path: String,
|
||||
pub html: String,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize)]
|
||||
struct AlternateLinkContext {
|
||||
href: String,
|
||||
hreflang: String,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize)]
|
||||
struct BlogLanguageContext {
|
||||
is_current: bool,
|
||||
code: String,
|
||||
flag: String,
|
||||
href: String,
|
||||
href_prefix: String,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize)]
|
||||
struct DayBlockContext {
|
||||
show_date_marker: bool,
|
||||
date_label: String,
|
||||
posts: Vec<serde_json::Value>,
|
||||
show_separator: bool,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize)]
|
||||
struct ListTemplateContext {
|
||||
language: String,
|
||||
language_prefix: String,
|
||||
page_title: String,
|
||||
pico_stylesheet_href: Option<String>,
|
||||
html_theme_attribute: Option<String>,
|
||||
alternate_links: Vec<AlternateLinkContext>,
|
||||
blog_languages: Vec<BlogLanguageContext>,
|
||||
menu_items: Vec<serde_json::Value>,
|
||||
calendar_initial_year: i32,
|
||||
calendar_initial_month: u32,
|
||||
archive_context: Option<serde_json::Value>,
|
||||
show_archive_range_heading: bool,
|
||||
min_date: Option<serde_json::Value>,
|
||||
max_date: Option<serde_json::Value>,
|
||||
day_blocks: Vec<DayBlockContext>,
|
||||
is_list_page: bool,
|
||||
is_first_page: bool,
|
||||
is_last_page: bool,
|
||||
has_prev_page: bool,
|
||||
has_next_page: bool,
|
||||
prev_page_href: Option<String>,
|
||||
next_page_href: Option<String>,
|
||||
canonical_post_path_by_slug: HashMap<String, String>,
|
||||
canonical_media_path_by_source_path: HashMap<String, String>,
|
||||
post_data_json_by_id: HashMap<String, String>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, Serialize)]
|
||||
struct PostTemplateContext<'a> {
|
||||
language: &'a str,
|
||||
language_prefix: String,
|
||||
page_title: &'a str,
|
||||
pico_stylesheet_href: Option<String>,
|
||||
html_theme_attribute: Option<String>,
|
||||
alternate_links: Vec<AlternateLinkContext>,
|
||||
blog_languages: Vec<BlogLanguageContext>,
|
||||
menu_items: Vec<serde_json::Value>,
|
||||
calendar_initial_year: i32,
|
||||
calendar_initial_month: u32,
|
||||
post: serde_json::Value,
|
||||
post_categories: Vec<String>,
|
||||
post_tags: Vec<String>,
|
||||
tag_color_by_name: HashMap<String, String>,
|
||||
backlinks: Vec<serde_json::Value>,
|
||||
canonical_post_path_by_slug: HashMap<String, String>,
|
||||
canonical_media_path_by_source_path: HashMap<String, String>,
|
||||
post_data_json_by_id: HashMap<String, String>,
|
||||
}
|
||||
|
||||
pub fn build_canonical_post_path(post: &Post, language: &str, main_language: &str) -> String {
|
||||
let timestamp_ms = post.published_at.unwrap_or(post.created_at);
|
||||
let Some(timestamp) = Utc.timestamp_millis_opt(timestamp_ms).single() else {
|
||||
return fallback_language_path(post, language, main_language);
|
||||
};
|
||||
|
||||
let base = format!(
|
||||
"/{:04}/{:02}/{:02}/{}",
|
||||
timestamp.year(),
|
||||
timestamp.month(),
|
||||
timestamp.day(),
|
||||
post.slug
|
||||
);
|
||||
|
||||
if language.eq_ignore_ascii_case(main_language) {
|
||||
base
|
||||
} else {
|
||||
format!("/{language}{base}")
|
||||
}
|
||||
}
|
||||
|
||||
pub fn render_starter_single_post_page(
|
||||
post: &Post,
|
||||
body_markdown: &str,
|
||||
metadata: &ProjectMetadata,
|
||||
language: &str,
|
||||
) -> Result<RenderedPage, RenderError> {
|
||||
let relative_path = format!("{}/index.html", build_canonical_post_path(post, language, main_language(metadata)).trim_start_matches('/'));
|
||||
let canonical_path = build_canonical_post_path(post, language, main_language(metadata));
|
||||
let (calendar_initial_year, calendar_initial_month) = calendar_initial_parts(post);
|
||||
let context = PostTemplateContext {
|
||||
language,
|
||||
language_prefix: language_prefix(language, main_language(metadata)),
|
||||
page_title: &post.title,
|
||||
pico_stylesheet_href: metadata
|
||||
.pico_theme
|
||||
.as_ref()
|
||||
.map(|_| "/assets/pico.min.css".to_string()),
|
||||
html_theme_attribute: None,
|
||||
alternate_links: build_alternate_links(post, metadata, language),
|
||||
blog_languages: build_blog_languages(post, metadata, language),
|
||||
menu_items: vec![],
|
||||
calendar_initial_year,
|
||||
calendar_initial_month,
|
||||
post: serde_json::json!({
|
||||
"id": post.id,
|
||||
"title": post.title,
|
||||
"content": body_markdown,
|
||||
}),
|
||||
post_categories: post.categories.clone(),
|
||||
post_tags: post.tags.clone(),
|
||||
tag_color_by_name: post
|
||||
.tags
|
||||
.iter()
|
||||
.map(|tag| (tag.clone(), String::new()))
|
||||
.collect(),
|
||||
backlinks: vec![],
|
||||
canonical_post_path_by_slug: HashMap::from([(post.slug.clone(), canonical_path)]),
|
||||
canonical_media_path_by_source_path: HashMap::new(),
|
||||
post_data_json_by_id: HashMap::new(),
|
||||
};
|
||||
|
||||
let html = render_liquid_template(
|
||||
STARTER_SINGLE_POST_TEMPLATE,
|
||||
&starter_partials(),
|
||||
&context,
|
||||
)?;
|
||||
|
||||
Ok(RenderedPage { relative_path, html })
|
||||
}
|
||||
|
||||
pub fn render_starter_list_page(
|
||||
posts: &[(Post, String)],
|
||||
metadata: &ProjectMetadata,
|
||||
language: &str,
|
||||
) -> Result<RenderedPage, RenderError> {
|
||||
let relative_path = if language.eq_ignore_ascii_case(main_language(metadata)) {
|
||||
"index.html".to_string()
|
||||
} else {
|
||||
format!("{language}/index.html")
|
||||
};
|
||||
|
||||
let canonical_paths = posts
|
||||
.iter()
|
||||
.map(|(post, _)| {
|
||||
(
|
||||
post.slug.clone(),
|
||||
build_canonical_post_path(post, language, main_language(metadata)),
|
||||
)
|
||||
})
|
||||
.collect::<HashMap<_, _>>();
|
||||
|
||||
let (calendar_initial_year, calendar_initial_month) = posts
|
||||
.first()
|
||||
.map(|(post, _)| calendar_initial_parts(post))
|
||||
.unwrap_or((1970, 1));
|
||||
|
||||
let context = ListTemplateContext {
|
||||
language: language.to_string(),
|
||||
language_prefix: language_prefix(language, main_language(metadata)),
|
||||
page_title: metadata.name.clone(),
|
||||
pico_stylesheet_href: metadata
|
||||
.pico_theme
|
||||
.as_ref()
|
||||
.map(|_| "/assets/pico.min.css".to_string()),
|
||||
html_theme_attribute: None,
|
||||
alternate_links: vec![],
|
||||
blog_languages: build_blog_languages_for_index(metadata, language),
|
||||
menu_items: vec![],
|
||||
calendar_initial_year,
|
||||
calendar_initial_month,
|
||||
archive_context: None,
|
||||
show_archive_range_heading: false,
|
||||
min_date: None,
|
||||
max_date: None,
|
||||
day_blocks: build_day_blocks(posts),
|
||||
is_list_page: false,
|
||||
is_first_page: true,
|
||||
is_last_page: true,
|
||||
has_prev_page: false,
|
||||
has_next_page: false,
|
||||
prev_page_href: None,
|
||||
next_page_href: None,
|
||||
canonical_post_path_by_slug: canonical_paths,
|
||||
canonical_media_path_by_source_path: HashMap::new(),
|
||||
post_data_json_by_id: HashMap::new(),
|
||||
};
|
||||
|
||||
let html = render_liquid_template(
|
||||
&starter_post_list_template(),
|
||||
&starter_partials(),
|
||||
&context,
|
||||
)?;
|
||||
|
||||
Ok(RenderedPage { relative_path, html })
|
||||
}
|
||||
|
||||
fn starter_partials() -> HashMap<String, String> {
|
||||
HashMap::from([
|
||||
("partials/head".to_string(), STARTER_HEAD_PARTIAL.to_string()),
|
||||
("partials/menu".to_string(), STARTER_MENU_PARTIAL.to_string()),
|
||||
(
|
||||
"partials/language-switcher".to_string(),
|
||||
STARTER_LANGUAGE_SWITCHER_PARTIAL.to_string(),
|
||||
),
|
||||
(
|
||||
"partials/menu-items".to_string(),
|
||||
"{% for item in items %}<a href=\"{{ item.href }}\">{{ item.title }}</a>{% endfor %}".to_string(),
|
||||
),
|
||||
])
|
||||
}
|
||||
|
||||
fn starter_post_list_template() -> String {
|
||||
STARTER_POST_LIST_TEMPLATE.replace(
|
||||
"{% render 'partials/head', page_title: page_title, pico_stylesheet_href: pico_stylesheet_href, language_prefix: language_prefix %}",
|
||||
"{% render 'partials/head', page_title: page_title, pico_stylesheet_href: pico_stylesheet_href, language_prefix: language_prefix, alternate_links: alternate_links %}",
|
||||
)
|
||||
}
|
||||
|
||||
fn main_language(metadata: &ProjectMetadata) -> &str {
|
||||
metadata.main_language.as_deref().unwrap_or("en")
|
||||
}
|
||||
|
||||
fn language_prefix(language: &str, main_language: &str) -> String {
|
||||
if language.eq_ignore_ascii_case(main_language) {
|
||||
String::new()
|
||||
} else {
|
||||
format!("/{language}")
|
||||
}
|
||||
}
|
||||
|
||||
fn fallback_language_path(post: &Post, language: &str, main_language: &str) -> String {
|
||||
if language.eq_ignore_ascii_case(main_language) {
|
||||
format!("/posts/{}", post.slug)
|
||||
} else {
|
||||
format!("/{language}/posts/{}", post.slug)
|
||||
}
|
||||
}
|
||||
|
||||
fn calendar_initial_parts(post: &Post) -> (i32, u32) {
|
||||
let timestamp_ms = post.published_at.unwrap_or(post.created_at);
|
||||
Utc.timestamp_millis_opt(timestamp_ms)
|
||||
.single()
|
||||
.map(|timestamp| (timestamp.year(), timestamp.month()))
|
||||
.unwrap_or((1970, 1))
|
||||
}
|
||||
|
||||
fn build_alternate_links(post: &Post, metadata: &ProjectMetadata, current_language: &str) -> Vec<AlternateLinkContext> {
|
||||
metadata
|
||||
.blog_languages
|
||||
.iter()
|
||||
.map(|language| AlternateLinkContext {
|
||||
href: build_absolute_post_url(post, metadata, language),
|
||||
hreflang: language.clone(),
|
||||
})
|
||||
.chain(std::iter::once(AlternateLinkContext {
|
||||
href: build_absolute_post_url(post, metadata, current_language),
|
||||
hreflang: "x-default".to_string(),
|
||||
}))
|
||||
.collect()
|
||||
}
|
||||
|
||||
fn build_blog_languages(post: &Post, metadata: &ProjectMetadata, current_language: &str) -> Vec<BlogLanguageContext> {
|
||||
metadata
|
||||
.blog_languages
|
||||
.iter()
|
||||
.map(|language| BlogLanguageContext {
|
||||
is_current: language.eq_ignore_ascii_case(current_language),
|
||||
code: language.clone(),
|
||||
flag: render_flag(language),
|
||||
href: build_absolute_post_url(post, metadata, language),
|
||||
href_prefix: language_prefix(language, main_language(metadata)),
|
||||
})
|
||||
.collect()
|
||||
}
|
||||
|
||||
fn build_blog_languages_for_index(metadata: &ProjectMetadata, current_language: &str) -> Vec<BlogLanguageContext> {
|
||||
metadata
|
||||
.blog_languages
|
||||
.iter()
|
||||
.map(|language| BlogLanguageContext {
|
||||
is_current: language.eq_ignore_ascii_case(current_language),
|
||||
code: language.clone(),
|
||||
flag: render_flag(language),
|
||||
href: build_absolute_index_url(metadata, language),
|
||||
href_prefix: language_prefix(language, main_language(metadata)),
|
||||
})
|
||||
.collect()
|
||||
}
|
||||
|
||||
fn build_absolute_post_url(post: &Post, metadata: &ProjectMetadata, language: &str) -> String {
|
||||
let base_url = metadata.public_url.as_deref().unwrap_or("").trim_end_matches('/');
|
||||
format!("{base_url}{}", build_canonical_post_path(post, language, main_language(metadata)))
|
||||
}
|
||||
|
||||
fn build_absolute_index_url(metadata: &ProjectMetadata, language: &str) -> String {
|
||||
let base_url = metadata.public_url.as_deref().unwrap_or("").trim_end_matches('/');
|
||||
let suffix = if language.eq_ignore_ascii_case(main_language(metadata)) {
|
||||
"/".to_string()
|
||||
} else {
|
||||
format!("/{language}/")
|
||||
};
|
||||
format!("{base_url}{suffix}")
|
||||
}
|
||||
|
||||
fn render_flag(language: &str) -> String {
|
||||
normalize_language(language).flag_emoji().to_string()
|
||||
}
|
||||
|
||||
fn build_day_blocks(posts: &[(Post, String)]) -> Vec<DayBlockContext> {
|
||||
let mut blocks: Vec<DayBlockContext> = Vec::new();
|
||||
let mut current_key: Option<String> = None;
|
||||
|
||||
for (post, body) in posts {
|
||||
let timestamp_ms = post.published_at.unwrap_or(post.created_at);
|
||||
let Some(timestamp) = Utc.timestamp_millis_opt(timestamp_ms).single() else {
|
||||
continue;
|
||||
};
|
||||
|
||||
let key = format!("{:04}-{:02}-{:02}", timestamp.year(), timestamp.month(), timestamp.day());
|
||||
if current_key.as_deref() != Some(key.as_str()) {
|
||||
if let Some(last) = blocks.last_mut() {
|
||||
last.show_separator = true;
|
||||
}
|
||||
current_key = Some(key);
|
||||
blocks.push(DayBlockContext {
|
||||
show_date_marker: true,
|
||||
date_label: format!("{:02}.{:02}.{:04}", timestamp.day(), timestamp.month(), timestamp.year()),
|
||||
posts: Vec::new(),
|
||||
show_separator: false,
|
||||
});
|
||||
}
|
||||
|
||||
if let Some(block) = blocks.last_mut() {
|
||||
block.posts.push(serde_json::json!({
|
||||
"id": post.id,
|
||||
"slug": post.slug,
|
||||
"title": post.title,
|
||||
"content": post.excerpt.clone().unwrap_or_else(|| body.clone()),
|
||||
"show_title": true,
|
||||
}));
|
||||
}
|
||||
}
|
||||
|
||||
blocks
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use crate::model::PostStatus;
|
||||
|
||||
fn make_post() -> Post {
|
||||
Post {
|
||||
id: "post-1".into(),
|
||||
project_id: "project-1".into(),
|
||||
title: "Hello".into(),
|
||||
slug: "hello".into(),
|
||||
excerpt: None,
|
||||
content: Some("Body".into()),
|
||||
status: PostStatus::Published,
|
||||
author: None,
|
||||
language: Some("en".into()),
|
||||
do_not_translate: false,
|
||||
template_slug: None,
|
||||
file_path: String::new(),
|
||||
checksum: None,
|
||||
tags: vec![],
|
||||
categories: vec![],
|
||||
published_title: None,
|
||||
published_content: None,
|
||||
published_tags: None,
|
||||
published_categories: None,
|
||||
published_excerpt: None,
|
||||
created_at: 1_710_000_000_000,
|
||||
updated_at: 1_710_000_000_000,
|
||||
published_at: Some(1_710_000_000_000),
|
||||
}
|
||||
}
|
||||
|
||||
fn make_metadata() -> ProjectMetadata {
|
||||
ProjectMetadata {
|
||||
name: "Blog".into(),
|
||||
description: None,
|
||||
public_url: Some("https://example.com".into()),
|
||||
main_language: Some("en".into()),
|
||||
default_author: None,
|
||||
max_posts_per_page: 50,
|
||||
blogmark_category: None,
|
||||
pico_theme: None,
|
||||
semantic_similarity_enabled: false,
|
||||
blog_languages: vec!["en".into(), "de".into()],
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn canonical_post_paths_follow_language_prefix_rule() {
|
||||
let post = make_post();
|
||||
assert_eq!(build_canonical_post_path(&post, "en", "en"), "/2024/03/09/hello");
|
||||
assert_eq!(build_canonical_post_path(&post, "de", "en"), "/de/2024/03/09/hello");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn starter_single_post_renderer_uses_canonical_route_and_language_links() {
|
||||
let post = make_post();
|
||||
let metadata = make_metadata();
|
||||
let rendered = render_starter_single_post_page(&post, "Body with [link](/posts/hello)", &metadata, "en").unwrap();
|
||||
|
||||
assert_eq!(rendered.relative_path, "2024/03/09/hello/index.html");
|
||||
assert!(rendered.html.contains("https://example.com/2024/03/09/hello"));
|
||||
assert!(rendered.html.contains("https://example.com/de/2024/03/09/hello"));
|
||||
assert!(rendered.html.contains("href=\"/2024/03/09/hello\""));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn starter_list_renderer_groups_posts_and_uses_language_specific_index_path() {
|
||||
let metadata = make_metadata();
|
||||
let first = make_post();
|
||||
let mut second = make_post();
|
||||
second.id = "post-2".into();
|
||||
second.slug = "next".into();
|
||||
second.title = "Next".into();
|
||||
second.published_at = Some(1_710_086_400_000);
|
||||
second.created_at = 1_710_086_400_000;
|
||||
|
||||
let rendered = render_starter_list_page(
|
||||
&[(first, "First body".into()), (second, "Second body".into())],
|
||||
&metadata,
|
||||
"de",
|
||||
)
|
||||
.unwrap();
|
||||
|
||||
assert_eq!(rendered.relative_path, "de/index.html");
|
||||
assert!(rendered.html.contains("archive-day-group"));
|
||||
assert!(rendered.html.contains("09.03.2024"));
|
||||
assert!(rendered.html.contains("10.03.2024"));
|
||||
assert!(rendered.html.contains("href=\"/de/2024/03/10/next\""));
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user