summaryrefslogtreecommitdiff
path: root/docs/src/pages/en/reference/builtin-components.md
diff options
context:
space:
mode:
authorGravatar Jonathan Neal <jonathantneal@hotmail.com> 2022-02-07 13:39:53 -0500
committerGravatar GitHub <noreply@github.com> 2022-02-07 13:39:53 -0500
commita911d14eabe4f4f9080b59b1c292818ea2ca6123 (patch)
tree529fdda395eedc122955fd2851954d61554869b4 /docs/src/pages/en/reference/builtin-components.md
parent2bc91543ceeb5f3dd45e201bf75d79f186e85141 (diff)
downloadastro-a911d14eabe4f4f9080b59b1c292818ea2ca6123.tar.gz
astro-a911d14eabe4f4f9080b59b1c292818ea2ca6123.tar.zst
astro-a911d14eabe4f4f9080b59b1c292818ea2ca6123.zip
Remove docs from monorepo (#2517)
* Remove docs from monorepo * Update PULL_REQUEST_TEMPLATE.md * Update relative doc references with links or todo
Diffstat (limited to 'docs/src/pages/en/reference/builtin-components.md')
-rw-r--r--docs/src/pages/en/reference/builtin-components.md70
1 files changed, 0 insertions, 70 deletions
diff --git a/docs/src/pages/en/reference/builtin-components.md b/docs/src/pages/en/reference/builtin-components.md
deleted file mode 100644
index 76102bbaf..000000000
--- a/docs/src/pages/en/reference/builtin-components.md
+++ /dev/null
@@ -1,70 +0,0 @@
----
-layout: ~/layouts/MainLayout.astro
-title: Built-In Components
----
-
-Astro includes several builtin components for you to use in your projects. All builtin components are available via `import {} from 'astro/components';`.
-
-## `<Code />`
-
-```astro
----
-import { Code } from 'astro/components';
----
-<!-- Syntax highlight some JavaScript code. -->
-<Code code={`const foo = 'bar';`} lang="js" />
-<!-- Optional: customize your theme. -->
-<Code code={`const foo = 'bar';`} lang="js" theme="dark-plus" />
-<!-- Optional: Enable word wrapping. -->
-<Code code={`const foo = 'bar';`} lang="js" wrap />
-```
-
-This component provides syntax highlighting for code blocks at build time (no client-side JavaScript included). The component is powered internally by shiki and it supports all popular [themes](https://github.com/shikijs/shiki/blob/main/docs/themes.md) and [languages](https://github.com/shikijs/shiki/blob/main/docs/languages.md). Plus, you can add your custom themes and languages by passing them to `theme` and `lang` respectively.
-
-You can also use the `<Prism />` component for syntax highlighting powered by the [Prism](https://prismjs.com/) syntax highlighting library. This is the library that Astro's Markdown uses by default. However, we will be transitioning all usage over to `<Code>` as we move towards our v1.0 release.
-
-## `<Markdown />`
-
-```astro
----
-import { Markdown } from 'astro/components';
----
-<Markdown>
- # Markdown syntax is now supported! **Yay!**
-</Markdown>
-```
-
-See our [Markdown Guide](/en/guides/markdown-content) for more info.
-
-<!-- TODO: We should move some of the specific component info here. -->
-
-## `<Prism />`
-
-```astro
----
-import { Prism } from 'astro/components';
----
-<Prism lang="js" code={`const foo = 'bar';`} />
-```
-
-This component provides language-specific syntax highlighting for code blocks. Since this never changes in the client it makes sense to use an Astro component (it's equally reasonable to use a framework component for this kind of thing; Astro is server-only by default for all frameworks!).
-
-See the [list of languages supported by Prism](https://prismjs.com/#supported-languages) where you can find a language's corresponding alias. And, you can also display your Astro code blocks with lang="astro"!
-
-## `<Debug />`
-
-```astro
----
-import Debug from 'astro/debug';
-const serverObject = {
- a: 0,
- b: "string",
- c: {
- nested: "object"
- }
-}
----
-<Debug {serverObject} />
-```
-
-This component provides a way to inspect values on the clientside, without any JavaScript.