Commit graph

205 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
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
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
João Paquim
3b51f4b5e2
docs: fix broken link to Markdown component (#827) 2021-07-22 19:29:32 -05: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
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
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
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
Caleb Jasik
11100d62ef
docs/fix: add language to code block (#761) 2021-07-19 18:18:07 -07: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
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
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
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