update repo URL (#1994)
This commit is contained in:
parent
9ed6b3c0f0
commit
7476a92461
100 changed files with 194 additions and 194 deletions
4
.github/workflows/congratsbot.yml
vendored
4
.github/workflows/congratsbot.yml
vendored
|
@ -8,7 +8,7 @@ on:
|
|||
jobs:
|
||||
congrats:
|
||||
name: "discord:congratsbot"
|
||||
if: github.repository == 'snowpackjs/astro'
|
||||
if: github.repository == 'withastro/astro'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- id: setup
|
||||
|
@ -21,4 +21,4 @@ jobs:
|
|||
# DISCORD_AVATAR: ${{ github.event.pull_request.user.avatar_url }}
|
||||
uses: Ilshidur/action-discord@0.3.2
|
||||
with:
|
||||
args: '**Sweet!** <${{ github.event.commits[0].author.name }}> just merged ["\"${{ steps.setup.outputs.COMMIT_MSG }}\""](<https://github.com/snowpackjs/astro/commits/main>) ```${{ github.event.commits[0].message }}```'
|
||||
args: '**Sweet!** <${{ github.event.commits[0].author.name }}> just merged ["\"${{ steps.setup.outputs.COMMIT_MSG }}\""](<https://github.com/withastro/astro/commits/main>) ```${{ github.event.commits[0].message }}```'
|
||||
|
|
6
.github/workflows/issue.yml
vendored
6
.github/workflows/issue.yml
vendored
|
@ -18,19 +18,19 @@ jobs:
|
|||
uses: srggrs/assign-one-project-github-action@1.2.1
|
||||
if: github.event.action == 'opened' && startsWith(github.event.issue.title, '🐛 BUG:')
|
||||
with:
|
||||
project: 'https://github.com/snowpackjs/astro/projects/2'
|
||||
project: 'https://github.com/withastro/astro/projects/2'
|
||||
column_name: 'Needs Triage'
|
||||
|
||||
- name: Assign RFCs to the RFC Tracker
|
||||
uses: srggrs/assign-one-project-github-action@1.2.1
|
||||
if: github.event.action == 'opened' && startsWith(github.event.issue.title, '💡 RFC:')
|
||||
with:
|
||||
project: 'https://github.com/snowpackjs/astro/projects/3'
|
||||
project: 'https://github.com/withastro/astro/projects/3'
|
||||
column_name: 'Discussing'
|
||||
|
||||
- name: Assign RFCs to the Docs Tracker
|
||||
uses: srggrs/assign-one-project-github-action@1.2.1
|
||||
if: github.event.action == 'opened' && startsWith(github.event.issue.title, '📘 DOC:')
|
||||
with:
|
||||
project: 'https://github.com/snowpackjs/astro/projects/5'
|
||||
project: 'https://github.com/withastro/astro/projects/5'
|
||||
column_name: 'TODO'
|
||||
|
|
2
.github/workflows/release.yml
vendored
2
.github/workflows/release.yml
vendored
|
@ -43,7 +43,7 @@ jobs:
|
|||
DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
|
||||
uses: Ilshidur/action-discord@0.3.2
|
||||
with:
|
||||
args: 'A new release just went out! [Release notes →](<https://github.com/snowpackjs/astro/releases/>)'
|
||||
args: 'A new release just went out! [Release notes →](<https://github.com/withastro/astro/releases/>)'
|
||||
|
||||
- name: push main branch to latest branch
|
||||
if: steps.changesets.outputs.published == 'true'
|
||||
|
|
2
.github/workflows/stat.yml
vendored
2
.github/workflows/stat.yml
vendored
|
@ -7,7 +7,7 @@ on:
|
|||
|
||||
jobs:
|
||||
stat:
|
||||
if: github.repository == 'snowpackjs/astro'
|
||||
if: github.repository == 'withastro/astro'
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out code using Git
|
||||
|
|
|
@ -186,7 +186,7 @@ When in prerelease mode, the automatic PR release process will no longer release
|
|||
1. Run `yarn release` to publish your new release.
|
||||
1. Run `git push && git push --tags` to push your new release to GitHub.
|
||||
1. Run `git push release/0.X:latest` to push your release branch to `latest`. This will trigger an update to the docs site, the www site, etc.
|
||||
1. Go to https://github.com/snowpackjs/astro/releases/new and create a new release. Copy the new changelog entry from https://github.com/snowpackjs/astro/blob/latest/packages/astro/CHANGELOG.md.
|
||||
1. Go to https://github.com/withastro/astro/releases/new and create a new release. Copy the new changelog entry from https://github.com/withastro/astro/blob/latest/packages/astro/CHANGELOG.md.
|
||||
1. Post in Discord #announcements channel, if needed!
|
||||
|
||||
## Translations
|
||||
|
|
|
@ -234,7 +234,7 @@ Please let me know if you’re interested in accepting this invitation. If so, w
|
|||
Best,
|
||||
${MY_NAME}
|
||||
|
||||
*PS: As a reminder, our Governance document describes the following privileges and responsibilities for the **L2 - Maintainer** role: https://github.com/snowpackjs/astro/blob/main/GOVERNANCE.md*
|
||||
*PS: As a reminder, our Governance document describes the following privileges and responsibilities for the **L2 - Maintainer** role: https://github.com/withastro/astro/blob/main/GOVERNANCE.md*
|
||||
```
|
||||
|
||||
## Voting: Core Maintainer (L3) Nomination
|
||||
|
|
|
@ -6,7 +6,7 @@ Welcome to the Astro style guide. This document is meant to guide you on the cod
|
|||
- Blog post writing style
|
||||
- Discord/Twitter writing style
|
||||
|
||||
For the RFC writing guide, check out the [RFC issue template](https://github.com/snowpackjs/astro/issues/new/choose).
|
||||
For the RFC writing guide, check out the [RFC issue template](https://github.com/withastro/astro/issues/new/choose).
|
||||
|
||||
### Linting (Style Rules)
|
||||
|
||||
|
@ -16,8 +16,8 @@ Anything enforced by linting and formatting is considered a **style rule.** It i
|
|||
|
||||
These style rules are maintained in configuration files, and therefore not documented in this document. Read any of the following configuration files to learn more about the style rules that we strictly enforced across the codebase:
|
||||
|
||||
- [ESLint](https://github.com/snowpackjs/astro/blob/main/.eslintrc.cjs) (Linting)
|
||||
- [Prettier](https://github.com/snowpackjs/astro/blob/main/.prettierrc.json) (Formatting)
|
||||
- [ESLint](https://github.com/withastro/astro/blob/main/.eslintrc.cjs) (Linting)
|
||||
- [Prettier](https://github.com/withastro/astro/blob/main/.prettierrc.json) (Formatting)
|
||||
|
||||
Alternatively, don't worry too much about style rules and trust that our tools will catch these issues for you and offer inline suggestions as you work.
|
||||
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
# Astro Docs <img width="19.2" height="25.6" src="https://raw.githubusercontent.com/snowpackjs/astro/main/assets/brand/logo.svg" alt="Astro logo">
|
||||
# Astro Docs <img width="19.2" height="25.6" src="https://raw.githubusercontent.com/withastro/astro/main/assets/brand/logo.svg" alt="Astro logo">
|
||||
|
||||
## Contributing
|
||||
|
||||
|
|
|
@ -7,8 +7,8 @@ export interface Props {
|
|||
|
||||
const { path } = Astro.props as Props;
|
||||
const commitPath = 'docs/' + path;
|
||||
const url = `https://api.github.com/repos/snowpackjs/astro/commits?path=${commitPath}`;
|
||||
const commitsURL = `https://github.com/snowpackjs/astro/commits/main/${commitPath}`;
|
||||
const url = `https://api.github.com/repos/withastro/astro/commits?path=${commitPath}`;
|
||||
const commitsURL = `https://github.com/withastro/astro/commits/main/${commitPath}`;
|
||||
|
||||
async function getCommits(url) {
|
||||
try {
|
||||
|
|
|
@ -35,7 +35,7 @@ const {editHref} = Astro.props;
|
|||
</a>
|
||||
</li>
|
||||
<li class={`header-link depth-2`}>
|
||||
<a href="https://github.com/snowpackjs/astro/blob/main/CONTRIBUTING.md#translations" target="_blank">
|
||||
<a href="https://github.com/withastro/astro/blob/main/CONTRIBUTING.md#translations" target="_blank">
|
||||
<svg aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 88.6 77.3" height="1.24em" width="1.24em" style="margin: -2px;"> <path fill="currentColor" d="M61,24.6h7.9l18.7,51.6h-7.7l-5.4-15.5H54.3l-5.6,15.5h-7.2L61,24.6z M72.6,55l-8-22.8L56.3,55H72.6z" /> <path fill="currentColor" d="M53.6,60.6c-10-4-16-9-22-14c0,0,1.3,1.3,0,0c-6,5-20,13-20,13l-4-6c8-5,10-6,19-13c-2.1-1.9-12-13-13-19h8 c4,9,10,14,10,14c10-8,10-19,10-19h8c0,0-1,13-12,24l0,0c5,5,10,9,19,13L53.6,60.6z M1.6,16.6h56v-8h-23v-7h-9v7h-24V16.6z" /> </svg>
|
||||
<span>Translate this page</span>
|
||||
</a>
|
||||
|
|
|
@ -13,49 +13,49 @@
|
|||
{
|
||||
"name": "Starter Kit",
|
||||
"description": "A default starter project for Astro. Flexible enough to handle anything that you might want to build.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/starter",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/starter",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/starter",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/starter",
|
||||
"command": "npm init astro"
|
||||
},
|
||||
{
|
||||
"name": "Docs",
|
||||
"description": "A documentation website theme, complete with i18n, search, dark mode and more.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/docs",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/docs",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/docs",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/docs",
|
||||
"command": "npm init astro -- --template docs"
|
||||
},
|
||||
{
|
||||
"name": "Blog",
|
||||
"description": "A blog theme, perfect for personal and company blogs.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/blog",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/blog",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/blog",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/blog",
|
||||
"command": "npm init astro -- --template blog"
|
||||
},
|
||||
{
|
||||
"name": "Portfolio",
|
||||
"description": "A portfolio theme, perfect for your personal or professional online portfolio.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/portfolio",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/portfolio",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/portfolio",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/portfolio",
|
||||
"command": "npm init astro -- --template portfolio"
|
||||
},
|
||||
{
|
||||
"name": "Portfolio-svelte",
|
||||
"description": "A portfolio theme using Svelte components, perfect for your personal or professional online portfolio.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/portfolio-svelte",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/portfolio-svelte",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/portfolio-svelte",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/portfolio-svelte",
|
||||
"command": "npm init astro -- --template portfolio-svelte"
|
||||
},
|
||||
{
|
||||
"name": "Minimal",
|
||||
"description": "A minimal theme, with just the bare minimum needed to get started.",
|
||||
"github": "https://github.com/snowpackjs/astro/tree/main/examples/minimal",
|
||||
"github": "https://github.com/withastro/astro/tree/main/examples/minimal",
|
||||
"demo": null,
|
||||
"sandbox": "https://github.dev/snowpackjs/astro/tree/main/examples/minimal",
|
||||
"sandbox": "https://github.dev/withastro/astro/tree/main/examples/minimal",
|
||||
"command": "npm init astro -- --template minimal"
|
||||
}
|
||||
],
|
||||
|
|
|
@ -11,7 +11,7 @@ import { SITE } from "../config.ts";
|
|||
const { content = {}, hideRightSidebar = false} = Astro.props;
|
||||
const currentPage = Astro.request.url.pathname;
|
||||
const currentFile = `src/pages${currentPage.replace(/\/$/, "")}.md`;
|
||||
const githubEditUrl = `https://github.com/snowpackjs/astro/blob/main/docs/${currentFile}`;
|
||||
const githubEditUrl = `https://github.com/withastro/astro/blob/main/docs/${currentFile}`;
|
||||
const formatTitle = (content, SITE) => content.title ? `${content.title} 🚀 ${SITE.title}` : SITE.title;
|
||||
---
|
||||
<html dir={content.dir ?? 'ltr'} lang={content.lang ?? 'en-us'} class="initial">
|
||||
|
|
|
@ -19,7 +19,7 @@ Astro هو باني موقع ثابت. تعرف أكثر حول ماهية Astro
|
|||
|
||||
### أمثلة على بعض المشاريع
|
||||
|
||||
أن كنت تفضل التعلم عن طريق الأمثلة، ألقي نظرةٍ على [مكتبة الأمثلة الشاملة](https://github.com/snowpackjs/astro/tree/main/examples) المتواجدة على Github.
|
||||
أن كنت تفضل التعلم عن طريق الأمثلة، ألقي نظرةٍ على [مكتبة الأمثلة الشاملة](https://github.com/withastro/astro/tree/main/examples) المتواجدة على Github.
|
||||
|
||||
بمقدورك الإطلاع على أي من هذه الأمثلة وتجربتها مُباشرةً على جهازك،
|
||||
فقط نفذ الأمر <code ltr="left">npm init astro</code> متبوعًا بـ
|
||||
|
@ -45,7 +45,7 @@ _ملحوظة: بعض المُميزات مُقتصرة على CodeSandbx (مث
|
|||
|
||||
يأتي العديد الأشخاص من خلفياتِ تعلم مُختلفة إلى Astro، أيًا كانت طريقة التعليم التي تفضلها سواءً أكنت تفضل الطريقة النظرية أو الطريقة العملية، نتمنى أن تجد هذا القسم مفيدًا.
|
||||
|
||||
- إن كُنت تُفضل **التعلم من خلال التجربة العملية**، أبدأ من خلال [مكتبتنا للأمثلة](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- إن كُنت تُفضل **التعلم من خلال التجربة العملية**، أبدأ من خلال [مكتبتنا للأمثلة](https://github.com/withastro/astro/tree/main/examples).
|
||||
- إن كُنت تُفضل **التعلم من خلال الفهم خطوةً بخطوة**، أبدأ من خلال [دليل المفاهيم الأساسية والإرشادات](/core-concepts/project-structure).
|
||||
|
||||
مثل أي تقنيةٍ ليست بمألوفة، Astro يأتيك بمنحنى تعليمي مختلف بعض الشيء، ولكن على أي حال، مع بعض الصبر والممارسة، نحن متأكدون بأنك _ستتأقلم معه_ في وقتٍ هين دون أن تشعر.
|
||||
|
@ -71,11 +71,11 @@ _ملحوظة: بعض المُميزات مُقتصرة على CodeSandbx (مث
|
|||
|
||||
ونحن أيضًا نُعد نشرة إصدارات ونعلن عنها في [مُجتمعنا على ديسكورد](https://astro.build/chat) على قناة <span dir="ltr">#announcements</span>
|
||||
|
||||
ليست كل إصدارات Astro تملك تدوينة نشرةٍ خاصة بها، لكن ستجد سجلًا للتغيرات في ملف [`CHANGELOG.md` في مستودع Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
ليست كل إصدارات Astro تملك تدوينة نشرةٍ خاصة بها، لكن ستجد سجلًا للتغيرات في ملف [`CHANGELOG.md` في مستودع Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## شيءٌ ما ناقص؟
|
||||
|
||||
إن كان هناك شيءُ ما غير مُوثق أو لو كنت تشعر بالحيرة والإرتباك من جزءٍ معين في التوثيق، لا تتردد في [رفع طلب خطبٌ ما في ملف التوثيق](https://github.com/snowpackjs/astro/issues/new/choose)، مع اقتراحك للتحسين، أو قم بتغريد تغريدةٍ إلى حسابنا على تويتر [@astrodotbuild](https://twitter.com/astrodotbuild)، نحب سماع آرائك!
|
||||
إن كان هناك شيءُ ما غير مُوثق أو لو كنت تشعر بالحيرة والإرتباك من جزءٍ معين في التوثيق، لا تتردد في [رفع طلب خطبٌ ما في ملف التوثيق](https://github.com/withastro/astro/issues/new/choose)، مع اقتراحك للتحسين، أو قم بتغريد تغريدةٍ إلى حسابنا على تويتر [@astrodotbuild](https://twitter.com/astrodotbuild)، نحب سماع آرائك!
|
||||
|
||||
## التَقدِير
|
||||
|
||||
|
|
|
@ -23,7 +23,7 @@ _Бележка: някои функционалности (например: Fa
|
|||
|
||||
Всякакви видове хора с различни методи за обучение се ориентират към Astro. Независимо дали предпочитате по-теоретичен, или по-практически подход, ние се надяваме че ще намерите тази секция за полезна.
|
||||
|
||||
- Ако предпочитате да **учите чрез практика**, започнете с нашата [библиотека с примери](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Ако предпочитате да **учите чрез практика**, започнете с нашата [библиотека с примери](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Ако предпочитате да **учите концепции стъпка по стъпка**, започнете с нашите [базови концепции и гидове](/core-concepts/project-structure).
|
||||
|
||||
Като всяка непозната технология, Astro изисква известно време, за да се научи. Но с практика и малко търпение, ние сме сигурни, че _ще го схванете_ за нула време.
|
||||
|
@ -49,11 +49,11 @@ _Бележка: някои функционалности (например: Fa
|
|||
|
||||
Публикуваме и съобщения относно нови версии в [нашия Discord сървър](https://astro.build/chat) в #announcements канала.
|
||||
|
||||
Не всяка нова версия на Astro заслужава собствен блог пост, но можете да намерите регистър на промените за всеки релийз в [`CHANGELOG.MD` файла, намиращ се в репото на Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Не всяка нова версия на Astro заслужава собствен блог пост, но можете да намерите регистър на промените за всеки релийз в [`CHANGELOG.MD` файла, намиращ се в репото на Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Нещо липсва?
|
||||
|
||||
Ако нещо липсва в документацията или намирате нещо за объркващо, моля [подайте го като issue за документацията](https://github.com/snowpackjs/astro/issues/new/choose) с Вашите предложения за подобрение или пуснете tweet към [@astrodotbuild](https://twitter.com/astrodotbuild). Обичаме да чуваме от Вас!
|
||||
Ако нещо липсва в документацията или намирате нещо за объркващо, моля [подайте го като issue за документацията](https://github.com/withastro/astro/issues/new/choose) с Вашите предложения за подобрение или пуснете tweet към [@astrodotbuild](https://twitter.com/astrodotbuild). Обичаме да чуваме от Вас!
|
||||
|
||||
## Credit
|
||||
|
||||
|
|
|
@ -23,7 +23,7 @@ _দ্রষ্টব্য: বর্তমানে কোডস্যান
|
|||
|
||||
বিভিন্ন ব্যাকগ্রাউন্ডের বিভিন্ন ধরণের মানুষ বিভিন্ন পদ্ধতিতে শিখার আগ্রহ নিয়ে Astro-তে আসে। আপনি ব্যবহারিক বা তাত্ত্বিক যে পদ্ধতিতেই শিখতে পছন্দ করেন, আমাদের আশা এই অংশটি আপনাকে সহায়তা করবে।
|
||||
|
||||
- যদি আপনি **করে করে** শিখতে পছন্দ করেন, তাহলে আমাদের [উদাহরণগুলো](https://github.com/snowpackjs/astro/tree/main/examples) দিয়ে শুরু করুন।
|
||||
- যদি আপনি **করে করে** শিখতে পছন্দ করেন, তাহলে আমাদের [উদাহরণগুলো](https://github.com/withastro/astro/tree/main/examples) দিয়ে শুরু করুন।
|
||||
- আর যদি আপনি **ধাপে ধাপে** বিষয়গুলো বুঝতে চান, তাহলে আমাদের [মৌলিক ধারণা এবং সহায়িকাসমূহ](/core-concepts/project-structure) দেখুন।
|
||||
|
||||
অন্যান্য যেকোনো অপরিচিত প্রযুক্তির মতো, Astro শিখতেও কিছুটা প্রচেষ্টার প্রয়োজন রয়েছে। কিন্তু, আমরা জানি, আপনি লেগে থাকলে অতি দ্রুতই এর সাথে মানিয়ে নিতে _পারবেন_।
|
||||
|
@ -48,11 +48,11 @@ _দ্রষ্টব্য: বর্তমানে কোডস্যান
|
|||
|
||||
আমরা আমাদের [ডিসকর্ড সার্ভারের](https://astro.build/chat) **#announcements** চ্যানেলেও যেকোনো নতুন বিজ্ঞপ্তি প্রকাশ করে থাকি।
|
||||
|
||||
প্রতিটি Astro রিলিজের জন্য আমরা নতুন ব্লগ পোস্ট করি না, কিন্তু আপনি Astro রিপোজিটরির [`CHANGELOG.md`](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) ফাইলে প্রতিটি রিলিজের বিস্তারিত পরিবর্তনসূচি দেখতে পারবেন।
|
||||
প্রতিটি Astro রিলিজের জন্য আমরা নতুন ব্লগ পোস্ট করি না, কিন্তু আপনি Astro রিপোজিটরির [`CHANGELOG.md`](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) ফাইলে প্রতিটি রিলিজের বিস্তারিত পরিবর্তনসূচি দেখতে পারবেন।
|
||||
|
||||
## কিছু অনুপস্থিত মনে হচ্ছে?
|
||||
|
||||
আপনার যদি ডকুমেন্টেশনে কোনো কিছু অনুপস্থিত মনে হয় বা কোনো অংশকে বিভ্রান্তিকর মনে হয়, তাহলে দয়া করে আপনার পরামর্শসহ [একটি ইস্যু ফাইল করুন](https://github.com/snowpackjs/astro/issues/new/choose) অথবা [@astrodotbuild](https://twitter.com/astrodotbuild) টুইটার অ্যাকাউন্টটিতে টুইট করুন। আমরা আপনাদের পরামর্শ শুনতে সর্বদা আগ্রহী!
|
||||
আপনার যদি ডকুমেন্টেশনে কোনো কিছু অনুপস্থিত মনে হয় বা কোনো অংশকে বিভ্রান্তিকর মনে হয়, তাহলে দয়া করে আপনার পরামর্শসহ [একটি ইস্যু ফাইল করুন](https://github.com/withastro/astro/issues/new/choose) অথবা [@astrodotbuild](https://twitter.com/astrodotbuild) টুইটার অ্যাকাউন্টটিতে টুইট করুন। আমরা আপনাদের পরামর্শ শুনতে সর্বদা আগ্রহী!
|
||||
|
||||
## ক্রেডিট
|
||||
|
||||
|
|
|
@ -18,7 +18,7 @@ A few features are still missing from Astro, and several APIs are not yet finali
|
|||
|
||||
[Docusaurus](https://docusaurus.io/) is a popular documentation website builder. Docusaurus uses React to generate your website UI while Astro supports React, Vue.js, Svelte, and raw HTML templating.
|
||||
|
||||
Docusaurus was designed to build documentation websites and has some built-in, documentation-specific website features that Astro does not. Instead, Astro offers documentation-specific features through an official [`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs) theme that you can use for your site. This website was built using that template!
|
||||
Docusaurus was designed to build documentation websites and has some built-in, documentation-specific website features that Astro does not. Instead, Astro offers documentation-specific features through an official [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) theme that you can use for your site. This website was built using that template!
|
||||
|
||||
### Comparing Docusaurus vs. Astro Performance
|
||||
|
||||
|
@ -201,9 +201,9 @@ One big reason behind this performance difference is Astro's smaller JavaScript
|
|||
|
||||
[VuePress](https://vuepress.vuejs.org/guide/) is a popular documentation website builder from the creators of Vue.js. VuePress uses Vue.js to generate your website UI while Astro supports React, Vue.js, Svelte, and raw HTML templating.
|
||||
|
||||
VuePress was designed for documentation websites and has some built-in, documentation-specific website features that Astro does not support out of the box. Instead, Astro offers documentation-specific features through an official [`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs) theme that you can use for your site. This website was built using that template!
|
||||
VuePress was designed for documentation websites and has some built-in, documentation-specific website features that Astro does not support out of the box. Instead, Astro offers documentation-specific features through an official [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) theme that you can use for your site. This website was built using that template!
|
||||
|
||||
Evan You (creator of Vue.js) is currently working on a new version of Vuepress called [VitePress.](https://vitepress.vuejs.org/). If you want a modern alternative to VuePress, [check out Evan's post](https://github.com/snowpackjs/astro/issues/1159#issue-974035962) on why VitePress may be a better option.
|
||||
Evan You (creator of Vue.js) is currently working on a new version of Vuepress called [VitePress.](https://vitepress.vuejs.org/). If you want a modern alternative to VuePress, [check out Evan's post](https://github.com/withastro/astro/issues/1159#issue-974035962) on why VitePress may be a better option.
|
||||
|
||||
### Comparing VuePress vs. Astro Performance
|
||||
|
||||
|
|
|
@ -83,7 +83,7 @@ For a real-world example, you might implement GitHub's file viewer like so:
|
|||
/[org]/[repo]/tree/[branch]/[...file]
|
||||
```
|
||||
|
||||
In this example, a request for `/snowpackjs/astro/tree/main/docs/public/favicon.svg` would result in the following parameters being available to the page:
|
||||
In this example, a request for `/withastro/astro/tree/main/docs/public/favicon.svg` would result in the following parameters being available to the page:
|
||||
|
||||
```js
|
||||
{
|
||||
|
|
|
@ -16,7 +16,7 @@ Alternativt kan du læse vores [Installationsguide](/installation) for en fuld g
|
|||
|
||||
### Eksempelprojekter
|
||||
|
||||
Hvis du foretrækker at lære Astro ved hjælp af eksempler, kan du tjekke vores [fulde bibliotek af eksempler](https://github.com/snowpackjs/astro/tree/main/examples) på GitHub.
|
||||
Hvis du foretrækker at lære Astro ved hjælp af eksempler, kan du tjekke vores [fulde bibliotek af eksempler](https://github.com/withastro/astro/tree/main/examples) på GitHub.
|
||||
|
||||
Du kan tjekke alle disse eksempler på din lokale maskine ved at køre `npm init astro` med CLI-flaget `--template`. Flaget `--template` understøtter også tredjeparts-skabeloner lavet af fællesskabet.
|
||||
|
||||
|
@ -30,13 +30,13 @@ npm init astro -- --template [GITHUB_BRUGER]/[REPO_NAVN]/sti/til/eksempel
|
|||
|
||||
### Online Legepladser
|
||||
|
||||
Hvis du er interesseret i at lege med Astro i browseren, kan du bruge en online kodeeditor som Stackblitz, CodeSandbox, Gitpod eller GitHub Codespaces. Klik på "Open in Stackblitz" linket i et af eksemplerne i vores [liste af eksempler](https://github.com/snowpackjs/astro/tree/main/examples). Eller, [klik her](https://stackblitz.com/fork/astro) for at starte et nyt projekt i [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
Hvis du er interesseret i at lege med Astro i browseren, kan du bruge en online kodeeditor som Stackblitz, CodeSandbox, Gitpod eller GitHub Codespaces. Klik på "Open in Stackblitz" linket i et af eksemplerne i vores [liste af eksempler](https://github.com/withastro/astro/tree/main/examples). Eller, [klik her](https://stackblitz.com/fork/astro) for at starte et nyt projekt i [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
|
||||
## Lær Astro
|
||||
|
||||
Alle slags mennesker kommer til Astro fra forskellige baggrunde og medbringer forskellige læringsstile. Uanset om du foretrækker en mere teoretisk eller praktisk tilgang, håber vi at du finder dette afsnit nyttigt.
|
||||
|
||||
- Hvis du foretrækker at **lære ved at gøre**, kan du starte med vores [liste af eksempler](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Hvis du foretrækker at **lære ved at gøre**, kan du starte med vores [liste af eksempler](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Hvis du foretrækker at **lære koncepter trin for trin**, kan du starte med vores [grundlæggende koncepter og vejledninger](/core-concepts/project-structure).
|
||||
|
||||
Som enhver anden ukendt teknologi har Astro en lille indlæringskurve. Men med øvelse og lidt tålmodighed, ved vi at du _vil_ få styr på det på ingen tid.
|
||||
|
@ -61,11 +61,11 @@ Twitter-kontoen [@astrodotbuild](https://twitter.com/astrodotbuild) er den offic
|
|||
|
||||
Vi sender også udgivelsesmeddelelser til vores [Discord-fællesskab](https://astro.build/chat) i #announcements kanalen.
|
||||
|
||||
Ikke hver Astro udgivelse fortjener sit eget blogindlæg, men du kan finde en detaljeret ændringsliste for hver udgivelse i [`CHANGELOG.md` filen i Astro-repositoriet](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Ikke hver Astro udgivelse fortjener sit eget blogindlæg, men du kan finde en detaljeret ændringsliste for hver udgivelse i [`CHANGELOG.md` filen i Astro-repositoriet](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Mangler der noget?
|
||||
|
||||
Hvis der mangler noget i dokumentationen, eller hvis du synes, at en del er forvirrende, skal du [indsende et Issue om dokumentationen](https://github.com/snowpackjs/astro/issues/new/choose) med dit forslag til forbedringer, eller tweet på [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-kontoen. Vi elsker at høre fra dig!
|
||||
Hvis der mangler noget i dokumentationen, eller hvis du synes, at en del er forvirrende, skal du [indsende et Issue om dokumentationen](https://github.com/withastro/astro/issues/new/choose) med dit forslag til forbedringer, eller tweet på [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-kontoen. Vi elsker at høre fra dig!
|
||||
|
||||
## Kredit
|
||||
|
||||
|
|
|
@ -26,7 +26,7 @@ _Hinweis: Einige Funktionen (z.B. Fast Refresh) funktionieren aktuell nur begren
|
|||
|
||||
Es kommen eine Menge verschiedener Menschen mit unterschiedlichen Hintergründen und anderen Lernweisen zu Astro. Unabhängig davon, ob Du lieber theoretisch oder praktisch lernst, hoffen wir, dass Dir dieser Abschnitt weiterhilft.
|
||||
|
||||
- Falls Du lieber **praktisch lernst**, suche Dir ein Beispiel aus unserer [Beispiel Liste](https://github.com/snowpackjs/astro/tree/main/examples) aus und fange direkt an.
|
||||
- Falls Du lieber **praktisch lernst**, suche Dir ein Beispiel aus unserer [Beispiel Liste](https://github.com/withastro/astro/tree/main/examples) aus und fange direkt an.
|
||||
|
||||
- Falls Du lieber **theoretisch lernst**, kannst Du mit unseren [grundlegenden Konzepten und Anleitungen](/core-concepts/project-structure) beginnen.
|
||||
|
||||
|
@ -54,11 +54,11 @@ Unser [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-Account ist di
|
|||
|
||||
Zusätzlich veröffentlichen wir alle Release-Ankündigungen in unserer [Discord Community](https://astro.build/chat) im `#announcements`-Kanal.
|
||||
|
||||
Auch wenn nicht jedes Astro-Release einen eigenen Blogpost verdient, kannst Du alle Änderungen für jedes Release in unserem detaillierten [`CHANGELOG.md` im Astro Repository](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) nachlesen.
|
||||
Auch wenn nicht jedes Astro-Release einen eigenen Blogpost verdient, kannst Du alle Änderungen für jedes Release in unserem detaillierten [`CHANGELOG.md` im Astro Repository](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) nachlesen.
|
||||
|
||||
## Fehlt etwas?
|
||||
|
||||
Falls Dir etwas in der Dokumentation fehlt, oder Du einen Teil verwirrend findest, [erstell bitte ein Issue](https://github.com/snowpackjs/astro/issues/new/choose) mit deinen Verbesserungsvorschlägen für die Dokumentation oder tweete an den [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-Account.
|
||||
Falls Dir etwas in der Dokumentation fehlt, oder Du einen Teil verwirrend findest, [erstell bitte ein Issue](https://github.com/withastro/astro/issues/new/choose) mit deinen Verbesserungsvorschlägen für die Dokumentation oder tweete an den [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-Account.
|
||||
|
||||
Wir freuen uns, von Dir zu hören.
|
||||
|
||||
|
|
|
@ -29,7 +29,7 @@ yarn create astro
|
|||
pnpm create astro
|
||||
```
|
||||
|
||||
Mit dem [`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro) Assistenten kannst du aus einer Reihe von [Starter-Vorlagen](https://github.com/snowpackjs/astro/tree/main/examples) wählen. Alternativ kannst du auch dein eigenes Astro-Projekt direkt von GitHub importieren.
|
||||
Mit dem [`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro) Assistenten kannst du aus einer Reihe von [Starter-Vorlagen](https://github.com/withastro/astro/tree/main/examples) wählen. Alternativ kannst du auch dein eigenes Astro-Projekt direkt von GitHub importieren.
|
||||
|
||||
```bash
|
||||
# Hinweis: Ersetze "my-astro-project" durch den Namen deines Projekts.
|
||||
|
|
|
@ -30,7 +30,7 @@ npm run build
|
|||
|
||||
Um mehr über den Installationsprozess und den ersten Gebrauch von Astro zu lernen, [lies unseren Installations-Leitfaden.](de/installation)
|
||||
|
||||
Wenn du es bevorzugst anhand eines Beispiels zu lernen, schau dir die [komplette Liste an Beispielen](https://github.com/snowpackjs/astro/tree/main/examples) auf GitHub an.
|
||||
Wenn du es bevorzugst anhand eines Beispiels zu lernen, schau dir die [komplette Liste an Beispielen](https://github.com/withastro/astro/tree/main/examples) auf GitHub an.
|
||||
Du kannst jedes Beispiel ausprobieren, indem du `npm init astro -- --template "EXAMPLE_NAME"` ausführst.
|
||||
|
||||
## Starte dein Projekt
|
||||
|
|
|
@ -18,7 +18,7 @@ Algunas características, aunque son pocas, aún no están disponibles en Astro
|
|||
|
||||
[Docusaurus](https://docusaurus.io/) es un popular generador de sitios web sobre documentación. Docusaurus desarrollado por React para generar tu UI del sitio web; mientras que Astro soporta React, Vue.js, Svelte, y plantillas HTML.
|
||||
|
||||
Docusaurus fue diseñada para construir la documentación de las páginas web y tienen una creación propia y unas características específicas de documentación que Astro no posee. En lugar de eso, Astro ofrece características específicas de documentación mediante un tema oficial [`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs) que puedes utilizar en tu sitio. !Este sitio web se construyó usando ese tema!
|
||||
Docusaurus fue diseñada para construir la documentación de las páginas web y tienen una creación propia y unas características específicas de documentación que Astro no posee. En lugar de eso, Astro ofrece características específicas de documentación mediante un tema oficial [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) que puedes utilizar en tu sitio. !Este sitio web se construyó usando ese tema!
|
||||
|
||||
#### Comparando el Rendimiento de Docusaurus vs. Astro
|
||||
|
||||
|
@ -201,9 +201,9 @@ Una de las más grandes razones detrás de la diferencia en los rendimientos es
|
|||
|
||||
[VuePress](https://vuepress.vuejs.org/guide/) es un constructor de documentación de sitios web, desarrollado por los creadores de Vue.js. VuePress utiliza Vue.js para generar la interfaz de usuario de tu sitio web, mientras que Astro soporta React, Vue.js, Svelte, y plantillas HTML.
|
||||
|
||||
VuePress fue diseñado para documentar sitios web y tiene funcionalidades y características propias que Astro no soporta por defecto. En su lugar, Astro ofrece características específicas de documentación mediante un tema oficial [`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs), el cual puedes usar para tu sitio web. !Este sitio web fue construido usando ese tema!
|
||||
VuePress fue diseñado para documentar sitios web y tiene funcionalidades y características propias que Astro no soporta por defecto. En su lugar, Astro ofrece características específicas de documentación mediante un tema oficial [`docs`](https://github.com/withastro/astro/tree/main/examples/docs), el cual puedes usar para tu sitio web. !Este sitio web fue construido usando ese tema!
|
||||
|
||||
Actualmente, Evan You (creador de Vue.js) está trabajando en una nueva versión de Vuepress llamado [VitePress.](https://vitepress.vuejs.org/). Si quieres conocer una moderna alternativa a VuePress, [revisa este post de Evan](https://github.com/snowpackjs/astro/issues/1159#issue-974035962) del porqué VitePress podría ser una mejor opción.
|
||||
Actualmente, Evan You (creador de Vue.js) está trabajando en una nueva versión de Vuepress llamado [VitePress.](https://vitepress.vuejs.org/). Si quieres conocer una moderna alternativa a VuePress, [revisa este post de Evan](https://github.com/withastro/astro/issues/1159#issue-974035962) del porqué VitePress podría ser una mejor opción.
|
||||
|
||||
#### Comparando el VuePress de Gatsby vs. Astro
|
||||
|
||||
|
|
|
@ -83,7 +83,7 @@ Para un ejemplo del mundo real, puede implementar el visor de archivos de GitHub
|
|||
/[org]/[repo]/tree/[branch]/[...file]
|
||||
```
|
||||
|
||||
En este ejemplo, una solicitud de `/snowpackjs/astro/tree/main/docs/public/favicon.svg` daría como resultado que los siguientes parámetros estuvieran disponibles para la página:
|
||||
En este ejemplo, una solicitud de `/withastro/astro/tree/main/docs/public/favicon.svg` daría como resultado que los siguientes parámetros estuvieran disponibles para la página:
|
||||
|
||||
```js
|
||||
{
|
||||
|
|
|
@ -24,7 +24,7 @@ _Nota: Algunas características (ex: Fast Refresh) actualmente están limitadas
|
|||
|
||||
Todo tipo de personas vienen a Astro de diferentes orígenes trayendo consigo diferentes estilos de aprendizaje. Ya sea que prefieras un enfoque más teórico o práctico, esperamos que esta sección te resulte útil.
|
||||
|
||||
- Si prefieres **aprender haciendo**, comienza con nuestra biblioteca de [ejemplos](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Si prefieres **aprender haciendo**, comienza con nuestra biblioteca de [ejemplos](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Si prefieres **aprender conceptos paso a paso**, comienza con nuestros [conceptos básicos y guías](https://docs.astro.build/es/core-concepts/project-structure).
|
||||
|
||||
Como cualquier tecnología desconocida, Astro viene con una ligera curva de aprendizaje. Sin embargo, con práctica y algo de paciencia, sabemos que lo dominarás en poco tiempo.
|
||||
|
@ -49,11 +49,11 @@ La cuenta de Twitter [@astrodotbuild](https://twitter.com/astrodotbuild) es la f
|
|||
|
||||
También publicamos anuncios de lanzamiento en nuestra comunidad de [Discord](https://astro.build/chat) en el canal de #announcements.
|
||||
|
||||
No todos los lanzamientos de Astro merecen su propia publicación en el blog, pero puedes encontrar un registro de cambios detallado para cada versión en el archivo [CHANGELOG.md](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) en el repositorio de Astro.
|
||||
No todos los lanzamientos de Astro merecen su propia publicación en el blog, pero puedes encontrar un registro de cambios detallado para cada versión en el archivo [CHANGELOG.md](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) en el repositorio de Astro.
|
||||
|
||||
## ¿Falta algo?
|
||||
|
||||
Si falta algo en la documentación o si alguna parte te resulta confusa, por favor [abre una issue para la documentación](https://github.com/snowpackjs/astro/issues/new/choose) con tus sugerencias de mejora o menciona a la cuenta de Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). ¡Nos encanta saber de ti!
|
||||
Si falta algo en la documentación o si alguna parte te resulta confusa, por favor [abre una issue para la documentación](https://github.com/withastro/astro/issues/new/choose) con tus sugerencias de mejora o menciona a la cuenta de Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). ¡Nos encanta saber de ti!
|
||||
|
||||
## Créditos
|
||||
|
||||
|
|
|
@ -26,7 +26,7 @@ npm init astro
|
|||
yarn create astro
|
||||
```
|
||||
|
||||
El asistente de instalación [`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro), te permite escoger de una lista de [plantillas de inicio](/examples); por otro lado, puedes importar tus propios proyectos de Astro directamente desde GitHub.
|
||||
El asistente de instalación [`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro), te permite escoger de una lista de [plantillas de inicio](/examples); por otro lado, puedes importar tus propios proyectos de Astro directamente desde GitHub.
|
||||
|
||||
```bash
|
||||
# Nota: Reemplaza "my-astro-project" con el nombre de tu proyecto.
|
||||
|
|
|
@ -30,7 +30,7 @@ npm run build
|
|||
|
||||
Para saber más sobre la instalación y uso de Astro por primera vez, por favor [lea nuestra guía de instalación.](installation)
|
||||
|
||||
Si prefieres aprender con ejemplos, revisa nuestra [librería completa de ejemplos](https://github.com/snowpackjs/astro/tree/main/examples) en GitHub. Puedes revisar cualquiera de estos ejemplos localmente ejecutando `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
Si prefieres aprender con ejemplos, revisa nuestra [librería completa de ejemplos](https://github.com/withastro/astro/tree/main/examples) en GitHub. Puedes revisar cualquiera de estos ejemplos localmente ejecutando `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
|
||||
## Comienza con tu proyecto
|
||||
|
||||
|
|
|
@ -6,7 +6,7 @@ lang: es
|
|||
|
||||
Para configurar Astro, agrega un archivo `astro.config.mjs` en la raíz de tu proyecto. Todos los ajustes son opcionales.
|
||||
|
||||
Puedes ver la API de configuración completa (incluida la información sobre la configuración predeterminada) en [GitHub](https://github.com/snowpackjs/astro/blob/latest/packages/astro/src/@types/config.ts).
|
||||
Puedes ver la API de configuración completa (incluida la información sobre la configuración predeterminada) en [GitHub](https://github.com/withastro/astro/blob/latest/packages/astro/src/@types/config.ts).
|
||||
|
||||
```js
|
||||
// Example: astro.config.mjs
|
||||
|
|
|
@ -22,7 +22,7 @@ _Huomaa: jotkin toiminnallisuudet (mm. nopea päivitys) ovat toistaiseksi rajall
|
|||
|
||||
Ihmisillä on monenlaisia taustoja ja erilaisia oppimistyylejä. Toivomme sinun saavan irti tästä osiosta riippumatta siitä oletko enemmän teoriatason vaiko käytännön tason oppija.
|
||||
|
||||
- Jos suosit **oppimista tekemällä**, kokeile aloittaa [esimerkkikirjastostamme](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Jos suosit **oppimista tekemällä**, kokeile aloittaa [esimerkkikirjastostamme](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Jos suosit **konseptien oppimista vaihe vaiheelta**, kokeile aloittaa [peruskonsepteista ja oppaista](/core-concepts/project-structure).
|
||||
|
||||
Astrolla on oma oppimiskäyränsä kuten millä tahansa ennestään tuntemattomalla teknologialla. Harjoittelulla ja kärsivällisyydellä _tulet_ pääsemään asioista kärryille.
|
||||
|
@ -47,11 +47,11 @@ Twitterin [@astrodotbuild](https://twitter.com/astrodotbuild)-tunnus on virallin
|
|||
|
||||
Tulemme kertomaan julkaisuista myös [Discord-yhteisössä](https://astro.build/chat) kanavalla #announcements.
|
||||
|
||||
Kaikki Astro-julkaisut eivät tule olemaan oman blogikirjoituksensa arvoisia, mutta löydät yksityiskohtaisen muutoslokin jokaiselle julkaisulle [`CHANGELOG.md`-tiedostosta Astron repossa](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Kaikki Astro-julkaisut eivät tule olemaan oman blogikirjoituksensa arvoisia, mutta löydät yksityiskohtaisen muutoslokin jokaiselle julkaisulle [`CHANGELOG.md`-tiedostosta Astron repossa](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Puuttuuko jotakin?
|
||||
|
||||
Mikäli havaitset puutteita dokumentaatiossa tai että osa siitä ovat hämmentäviä, jätäthän [ilmoituksen dokumentaation ongelmasta](https://github.com/snowpackjs/astro/issues/new/choose) sisältäen ehdotuksesi sen parantamiseksi, tai twiittaa [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-tunnukselle. Otamme palautetta vastaan mielellämme!
|
||||
Mikäli havaitset puutteita dokumentaatiossa tai että osa siitä ovat hämmentäviä, jätäthän [ilmoituksen dokumentaation ongelmasta](https://github.com/withastro/astro/issues/new/choose) sisältäen ehdotuksesi sen parantamiseksi, tai twiittaa [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-tunnukselle. Otamme palautetta vastaan mielellämme!
|
||||
|
||||
## Kiitokset
|
||||
|
||||
|
|
|
@ -24,7 +24,7 @@ _Note: quelques-unes des fonctionnalités (ex : Rafraîchissement Rapide) sont p
|
|||
|
||||
Tous les développeurs qui essaient Astro n'ont ni la même expérience, ni les mêmes méthodes d'apprentissage. Que vous préfériez une approche plutôt théorique ou pratique, nous espérons que vous trouverez l'aide qu'il vous faut dans cette section.
|
||||
|
||||
- Si vous préférez une **approche pratique**, commencez avec notre [librairie d'exemples](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Si vous préférez une **approche pratique**, commencez avec notre [librairie d'exemples](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Si vous préférez **apprendre les concepts étape par étape**, commencez avec nos [fondamentaux et guides](/core-concepts/project-structure).
|
||||
|
||||
Comme toute nouvelle technologie, Astro possède une certaine courbe d'apprentissage. Malgré cela, avec de la pratique et de la patience, nous savons, que _vous_ allez prendre la main, en très peu de temps.
|
||||
|
@ -49,11 +49,11 @@ Le compte Twitter [@astrodotbuild](https://twitter.com/astrodotbuild) est la sou
|
|||
|
||||
Nous publions également les annonces de nouvelles versions sur notre [Communauté Discord](https://astro.build/chat) dans le salon #announcements.
|
||||
|
||||
Toutes les releases d'Astro ne requièrent pas leur propre article de blog, mais vous pouvez trouver un changelog détaillé de toutes les releases dans le [fichier `CHANGELOG.md` du dépôt Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Toutes les releases d'Astro ne requièrent pas leur propre article de blog, mais vous pouvez trouver un changelog détaillé de toutes les releases dans le [fichier `CHANGELOG.md` du dépôt Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Quelque chose vous manque ?
|
||||
|
||||
Si vous pensez que quelque chose manque dans la documentation ou si vous en trouvez une partie déroutante, veuillez [créer une "issue" sur le dépôt de la documentation](https://github.com/snowpackjs/astro/issues/new/choose) avec vos suggestions d'amélioration, ou bien mentionnez le compte [@astrodotbuild](https://twitter.com/astrodotbuild) sur Twitter. Nous adorons avoir de vos nouvelles !
|
||||
Si vous pensez que quelque chose manque dans la documentation ou si vous en trouvez une partie déroutante, veuillez [créer une "issue" sur le dépôt de la documentation](https://github.com/withastro/astro/issues/new/choose) avec vos suggestions d'amélioration, ou bien mentionnez le compte [@astrodotbuild](https://twitter.com/astrodotbuild) sur Twitter. Nous adorons avoir de vos nouvelles !
|
||||
|
||||
## Crédits
|
||||
|
||||
|
|
|
@ -26,7 +26,7 @@ npm init astro
|
|||
yarn create astro
|
||||
```
|
||||
|
||||
L'assistant d'installation [`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro) vous propose de choisir entre différents [squelettes d'application](/examples), mais offre aussi la possibilité d'importer un projet Astro directement depuis GitHub.
|
||||
L'assistant d'installation [`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro) vous propose de choisir entre différents [squelettes d'application](/examples), mais offre aussi la possibilité d'importer un projet Astro directement depuis GitHub.
|
||||
|
||||
```bash
|
||||
# Note : remplacez "my-astro-project" avec le nom de votre projet.
|
||||
|
|
|
@ -16,7 +16,7 @@ Alternatively, read our [Installation Guide](/installation) for a full walk-thro
|
|||
|
||||
### Example Projects
|
||||
|
||||
If you prefer to learn Astro by example, check out our [complete library of examples](https://github.com/snowpackjs/astro/tree/main/examples) on GitHub.
|
||||
If you prefer to learn Astro by example, check out our [complete library of examples](https://github.com/withastro/astro/tree/main/examples) on GitHub.
|
||||
|
||||
You can check out any of these examples on your local machine by running `npm init astro` with the `--template` CLI flag. The `--template` flag also supports third-party, community templates.
|
||||
|
||||
|
@ -32,13 +32,13 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
|
||||
If you're interested in playing around with Astro in the browser, you can instantly spin up a new Astro project with our UI at [astro.new](https://astro.new/).
|
||||
|
||||
You can try Astro in online code editors like Stackblitz, CodeSandbox, Gitpod, and GitHub Codespaces. Click the "Open in Stackblitz" link in any of the examples in our [examples library](https://github.com/snowpackjs/astro/tree/main/examples). Or, [click here](https://stackblitz.com/fork/astro) to start a new project in [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
You can try Astro in online code editors like Stackblitz, CodeSandbox, Gitpod, and GitHub Codespaces. Click the "Open in Stackblitz" link in any of the examples in our [examples library](https://github.com/withastro/astro/tree/main/examples). Or, [click here](https://stackblitz.com/fork/astro) to start a new project in [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
|
||||
## Learn Astro
|
||||
|
||||
All manner of people come to Astro from different backgrounds bringing with them different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful.
|
||||
|
||||
- If you prefer to **learn by doing**, start with our [examples library](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- If you prefer to **learn by doing**, start with our [examples library](https://github.com/withastro/astro/tree/main/examples).
|
||||
- If you prefer to **learn concepts step by step**, start with our [basic concepts and guides](/core-concepts/project-structure).
|
||||
|
||||
Like any unfamiliar technology, Astro comes with a slight learning curve. However, with practice and some patience, we know, you _will_ get the hang of it, in no time.
|
||||
|
@ -63,11 +63,11 @@ The [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter account is the o
|
|||
|
||||
We also post release announcements to our [Discord community](https://astro.build/chat) in the #announcements channel.
|
||||
|
||||
Not every Astro release deserves its own blog post, but you can find a detailed changelog for every release in the [`CHANGELOG.md` file in the Astro repository](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Not every Astro release deserves its own blog post, but you can find a detailed changelog for every release in the [`CHANGELOG.md` file in the Astro repository](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Something Missing?
|
||||
|
||||
If something is missing in the documentation or if you found some part confusing, please [file an issue for the documentation](https://github.com/snowpackjs/astro/issues/new/choose) with your suggestions for improvement, or tweet at the [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter account. We love hearing from you!
|
||||
If something is missing in the documentation or if you found some part confusing, please [file an issue for the documentation](https://github.com/withastro/astro/issues/new/choose) with your suggestions for improvement, or tweet at the [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter account. We love hearing from you!
|
||||
|
||||
## Credit
|
||||
|
||||
|
|
|
@ -6,7 +6,7 @@ description: Learn how to use environment variables in an Astro project.
|
|||
|
||||
Astro uses Vite for environment variables, and allows you to use any of its methods to get and set environment variables. Note that all environment variables must be prefixed with `PUBLIC_` to be accessible by client side code.
|
||||
|
||||
The ability to access private variables on the server side is [still being discussed](https://github.com/snowpackjs/astro/issues/1765).
|
||||
The ability to access private variables on the server side is [still being discussed](https://github.com/withastro/astro/issues/1765).
|
||||
|
||||
## Setting environment variables
|
||||
|
||||
|
|
|
@ -8,7 +8,7 @@ Astro comes with out-of-the-box Markdown support powered by the expansive [remar
|
|||
|
||||
## Parsers
|
||||
|
||||
Astro lets you use any Markdown parser you want. It just needs to be a function that follows the `MarkdownParser` type declared inside [this file](https://github.com/snowpackjs/astro/blob/main/packages/astro/src/@types/astro.ts). You can declare it inside `astro.config.mjs`:
|
||||
Astro lets you use any Markdown parser you want. It just needs to be a function that follows the `MarkdownParser` type declared inside [this file](https://github.com/withastro/astro/blob/main/packages/astro/src/@types/astro.ts). You can declare it inside `astro.config.mjs`:
|
||||
|
||||
```js
|
||||
// astro.config.mjs
|
||||
|
|
|
@ -251,7 +251,7 @@ As an alternative to `src/styles/global.css`, You may also add Tailwind utilitie
|
|||
|
||||
#### Migrating from v0.19
|
||||
|
||||
As of [version 0.20.0](https://github.com/snowpackjs/astro/releases/tag/astro%400.20.0), Astro will no longer bundle, build and process `public/` files. Previously, we'd recommended putting your tailwind files in the `public/` directory. If you started a project with this pattern, you should move any Tailwind styles into the `src` directory and import them in your template using [Astro.resolve()][astro-resolve]:
|
||||
As of [version 0.20.0](https://github.com/withastro/astro/releases/tag/astro%400.20.0), Astro will no longer bundle, build and process `public/` files. Previously, we'd recommended putting your tailwind files in the `public/` directory. If you started a project with this pattern, you should move any Tailwind styles into the `src` directory and import them in your template using [Astro.resolve()][astro-resolve]:
|
||||
|
||||
```astro
|
||||
<link
|
||||
|
@ -622,7 +622,7 @@ Also please check out the [Stylelint][stylelint] project to whip your styles int
|
|||
[fouc]: https://en.wikipedia.org/wiki/Flash_of_unstyled_content
|
||||
[layout-isolated]: https://web.archive.org/web/20210227162315/https://visly.app/blogposts/layout-isolated-components
|
||||
[less]: https://lesscss.org/
|
||||
[issues]: https://github.com/snowpackjs/astro/issues
|
||||
[issues]: https://github.com/withastro/astro/issues
|
||||
[magic-number]: https://css-tricks.com/magic-numbers-in-css/
|
||||
[material-ui]: https://material.io/components
|
||||
[peace-on-css]: https://didoo.medium.com/let-there-be-peace-on-css-8b26829f1be0
|
||||
|
|
|
@ -29,7 +29,7 @@ yarn create astro
|
|||
pnpm create astro
|
||||
```
|
||||
|
||||
[`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro) wizard lets you choose from a set of [starter templates](https://github.com/snowpackjs/astro/tree/main/examples) or alternatively, you could import your own Astro project directly from GitHub.
|
||||
[`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro) wizard lets you choose from a set of [starter templates](https://github.com/withastro/astro/tree/main/examples) or alternatively, you could import your own Astro project directly from GitHub.
|
||||
|
||||
```bash
|
||||
# Note: Replace "my-astro-project" with the name of your project.
|
||||
|
|
|
@ -16,7 +16,7 @@ In alternativa, leggi la nostra [Guida all'Installazione](/installation) per una
|
|||
|
||||
### Esempi
|
||||
|
||||
Se preferisci imparare Astro tramite esempi, dai un'occhiata alla nostra [libreria completa degli esempi](https://github.com/snowpackjs/astro/tree/main/examples) su GitHub.
|
||||
Se preferisci imparare Astro tramite esempi, dai un'occhiata alla nostra [libreria completa degli esempi](https://github.com/withastro/astro/tree/main/examples) su GitHub.
|
||||
|
||||
Puoi testare uno qualsiasi di questi esempi sulla tua macchina locale lanciando `npm init astro` con la flag `--template` da CLI. La flag `--template` supporta anche template di terze parti della community.
|
||||
|
||||
|
@ -30,13 +30,13 @@ npm init astro -- --template [UTENTE_GITHUB]/[NOME_REPO]/percorso/al/esempio
|
|||
|
||||
### Online Playgrounds
|
||||
|
||||
Se ti interessa provare Astro in un browser, puoi utilizzare un code editor online come Stackblitz, CodeSandbox, Gitpod o GitHub Codespaces. Clicca sul link "Open in Stackblitz" in uno dei nostri esempi nella [libreria degli esempi](https://github.com/snowpackjs/astro/tree/main/examples). In alternativa, [clicca qui](https://stackblitz.com/fork/astro) per avviare un nuovo progetto in [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
Se ti interessa provare Astro in un browser, puoi utilizzare un code editor online come Stackblitz, CodeSandbox, Gitpod o GitHub Codespaces. Clicca sul link "Open in Stackblitz" in uno dei nostri esempi nella [libreria degli esempi](https://github.com/withastro/astro/tree/main/examples). In alternativa, [clicca qui](https://stackblitz.com/fork/astro) per avviare un nuovo progetto in [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
|
||||
## Impara Astro
|
||||
|
||||
In Astro arrivano persone di tutti i tipi, con il loro background di conoscenze e stili d'apprendimento diversi. Sia che tu preferisca un approccio più teorico o più pratico, speriamo troverai questa sezione utile.
|
||||
|
||||
- Se preferisci **imparare facendo cose**, puoi iniziare con la nostra [libreria degli esempi](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Se preferisci **imparare facendo cose**, puoi iniziare con la nostra [libreria degli esempi](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Se preferisci **imparare i concetti passo-passo**, puoi iniziare da [guide e concetti base](/core-concepts/project-structure).
|
||||
|
||||
Come ogni tecnologia poco familiare, Astro si presenta con una leggera curva di apprendimento. Tuttavia, con un po' di pratica e pazienza, sappiamo che ci riuscirai in poco tempo.
|
||||
|
@ -61,11 +61,11 @@ L'account Twitter [@astrodotbuild](https://twitter.com/astrodotbuild) è la font
|
|||
|
||||
Pubblichiamo anche annunci sui rilasci nella nostra [community Discord](https://astro.build/chat) nel canale #announcements.
|
||||
|
||||
Non tutte le release di Astro saranno accompagnate da un post sul blog, ma puoi sempre trovare un changelog dettagliato per ogni release nel [file `CHANGELOG.md` nella repository Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Non tutte le release di Astro saranno accompagnate da un post sul blog, ma puoi sempre trovare un changelog dettagliato per ogni release nel [file `CHANGELOG.md` nella repository Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Manca Qualcosa?
|
||||
|
||||
Se manca qualcosa nella documentazione o trovi qualche parte confusionaria, per favore [segnala un problema sulla documentazione](https://github.com/snowpackjs/astro/issues/new/choose) con i tuoi suggerimenti per migliorarla, oppure twitta all'account Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). Ci piace ascoltarvi!
|
||||
Se manca qualcosa nella documentazione o trovi qualche parte confusionaria, per favore [segnala un problema sulla documentazione](https://github.com/withastro/astro/issues/new/choose) con i tuoi suggerimenti per migliorarla, oppure twitta all'account Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). Ci piace ascoltarvi!
|
||||
|
||||
## Crediti
|
||||
|
||||
|
|
|
@ -18,7 +18,7 @@ Astro の簡単な概要を知りたい方は[ホームページ](https://astro.
|
|||
|
||||
## サンプルプロジェクト
|
||||
|
||||
サンプルを使って Astro を学びたい方は、GitHub にある[全サンプル](https://github.com/snowpackjs/astro/tree/main/examples)をご覧ください。
|
||||
サンプルを使って Astro を学びたい方は、GitHub にある[全サンプル](https://github.com/withastro/astro/tree/main/examples)をご覧ください。
|
||||
|
||||
これらのサンプルは、`--template` という CLI フラグを付けて `npm init astro` を実行すると、ローカルマシンでチェックアウトできます。また、 `--template` フラグは、サードパーティのコミュニティテンプレートもサポートしています。
|
||||
|
||||
|
@ -40,7 +40,7 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
|
||||
Astro には、さまざまなバックグラウンドを持った人が集まっており、学習スタイルもさまざまです。このセクションでは、より理論的なアプローチや実践的なアプローチなど、さまざまな学習スタイルをご紹介していますので、参考になれば幸いです。
|
||||
|
||||
- 実際にやってみて学びたいという方は、まず[サンプルライブラリ](https://github.com/snowpackjs/astro/tree/main/examples)から始めてください。
|
||||
- 実際にやってみて学びたいという方は、まず[サンプルライブラリ](https://github.com/withastro/astro/tree/main/examples)から始めてください。
|
||||
- また、コンセプトを段階的に学びたい方は、[基本コンセプトとガイド](/core-concepts/project-structure)をご覧ください。
|
||||
|
||||
他の慣れない技術と同様、Astro にも若干の習得が必要です。しかし、練習と忍耐力があれば、すぐに使いこなせるようになること間違いなしでしょう。
|
||||
|
@ -65,11 +65,11 @@ Astro チームからの最新情報は、[@astrodotbuild](https://twitter.com/a
|
|||
|
||||
また、[Discord コミュニティ](https://astro.build/chat)の #announcements チャンネルにもリリースのお知らせを投稿しています。
|
||||
|
||||
すべてのリリースがブログ記事で紹介されるわけではありませんが、[Astro リポジトリの `CHANGELOG.md` ファイル](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md)には、すべてのリリースの詳細な変更履歴が記載されています。
|
||||
すべてのリリースがブログ記事で紹介されるわけではありませんが、[Astro リポジトリの `CHANGELOG.md` ファイル](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md)には、すべてのリリースの詳細な変更履歴が記載されています。
|
||||
|
||||
## 何か足りない?
|
||||
|
||||
ドキュメントに何か足りないところがあったり、わかりにくいところを見つけたら、改善のための提案を[ドキュメントの Issue として提出してください](https://github.com/snowpackjs/astro/issues/new/choose)。または [@astrodotbuild](https://twitter.com/astrodotbuild) の Twitter アカウントにつぶやいてください。皆様のご意見をお待ちしております。
|
||||
ドキュメントに何か足りないところがあったり、わかりにくいところを見つけたら、改善のための提案を[ドキュメントの Issue として提出してください](https://github.com/withastro/astro/issues/new/choose)。または [@astrodotbuild](https://twitter.com/astrodotbuild) の Twitter アカウントにつぶやいてください。皆様のご意見をお待ちしております。
|
||||
|
||||
## クレジット
|
||||
|
||||
|
|
|
@ -30,7 +30,7 @@ yarn create astro
|
|||
pnpm create astro
|
||||
```
|
||||
|
||||
[`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro)ウィザードでは、[スターターテンプレート](https://github.com/snowpackjs/astro/tree/main/examples)から好きなものを選べます。代わりに GitHub から自分の Astro プロジェクトを直接インポートもできます。
|
||||
[`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro)ウィザードでは、[スターターテンプレート](https://github.com/withastro/astro/tree/main/examples)から好きなものを選べます。代わりに GitHub から自分の Astro プロジェクトを直接インポートもできます。
|
||||
|
||||
```bash
|
||||
# 注: "my-astro-project" はあなたのプロジェクト名に置き換えてください。
|
||||
|
|
|
@ -28,7 +28,7 @@ npm run build
|
|||
|
||||
はじめて Astro をインストールして使用する場合は、[インストールガイド](/ja/installation)をご覧ください。
|
||||
|
||||
サンプルを見ながら学びたいという方は、GitHub にある[全サンプル](https://github.com/snowpackjs/astro/tree/main/examples)をご覧ください。 `npm init astro -- --template "EXAMPLE_NAME"` を実行すれば、これらのサンプルをローカルにチェックアウトできます。
|
||||
サンプルを見ながら学びたいという方は、GitHub にある[全サンプル](https://github.com/withastro/astro/tree/main/examples)をご覧ください。 `npm init astro -- --template "EXAMPLE_NAME"` を実行すれば、これらのサンプルをローカルにチェックアウトできます。
|
||||
|
||||
## プロジェクトの開始
|
||||
|
||||
|
|
|
@ -24,7 +24,7 @@ _주의: 몇몇 기능은 아직 CodeSandbox에서 동작하지 않을 수 있
|
|||
|
||||
사람들은 다양한 배경에서 각자 다른 학습 스타일로 Astro에 입문합니다. 이 섹션이 이론적인 접근 방식이나 실용적인 접근 방식을 선호하는 사람 모두에게 도움이 되기를 바랍니다.
|
||||
|
||||
- **직접 경험하며 배우는** 방식을 선호한다면, [예제 라이브러리](https://github.com/snowpackjs/astro/tree/main/examples)에서 시작해보세요.
|
||||
- **직접 경험하며 배우는** 방식을 선호한다면, [예제 라이브러리](https://github.com/withastro/astro/tree/main/examples)에서 시작해보세요.
|
||||
- **개념부터 차근차근 익히는** 방식을 선호한다면, [기본 개념 가이드](/core-concepts/project-structure)에서 시작해보세요.
|
||||
|
||||
다른 낯선 기술과 마찬가지로 Astro에는 러닝 커브(learning curve)가 있습니다. 하지만 약간의 인내심을 가지고 연습한다면 충분히, 쉽게 습득할 수 있습니다.
|
||||
|
@ -49,11 +49,11 @@ API 참조 섹션은 특정 Astro API를 자세히 배우고 싶을 때 유용
|
|||
|
||||
또한 [디스코드](https://astro.build/chat)의 #announcements 채널에서도 릴리즈 소식을 찾아볼 수 있습니다.
|
||||
|
||||
모든 릴리즈가 블로그에 게시되는 것은 아닙니다. 블로그에 게시되지 않은 버전 릴리즈에 관한 자세한 수정사항은 [Astro 리포지터리 안의 `CHANGELOG.md`](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) 파일에서 읽어볼 수 있습니다.
|
||||
모든 릴리즈가 블로그에 게시되는 것은 아닙니다. 블로그에 게시되지 않은 버전 릴리즈에 관한 자세한 수정사항은 [Astro 리포지터리 안의 `CHANGELOG.md`](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) 파일에서 읽어볼 수 있습니다.
|
||||
|
||||
## 빠진 항목이 있나요?
|
||||
|
||||
문서에서 빠진 항목을 발견하거나 혼동되는 부분이 있다면 개선을 위한 제안과 함께 [문서의 리포지터리](https://github.com/snowpackjs/astro/issues/new/choose)에 이슈를 올리거나 [@astrodotbuild](https://twitter.com/astrodotbuild) 트위터 계정으로 트윗해주세요. 여러분의 참여를 기다립니다!
|
||||
문서에서 빠진 항목을 발견하거나 혼동되는 부분이 있다면 개선을 위한 제안과 함께 [문서의 리포지터리](https://github.com/withastro/astro/issues/new/choose)에 이슈를 올리거나 [@astrodotbuild](https://twitter.com/astrodotbuild) 트위터 계정으로 트윗해주세요. 여러분의 참여를 기다립니다!
|
||||
|
||||
## 크레딧
|
||||
|
||||
|
|
|
@ -22,7 +22,7 @@ _Opmerking: sommige functies (bv. Snel vernieuwen) zijn momenteel beperkt op Cod
|
|||
|
||||
Mensen komen naar Astro vanuit verschillende achtergronden en met verschillende leerstijlen. Of je nu de voorkeur geeft aan een meer theoretische of praktische benadering, we hopen dat je deze sectie nuttig zult vinden.
|
||||
|
||||
- Als je liever **leert door te doen**, begin dan met onze [voorbeeldenbibliotheek](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Als je liever **leert door te doen**, begin dan met onze [voorbeeldenbibliotheek](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Als je de concepten liever **stap voor stap leert**, begin dan met onze [basisconcepten en handleidingen](/core-concepts/project-structure).
|
||||
|
||||
Zoals elke onbekende technologie heeft Astro een leercurve. Met wat oefening en wat geduld krijg je het onder de knie.
|
||||
|
@ -47,11 +47,11 @@ Het [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-account is de of
|
|||
|
||||
We plaatsen ook release-aankondigingen in onze [Discord-community](https://astro.build/chat) in het #announcements kanaal.
|
||||
|
||||
Niet elke Astro-release verdient een eigen blogpost, maar je kunt een gedetailleerde changelog voor elke release vinden in het [CHANGELOG.md-bestand in de Astro-repository](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Niet elke Astro-release verdient een eigen blogpost, maar je kunt een gedetailleerde changelog voor elke release vinden in het [CHANGELOG.md-bestand in de Astro-repository](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Mis je iets?
|
||||
|
||||
Als er iets ontbreekt in de documentatie of als je een onderdeel verwarrend vond, [dien dan een probleem in voor de documentatie](https://github.com/snowpackjs/astro/issues/new/choose) met je suggesties voor verbetering, of tweet naar het [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-account. We horen graag van je!
|
||||
Als er iets ontbreekt in de documentatie of als je een onderdeel verwarrend vond, [dien dan een probleem in voor de documentatie](https://github.com/withastro/astro/issues/new/choose) met je suggesties voor verbetering, of tweet naar het [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter-account. We horen graag van je!
|
||||
|
||||
## Credit
|
||||
|
||||
|
|
|
@ -28,7 +28,7 @@ npm run build
|
|||
|
||||
Voor meer informatie over het voor het gebruik van Astro en het installeren ervan: [lees onze installatie handleiding.](/installation)
|
||||
|
||||
Als je liever leert doormiddel van voorbeelden, bekijk dan de [complete bibliotheek van voorbeelden](https://github.com/snowpackjs/astro/tree/main/examples) op GitHub. Je kan deze voorbeelden lokaal bekijken door het volgende commando uit te voeren: `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
Als je liever leert doormiddel van voorbeelden, bekijk dan de [complete bibliotheek van voorbeelden](https://github.com/withastro/astro/tree/main/examples) op GitHub. Je kan deze voorbeelden lokaal bekijken door het volgende commando uit te voeren: `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
|
||||
## Start je project
|
||||
|
||||
|
|
|
@ -24,7 +24,7 @@ _Nota: algumas funcionalidades (ex: Fast Refresh) no momento estão limitadas no
|
|||
|
||||
Todos os tipos de pessoas vêm ao Astro com diferentes bagagens trazendo com eles diferentes estilos de aprendizagem. Se você prefere uma abordagem mais teórica ou prática, esperamos que você encontre esta seção útil.
|
||||
|
||||
- Se você prefere **aprender fazendo**, comece com nossa [biblioteca de exemplos](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Se você prefere **aprender fazendo**, comece com nossa [biblioteca de exemplos](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Se você prefere **aprender conceitos passo-a-passo**, comece com [conceitos básicos e guias](/core-concepts/project-structure).
|
||||
|
||||
Como qualquer tecnologia emergente, Astro vem com uma leve curva de aprendizado. No entanto, com prática e alguma paciência, sabemos que você _vai_ pegar o jeito da coisa.
|
||||
|
@ -49,11 +49,11 @@ A conta do Twitter [@astrodotbuild](https://twitter.com/astrodotbuild) é a font
|
|||
|
||||
Também publicamos anúncios de lançamento em nossa [comunidade no Discord](https://astro.build/chat) no canal #announcements.
|
||||
|
||||
Nem todo lançamento do Astro merece sua própria postagem no blog, mas você pode encontrar um changelog detalhado para cada lançamento no arquivo [`CHANGELOG.md` no repositório Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
Nem todo lançamento do Astro merece sua própria postagem no blog, mas você pode encontrar um changelog detalhado para cada lançamento no arquivo [`CHANGELOG.md` no repositório Astro](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md).
|
||||
|
||||
## Algo está faltando?
|
||||
|
||||
Se algo estiver faltando na documentação ou se você achar alguma parte confusa, por favor [registre uma nova issue para a documentação](https://github.com/snowpackjs/astro/issues/new/choose) com suas sugestões de melhoria, ou tweet na conta do Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). Nós adoramos ouvir de você!
|
||||
Se algo estiver faltando na documentação ou se você achar alguma parte confusa, por favor [registre uma nova issue para a documentação](https://github.com/withastro/astro/issues/new/choose) com suas sugestões de melhoria, ou tweet na conta do Twitter [@astrodotbuild](https://twitter.com/astrodotbuild). Nós adoramos ouvir de você!
|
||||
|
||||
## Créditos
|
||||
|
||||
|
|
|
@ -30,7 +30,7 @@ npm run build
|
|||
|
||||
To learn more about installing and using Astro for the first time, please [read our installation guide.](/installation)
|
||||
|
||||
If you prefer to learn by example, check out our [complete library of examples](https://github.com/snowpackjs/astro/tree/main/examples) on GitHub. You can check out any of these examples locally by running `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
If you prefer to learn by example, check out our [complete library of examples](https://github.com/withastro/astro/tree/main/examples) on GitHub. You can check out any of these examples locally by running `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
|
||||
## Start your project
|
||||
|
||||
|
|
|
@ -5,7 +5,7 @@ title: Configuration Reference
|
|||
|
||||
To configure Astro, add an `astro.config.mjs` file in the root of your project. All settings are optional.
|
||||
|
||||
You can view the full configuration API (including information about default configuration) on [GitHub.](https://github.com/snowpackjs/astro/blob/latest/packages/astro/src/%40types/astro.ts)
|
||||
You can view the full configuration API (including information about default configuration) on [GitHub.](https://github.com/withastro/astro/blob/latest/packages/astro/src/%40types/astro.ts)
|
||||
|
||||
```js
|
||||
// Example: astro.config.mjs
|
||||
|
|
|
@ -14,7 +14,7 @@ A renderer is an NPM package that has two responsibilities:
|
|||
1. _render a component to a static string of HTML_ at build time.
|
||||
2. _rehydrate that HTML to create an interactive component_ on the client.
|
||||
|
||||
Take a look at any one of Astro's built-in [`renderers`](https://github.com/snowpackjs/astro/tree/main/packages/renderers) to see this in action. We'll go into more detail in the following sections.
|
||||
Take a look at any one of Astro's built-in [`renderers`](https://github.com/withastro/astro/tree/main/packages/renderers) to see this in action. We'll go into more detail in the following sections.
|
||||
|
||||
## Building Your Own Renderer
|
||||
|
||||
|
|
|
@ -15,7 +15,7 @@ Astro – это современный сборщик статических с
|
|||
|
||||
### Примеры проектов
|
||||
|
||||
Если вы предпочитаете учить Astro по примерам, вы можете воспользоваться [полной библиотекой примеров](https://github.com/snowpackjs/astro/tree/main/examples) на GitHub.
|
||||
Если вы предпочитаете учить Astro по примерам, вы можете воспользоваться [полной библиотекой примеров](https://github.com/withastro/astro/tree/main/examples) на GitHub.
|
||||
|
||||
Вы можете установить любой из этих примеров на вашу локальную машину с помощью команды `npm init astro` и дополнительного параметра `--template`. Флаг `--template` также поддерживает сторонние шаблоны.
|
||||
|
||||
|
@ -30,13 +30,13 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
### Онлайн-песочницы
|
||||
|
||||
Если вы хотите попробовать Astro прямо в браузере, можно использовать онлайн-редакторы кода, например, Stackblitz, CodeSandbox, Gitpod или GitHub Codespaces.
|
||||
Также вы можете нажать на кнопку "Open in Stackblitz" в любом из примеров в нашей [библиотеке](https://github.com/snowpackjs/astro/tree/main/examples). Или [нажмите здесь](https://stackblitz.com/fork/astro), чтобы запустить новый проект на [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
Также вы можете нажать на кнопку "Open in Stackblitz" в любом из примеров в нашей [библиотеке](https://github.com/withastro/astro/tree/main/examples). Или [нажмите здесь](https://stackblitz.com/fork/astro), чтобы запустить новый проект на [Stackblitz](https://stackblitz.com/fork/astro).
|
||||
|
||||
## Изучаем Astro
|
||||
|
||||
Люди, приходящие в Astro из разных областей, приносят свой уникальный стиль изучения. Независимо от того, какой стиль изучения вы предпочитаете: теоретический или практический, мы надеемся, этот раздел будет вам полезен.
|
||||
|
||||
- Если вы предпочитаете **изучение на практике**, начните с нашей [библиотеки примеров](https://github.com/snowpackjs/astro/tree/main/examples).
|
||||
- Если вы предпочитаете **изучение на практике**, начните с нашей [библиотеки примеров](https://github.com/withastro/astro/tree/main/examples).
|
||||
- Если вы предпочитаете **изучать принципы шаг за шагом**, начните с [основных принципов и руководств](/core-concepts/project-structure).
|
||||
|
||||
Как любая новая технология, Astro требует немного изучения.
|
||||
|
@ -62,11 +62,11 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
|
||||
Также мы выкладываем анонсы релизов в нашем сообществе в [Discord](https://astro.build/chat) в канале #announcements.
|
||||
|
||||
Не каждый релиз Astro заслуживает отдельной публикации в нашем блоге, но вы можете найти все детали в описании изменений к релизу в файле [`CHANGELOG.md`](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) в нашем репозитории на Github.
|
||||
Не каждый релиз Astro заслуживает отдельной публикации в нашем блоге, но вы можете найти все детали в описании изменений к релизу в файле [`CHANGELOG.md`](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) в нашем репозитории на Github.
|
||||
|
||||
## Что-то упущено?
|
||||
|
||||
Если в документации что-то пропущено или какая-то часть не совсем понятна, пожалуйста, [создайте issue по документации](https://github.com/snowpackjs/astro/issues/new/choose) с вашими предложениями об исправлениях или улучшениях, или упомяните наш [@astrodotbuild](https://twitter.com/astrodotbuild) Твиттер аккаунт в вашем твите. Мы всегда рады услышать ваши мысли об Astro!
|
||||
Если в документации что-то пропущено или какая-то часть не совсем понятна, пожалуйста, [создайте issue по документации](https://github.com/withastro/astro/issues/new/choose) с вашими предложениями об исправлениях или улучшениях, или упомяните наш [@astrodotbuild](https://twitter.com/astrodotbuild) Твиттер аккаунт в вашем твите. Мы всегда рады услышать ваши мысли об Astro!
|
||||
|
||||
## Благодарность
|
||||
|
||||
|
|
|
@ -27,7 +27,7 @@ npm run build
|
|||
|
||||
Чтобы узнать больше об установке и использовании Astro, пожалуйста, [прочитайте нашу инструкцию по установке.](installation)
|
||||
|
||||
Если вы предпочитаете обучаться по примерам, обратите внимание на [нашу библиотеку примеров](https://github.com/snowpackjs/astro/tree/main/examples) на GitHub. Вы можете развернуть любой из примеров локально, запустив команду `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
Если вы предпочитаете обучаться по примерам, обратите внимание на [нашу библиотеку примеров](https://github.com/withastro/astro/tree/main/examples) на GitHub. Вы можете развернуть любой из примеров локально, запустив команду `npm init astro -- --template "EXAMPLE_NAME"`.
|
||||
|
||||
## Запуск вашего проекта
|
||||
|
||||
|
|
|
@ -18,7 +18,7 @@ Astro 仍然缺少一些功能,一些 API 还没有最终确定。虽然项目
|
|||
|
||||
[Docusaurus](https://docusaurus.io/) 是一个流行的文档网站创建工具。Docusaurus 使用 React 来生成你的网站界面,而 Astro 支持 React、 Vue.js 、Svelte 以及原始 HTML 模板。
|
||||
|
||||
Docusaurus 是为建立文档网站而设计的,它有一些内置的、针对文档的网站功能,而 Astro 却没有。相反,Astro 通过一个官方的 [`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs) 主题提供了特定的文档功能,你可以在你的网站尝试使用。本网站就是用这个模板建立的!
|
||||
Docusaurus 是为建立文档网站而设计的,它有一些内置的、针对文档的网站功能,而 Astro 却没有。相反,Astro 通过一个官方的 [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) 主题提供了特定的文档功能,你可以在你的网站尝试使用。本网站就是用这个模板建立的!
|
||||
|
||||
#### 对比 Docusaurus 及 Astro 性能
|
||||
|
||||
|
@ -187,7 +187,7 @@ Nuxt 有很好的内置图片优化功能,这可以使 Nuxt 成为一些图片
|
|||
|
||||
[VuePress](https://vuepress.vuejs.org/guide/)是一个流行的文档网站建设者。VuePress 使用 Vue.js 来生成你的网站用户界面,而 Astro 支持 React、Vue.js、Svelte 和原始 HTML 模板化。
|
||||
|
||||
VuePress 是为建立文档网站而设计的,它有一些内置的、针对文档的网站功能,而 Astro 没有。相反,Astro 通过官方的[`docs`](https://github.com/snowpackjs/astro/tree/main/examples/docs)主题提供了特定的文档功能,你可以在你的网站使用。这个网站就是用这个模板建立的!
|
||||
VuePress 是为建立文档网站而设计的,它有一些内置的、针对文档的网站功能,而 Astro 没有。相反,Astro 通过官方的[`docs`](https://github.com/withastro/astro/tree/main/examples/docs)主题提供了特定的文档功能,你可以在你的网站使用。这个网站就是用这个模板建立的!
|
||||
|
||||
#### 对比 VuePress 及 Astro 性能
|
||||
|
||||
|
|
|
@ -4,6 +4,6 @@ title: 模板样例
|
|||
lang: zh-CN
|
||||
---
|
||||
|
||||
如果你喜欢通过实例来学习,请查看我们在 GitHub 上的[模板样例](https://github.com/snowpackjs/astro/tree/main/examples)
|
||||
如果你喜欢通过实例来学习,请查看我们在 GitHub 上的[模板样例](https://github.com/withastro/astro/tree/main/examples)
|
||||
|
||||
<!-- Once we merge astro-docs back into the main repo, we can actually fetch the list of examples at build-time by scanning the examples/ directory! -->
|
||||
|
|
|
@ -24,7 +24,7 @@ Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页]
|
|||
|
||||
各种各样的人来自不同的背景,带来了不同的学习方式,来到 Astro。无论你喜欢的是理论性强的方法还是实践性强的方法,我们希望你会发现本节内容对你有帮助。
|
||||
|
||||
- 如果你喜欢在**实践中**学习,请从我们的 [实例库](https://github.com/snowpackjs/astro/tree/main/examples) 开始学习。
|
||||
- 如果你喜欢在**实践中**学习,请从我们的 [实例库](https://github.com/withastro/astro/tree/main/examples) 开始学习。
|
||||
|
||||
- 如果你喜欢**逐步学习概念**,请从我们的[基本概念和指南](/core-concepts/project-structure)开始。
|
||||
|
||||
|
@ -50,11 +50,11 @@ Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页]
|
|||
|
||||
我们也在我们的 [Discord 社区](https://astro.build/chat) 的 #announcements 频道中发布 release 公告。
|
||||
|
||||
当然并非每个 Astro 的发布都会有自己的 release 公告,你可以在 Astro 仓库的 [`CHANGELOG.md`文件](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) 中找到每个版本的详细更新日志。
|
||||
当然并非每个 Astro 的发布都会有自己的 release 公告,你可以在 Astro 仓库的 [`CHANGELOG.md`文件](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) 中找到每个版本的详细更新日志。
|
||||
|
||||
## 勘误与建议
|
||||
|
||||
如果你在阅读的过程中发现文档中缺少什么,或者你发现某些部分令人困惑,请 [为文档提交问题](https://github.com/snowpackjs/astro/issues/new/choose) ,提出你的改进建议,或者在 [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter 账户上发推文。我们希望听到你的建议!
|
||||
如果你在阅读的过程中发现文档中缺少什么,或者你发现某些部分令人困惑,请 [为文档提交问题](https://github.com/withastro/astro/issues/new/choose) ,提出你的改进建议,或者在 [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter 账户上发推文。我们希望听到你的建议!
|
||||
|
||||
## 参考
|
||||
|
||||
|
|
|
@ -28,7 +28,7 @@ npm init astro
|
|||
yarn create astro
|
||||
```
|
||||
|
||||
[`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro) 工具让你从预设的 [启动模板](/examples) 中选择,或者你也可以直接从 Github 导入自己的 Astro 项目。
|
||||
[`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro) 工具让你从预设的 [启动模板](/examples) 中选择,或者你也可以直接从 Github 导入自己的 Astro 项目。
|
||||
|
||||
```bash
|
||||
# 提醒:把「my-astro-project」改为项目的名称。
|
||||
|
|
|
@ -4,6 +4,6 @@ title: 範例
|
|||
lang: zh-Hant-TW
|
||||
---
|
||||
|
||||
如果喜歡從做中學,可以看看放在 Github 的[範例資源庫](https://github.com/snowpackjs/astro/tree/main/examples)。
|
||||
如果喜歡從做中學,可以看看放在 Github 的[範例資源庫](https://github.com/withastro/astro/tree/main/examples)。
|
||||
|
||||
<!-- Once we merge astro-docs back into the main repo, we can actually fetch the list of examples at build-time by scanning the examples/ directory! -->
|
||||
|
|
|
@ -16,7 +16,7 @@ Astro 是利用現代技術的靜態網站生成工具。可以從[首頁](https
|
|||
|
||||
### 示範專案
|
||||
|
||||
比較喜歡從範例來學 Astro 的話,請看放在 Github 的[範例資源庫](https://github.com/snowpackjs/astro/tree/main/examples)。
|
||||
比較喜歡從範例來學 Astro 的話,請看放在 Github 的[範例資源庫](https://github.com/withastro/astro/tree/main/examples)。
|
||||
|
||||
這裡的範例都可以在本地端機器執行 `npm init astro` 並加上 CLI Flag: `--template`。
|
||||
`--template` Flag 也支援第三方、社群的範本。
|
||||
|
@ -31,13 +31,13 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
|
||||
### 線上玩玩看
|
||||
|
||||
有興趣在瀏覽器試玩 Astro 的話,可以在 Stackblitz、CodeSandbox、Gitpod 或 GitHub Codespaces 使用線上程式碼編輯器。點選[範例資源庫](https://github.com/snowpackjs/astro/tree/main/examples)裡任一個範例的 "Open in Stackblitz" 連結。或者,[點此](https://stackblitz.com/fork/astro)在 Stackblitz 開啟新專案。
|
||||
有興趣在瀏覽器試玩 Astro 的話,可以在 Stackblitz、CodeSandbox、Gitpod 或 GitHub Codespaces 使用線上程式碼編輯器。點選[範例資源庫](https://github.com/withastro/astro/tree/main/examples)裡任一個範例的 "Open in Stackblitz" 連結。或者,[點此](https://stackblitz.com/fork/astro)在 Stackblitz 開啟新專案。
|
||||
|
||||
## 學習 Astro
|
||||
|
||||
每個來到 Astro 的人來自不同背景,使得學習方式也不同。不管是喜歡更為理論,還是實際的方法,希望都可以覺得這部分很有用。
|
||||
|
||||
- 如果喜歡**從做中學**,從[範例資源庫](https://github.com/snowpackjs/astro/tree/main/examples)開始。
|
||||
- 如果喜歡**從做中學**,從[範例資源庫](https://github.com/withastro/astro/tree/main/examples)開始。
|
||||
- 如果喜歡**一步一步學習概念**,就從[基本概念與指南](/core-concepts/project-structure)開始。
|
||||
|
||||
就像任何還不熟悉的技術,Astro 會有一些學習曲線。只不過,只要練習和一些耐心,我們確信很快就會熟悉。
|
||||
|
@ -62,11 +62,11 @@ npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
|
|||
|
||||
我們也會把釋出版本公告貼在 [Discord 社群](https://astro.build/chat) 的 #announcements 頻道。
|
||||
|
||||
不是每個 Astro 釋出版本都會有一篇專屬的部落格貼文。然而,還是可以在 [Astro 的 Repository 裡的 `CHANGELOG.md` 檔案](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md),找到每個釋出版本的詳細變動記錄。
|
||||
不是每個 Astro 釋出版本都會有一篇專屬的部落格貼文。然而,還是可以在 [Astro 的 Repository 裡的 `CHANGELOG.md` 檔案](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md),找到每個釋出版本的詳細變動記錄。
|
||||
|
||||
## 還漏了什麼嗎?
|
||||
|
||||
如果文件裡有東西沒寫到,或是覺得有些地方很難理解,請[開文件的 Issue](https://github.com/snowpackjs/astro/issues/new/choose),附上改進建議,或推文到推特帳號 [@astrodotbuild](https://twitter.com/astrodotbuild)。我們喜愛聽到回饋!
|
||||
如果文件裡有東西沒寫到,或是覺得有些地方很難理解,請[開文件的 Issue](https://github.com/withastro/astro/issues/new/choose),附上改進建議,或推文到推特帳號 [@astrodotbuild](https://twitter.com/astrodotbuild)。我們喜愛聽到回饋!
|
||||
|
||||
## 參考
|
||||
|
||||
|
|
|
@ -26,7 +26,7 @@ npm init astro
|
|||
yarn create astro
|
||||
```
|
||||
|
||||
[`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro) 精靈提供一些[上手範本](/examples)進行挑選。或者,也可以直接從 Github 匯入自己的 Astro 專案。
|
||||
[`create-astro`](https://github.com/withastro/astro/tree/main/packages/create-astro) 精靈提供一些[上手範本](/examples)進行挑選。或者,也可以直接從 Github 匯入自己的 Astro 專案。
|
||||
|
||||
```bash
|
||||
# 提醒:把「my-astro-project」改為專案的名稱。
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template blog-multiple-authors
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/blog-multiple-authors)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/blog-multiple-authors)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -51,4 +51,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template blog
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/blog)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/blog)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -51,4 +51,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template docs
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/docs)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/docs)
|
||||
|
||||
## Features
|
||||
|
||||
|
@ -32,7 +32,7 @@ To deploy your site to production, check out our [Deploy an Astro Website](https
|
|||
|
||||
## New to Astro?
|
||||
|
||||
Welcome! Check out [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Welcome! Check out [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
||||
|
||||
## Customize This Theme
|
||||
|
|
|
@ -1,8 +1,8 @@
|
|||
---
|
||||
// fetch all commits for just this page's path
|
||||
const path = "docs/" + Astro.props.path;
|
||||
const url = `https://api.github.com/repos/snowpackjs/astro/commits?path=${path}`;
|
||||
const commitsURL = `https://github.com/snowpackjs/astro/commits/main/${path}`;
|
||||
const url = `https://api.github.com/repos/withastro/astro/commits?path=${path}`;
|
||||
const commitsURL = `https://github.com/withastro/astro/commits/main/${path}`;
|
||||
|
||||
async function getCommits(url) {
|
||||
try {
|
||||
|
|
|
@ -6,7 +6,7 @@ export const SITE = {
|
|||
|
||||
export const OPEN_GRAPH = {
|
||||
image: {
|
||||
src: 'https://github.com/snowpackjs/astro/blob/main/assets/social/banner.jpg?raw=true',
|
||||
src: 'https://github.com/withastro/astro/blob/main/assets/social/banner.jpg?raw=true',
|
||||
alt: 'astro logo on a starry expanse of space,' + ' with a purple saturn-like planet floating in the right foreground',
|
||||
},
|
||||
twitter: 'astrodotbuild',
|
||||
|
@ -17,7 +17,7 @@ export const KNOWN_LANGUAGES = {
|
|||
};
|
||||
|
||||
// Uncomment this to add an "Edit this page" button to every page of documentation.
|
||||
// export const GITHUB_EDIT_URL = `https://github.com/snowpackjs/astro/blob/main/docs/`;
|
||||
// export const GITHUB_EDIT_URL = `https://github.com/withastro/astro/blob/main/docs/`;
|
||||
|
||||
// Uncomment this to add an "Join our Community" button to every page of documentation.
|
||||
// export const COMMUNITY_INVITE_URL = `https://astro.build/chat`;
|
||||
|
|
|
@ -4,6 +4,6 @@
|
|||
npm init astro -- --template framework-lit
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-lit)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-lit)
|
||||
|
||||
This example showcases Astro working with [Lit](https://lit.dev/).
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template framework-multiple
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-multiple)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-multiple)
|
||||
|
||||
This example showcases Astro's built-in support for multiple frameworks ([React](https://reactjs.org), [Preact](https://preactjs.com), [Svelte](https://svelte.dev), and [Vue (`v3.x`)](https://v3.vuejs.org/)).
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template framework-preact
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-preact)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-preact)
|
||||
|
||||
This example showcases Astro working with [Preact](https://preactjs.com).
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template framework-react
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-react)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-react)
|
||||
|
||||
This example showcases Astro working with [React](https://reactjs.org/).
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template framework-solid
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-solid)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-solid)
|
||||
|
||||
This example showcases Astro working with [Solid](https://www.solidjs.com/).
|
||||
|
||||
|
|
|
@ -4,6 +4,6 @@
|
|||
npm init astro -- --template framework-svelte
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-svelte)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-svelte)
|
||||
|
||||
This example showcases Astro working with [Svelte](https://svelte.dev/).
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template framework-vue
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/framework-vue)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/framework-vue)
|
||||
|
||||
This example showcases Astro working with [Vue](https://v3.vuejs.org/).
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template minimal
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/minimal)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -40,4 +40,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template portfolio
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/portfolio-svelte)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/portfolio-svelte)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -21,4 +21,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -231,7 +231,7 @@ const featuredProject = projects[0];
|
|||
<h3 class="sectionTitle">About me</h3>
|
||||
<p class="bio">
|
||||
<span>Hello!</span> I’m Jeanine, and this is my website. It was made using{' '}
|
||||
<a href="https://github.com/snowpackjs/astro" target="_blank" rel="nofollow">
|
||||
<a href="https://github.com/withastro/astro" target="_blank" rel="nofollow">
|
||||
Astro
|
||||
</a>
|
||||
, a new way to build static sites. This is just an example template for you to modify.
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template portfolio
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/portfolio)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/portfolio)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -21,4 +21,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -222,7 +222,7 @@ const featuredProject = projects[0];
|
|||
<h3 class="sectionTitle">About me</h3>
|
||||
<p class="bio">
|
||||
<span>Hello!</span> I’m Jeanine, and this is my website. It was made using{' '}
|
||||
<a href="https://github.com/snowpackjs/astro" target="_blank" rel="nofollow">
|
||||
<a href="https://github.com/withastro/astro" target="_blank" rel="nofollow">
|
||||
Astro
|
||||
</a>, a new way to build static sites. This is just an example template for you to modify.
|
||||
</p>
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
# Welcome to [Astro](https://astro.build)
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/starter)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/starter)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -40,4 +40,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -1 +1 @@
|
|||
https://rawcdn.githack.com/snowpackjs/astro/main/examples/starter/public/favicon.ico
|
||||
https://rawcdn.githack.com/withastro/astro/main/examples/starter/public/favicon.ico
|
|
@ -36,7 +36,7 @@ import { Markdown } from 'astro/components';
|
|||
|
||||
<section>
|
||||
<h2>👀 Want to learn more?</h2>
|
||||
<p>Feel free to check <a href="https://github.com/snowpackjs/astro">our documentation</a> or jump into our <a href="https://astro.build/chat">Discord server</a>.</p>
|
||||
<p>Feel free to check <a href="https://github.com/withastro/astro">our documentation</a> or jump into our <a href="https://astro.build/chat">Discord server</a>.</p>
|
||||
</section>
|
||||
|
||||
</article>
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template subpath
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/subpath)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/subpath)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -42,4 +42,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -4,6 +4,6 @@
|
|||
npm init astro -- --template with-markdown-plugins
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/with-markdown-plugins)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/with-markdown-plugins)
|
||||
|
||||
This example showcases Astro's [built-in Markdown support](../../docs/markdown.md) with additional, user-provided plugins.
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template with-markdown
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/with-markdown)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/with-markdown)
|
||||
|
||||
This example showcases Astro's [built-in Markdown support](../../docs/markdown.md).
|
||||
|
||||
|
|
|
@ -4,6 +4,6 @@
|
|||
npm init astro -- --template with-nanostores
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/with-nanostores)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/with-nanostores)
|
||||
|
||||
This example showcases using [`nanostores`](https://github.com/nanostores/nanostores) to provide shared state between components from different frameworks.
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template with-tailwindcss
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/with-tailwindcss)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/with-tailwindcss)
|
||||
|
||||
Astro comes with [Tailwind](https://tailwindcss.com) support out of the box. This example showcases how to style your Astro project with Tailwind.
|
||||
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
npm init astro -- --template minimal
|
||||
```
|
||||
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/snowpackjs/astro/tree/latest/examples/minimal)
|
||||
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal)
|
||||
|
||||
> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun!
|
||||
|
||||
|
@ -40,4 +40,4 @@ All commands are run from the root of the project, from a terminal:
|
|||
|
||||
## 👀 Want to learn more?
|
||||
|
||||
Feel free to check [our documentation](https://github.com/snowpackjs/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
Feel free to check [our documentation](https://github.com/withastro/astro) or jump into our [Discord server](https://astro.build/chat).
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
"private": true,
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git"
|
||||
"url": "https://github.com/withastro/astro.git"
|
||||
},
|
||||
"scripts": {
|
||||
"release": "yarn build:all && changeset publish",
|
||||
|
|
|
@ -8,7 +8,7 @@
|
|||
"types": "./dist/index.d.ts",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git",
|
||||
"url": "https://github.com/withastro/astro.git",
|
||||
"directory": "packages/astro-parser"
|
||||
},
|
||||
"files": [
|
||||
|
|
|
@ -5,7 +5,7 @@
|
|||
"main": "index.mjs",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git",
|
||||
"url": "https://github.com/withastro/astro.git",
|
||||
"directory": "packages/astro-prism"
|
||||
},
|
||||
"scripts": {},
|
||||
|
|
|
@ -31,7 +31,7 @@
|
|||
|
||||
This new version of Astro includes:
|
||||
|
||||
- A new, faster, [Go-based compiler](https://github.com/snowpackjs/astro-compiler)
|
||||
- A new, faster, [Go-based compiler](https://github.com/withastro/astro-compiler)
|
||||
- A completely new runtime backed by [Vite](https://vitejs.dev/), with significantly dev experience improvements
|
||||
- Improved support for loading Astro config files, including `.cjs`, `.js`, and `.ts` files
|
||||
- And [many more features](https://astro.build/blog/astro-021-preview/)!
|
||||
|
@ -1039,7 +1039,7 @@ _Rolling back to 0.13.10 to prevent a regression in the dev server output._
|
|||
### Patch Changes
|
||||
|
||||
- 6573bea: Fixed README header aspect ratio
|
||||
- 2671b6f: Fix [472](https://github.com/snowpackjs/astro/issues/472) by not injecting `astro-*` scoped class unless it is actually used
|
||||
- 2671b6f: Fix [472](https://github.com/withastro/astro/issues/472) by not injecting `astro-*` scoped class unless it is actually used
|
||||
- b547892: Makes providing a head element on pages optional
|
||||
- b547892: Allows astro documents to omit the head element
|
||||
- 0abd251: Allows renderers to provide knownEntrypoint config values
|
||||
|
@ -1189,7 +1189,7 @@ _Rolling back to 0.13.10 to prevent a regression in the dev server output._
|
|||
### Patch Changes
|
||||
|
||||
- 0d6afae: Fixes a few small bugs with the `Markdown` component when there are multiple instances on the same page
|
||||
- 1d930ff: Adds [`--verbose`](https://docs.astro.build/cli.md#--verbose) and [`--reload`](https://github.com/snowpackjs/astro/blob/main/docs/cli/#--reload) flags to the `astro` CLI.
|
||||
- 1d930ff: Adds [`--verbose`](https://docs.astro.build/cli.md#--verbose) and [`--reload`](https://github.com/withastro/astro/blob/main/docs/cli/#--reload) flags to the `astro` CLI.
|
||||
|
||||
## 0.12.3
|
||||
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
<img src="https://github.com/snowpackjs/astro/blob/main/assets/social/banner.jpg?raw=true" />
|
||||
<img src="https://github.com/withastro/astro/blob/main/assets/social/banner.jpg?raw=true" />
|
||||
|
||||
**Astro** is a _fresh but familiar_ approach to building websites. Astro combines decades of proven performance best practices with the DX improvements of the component-oriented era. Use your favorite JavaScript framework and automatically ship the bare-minimum amount of JavaScript—by default.
|
||||
|
||||
|
@ -31,8 +31,8 @@ You can sponsor Astro's development on [Open Collective][oc]. Astro is generousl
|
|||
<table>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td align="center"><a href="https://www.netlify.com/" target="_blank"><img width="147" height="40" src="https://raw.githubusercontent.com/snowpackjs/astro/main/.github/assets/netlify.svg" alt="Netlify" /></a></td>
|
||||
<td align="center"><a href="https://www.vercel.com/" target="_blank"><img width="150" height="34" src="https://raw.githubusercontent.com/snowpackjs/astro/main/.github/assets/vercel.svg" alt="Vercel" /></a></td>
|
||||
<td align="center"><a href="https://www.netlify.com/" target="_blank"><img width="147" height="40" src="https://raw.githubusercontent.com/withastro/astro/main/.github/assets/netlify.svg" alt="Netlify" /></a></td>
|
||||
<td align="center"><a href="https://www.vercel.com/" target="_blank"><img width="150" height="34" src="https://raw.githubusercontent.com/withastro/astro/main/.github/assets/vercel.svg" alt="Vercel" /></a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
@ -42,7 +42,7 @@ You can sponsor Astro's development on [Open Collective][oc]. Astro is generousl
|
|||
<table>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td align="center"><a href="https://sentry.io" target="_blank"><img width="147" height="40" src="https://raw.githubusercontent.com/snowpackjs/astro/main/.github/assets/sentry.svg" alt="Sentry" /></a></td>
|
||||
<td align="center"><a href="https://sentry.io" target="_blank"><img width="147" height="40" src="https://raw.githubusercontent.com/withastro/astro/main/.github/assets/sentry.svg" alt="Sentry" /></a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
@ -63,7 +63,7 @@ Please upgrade to a version of Node.js with complete ESM support: "^12.20.0 || ^
|
|||
console.error(`\nNode.js v${version} is not supported by Astro!
|
||||
Supported versions: ${engines}\n
|
||||
Issue Detected! This Node.js version was expected to work, but failed a system check.
|
||||
Please file an issue so that we can take a look: https://github.com/snowpackjs/astro/issues/new\n`);
|
||||
Please file an issue so that we can take a look: https://github.com/withastro/astro/issues/new\n`);
|
||||
} else {
|
||||
console.error(`\nNode.js v${version} is not supported by Astro!
|
||||
Please upgrade Node.js to a supported version: "${engines}"\n`);
|
||||
|
|
|
@ -9,7 +9,7 @@
|
|||
"types": "./dist/types/@types/astro.d.ts",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git",
|
||||
"url": "https://github.com/withastro/astro.git",
|
||||
"directory": "packages/astro"
|
||||
},
|
||||
"exports": {
|
||||
|
|
|
@ -105,7 +105,7 @@ ${source}
|
|||
\`\`\`
|
||||
`,
|
||||
});
|
||||
err.url = `https://github.com/snowpackjs/astro/issues/new?${search.toString()}`;
|
||||
err.url = `https://github.com/withastro/astro/issues/new?${search.toString()}`;
|
||||
err.message = `Error: Uh oh, the Astro compiler encountered an unrecoverable error!
|
||||
|
||||
Please open
|
||||
|
|
|
@ -43,4 +43,4 @@ May be provided in place of prompts
|
|||
| `--template` | Specify the template name ([list][examples]) |
|
||||
| `--commit` | Specify a specific Git commit or branch to use from this repo (by default, `main` branch of this repo will be used) |
|
||||
|
||||
[examples]: https://github.com/snowpackjs/astro/tree/main/examples
|
||||
[examples]: https://github.com/withastro/astro/tree/main/examples
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
"type": "module",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git",
|
||||
"url": "https://github.com/withastro/astro.git",
|
||||
"directory": "packages/create-astro"
|
||||
},
|
||||
"exports": {
|
||||
|
|
|
@ -32,7 +32,7 @@ const POSTPROCESS_FILES = ['package.json', 'astro.config.mjs', 'CHANGELOG.md'];
|
|||
|
||||
export async function main() {
|
||||
console.log(`\n${bold('Welcome to Astro!')} ${gray(`(create-astro v${version})`)}`);
|
||||
console.log(`If you encounter a problem, visit ${cyan('https://github.com/snowpackjs/astro/issues')} to search or file a new issue.\n`);
|
||||
console.log(`If you encounter a problem, visit ${cyan('https://github.com/withastro/astro/issues')} to search or file a new issue.\n`);
|
||||
|
||||
console.log(`${green(`>`)} ${gray(`Prepare for liftoff.`)}`);
|
||||
console.log(`${green(`>`)} ${gray(`Gathering mission details...`)}`);
|
||||
|
@ -70,7 +70,7 @@ export async function main() {
|
|||
|
||||
const hash = args.commit ? `#${args.commit}` : '';
|
||||
|
||||
const templateTarget = options.template.includes('/') ? options.template : `snowpackjs/astro/examples/${options.template}#latest`;
|
||||
const templateTarget = options.template.includes('/') ? options.template : `withastro/astro/examples/${options.template}#latest`;
|
||||
|
||||
const emitter = degit(`${templateTarget}${hash}`, {
|
||||
cache: false,
|
||||
|
@ -109,13 +109,13 @@ export async function main() {
|
|||
// Warning for issue #655
|
||||
if (err.message === 'zlib: unexpected end of file') {
|
||||
console.log(yellow("This seems to be a cache related problem. Remove the folder '~/.degit/github/snowpackjs' to fix this error."));
|
||||
console.log(yellow('For more information check out this issue: https://github.com/snowpackjs/astro/issues/655'));
|
||||
console.log(yellow('For more information check out this issue: https://github.com/withastro/astro/issues/655'));
|
||||
}
|
||||
|
||||
// Helpful message when encountering the "could not find commit hash for ..." error
|
||||
if (err.code === 'MISSING_REF') {
|
||||
console.log(yellow("This seems to be an issue with degit. Please check if you have 'git' installed on your system, and install it if you don't have (https://git-scm.com)."));
|
||||
console.log(yellow("If you do have 'git' installed, please file a new issue here: https://github.com/snowpackjs/astro/issues"));
|
||||
console.log(yellow("If you do have 'git' installed, please file a new issue here: https://github.com/withastro/astro/issues"));
|
||||
}
|
||||
process.exit(1);
|
||||
}
|
||||
|
|
|
@ -5,7 +5,7 @@
|
|||
"type": "module",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/snowpackjs/astro.git",
|
||||
"url": "https://github.com/withastro/astro.git",
|
||||
"directory": "packages/markdown/remark"
|
||||
},
|
||||
"exports": {
|
||||
|
|
|
@ -36,7 +36,7 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 24 24"><path d="M24 4.557c-.883.392-1.832.656-2.828.775 1.017-.609 1.798-1.574 2.165-2.724-.951.564-2.005.974-3.127 1.195-.897-.957-2.178-1.555-3.594-1.555-3.179 0-5.515 2.966-4.797 6.045-4.091-.205-7.719-2.165-10.148-5.144-1.29 2.213-.669 5.108 1.523 6.574-.806-.026-1.566-.247-2.229-.616-.054 2.281 1.581 4.415 3.949 4.89-.693.188-1.452.232-2.224.084.626 1.956 2.444 3.379 4.6 3.419-2.07 1.623-4.678 2.348-7.29 2.04 2.179 1.397 4.768 2.212 7.548 2.212 9.142 0 14.307-7.721 13.995-14.646.962-.695 1.797-1.562 2.457-2.549z"/></svg>
|
||||
Twitter
|
||||
</a>
|
||||
<a class="header-subitem header-subitem-secondary" href="https://github.com/snowpackjs/astro" target="_blank">
|
||||
<a class="header-subitem header-subitem-secondary" href="https://github.com/withastro/astro" target="_blank">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
|
||||
</svg>
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
<!-- Place this tag where you want the button to render. -->
|
||||
<div class="hidden-mobile" style="text-align: center; height: 36px; margin-top: 0.75rem;">
|
||||
<a class="github-button" href="https://github.com/snowpackjs/astro" data-icon="octicon-star"
|
||||
data-size="large" data-show-count="true" aria-label="Star snowpackjs/astro on GitHub">Star</a>
|
||||
<a class="github-button" href="https://github.com/withastro/astro" data-icon="octicon-star"
|
||||
data-size="large" data-show-count="true" aria-label="Star withastro/astro on GitHub">Star</a>
|
||||
</div>
|
||||
<!-- Place this tag in your head or just before your close body tag. -->
|
||||
<script async="async" defer="defer" src="https://buttons.github.io/buttons.js"></script>
|
|
@ -47,7 +47,7 @@
|
|||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a class="header-subitem header-subitem-secondary" href="https://github.com/snowpackjs/astro">
|
||||
<a class="header-subitem header-subitem-secondary" href="https://github.com/withastro/astro">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
|
||||
</svg>
|
||||
|
|
|
@ -42,7 +42,7 @@ Named slots are particularly useful for page layouts. A layout can now specify s
|
|||
|
||||
<img src="/assets/blog/astro-018/solid-logo-dark.svg" alt="Solid.js logo" style="background-color: rgb(65, 64, 66); padding: 2rem 4rem;" />
|
||||
|
||||
[Solid](https://www.solidjs.com/) is a JSX-based UI framework that bills itself as the familiar, modern, more reactive alternative to React. We're really excited about Solid, and with the new [Solid renderer](https://github.com/snowpackjs/astro/tree/main/packages/renderers/renderer-solid) for Astro you can use Solid as a first-class framework in your project.
|
||||
[Solid](https://www.solidjs.com/) is a JSX-based UI framework that bills itself as the familiar, modern, more reactive alternative to React. We're really excited about Solid, and with the new [Solid renderer](https://github.com/withastro/astro/tree/main/packages/renderers/renderer-solid) for Astro you can use Solid as a first-class framework in your project.
|
||||
|
||||
Adding support for Solid (our third officially-supported JSX framework) wasn't easy, and required a major refactoring of how Astro handles JSX. The final result was worth it: Astro is now much better at supporting different types of JSX and can even support the new React v17 JSX transform. This new foundation for Astro should support us well into the future.
|
||||
|
||||
|
@ -53,7 +53,7 @@ The release of Solid v1.0 is the perfect showcase for Astro's multi-framework pr
|
|||
|
||||
![Lit logo](/assets/blog/astro-018/lit-logo.svg)
|
||||
|
||||
Server-side rendering (SSR) for web components is finally here, thanks to Lit and the new [Lit renderer for Astro](https://github.com/snowpackjs/astro/tree/main/packages/renderers/renderer-lit).
|
||||
Server-side rendering (SSR) for web components is finally here, thanks to Lit and the new [Lit renderer for Astro](https://github.com/withastro/astro/tree/main/packages/renderers/renderer-lit).
|
||||
|
||||
Thanks to the [Declarative Shadow DOM](https://web.dev/declarative-shadow-dom/) -- a new HTML feature that's now available in Chrome -- the Lit project was able to release experimental SSR support for Lit. Define a custom element in JavaScript and server render it with Astro as you would any other component from React or Vue. Unlike other JS components, you still use the custom element tag name in your HTML.
|
||||
|
||||
|
@ -66,7 +66,7 @@ We've been absolutely blown away by the love Astro has recieved in such a short
|
|||
- Featured articles and guides from [Netlify](https://www.netlify.com/blog/2021/07/23/build-a-modern-shopping-site-with-astro-and-serverless-functions/), [Cloudflare](https://developers.cloudflare.com/pages/framework-guides/astro), [CSS Tricks](https://css-tricks.com/a-look-at-building-with-astro/), and more.
|
||||
- Over 2,000 developers have downloaded the [Astro VSCode extension](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)
|
||||
- Over 500 weekly visitors to our [amazing Discord](https://astro.build/chat)
|
||||
- Over 300 public projects using Astro [on Github](https://github.com/snowpackjs/astro)
|
||||
- Over 300 public projects using Astro [on Github](https://github.com/withastro/astro)
|
||||
- 2 (TWO!) Astro jobs already posted on Discord!
|
||||
- [GitHub adds support for Astro component syntax highlighting](https://twitter.com/n_moore/status/1417881860051509250)
|
||||
|
||||
|
|
|
@ -130,7 +130,7 @@ Not all developers speak English. In fact, most don't. Luckily, some amazing con
|
|||
- [Suomi](https://docs.astro.build/fi/getting-started)
|
||||
- [Русский](https://docs.astro.build/ru/getting-started)
|
||||
|
||||
These are still a work in progress, and we'll keep working towards 100% translation as we creep closer to a v1.0 release. If you know a few languages and are able to contribute, [we could really use your help!](https://github.com/snowpackjs/astro/blob/main/CONTRIBUTING.md#translations)
|
||||
These are still a work in progress, and we'll keep working towards 100% translation as we creep closer to a v1.0 release. If you know a few languages and are able to contribute, [we could really use your help!](https://github.com/withastro/astro/blob/main/CONTRIBUTING.md#translations)
|
||||
|
||||
## Open Collective
|
||||
|
||||
|
@ -142,7 +142,7 @@ We created an Open Collective because corporate sponsorship is one of the few pr
|
|||
|
||||
Chances are, your company benefits from open source software. Invest in the technologies that power your business by sponsoring Astro and any other open source projects that you use. **Bonus:** thousands of developers will see your logo on our README and the [astro.build homepage](https://astro.build), every day.
|
||||
|
||||
100% of funds raised are invested directly back into the project and our community. You can read more about how funds are distributed by reading our [FUNDING.md](https://github.com/snowpackjs/astro/blob/main/FUNDING.md) doc on GitHub.
|
||||
100% of funds raised are invested directly back into the project and our community. You can read more about how funds are distributed by reading our [FUNDING.md](https://github.com/withastro/astro/blob/main/FUNDING.md) doc on GitHub.
|
||||
|
||||
We'll be tweeting out personal "thank you" messages to every person and company who hits the ["Sponsor"](https://opencollective.com/astrodotbuild) button in the next 48 hours. Our first, very special THANK YOU goes out to [Chris Jennings](https://twitter.com/ckj), CCO and co-founder of [Sentry](https://sentry.io/), for being our first official sponsor! 🎉
|
||||
|
||||
|
|
|
@ -37,9 +37,9 @@ This switch from Snowpack to Vite might come as a surprise to some: Both Drew an
|
|||
|
||||
## Hello, WASM!
|
||||
|
||||
Astro 0.21 features another huge low-level improvement: the brand new [@astrojs/compiler](https://github.com/snowpackjs/astro-compiler-next). Astro's new compiler is written in Go and distributed as WASM. You can run it right in your browser, or on the server in Node.js and Deno.
|
||||
Astro 0.21 features another huge low-level improvement: the brand new [@astrojs/compiler](https://github.com/withastro/astro-compiler-next). Astro's new compiler is written in Go and distributed as WASM. You can run it right in your browser, or on the server in Node.js and Deno.
|
||||
|
||||
The new [@astrojs/compiler](https://github.com/snowpackjs/astro-compiler-next) unlocks:
|
||||
The new [@astrojs/compiler](https://github.com/withastro/astro-compiler-next) unlocks:
|
||||
|
||||
- **Flexibility:** Run the compiler anywhere with WASM.
|
||||
- **Speed:** Build sites faster with Go's compiled-language performance.
|
||||
|
@ -89,7 +89,7 @@ Now, Astro's dev server sends HTML updates to the browser and then runs a small
|
|||
|
||||
## Try it today
|
||||
|
||||
If you've read this far, we'd love your help trying out the latest release before launch. You can try out our latest release today [in the browser](https://gitpod.io#snapshot/5e7cf2f1-8108-4fa5-99d3-ed8de70d8c23) or by running `npm install astro@next--compiler` in a new project directory. You can follow our progress and leave feedback in the `next` PR on GitHub: https://github.com/snowpackjs/astro/pull/1406
|
||||
If you've read this far, we'd love your help trying out the latest release before launch. You can try out our latest release today [in the browser](https://gitpod.io#snapshot/5e7cf2f1-8108-4fa5-99d3-ed8de70d8c23) or by running `npm install astro@next--compiler` in a new project directory. You can follow our progress and leave feedback in the `next` PR on GitHub: https://github.com/withastro/astro/pull/1406
|
||||
|
||||
Leave feedback, report bugs, and get involved with Astro's development in our [Discord server](https://astro.build/chat). You can also [follow along](https://twitter.com/astrodotbuild) on Twitter.
|
||||
|
||||
|
|
|
@ -94,7 +94,7 @@ By building your site to static HTML by default, Astro makes it difficult (but n
|
|||
|
||||
Astro is built by the team of open source developers behind [Snowpack](https://snowpack.dev) and [Skypack](https://skypack.dev), with additional contributions from the community.
|
||||
|
||||
**Astro is and always will be free.** It is an open source project released under the [MIT license](https://github.com/snowpackjs/astro/blob/main/LICENSE).
|
||||
**Astro is and always will be free.** It is an open source project released under the [MIT license](https://github.com/withastro/astro/blob/main/LICENSE).
|
||||
|
||||
We care deeply about building a more sustainable future for open source software. At the same time, we need to support Astro's development long-term. This requires money (donations alone aren't enough.)
|
||||
|
||||
|
|
Loading…
Reference in a new issue