From 78b5bde14c167b289a20b479d4fa4790eb9165aa Mon Sep 17 00:00:00 2001 From: Matthew Phillips Date: Mon, 16 Aug 2021 16:43:06 -0400 Subject: Astro.resolve (#1085) * add: Astro.resolve * Add docs and tests for Astro.resolve * Add warnings when using string literals * Prevent windows errors * Adds a changeset * Use the astro logger to log the warning * Use the .js extension * Dont warn for data urls * Rename nonRelative and better match Co-authored-by: Jonathan Neal --- docs/src/pages/reference/api-reference.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'docs/src/pages/reference/api-reference.md') diff --git a/docs/src/pages/reference/api-reference.md b/docs/src/pages/reference/api-reference.md index 148241691..2f73cb30c 100644 --- a/docs/src/pages/reference/api-reference.md +++ b/docs/src/pages/reference/api-reference.md @@ -64,6 +64,30 @@ const data = Astro.fetchContent('../pages/post/*.md'); // returns an array of po `Astro.site` returns a `URL` made from `buildOptions.site` in your Astro config. If undefined, this will return a URL generated from `localhost`. +```astro +--- +const path = Astro.site.pathname; +--- + +

Welcome to {path}

+``` + +### `Astro.resolve()` + +`Astro.resolve()` helps with creating URLs relative to the current Astro file, allowing you to reference files within your `src/` folder. + +Astro *does not* resolve relative links within HTML, such as images: + +```html + +``` + +The above will be sent to the browser as-is and the browser will resolve it relative to the current __page__. If you want it to be resolved relative to the .astro file you are working in, use `Astro.resolve`: + +```astro + +``` + ## `getStaticPaths()` If a page uses dynamic params in the filename, that component will need to export a `getStaticPaths()` function. -- cgit v1.2.3