Commit graph

249 commits

Author SHA1 Message Date
Fred K. Schott
8963b6607a fix bad import 2021-09-06 01:42:58 -07:00
FredKSchott
5fe677d69c [ci] yarn format 2021-09-06 08:32:22 +00:00
Fred K. Schott
9f06fb014b cleanup docs changes 2021-09-06 01:31:10 -07:00
FredKSchott
b4d1c9bc64 [ci] yarn format 2021-09-06 08:25:23 +00:00
Fred K. Schott
6dc05575a6 scale back the examples page 2021-09-06 01:21:55 -07:00
aFuzzyBear
d321d8366b Adds examples page 2021-09-06 01:21:39 -07:00
Sam Chen
8c69275f03
docs: add a link to next article (#1308) 2021-09-05 10:16:44 -05:00
Caleb Jasik
73a98821b7
📘DOC: Fix URL normalization for the Left Sidebar in docs (#1299)
* Fix URL normalization for the Left Sidebar in docs

* Move the fix into `util.ts` as suggested by @FredKSchott
2021-09-04 19:55:55 -05:00
Sam Chen
0555689b8a
docs: add a period (#1306) 2021-09-03 22:07:30 -05:00
FredKSchott
e516f9c953 [ci] yarn format 2021-09-03 18:07:39 +00:00
Fred K. Schott
e282e8e4ac
Add new <Code> component, to succeed <Prism> (#1208)
* add code component

* Update packages/astro/components/Debug.astro

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

* Update packages/astro/components/Debug.astro

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

* fix format in debug component

* remove Debug changes

* add wrap support

* add props docs

* update default theme

Co-authored-by: Peter Singh <drgaud@hotmail.com>
Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
2021-09-03 11:06:25 -07:00
raph_5
cdc69792f9
Debug component importation (#1289)
with   import { Debug } from 'astro/debug'   :
   Debug = undefined
   Error: Unable to render Debug because it is undefined! Did you forget to import the component or is it possible there is a typo?
2021-09-01 15:03:25 -07:00
Hendrik Runte
d96d6d453d
Update getting-started.md (#1281)
Fixing some minor typos and improving style.
2021-09-01 15:01:46 -07:00
Mani Gandham
ef1ce95407
Delete docs text about removed Collections API (#1286) 2021-08-31 22:27:41 -07:00
Tim Chesney
66734b75f1
Remove reference/link to Collections (#1277)
* Remove reference/link to Collections

Remove line that refers to 'Core Concepts - Collections' given this is now deprecated.

* Added reference to routing

Tested link as working in local build.
2021-08-31 18:04:26 -07:00
Caleb Jasik
61e4f2cb1f
Remove caveat about Astro.request not being passed to components. (#1276) 2021-08-31 13:58:52 -04:00
FredKSchott
6c3416ef44 [ci] yarn format 2021-08-31 15:55:47 +00:00
Lachlan Young
5b24bd1768
Add v20 documentation for bundling assets (#1262)
* Add v20 documentation for bundling assets

* 🛁 Revert bad doc

* 🛁 Address CR

*  Use astro

* 🛁 Correct Link

* Update styling.md

Co-authored-by: Fred K. Schott <fkschott@gmail.com>
2021-08-31 08:54:35 -07:00
Xinyuan Wang
327d59287f
docs: translate astro vs other docs to zh comparing-astro-vs-other-tools.md (#1199)
* 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>

* docs: translate astro vs other docs to zh
comparing-astro-vs-other-tools.md

* Version Packages

* [ci] yarn format

* fix: Merge conflicts

* docs: add the part of gatsby

* [ci] yarn format

Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: ChelesteWang <ChelesteWang@users.noreply.github.com>
2021-08-30 14:21:04 -07:00
Drew Powers
5b6c52eb41
Alphabetize API doc (#1270) 2021-08-30 14:15:20 -07:00
Sarah Rainsberger
3d73d7fbf2
Include lang="xxxx" in Prism component example (#1264) 2021-08-29 11:39:39 -05:00
Mikkel Tønder
9823f16f51
Add danish translation of the getting started page (#1243)
* Add danish translation of the getting started page

* Add danish to KNOWN_LANGUAGES
2021-08-27 16:01:06 -04:00
matthewp
5cc7947a58 [ci] yarn format 2021-08-27 14:13:41 +00:00
Matthew Phillips
788c769d78
Implementation of hoisted scripts (#1178)
* Implementation of hoisted scripts

* Use the facade id

* Adds docs on hoisted scripts

* Don't try to run rollup if there are no hoisted scripts

* Handle scripts possibly being undefined (client:only)

* Get rid of changes to the portfolio example

* Adds a changeset

* Remove a todo

* Fix lint errors

* Rename TransformResult property to hoistedScripts

* Move Hoisted Scripts docs to astro-components page

* Fixes lint errors

* Fix path join for windows
2021-08-27 10:12:27 -04:00
matthewp
dc493b39f7 [ci] yarn format 2021-08-27 13:42:16 +00:00
Matthew Phillips
4c4c797020
Update Tailwind docs for path to css (#1240)
* Update Tailwind docs for path to css

* Remove other references to public in the styling guide

* Remove unnecessary (pages)
2021-08-27 09:40:40 -04:00
matthewp
c8c9917c1d [ci] yarn format 2021-08-27 12:27:58 +00:00
Mark Teekman
110fdb1ac1
Add new Astro components package (#1242) 2021-08-27 08:26:18 -04:00
FredKSchott
59cc62f7bd [ci] yarn format 2021-08-26 19:10:14 +00:00
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
Fred K. Schott
96ecb3da5f
docs: fix header rtl logo view (#1224) 2021-08-25 08:18:04 -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
Caleb Jasik
2fd004dcd9
Add a titleClosure to the HeadSEO.astro component (#1140)
* Testing out adding a `titleClosure` to the `HeadSEO.astro` component

I think the api needs a bit of improvement, but the basic idea is you can pass this in to a published astro component for specifying how you want it to format your title!

* Refactor to make it pretty

* Rename the `titleClosure()` prop to `formatTitle()` to be more clear

* Use title, with site title as the fallback (#1143)

See og:title guidance (https://developers.facebook.com/docs/sharing/webmasters/)

Co-authored-by: Jonathan Neal <jonathantneal@hotmail.com>
2021-08-23 15:08:20 -05:00
Fred K. Schott
c06da5dd78
Add trailingSlash & pageDirectoryUrl config options (#1197) 2021-08-23 12:05:01 -07:00
matthewp
1185d8ffcb [ci] yarn format 2021-08-23 18:55:00 +00:00
Fred K. Schott
e03f39a1b3
fix the rtl search bar view (#1177) 2021-08-23 14:53:44 -04:00
Fred K. Schott
d51e0f4fef update universal id 2021-08-20 22:48:32 -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
kelvinsjk
52cf927564
docs: fix mobile sidebar toggle (#1158) 2021-08-18 15:03:26 -07: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
Fred K. Schott
b3da04bb50 add back dark-mode aware favicons 2021-08-17 22:24:46 -07:00
Oleg
537e348b3e
docs: fix select language in Safari (#1127) (#1128)
* docs: fix select language in Safari (#1127)

* docs: fix select language top position

* docs: fix select language position
2021-08-17 22:03:13 -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
Fred K. Schott
5e0e276609 cleanup example favicons 2021-08-16 14:34:08 -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
Fred K. Schott
ada4058a3e docs: rename sidebar "Components" to "Component Syntax" 2021-08-13 11:28:11 -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
Fred K. Schott
1350d57997
Do not observe visible hydrate components more than once (#1015)
* add support for truely unique astro root uids

* update test to test uniqueness
2021-08-10 09:51:19 -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
c6b486e4bd [ci] yarn format 2021-08-06 18:55:50 +00:00
V. Tinev
57328fc056
Styled the dark version of the search bar. (#1041)
* Styled the dark version for the search bar. Changed some stlyes for both themes.

* Adjusted the SearchFooter glow.

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

* Removed search footer glow.

* Added inset shadow for the search modal.

Co-authored-by: V. Tinev <vtinev@2create.studio>
Co-authored-by: Peter Singh <drgaud@hotmail.com>
2021-08-06 11:54:42 -07:00
Marcus Otterström
50fed4902b
Fix contrast issue in lang picker (#1044) 2021-08-06 11:54: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
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