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

[reorg] New sidebar! #8239

Merged
merged 43 commits into from
Jun 14, 2024
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
387d7b2
initial sidebar reorg + new installation and setup page
sarah11918 May 9, 2024
a82caf4
put back manual file, to make other languages happy
sarah11918 May 9, 2024
3ace2ff
un-rename content file, to make other languages happy
sarah11918 May 9, 2024
670956a
Discard changes to src/content/docs/en/install/manual.mdx
sarah11918 May 9, 2024
7eeba48
Merge branch 'main' into sssidebar
TheOtterlord May 30, 2024
46001b9
Merge branch 'main' into sssidebar
sarah11918 May 31, 2024
4cfe9e7
Apply suggestions from code review
sarah11918 May 31, 2024
0677783
Add recipes to community section, point to tut extensions, fix links
sarah11918 May 31, 2024
92e98da
Bring back old `pnpm-lock.yaml`
yanthomasdev Jun 7, 2024
d0c2341
Merge branch 'main' into sssidebar
sarah11918 Jun 7, 2024
b211827
resolve link issue in content guide
sarah11918 Jun 7, 2024
3a4d5e0
update all install links
sarah11918 Jun 7, 2024
7958160
hunt down rest of anchor links
sarah11918 Jun 7, 2024
a8896af
vercel redirects for pages that will be deleted
sarah11918 Jun 7, 2024
66ea679
more vercel redirects
sarah11918 Jun 7, 2024
5e75c79
comma format json
sarah11918 Jun 7, 2024
35e9133
update to capital casing everywhere
sarah11918 Jun 10, 2024
fad3cd4
move old install pages to old translations
sarah11918 Jun 10, 2024
22604b1
Move all the install folders into old translations to check links
sarah11918 Jun 10, 2024
338da95
move all recipes.mdx to old translations folder to check for links
sarah11918 Jun 10, 2024
4e444ba
Merge branch 'main' into sssidebar
delucis Jun 12, 2024
8d0781e
Fix lockfile
delucis Jun 12, 2024
e48a5c4
Discard changes to pnpm-lock.yaml
delucis Jun 12, 2024
d25a7d0
fix a bunch of links
sarah11918 Jun 12, 2024
73a32a0
fix remaining 404s
sarah11918 Jun 12, 2024
dc58339
fix more non-localized slugs
sarah11918 Jun 12, 2024
d864c5f
fix last localized slugs
sarah11918 Jun 12, 2024
0c03802
Merge branch 'main' into sssidebar
sarah11918 Jun 12, 2024
580796e
Fix `isSubPage` logic for new structure
delucis Jun 12, 2024
65393cc
Merge branch 'main' into sssidebar
sarah11918 Jun 13, 2024
a3c0922
proper capital case
sarah11918 Jun 13, 2024
0f0d857
proper capital case
sarah11918 Jun 13, 2024
4b0a3c7
tutorial entry text
sarah11918 Jun 13, 2024
ecc9d1e
env variables in in sidebar
sarah11918 Jun 13, 2024
6ad79b1
env variables no longer needs special sidebar highlighting
sarah11918 Jun 13, 2024
2025fc8
found a sidebar home for TS and EV; Aliases no longer its own page
sarah11918 Jun 13, 2024
339ecc9
add two pages back into sidebar nav
sarah11918 Jun 13, 2024
7d37038
move alias page to `imports.mdx` (#8515)
kevinzunigacuellar Jun 13, 2024
ceff8ad
Merge branch 'main' into sssidebar
sarah11918 Jun 13, 2024
f8eb3f3
localized slugs for alias content
sarah11918 Jun 13, 2024
9664106
all languages!
sarah11918 Jun 14, 2024
91a18fe
Merge branch 'main' into sssidebar
sarah11918 Jun 14, 2024
197efb5
redirect test with anchor link
sarah11918 Jun 14, 2024
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
6 changes: 2 additions & 4 deletions src/content/docs/en/community-resources/content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,9 @@ Check out the following courses and tutorials to learn more about Astro.

## Recipes and Guides

See guided examples of adding features to your Astro project, submitted by our community members!
[Astro's official recipes](/en/recipes/) are short, focused how-to guides that walk a reader through completing a working example of a specific task. Recipes are a great way to add new features or behavior to your Astro project by following step-by-step instructions!
sarah11918 marked this conversation as resolved.
Show resolved Hide resolved

[Astro recipes](/en/recipes/) are typically short, focused how-to guides that walk a reader through completing a working example of a specific task. Recipes are a great way to add new features or behavior to your Astro project by following step-by-step instructions!

Other guides might explain concepts related to an area of content, such as using images or working with MDX.
See guided examples below of adding features to your Astro project or understanding working with Astro concepts, submitted by our community members!

:::tip[Add your own!]
Have you written a recipe for Astro? [Edit this page](https://github.com/withastro/docs/edit/main/src/content/docs/en/community-resources/content.mdx) and add your link in the appropriate section!
Expand Down
10 changes: 7 additions & 3 deletions src/content/docs/en/guides/content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Create and write a new `.md` file in your code editor or bring in an existing fi
<ReadMore>Learn more about [writing Markdown content in Astro](/en/guides/markdown-content/).</ReadMore>

### MDX Authoring
If you add the MDX integration to your project, you can also write content using `.mdx` files, which let you include JavaScript expressions and custom components within your Markdown. This includes both static [Astro components](/en/basics/astro-components/) and interactive [framework components](/en/guides/framework-components/). Add UI elements such as a banner or an interactive carousel right in your text to turn your content into full-fledged web pages.
If you add the [Astro MDX integration](/en/guides/integrations-guide/mdx/) to your project, you can also write content using `.mdx` files, which let you include JavaScript expressions and custom components within your Markdown. This includes both static [Astro components](/en/basics/astro-components/) and interactive [framework components](/en/guides/framework-components/). Add UI elements such as a banner or an interactive carousel right in your text to turn your content into full-fledged web pages.

Write and edit `.mdx` files directly in your code editor, alongside your project files.

Expand All @@ -39,20 +39,24 @@ Write and edit `.mdx` files directly in your code editor, alongside your project

Write blog posts in your existing Content Management System (CMS) such as Storyblok, WordPress, or Contentful. Some CMSes, like Storyblok, provide an official [Astro integration](https://www.storyblok.com/mp/announcing-storyblok-astro). Others expose a JavaScript SDK that Astro pages can use to [fetch your remote content](/en/guides/data-fetching/#fetch-from-a-headless-cms).

<ReadMore>Explore our collection of [CMS guides](/en/guides/cms/) and [Astro CMS integrations](https://astro.build/integrations/?search=cms) for a wide selection of resources.</ReadMore>

## Managing content pages

Markdown and MDX files that live in your `src/pages` directory will automatically generate pages on your site using Astro's [file-based routing](/en/guides/routing/), built at a URL corresponding to the post's file path.

You can also choose to keep your Markdown and MDX files outside of the `src/pages` directory, and instead [import their content](/en/guides/markdown-content/#importing-markdown) into `.astro` pages.

Astro's own [content collections](/en/guides/content-collections/) provide a powerful, type-safe way to work with your Markdown, MDX, or Markdoc content.

If you're writing your content in a CMS, you can fetch your posts and use [dynamic routing](/en/guides/routing/#dynamic-routes) to use one `.astro` file to generate a route for each post. In Astro's default static mode, these routes are generated at build time. If you opt-in to [SSR mode](/en/guides/server-side-rendering/), you respond to a request at runtime and fetch the content on demand.

## Showcasing your content

To build common features to organize and display your content, such as a blog archive or a page for each blog tag, Astro allows you to [fetch filenames and metadata](/en/reference/api-reference/#astroglob) from your Markdown and MDX frontmatter and use these to generate page content and routes.
To build common features to organize and display your content, such as a blog archive or a page for each blog tag, Astro allows you to [fetch filenames and metadata](/en/reference/api-reference/#astroglob) from your Markdown and MDX frontmatter or use [content collection helper utilities](/en/guides/content-collections/#querying-collections) to query your entries and generate page content and routes.

<RecipeLinks slugs={["en/guides/rss"]} />

## Community Integrations

In addition to the official [`@astrojs/mdx`](/en/guides/integrations-guide/mdx/) integration, there are several third-party [community integrations](https://astro.build/integrations/?search=&categories%5B%5D=css%2Bui) for working with content in your Astro project.
In addition to the official [`@astrojs/mdx`](/en/guides/integrations-guide/mdx/) and [`@astrojs/markdoc`](/en/guides/integrations-guide/markdoc/) integrations, there are several third-party [community integrations](https://astro.build/integrations/?search=content) for working with content in your Astro project.
Loading
Loading