c_meyer/pxt-calliope
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Blocks2Javascript review edits (#1341)

Browse Source
This commit is contained in:
Galen Nickel
2018-10-03 13:15:22 -07:00
committed by Peli de Halleux
parent 1a9235e333
commit 2e1df3d70d
2 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/courses/blocks-to-javascript.md
View File

@@ -12,14 +12,14 @@ Are you ready to try JavaScript to write your code?
[
{
"name": "Hello JavaScript",
"description": "Learn to convert your block code in JavaScript",
"description": "Learn how to convert your code from blocks to JavaScript",
"url": "/courses/blocks-to-javascript/hello-javascript",
"cardType": "side",
"imageUrl": "/static/courses/blocks-to-javascript/hello-javascript.png"
},
{
"name": "Starter Blocks",
"description": "Start from blocks to jump into JavaScript",
"description": "Begin with blocks and then jump into JavaScript",
"url": "/courses/blocks-to-javascript/starter-blocks",
"cardType": "side",
"imageUrl": "/static/courses/blocks-to-javascript/starter-blocks.png"

24
docs/courses/blocks-to-javascript/starter-blocks.md
View File

@@ -2,17 +2,17 @@
## ~ hint
Use your blocks knownledge to learn JavaScript faster.
Use your knownledge of blocks to learn JavaScript faster.
## ~
MakeCode can convert your blocks to JavaScript and back. Start from blocks and jump into JavaScript for an easier start.
MakeCode can convert your blocks to JavaScript and back. Start your program with blocks and then jump into JavaScript as an easy way to begin working in the code.
## Do it blocks then convert
So you are pretty familiar with the blocks editor and still getting used to JavaScript. MakeCode can convert any block code into JavaScript. Let's see it in action.
So you are pretty familiar with the blocks editor and still getting used to JavaScript? MakeCode can convert any block code into JavaScript. Let's see it in action.
* create a simple program in the code editor
* Create a simple program in the code editor.
```blocks
input.onButtonPressed(Button.A, function () {
@@ -26,7 +26,7 @@ input.onButtonPressed(Button.A, function () {
})
```
* click on the **{} JavaScript** button in the top menu to convert the blocks to JavaScript. Voila!
* Click on the **{} JavaScript** button in the top menu to convert the blocks to JavaScript. Voila!
```typescript
input.onButtonPressed(Button.A, function () {
@@ -42,9 +42,9 @@ input.onButtonPressed(Button.A, function () {
## Go back to blocks
Do you feel like editing blocks again? MakeCode can convert back your JavaScript code into blocks.
Do you want to go back to editing with blocks again? MakeCode can convert your JavaScript code back into blocks.
* replace a few dots '.' with hashmarks '#'
* Replace a few dots `.` with hashmarks `#`.
```typescript
input.onButtonPressed(Button.A, function () {
@@ -60,11 +60,11 @@ input.onButtonPressed(Button.A, function () {
### ~ hint
So you change your JavaScript code and nothing works anymore, there are tons of red squiggle and you don't understand why... Don't panic, use the **Undo** button to revert your changes until everything works again.
Well, you changed your JavaScript code and nothing works anymore. You see gobs of red squiggles and you don't understand why... Don't panic, use the **Undo** button to revert your changes until everything works again.
### ~
* click on the **Blocks** button in the top to convert the JavaScript back to blocks.
* Click on the **Blocks** button in the top to convert the JavaScript back to blocks.
```blocks
input.onButtonPressed(Button.A, function () {
@@ -80,9 +80,9 @@ input.onButtonPressed(Button.A, function () {
## Grey blocks are a good sign!
If you start to writing more complex JavaScript (good job!), MakeCode might not be able to convert it back to blocks. In that case, you will see _grey blocks_ in your block code. They represent chunks of JavaScript that are too complicated for blocks.
If you start to write more complex JavaScript (it's great that you are!), MakeCode might not be able to convert it back to blocks. In that case, you will see _grey blocks_ in your block code. They represent chunks of JavaScript that are too complicated for blocks.
* go back to **JavaScript** and add a second frame to create animation. This is something you can do in JavaScript but not in blocks.
* Go back to **JavaScript** and add a second frame to create animation. This is something you can do in JavaScript but not in blocks.
```typescript
input.onButtonPressed(Button.A, function () {
@@ -96,7 +96,7 @@ input.onButtonPressed(Button.A, function () {
})
```
* go to the **Blocks** editor and you will see a big **grey** block in the button handler. This is because you are creating code too complex for the blocks. Take it as a compliment!
* Go to the **Blocks** editor and you will see a big **grey** block in the button handler. This is because you are creating code too complex for the blocks. Take it as a compliment!
```blocks
input.onButtonPressed(Button.A, function () {