README

您正在寻找有关 PHP TestFest 的信息吗？请查看我们的网站，您可以在这里找到有关组织 PHP TestFest 活动以及如何参与、成为导师等的详细信息：https://phptestfest.org。

如果您想为 PHP TestFest 贡献，您来到了正确的位置。请继续阅读...

工具

我们正在构建的一个工具是控制台应用程序，它将使您能够更快地启动并运行 PHP TestFest 以及编写 phpt 测试。试一试。在命令提示符中，键入

composer create-project --stability dev phpc/testfest
cd testfest/
./bin/testfest

另一个由巴西的 PHP São Paulo 和爱尔兰的 PHP Dublin 共同制作的工具是 docker-phpqa。目标是使用非常简单的流程在多个 PHP 版本中运行您的 PHPT。

本存储库中的 PHP TestFest 网站维护在 docs/ 目录中。它使用 GitHub Pages 提供服务。当拉取请求合并到 master 时，对 docs/ 的任何更改都将立即部署。

所有内容都可以用 GitHub 风格的 Markdown 和 HTML 编写。有关如何使用网站主题的示例，请参阅通用 (docs/theme-example/generic.md) 和元素 (docs/theme-example/elements.md)。

网站有几个主要部分需要大量贡献

教程

查看 docs/_tutorials/ 目录中的其他教程，以了解教程文件的格式。所有内容都是 Markdown 格式，但您需要添加一些 YAML 前端元数据。只需在 docs/_tutorials/ 中创建一个新的 Markdown 文件即可开始！

请确保您有权使用您帖子中包含的任何图片。最好使用 Creative Commons 许可或公共领域的图片。查找免费使用图片的好地方是 Unsplash。
资源

要向资源列表添加更多项目，请编辑 docs/_data/resources.yml。它是一个具有特定属性的 YAML 数组。查看列表中的其他项目，了解您可能需要指定哪些属性。
参与小组

如果您的小组正在参加 PHP TestFest，请将其添加到列表中。编辑 docs/_data/groups/2017.yml 以将您的小组添加到 2017 年的列表中。它是一个 YAML 数组；查看列表中其他小组使用的属性，了解您可以指定什么。
导师

如果您有兴趣在 PHP TestFest 期间成为某个小组的导师，请随时添加自己到 2017 年的列表中。编辑 docs/_data/mentors/2017.yml，指定您认为其他人需要了解的任何属性。您还可以说明您是否可以在本地、远程或为小组旅行提供指导。
其他内容

我们还需要帮助填写和维护以下页面的内容
- 入门 (docs/start.md)
- 组织 PHP TestFest 活动 (docs/lead.md)
- 成为导师 (docs/mentors.md)

有两种方法可以在本地测试对 docs/ 目录的更改：通过 Docker 或在您的系统上安装所有依赖项。

首先，请确保您已经安装了 Docker。然后在命令提示符中，输入以下命令

git clone https://github.com/phpcommunity/phptestfest.org.git
cd phptestfest.org/docs/

要预览您的更改，请从 docs/ 目录的命令提示符中输入以下内容

docker run --rm -v "$PWD":/usr/src/app -p "4000:4000" phpcommunity/github-pages

现在，您可以在网页浏览器中通过 https://:4000 预览网站。

按照以下步骤确保您已安装 GitHub Pages 的依赖项

(可选但推荐) 安装 rbenv
- 安装后，在命令提示符中输入 rbenv install 2.3.3 以使用 rbenv 安装 Ruby 版本 2.3.3
从命令提示符中，输入以下命令

git clone https://github.com/phpcommunity/phptestfest.org.git
cd phptestfest.org/docs/
gem install bundler
bundle install

要预览您的更改，请从 docs/ 目录的命令提示符中输入以下内容

bundle exec jekyll serve

现在，您可以在网页浏览器中通过 https://:4000 预览网站。