Как использовать руководства
Что такое Ember?
Ember.js — это продуктивный, проверенный временем JavaScript-фреймворк для создания современных веб-приложений. Он включает в себя всё необходимое для построения богатых пользовательских интерфейсов, работающих на любом устройстве. Он делает это, предоставляя разработчикам множество функций, которые необходимы для управления сложностью современных веб-приложений, а также интегрированный инструментарий разработки, который позволяет быстро итеративно работать.
Некоторые из этих функций, о которых вы узнаете из руководств, это:
- Ember CLI — мощный инструментарий разработки для создания, разработки и сборки приложений Ember. Ознакомьтесь с основными командами в руководствах по CLI.
- Компоненты — фундаментальная конструкция, используемая в приложениях Ember, используемая для создания повторно используемых элементов пользовательского интерфейса и определения макета и функциональности приложения.
- Маршрутизация — центральная часть приложения Ember. Позволяет разработчикам управлять состоянием приложения из URL.
- Сервисы — способ хранить долгосрочное состояние в вашем приложении и передавать его.
- Ember Data — Ember Data предоставляет согласованный способ взаимодействия с внешними API и управления состоянием приложения
- Ember Inspector — расширение браузера или закладка для инспектирования вашего приложения в реальном времени. Он также полезен для обнаружения приложений Ember в дикой природе, попробуйте установить его и открыть сайт NASA!
Структура
В левой части каждой страницы руководств находится оглавление, организованное в разделах, которые можно развернуть, чтобы увидеть темы, которые они охватывают. Как разделы, так и темы в каждом разделе упорядочены от базовых до продвинутых концепций.
Руководства предназначены для содержать практические объяснения того, как создавать приложения Ember, ориентируясь на наиболее часто используемые функции Ember.js. Для получения исчерпывающей документации по каждой функции и API Ember см. документацию API Ember.js.
Руководства начинаются с объяснения того, как начать работу с Ember, за которым следует учебник о том, как создать ваше первое приложение Ember. Если вы новичок в Ember, мы рекомендуем начать с этих двух первых разделов руководств.
Предположения
Хотя мы стараемся сделать руководства максимально понятными для новичков, мы должны установить базовый уровень, чтобы руководства могли оставаться сосредоточенными на функциональности Ember.js. Мы постараемся ссылаться на соответствующую документацию всякий раз, когда вводится новая концепция.
Чтобы получить максимальную пользу от руководств, вам необходимо иметь практические знания по HTML, CSS и JavaScript — строительным блокам веб-страниц. Вы можете узнать больше о каждой из этих технологий в руководстве Работа с HTML, CSS и JavaScript, включая некоторые из специальных функций, которые использует Ember, такие как поля класса и декораторы.
Доступность
Если вы используете экранный читатель во время работы с руководствами, мы рекомендуем использовать Firefox и NVDA или Safari и VoiceOver для наилучшего опыта.
Сообщения о проблемах
Опечатки, пропущенные слова и примеры кода с ошибками считаются ошибками в документации. Если вы обнаружите одну из них или хотите улучшить существующие руководства, мы с удовольствием поможем вам помочь нам!
Вот некоторые из наиболее распространенных способов сообщить о проблеме с руководствами:
- Используйте значок карандаша в правом верхнем углу каждой страницы руководства
- Откройте вопрос или запрос на вытягивание в репозиторий GitHub
Нажатие значка карандаша переведет вас в редактор GitHub для этого руководства, чтобы вы могли сразу же редактировать его, используя язык разметки Markdown. Это самый быстрый способ исправить опечатку, пропущенное слово или ошибку в примере кода.
Если вы хотите внести более существенный вклад, обязательно проверьте наш отслеживатель проблем, чтобы узнать, не решается ли уже ваша проблема. Если вы не найдете активного вопроса, откройте новый.
Если у вас есть вопросы о стилях или процессе внесения вклада, вы можете ознакомиться с нашим руководством по внесению вклада. Если ваш вопрос останется без ответа, обратитесь к нам в канале #dev-ember-learning в Discord-сообществе Ember.
Удачи!
© 2022 Yehuda Katz, Tom Dale and Ember.js contributors
Licensed under the MIT License.
https://guides.emberjs.com/v3.28.0/getting-started