[mdbook] Añade soporte a contenidos mdBook

This commit is contained in:
Manuel Cillero 2024-12-23 21:36:25 +01:00
parent 8a911bfb6a
commit cfd9d1ccbe
42 changed files with 5975 additions and 0 deletions

View file

@ -0,0 +1,193 @@
use pagetop::prelude::*;
pub mod util;
include_files!(mdbook);
pub struct MdBook;
impl PackageTrait for MdBook {
fn configure_service(&self, scfg: &mut service::web::ServiceConfig) {
include_files_service!(scfg, mdbook => "/mdbook");
}
}
impl MdBook {
pub fn mdbook_service(
scfg: &mut service::web::ServiceConfig,
mdbook_path: &'static str,
mdbook_map: &'static StaticResources,
) {
let path = mdbook_path.trim_end_matches('/');
scfg.service(
service::web::scope(path)
.route(
"{tail:.*html$}",
service::web::get()
.to(move |request: HttpRequest| mdbook_page(request, path, mdbook_map)),
)
.route(
"{tail:.*$}",
service::web::get()
.to(move |request: HttpRequest| mdbook_resource(request, path, mdbook_map)),
),
);
}
}
async fn mdbook_page(
request: HttpRequest,
mdbook_path: &'static str,
mdbook_map: &'static StaticResources,
) -> ResultPage<Markup, ErrorPage> {
let path_len = mdbook_path.len() + 1;
if let Some(content) = mdbook_map.get(&request.path()[path_len..]) {
if let Ok(html) = std::str::from_utf8(content.data) {
let lang = langid_for(extract("Lang", html).unwrap_or("")).unwrap_or(&FALLBACK_LANGID);
let title = match extract("Title", html) {
Some(title) => title,
_ => "Documentación",
};
let _print = matches!(extract("Print", html), Some("enabled"));
let _mathjax = matches!(extract("MathJax", html), Some("supported"));
let beginning = {
let separator = "<!-- mdBook -->";
match html.find(separator) {
Some(pos) => pos + separator.len(),
_ => 0,
}
};
Page::new(request)
.with_title(L10n::n(title))
.with_metadata("theme-color", "#ffffff")
.with_assets(AssetsOp::LangId(lang))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/css/variables.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/css/general.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/css/chrome.css",
)))
.with_assets(AssetsOp::AddStyleSheet(
StyleSheet::from("/mdbook/css/print.css").for_media(&TargetMedia::Print),
))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/FontAwesome/css/font-awesome.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/fonts/fonts.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/highlight.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/tomorrow-night.css",
)))
.with_assets(AssetsOp::AddStyleSheet(StyleSheet::from(
"/mdbook/ayu-highlight.css",
)))
.with_assets(AssetsOp::AddJavaScript(JavaScript::from(
"/mdbook/navigators.js",
)))
.with_body_skip_to("mdbook")
.with_component(Html::with(html! {
div id="mdbook" {
(PreEscaped(&html[beginning..]))
}
}))
.render()
} else {
Err(ErrorPage::NotFound(request))
}
} else {
Err(ErrorPage::NotFound(request))
}
}
async fn mdbook_resource(
request: HttpRequest,
mdbook_path: &'static str,
mdbook_map: &'static StaticResources,
) -> service::HttpResponse {
let path_len = mdbook_path.len() + 1;
// De https://github.com/kilork/actix-web-static-files/blob/master/src/resource_files.rs, ver
// funciones respond_to(), any_match() y none_match().
if let Some(file) = &mdbook_map.get(&request.path()[path_len..]) {
let etag = Some(service::http::header::EntityTag::new_strong(format!(
"{:x}:{:x}",
file.data.len(),
file.modified
)));
let precondition_failed = !any_match(etag.as_ref(), &request);
let not_modified = !none_match(etag.as_ref(), &request);
let mut resp = service::HttpResponse::build(service::http::StatusCode::OK);
resp.insert_header((service::http::header::CONTENT_TYPE, file.mime_type));
if let Some(etag) = etag {
resp.insert_header(service::http::header::ETag(etag));
}
if precondition_failed {
return ErrorPage::PreconditionFailed(request).error_response();
} else if not_modified {
return ErrorPage::NotModified(request).error_response();
}
resp.body(file.data)
} else {
ErrorPage::NotFound(request).error_response()
}
}
/// Returns true if `request` has no `If-Match` header or one which matches `etag`.
fn any_match(etag: Option<&service::http::header::EntityTag>, request: &HttpRequest) -> bool {
match request.get_header::<service::http::header::IfMatch>() {
None | Some(service::http::header::IfMatch::Any) => true,
Some(service::http::header::IfMatch::Items(ref items)) => {
if let Some(some_etag) = etag {
for item in items {
if item.strong_eq(some_etag) {
return true;
}
}
}
false
}
}
}
/// Returns true if `request` doesn't have an `If-None-Match` header matching `req`.
fn none_match(etag: Option<&service::http::header::EntityTag>, request: &HttpRequest) -> bool {
match request.get_header::<service::http::header::IfNoneMatch>() {
Some(service::http::header::IfNoneMatch::Any) => false,
Some(service::http::header::IfNoneMatch::Items(ref items)) => {
if let Some(some_etag) = etag {
for item in items {
if item.weak_eq(some_etag) {
return false;
}
}
}
true
}
None => true,
}
}
fn extract(attr: &'static str, from: &'static str) -> Option<&'static str> {
let search = join_string!("<!-- ", attr, ":");
if let Some(ini) = from.find(&search) {
let ini = ini + search.len() + 1;
if let Some(end) = from[ini..].find("-->").map(|i| i + ini) {
let end = end - 1;
return Some(&from[ini..end]);
}
}
None
}

View file

@ -0,0 +1,35 @@
use std::path::Path;
pub fn except_mdbook_common_resources(p: &Path) -> bool {
let common_resources: [&str; 28] = [
"css/chrome.css",
"css/general.css",
"css/print.css",
"css/variables.css",
"FontAwesome/css/font-awesome.css",
"FontAwesome/fonts/fontawesome-webfont.eot",
"FontAwesome/fonts/fontawesome-webfont.svg",
"FontAwesome/fonts/fontawesome-webfont.ttf",
"FontAwesome/fonts/fontawesome-webfont.woff",
"FontAwesome/fonts/fontawesome-webfont.woff2",
"FontAwesome/fonts/FontAwesome.ttf",
"fonts/fonts.css",
"fonts/OPEN-SANS-LICENSE.txt",
"fonts/open-sans-v17-all-charsets-300.woff2",
"fonts/open-sans-v17-all-charsets-300italic.woff2",
"fonts/open-sans-v17-all-charsets-600.woff2",
"fonts/open-sans-v17-all-charsets-600italic.woff2",
"fonts/open-sans-v17-all-charsets-700.woff2",
"fonts/open-sans-v17-all-charsets-700italic.woff2",
"fonts/open-sans-v17-all-charsets-800.woff2",
"fonts/open-sans-v17-all-charsets-800italic.woff2",
"fonts/open-sans-v17-all-charsets-italic.woff2",
"fonts/open-sans-v17-all-charsets-regular.woff2",
"fonts/SOURCE-CODE-PRO-LICENSE.txt",
"fonts/source-code-pro-v11-all-charsets-500.woff2",
"ayu-highlight.css",
"highlight.css",
"tomorrow-night.css",
];
!common_resources.iter().any(|f| p.ends_with(f))
}