Commit graph

513 commits

Author SHA1 Message Date
Caleb Jasik
11100d62ef
docs/fix: add language to code block (#761) 2021-07-19 18:18:07 -07:00
natemoo-re
cd8b438c08 [ci] yarn format 2021-07-20 00:37:38 +00:00
Nate Moore
325e8cba2d
Improve docs theme (#717)
* Revert "Revert "New getting started guide (#715)""

This reverts commit dc4ba25b01.

* style: update docs theme

* style: implement feedback

* feat: remove FOUC

* Update docs/src/pages/404.astro

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>

* Fix 404 title prop

* chore: implement feedback

* fix: ul, ol styles

* fix: center logo on mobile

* fix: improve navbar header contrast

* fix: improve logo overlap

* fix: `.nav-link` radius

* fix: small mobile tweaks

* feat: improve nav styles

* feat: improve embed styles

* fix: feedback items

* fix: make header sticky on mobile

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-07-19 19:36:09 -05:00
Tony Sullivan
7f57651686
fix: 🐛 ThemeToggle should initialize from localstorage immediately (#748)
Co-authored-by: Tony Sullivan <tony.f.sullivan@gmail.com>
2021-07-19 16:18:02 -07:00
FredKSchott
054e79acd7 [ci] yarn format 2021-07-19 22:45:45 +00:00
Fred K. Schott
e002755309
add comparison docs (#718) 2021-07-19 15:44:15 -07:00
Fred K. Schott
488d13a90f small typo fix 2021-07-19 14:20:47 -07:00
FredKSchott
d55d8b8c6e [ci] yarn format 2021-07-17 19:48:01 +00:00
mundry
f74112798b
Fix typos in the documentation. (#731)
Co-authored-by: mundry <mundry@users.noreply.github.com>
2021-07-17 15:46:51 -04:00
Seanghay
234b175a19
closing style tag (#730) 2021-07-17 15:45:11 -04:00
FredKSchott
dae398100d [ci] yarn format 2021-07-16 17:42:16 +00:00
Fred K. Schott
ea27663f92 New getting started guide 2021-07-16 13:39:59 -04:00
Fred K. Schott
dc4ba25b01 Revert "New getting started guide (#715)"
This reverts commit 2827f077ba.
2021-07-16 13:39:48 -04:00
Fred K. Schott
94fdd0db1b Revert "[ci] yarn format"
This reverts commit c2176bfc83.
2021-07-16 13:39:41 -04:00
natemoo-re
c2176bfc83 [ci] yarn format 2021-07-16 16:58:21 +00:00
Fred K. Schott
2827f077ba
New getting started guide (#715)
* New getting started guide

* style: small style tweaks

* style: theme updates

* chore: add redirect

* style: theme tweaks

* fix: clamp logo height

* style: fix sidebar width

Co-authored-by: Nate Moore <nate@skypack.dev>
2021-07-16 11:57:07 -05:00
JuanM04
f64ff85b26
Changed URLs to match the release (#711) 2021-07-16 06:59:46 -04:00
Benjamin Piper
36f75b9d53
Added 404.astro to docs (#712) 2021-07-16 01:18:33 -05:00
Fred K. Schott
af15798558 remove sub-format script 2021-07-15 16:13:39 -04:00
Fred K. Schott
f1fe14efda add site analytics 2021-07-15 16:12:25 -04:00
Fred K. Schott
73b8a3a40b fix import.meta docs reference 2021-07-15 16:03:40 -04:00
FredKSchott
719a7217ba [ci] yarn format 2021-07-15 19:57:50 +00:00
Fred K. Schott
5205c2d8aa add back api docs page that is referenced in the CLI 2021-07-15 15:56:40 -04:00
FredKSchott
5d1e2bab25 [ci] yarn format 2021-07-15 19:51:37 +00:00
Fred K. Schott
b0a46cf6f5 new sidebar actions 2021-07-15 15:50:27 -04:00
Fred K. Schott
7977b9639e fix installation top paragraph 2021-07-15 15:39:37 -04:00
Fred K. Schott
56e945810c fix doc dir for monorepo 2021-07-15 14:33:06 -04:00
Fred K. Schott
8e4f2c234a fix the docs dir 2021-07-15 14:19:23 -04:00
FredKSchott
f51f6c85d1 [ci] yarn format 2021-07-15 18:14:46 +00:00
Fred K. Schott
166e22bdf3
merge in docs site (#705) 2021-07-15 14:13:35 -04:00
FredKSchott
5814f2faca [ci] yarn format 2021-07-14 18:16:46 +00:00
FredKSchott
1583ef173a [ci] yarn format 2021-07-14 17:43:06 +00:00
Fred K. Schott
d40edb0b67
Docs sync (#680)
* test ignoring examples from workspace

* docs sync
2021-07-14 13:41:51 -04:00
François Vaux
d07f3d4186
Fix astro/jsx comparison table formatting (#673) 2021-07-13 11:01:49 -05:00
Matthew Phillips
0340b0f0b1
Adds support for client:media hydrator (#664)
* Adds support for client:media hydrator

* Include a changeset

* Pass in undefined when not hydrating
2021-07-12 16:27:08 -04:00
natemoo-re
7aa8d4719f [ci] yarn format 2021-07-12 18:08:45 +00:00
Nate Moore
8f4562afbe
Add support for named slots (#661)
* feat: support named slots, slot fallback content

* docs: document slots

* chore: add changeset

* fix: build errors

* chore: prefer `patch` version
2021-07-12 13:07:39 -05:00
Nate Moore
b4f145a0e7
Update component-hydration.md 2021-07-08 15:19:30 -05:00
Nate Moore
ea5afcd633
Update component-hydration.md 2021-07-08 11:55:52 -05:00
Nate Moore
ee4bcb5729
docs(#628): Clarify component rendering
Every component is rendered on the server at build time. Hydration directives _optionally_ add client-side hydration at runtime.
2021-07-08 11:50:12 -05:00
natemoo-re
1bbe98ae54 [ci] yarn format 2021-07-07 20:10:09 +00:00
Nate Moore
f83407e09a
Expose content.astro.html to Astro.fetchContent (#583)
* feat: expose `content.astro.html` to Astro.fetchContent

* docs: add `astro.html` note to docs
2021-07-01 12:07:26 -05:00
Pavel Mineev
d3969436dc
Remark and rehype plugins (#562)
* remark plugins

* remove unused dependency

* enable codeblocks

* backward compatibility with remark-code-titles

* add support for rehype plugins

* add proper types for plugins

* fixes after review

- connect plugins by name
- make plugins configurable
- connect gfm and footnotes if no plugins provided from config
- add more plugins to example

* update and rename example

* add documentation for markdown plugins

* chore: rename with-markdown-plugins example

* chore: restructure dependencies

* feat: add back smartypants, fix mdx expressions

* chore: remove log

* test: add markdown plugin tests

* chore: add changeset

* docs: update markdown doc

Co-authored-by: Nate Moore <nate@skypack.dev>
2021-07-01 11:55:22 -05:00
Matthew Phillips
fd80381db2
Adds hydrationPolyfills config for renderers (#594)
Some renderers, such as Lit, need special polyfills only for hydration. We have the `polyfills` array, but that is intended for polyfills that always need to run. This adds a second type hydrationPolyfills that only run on elements that are `:load`, `:idle`, etc.
2021-07-01 10:42:56 -04:00
Matthew Phillips
6a660f1b08
Implements low-level custom element support (#587)
* Implements low-level custom element support

* Changes based on self review

* Adds a changeset

* Polyfills are added even when not hydrating

* Remove hydrationMethod option

Punting on this idea until it's really needed.
2021-07-01 08:42:07 -04:00
Fred K. Schott
279a252462 astro-docs sync 2021-06-27 23:30:57 -07:00
Tony @ Navillus
245632bc31
Update collections.md (#549)
Updating the Individual Pages from a Collection example to fix a few typos.

- The pokemon API returns an object with an array named `results` (plural)
- `data()` needs to wrap the object in an Array
- accessing item data needs to use `collection.data[0]` to grab data from the `data()` Array
2021-06-25 14:07:11 -07:00
natemoo-re
d8a162aeee [ci] yarn format 2021-06-24 22:49:30 +00:00
Nate Moore
a136c85e6b
New Props API (#515)
* wip: update props api

* feat(#139, #309): enable new props api

* chore: migrate examples to new props API

* docs: update syntax guide for new props API

* chore: update examples to new props API

* chore: update docs to new Props API

* fix: hide __astroInternal from `Astro.props` consumers

* chore: remove scratchpad file

* chore: fix script error

* test: fix failing collection tests

* fix: set __astroInternal to `enumerable: false`

* chore: add changeset

* feat: warn users using old props api
2021-06-24 17:48:24 -05:00
Robert Soriano
d6dfff6000
add svelte extension to purge list (#529) 2021-06-24 09:53:58 -04:00
matthewp
bf6aab7427 [ci] yarn format 2021-06-23 20:02:44 +00:00
Matthew Phillips
e316c9578c
Allow usage of node builtins through node: prefix (#520)
* Start of allowing node builtins issue

* Allow use of node:builtin

* Produce an error in Astro files with bare builtin usage

* Upgrade snowpack version

bug fixes for packages that use `node:`

* Document node builtins

* Use the provided builtins list
2021-06-23 16:01:32 -04:00
Tony @ Navillus
3f3e4f1286
Update createCollection() to handle pageSize: Infinity (#516)
* Fix pageSize calculation when Infinity is given

* test grouping collection with pageSize: Infinity

* test individual pages for collection items

* Revert "update docs, remove reference to Inifinity"

This reverts commit e8a976a543.

* Adding changeset
2021-06-23 08:40:58 -04:00
Fred K. Schott
09b5779884
fix issues uncovered by snowpack warnings (#511)
* fix output issues uncovered by snowpack warnings

* Update the snowpack version

* Load Prism dep as the default

* Rename srcRoot to src

* Document the src option

* Add the changeset

Co-authored-by: Matthew Phillips <matthew@skypack.dev>
2021-06-22 14:41:04 -04:00
matthewp
32fdb383c7 [ci] yarn format 2021-06-21 19:35:26 +00:00
Matthew Phillips
0abd251cda
Removes snowpack warning suppression (#504)
* Start of warnings

* Provide knownEntrypoints by renderers

This allows renderers to provide knownEntrypoints that will be forwarded to snowpack. This gets rid of renderer-specific warnings and allows us to remove the snowpack logging hacks we were doing.

* Adds a changeset
2021-06-21 15:34:22 -04:00
Fred K. Schott
e8a976a543 update docs, remove reference to Inifinity 2021-06-18 16:16:27 -07:00
Tony @ Navillus
fc4433e640
Update collections.md (#485)
Very minor typo in the example code pulling results out of the `pokeapi` response
2021-06-17 13:47:48 -05:00
Caleb Jasik
02d175cd95
Update the shape of data provided by Astro.fetchContent("./*.md") (#479) 2021-06-16 17:39:47 -05:00
Drew Powers
e7b2a6d8dd
Fix typo, clarify layout section (#474) 2021-06-16 14:12:16 -06:00
Drew Powers
52fc62d454
Fix syntax errors in styling docs (#471) 2021-06-16 13:53:09 -06:00
Brad Cornes
3ada25d7d9
Pass configured Tailwind config file to the tailwindcss plugin (#352)
* fix tailwind config filename

* pass configured config file to tailwindcss

* add changeset

* remove `tailwindConfig` from `CompileOptions` interface
2021-06-16 11:36:19 -06:00
matthewp
aa0c4e37fa [ci] yarn format 2021-06-16 12:21:06 +00:00
Nikhil Mehta
dce6a6ce61
docs: fixed ascii based folder strucure in dev.md (#461) 2021-06-16 08:19:57 -04:00
Drew Powers
272769d723
Improve asset resolution in Astro (#437)
* Improve asset resolution in Astro

Fixes #96

* Add docs, changeset

* Fix collection resolution
2021-06-15 14:53:16 -06:00
Nate Moore
0c39c27ef5
docs: update syntax docs (#449) 2021-06-15 14:32:32 -05:00
Jasper Nykänen
e3ab36f914
Fix typo (#441) 2021-06-15 14:29:01 -05:00
Drew Powers
d14bfdc6c6
Clarify docs suggesting that Astro may just randomly break your styles (#451) 2021-06-15 11:26:24 -06:00
natemoo-re
266e447e01 [ci] yarn format 2021-06-15 16:34:46 +00:00
Nate Moore
490f2bebbc
Add <> fragment support for expressions (#433)
* feat: add support for `<>` and `</>` Fragments

* docs: explain Fragments

* test: add fragment test
2021-06-15 11:33:27 -05:00
FredKSchott
2ea15f4192 [ci] yarn format 2021-06-15 00:22:00 +00:00
Fred K. Schott
8399a4893e
new collections API docs (#416)
* new collections API docs

* docs updates

* Update docs/collections.md

Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>

* respond to code review

Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>
2021-06-14 17:21:00 -07:00
matthewp
b49ca27b06 [ci] yarn format 2021-06-14 19:47:05 +00:00
Fred K. Schott
528886b76a
rewrite part of the renderer docs (#432) 2021-06-14 15:45:50 -04:00
Drew Powers
c374a549b5
Allow createCollection() to fetch remote data (#400)
* Allow createCollection() to fetch remote data

Fixes #378

* Update docs

* revert isomorphic-fetch, see if ci passes

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-06-11 18:31:36 -07:00
matthewp
86694cb8b8 [ci] yarn format 2021-06-11 13:04:33 +00:00
Matthew Phillips
1bab906539
Remove second snowpack instance (#368)
* Remove second snowpack instance

* Document import.meta.env.SSR

* Remove unnecessary Promise.all
2021-06-11 09:03:22 -04:00
Fred K. Schott
047b0fcc6c
Update syntax.md 2021-06-09 14:15:46 -07:00
Christian Kaisermann
26853fd2ec
docs: fix browserlists link (#351)
* docs: fix browserlists link

* Update styling.md
2021-06-09 16:39:52 -04:00
Christopher Harrison
cbd5e1d259
Update vs code link (#366)
I think this is the link you wanted for the extension
2021-06-09 16:10:06 -04:00
natemoo-re
f6da8b8571 [ci] yarn format 2021-06-07 14:41:07 +00:00
Matthew Phillips
be0fe0e908
Add component publishing guide (#311) 2021-06-07 09:39:57 -05:00
Nate Moore
54a653e281
Update renderers.md 2021-06-05 10:23:10 -05:00
Nate Moore
fe7769b84d
Update renderers.md 2021-06-04 19:46:13 -05:00
natemoo-re
9d35339930 [ci] yarn format 2021-06-05 00:42:26 +00:00
Nate Moore
316b4a1652
Add docs for renderer plugins (#302)
* docs: add renderer doc

* doc: update intro

* doc: reorganize renderers doc

* docs: update renderer intro
2021-06-04 19:41:26 -05:00
Matthew Phillips
1d930ffdf4
Add verbose and reload commands (#297)
* Add verbose and reload commands

* Adds docs

* Adds a changeset

* Update witty-colts-fix.md

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>
2021-06-04 16:38:01 -05:00
natemoo-re
83aaa36376 [ci] yarn format 2021-06-02 16:36:44 +00:00
Nate Moore
94eac19888
Pre-release refactors (#289)
* refactor: expose `astro/components` as component entrypoint

* refactor: remove `extensions` from all configs

* test: fix snowpack tests

* docs: update config doc
2021-06-02 11:35:28 -05:00
Nate Moore
ffb6380c3f
Dynamic Markdown content (#273)
* wip: serverside render dynamic Markdown content

* docs: update Markdown.astro comments

* Use existing markdown infrastructure to render external MD

* Update Markdown docs

* Add a changeset

Co-authored-by: Matthew Phillips <matthew@skypack.dev>
2021-06-02 11:53:33 -04:00
Drew Powers
addd67d244
Change astroRoot to pages (#277)
#271
2021-06-01 09:57:12 -06:00
Nate Moore
3df41d2308
Bugbash! (#263)
* fix(vscode): Markdown frontmatter should use TSX, not YAML

* test: add test for #153

* chore: bump deps

* chore: update to use @astrojs scope

* fix: Markdown parse error when only child is `{expression}`

* fix: update renderer edge cases

* fix: failing test

* fix: update renderer
2021-05-28 17:19:40 -05:00
Drew Powers
f366520995
Improve Advanced Styling doc (#268) 2021-05-27 20:05:29 -06:00
duncanhealy
31e52c2e4c [ci] yarn format 2021-05-26 17:28:31 +00:00
duncanhealy
653ee5ec07
documentation: post #231 merge renderers are a config option (#249)
* documentation: post #231 merge renderers are a config option

* Update docs/config.md to reorder
2021-05-26 18:27:26 +01:00
ewatch
3d99045411
Fix invalid HTML code in Example 1 (#236)
Line 111 opened a headline with h5 but closed with h6.
Both are h5 tags now.
2021-05-24 16:53:39 -04:00
Drew Powers
c43ee95850
Bugfix: random CSS ordering (#232)
* Bugfix: random CSS ordering

Fixes #230

* Update docs
2021-05-24 10:57:35 -06:00
Drew Powers
19e20f2c54
Add Tailwind support to Astro Dev Server (#222)
* Improve PostCSS and Tailwind support

* Update styling docs

* Changelog

* Fix test hanging
2021-05-21 14:02:19 -06:00
natemoo-re
a2ae7018ca [ci] yarn format 2021-05-17 14:30:21 +00:00
Nate Moore
b3886c206f
Fix markdown issues (#208)
* Init fix/markdown

* Astro Markdown (#207)

* Add Astro Markdown to VSCode Extension

* Add Astro Markdown to Astro

* refactor: update astro-markdown example

* feat: remove embedded components from `.md` files

* fix: resolve `.md.astro` files at runtime

* chore: update markdown tests

* feat: add <Markdown> component

* chore: bump examples

* chore: update example

* fix: improve Markdown child handling

* feat: harden markdown support, add code fence support, add automatic dedenting

* chore: add weird markdown edge cases

* chore: update remote-markdown examples

* chore: add comment to Markdown.astro

* feat: improve markdown support (codefences, nested inside HTML)

* refactor: extract import specifier types to set

* refactor: conditionally import markdown renderer

* refactor: revert special-cased "astro/components"

* refactor: revert special-cased "astro/components"

* refactor: use astro/components/Markdown.astro

* refactor: remove `.md.astro` support in favor of Markdown component

* refactor: use regular .astro files

* refactor: remove unused code

* refactor: move Markdown inside Layout

* wip: markdown scoped styles

* feat: improve scoped styles in Markdown

* feat: micromark => remark ecosystem

* fix: markdown build

* fix: markdown build

* chore: add todo

* fix: collect headers text

* docs: add Markdown doc

* chore: add changeset

* docs: improve Markdown highlighting

* refactor: prefer Set

* refactor: exclude large unified deps

* docs: update markdown docs

Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com>

* chore: remove extra markdown deps

* perf: optimize markdown

* fix: unified/rehype deps

* temp: fix markdown test

* test: add TODO comment

* fix: do not namespace frontmatter, just astro metadata

* test: fix astro-markdown test

* test: add realworld markdown example

* fix: prism language bug

* docs: update markdown docs

* chore: bump dependencies

* fix: escape codespan

* fix: unterminated string literal

* fix(vscode): inline dependencies

* fix(vscode): dependencies

* feat(vscode): embedded markdown

* feat: add Markdown syntax highlighting

* chore: improve markdown example

* fix: markdown example

* feat: highlighting improvements

* chore: add changeset

* fix: CodeBlock => CodeSpan

* chore: get astro-markdown example running

Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com>
2021-05-17 09:29:16 -05:00
Drew Powers
7184149514
Add Astro.request.canonicalURL and Astro.site to global (#199) 2021-05-11 17:31:52 -06:00
Drew Powers
42ec961eec
Add more docs on styling (#186) 2021-05-08 11:35:44 -04:00
Drew Powers
94038d3297
Format (#167) 2021-05-03 12:26:10 -06:00
Drew Powers
1d498facc8
Fix RSS dategen (#156) 2021-04-30 11:52:00 -05:00
Nate Moore
961eee5007
Docs: add .astro Syntax guide (#137)
* wip: astro syntax docs

* docs: update syntax guide

* docs: add IDE note

* chore: beautify file

* docs: edits

* Update docs/syntax.md

Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>

* docs: be kinder to JSX :)

* fix: spelling

* docs: clarify some code comments

Co-authored-by: Drew Powers <1369770+drwpow@users.noreply.github.com>
2021-04-28 14:55:25 -05:00
Nate Moore
61ccd59f92
Minimal create-astro CLI (#136)
* feat: add minimal create-astro CLI

* docs: update readme
2021-04-27 15:59:23 -05:00
Nate Moore
73b7827b40
chore: update docs to new defaults (#133) 2021-04-27 13:42:03 -05:00
Matthew Phillips
41c64b30af
Move the request object from import.meta to Astro (#134)
* Move the `request` object from import.meta to Astro

This moves the `request` object to the Astro "global" (really just a render-level variable).

* Document Astro.request
2021-04-27 14:00:33 -04:00
Nate Moore
dea1a6dfc9
Update defaults directory structure to src and dist (#132)
* chore: update defaults in docs

* chore: update config defaults

* test: update tests to config defaults

* chore: update gitignore to new defaults

* docs: update readme to new defaults

* chore: update examples to new defaults

* chore: update default exclude in lang server

* chore: update tests

* test: fix failing tests

* chore: update www defaults
2021-04-26 15:54:20 -06:00
Matthew Phillips
0ea4a986e2
Support 500 pages in the dev server (#131)
* Support 500 pages

* Document custom 400/500 pages

* Remove search from any pages not the 500 page

* fix(kitchen-sink): add snowpack.config.js

* fix(examples): add snowpack.config.js

* style: redesign built-in 500 page

Co-authored-by: Nate Moore <nate@skypack.dev>
2021-04-26 16:42:11 -04:00
Drew Powers
510e7920d2
Add RSS generation (#123) 2021-04-23 10:44:41 -06:00
Matthew Phillips
da033e27ea
CLI docs (#121)
* Start of cli docs

* Document the CLI

Also adds support for the `--config` option and `--port` option for the dev server.

* Add tests for --config and --port flags

* Add port to validateConfig
2021-04-22 08:25:57 -04:00
Drew Powers
76932822b8
Split README into docs (#118) 2021-04-20 17:15:47 -06:00