* show how to pass props
In the current documentation it is only shown how to receive props but not how to pass a component said props.
This adds a bit of code which shows how to pass props to a component.
* Update docs/src/pages/core-concepts/astro-components.md
Co-authored-by: Caleb Jasik <calebjasik@jasik.xyz>
* Expose slots to components via Astro.slots
* test: Add Astro.slots API tests
* docs: Document Astro.slots API
* docs: Duplicate Astro.slots documentation to other api-reference markdown
* Update proposal to use booleans, based upon RFC feedback
* update implementation & tests based on request
* changeset
* new publish docs
* Minor cleanup
- Removed trailing whitespaces.
- Fixed a typo where `components` was misspelled.
- Moved all links to references at the bottom of the file.
- On line 162, I added bash for the file tree example as it was used for the previous example on line 29.
- Added a new line between examples that had a DO and DO NOT.
- The code snippet from line 85 is a good example. Having that li'l space made it much nicer to read.
* cleanup publish docs
* add note on experimental nature of npm package support
Co-authored-by: Devin W. Leaman <git@4lch4.email>
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?
* 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.
* 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
* 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>
* wip
* 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>
* [ci] yarn format
* Update CONTRIBUTING.md (#1131)
* [ci] yarn format
* 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
* Make congratsbot not run in forks (#1145)
* add back dark-mode aware favicons
* make example favicons prefer non-dark mode
* Version Packages (next) (#1129)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* code review comments
Co-authored-by: Tony Sullivan <tony.f.sullivan@outlook.com>
Co-authored-by: Tony Sullivan <tony.f.sullivan@gmail.com>
Co-authored-by: matthewp <matthewp@users.noreply.github.com>
Co-authored-by: FredKSchott <FredKSchott@users.noreply.github.com>
Co-authored-by: Oleg <64708593+olejech@users.noreply.github.com>
Co-authored-by: Marcus Otterström <35617441+MarcusOtter@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* 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>
* 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>
If we wanted to, we *could* set the font-weight as `heavier` maybe? Is that an option? So that it just chooses an increase in font-weight for differentiation from text outside of a link.
This was mainly a problem with headings that have links, the difference in font-weight stuck out like a sore thumb to me.
* 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>
* 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>
* [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
* 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>
* 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
* 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
* 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>
* 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>
* 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>
* 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).
* 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>
* 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>
* 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>
* 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>
* 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>
* 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
* 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>
* 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.
* 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>
