反馈。
主要是打字错误。

https://github.com/WordPress/gutenberg/tree/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock

environment x 2（写入两次）=环境
pacakage=包

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/devenv.md

这一页写得很好！流动良好！

代码编辑器

提到其他一些代码编辑器怎么样？正如你所说，这是一个个人的选择，但最好列出几个选项，以告知用户一些备选方案。

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/wp-plugin.md

写得很好！

除了Firefox之外，还可以链接到Chrome开发工具。两者兼而有之。

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/esnext-js.md

干得好！

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/block-anatomy.md

解释得很好！

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/block-attributes.md

这对我来说还不清楚。它还可以进一步分解。
我们将添加一个消息属性，该属性将成为保存用户消息的变量。下面的代码定义了一个字符串类型的消息属性，其值派生自源，定义为div标记的文本

对我来说，这一页缺乏更多细节。很高兴你能链接到其他资源。

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/block-code.md

效果很好！

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/author-experience.md

作品。

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/finishing.md

别的。可以将各种组件添加到块中。
我的理解是，可以将许多组件放入块中以获得所需的功能。

下一步将测试它。
因为我主要是一个视觉化的人，很少编写代码。我基本上可以跟上。真正的测试将是设置Local等并完成教程。

@帕尔约阿希姆感谢您提供全面的反馈。我已经解决了您列出的所有项目，并进一步完善了教程。我很感谢您仔细阅读，并期待在您测试实现时收到反馈。谢谢您。

尺寸变化：+5.59千字节（0%）

总大小：1.13 MB

_{压缩尺寸作用}

你好，马库斯@姆卡兹

我查看了调整后的文档，注意到在“附加组件”下出现了这个错误。

您可以直观地浏览组件（应该是组件）及其使用上发布的Storybook工具的实现https://wordpress.github.io/gutenberg网站

文档看起来真的很好！
干得好！从一个教程创建者到另一个。我运行easywebdesigntutorials.com（我已经有一段时间没有更新了，这些天我正在修改网站以使用Gutenberg。我也在更新教程。）

以非开发人员的身份经历这一过程。
一步一步地。

在第一步中有很多困惑。

开发工具

“引导块”是什么意思？

这些工具用于获取我们将要编写的JavaScript，它的语法是浏览器无法运行的，并将其转换为可以运行的语法。

可以改为：

这些工具用于将要编写的JavaScript转换为浏览器可以运行的语法。

————

注意！所有链接都需要在新标签中打开！因此，在单击链接时不会丢失教程。

下载节点（链接）-->https://nodejs.org/en/download（下载）/（下载您使用的操作系统的安装程序。）

它还为大多数包管理器打包这意味着什么？

在阅读关于在Mac上使用Homebrew软件包工具的建议之前，我继续下载并安装了Nodej。

brew-install-nodejs=js部分超出了代码语法。

我对自制软件包工具部分感到困惑。访问自制网站：
上面写着Install Homebrew和以下代码：
/bin/bash-c“$（curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

文件中说：
“在Mac上，我建议使用Homebrew软件包工具，安装为：brew install nodejs”

我对上面句子中提到的两种安装方法和Homebrew网站上建议的一种安装方法感到困惑。

—

NPM通常与上述安装捆绑在一起这令人困惑。上面谈到了下载和安装，现在我读到NPM也捆绑了上面的安装。
我应该下载Nodejs还是NPM，其中似乎也包含Nodejs？

但是您安装了Nodejs？

我不清楚所使用的不同方法。

1. 从Nodejs下载。
2. 自制软件包工具似乎是另一种方法。但我不确定。这似乎与1有关。
3. 下载并安装NPM（我认为）。没有到哪里下载NPM的链接。

我认为这是开发工具页面。我停在那里，在文档更新后将再次开始。祝你周末愉快！

@帕尔约阿希姆我想我已经解决了你的问题。我指出包管理器是使用Node安装程序的替代方案。我还明确指定了与哪个平台匹配。

感谢您的反馈，请继续关注。

在新选项卡中打开链接？

https://github.com/WordPress/gutenberg/blob/add/docs-create-block/docs/designers-developers/developers/tutorials/create-bock/devenv.md

当我理解指令时，思想自由流动。

