1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/mirrors-pxt

Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

Microsoft MakeCode

Microsoft MakeCode основан на открытом проекте Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode — это имя, используемое в пользовательских редакторах, PXT используется во всех исходных кодах на GitHub.

PXT — это фреймворк для создания специализированных программных сред для начинающих, особенно ориентированный на образование в области информатики. Основной язык программирования PXT — это подмножество TypeScript (с исключением динамических возможностей JavaScript).

Основные возможности PXT:

  • блоковый редактор кода на основе Blockly и конвертер в текстовый формат
  • редактор кода на основе Monaco, который используется в VS Code, функции редактора перечислены здесь.
  • поддержка расширяемости для определения новых блоков на TypeScript
  • генератор машинного кода ARM Thumb
  • утилита управления пакетами командной строки

Дополнительная информация:

Примеры редакторов, построенных с помощью MakeCode:

Ветки

  • master — это активная ветка разработки, в настоящее время используется v3.* сборки
  • v* — это ветка обслуживания для v*.* сборок## Запуск целевой системы с локального сервера

Пожалуйста, следуйте инструкциям здесь.

Связывание целевой системы с PXT

Если вы изменяете свою собственную версию PXT и хотите, чтобы целевая система (например, pxt-microbit) использовала вашу локальную версию, перейдите в директорию целевой системы (например, pxt-microbit, которая должна быть сестринской директорией pxt) и выполните

pxt link ../pxt

Если у вас есть несколько версий pxt, вы можете сделать следующее:

  • выполните npm i в pxt и целевой системе
  • в целевой системе выполните pxt link ..\some-other-pxt (может потребоваться обновление вашей CLI, выполните npm install -g pxt)

Если вы выполните npm i после этого (в целевой системе или pxt), вам может потребоваться повторить эти шаги.

Сборка

Сначала установите Node: минимальная версия 8. Для сборки командных строковых инструментов PXT:

npm install
npm run build

Затем установите командный строковый инструмент pxt (необходимо выполнить только один раз):

npm install -g pxt

Затем установите gulp (необходимо выполнить только один раз):

npm install -g gulp

После этого вы сможете запустить pxt из любой точки дерева сборки.

Чтобы запустить локальный веб-сервер, выполните pxt serve из корневой директории целевого приложения (например, pxt-microbit). PXT откроет редактор в вашем по умолчанию веб-браузере.Если вы разрабатываете для pxt, вы можете запустить gulp watch из корневой директории репозитория pxt для отслеживания изменений и пересборки.

gulp watch

Если вы работаете исключительно над CLI,

gulp watchCli

Если вам не нужно собирать набор связанных веб-приложений (skillmap, многопользовательский режим и т.д.), вы можете пропустить их и немного ускорить сборку:

gulp --no-webapps

Иконки

В директории svgicons/ находятся несколько пользовательских иконок (для использования в дополнение к http://semantic-ui.com/elements/icon.html). Эти иконки должны быть размером 1000x1000px. Лучше всего начать с существующей иконки. Чтобы просмотреть доступные иконки, перейдите на http://localhost:3232/icons.html (этот файл, а также icons.css, содержащий сгенерированный WOFF шрифт иконок, создается во время сборки).

Если у вас возникли проблемы с отображением созданной иконки, попробуйте:

npm install -g svgo
svgo svgicons/myicon.svg

Общее стилирование

Когда вы добавляете CSS-цвет или другой элемент стиля, который будет использоваться в редакторах целевых приложений (например, micro:bit, Arcade) и под-приложениях (например, skillmap, teachertool и т.д.), объявите переменную CSS для него в theme/themepacks.less:1. Добавьте новую переменную в псевдокласс :root. Выберите разумное значение по умолчанию в соответствии с рекомендациями в файле. 2. Добавьте новую переменную во все темы, определенные в этом файле. На момент написания этого текста определена только тема theme-highcontrast. Выберите значение, которое хорошо работает для данной темы. 3. Добавьте новую переменную в темы для каждого целевого приложения. Это будет выполнено в файле theme/themepacks.less целевого репозитория (например, pxt-microbit, pxt-arcade).Переменные, объявленные таким образом, будут доступны для под-приложений во время выполнения, и они будут инициализированы значениями, определенными целевым приложением, в котором они выполняются.### Выделение кода в документации

В документации выделение фрагментов кода осуществляется с помощью highlight.js (hljs). В настоящее время включены следующие языки:

  • TypeScript
  • Python
  • JavaScript
  • HTML, XML
  • Markdown

Если вам необходимо добавить другие языки или обновить существующие, вы можете найти распределение по адресу https://highlightjs.org/download/; выберите все языки, которые вы хотите включить (включая указанные выше!), скачайте и распакуйте, а затем скопируйте highlight.pack.js в webapp/public/highlight.js/.

Тесты

Тесты расположены в подпапке tests/ и представляют собой комбинацию тестов на уровне модуля и браузерных тестов. Для их выполнения запустите npm run test:all в корневой директории.

Лицензия

MIT License

Код поведения

Этот проект использует Microsoft Open Source Code of Conduct. Для получения дополнительной информации обратитесь к FAQ по Коду поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями.

Связаться с нами

Свяжитесь с нами## Торговые марки

MICROSOFT, логотип Microsoft и MAKECODE являются зарегистрированными товарными знаками корпорации Microsoft. Они могут использоваться только в соответствии с целями, описанными в и в соответствии с правилами использования товарных знаков и бренда Microsoft, опубликованными по адресу https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Если использование не описано в опубликованных правилах Microsoft или вы не уверены, обратитесь к вашему юридическому консультанту или команде MakeCode (makecode@microsoft.com).

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Майкрософт МейкКод (PXT — Программинг Экспириенс Тул Кит). Развернуть Свернуть
MIT
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/mirrors-pxt.git
git@api.gitlife.ru:oschina-mirror/mirrors-pxt.git
oschina-mirror
mirrors-pxt
mirrors-pxt
master