sitewriter/README.md

70 lines
2.3 KiB
Markdown
Raw Normal View History

2021-10-19 15:11:10 +00:00
# sitewriter
2020-11-22 15:42:16 +00:00
2021-10-19 15:11:10 +00:00
### A library to generate sitemaps.
2020-11-22 14:43:41 +00:00
2021-10-19 15:11:10 +00:00
[![Version](https://img.shields.io/crates/v/sitewriter)](https://crates.io/crates/sitewriter)
[![Downloads](https://img.shields.io/crates/d/sitewriter)](https://crates.io/crates/sitewriter)
[![License](https://img.shields.io/crates/l/sitewriter)](https://crates.io/crates/sitewriter)
2021-10-19 15:14:04 +00:00
![Rust](https://github.com/edg-l/sitewriter/workflows/Rust/badge.svg)
2021-10-19 15:11:10 +00:00
[![Docs](https://docs.rs/sitewriter/badge.svg)](https://docs.rs/sitewriter)
2020-11-22 14:43:41 +00:00
2021-10-19 15:11:10 +00:00
It uses the [quick-xml](https://github.com/tafia/quick-xml) so it should be fast.
2020-11-22 14:43:41 +00:00
2021-10-19 15:11:10 +00:00
### Example
2020-11-22 14:47:10 +00:00
2020-11-22 14:43:41 +00:00
```rust
2021-10-19 15:11:10 +00:00
use chrono::prelude::*;
use sitewriter::*;
2020-11-22 14:43:41 +00:00
2021-10-19 15:11:10 +00:00
let urls = vec![
UrlEntryBuilder::default()
.loc("https://edgarluque.com/projects".parse().unwrap())
.build()
.unwrap(),
UrlEntry {
loc: "https://edgarluque.com/".parse().unwrap(),
changefreq: Some(ChangeFreq::Daily),
priority: Some(1.0),
lastmod: Some(Utc::now()),
},
UrlEntry {
loc: "https://edgarluque.com/blog".parse().unwrap(),
changefreq: Some(ChangeFreq::Weekly),
priority: Some(0.8),
lastmod: Some(Utc::now()),
},
UrlEntry {
loc: "https://edgarluque.com/blog/sitewriter".parse().unwrap(),
changefreq: Some(ChangeFreq::Never),
priority: Some(0.5),
lastmod: Some(Utc.ymd(2020, 11, 22).and_hms(15, 10, 15)),
},
UrlEntry {
loc: "https://edgarluque.com/blog/some-future-post"
.parse()
.unwrap(),
changefreq: Some(ChangeFreq::Never),
priority: Some(0.5),
lastmod: Some(
Utc.from_utc_datetime(&Local.ymd(2020, 12, 5).and_hms(12, 30, 0).naive_utc()),
),
},
// Entity escaping
UrlEntry {
loc: "https://edgarluque.com/blog/test&id='<test>'"
.parse()
.unwrap(),
changefreq: Some(ChangeFreq::Never),
priority: Some(0.5),
lastmod: Some(
Utc.from_utc_datetime(&Local.ymd(2020, 12, 5).and_hms(12, 30, 0).naive_utc()),
),
},
];
2020-11-22 14:43:41 +00:00
2021-10-19 15:11:10 +00:00
let result = Sitemap::generate_str(&urls).unwrap();
println!("{}", result);
2020-11-22 14:43:41 +00:00
```
2020-11-22 14:47:10 +00:00
2021-10-19 15:11:10 +00:00
License: MIT