Commit graph

181 commits

Author SHA1 Message Date
Fred K. Schott
ff92be637f
add "astro preview" command (#1226)
* add "astro preview" command

* Update green-buttons-reflect.md

* Update cli-reference.md
2021-08-26 12:08:52 -07:00
Fred K. Schott
155676275b remove unpublished blog post from docs 2021-08-26 11:25:54 -07:00
FredKSchott
d3499fc6dd [ci] yarn format 2021-08-26 04:45:36 +00:00
Rafid Muhymin Wafi
d6798d7ae6
added bengali translation of the getting started page (#1215) 2021-08-25 21:44:26 -07:00
semvis123
4d7dccfb58
NL docs typo fixes (#1232)
Fixes 2 small typos in the Dutch documentation
2021-08-25 14:57:31 -04:00
Anneke Sinnema
72d3dd00ee
Update getting-started.md (#1231) 2021-08-25 14:56:37 -04:00
matthewp
c819b3dade [ci] yarn format 2021-08-25 16:12:44 +00:00
حمد بنقالي
7ea0cb3368
Arabic getting-started translation (#1166)
Co-authored-by: = <=>
2021-08-25 12:11:29 -04:00
E. Berke KARAGÖZ
f097c88d2e
Fix typo Mardown on line 219 (#1229) 2021-08-25 12:09:56 -04:00
FredKSchott
3835856f2b [ci] yarn format 2021-08-24 05:32:44 +00:00
Joohoon Cha
b3a1c0cdcc
[i18n][Docs] Add Korean Translation of Getting Started page (#1189)
* translate getting-started.md into KR

* add kr to KNOWN_LANGUAGES

* add kr config to sidebar

* add kr option to the language selector
2021-08-23 22:31:24 -07:00
FredKSchott
884a2ea76a [ci] yarn format 2021-08-23 21:17:45 +00:00
Fred K. Schott
2538325a46 fix docs on config api 2021-08-23 14:16:29 -07:00
matthewp
010c71e16a [ci] yarn format 2021-08-23 20:44:36 +00:00
Caleb Jasik
efb41f22c3
Add Astro <Debug/> component (#675)
* Initial MVP Debug component

* Document the prettifying of the input

* Just make `<Debug/>` a wrapper around `<Prism/>` lol

* feat: add details/summary debug component

* chore: remove Props (unused)

* fix: prefer `div` to semantic elements

* chore: format

* fix: prop-drill `class` into components

* fix: ensure `astro/components` are evaluated lazily

* feat(debug): export debug component from `astro/debug`

* fix: minimal example local snowpack config

* docs: add debugging docs

* chore: add changeset

* docs: update debug docs

Co-authored-by: Nate Moore <nate@skypack.dev>
2021-08-23 16:43:22 -04:00
Fred K. Schott
c06da5dd78
Add trailingSlash & pageDirectoryUrl config options (#1197) 2021-08-23 12:05:01 -07:00
headapplesgithub
f235c84972
Update getting-started.md (#1182)
corrected typo "quickly" to "quick"
2021-08-20 13:13:43 -07:00
FredKSchott
aaef6aefef [ci] yarn format 2021-08-20 15:54:37 +00:00
headapplesgithub
68294f777d
Update comparing-astro-vs-other-tools.md (#1169)
Removed duplicate paragraph in the section about Eleventy vs Astro performance.

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-08-20 08:53:12 -07:00
mundry
cdbe2e486d
Fix typos in the docs. (#1165)
Co-authored-by: mundry <mundry@users.noreply.github.com>
2021-08-19 17:56:58 -06:00
Jonathan Neal
e66872125d
add dev script, switch documentation from advising start to dev script (#1141) 2021-08-18 22:07:08 -07:00
Fred K. Schott
a79b6db152
Add Vitepress to "Astro vs. X" comparison page 2021-08-18 18:13:20 -07:00
drwpow
737c10101a [ci] yarn format 2021-08-18 23:46:47 +00:00
Marcus Otterström
b5e5dcfed0
[DOCS] Add more information about content.astro (markdown) (#1148)
* Correct heading levels

* Add more info about content.astro

* Remove accidental heading
2021-08-18 17:45:35 -06:00
Fred K. Schott
72853afffa
Update api-reference.md 2021-08-18 09:33:18 -07:00
Magnus Markling
d18402de3a
Fix typo (#1151) 2021-08-18 09:04:11 -07:00
Tony Sullivan
1971ab3c60
Add support for client:only hydrator (#935)
* Adding support for client:only hydration

* Adding documentation for client:only

* Adding changeset

* Updating the test to use a browser-only API

* Adding a browser-specific import script, this reproduces the issue where client:only imports must be removed

* typo fix

* removing mispelled test component

* WIP: delaying inclusion of component imports until the hydration method is known

* WIP: tweaking the test to use window instead of document

* When only one renderer is included, use that for client:only hydration

* temporary test script snuck into the last commit

* WIP: adding check for a client:only renderer hint

* refactor: Remove client:only components instead of delaying all component import statements

* Updating the changeset and docs for the renderer hint

* refactor: pull client:only render matching out to it's own function

* Updating renderer hinting to match full name, with shorthand for internal renderers

Co-authored-by: Tony Sullivan <tony.f.sullivan@gmail.com>
2021-08-17 13:44:56 -04:00
Gautier Ben Aïm
64bbd89f42
docs: added 2 pages in French (#1114) 2021-08-16 22:01:02 -07:00
matthewp
24a40bee63 [ci] yarn format 2021-08-16 20:44:46 +00:00
Matthew Phillips
78b5bde14c
Astro.resolve (#1085)
* add: Astro.resolve

* Add docs and tests for Astro.resolve

* Add warnings when using string literals

* Prevent windows errors

* Adds a changeset

* Use the astro logger to log the warning

* Use the .js extension

* Dont warn for data urls

* Rename nonRelative and better match

Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com>
2021-08-16 16:43:06 -04:00
Marcus Otterström
47025a7c7d
Bold props interface words (#1123)
* Bold props interface words

* Turn it into blockquote
2021-08-16 13:19:18 -07:00
FredKSchott
71e396c3cc [ci] yarn format 2021-08-16 16:12:07 +00:00
Fred K. Schott
6322c99623
update astro comparisons (#1109) 2021-08-16 09:10:46 -07:00
Nate Moore
b3a6decc70 docs: trigger build 2021-08-13 11:49:41 -05:00
Sia
4dab932f94
Remove sentence about dev server docs (#1095) 2021-08-12 13:25:09 -05:00
mundry
cbae535cad
Fix typos in the docs/ content (#1093)
Co-authored-by: mundry <mundry@users.noreply.github.com>
2021-08-12 13:24:06 -05:00
Naeem N
fbbb589d92
Nuxt.js official page url corrected (#1096) 2021-08-12 13:20:31 -05:00
FredKSchott
b63960f514 [ci] yarn format 2021-08-11 22:05:17 +00:00
Fred K. Schott
0f0cc2b9d8
Add file-based routing /w dynamic paths (#1010)
* wip: add file-based routing

* add pagination tests and nested pagination support
2021-08-11 15:04:09 -07:00
Kus Cámara
adc767c515
change some Spanish translations (#1063) 2021-08-08 22:09:19 -07:00
FredKSchott
11c75d3f19 [ci] yarn format 2021-08-08 06:39:57 +00:00
Jonathan Neal
71882300b0
Fix code examples that would fail if copy-pasted (#1050) 2021-08-07 23:38:38 -07:00
FredKSchott
e530094330 [ci] yarn format 2021-08-06 22:23:50 +00:00
Fred K. Schott
73020fab0c another pass on alias docs 2021-08-06 15:22:35 -07:00
FredKSchott
dfafbe54d7 [ci] yarn format 2021-08-06 20:47:15 +00:00
V. Tinev
2da7078eff
[Docs] Added an "Aliases" page under Guides. [En] (#1042)
* Styled the dark version for the search bar. Changed some stlyes for both themes.

* [Docs] Added an "Aliases" page under Guides. [EN]

* [Docs] Added "Aliases" page under Guides. Removed styles from another PR.

* Revert theme.css.

* Revert Search.css.

* Edited the text.

Co-authored-by: Peter Singh <drgaud@hotmail.com>

* Text edits after review.

* Apply suggestions from documentation review.

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

Co-authored-by: V. Tinev <vtinev@2create.studio>
Co-authored-by: Peter Singh <drgaud@hotmail.com>
Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-08-06 13:46:09 -07:00
FredKSchott
0ef3d100f5 [ci] yarn format 2021-08-06 18:21:49 +00:00
Philippe L'ATTENTION
b71ccc2b9d
[ADD][i18n][Docs] French translation of getting started page (#1040)
* [ADD][i18n][Docs] French translation of getting started page

- Add Sidebar translated menus
- Add lang code fr to language selection
- Add french translated getting-started page

* [ADD][i18n][Docs] Adding 'fr' key to known langs for automatic redirect
2021-08-06 11:20:36 -07:00
FredKSchott
a3dd4d6bc8 [ci] yarn format 2021-08-06 05:52:13 +00:00
V. Tinev
8330071509
Added Bulgarian translation for the Getting Started page. (#1032)
* Added translation for the Getting Started page.

* Removed remaining English text from the translated version.

* Added Bulgarian as a known langugage (index.astro).

* Added Bulgarian as a known langugage (index.astro).

Co-authored-by: V. Tinev <vtiev@2create.studio>
2021-08-05 22:51:07 -07:00
FredKSchott
dbf18b1130 [ci] yarn format 2021-08-06 05:35:05 +00:00
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
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
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
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
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
Mulai
09fefead88
Fix Github Action setup (#934) 2021-07-29 16:31:47 -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
Marcus Otterström
c14d2550b2
Add missing word (#879) 2021-07-26 21:25:48 -05: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
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
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
Fred K. Schott
1085542d9d update astro vs lighthouse scores 2021-07-21 15:15:33 -07:00