“这些工具用于将我们要编写的JavaScript转换为浏览器可以运行的格式。这称为转储或构建步骤。”

新增：
如果您尚未使用包管理器，则需要下载一个。包管理器包含节点和NPM。

在Mac上，Homebrew（链接）是一个流行的包管理器。下载完Homebrew后，请按照我们的安装说明进行操作。打开终端和类型：brew install nodejs

在Windows上，Chocolatey（链接）是一个流行的包管理器。下载Chocolatey后，请按照我们的安装说明进行操作。打开终端和类型：巧克力安装节点

在Linux上，您应该确认也安装了NPM。在某些系统中，它是单独捆绑的，您可能需要显式安装它。例如，在Ubuntu或Debian系统上，您可以使用：apt-install nodejs npm进行安装

如果您已经安装了包管理器，则可以直接从主网站下载Nodejs（链接）并进行安装。

“或者，如果使用包管理器，则节点包是可航行的对于大多数包管理器来说都是（打字错误）。"

“……否则，请逐步完成教程中您需要的任何部分。”
可以更改为：
“……否则，请逐步完成所需的教程部分。
编辑:
“……否则，请转到您需要的教程部分。”

在新选项卡中打开链接？

我不认为我们在其他地方使用它。此外，你可以通过键盘修改器或操作系统内置的鼠标交互来实现。

伟大的马库斯！
我会重新开始，仔细看一遍，让你知道它是如何进行的。

这是一个缓慢的过程，但每一次修订的文档都会变得更好！

重新启动测试。这次我安装了Homebrew。重新安装Docker。我补充道：
npm-g install@wordpress/env到终端并收到与之前相同的权限错误。

我猜最初的Nodejs安装会影响wp-env，所以我想办法从OSX系统中删除Nodejs。我遇到了这个：https://www.positronx.io/how-to-uninstall-node-js-and-npm-from-macos/并紧随其后。
结果是，在我的OSX系统上无法再找到node-v和npm-v。

然后我重新安装了Homebrew。然后检查node-v和npm-v是否已重新安装。他们没有。
我跑了npm-g安装@wordpress/env但找不到。

现在我在看https://changelog.com/posts/install-node-js-with-homebrew-on-os-x并遵循那里的说明。我在末尾收到了这个消息：
“警告：节点14.4.0已经安装，只是没有链接
你可以使用brew链接节点链接此版本。"

我打字了brew链接节点

然后收到：

错误：无法对共享/doc/node/gdbinit进行符号链接/usr/local/share/doc/node不可写。

现在我不知道该怎么办。

我卸载了Homebrew。
https://osxdaily.com/2018/08/12/how-uninstall-homebrew-mac/
ruby-e“$（curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/uninstall)"

使用重新安装网址：https://brew.sh/
/bin/bash-c“$（curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
这似乎奏效了。

然后键入：brew安装节点

==>安装节点==>浇注节点-14.4.0 catalina.bottle.tar.gz错误：“brew link”步骤未成功完成已生成公式，但未符号链接到/usr/local无法对共享/man/man1/node进行符号链接。1目标/usr/local/share/man/man1/node.1已经存在。您可能想删除它：rm“/usr/local/share/man/man1/node.1”

我补充道rm“/usr/local/share/man/man1/node.1”把它取下来brew安装节点再一次。

===>节点Bash补全已安装到：/usr/local/etc/bash_completion.dpaaljoachimromdahl@Paals-MacBook-Pro~%节点-vzsh：找不到命令：节点paaljoachimromdahl@Paals-MacBook-Pro~%rm'/usr/local/share/man/man1/node.1'覆盖rw-r--r--/usr/local/share/man/man1/node.1的根/wheel？对paaljoachimromdahl@Paals-MacBook-Pro~%brew安装节点警告：节点14.4.0已经安装，只是没有链接您可以使用“brew link node”链接此版本。paaljoachimromdahl@Paals-MacBook-Pro~%节点-vzsh：找不到命令：节点paaljoachimromdahl@Paals-MacBook-Pro ~ %

编辑：

再来一次。这似乎奏效了：
我找到了这条线索：https://discuse.brew.sh/t/mac-osx-homebrew-error-could-not-symlink-include-node-common-gypi/4717/5

