const DEFAULT_REFERENCE_CLASS: &str = "footnote-ref";
const DEFAULT_SEPARATOR_CLASS: &str = "footnotes-sep";
const DEFAULT_LIST_CLASS: &str = "footnotes";
const DEFAULT_ITEM_CLASS: &str = "footnote";
const DEFAULT_BACKLINK_CLASS: &str = "footnote-back";
const DEFAULT_BACKLINK_LABEL: &str = "↩";
const CLASS_DELIMITERS: [char; 3] = ['"', '<', '>'];
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct CiteStyle {
pub(crate) reference_class: String,
pub(crate) separator_class: String,
pub(crate) list_class: String,
pub(crate) item_class: String,
pub(crate) backlink_class: String,
pub(crate) backlink_label: String,
}
impl Default for CiteStyle {
fn default() -> Self {
Self {
reference_class: DEFAULT_REFERENCE_CLASS.to_string(),
separator_class: DEFAULT_SEPARATOR_CLASS.to_string(),
list_class: DEFAULT_LIST_CLASS.to_string(),
item_class: DEFAULT_ITEM_CLASS.to_string(),
backlink_class: DEFAULT_BACKLINK_CLASS.to_string(),
backlink_label: DEFAULT_BACKLINK_LABEL.to_string(),
}
}
}
impl CiteStyle {
#[must_use]
pub fn reference_class(mut self, class: impl Into<String>) -> Self {
self.reference_class = checked_class(class.into());
self
}
#[must_use]
pub fn separator_class(mut self, class: impl Into<String>) -> Self {
self.separator_class = checked_class(class.into());
self
}
#[must_use]
pub fn list_class(mut self, class: impl Into<String>) -> Self {
self.list_class = checked_class(class.into());
self
}
#[must_use]
pub fn item_class(mut self, class: impl Into<String>) -> Self {
self.item_class = checked_class(class.into());
self
}
#[must_use]
pub fn backlink_class(mut self, class: impl Into<String>) -> Self {
self.backlink_class = checked_class(class.into());
self
}
#[must_use]
pub fn backlink_label(mut self, label: impl Into<String>) -> Self {
self.backlink_label = label.into();
self
}
}
fn checked_class(class: String) -> String {
debug_assert!(
!class.contains(CLASS_DELIMITERS),
"class name must not contain a quote or angle bracket: {class:?}"
);
class
}
pub(crate) fn class_attr(class: &str) -> String {
if class.is_empty() {
return String::new();
}
format!(r#" class="{class}""#)
}
#[cfg(test)]
#[path = "../tests/unit/style.rs"]
mod tests;