konevsa/typst
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add base() injection getter to the typst-docs Resolver (#3484)

Browse Source
This commit is contained in:
Jacob Hummer 2024-02-25 05:37:14 -06:00 committed by GitHub
parent ffd57bf56b
commit 010da18d99
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 66 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
crates/typst-docs/src/html.rs
View File

@ -307,7 +307,7 @@ impl<'a> Handler<'a> {
return Ok(link);
}
crate::link::resolve(link)
crate::link::resolve(link, self.resolver.base())
}
fn nesting(&self) -> usize {

60
crates/typst-docs/src/lib.rs
View File

@ -78,14 +78,15 @@ static FONTS: Lazy<(Prehashed<FontBook>, Vec<Font>)> = Lazy::new(|| {
/// Build documentation pages.
pub fn provide(resolver: &dyn Resolver) -> Vec<PageModel> {
vec![
markdown_page(resolver, "/docs/", "overview.md").with_route("/docs/"),
markdown_page(resolver, resolver.base(), "overview.md")
.with_route(resolver.base()),
tutorial_pages(resolver),
reference_pages(resolver),
guide_pages(resolver),
packages_page(resolver),
markdown_page(resolver, "/docs/", "changelog.md"),
markdown_page(resolver, "/docs/", "roadmap.md"),
markdown_page(resolver, "/docs/", "community.md"),
markdown_page(resolver, resolver.base(), "changelog.md"),
markdown_page(resolver, resolver.base(), "roadmap.md"),
markdown_page(resolver, resolver.base(), "community.md"),
]
}
@ -102,6 +103,9 @@ pub trait Resolver {
/// Determine the commits between two tags.
fn commits(&self, from: &str, to: &str) -> Vec<Commit>;
/// Get the base URL for the routes and links. This must end with a slash.
fn base(&self) -> &str;
}
/// Create a page from a markdown file.
@ -128,25 +132,39 @@ fn markdown_page(
/// Build the tutorial.
fn tutorial_pages(resolver: &dyn Resolver) -> PageModel {
let mut page = markdown_page(resolver, "/docs/", "tutorial/welcome.md");
let mut page = markdown_page(resolver, resolver.base(), "tutorial/welcome.md");
page.children = DOCS_DIR
.get_dir("tutorial")
.unwrap()
.files()
.filter(|file| file.path() != Path::new("tutorial/welcome.md"))
.map(|file| markdown_page(resolver, "/docs/tutorial/", file.path()))
.map(|file| {
markdown_page(resolver, &format!("{}tutorial/", resolver.base()), file.path())
})
.collect();
page
}
/// Build the reference.
fn reference_pages(resolver: &dyn Resolver) -> PageModel {
let mut page = markdown_page(resolver, "/docs/", "reference/welcome.md");
let mut page = markdown_page(resolver, resolver.base(), "reference/welcome.md");
page.children = vec![
markdown_page(resolver, "/docs/reference/", "reference/syntax.md")
markdown_page(
resolver,
&format!("{}reference/", resolver.base()),
"reference/syntax.md",
)
.with_part("Language"),
markdown_page(resolver, "/docs/reference/", "reference/styling.md"),
markdown_page(resolver, "/docs/reference/", "reference/scripting.md"),
markdown_page(
resolver,
&format!("{}reference/", resolver.base()),
"reference/styling.md",
),
markdown_page(
resolver,
&format!("{}reference/", resolver.base()),
"reference/scripting.md",
),
category_page(resolver, FOUNDATIONS).with_part("Library"),
category_page(resolver, MODEL),
category_page(resolver, TEXT),
@ -162,10 +180,18 @@ fn reference_pages(resolver: &dyn Resolver) -> PageModel {
/// Build the guides section.
fn guide_pages(resolver: &dyn Resolver) -> PageModel {
let mut page = markdown_page(resolver, "/docs/", "guides/welcome.md");
let mut page = markdown_page(resolver, resolver.base(), "guides/welcome.md");
page.children = vec![
markdown_page(resolver, "/docs/guides/", "guides/guide-for-latex-users.md"),
markdown_page(resolver, "/docs/guides/", "guides/page-setup.md"),
markdown_page(
resolver,
&format!("{}guides/", resolver.base()),
"guides/guide-for-latex-users.md",
),
markdown_page(
resolver,
&format!("{}guides/", resolver.base()),
"guides/page-setup.md",
),
];
page
}
@ -178,7 +204,7 @@ fn packages_page(resolver: &dyn Resolver) -> PageModel {
.contents_utf8()
.unwrap();
PageModel {
route: "/docs/packages/".into(),
route: eco_format!("{}packages/", resolver.base()),
title: "Packages".into(),
description: "Packages for Typst.".into(),
part: None,
@ -191,7 +217,7 @@ fn packages_page(resolver: &dyn Resolver) -> PageModel {
/// Create a page for a category.
#[track_caller]
fn category_page(resolver: &dyn Resolver, category: Category) -> PageModel {
let route = eco_format!("/docs/reference/{}/", category.name());
let route = eco_format!("{}reference/{}/", resolver.base(), category.name());
let mut children = vec![];
let mut items = vec![];
let mut shorthands = None;
@ -801,5 +827,9 @@ mod tests {
fn commits(&self, _: &str, _: &str) -> Vec<Commit> {
vec![]
}
fn base(&self) -> &str {
"/"
}
}
}

38
crates/typst-docs/src/link.rs
View File

@ -4,15 +4,15 @@ use typst::foundations::Func;
use crate::{get_module, GROUPS, LIBRARY};
/// Resolve an intra-doc link.
pub fn resolve(link: &str) -> StrResult<String> {
pub fn resolve(link: &str, base: &str) -> StrResult<String> {
if link.starts_with('#') || link.starts_with("http") {
return Ok(link.to_string());
}
let (head, tail) = split_link(link)?;
let mut route = match resolve_known(head) {
Some(route) => route.into(),
None => resolve_definition(head)?,
let mut route = match resolve_known(head, base) {
Some(route) => route,
None => resolve_definition(head, base)?,
};
if !tail.is_empty() {
@ -35,24 +35,24 @@ fn split_link(link: &str) -> StrResult<(&str, &str)> {
}
/// Resolve a `$` link head to a known destination.
fn resolve_known(head: &str) -> Option<&'static str> {
fn resolve_known(head: &str, base: &str) -> Option<String> {
Some(match head {
"$tutorial" => "/docs/tutorial",
"$reference" => "/docs/reference",
"$category" => "/docs/reference",
"$syntax" => "/docs/reference/syntax",
"$styling" => "/docs/reference/styling",
"$scripting" => "/docs/reference/scripting",
"$guides" => "/docs/guides",
"$packages" => "/docs/packages",
"$changelog" => "/docs/changelog",
"$community" => "/docs/community",
"$tutorial" => format!("{base}tutorial"),
"$reference" => format!("{base}reference"),
"$category" => format!("{base}reference"),
"$syntax" => format!("{base}reference/syntax"),
"$styling" => format!("{base}reference/styling"),
"$scripting" => format!("{base}reference/scripting"),
"$guides" => format!("{base}guides"),
"$packages" => format!("{base}packages"),
"$changelog" => format!("{base}changelog"),
"$community" => format!("{base}community"),
_ => return None,
})
}
/// Resolve a `$` link to a global definition.
fn resolve_definition(head: &str) -> StrResult<String> {
fn resolve_definition(head: &str, base: &str) -> StrResult<String> {
let mut parts = head.trim_start_matches('$').split('.').peekable();
let mut focus = &LIBRARY.global;
let mut category = None;
@ -76,8 +76,8 @@ fn resolve_definition(head: &str) -> StrResult<String> {
group.category == category.name() && group.filter.iter().any(|func| func == name)
}) {
let mut route = format!(
"/docs/reference/{}/{}/#functions-{}",
group.category, group.name, name
"{}reference/{}/{}/#functions-{}",
base, group.category, group.name, name
);
if let Some(param) = parts.next() {
route.push('-');
@ -86,7 +86,7 @@ fn resolve_definition(head: &str) -> StrResult<String> {
return Ok(route);
}
let mut route = format!("/docs/reference/{}/{name}/", category.name());
let mut route = format!("{}reference/{}/{name}/", base, category.name());
if let Some(next) = parts.next() {
if value.field(next).is_ok() {
route.push_str("#definitions-");