Commit graph

407 commits

Author SHA1 Message Date
YM
036af0a790
Docs: Add zh-tw translation for Setup (#980)
* Add zh-tw translation of quick start in doc

* Add translation into zh-tw for Install in docs

* Update getting started for zh-tw

* Update language label for Traditional Chinese

* Update toc titles for zh-hant-TW

* Update lang attribute for zh-TW

* Add zh-tw translation of example in doc

* Update sidebar items for zh-TW in Docs
2021-08-05 22:33:55 -07:00
Fred K. Schott
eafbb45f04
update automatic docs redirect (#1014) 2021-08-04 14:22:11 -07:00
FredKSchott
6a4a9fe3a1 [ci] yarn format 2021-08-04 19:46:51 +00:00
Laura Caroline
c2723567d9
Add Portuguese Translation of Getting Started page (#981)
* Add Portuguese Translation of Getting Started page

Based on Brazilian Portuguese

* Fix/add improvement sugestions.

* Add missing preposition

* Update file to represent also the region

The Only changes to the existing files were the addition of the lang attribute

* Add language selection for Brazilian Portuguese
2021-08-04 12:45:22 -07:00
Abdullah Mzaien
81c885f54f
Adding Dir attribute to allow rtl languages to work (#982)
* Adding Dir attribute to allow rtl languges to work

* Update docs/src/layouts/MainLayout.astro

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

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-08-04 12:33:55 -07:00
Jesus Gil
a1e5d04118
Add spanish getting-started translation (#988)
* Add spanish getting-started translation

Translated getting-started page to spanish. Added spanish links to
config.ts, and spanish option to header language dropdown.

* add language code to frontmatter

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-08-04 11:06:19 -07:00
Joshua Stübner
935fe60070
Docs/add german translation (#1005)
* feat: add German getting started page

* feat: add missing links to German page to config and LanguageSelect

* feat: remove two dashes because that's considered bad practice

* Update LanguageSelect.tsx

Co-authored-by: Joshua <joshua.stuebner@bloxxter.com>
Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-08-04 11:04:33 -07:00
FredKSchott
08b442dcf5 [ci] yarn format 2021-08-04 16:06:21 +00:00
Xinyuan Wang
2bd178d4f9
docs(translate):translate getting-started.md into ZH (CN & TW) (#979)
* translate getting-started.md into ZH (CN & TW)

* fix translate the title for getting-started.md

* add zh CN & TW config in Docs

* fix config "locale"

* fix config.ts add route for CN & TW

* fix installation.md Next Steps title 's level

* translate quick-start.md &
installation.md & examples.md
into ZH (CN )

* Add lang variable to docs frontmatter
for translations

* Update docs/src/pages/zh-TW/getting-started.md

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

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-08-04 09:05:00 -07:00
Jonathan Neal
c7aca2c9b2
Reduce meta viewport tag (#1006) 2021-08-04 08:30:58 -04:00
Bryce Wray
058388c874
Update deploy.md (typo in newly added section) (#998) 2021-08-03 18:31:20 -05:00
matthewp
fc739c24d7 [ci] yarn format 2021-08-03 14:50:44 +00:00
Bryce Wray
07244a3782
Update deploy.md for Cloudflare Pages (#992)
* Update deploy.md for Cloudflare Pages

- Adding description of how to set up an Astro site in Cloudflare Pages.
- Minor grammatical fix in the “Credits” area. :-) [Sorry, I have OCD about “off of.”]

* Remove sentence fragment

Removing sentence fragment left behind when I was researching the Environment Variable part. :-/

* Update deploy.md (remove misplaced text)

Same as before, but removing potentially misleading reference to Node version (since we explain in "Environment variables (advanced)" part how to resolve).
2021-08-03 10:48:57 -04:00
Joshua Stübner
52ca7fafb0
Improve Collection docs for RSS (#990)
- Added missing but required link attribute
- Added note on how to create a full text feed
2021-08-03 08:18:25 -04:00
Caleb Jasik
c2d8cea41f
Add lang variable to docs frontmatter for translations (#984) 2021-08-02 13:45:28 -04:00
Bryce Wray
f935c5a9fa
Update styling.md re link-handling for .scss files (#977)
Adding a note to make clear that users of .scss files should still link to the final compiled .css files, as per https://discord.com/channels/830184174198718474/853350631389265940/871151798075949066.
2021-08-01 23:52:58 -07:00
Fred K. Schott
b3270728c2 add support for 4-letter language codes (ex: zh-TW) 2021-08-01 23:49:24 -07:00
FredKSchott
877f9d2702 [ci] yarn format 2021-08-02 06:40:02 +00:00
Fred K. Schott
94f89a3c88
full translation (#967) 2021-08-01 23:38:50 -07:00
Fred K. Schott
ca3c16a611 fix bad merge from outdated layout 2021-07-31 08:36:01 -07:00
Fred K. Schott
289450fce6 small cleanup to installation docs 2021-07-30 23:15:24 -07:00
Fred K. Schott
ee95351ee8 add finnish to language selector 2021-07-30 23:11:24 -07:00
Fred K. Schott
bc7dae9faf move finnish translations to fi 2021-07-30 23:05:24 -07:00
Vesa Piittinen
d55fe81d10
WIP: Documentation in Finnish (#837)
* Initial Finnish getting-started.md

* Initial Finnish `quick-start.md`

* Missing word

* Use a different test path name

* Initial Finnish `installation.md`

* Sync with `installation.md`

* WIP Finnish island-architecture.md

* Fix some sillyness

* Delete island-architecture.md

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-07-30 23:04:42 -07:00
Diogo Felix
5e9a47ffbc
📘 DOC: Add PostCSS configuration on Astro (#947) 2021-07-30 22:45:56 -07:00
FredKSchott
d7b0080da0 [ci] yarn format 2021-07-31 05:41:22 +00:00
allanvobraun
81d6960a16
Add svelte file extension to tailwind puge configuration. (#964)
Self explanatory.
2021-07-30 22:39:39 -07:00
Fred K. Schott
7c74496149
Docs site cleanup (#948)
* add language selector

* docs site cleanup

* review feedback

* code review comments
2021-07-30 22:39:15 -07:00
Marcus Otterström
d0b8485ddf
Ascii quotes (#928) 2021-07-30 17:34:07 -05:00
FredKSchott
01387674ba [ci] yarn format 2021-07-30 07:54:54 +00:00
Marcus Otterström
6d9ef9c0e9
Fix typos and clarify docs (#880)
* 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-30 00:53:24 -07:00
Fred K. Schott
e9d52bd1cc move translated nl docs 2021-07-29 22:03:56 -07:00
Chris Bongers
ea6af0392c
Started on the getting started dutch docs 🇳🇱 (#855) 2021-07-29 21:33:50 -07:00
Fred K. Schott
8fa228630b small docs font fix 2021-07-29 16:45:48 -07:00
matthewp
59cf6dcca8 [ci] yarn format 2021-07-29 20:33:19 +00:00
Mulai
09fefead88
Fix Github Action setup (#934) 2021-07-29 16:31:47 -04:00
Fred K. Schott
6eeafac715
Add algolia-powered search bar to docs site (#917)
* add search bar

* replace cmd+k with slash hotkey

* update api key

* add localhost support for search
2021-07-29 13:31:41 -07:00
Caleb Jasik
908139642a
📘 DOC: Improve SiteSidebar styles on mobile (#939) 2021-07-29 16:31:18 -04:00
Caleb Jasik
72898e3cd6
Add yarn lint:a11y to the docs project (#804) 2021-07-28 17:00:00 -04:00
matthewp
0849152d36 [ci] yarn format 2021-07-28 18:38:31 +00:00
github-actions[bot]
b4f7888be3
Version Packages (#912)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2021-07-28 14:37:29 -04:00
Maksim Markelov
70f0a09d30
Add remark-slug (#862)
* Add remark-slug

* Add remark-slug in documentation

* Add changeset
2021-07-28 12:33:19 -04:00
Nikola Hristov
5e3e828a44
Fixes typo (#902) 2021-07-28 10:43:09 -05:00
Fred K. Schott
7dfe22ecce remove warning from collections docs 2021-07-27 18:05:48 -07:00
Balázs Orbán
b7630b93e6
docs: add missing matchMedia reference (#895)
* docs: add missing `matchMedia` reference

* Update docs/src/pages/core-concepts/component-hydration.md

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-07-27 17:22:27 -05:00
matthewp
365f3bd230 [ci] yarn format 2021-07-27 14:36:32 +00:00
Peter Singh
e3d73149f7
DOC: revisions made to the setup section (#864)
* this is the last time im changing these files....

* This is Thats these two files finished off...

* Updated the section setup, a bit

* trying to resolve the conflict

Co-authored-by: Matthew Phillips <matthew@matthewphillips.info>
2021-07-27 10:35:23 -04:00
Caleb Jasik
0c46a1dab2
Docs/show docsidebar on mobile (#878) 2021-07-27 01:31:07 -05:00
Marcus Otterström
c14d2550b2
Add missing word (#879) 2021-07-26 21:25:48 -05:00
FredKSchott
c8896bd021 [ci] yarn format 2021-07-26 20:42:42 +00:00
Fred K. Schott
60a2755c0a
some docs site polish (#853)
* some docs polish

* attempt to fix theme toggle
2021-07-26 13:41:32 -07:00
Alexandre Desroches
1f09df6c7c
Fixed typo in getting-started.md (#842) 2021-07-24 09:13:20 -05:00
Austin Crim
96f70c3f99
fix table header color (#839)
Co-authored-by: Austin Crim <crim.austin@principal.com>
2021-07-23 23:40:47 +02:00
Tony Sullivan
294a656ed9
Introduce <style global> (#824)
* Adding support for multiple <style> blocks

* Adding support for `<style global>`

* scoping @keyframes should also be skipped for <style global>

* Adding test coverage for muliple style blocks, global blocks, and scoped keyframes

* docs: Updating docs for `<style global>` support

* Adding yarn changeset

* Punctuation fix in styling docs

* docs: Clarifying example use cases given in the docs

Co-authored-by: Tony Sullivan <tony.f.sullivan@gmail.com>
2021-07-23 13:51:27 -04:00
FredKSchott
041788878d [ci] yarn format 2021-07-23 17:12:19 +00:00
Danny Burrows
b5fed3be9b
📘 DOC: Adding github actions example to deploy.md (#823)
* Adding github actions example to deploy.md

* Update wording and example

Made the suggested changes

* Apply suggestions from code review

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
Co-authored-by: Fred K. Schott <fkschott@gmail.com>

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-07-23 10:11:08 -07:00
Caleb Jasik
0c729f248d
docs: adds a skip link so that you can skip the nav via keyboard (#829) 2021-07-22 23:52:01 -05:00
Fred K. Schott
353bc89f65 fix next framework example versions 2021-07-22 21:43:31 -07:00
João Paquim
3b51f4b5e2
docs: fix broken link to Markdown component (#827) 2021-07-22 19:29:32 -05:00
jasikpark
40875600f1 [ci] yarn format 2021-07-23 00:13:51 +00:00
Caleb Jasik
4fd6cfe668
📘 DOC: improve a11y (#806)
* 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-22 19:12:37 -05:00
Caleb Jasik
7b600d597b
Move site to a prop instead of directly importing from within the component. (#803) 2021-07-22 19:08:45 -05:00
FredKSchott
bea8154f69 [ci] yarn format 2021-07-22 14:07:25 +00:00
Danny Burrows
55195200fa
Update deploy.sh to include touch .nojekyll (#819)
* Update deploy.sh to include touch .nojekyll

* Update deploy.md

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-07-22 07:05:53 -07:00
Chris Bongers
022382cd3f
Added docs for community plugins 📗 (#799)
* Added docs for community plugins 📗

* Updated copy for keywords 🔗
2021-07-22 07:04:19 -07:00
João Paquim
6d37b7f80e
docs: remove duplicate section describing slots (#820)
With the recently added documentation describing named slots, the previous Slots section was redundant, and was consolidated into the same section.
2021-07-22 07:02:29 -07:00
natemoo-re
561cbee68f [ci] yarn format 2021-07-21 23:11:40 +00:00
Nate Moore
bd18e14a2c
Expose JSX compilation to renderers (#588)
* 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 18:10:03 -05:00
Jesus Gil
ba6b47eda7
Hsla composition (#790)
* update theme colors to hsla

* Add light navbar bg color

* remove duplicate color assignments in Note.astro

* clean up

Clean up css variables and document use of hsla colors
2021-07-21 18:02:45 -05:00
Fred K. Schott
1085542d9d update astro vs lighthouse scores 2021-07-21 15:15:33 -07:00
Fred K. Schott
5609940be0 remove video from getting started page 2021-07-21 15:10:31 -07:00
Fred K. Schott
5f922221ba Revert "Version Packages (next) (#692)"
This reverts commit 790bd89ead.
2021-07-21 08:12:32 -07:00
github-actions[bot]
790bd89ead
Version Packages (next) (#692)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2021-07-21 07:57:51 -07:00
FredKSchott
428513c446 [ci] yarn format 2021-07-21 14:51:37 +00:00
Fred K. Schott
c611f2ced6 add note that collections api is new 2021-07-21 07:50:20 -07:00
Fred K. Schott
31570f0b9c
slight homepage redesign (#789) 2021-07-21 07:44:15 -07:00
FredKSchott
b7e579a9cb [ci] yarn format 2021-07-21 14:13:10 +00:00
Fred K. Schott
f67e8f5f55
New Collections API (#703)
* 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-21 07:11:57 -07:00
Kyosuke
5fcd466d95
replace npm run start with npm start (#791) 2021-07-21 07:09:44 -07:00
Fred K. Schott
661a52f4dd optimize social image 2021-07-20 20:48:18 -07:00
Caleb Jasik
2a7654edf3
Docs/ Add MetaData component for Open Graph and Twitter embeds (#784)
* Docs/ Add MetaData component for Open Graph and Twitter embeds

* Switch twitter card type to `summary_large_image`

* Add a version tag to the default-og-image url for cache busting

* Update docs/src/config.ts

Co-authored-by: Fred K. Schott <fkschott@gmail.com>

* Incorporate changes from review

* Construct `canonicalImageSrc` from `Astro.site`, which is not useful now, but could be if #788 is implemented

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-07-20 21:52:26 -05:00
Caleb Jasik
c1e304dfb8
Docs/ Add --silent cli option (#785) 2021-07-20 17:59:03 -07:00
Fred K. Schott
9f6ec661e2 update astro.config.js to astro.config.mjs in docs 2021-07-20 13:58:29 -07:00
Caleb Jasik
ec4e00a8c1
Docs/fix sitesidebar template (#778)
* Fix: Do not commit `.env` files in any directory

* Links that aren't current should have either *no* aria-current attribute or `aria-current="false"` for the same effect.
2021-07-20 15:56:45 -05:00
Caleb Jasik
6915dc688b
docs: fix the templating setup for the <title/> in MainLayout.astro (#779) 2021-07-20 15:56:20 -05:00
Fred K. Schott
225baf1fc6 change snowpack.config.js to snowpack.config.mjs in docs 2021-07-20 13:47:09 -07:00
natemoo-re
d6a9afb8e1 [ci] yarn format 2021-07-20 19:05:48 +00:00
Nate Moore
e129cde67d
chore: move vercel.json to subdirs (#776) 2021-07-20 14:04:35 -05:00
Sha Mwe La
c044e62a08
Add title for the Astro Documentation Page (#774)
* Add title for the Astro Documentation Page

* Add the missing object braces

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>

Co-authored-by: Nate Moore <natemoo-re@users.noreply.github.com>
2021-07-20 11:03:44 -05:00
Sha Mwe La
791558658f
Remove trailing comma (#773) 2021-07-20 06:56:00 -07:00
Caleb Jasik
59e558bbc0
docs: use aria-current="page" rather than .is-active in SiteSidebar.astro (#770) 2021-07-20 06:55:35 -07:00
Fred K. Schott
7ad7e16633 add back removed left sidebar scroll behavior 2021-07-19 21:30:30 -07:00
FredKSchott
50f82e1a53 [ci] yarn format 2021-07-20 04:07:49 +00:00
Caleb Jasik
4253683ec0
docs: set header link width to 100% so that the link fills the entire box it sits in for easier selection (#767) 2021-07-19 21:05:00 -07:00
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