diff --git a/docs/src/components/Header/LanguageSelect.tsx b/docs/src/components/Header/LanguageSelect.tsx index 815bef472..a5fb73f78 100644 --- a/docs/src/components/Header/LanguageSelect.tsx +++ b/docs/src/components/Header/LanguageSelect.tsx @@ -70,6 +70,9 @@ const LanguageSelect: FunctionalComponent<{ lang: string }> = ({ lang }) => { + ); diff --git a/docs/src/config.ts b/docs/src/config.ts index 2ff25dd90..b66dc9d01 100644 --- a/docs/src/config.ts +++ b/docs/src/config.ts @@ -65,6 +65,10 @@ export const SIDEBAR = { { text: '安裝', link: 'zh-TW/installation' }, { text: '範例', link: 'zh-TW/examples' }, ], + bg: [ + { text: 'Главни', header: true }, + { text: 'Започваме!', link: 'bg/getting-started' } + ] }; export const SITE = { diff --git a/docs/src/pages/bg/getting-started.md b/docs/src/pages/bg/getting-started.md new file mode 100644 index 000000000..f34dfa85c --- /dev/null +++ b/docs/src/pages/bg/getting-started.md @@ -0,0 +1,62 @@ +--- +layout: ~/layouts/MainLayout.astro +title: Започваме! +--- + +Astro е модерен builder за статични сайтове. Научете всичко за Astro от [нашата начална страница](https://astro.build/) или от [release поста](https://astro.build/blog/introducing-astro). Тази страница е оглед на документацията на Astro и всички свързани ресурси. + +За бърз оглед на Astro, посетете нашата [начална страница](https://astro.build). + +## Пробвайте Astro + +Най-лесният начин да пробвате Astro е да изпълните `npm init astro` в нова локална директория. Нашият CLI Wizard ще Ви помогне да започнете нов Astro проект. + +За да започнете с Astro в 5 бързи и лесни стъпки, посетете нашия [Гид за бърз старт](quick-start). + +Алтернативно, можете да прочетете нашия [Инсталационен гид](/installation) за всичко относно настройката на Astro. + +### Онлайн площадки (playgrounds) + +Ако искате да си експериментирате с Astro в браузъра, можете да използвате онлайн площадка за код. Пробвайте нашия "Hello World!" темплейт на [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3). + +_Бележка: някои функционалности (например: Fast Refresh) са лимитирани на CodeSandbox засега._ + +## Научете Astro + +Всякакви видове хора с различни методи за обучение се ориентират към Astro. Независимо дали предпочитате по-теоретичен, или по-практически подход, ние се надяваме че ще намерите тази секция за полезна. + +- Ако предпочитате да **учите чрез практика**, започнете с нашата [библиотека с примери](https://github.com/snowpackjs/astro/tree/main/examples). +- Ако предпочитате да **учите концепции стъпка по стъпка**, започнете с нашите [базови концепции и гидове](/core-concepts/project-structure). + +Като всяка непозната технология, Astro изисква известно време, за да се научи. Но с практика и малко търпение, ние сме сигурни, че _ще го схванете_ за нула време. + +### Научете `.astro` синтаксис + +Когато започнете да учите Astro, ще видите много файлове с разширение `.astro`. Това е **Компонентният синтаксис на Astro** - +специален файлов формат наподобяващ HTML, който Astro използва за изграждане на страници (templating). Направен е, така че да е познат на всеки с HTML или JSX опит. + +Нашият помощен гид за [Astro компонентите](/core-concepts/astro-components) Ви запознава със синтаксисът на Astro и е най-добрият начин да се научите. + +### API Справка + +Тази секция е полезна, когато искате да научите повече детайли относно даден Astro API. Например - [Конфигурационната справка](/reference/configuration-reference) изброява всички възможни конфигурационни опции. [Справката за вградени компоненти](/reference/builtin-components) изброява всички възможни базови (core) компоненти, като `` и ``. + +### Версия на документацията + +Тази документация винаги рефлектира последната стабилна версия на Astro. Когато пуснем версия 1.0, ще добавим опция за преглед на предишни или бъдещи версии. + +## Бъдете информирани + +Официалният източник за новини от екипа на Astro е Twitter акаунтът - [@astrodotbuild](https://twitter.com/astrodotbuild). + +Публикуваме и съобщения относно нови версии в [нашия Discord сървър](https://astro.build/chat) в #announcements канала. + +Не всяка нова версия на Astro заслужава собствен блог пост, но можете да намерите регистър на промените за всеки релийз в [`CHANGELOG.MD` файла, намиращ се в репото на Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md). + +## Нещо липсва? + +Ако нещо липсва в документацията или намирате нещо за объркващо, моля [подайте го като issue за документацията](https://github.com/snowpackjs/astro/issues/new/choose) с Вашите предложения за подобрение или пуснете tweet към [@astrodotbuild](https://twitter.com/astrodotbuild). Обичаме да чуваме от Вас! + +## Credit + +Първоначално този гид е базиран на документацията на [React](https://reactjs.org/). diff --git a/docs/src/pages/index.astro b/docs/src/pages/index.astro index 2b090ca81..eaa67e524 100644 --- a/docs/src/pages/index.astro +++ b/docs/src/pages/index.astro @@ -6,7 +6,7 @@ import Layout from '../layouts/MainLayout.astro'; // This is some wip redirect code based on the browser language. // A vercel.json redirect is enforced in production, so no user should ever see this page. // Remove the vercel.json redirect when this is ready. - const KNOWN_LANGUAGES = ['de','en','es','fi','nl','pt-br','zh-CN','zh-TW']; + const KNOWN_LANGUAGES = ['bg', 'de','en','es','fi','nl','pt-br','zh-CN','zh-TW']; let newLangWithRegion = (window.navigator.userLanguage || window.navigator.language || 'en-US').substr(0, 5); let newLang = newLangWithRegion.substr(0, 2); if (newLang === 'en') { @@ -18,4 +18,4 @@ import Layout from '../layouts/MainLayout.astro'; } else { window.location.pathname = '/getting-started'; } - \ No newline at end of file +