Skip to content

Commit

Permalink
Adding supporting docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Jon Park committed Jan 22, 2015
1 parent 516cf35 commit cd16dfd
Show file tree
Hide file tree
Showing 5 changed files with 103 additions and 3 deletions.
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Changelog

All Notable changes to `clicksco/commonmark-laravel` will be documented in this file

## 1.0 - 2015-01-22

Initial version
32 changes: 32 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Contributing

Contributions are **welcome** and will be fully **credited**.

We accept contributions via Pull Requests on [Github](https://github.com/Clicksco/CommonMark).


## Pull Requests

- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](http://pear.php.net/package/PHP_CodeSniffer).

- **Add tests!** - Your patch won't be accepted if it doesn't have tests.

- **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.

- **Consider our release cycle** - We try to follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.

- **Create feature branches** - Don't ask us to pull from your master branch.

- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.

- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.


## Running Tests

``` bash
$ phpunit
```


**Happy coding**!
61 changes: 61 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# CommonMark Laravel 4 Wrapper

<!--[![Latest Version](https://img.shields.io/github/release/clicksco/commonmark-laravel.svg?style=flat-square)](https://github.com/Clicksco/CommonMark/releases)-->
[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)
<!--[![Build Status](https://img.shields.io/travis/clicksco/commonmark-laravel/master.svg?style=flat-square)](https://travis-ci.org/clicksco/commonmark-laravel)
[![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/clicksco/commonmark-laravel.svg?style=flat-square)](https://scrutinizer-ci.com/g/clicksco/commonmark-laravel/code-structure)
[![Quality Score](https://img.shields.io/scrutinizer/g/clicksco/commonmark-laravel.svg?style=flat-square)](https://scrutinizer-ci.com/g/clicksco/commonmark-laravel)
[![Total Downloads](https://img.shields.io/packagist/dt/clicksco/commonmark-laravel.svg?style=flat-square)](https://packagist.org/packages/clicksco/commonmark-laravel)-->

Trivial Laravel 4 wrapper class for The PHP League's CommonMark package.

## Install

Require the package with Composer

``` bash
$ composer require clicksco/commonmark-laravel
```

Update app/config/app.php with the ServiceProvider and Facade

``` php
'providers' => [
...
'Clicksco\CommonMark\ServiceProvider',
...
];
```

``` php
'aliases' => [
...
'CommonMark' => 'Clicksco\CommonMark\Facade',
...
];
```

## Usage

``` php
echo CommonMark::convertToHtml('# Hello, World!');
```

## Testing

``` bash
$ phpunit
```

## Contributing

Please see [CONTRIBUTING](https://github.com/clicksco/commonmarklaravel/blob/master/CONTRIBUTING.md) for details.

## Credits

- [Jon Park](https://github.com/jonspark)
- [All Contributors](https://github.com/clicksco/commonmarklaravel/contributors)

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
4 changes: 2 additions & 2 deletions composer.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"name": "clicksco/commonmark-laravel",
"description": "Simple Laravel wrapper class for League\\CommonMark",
"description": "Trivial Laravel wrapper class for League\\CommonMark",
"keywords": [
"laravel",
"commonmark"
],
"homepage": "https://github.com/clicksco/commonmark-laravel",
"homepage": "https://github.com/Clicksco/CommonMarkLaravel",
"license": "MIT",
"authors": [
{
Expand Down
2 changes: 1 addition & 1 deletion src/ServiceProvider.php
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ public function provides()
public function register()
{
$this->app->bindShared('clicksco.commonmark', function($app) {
return new CommonMarkConverter;
return new CommonMarkConverter();
});
}
}

0 comments on commit cd16dfd

Please sign in to comment.