summaryrefslogtreecommitdiff
path: root/docs/src/pages/reference (follow)
AgeCommit message (Collapse)AuthorFilesLines
2022-01-03Docs/move-english-docs-to-"en"-folder (#2268)Gravatar Caleb Jasik 5-744/+0
* Move english pages under `/en` and fix broken links hopefully * Add meta refresh tags for `/` to `/en/` url moves + make `/index.astro` work without js * update languageselect for new en format Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-12-22Update Configuration Reference documentation (#2239)Gravatar Jonathan Neal 1-16/+72
* Update Configuration Reference documentation * Update docs/src/pages/reference/configuration-reference.md Co-authored-by: Peter Singh <drgaud@hotmail.com> * nit: update initial config example * nit: update initial config example * clarify pages option * nit: update how the configuration reference is organized Co-authored-by: Peter Singh <drgaud@hotmail.com>
2021-11-29docs: update some Snowpack references to Vite (#2035)Gravatar Ludovico Fischer 1-1/+1
* docs: update some Snowpack references to Vite Vite has replaced Snowpack in 0.21. * Apply suggestions from code review Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com> Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>
2021-11-23update repo URL (#1994)Gravatar Fred K. Schott 2-2/+2
2021-11-22docs: update link to AstroUserConfig type definitions (#1961)Gravatar Masataka Yakura 1-1/+1
* docs: update link to AstroUserConfig type definitions addresses https://github.com/snowpackjs/astro/issues/1960 * docs: update link to `@types/astro.ts` to refer to the `latest` branch. 22b73e652d changes the branch to `main`, this changes back to use `latest`.
2021-11-20(docs) Fix config reference link (#1946)Gravatar JuanM04 1-1/+1
2021-11-19Docs codeblock fixes (#1931)Gravatar Jonathan Neal 1-2/+2
* Update astro & markdown code blocks for consistency * Add 'JSX in Frontmatter' note to Migration Guide * code block improvements
2021-11-19Doc improvements (#1929)Gravatar Jonathan Neal 1-3/+3
* Update astro & markdown code blocks for consistency * Add 'JSX in Frontmatter' note to Migration Guide
2021-11-01Fixed typo in API Reference. (#1697)Gravatar Isaac McFadyen 1-1/+1
Added missing curly brace ('}') to API Reference docs.
2021-10-29🚀 Astro Next (0.21.0) (#1406)Gravatar Drew Powers 2-25/+27
* make astro-root uids unique * Move Astro to Vite * Update tests * More test improvements * fred fixes * Update compiler, improve tests * Fix runtime, improve code frame * Add Markdown support * Tycho fixes * Fred fixes part 2 * Throw Error for WIP Features * Improve testing suite * Allow users to pass config to Vite * Fix npm install (#1407) * Automate publish on merge (#1408) * Add NPM_TOKEN to publish script (#1409) * Create .npmrc * Clean up astro deps (#1411) * Use new renderers (#1412) * feat: update compiler (#1421) * Try mocha/chai test runners (#1418) * Try mocha/chai test runners * Disable failing smoke test for now Will revert when next can build docs * Enable mocha in parallel mode * Remove warning * Update docs * Fix Windows bug * Fix internal imports * Fix styles * Fix CI release on merge to next (#1427) * Fix logger locale parsing (#1439) * fix(logger): locale parsing * Fixed issue of compiler crash when "c" locale was encountered * Return default locale if parsed locale is less than 2 chars long * chore: add changeset * Apply changes from #1387 * Add back in support for children (#1486) * Add back in support for children * Be more careful * Enables most slot tests (#1494) * Enables most slot tests * Use spreadAttributes * Add hydration to Solid renderer (#1479) (#1495) * feat: add hydration to Solid renderer * fix: intersection observer, move script to the end Co-authored-by: Ryan Carniato <ryansolid@gmail.com> * [next] support Astro.slots API (#1516) * [next] Support for custom elements (#1528) * [next] Support for custom elements * Fix eslint errors * eslint again * [next] Fix Astro.fetchContent (#1480) * fix Astro.fetchContent * fix(fetchContent): cast type Co-authored-by: Nate Moore <nate@skypack.dev> * Move hydration to the compiler (#1547) * Move hydration to the compiler * Move extracting url, export to util fn * Brings back astro-dynamic tests (#1548) * Implements top-level Astro + Astro.resolve (#1556) * Implements top-level Astro + Astro.resolve * Fix linting * [next] Update renderers (#1509) * chore: update vite * fix(renderers): point renderers to resolved server/client entrypoints * Chore: Enable more tests with new compiler changes (#1558) * [Next] `fetch` support (#1563) * fix: polyfill fetch in every ssr scenario * test(fetch): update fetch tests * docs: update data fetching guide to remove caveats about `fetch` and isomorphic usage * refactor: update regex for clarity * Restructure (#1569) * Upgrade to @astrojs/compiler 0.2.0 (#1584) * Use Vite fork (#1585) * Use Vite fork * Fix linting * Move Vite to vendor/ and add a license * Fix linting * Include the dist folder * Update files config * Markdown compilation (#1593) * Markdown compilation * remove debugger * Gets lit hydration working (#1595) * Gets Astro.fetchContent compilation to work (#1596) * Gets Astro.fetchContent compilation to work This fixes Astro.fetchContent so that we handle esbuild transforming the name of the nested Astro call. * Remove debugging * Update the tests * Remove another debugger * Update Vite to latest (#1597) * Add Prism syntax highlighting (#1598) * Scoped styles with markdown (#1599) * Bugfix: fix getStaticPaths() cache miss (#1602) * Fix build order (#1609) * Bugfix: restore build to get all paths earlier, when build. Same as main. * Also re-add timings * [next] blog example fully working (#1610) * Add environment variables docs (Closes #873) (#1587) * Added environment variables docs (Closes #873) * Fixed prefix * Remove numbered comments (#1611) * Chore: remove numbered comments * Clean up block comments * comment style fixes (#1614) * [next] Upgrade compiler (#1619) * [next] Upgrade compiler * Upgrade to latest compiler * Fix the path to global css * Removed debugger * feat: add fragment support to vite-plugin-astro (#1600) * [next] fix `.tsx` handling (#1620) * fix: support tsx in JSX plugin * fix: preserve JSX via esbuild, only use Babel for JSX compilation * fix: handle upcoming Vite API for `ssr` flag * [next] Add CSS preprocessing (#1589) * Add concept for style support in Astro * Update style preprocessor to use new compiler * fix: massage preprocessStyle type * fix: @astrojs/compiler types Co-authored-by: Nate Moore <nate@skypack.dev> * fix issues in blog-multiple-authors (#1621) * Move Sass to deps (#1622) * Update renderer API for Vite (#1623) * Update renderer API for Vite * Fix lit-element tests * Clean up comments * Throw friendly error if renderer provides viteConfig in a bad format * Fix changesets (#1628) * Remove cheerio scanning from build stats (#1629) * Minor change to jsxTransformOptions, update Renderer API docs (#1630) * [next] docs example fully working (#1627) * [next] docs example fully working * Upgrade compiler to unlock docs * Add `class:list` directive (#1612) * Add support for class:list directive The `class:list` directive serializes an expression of css class names. For React components, `className:list` is also supported. * Remove `className` support and React tests * Add tests for the absence of omitted classes * fix: `define:vars` scoping for styles (#1632) * feat: fix Debug component (#1633) * [next] Fix `<Markdown>` component (#1631) * fix: cleanup issues with <Markdown> component * fix: fix `content` usage with Markdown * [next] Fix `<Code>` component (#1635) * fix: enable Code component * test: update expect to chai format * Fixes solid (#1634) * Fixes solid * Rename the test * Rebase with next * Skip solid test for now * Add support for markdown plugins (#1650) * Fix broken next release (#1652) * Prevent passing to Svelte components * Prevent passing class to Vue components * Add CSS injection, fix portfolio example (#1648) * Fix portfolio example * Add .pcss extension * Update load ssr opts * Update packages/astro/src/runtime/server/index.ts Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com> Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com> Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com> * Fixes external HMR (#1654) * Upgrade compiler version (#1655) Fixes docs and blog examples * Resolve renderers relative to the projectRoot (#1659) * Template fixes (#1656) * fix: dedupe hashes for identical islands (#1660) * fix: scope `define:vars` to `:root` for `<style global>` (#1663) * chore: update compiler to latest (#1664) * [next] fix island hydration inside of `<Markdown>` (#1665) * fix: create rehype plugin to smooth over island hydration bugs * refactor: remove debug code * chore: explain need for `rehypeIslands` * Bugfix: renderer-lit missing files on npm (#1669) * Force Vite to rebuild dependencies (#1670) * [next] Add `preact/compat` renderer (#1668) * feat: add preact/compat entry for `@astrojs/renderer-preact` * Update index.js * Bugfix: plugin-astro-fetch tries to append node-fetch to node-fetch (#1671) * Fix Vite race condition (#1674) * Fix with-nanostore deps (#1675) Adds missing Solid renderer * [next] Fix `resolveDependency` on Windows (#1666) * fix: Windows issue with resolveDependency util * chore: add comment * Update CONTRIBUTING.md (#1677) * Prevent scanning a user's deps (#1678) * Prevent scanning a user's deps * Remove unused things * remove unused util * Adding a changeset for the remark plugin * Config changes needed for stater template (#1680) This does 2 things: 1. Adds prismjs as a dep. 2. Adds shiki as an external. * Next bugs (#1681) * fix(#1679): hoisted <script> rendering * fix(#1679): do not print global for styles, but do for scripts * fix: update ObjectSet implementation * fix: dedupe elements in sets * [next] update compiler (#1683) * chore: update compiler * chore: update compiler (again) * Fix Astro HMR bottleneck (#1684) * Bugfix: JSX renderers can be declared in any order (#1686) * chore: update compiler (#1690) * Exclude lit-server from being optimized (#1691) This should get the lit example working from `npm`. * fix: exclude all renderer server entrypoints (#1692) * chore: update compiler (#1705) * fix: do not crash when Markdown has no content (#1702) * feat: improve support for third-party React packages (#1701) * Remove prism warning when no language is provided (#1703) * Remove prism warning when no language is provided * Add the plaintext language instead * retry deploy * chore: enter prerelease mode under `next` (#1707) * Updates to the changesets (#1708) * Updates to the changesets * Adds a changeset for astro-prism Co-authored-by: Fred K. Schott <fkschott@gmail.com> Co-authored-by: Nate Moore <nate@skypack.dev> Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com> Co-authored-by: Pranav Karawale <52596591+obnoxiousnerd@users.noreply.github.com> Co-authored-by: Matthew Phillips <matthew@skypack.dev> Co-authored-by: Matthew Phillips <matthew@matthewphillips.info> Co-authored-by: Ryan Carniato <ryansolid@gmail.com> Co-authored-by: AsyncBanana <58297401+AsyncBanana@users.noreply.github.com> Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com>
2021-10-12docs: fix knownEntryPoints and add async renderToStaticMarkup example (#1489)Gravatar Brandon 1-3/+16
2021-10-11[ci] yarn formatGravatar matthewp 1-1/+1
2021-10-11Adds the astro check command (#1410)Gravatar Matthew Phillips 1-0/+6
* Adds the `astro check` command. This adds `astro check`, which runs type checking (and general error checking) on Astro projects. * print the number of errors found * Adds a changeset * Add cli docs * Upgrade the language server version * Prevent linting the console.logs
2021-09-15Expose slots to components (#1368)Gravatar Jonathan Neal 1-0/+11
* Expose slots to components via Astro.slots * test: Add Astro.slots API tests * docs: Document Astro.slots API * docs: Duplicate Astro.slots documentation to other api-reference markdown * Update proposal to use booleans, based upon RFC feedback * update implementation & tests based on request * changeset
2021-09-03[ci] yarn formatGravatar FredKSchott 1-2/+0
2021-09-03Add new <Code> component, to succeed <Prism> (#1208)Gravatar Fred K. Schott 1-0/+20
* add code component * Update packages/astro/components/Debug.astro Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz> * Update packages/astro/components/Debug.astro Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz> * fix format in debug component * remove Debug changes * add wrap support * add props docs * update default theme Co-authored-by: Peter Singh <drgaud@hotmail.com> Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-09-01Debug component importation (#1289)Gravatar raph_5 1-1/+1
with import { Debug } from 'astro/debug' : Debug = undefined Error: Unable to render Debug because it is undefined! Did you forget to import the component or is it possible there is a typo?
2021-08-31Delete docs text about removed Collections API (#1286)Gravatar Mani Gandham 1-1/+1
2021-08-31Remove reference/link to Collections (#1277)Gravatar Tim Chesney 1-1/+1
* Remove reference/link to Collections Remove line that refers to 'Core Concepts - Collections' given this is now deprecated. * Added reference to routing Tested link as working in local build.
2021-08-31Remove caveat about `Astro.request` not being passed to components. (#1276)Gravatar Caleb Jasik 1-2/+0
2021-08-30Alphabetize API doc (#1270)Gravatar Drew Powers 1-12/+12
2021-08-29Include lang="xxxx" in Prism component example (#1264)Gravatar Sarah Rainsberger 1-2/+4
2021-08-26[ci] yarn formatGravatar FredKSchott 1-1/+1
2021-08-26add "astro preview" command (#1226)Gravatar Fred K. Schott 1-0/+6
* add "astro preview" command * Update green-buttons-reflect.md * Update cli-reference.md
2021-08-23[ci] yarn formatGravatar FredKSchott 1-4/+5
2021-08-23fix docs on config apiGravatar Fred K. Schott 1-7/+11
2021-08-23[ci] yarn formatGravatar matthewp 1-2/+1
2021-08-23Add Astro `<Debug/>` component (#675)Gravatar Caleb Jasik 1-0/+19
* Initial MVP Debug component * Document the prettifying of the input * Just make `<Debug/>` a wrapper around `<Prism/>` lol * feat: add details/summary debug component * chore: remove Props (unused) * fix: prefer `div` to semantic elements * chore: format * fix: prop-drill `class` into components * fix: ensure `astro/components` are evaluated lazily * feat(debug): export debug component from `astro/debug` * fix: minimal example local snowpack config * docs: add debugging docs * chore: add changeset * docs: update debug docs Co-authored-by: Nate Moore <nate@skypack.dev>
2021-08-23Add trailingSlash & pageDirectoryUrl config options (#1197)Gravatar Fred K. Schott 1-19/+7
2021-08-18Update api-reference.mdGravatar Fred K. Schott 1-1/+1
2021-08-16[ci] yarn formatGravatar matthewp 1-2/+2
2021-08-16Astro.resolve (#1085)Gravatar Matthew Phillips 1-0/+24
* 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 <jonathantneal@hotmail.com>
2021-08-12Remove sentence about dev server docs (#1095)Gravatar Sia 1-2/+0
2021-08-12Fix typos in the docs/ content (#1093)Gravatar mundry 2-2/+2
Co-authored-by: mundry <mundry@users.noreply.github.com>
2021-08-11Add file-based routing /w dynamic paths (#1010)Gravatar Fred K. Schott 1-66/+130
* wip: add file-based routing * add pagination tests and nested pagination support
2021-08-08[ci] yarn formatGravatar FredKSchott 1-7/+8
2021-08-07Fix code examples that would fail if copy-pasted (#1050)Gravatar Jonathan Neal 2-4/+4
2021-07-30Docs site cleanup (#948)Gravatar Fred K. Schott 5-5/+5
* add language selector * docs site cleanup * review feedback * code review comments
2021-07-30Ascii quotes (#928)Gravatar Marcus Otterström 2-3/+3
2021-07-30Fix typos and clarify docs (#880)Gravatar Marcus Otterström 1-1/+1
* Add more missing words * Add missing dot * Add another missing dot * Clarify what optimized css means (discussed on Discord) * Remove oxford comma Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-07-22📘 DOC: improve a11y (#806)Gravatar Caleb Jasik 1-2/+0
* Add `tabindex="0"` to `<pre>` so that they are navigable by keyboard users if they overflow. * Landmark elements should have unique names https://dequeuniversity.com/rules/axe/4.3/landmark-unique * Page must have one main landmark https://dequeuniversity.com/rules/axe/4.3/landmark-one-main - Main landmark must not be contained by another landmark https://dequeuniversity.com/rules/axe/4.3/landmark-main-is-top-level * Heading level cannot increase by more than one * Ensure that links with the same accessible name serve a similar purpose https://dequeuniversity.com/rules/axe/4.3/identical-links-same-purpose * Just update the accessible name and require context for the visible link name * Fix CSS from the removal of the second <main> * Revert heading level change
2021-07-21[ci] yarn formatGravatar natemoo-re 1-0/+2
2021-07-21Expose JSX compilation to renderers (#588)Gravatar Nate Moore 1-0/+45
* feat: add support for `jsxImportSource`, new JSX transform * Renderer: add Solid renderer (#667) * feat: add support for `jsxImportSource`, new JSX transform * WIP: solid renderer * [Renderer] Solid (#656) * feat: add support for `jsxImportSource`, new JSX transform * WIP: solid renderer * Solid renderer: fix SSR of children, hydration (top level) Caveat: cannot hydrate children/descendants of hydrated parents * Fix hydration of fragments * fix: SyntaxError in React/Preact renderers * fix: errors in React/Preact renderers * feat: update react external * chore: update examples * chore: delete old changelog * chore: update astro config Co-authored-by: Nate Moore <nate@skypack.dev> * Changing the preact to Solid (#669) * chore: use new client:visible syntax * fix: dev script issue * chore: cleanup SolidJS example * docs: update framework example docs * chore: cleanup framework-multiple example * fix: remove SolidJS false-positives from Preact renderer * chore: add changeset Co-authored-by: eyelidlessness <eyelidlessness@users.noreply.github.com> Co-authored-by: Abdullah Mzaien <s201540830@kfupm.edu.sa> * feat(create-astro): add Solid support * docs: add JSX options to renderer reference * chore: add changeset for P/React renderers * fix: move react/server.js to external * chore: remove brewfile * Revert "feat: add support for `jsxImportSource`, new JSX transform" This reverts commit 077c4bfc135c58a85d4ebfca6012e90403694d8d. * fix: remove `react-dom/server` from `external` * chore: remove unused dependency * feat: improve JSX error messages * Revert "Revert "feat: add support for `jsxImportSource`, new JSX transform"" This reverts commit f6c2896b9ec6430611fc0abae7d586c42aca87e5. * docs: update jsxImportSource * feat: improve error message * feat: improve error logging for JSX renderers * tests: add jsx-runtime tests * chore: update snowpack Co-authored-by: eyelidlessness <eyelidlessness@users.noreply.github.com> Co-authored-by: Abdullah Mzaien <s201540830@kfupm.edu.sa>
2021-07-21[ci] yarn formatGravatar FredKSchott 1-6/+9
2021-07-21New Collections API (#703)Gravatar Fred K. Schott 1-86/+92
* updated createCollection API * Update examples/portfolio/src/pages/projects.astro Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz> * Update docs/reference/api-reference.md Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz> * fix(docs): collection doc typos (#758) * keep cleaning up docs and adding tests Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz> Co-authored-by: Mark Pinero <markspinero@gmail.com>
2021-07-20Docs/ Add `--silent` cli option (#785)Gravatar Caleb Jasik 1-0/+4
2021-07-20change snowpack.config.js to snowpack.config.mjs in docsGravatar Fred K. Schott 1-1/+1
2021-07-17Fix typos in the documentation. (#731)Gravatar mundry 2-2/+2
Co-authored-by: mundry <mundry@users.noreply.github.com>
2021-07-15fix import.meta docs referenceGravatar Fred K. Schott 1-3/+6
2021-07-15[ci] yarn formatGravatar FredKSchott 4-8/+24
generated by cgit v1.2.3 (git 2.46.0) at 2025-08-12 14:07:50 +0000