avtomon/sami-github

A Sami theme for GitHub Markdown formatted documentation. (this is a fork of phine/sami-github)

1.0.7 2020-01-08 09:52 UTC

This package is auto-updated.

Last update: 2024-03-16 18:56:26 UTC


README

This is a fork of phine/sami-github, with a few fixes as the original project is abandoned.

A Sami theme for GitHub Markdown formatted documentation.

Usage

use Sami\Sami;
use Sami\Version\GitVersionCollection;
use Symfony\Component\Finder\Finder;

$iterator = Finder::create()
    ->files()
    ->name('*.php')
    ->exclude('Resources')
    ->exclude('Tests')
    ->in($dir = '/path/to/symfony/src')
;

$versions = GitVersionCollection::create($dir)
    ->addFromTags('v2.0.*')
    ->add('2.0', '2.0 branch')
    ->add('master', 'master branch')
;

return new Sami($iterator, array(
    'theme'                => 'github',
    'versions'             => $versions,
    'title'                => 'Symfony2 API',
    'build_dir'            => __DIR__.'/../build/sf2/%version%',
    'cache_dir'            => __DIR__.'/../cache/sf2/%version%',
    // use a custom theme directory
    'template_dirs'        => array(__DIR__.'/themes/sami-github'),
    'default_opened_level' => 2,
));

Requirement

  • PHP >= 5.3.3
  • Sami >= 1.1.0

Installation

Via Composer:

$ composer require "avtomon/sami-github=~1.0"

License

This library is available under the MIT license.