diff options
| author |  Fred K. Schott <fkschott@gmail.com>
| 2021-07-15 14:13:35 -0400 |
|---|---|---|
| committer |  GitHub <noreply@github.com>
| 2021-07-15 14:13:35 -0400 |
| commit | 166e22bdf35b9751dc42f5cc6cb27a99b077df93 (patch) | |
| tree | e8643360c2250dda82ebf95b62281978547d5188 /docs/core-concepts/astro-pages.md | |
| parent | fb8bf7ec43f7b09348c12d5ff9f81131c70ef5e9 (diff) | |
| download | astro-166e22bdf35b9751dc42f5cc6cb27a99b077df93.tar.gz astro-166e22bdf35b9751dc42f5cc6cb27a99b077df93.tar.zst astro-166e22bdf35b9751dc42f5cc6cb27a99b077df93.zip | |
merge in docs site (#705)
Diffstat (limited to 'docs/core-concepts/astro-pages.md')
| -rw-r--r-- | docs/core-concepts/astro-pages.md | 60 |
1 files changed, 0 insertions, 60 deletions
diff --git a/docs/core-concepts/astro-pages.md b/docs/core-concepts/astro-pages.md deleted file mode 100644 index 0aedca4bf..000000000 --- a/docs/core-concepts/astro-pages.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -layout: ~/layouts/Main.astro -title: Pages ---- - -**Pages** are a special type of [Astro Component](/core-concepts/astro-components) that handle routing, data loading, and templating for each page of your website. You can think of them like any other Astro component, just with extra responsibilities. - -Astro also supports Markdown for content-heavy pages, like blog posts and documentation. See [Markdown Content](/guides/markdown-content) for more information on writing pages with Markdown. - -## File-based Routing - -Astro uses Pages to do something called **file-based routing.** Every file in your `src/pages` directory becomes a page on your site, using the file name to decide the final route. - -Astro Components (`.astro`) and Markdown Files (`.md`) are the only supported formats for pages. Other page types (like a `.jsx` React component) are not supported, but you can use anything as a UI component inside of an `.astro` page to achieve a similar result. - -``` -src/pages/index.astro -> mysite.com/ -src/pages/about.astro -> mysite.com/about -src/pages/about/index.astro -> mysite.com/about -src/pages/about/me.astro -> mysite.com/about/me -src/pages/posts/1.md -> mysite.com/posts/1 -``` - -## Page Templating - -All Astro components are responsible for returning HTML. Astro Pages return HTML as well, but have the unique responsibility of returning a full `<html>...</html>` page response, including `<head>` ([MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/head)) and `<body>` ([MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body)). - -`<!doctype html>` is optional, and will be added automatically. - -```astro ---- -// Example: HTML page skeleton ---- -<!doctype html> -<html> - <head> - <title>Document title</title> - </head> - <body> - <h1>Hello, world!</h1> - </body> -</html> -``` - -## Data Loading - -Astro pages can fetch data to help generate your pages. Astro provides two different tools to pages to help you do this: **fetch()** and **top-level await.** - -📚 Read our [full guide](/guides/data-fetching) on data-fetching to learn more. - -```astro ---- -// Example: Astro component scripts run at build time -const response = await fetch('http://example.com/movies.json'); -const data = await response.json(); -console.log(data); ---- -<!-- Output the result to the page --> -<div>{JSON.stringify(data)}</div> -``` |