apparat/artefakt

Artefakt Pattern Library Tool Base Distribution

Artefakt Pattern Library Tool

Prerequisites

• PHP 7.2+
• Composer (PHP dependency manager)

I recommend using the latest available version of PHP as a matter of principle., _(*1)

Installation

Start a new Artefakt Pattern Library by running this on a command prompt (requires Composer to be available as composer):, _(*2)

composer create-project --prefer-dist apparat/artefakt <project-name>
cd <project-name>

Please make sure to replace <project-name> with the path and name of your project., _(*3)

Custom directories

If you want Artefakt to use other directories than the default ones, create a custom composer.json in your installation directory:, _(*4)

mkdir <project-name>
cd <project-name>
composer init

Edit your composer.json to specify one or more custom directories like this:, _(*5)

{
    "name": "your/project",
    "require": {
        "apparat/artefakt": "dev-master"
    },
    "extra": {
        "apparat/artefakt": {
            "components": "cpms", // Component data directory
            "documents": "docs", // Document data directory
            "cache": "/tmp/artefakt" // Cache directory
        }
    }
}

Relative paths are resolved against the installation directory (the directory where the composer.json resides). Finish the installation with:, _(*6)

composer install
vendor/bin/artefakt app:init

Dependencies

, _(*7)

Quality

The Artefakt set of libraries attempt to comply with PSR-1, PSR-2, and PSR-4. If you notice compliance oversights, please send a patch for the respective library via pull request., _(*8)

Contributing

Found a bug or have a feature request? Please have a look at the known issues first and open a new issue if necessary. Please see contributing and conduct for details., _(*9)

Security

If you discover any security related issues, please email joschi@kuphal.net instead of using the issue tracker., _(*10)

Credits

• Joschi Kuphal
• All Contributors

License

Copyright © 2018 Joschi Kuphal / joschi@kuphal.net. Licensed under the terms of the MIT license., _(*11)