Commit graph

227 commits

Author SHA1 Message Date
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