First draft of theme support

This commit is contained in:
Vincent Prouillet 2017-08-23 19:17:24 +09:00
parent ce371f2ed5
commit c77cc9b170
20 changed files with 115 additions and 31 deletions

3
Cargo.lock generated
View file

@ -4,6 +4,7 @@ version = "0.1.0"
dependencies = [
"errors 0.1.0",
"tempdir 0.3.5 (registry+https://github.com/rust-lang/crates.io-index)",
"tera 0.10.9 (registry+https://github.com/rust-lang/crates.io-index)",
]
[[package]]
@ -775,6 +776,7 @@ dependencies = [
"serde 1.0.11 (registry+https://github.com/rust-lang/crates.io-index)",
"serde_derive 1.0.11 (registry+https://github.com/rust-lang/crates.io-index)",
"tera 0.10.9 (registry+https://github.com/rust-lang/crates.io-index)",
"utils 0.1.0",
]
[[package]]
@ -1163,6 +1165,7 @@ dependencies = [
"serde_derive 1.0.11 (registry+https://github.com/rust-lang/crates.io-index)",
"slug 0.1.2 (registry+https://github.com/rust-lang/crates.io-index)",
"tera 0.10.9 (registry+https://github.com/rust-lang/crates.io-index)",
"utils 0.1.0",
]
[[package]]

View file

