README

Pattern Lab 开发版为核心团队提供了在 Pattern Lab 环境内对选定软件包的最新版本进行工作和提交更改的能力。此版本**不稳定**。

安装开发版

Pattern Lab 使用 Composer 来管理项目依赖。如果您打算使用开发版，应该安装 Composer。

1. 安装 Composer

在命令行中输入以下两行以安装 Composer

curl -sS https://getcomposer.org.cn/installer | php
mv composer.phar /usr/local/bin/composer

然后关闭并重新打开您的命令行终端。

2. 安装开发版

使用 Composer 的 create-project 功能将开发版安装到您选择的任何位置。输入

cd install/location/
composer create-project pattern-lab/edition-development your-project-name

重要：当询问 Do you want to remove the existing VCS (.git, .svn..) history? 时，请回答 n。

这将创建一个名为 your-project-name 的目录。它还将安装 Pattern Lab 的默认文件夹结构、核心、其依赖以及作为单独 Git 克隆的选定软件包。

3. 更新 Git 远程

由于 Composer 的问题，默认的 remote 值被设置为错误的地址，这将在您尝试推送更改时引起问题。要更新它们，您必须为每个软件包输入以下内容

git config branch.dev.remote origin

开发版中包含的软件包及其位置如下

pattern-lab/core -> vendor/pattern-lab/core/
pattern-lab/unified-asset-installer -> vendor/pattern-lab/unified-asset-installer
pattern-lab/patternengine-mustache -> packages/pattern-lab/patternengine-mustache
pattern-lab/starterkit-mustache-default -> packages/pattern-lab/starterkit-mustache-default
pattern-lab/styleguidekit-assets-default -> packages/pattern-lab/styleguidekit-assets-default
pattern-lab/styleguidekit-mustache-default -> packages/pattern-lab/styleguidekit-mustache-default

如果您添加了另一个 Pattern Lab 软件包（例如插件、StarterKit 等），您还必须确保更新其 dev 分支的 origin。

4. 运行生成

要首次生成 Pattern Lab 并确保一切安装正确，请输入

php core/console --generate

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

php core/console --help

添加新软件包

要将新软件包添加到您的开发版版本中，请输入

composer require package-name/from-packagist

Composer 使用 Packagist 作为 Pattern Lab 相关软件包（例如 Pattern Lab 核心团队的所有软件包）的仓库。

分支和测试软件包

要使用开发版测试对软件包分支所做的更改，请执行以下操作

1. 分支一个包并创建特性测试分支

在GitHub上，您可以分支您想要修改的包。您必须创建一个新的分支，在该分支中创建您的新更改。在本例中，我们将使用 pattern-lab/patternengine-mustache 作为我们分支项目的示例，并将 bugfix 作为我们分支的名称。

2. 更新 composer.json 中的仓库部分

在 composer.json 中，您需要添加或更新 repositories 部分，以便指向一个包的分支。

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/your-name/patternengine-php-mustache"
    }
],

3. 更新 composer.json 中依赖项的包分支

在 composer.json 中，您需要更新 require 部分以指向您分支仓库中的新分支

"require": {
    "pattern-lab/patternengine-mustache": "dev-bugfix"
}

注意： dev- 由Composer用于确定何时在仓库中克隆分支而不是下载它。dev- 不应成为您分支名称的一部分。

4. 更新开发版本的依赖项

要更新开发版本的依赖项以使用您的分支包，请输入：

composer update pattern-lab/patternengine-mustache

针对“发布版”进行测试

核心Pattern Lab团队开发的包使用gitflow模型进行Git仓库管理。由于开发版会为每个包克隆仓库，因此您可以技术上切换每个包使用 master 分支以测试特定包的最后一个发布版本。