README

标准版为开发者和平面设计师提供了一个干净、稳定的基线，以便从其中开发基于 Twig 的模式库。

注意：这是 由 Drupal Pattern Lab GitHub 组织分叉的原始版本，所有依赖项也是如此。请参阅 我们分叉的原因 - 这是对 Pattern Lab 的热爱。

组件包

标准版 Twig 包括以下组件

• pattern-lab/core: GitHub
• pattern-lab/patternengine-twig: GitHub
• pattern-lab/styleguidekit-assets-default: GitHub
• pattern-lab/styleguidekit-twig-default: GitHub

安装

有两种方法可以下载和安装标准版 Twig

• 下载预构建项目
• 使用 Composer 创建项目

下载预构建项目

要开始使用标准版 Twig，最快的方法是从 发行页面 下载预构建版本。预构建项目默认安装了 Base StarterKit for Twig。

请注意：Pattern Lab 使用 Composer 来管理项目依赖项。要升级标准版 Twig 或安装插件，您需要 安装 Composer。我们建议您 全局安装它。

使用 Composer 创建项目

Pattern Lab 使用 Composer 来管理项目依赖项。

1. 安装 Composer

请按照 Composer 网站的安装 Composer 说明进行操作。我们建议您 全局安装它。

2. 安装标准版 Twig

使用 Composer 的 create-project 命令 将标准版 Twig 安装到您选择的路径。在终端中输入

cd install/location/
composer create-project drupal-pattern-lab/edition-twig-standard your-project-name

这将把标准版 Twig 安装到 install/location/ 目录下的一个名为 your-project-name 的目录中。在设置过程中，您将被要求安装合适的 StarterKit。在过程完成后，您将自动进入项目目录。

更新 Pattern Lab

要更新 Pattern Lab，请参阅每个组件的 GitHub 存储库。组件列在 README 的顶部。

有用的命令

以下是一些您可以在命令行上使用的、用于处理 Pattern Lab 的有用命令。

列出所有可用命令

要列出所有可用命令，请输入

php core/console --help

要列出特定命令的选项，请输入

php core/console --help --[command]

生成Pattern Lab

要生成Pattern Lab的前端，请输入

php core/console --generate

监视更改并重新生成Pattern Lab

要监视更改并重新生成Pattern Lab的前端，请输入

php core/console --watch

启动服务器以查看Pattern Lab

您可以使用PHP内置的Web服务器在浏览器中审查您的Pattern Lab项目。在另一个窗口中输入

php core/console --server

然后在您的浏览器中打开 http://localhost:8080。

安装StarterKit

要将接近空白的StarterKit作为项目的起点安装，请输入

php core/console --starterkit --init

要安装来自GitHub的特定StarterKit，请输入

php core/console --starterkit --install <starterkit-vendor/starterkit-name>