我跑了：
sudo chown-R$（whoami）/usr/local/*

然后重新安装Homebrew
/bin/bash-c“$（curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
然后键入：brew安装节点

节点和npm现在显示：

节点-v
14.40版
npm-v型
第6.14.4条

下一步是安装：
npm-g install@wordpress/env

以下是我在终端中收到的消息：

paaljoachimromdahl@Paals-MacBook-Pro~%npm-g install@wordpress/envnpm警告已弃用请求@2.88.2：请求已被否决，请参阅https://github.com/request/request/issues/3142/usr/local/bin/wp-env->/usr/locall/lib/node_modules/@wordpress/env/bin/wsp-env> nodegit@0.26.5安装/usr/local/lib/node_modules/@wordpress/env/node_modules/nodegit>节点生命周期脚本/预安装和节点生命周期[nodegit]运行预安装脚本[nodegit]正在运行安装脚本节点-前gyp警告使用node-pre-gyp https下载请求节点-前gypWARN尝试下载（404）：https://axonodegit.s3.amazonaws.com/nodegit/nodegit/nodegit-v0.26.5-node-v83-darwin-x64.tar.gz 找不到的node-pre-gyp WARN预构建二进制文件nodegit@0.26.5和节点@14.4.0（node-v83 ABI，未知）（返回到使用node-gyp进行源代码编译）“com.apple.pkg没有收据。”。在“/”处找到CLTools_Executables“。“com.apple.pkg没有收据。”。“DeveloperToolsCLILeo”位于“/”。“com.apple.pkg没有收据。”。在“/”处找到DeveloperToolsCLI“。gyp：未检测到Xcode或CLT版本！吉普错误！配置错误吉普呃！堆栈错误：`gyp`失败，退出代码：1吉普错误！ChildProcess.onCpExit处的堆栈（/usr/local/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:351:16）吉普错误！ChildProcess.emit处的堆栈（events.js:315:20）吉普错误！堆栈在进程中。子进程_handle.onexit（内部/child_process.js:276:12）吉普错误！达尔文系统19.5.0吉普错误！命令“/usr/local/Cellar/node/14.4.0/bin/node”“--module_path=/usr/local/lib/node_modules/@wordpress/env/node_modules/nodegit/build/Release”“--napi_version=6”“--node_abi_napi=napi”“--napi_build_version=0”“--node_napi_label=node-v83”吉普错误！cwd/usr/local/lib/node_modules/@wordpress/env/node_modules/nodegit吉普错误！节点-v v14.4.0吉普错误！节点-gyp-v v5.1.0吉普错误！不正常节点-前gyp错误！生成错误node-pre-gyp错误！堆栈错误：无法执行“/usr/local/Cellar/node/14.4.0/bin/node/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js configure--fallback-to-build--module=/usr/local/lib/node_modules/@wordpress/env/node_models/nodegit/build/Release/nodegit.node--module_name=nodegit--module_path=/usr/local/lib/node_modules/@wordpress/env/node_modules/nodegit/build/Release--napi_version=6--node_abi_napi=napi--napi_build_version=0--node_napi_label=node-v83'（1）node-pre-gyp错误！ChildProcess处的堆栈<匿名>（/usr/local/lib/node_modules/@wordpress/env/node_modules/node-pre-gyp/lib/util/compile.js:83:29）节点预处理错误！ChildProcess.emit处的堆栈（events.js:315:20）节点-前gyp错误！堆栈位于maybeClose（internal/child_process.js:1051:16）node-pre-gyp错误！进程中的堆栈。子进程_handle.onexit（内部/child_process.js:287:5）节点-前gyp错误！达尔文系统19.5.0node-pre-gyp错误！命令“/usr/local/Cellar/node/14.4.0/bin/node”“/usl/local/lib/node_modules/@wordpress/env/node_modules/.bin/node-pre-gyp”“安装”“--回退到构建”node-pre-gyp错误！cwd/usr/local/lib/node_modules/@wordpress/env/node_modules/nodgitnode-pre-gyp错误！节点-v v14.4.0node-pre-gyp错误！node-pre-gyp-v0.13.0node-pre-gyp错误！不正常无法执行“/usr/local/Cellar/node/14.4.0/bin/node/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js configure--回退到构建--module=/usr/local/lib/node_modules/@wordpress/env/node_模块/nodegit/build/Release/nodegit.node--module_name=nodegit--module_path=/usr/local/lib/node_modules/@wordpress/env/node_modules/nodegit/build/Release--napi_version=6--node_abi_napi=napi--napi_build_version=0--node_napi_label=node-v83'（1）[nodegit]错误-无法完成安装[nodegit]错误-已完成，错误代码：1npm错误！代码ELIFECYCLEnpm错误！错误编号1npm错误！nodegit@0.26.5安装：`node lifecycleScripts/preinstall&&node life cycle脚本/install`npm错误！退出状态1npm错误！npm错误！在失败节点位数@0.26.5安装脚本。npm错误！这可能不是npm的问题。上面可能还有其他日志输出。npm错误！此运行的完整日志可在以下位置找到：npm错误/用户/paaljoachimromdahl/.npm/_logs/2020-06-23T12_59_42_470Z-debug.log

检查：

paaljoachimromdahl@Paals-MacBook-Pro~%wp-env--版本zsh：找不到命令：wp-envpaaljoachimromdahl@Paals-MacBook-Pro ~ %

我目前无法通过终端安装wp-env。

寻找替代方案，如本地。

WordPress插件（文档页面）

“如果您不打算使用wp-env，请更改您的本地WordPress插件目录；如果您确实计划使用wp-env，请从项目的任何目录开始。”

--->
如果您决定不使用wp-env，请切换到本地WordPress插件目录。
示例：~\Local Sites\nameofpsite\wp-content\plugins

“运行以下命令以生成插件文件：”
npx@wordpress/create-block gutenpride公司

--->如果使用本地或其他软件。正确的终端命令是什么？例如，基于上述示例。

“生成的插件现在应该列在WordPress安装的插件管理页面上。如果您正在使用wp-env，请参阅开发环境（输入错误）设置，然后您现在应该运行：“
wp-env启动

如果使用Local？在本地启动站点并进入WordPress站点。

@帕尔约阿希姆我在插件部分添加了标题，这样它就说明了每个步骤是什么，并且明确了每个步骤的选项，分别为Local和wp-env提供了A和B

马库斯建议的变通方案。
https://tecadmin.net/install-nodejs-with-nvm/

我将此代码粘贴到终端：
卷曲https://raw.githubusercontent.com/creationix/nvm主机/install.sh|巴什

在这之前，它似乎工作得很好：

=>找不到配置文件。尝试了~/.bashrc、~/.bash_profile、~//.zshrc和~/.profile。=>创建其中一个并再次运行此脚本或=>自己将以下行附加到正确的文件中：export NVM_DIR=“$HOME/.NVM”[-s“$NVM_DIR/NVM.sh”]&\。“$NVM_DIR/NVM.sh”#这将加载NVM=>关闭并重新打开终端以开始使用nvm，或运行以下命令立即使用它：export NVM_DIR=“$HOME/.NVM”[-s“$NVM_DIR/NVM.sh”]&\。“$NVM_DIR/NVM.sh”#这将加载NVMpaaljoachimromdahl@Paals-MacBook-Pro ~ %

上面的代码要求我创建一个列出的文件。我在终端中键入了以下内容：
触摸~/.zshrc
touch=创建文件。
~/=主目录。

我没有收到文件已创建的确认。
我退出终端并重新打开它，然后再次运行：
卷曲https://raw.githubusercontent.com/creationix/nvm主机/install.sh|巴什

这次似乎奏效了。

我再次尝试安装npm-g install@wordpress/env
同样的错误也出现了。

关闭航站楼，重新开放。
下一步：nvm安装节点

似乎有一些错误，但我关闭了终端，重新打开并运行nvm安装节点再一次。此时间终端发出以下消息：

v14.4.0已安装。现在使用节点v14.4.0（npm v6.14.5）

关闭和重新开放的航站楼。粘贴时间：
npm-g install@wordpress/env再次进入终端。

上述错误再次出现。

上面包含错误的较长终端消息中显示的一个错误是：
gyp：未检测到Xcode或CLT版本！

我遵循了这里的说明：https://anansewaa.com/install-command-line-tools-on-macos-catalina/（重新）安装Xcode。

paaljoachimromdahl@Paals-MacBook-Pro~%xcode-select--安装xcode-select:error:命令行工具已安装，请使用“软件更新”安装更新

测试内容：https://stackoverflow.com/questions/34617452/如何更新-xcode-from-commandline
软件更新--安装-a

没有可用的更新。

我已登录：https://developer.apple.com/download/more/下载最新稳定的Xcode。11.5版。目前正在下载7.6GB的zip文件。我还下载了Xcode 11.5GM Seed.dmg的命令行工具

@帕尔约阿希姆对于输入错误和不同的措辞，您可以直接在UI中提出更改。这样一来，申请就容易多了（任何有会员的人都可以申请），你的贡献将立即归功于你。请参见：https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request#启动-a审查

我已经将教程链接到目录，并在每个页面的底部添加了一个链接。

我的首选是将其合并并更新，然后使用其他信息进行迭代，这样可以更容易地跟踪单个更改和建议-vs-同时继续处理大量文档。

@姆卡兹，有没有办法将本教程放在文档中的临时文件夹中并迭代后续任务？

与此同时，我帮助了@科林克里尔将此更改合并到我们生成的位置块.json对于块：#23399。看起来它应该在教程中有自己的部分。

本周早些时候，我将块注册的核心新方法反向移植到了WordPress，该方法可以使用块.json– 寄存器块类型来自元数据。这是为块目录注册块的首选方法。相关提交：WordPress/WordPress-develop开发@5英尺6英寸44.

如果合并了它，其他人可以帮助完成本教程的各个步骤。

@姆卡兹，有没有办法将本教程放在文档中的临时文件夹中并迭代后续任务？

@吉奥罗牌手表我可以将它从目录中删除，我们仍然可以合并，它不会被发布，因为它不会在清单中。所以它会在回购中，但不会发布到块编辑器手册中。你就是这么想的吗？

我还没有测试最新的版本，所以我不知道它是否有效。
但我们现在的第一个版本看起来很好。
我可以致力于为版本2提供反馈。

由于文档的初始链接已更改。文档现在位于此处：https://github.com/WordPress/gutenberg/tree/master/docs/designers-developers/developers/tutorials/create-block

顺便说一句，我使用的是Mac OSX 10.15.5。（macOS Catalina）。
由于我在设置开发环境时遇到问题，我还建议添加一个故障排除部分。

• 如何重新设置开发环境并重新启动过程。

一旦下一次迭代PR设置完成。让我知道，我会开始在那里提供反馈。

还有一件事。
设置文档。

成为开发人员的用户需要知道如何设置Gutenberg开发环境。因此，第一个教程将是为古腾堡建立一个本地开发环境。它应该包含到目前为止已经建立的各种信息。最后是故障排除部分。

在建立古腾堡开发环境的最后，它将分支到（添加链接到）
->
与古腾堡一起创建第一个区块。
链接到：添加块提交指南。#23545
以及其他教程的链接。如以下所示。

贡献给古腾堡。可以包含：建立公关。贡献给现有公关。代码审查。等等…（添加链接到）
->
（根据现有问题/PR创建教程。）
-如何使用现有块的示例将图标添加到工具栏。这个问题是一个很好的示例问题，可以从以下方面创建一个好的问题：#12684（评论）
-如何调整侧边栏设置。
-实际上，这里有很多链接。。。。。

底线。这一切都始于建立古腾堡环境。有点像一条面包屑路，里面有父母和孩子。
（父）古腾堡环境->（子）使用古腾堡创建第一个块。
（父级）古腾堡环境->（子级）贡献给古腾堡。
（父）Gutenberg环境->（子）如何将图标添加到工具栏。
（父级）古腾堡环境->（子级）---有很多教程--

我们在这里建立了本地WordPress开发环境的基础：#23593
用于创建插件或为WordPress核心和/或Gutenberg做贡献。

--

但是创建块的文档在哪里？

@帕尔约阿希姆我需要批准才能合并#23593在中之后，我可以链接“创建块”教程。目前它只在GitHub中，没有公开发布。