@ -23,6 +23,8 @@ pub struct Config {
/// Base URL of the site, the only required config argument
pub base_url: String,
/// Theme to use
pub theme: Option<String>,
/// Title of the site. Defaults to None
pub title: Option<String>,
/// Whether to highlight all code blocks found in markdown files. Defaults to false
@ -130,6 +132,7 @@ impl Default for Config {
fn default() -> Config {
Config {
title: Some("".to_string()),
theme: None,
base_url: "http://a-website.com/".to_string(),
highlight_code: Some(true),
highlight_theme: Some("base16-ocean-dark".to_string()),

View file

@ -12,6 +12,7 @@ use errors::{Result, ResultExt};
use config::Config;
use utils::fs::{read_file, find_related_assets};
use utils::site::get_reading_analytics;
use utils::templates::render_template;
use front_matter::{PageFrontMatter, InsertAnchor, split_page_content};
use rendering::{Context, Header, markdown_to_html};
@ -154,7 +155,7 @@ impl Page {
context.add("current_url", &self.permalink);
context.add("current_path", &self.path);
tera.render(&tpl_name, &context)
render_template(&tpl_name, tera, &context, config.theme.clone())
.chain_err(|| format!("Failed to render page '{}'", self.file.path.display()))
}
}

View file

@ -9,6 +9,7 @@ use config::Config;
use front_matter::{SectionFrontMatter, split_section_content};
use errors::{Result, ResultExt};
use utils::fs::read_file;
use utils::templates::render_template;
use rendering::{Context, Header, markdown_to_html};
use page::Page;
@ -113,7 +114,7 @@ impl Section {
context.add("current_url", &self.permalink);
context.add("current_path", &self.path);
tera.render(&tpl_name, &context)
render_template(&tpl_name, tera, &context, config.theme.clone())
.chain_err(|| format!("Failed to render section '{}'", self.file.path.display()))
}

View file

@ -11,6 +11,7 @@ serde_derive = "1.0"
errors = { path = "../errors" }
config = { path = "../config" }
content = { path = "../content" }
utils = { path = "../utils" }
[dev-dependencies]
front_matter = { path = "../front_matter" }

View file

@ -5,6 +5,7 @@ extern crate tera;
extern crate errors;
extern crate config;
extern crate content;
extern crate utils;
#[cfg(test)]
extern crate front_matter;
@ -16,6 +17,7 @@ use tera::{Tera, Context, to_value, Value};
use errors::{Result, ResultExt};
use config::Config;
use content::{Page, Section};
use utils::templates::render_template;
/// A list of all the pages in the paginator with their index and links
@ -170,7 +172,7 @@ impl<'a> Paginator<'a> {
context.add("current_path", &pager.path);
context.add("paginator", &self.build_paginator_context(pager));
tera.render(&self.section.get_template_name(), &context)
render_template(&self.section.get_template_name(), tera, &context, config.theme.clone())
.chain_err(|| format!("Failed to render pager {} of section '{}'", pager.index, self.section.file.path.display()))
}
}

View file

@ -33,6 +33,7 @@ use sass_rs::{Options, compile_file};
use errors::{Result, ResultExt};
use config::{Config, get_config};
use utils::fs::{create_file, create_directory, ensure_directory_exists};
use utils::templates::render_template;
use content::{Page, Section, populate_previous_and_next_pages, sort_pages};
use templates::{GUTENBERG_TERA, global_fns, render_redirect_template};
use front_matter::{SortBy, InsertAnchor};
@ -67,7 +68,7 @@ pub struct Site {
pub tera: Tera,
live_reload: bool,
output_path: PathBuf,
static_path: PathBuf,
pub static_path: PathBuf,
pub tags: Option<Taxonomy>,
pub categories: Option<Taxonomy>,
/// A map of all .md files (section and pages) and their permalink
@ -80,14 +81,29 @@ impl Site {
/// Passing in a path is only used in tests
pub fn new<P: AsRef<Path>>(path: P, config_file: &str) -> Result<Site> {
let path = path.as_ref();
let config = get_config(path, config_file);
let tpl_glob = format!("{}/{}", path.to_string_lossy().replace("\\", "/"), "templates/**/*.*ml");
let mut tera = Tera::new(&tpl_glob).chain_err(|| "Error parsing templates")?;
tera.extend(&GUTENBERG_TERA)?;
if let Some(ref theme) = config.theme {
// Test that the {templates,static} folder exist for that theme
let theme_path = path.join("themes").join(theme);
if !theme_path.join("templates").exists() {
bail!("Theme `{}` is missing a templates folder", theme);
}
if !theme_path.join("static").exists() {
bail!("Theme `{}` is missing a static folder", theme);
}
let theme_tpl_glob = format!("{}/{}", path.to_string_lossy().replace("\\", "/"), "themes/**/*.html");
let tera_themes = Tera::new(&theme_tpl_glob).chain_err(|| "Error parsing templates from themes")?;
tera.extend(&tera_themes)?;
}
let site = Site {
base_path: path.to_path_buf(),
config: get_config(path, config_file),
config: config,
pages: HashMap::new(),
sections: HashMap::new(),
tera: tera,
@ -242,7 +258,7 @@ impl Site {
if render {
let insert_anchor = self.find_parent_section_insert_anchor(&self.pages[&path].file.parent);
let mut page = self.pages.get_mut(&path).unwrap();
let page = self.pages.get_mut(&path).unwrap();
page.render_markdown(&self.permalinks, &self.tera, &self.config, insert_anchor)?;
}
@ -259,7 +275,7 @@ impl Site {
let prev = self.sections.insert(section.file.path.clone(), section);
if render {
let mut section = self.sections.get_mut(&path).unwrap();
let section = self.sections.get_mut(&path).unwrap();
section.render_markdown(&self.permalinks, &self.tera, &self.config)?;
}
@ -353,9 +369,9 @@ impl Site {
html
}
/// Copy static file to public directory.
pub fn copy_static_file<P: AsRef<Path>>(&self, path: P) -> Result<()> {
let relative_path = path.as_ref().strip_prefix(&self.static_path).unwrap();
/// Copy the file at the given path into the public folder
pub fn copy_static_file<P: AsRef<Path>>(&self, path: P, base_path: &PathBuf) -> Result<()> {
let relative_path = path.as_ref().strip_prefix(base_path).unwrap();
let target_path = self.output_path.join(relative_path);
if let Some(parent_directory) = target_path.parent() {
create_dir_all(parent_directory)?;
@ -364,24 +380,36 @@ impl Site {
Ok(())
}
/// Copy the content of the `static` folder into the `public` folder
pub fn copy_static_directory(&self) -> Result<()> {
for entry in WalkDir::new(&self.static_path).into_iter().filter_map(|e| e.ok()) {
let relative_path = entry.path().strip_prefix(&self.static_path).unwrap();
/// Copy the content of the given folder into the `public` folder
fn copy_static_directory(&self, path: &PathBuf) -> Result<()> {
for entry in WalkDir::new(path).into_iter().filter_map(|e| e.ok()) {
let relative_path = entry.path().strip_prefix(path).unwrap();
let target_path = self.output_path.join(relative_path);
if entry.path().is_dir() {
if !target_path.exists() {
create_directory(&target_path)?;
}
} else {
let entry_fullpath = self.base_path.join(entry.path());
self.copy_static_file(entry_fullpath)?;
self.copy_static_file(entry_fullpath, path)?;
}
}
Ok(())
}
/// Copy the main `static` folder and the theme `static` folder if a theme is used
pub fn copy_static_directories(&self) -> Result<()> {
// The user files will overwrite the theme files
if let Some(ref theme) = self.config.theme {
self.copy_static_directory(
&self.base_path.join("themes").join(theme).join("static")
)?;
}
self.copy_static_directory(&self.static_path)?;
Ok(())
}
/// Deletes the `public` directory if it exists
pub fn clean(&self) -> Result<()> {
if self.output_path.exists() {
@ -440,17 +468,24 @@ impl Site {
self.render_categories()?;
self.render_tags()?;
if self.config.compile_sass.unwrap() {
self.compile_sass()?;
if let Some(ref theme) = self.config.theme {
let theme_path = self.base_path.join("themes").join(theme);
if theme_path.join("sass").exists() {
self.compile_sass(&theme_path)?;
}
}
self.copy_static_directory()
if self.config.compile_sass.unwrap() {
self.compile_sass(&self.base_path)?;
}
self.copy_static_directories()
}
pub fn compile_sass(&self) -> Result<()> {
pub fn compile_sass(&self, base_path: &PathBuf) -> Result<()> {
ensure_directory_exists(&self.output_path)?;
let base_path = self.base_path.to_string_lossy().replace("\\", "/");
let base_path = base_path.to_string_lossy().replace("\\", "/");
let sass_glob = format!("{}/{}", base_path, "sass/**/*.scss");
let files = glob(&sass_glob)
.unwrap()
@ -495,7 +530,7 @@ impl Site {
ensure_directory_exists(&self.output_path)?;
create_file(
&self.output_path.join("robots.txt"),
&self.tera.render("robots.txt", &Context::new())?
&render_template("robots.txt", &self.tera, &Context::new(), self.config.theme.clone())?
)
}
@ -582,7 +617,7 @@ impl Site {
}
context.add("tags", &tags);
let sitemap = self.tera.render("sitemap.xml", &context)?;
let sitemap = &render_template("sitemap.xml", &self.tera, &context, self.config.theme.clone())?;
create_file(&self.output_path.join("sitemap.xml"), &sitemap)?;
@ -616,9 +651,9 @@ impl Site {
};
context.add("feed_url", &rss_feed_url);
let sitemap = self.tera.render("rss.xml", &context)?;
let feed = &render_template("rss.xml", &self.tera, &context, self.config.theme.clone())?;
create_file(&self.output_path.join("rss.xml"), &sitemap)?;
create_file(&self.output_path.join("rss.xml"), &feed)?;
Ok(())
}

View file

@ -4,6 +4,7 @@ highlight_code = true
compile_sass = true
generate_rss = true
rss_limit = 2
theme = "sample"
[extra.author]
name = "Vincent Prouillet"

View file

@ -0,0 +1,3 @@
body {
font-weight: bold;
}

View file

@ -0,0 +1 @@
Hello

View file

@ -0,0 +1,3 @@
name = "sample"
[extra]

View file

@ -100,7 +100,6 @@ fn can_build_site_without_live_reload() {
site.build().unwrap();
assert!(Path::new(&public).exists());
assert!(file_exists!(public, "index.html"));
assert!(file_exists!(public, "sitemap.xml"));
assert!(file_exists!(public, "robots.txt"));
@ -130,6 +129,10 @@ fn can_build_site_without_live_reload() {
assert_eq!(file_exists!(public, "categories/index.html"), false);
assert_eq!(file_exists!(public, "tags/index.html"), false);
// Theme files are there
assert!(file_exists!(public, "sample.css"));
assert!(file_exists!(public, "some.js"));
// no live reload code
assert_eq!(file_contains!(public, "index.html", "/livereload.js?port=1112&mindelay=10"), false);

View file

@ -13,3 +13,4 @@ errors = { path = "../errors" }
config = { path = "../config" }
content = { path = "../content" }
front_matter = { path = "../front_matter" }
utils = { path = "../utils" }

View file

@ -7,6 +7,7 @@ extern crate errors;
extern crate config;
extern crate content;
extern crate front_matter;
extern crate utils;
use std::collections::HashMap;
@ -17,6 +18,7 @@ use config::Config;
use errors::{Result, ResultExt};
use content::{Page, sort_pages};
use front_matter::SortBy;
use utils::templates::render_template;
#[derive(Debug, Copy, Clone, PartialEq)]
@ -139,7 +141,7 @@ impl Taxonomy {
context.add("current_url", &config.make_permalink(&format!("{}/{}", name, item.slug)));
context.add("current_path", &format!("/{}/{}", name, item.slug));
tera.render(&format!("{}.html", name), &context)
render_template(&format!("{}.html", name), tera, &context, config.theme.clone())
.chain_err(|| format!("Failed to render {} page.", name))
}
@ -151,7 +153,7 @@ impl Taxonomy {
context.add("current_url", &config.make_permalink(&name));
context.add("current_path", &name);
tera.render(&format!("{}.html", name), &context)
render_template(&format!("{}.html", name), tera, &context, config.theme.clone())
.chain_err(|| format!("Failed to render {} page.", name))
}
}

View file

@ -14,8 +14,8 @@ pub mod filters;
pub mod global_fns;
use tera::{Tera, Context};
use errors::{Result, ResultExt};
use errors::{Result, ResultExt};
lazy_static! {
pub static ref GUTENBERG_TERA: Tera = {

View file

@ -5,6 +5,7 @@ authors = ["Vincent Prouillet <vincent@wearewizards.io>"]
[dependencies]
errors = { path = "../errors" }
tera = "0.10"
[dev-dependencies]

View file

@ -3,6 +3,8 @@ extern crate errors;
#[cfg(test)]
extern crate tempdir;
extern crate tera;
pub mod fs;
pub mod site;
pub mod templates;

View file

@ -0,0 +1,21 @@
use tera::{Tera, Context};
use errors::Result;
/// Renders the given template with the given context, but also ensures that, if the default file
/// is not found, it will look up for the equivalent template for the current theme if there is one
pub fn render_template(name: &str, tera: &Tera, context: &Context, theme: Option<String>) -> Result<String> {
if tera.templates.contains_key(name) {
return tera
.render(name, context)
.map_err(|e| e.into());
}
if let Some(ref t) = theme {
return tera
.render(&format!("{}/templates/{}", t, name), context)
.map_err(|e| e.into());
}
bail!("Tried to render `{}` but the template wasn't found", name)
}

View file

@ -180,12 +180,12 @@ pub fn serve(interface: &str, port: &str, config_file: &str) -> Result<()> {
(ChangeKind::StaticFiles, p) => {
if path.is_file() {
console::info(&format!("-> Static file changes detected {}", path.display()));
rebuild_done_handling(&broadcaster, site.copy_static_file(&path), &p);
rebuild_done_handling(&broadcaster, site.copy_static_file(&path, &site.static_path), &p);
}
},
(ChangeKind::Sass, p) => {
console::info(&format!("-> Sass file changed {}", path.display()));
rebuild_done_handling(&broadcaster, site.compile_sass(), &p);
rebuild_done_handling(&broadcaster, site.compile_sass(&site.base_path), &p);
},
};
console::report_elapsed_time(start);