You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

808 lines
29KB

  1. extern crate tera;
  2. extern crate rayon;
  3. extern crate glob;
  4. extern crate walkdir;
  5. extern crate serde;
  6. #[macro_use]
  7. extern crate serde_derive;
  8. extern crate sass_rs;
  9. #[macro_use]
  10. extern crate errors;
  11. extern crate config;
  12. extern crate utils;
  13. extern crate front_matter;
  14. extern crate templates;
  15. extern crate pagination;
  16. extern crate taxonomies;
  17. extern crate content;
  18. #[cfg(test)]
  19. extern crate tempdir;
  20. use std::collections::HashMap;
  21. use std::fs::{remove_dir_all, copy, create_dir_all};
  22. use std::mem;
  23. use std::path::{Path, PathBuf};
  24. use glob::glob;
  25. use tera::{Tera, Context};
  26. use walkdir::WalkDir;
  27. use sass_rs::{Options, OutputStyle, compile_file};
  28. use errors::{Result, ResultExt};
  29. use config::{Config, get_config};
  30. use utils::fs::{create_file, create_directory, ensure_directory_exists};
  31. use utils::templates::{render_template, rewrite_theme_paths};
  32. use content::{Page, Section, populate_previous_and_next_pages, sort_pages};
  33. use templates::{GUTENBERG_TERA, global_fns, render_redirect_template};
  34. use front_matter::{SortBy, InsertAnchor};
  35. use taxonomies::Taxonomy;
  36. use pagination::Paginator;
  37. use rayon::prelude::*;
  38. /// The sitemap only needs links and potentially date so we trim down
  39. /// all pages to only that
  40. #[derive(Debug, Serialize)]
  41. struct SitemapEntry {
  42. permalink: String,
  43. date: Option<String>,
  44. }
  45. impl SitemapEntry {
  46. pub fn new(permalink: String, date: Option<String>) -> SitemapEntry {
  47. SitemapEntry { permalink, date }
  48. }
  49. }
  50. #[derive(Debug)]
  51. pub struct Site {
  52. /// The base path of the gutenberg site
  53. pub base_path: PathBuf,
  54. /// The parsed config for the site
  55. pub config: Config,
  56. pub pages: HashMap<PathBuf, Page>,
  57. pub sections: HashMap<PathBuf, Section>,
  58. pub tera: Tera,
  59. live_reload: bool,
  60. output_path: PathBuf,
  61. pub static_path: PathBuf,
  62. pub tags: Option<Taxonomy>,
  63. pub categories: Option<Taxonomy>,
  64. /// A map of all .md files (section and pages) and their permalink
  65. /// We need that if there are relative links in the content that need to be resolved
  66. pub permalinks: HashMap<String, String>,
  67. }
  68. impl Site {
  69. /// Parse a site at the given path. Defaults to the current dir
  70. /// Passing in a path is only used in tests
  71. pub fn new<P: AsRef<Path>>(path: P, config_file: &str) -> Result<Site> {
  72. let path = path.as_ref();
  73. let mut config = get_config(path, config_file);
  74. let tpl_glob = format!("{}/{}", path.to_string_lossy().replace("\\", "/"), "templates/**/*.*ml");
  75. // Only parsing as we might be extending templates from themes and that would error
  76. // as we haven't loaded them yet
  77. let mut tera = Tera::parse(&tpl_glob).chain_err(|| "Error parsing templates")?;
  78. if let Some(theme) = config.theme.clone() {
  79. // Grab data from the extra section of the theme
  80. config.merge_with_theme(&path.join("themes").join(&theme).join("theme.toml"))?;
  81. // Test that the {templates,static} folder exist for that theme
  82. let theme_path = path.join("themes").join(&theme);
  83. if !theme_path.join("templates").exists() {
  84. bail!("Theme `{}` is missing a templates folder", theme);
  85. }
  86. if !theme_path.join("static").exists() {
  87. bail!("Theme `{}` is missing a static folder", theme);
  88. }
  89. let theme_tpl_glob = format!("{}/{}", path.to_string_lossy().replace("\\", "/"), "themes/**/*.html");
  90. let mut tera_theme = Tera::parse(&theme_tpl_glob).chain_err(|| "Error parsing templates from themes")?;
  91. rewrite_theme_paths(&mut tera_theme, &theme);
  92. tera_theme.build_inheritance_chains()?;
  93. tera.extend(&tera_theme)?;
  94. }
  95. tera.extend(&GUTENBERG_TERA)?;
  96. // the `extend` above already does it but hey
  97. tera.build_inheritance_chains()?;
  98. let site = Site {
  99. base_path: path.to_path_buf(),
  100. config: config,
  101. pages: HashMap::new(),
  102. sections: HashMap::new(),
  103. tera: tera,
  104. live_reload: false,
  105. output_path: path.join("public"),
  106. static_path: path.join("static"),
  107. tags: None,
  108. categories: None,
  109. permalinks: HashMap::new(),
  110. };
  111. Ok(site)
  112. }
  113. /// What the function name says
  114. pub fn enable_live_reload(&mut self) {
  115. self.live_reload = true;
  116. }
  117. /// Get all the orphan (== without section) pages in the site
  118. pub fn get_all_orphan_pages(&self) -> Vec<&Page> {
  119. let mut pages_in_sections = vec![];
  120. let mut orphans = vec![];
  121. for s in self.sections.values() {
  122. pages_in_sections.extend(s.all_pages_path());
  123. }
  124. for page in self.pages.values() {
  125. if !pages_in_sections.contains(&page.file.path) {
  126. orphans.push(page);
  127. }
  128. }
  129. orphans
  130. }
  131. pub fn set_output_path<P: AsRef<Path>>(&mut self, path: P) {
  132. self.output_path = path.as_ref().to_path_buf();
  133. }
  134. /// Reads all .md files in the `content` directory and create pages/sections
  135. /// out of them
  136. pub fn load(&mut self) -> Result<()> {
  137. let base_path = self.base_path.to_string_lossy().replace("\\", "/");
  138. let content_glob = format!("{}/{}", base_path, "content/**/*.md");
  139. let (section_entries, page_entries): (Vec<_>, Vec<_>) = glob(&content_glob)
  140. .unwrap()
  141. .filter_map(|e| e.ok())
  142. .partition(|entry| entry.as_path().file_name().unwrap() == "_index.md");
  143. let sections = {
  144. let config = &self.config;
  145. section_entries
  146. .into_par_iter()
  147. .filter(|entry| entry.as_path().file_name().unwrap() == "_index.md")
  148. .map(|entry| {
  149. let path = entry.as_path();
  150. Section::from_file(path, config)
  151. })
  152. .collect::<Vec<_>>()
  153. };
  154. let pages = {
  155. let config = &self.config;
  156. page_entries
  157. .into_par_iter()
  158. .filter(|entry| entry.as_path().file_name().unwrap() != "_index.md")
  159. .map(|entry| {
  160. let path = entry.as_path();
  161. Page::from_file(path, config)
  162. })
  163. .collect::<Vec<_>>()
  164. };
  165. // Kinda duplicated code for add_section/add_page but necessary to do it that
  166. // way because of the borrow checker
  167. for section in sections {
  168. let s = section?;
  169. self.add_section(s, false)?;
  170. }
  171. // Insert a default index section if necessary so we don't need to create
  172. // a _index.md to render the index page
  173. let index_path = self.base_path.join("content").join("_index.md");
  174. if !self.sections.contains_key(&index_path) {
  175. let mut index_section = Section::default();
  176. index_section.permalink = self.config.make_permalink("");
  177. index_section.file.parent = self.base_path.join("content");
  178. index_section.file.relative = "_index.md".to_string();
  179. self.sections.insert(index_path, index_section);
  180. }
  181. let mut pages_insert_anchors = HashMap::new();
  182. for page in pages {
  183. let p = page?;
  184. pages_insert_anchors.insert(p.file.path.clone(), self.find_parent_section_insert_anchor(&p.file.parent.clone()));
  185. self.add_page(p, false)?;
  186. }
  187. {
  188. // Another silly thing needed to not borrow &self in parallel and
  189. // make the borrow checker happy
  190. let permalinks = &self.permalinks;
  191. let tera = &self.tera;
  192. let config = &self.config;
  193. self.pages.par_iter_mut()
  194. .map(|(_, page)| {
  195. let insert_anchor = pages_insert_anchors[&page.file.path];
  196. page.render_markdown(permalinks, tera, config, insert_anchor)
  197. })
  198. .fold(|| Ok(()), Result::and)
  199. .reduce(|| Ok(()), Result::and)?;
  200. self.sections.par_iter_mut()
  201. .map(|(_, section)| section.render_markdown(permalinks, tera, config))
  202. .fold(|| Ok(()), Result::and)
  203. .reduce(|| Ok(()), Result::and)?;
  204. }
  205. self.populate_sections();
  206. self.populate_tags_and_categories();
  207. self.register_tera_global_fns();
  208. Ok(())
  209. }
  210. pub fn register_tera_global_fns(&mut self) {
  211. self.tera.register_global_function("get_page", global_fns::make_get_page(&self.pages));
  212. self.tera.register_global_function("get_section", global_fns::make_get_section(&self.sections));
  213. self.tera.register_global_function(
  214. "get_taxonomy_url",
  215. global_fns::make_get_taxonomy_url(self.tags.clone(), self.categories.clone())
  216. );
  217. self.tera.register_global_function(
  218. "get_url",
  219. global_fns::make_get_url(self.permalinks.clone(), self.config.clone())
  220. );
  221. }
  222. /// Add a page to the site
  223. /// The `render` parameter is used in the serve command, when rebuilding a page.
  224. /// If `true`, it will also render the markdown for that page
  225. /// Returns the previous page struct if there was one
  226. pub fn add_page(&mut self, page: Page, render: bool) -> Result<Option<Page>> {
  227. let path = page.file.path.clone();
  228. self.permalinks.insert(page.file.relative.clone(), page.permalink.clone());
  229. let prev = self.pages.insert(page.file.path.clone(), page);
  230. if render {
  231. let insert_anchor = self.find_parent_section_insert_anchor(&self.pages[&path].file.parent);
  232. let page = self.pages.get_mut(&path).unwrap();
  233. page.render_markdown(&self.permalinks, &self.tera, &self.config, insert_anchor)?;
  234. }
  235. Ok(prev)
  236. }
  237. /// Add a section to the site
  238. /// The `render` parameter is used in the serve command, when rebuilding a page.
  239. /// If `true`, it will also render the markdown for that page
  240. /// Returns the previous section struct if there was one
  241. pub fn add_section(&mut self, section: Section, render: bool) -> Result<Option<Section>> {
  242. let path = section.file.path.clone();
  243. self.permalinks.insert(section.file.relative.clone(), section.permalink.clone());
  244. let prev = self.sections.insert(section.file.path.clone(), section);
  245. if render {
  246. let section = self.sections.get_mut(&path).unwrap();
  247. section.render_markdown(&self.permalinks, &self.tera, &self.config)?;
  248. }
  249. Ok(prev)
  250. }
  251. /// Finds the insert_anchor for the parent section of the directory at `path`.
  252. /// Defaults to `AnchorInsert::None` if no parent section found
  253. pub fn find_parent_section_insert_anchor(&self, parent_path: &PathBuf) -> InsertAnchor {
  254. match self.sections.get(&parent_path.join("_index.md")) {
  255. Some(s) => s.meta.insert_anchor_links.unwrap(),
  256. None => InsertAnchor::None
  257. }
  258. }
  259. /// Find out the direct subsections of each subsection if there are some
  260. /// as well as the pages for each section
  261. pub fn populate_sections(&mut self) {
  262. let mut grandparent_paths: HashMap<PathBuf, Vec<PathBuf>> = HashMap::new();
  263. for section in self.sections.values_mut() {
  264. if let Some(ref grand_parent) = section.file.grand_parent {
  265. grandparent_paths
  266. .entry(grand_parent.to_path_buf())
  267. .or_insert_with(|| vec![])
  268. .push(section.file.path.clone());
  269. }
  270. // Make sure the pages of a section are empty since we can call that many times on `serve`
  271. section.pages = vec![];
  272. section.ignored_pages = vec![];
  273. }
  274. for page in self.pages.values() {
  275. let parent_section_path = page.file.parent.join("_index.md");
  276. if self.sections.contains_key(&parent_section_path) {
  277. self.sections.get_mut(&parent_section_path).unwrap().pages.push(page.clone());
  278. }
  279. }
  280. self.sort_sections_pages(None);
  281. // TODO: remove this clone
  282. let sections = self.sections.clone();
  283. for section in self.sections.values_mut() {
  284. if let Some(paths) = grandparent_paths.get(&section.file.parent) {
  285. section.subsections = paths
  286. .iter()
  287. .map(|p| sections[p].clone())
  288. .collect::<Vec<_>>();
  289. section.subsections
  290. .sort_by(|a, b| a.meta.weight.unwrap().cmp(&b.meta.weight.unwrap()));
  291. }
  292. }
  293. }
  294. /// Sorts the pages of the section at the given path
  295. /// By default will sort all sections but can be made to only sort a single one by providing a path
  296. pub fn sort_sections_pages(&mut self, only: Option<&Path>) {
  297. for (path, section) in &mut self.sections {
  298. if let Some(p) = only {
  299. if p != path {
  300. continue;
  301. }
  302. }
  303. let pages = mem::replace(&mut section.pages, vec![]);
  304. let (sorted_pages, cannot_be_sorted_pages) = sort_pages(pages, section.meta.sort_by());
  305. section.pages = populate_previous_and_next_pages(&sorted_pages);
  306. section.ignored_pages = cannot_be_sorted_pages;
  307. }
  308. }
  309. /// Find all the tags and categories if it's asked in the config
  310. pub fn populate_tags_and_categories(&mut self) {
  311. let generate_tags_pages = self.config.generate_tags_pages.unwrap();
  312. let generate_categories_pages = self.config.generate_categories_pages.unwrap();
  313. if !generate_tags_pages && !generate_categories_pages {
  314. return;
  315. }
  316. // TODO: can we pass a reference?
  317. let (tags, categories) = Taxonomy::find_tags_and_categories(
  318. &self.config,
  319. self.pages
  320. .values()
  321. .filter(|p| !p.is_draft())
  322. .cloned()
  323. .collect::<Vec<_>>()
  324. .as_slice()
  325. );
  326. if generate_tags_pages {
  327. self.tags = Some(tags);
  328. }
  329. if generate_categories_pages {
  330. self.categories = Some(categories);
  331. }
  332. }
  333. /// Inject live reload script tag if in live reload mode
  334. fn inject_livereload(&self, html: String) -> String {
  335. if self.live_reload {
  336. return html.replace(
  337. "</body>",
  338. r#"<script src="/livereload.js?port=1112&mindelay=10"></script></body>"#
  339. );
  340. }
  341. html
  342. }
  343. /// Copy the file at the given path into the public folder
  344. pub fn copy_static_file<P: AsRef<Path>>(&self, path: P, base_path: &PathBuf) -> Result<()> {
  345. let relative_path = path.as_ref().strip_prefix(base_path).unwrap();
  346. let target_path = self.output_path.join(relative_path);
  347. if let Some(parent_directory) = target_path.parent() {
  348. create_dir_all(parent_directory)?;
  349. }
  350. copy(path.as_ref(), &target_path)?;
  351. Ok(())
  352. }
  353. /// Copy the content of the given folder into the `public` folder
  354. fn copy_static_directory(&self, path: &PathBuf) -> Result<()> {
  355. for entry in WalkDir::new(path).into_iter().filter_map(|e| e.ok()) {
  356. let relative_path = entry.path().strip_prefix(path).unwrap();
  357. let target_path = self.output_path.join(relative_path);
  358. if entry.path().is_dir() {
  359. if !target_path.exists() {
  360. create_directory(&target_path)?;
  361. }
  362. } else {
  363. let entry_fullpath = self.base_path.join(entry.path());
  364. self.copy_static_file(entry_fullpath, path)?;
  365. }
  366. }
  367. Ok(())
  368. }
  369. /// Copy the main `static` folder and the theme `static` folder if a theme is used
  370. pub fn copy_static_directories(&self) -> Result<()> {
  371. // The user files will overwrite the theme files
  372. if let Some(ref theme) = self.config.theme {
  373. self.copy_static_directory(
  374. &self.base_path.join("themes").join(theme).join("static")
  375. )?;
  376. }
  377. // We're fine with missing static folders
  378. if self.static_path.exists() {
  379. self.copy_static_directory(&self.static_path)?;
  380. }
  381. Ok(())
  382. }
  383. /// Deletes the `public` directory if it exists
  384. pub fn clean(&self) -> Result<()> {
  385. if self.output_path.exists() {
  386. // Delete current `public` directory so we can start fresh
  387. remove_dir_all(&self.output_path).chain_err(|| "Couldn't delete `public` directory")?;
  388. }
  389. Ok(())
  390. }
  391. /// Renders a single content page
  392. pub fn render_page(&self, page: &Page) -> Result<()> {
  393. ensure_directory_exists(&self.output_path)?;
  394. // Copy the nesting of the content directory if we have sections for that page
  395. let mut current_path = self.output_path.to_path_buf();
  396. for component in page.path.split('/') {
  397. current_path.push(component);
  398. if !current_path.exists() {
  399. create_directory(&current_path)?;
  400. }
  401. }
  402. // Make sure the folder exists
  403. create_directory(&current_path)?;
  404. // Finally, create a index.html file there with the page rendered
  405. let output = page.render_html(&self.tera, &self.config)?;
  406. create_file(&current_path.join("index.html"), &self.inject_livereload(output))?;
  407. // Copy any asset we found previously into the same directory as the index.html
  408. for asset in &page.assets {
  409. let asset_path = asset.as_path();
  410. copy(&asset_path, &current_path.join(asset_path.file_name().unwrap()))?;
  411. }
  412. Ok(())
  413. }
  414. /// Deletes the `public` directory and builds the site
  415. pub fn build(&self) -> Result<()> {
  416. self.clean()?;
  417. // Render aliases first to allow overwriting
  418. self.render_aliases()?;
  419. self.render_sections()?;
  420. self.render_orphan_pages()?;
  421. self.render_sitemap()?;
  422. if self.config.generate_rss.unwrap() {
  423. self.render_rss_feed()?;
  424. }
  425. self.render_robots()?;
  426. // `render_categories` and `render_tags` will check whether the config allows
  427. // them to render or not
  428. self.render_categories()?;
  429. self.render_tags()?;
  430. if let Some(ref theme) = self.config.theme {
  431. let theme_path = self.base_path.join("themes").join(theme);
  432. if theme_path.join("sass").exists() {
  433. self.compile_sass(&theme_path)?;
  434. }
  435. }
  436. if self.config.compile_sass.unwrap() {
  437. self.compile_sass(&self.base_path)?;
  438. }
  439. self.copy_static_directories()
  440. }
  441. pub fn compile_sass(&self, base_path: &PathBuf) -> Result<()> {
  442. ensure_directory_exists(&self.output_path)?;
  443. let base_path = base_path.to_string_lossy().replace("\\", "/");
  444. let sass_glob = format!("{}/{}", base_path, "sass/**/*.scss");
  445. let files = glob(&sass_glob)
  446. .unwrap()
  447. .filter_map(|e| e.ok())
  448. .filter(|entry| !entry.as_path().file_name().unwrap().to_string_lossy().starts_with('_'))
  449. .collect::<Vec<_>>();
  450. let mut sass_options = Options::default();
  451. sass_options.output_style = OutputStyle::Compressed;
  452. for file in files {
  453. let name = file.as_path().file_stem().unwrap().to_string_lossy();
  454. let css = match compile_file(file.as_path(), sass_options.clone()) {
  455. Ok(c) => c,
  456. Err(e) => bail!(e)
  457. };
  458. create_file(&self.output_path.join(format!("{}.css", name)), &css)?;
  459. }
  460. Ok(())
  461. }
  462. pub fn render_aliases(&self) -> Result<()> {
  463. for page in self.pages.values() {
  464. if let Some(ref aliases) = page.meta.aliases {
  465. for alias in aliases {
  466. let mut output_path = self.output_path.to_path_buf();
  467. for component in alias.split('/') {
  468. output_path.push(&component);
  469. if !output_path.exists() {
  470. create_directory(&output_path)?;
  471. }
  472. }
  473. create_file(&output_path.join("index.html"), &render_redirect_template(&page.permalink, &self.tera)?)?;
  474. }
  475. }
  476. }
  477. Ok(())
  478. }
  479. /// Renders robots.txt
  480. pub fn render_robots(&self) -> Result<()> {
  481. ensure_directory_exists(&self.output_path)?;
  482. create_file(
  483. &self.output_path.join("robots.txt"),
  484. &render_template("robots.txt", &self.tera, &Context::new(), self.config.theme.clone())?
  485. )
  486. }
  487. /// Renders all categories and the single category pages if there are some
  488. pub fn render_categories(&self) -> Result<()> {
  489. if let Some(ref categories) = self.categories {
  490. self.render_taxonomy(categories)?;
  491. }
  492. Ok(())
  493. }
  494. /// Renders all tags and the single tag pages if there are some
  495. pub fn render_tags(&self) -> Result<()> {
  496. if let Some(ref tags) = self.tags {
  497. self.render_taxonomy(tags)?;
  498. }
  499. Ok(())
  500. }
  501. fn render_taxonomy(&self, taxonomy: &Taxonomy) -> Result<()> {
  502. if taxonomy.items.is_empty() {
  503. return Ok(())
  504. }
  505. ensure_directory_exists(&self.output_path)?;
  506. let output_path = self.output_path.join(&taxonomy.get_list_name());
  507. let list_output = taxonomy.render_list(&self.tera, &self.config)?;
  508. create_directory(&output_path)?;
  509. create_file(&output_path.join("index.html"), &self.inject_livereload(list_output))?;
  510. taxonomy
  511. .items
  512. .par_iter()
  513. .map(|item| {
  514. let single_output = taxonomy.render_single_item(item, &self.tera, &self.config)?;
  515. create_directory(&output_path.join(&item.slug))?;
  516. create_file(
  517. &output_path.join(&item.slug).join("index.html"),
  518. &self.inject_livereload(single_output)
  519. )
  520. })
  521. .fold(|| Ok(()), Result::and)
  522. .reduce(|| Ok(()), Result::and)
  523. }
  524. /// What it says on the tin
  525. pub fn render_sitemap(&self) -> Result<()> {
  526. ensure_directory_exists(&self.output_path)?;
  527. let mut context = Context::new();
  528. context.add(
  529. "pages",
  530. &self.pages
  531. .values()
  532. .filter(|p| !p.is_draft())
  533. .map(|p| SitemapEntry::new(p.permalink.clone(), p.meta.date.clone()))
  534. .collect::<Vec<_>>()
  535. );
  536. context.add(
  537. "sections",
  538. &self.sections
  539. .values()
  540. .map(|s| SitemapEntry::new(s.permalink.clone(), None))
  541. .collect::<Vec<_>>()
  542. );
  543. let mut categories = vec![];
  544. if let Some(ref c) = self.categories {
  545. let name = c.get_list_name();
  546. categories.push(SitemapEntry::new(self.config.make_permalink(&name), None));
  547. for item in &c.items {
  548. categories.push(
  549. SitemapEntry::new(self.config.make_permalink(&format!("{}/{}", &name, item.slug)), None),
  550. );
  551. }
  552. }
  553. context.add("categories", &categories);
  554. let mut tags = vec![];
  555. if let Some(ref t) = self.tags {
  556. let name = t.get_list_name();
  557. tags.push(SitemapEntry::new(self.config.make_permalink(&name), None));
  558. for item in &t.items {
  559. tags.push(
  560. SitemapEntry::new(self.config.make_permalink(&format!("{}/{}", &name, item.slug)), None),
  561. );
  562. }
  563. }
  564. context.add("tags", &tags);
  565. context.add("config", &self.config);
  566. let sitemap = &render_template("sitemap.xml", &self.tera, &context, self.config.theme.clone())?;
  567. create_file(&self.output_path.join("sitemap.xml"), sitemap)?;
  568. Ok(())
  569. }
  570. pub fn render_rss_feed(&self) -> Result<()> {
  571. ensure_directory_exists(&self.output_path)?;
  572. let mut context = Context::new();
  573. let pages = self.pages.values()
  574. .filter(|p| p.meta.date.is_some() && !p.is_draft())
  575. .cloned()
  576. .collect::<Vec<Page>>();
  577. // Don't generate a RSS feed if none of the pages has a date
  578. if pages.is_empty() {
  579. return Ok(());
  580. }
  581. let (sorted_pages, _) = sort_pages(pages, SortBy::Date);
  582. context.add("last_build_date", &sorted_pages[0].meta.date);
  583. // limit to the last n elements)
  584. context.add("pages", &sorted_pages.iter().take(self.config.rss_limit.unwrap()).collect::<Vec<_>>());
  585. context.add("config", &self.config);
  586. let rss_feed_url = if self.config.base_url.ends_with('/') {
  587. format!("{}{}", self.config.base_url, "rss.xml")
  588. } else {
  589. format!("{}/{}", self.config.base_url, "rss.xml")
  590. };
  591. context.add("feed_url", &rss_feed_url);
  592. let feed = &render_template("rss.xml", &self.tera, &context, self.config.theme.clone())?;
  593. create_file(&self.output_path.join("rss.xml"), feed)?;
  594. Ok(())
  595. }
  596. /// Renders a single section
  597. pub fn render_section(&self, section: &Section, render_pages: bool) -> Result<()> {
  598. ensure_directory_exists(&self.output_path)?;
  599. let public = self.output_path.clone();
  600. let mut output_path = public.to_path_buf();
  601. for component in &section.file.components {
  602. output_path.push(component);
  603. if !output_path.exists() {
  604. create_directory(&output_path)?;
  605. }
  606. }
  607. if render_pages {
  608. section
  609. .pages
  610. .par_iter()
  611. .map(|p| self.render_page(p))
  612. .fold(|| Ok(()), Result::and)
  613. .reduce(|| Ok(()), Result::and)?;
  614. }
  615. if !section.meta.should_render() {
  616. return Ok(());
  617. }
  618. if let Some(ref redirect_to) = section.meta.redirect_to {
  619. let permalink = self.config.make_permalink(redirect_to);
  620. create_file(&output_path.join("index.html"), &render_redirect_template(&permalink, &self.tera)?)?;
  621. return Ok(());
  622. }
  623. if section.meta.is_paginated() {
  624. self.render_paginated(&output_path, section)?;
  625. } else {
  626. let output = section.render_html(&self.tera, &self.config)?;
  627. create_file(&output_path.join("index.html"), &self.inject_livereload(output))?;
  628. }
  629. Ok(())
  630. }
  631. /// Used only on reload
  632. pub fn render_index(&self) -> Result<()> {
  633. self.render_section(
  634. &self.sections[&self.base_path.join("content").join("_index.md")],
  635. false
  636. )
  637. }
  638. /// Renders all sections
  639. pub fn render_sections(&self) -> Result<()> {
  640. self.sections
  641. .values()
  642. .collect::<Vec<_>>()
  643. .into_par_iter()
  644. .map(|s| self.render_section(s, true))
  645. .fold(|| Ok(()), Result::and)
  646. .reduce(|| Ok(()), Result::and)
  647. }
  648. /// Renders all pages that do not belong to any sections
  649. pub fn render_orphan_pages(&self) -> Result<()> {
  650. ensure_directory_exists(&self.output_path)?;
  651. for page in self.get_all_orphan_pages() {
  652. self.render_page(page)?;
  653. }
  654. Ok(())
  655. }
  656. /// Renders a list of pages when the section/index is wanting pagination.
  657. pub fn render_paginated(&self, output_path: &Path, section: &Section) -> Result<()> {
  658. ensure_directory_exists(&self.output_path)?;
  659. let paginate_path = match section.meta.paginate_path {
  660. Some(ref s) => s.clone(),
  661. None => unreachable!()
  662. };
  663. let paginator = Paginator::new(&section.pages, section);
  664. let folder_path = output_path.join(&paginate_path);
  665. create_directory(&folder_path)?;
  666. paginator
  667. .pagers
  668. .par_iter()
  669. .enumerate()
  670. .map(|(i, pager)| {
  671. let page_path = folder_path.join(&format!("{}", i + 1));
  672. create_directory(&page_path)?;
  673. let output = paginator.render_pager(pager, &self.config, &self.tera)?;
  674. if i > 0 {
  675. create_file(&page_path.join("index.html"), &self.inject_livereload(output))?;
  676. } else {
  677. create_file(&output_path.join("index.html"), &self.inject_livereload(output))?;
  678. create_file(&page_path.join("index.html"), &render_redirect_template(&section.permalink, &self.tera)?)?;
  679. }
  680. Ok(())
  681. })
  682. .fold(|| Ok(()), Result::and)
  683. .reduce(|| Ok(()), Result::and)
  684. }
  685. }