pxt
1.0.0
Microsoft MakeCode основан на проекте Microsoft Programming Experience Toolkit (PXT) с открытым исходным кодом. Microsoft MakeCode — это имя в редакторах, ориентированных на пользователя, PXT используется во всех источниках GitHub.
PXT — это платформа для создания специализированного программирования для начинающих, особенно ориентированная на образование в области информатики. Базовый язык программирования PXT является подмножеством TypeScript (без учета динамических функций JavaScript).
Основные особенности PXT:
Дополнительная информация:
Примеры редакторов, созданных с помощью MakeCode:
master — активная ветка разработки, в настоящее время собирается v3.*v* — это ветвь обслуживания для сборок v*.* Пожалуйста, следуйте инструкциям здесь.
Если вы изменяете свой собственный экземпляр 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 (либо в target, либо в 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
Если вам не нужно создавать набор связанных веб-приложений (карта навыков, многопользовательская игра и т. д.), вы можете пропустить их и немного ускорить сборку:
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) и субприложениями (также известными как «CRA», например, карта навыков, инструмент учителя и т. д.). Объявите для него переменную CSS в theme/themepacks.less :
:root . Выберите разумное значение по умолчанию в соответствии с рекомендациями в файле.theme-highcontrast . Выберите значение, которое хорошо подходит для данной темы.theme/themepacks.less целевого репозитория (например, pxt-microbit, pxt-arcade).Переменные, объявленные таким образом, будут доступны CRA во время выполнения, и они будут инициализированы значениями переопределения, определенными целью, в которой они выполняются.
В документации для подсветки фрагментов кода используется Highlight.js (hljs). На данный момент включены следующие языки:
Если вам нужно добавить другие языки или обновить существующие, вы можете найти дистрибутив по адресу https://highlightjs.org/download/; выберите все языки, которые вы хотите включить (включая те, что указаны выше!), загрузите и разархивируйте и, наконец, скопируйте highlight.pack.js в webapp/public/highlight.js/ .
Тесты расположены в подкаталогеtests tests/ и представляют собой комбинацию тестов узла и браузера. Чтобы выполнить их, запустите npm run test:all в корневом каталоге.
Лицензия MIT
В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации см. часто задаваемые вопросы о Кодексе поведения или свяжитесь с нами по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.
Свяжитесь с нами
MICROSOFT, логотип Microsoft и MAKECODE являются зарегистрированными товарными знаками корпорации Microsoft. Их можно использовать только для целей, описанных и в соответствии с руководящими принципами Microsoft по товарным знакам и брендам, опубликованными по адресу https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Если использование не описано в опубликованных руководствах Microsoft или вы не уверены, обратитесь к своему юрисконсульту или к команде MakeCode ([email protected]).
