Añade guía de mdBook como referencia para PageTop

website/src/main.rs

@@ -1,8 +1,14 @@
 use pagetop::prelude::*;
 
+mod mdbook;
+
 struct PageTopWebSite;
 
-impl AppTrait for PageTopWebSite {}
+impl AppTrait for PageTopWebSite {
+    fn enable_modules(&self) -> Vec<&'static dyn ModuleTrait> {
+        vec![&mdbook::MdBook]
+    }
+}
 
 #[actix_web::main]
 async fn main() -> std::io::Result<()> {

website/src/mdbook.rs

@@ -0,0 +1,153 @@
+use actix_web::ResponseError;
+use pagetop::prelude::*;
+
+use static_files::Resource;
+
+use std::collections::HashMap;
+
+include!(concat!(env!("OUT_DIR"), "/mdbook.rs"));
+
+static MDBOOK: LazyStatic<HashMap<&'static str, Resource>> = LazyStatic::new(||
+    generate()
+);
+
+pub const MODULE_MDBOOK: &str = "pagetop::website::module::mdbook";
+
+pub struct MdBook;
+
+impl ModuleTrait for MdBook {
+    fn handler(&self) -> &'static str {
+        MODULE_MDBOOK
+    }
+
+    fn configure_service(&self, cfg: &mut app::web::ServiceConfig) {
+        cfg.service(
+            app::web::scope("/doc")
+                .route("{tail:.*html$}", app::web::get().to(mdbook_page))
+                .route("{tail:.*$}", app::web::get().to(mdbook_resource))
+        );
+    }
+}
+
+async fn mdbook_page(request: app::HttpRequest) -> ResultPage<Markup, FatalError> {
+    // Remove initial "/doc/" from path:
+    let path = &request.path()[5..];
+
+    if let Some(content) = MDBOOK.get(path) {
+        if let Ok(html) = std::str::from_utf8(content.data) {
+            let mut page = Page::new().with_title("Documentación");
+            page.context()
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/css/variables.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/css/general.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/css/chrome.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(
+                        StyleSheet::located("/doc/css/print.css").for_media(TargetMedia::Print)
+                    )
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/FontAwesome/css/font-awesome.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/fonts/fonts.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/highlight.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/tomorrow-night.css"))
+                ))
+                .alter(InContextOp::StyleSheet(
+                    AssetsOp::<StyleSheet>::Add(StyleSheet::located("/doc/ayu-highlight.css"))
+                ));
+            page.add_to(
+                    "region-content",
+                    Container::new()
+                        .with_id("mdbook")
+                        .with_component(Html::with(html! { (PreEscaped(html)) }))
+                )
+                .render()
+        } else {
+            Err(FatalError::NotFound)
+        }
+    } else {
+        Err(FatalError::NotFound)
+    }
+}
+
+async fn mdbook_resource(request: app::HttpRequest) -> app::HttpResponse {
+    // Remove initial "/doc/" from path:
+    let path = &request.path()[5..];
+
+    // From https://github.com/kilork/actix-web-static-files/blob/master/src/resource_files.rs, see
+    // functions respond_to(), any_match() and none_match().
+    if let Some(file) = &MDBOOK.get(path) {
+        let etag = Some(app::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 = app::HttpResponse::build(app::http::StatusCode::OK);
+        resp.insert_header((app::http::header::CONTENT_TYPE, file.mime_type));
+
+        if let Some(etag) = etag {
+            resp.insert_header(app::http::header::ETag(etag));
+        }
+
+        if precondition_failed {
+            return FatalError::PreconditionFailed.error_response();
+        } else if not_modified {
+            return FatalError::NotModified.error_response();
+        }
+
+        resp.body(file.data)
+    } else {
+        FatalError::NotFound.error_response()
+    }
+}
+
+/// Returns true if `request` has no `If-Match` header or one which matches `etag`.
+fn any_match(etag: Option<&app::http::header::EntityTag>, request: &app::HttpRequest) -> bool {
+    match request.get_header::<app::http::header::IfMatch>() {
+        None | Some(app::http::header::IfMatch::Any) => true,
+        Some(app::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<&app::http::header::EntityTag>, request: &app::HttpRequest) -> bool {
+    match request.get_header::<app::http::header::IfNoneMatch>() {
+        Some(app::http::header::IfNoneMatch::Any) => false,
+        Some(app::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,
+    }
+}