schnittstabil/sugared-sami

Sami sweetened with ease

SugaredRim\Sami

, _(*1)

Sami sweetened with ease :cherries:, _(*2)

SugaredRim\Sami takes an opinionated view of generating documentation with Sami, it is preconfigured to get you up and running as quickly as possible., _(*3)

Install

$ composer require --dev sugared-rim/sami

Usage

Instead of creating a configuration file and running sami.phar update /path/to/config.php, just run sugared-rim-sami - that's it:, _(*4)

{
    ...
    "require-dev": {
        "sugared-rim/sami": ...
    },
    "scripts": {
        "doc": "sugared-rim-sami"
    }
}

Configuration

You may overwrite some options by putting it in your composer.json., _(*5)

Some of the default settings:, _(*6)

{
    ...
    "scripts": {
        "doc": "sugared-rim-sami"
    },
    "extra": {
        "sugared-rim/sami": {
            "files": "src",
            "filter": "SugaredRim\\Sami\\ProtectedFilter",
            "build_dir": "build/sami",
            "cache_dir": "build/cache/sami"
        }
    }
}

All extra.sugared-rim/sami options are passed through the Sami constructor, except:, _(*7)

• filter: A FQCN of the filter to use, sugared-rim-sami will create an instance for you.

License

MIT © Michael Mayer, _(*8)