Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

improve adapters page visibility #8575

Merged
merged 4 commits into from
Jun 19, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion src/content/docs/en/basics/rendering-modes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import RecipeLinks from '~/components/RecipeLinks.astro';
import ReadMore from '~/components/ReadMore.astro';

Your Astro project code must be **rendered** to HTML in order to be displayed on the web.

Expand Down Expand Up @@ -39,6 +40,8 @@ With [an SSR adapter](/en/guides/server-side-rendering/), Astro's other two outp

Since they are generated per visit, these routes can be customized for each viewer. For example, a page rendered on demand can show a logged-in user their account information or display freshly updated data without requiring a full-site rebuild. On-demand rendering on the server at request time is also known as **server-side rendering (SSR)**.

<ReadMore>Read more about [features available to you with on-demand rendering and an adapter](/en/guides/server-side-rendering/#on-demand-rendering-features), such as cookies, Response and Request objects, HTML streaming, and more.</ReadMore>

[Consider enabling `server` or `hybrid` mode](/en/guides/server-side-rendering/#enable-on-demand-server-rendering) in your Astro project if you need the following:

- **API endpoints**: Create specific pages that function as API endpoints for tasks like database access, authentication, and authorization while keeping sensitive data hidden from the client.
Expand All @@ -50,5 +53,5 @@ Since they are generated per visit, these routes can be customized for each view
Both `server` and `hybrid` output modes allow you to include [Astro islands](/en/concepts/islands/) for interactivity (or even entire embedded client-side rendered apps!) in your choice of [UI frameworks](/en/guides/framework-components/). With [middleware](/en/guides/middleware/) and Astro's [View Transitions API](/en/guides/view-transitions/) for animations and preserving state across route navigations, even highly interactive apps are possible.

:::tip
On demand server-rendering in Astro provides a true app experience without the JavaScript overhead of a client-side, single-page application.
On demand server-rendering in Astro, especially when combined with [view transitions](/en/guides/view-transitions/), provides a true app experience without the JavaScript overhead of a client-side, single-page application.
:::
5 changes: 3 additions & 2 deletions src/content/docs/en/guides/integrations-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,12 @@
import { Steps } from '@astrojs/starlight/components'


**Astro integrations** add new functionality and behaviors for your project with only a few lines of code. You can write a custom integration yourself, use an official integration, or use integrations built by the community.
**Astro integrations** add new functionality and behaviors for your project with only a few lines of code. You can use an official integration, [integrations built by the community](#finding-more-integrations) or even [build a custom integration yourself](#building-your-own-integration).

Integrations can…

- Unlock React, Vue, Svelte, Solid, and other popular UI frameworks.
- Unlock React, Vue, Svelte, Solid, and other popular UI frameworks with a [renderer](en/guides/framework-components).

Check failure on line 15 in src/content/docs/en/guides/integrations-guide.mdx

View workflow job for this annotation

GitHub Actions / Check Links

Broken page link in src/content/docs/en/guides/integrations-guide.mdx, line 15: en/guides/framework-components
- Enable on-demand rendering with an [SSR adapter](/en/guides/server-side-rendering/).
- Integrate tools like Tailwind, and Partytown with a few lines of code.
- Add new features to your project, like automatic sitemap generation.
- Write custom code that hooks into the build process, dev server, and more.
Expand Down
1 change: 1 addition & 0 deletions src/util/isSubPage.ts
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ const categoryIndex: Partial<Record<ReturnType<typeof getPageCategory>, string>>
const parentIndex: Record<string, string> = {
'editor-setup': 'install-and-setup',
'guides/dev-toolbar': 'install-and-setup',
'guides/server-side-rendering':'guides/integrations-guide'
};

/** Slugs of pages that appear at the top level even though they are in a sub-category. */
Expand Down
Loading