Merge pull request #117 from dimitriacosta/fix/en-docs

Fix en doc miles

Author: clemir

docs/access-handler.md

@@ -18,15 +18,17 @@ Just pass one of the following options as a field attribute or menu item value:
 
 *WARNING*: note this package will only prevents the elements from appearing in the front end, you still need to protect the backend access using middleware, etc.
 
-##Usage 
+## Usage 
 
 #### Form fields
 
-`{!! Field::select('user_id', null, ['role' => 'admin'])`
+```blade
+{!! Field::select('user_id', null, ['role' => 'admin']);
+```
 
 #### Menu items
 
-```
+```php
 // config/menu.php
 
 return [
@@ -44,7 +46,9 @@ return [
 ];
 ```
      
-`{!! Menu::make('menu.items') !}}`
+```blade
+{!! Menu::make('menu.items') !!}
+```
 
 ## Gate authorization
 
@@ -56,14 +60,19 @@ If it is an array, the first position of the array will be the name of the abili
 
 Examples:
 
-`{!! Field::text('change-password', ['allows' => 'change-password']) !!}`
-`{!! Field::select('category', $options, ['allows' => ['change-post-category', $category]]) !!}`
+```blade
+{!! Field::text('change-password', ['allows' => 'change-password']) !!}
+```
+
+```blade
+{!! Field::select('category', $options, ['allows' => ['change-post-category', $category]]) !!}
+```
 
 If you are building menus, you can use dynamic parameters to pass values to the gate.
 
 In the following example we will define a dynamic 'post' parameter, and pass it using setParam when building the menu:
 
-```
+```php
 // config/menu.php
 
 return [
@@ -76,7 +85,9 @@ return [
 ];
 ```
      
-`{!! Menu::make('menu.items')->setParam('post', $post)->render() !}}`
+```blade
+{!! Menu::make('menu.items')->setParam('post', $post)->render() !!}
+```
      
 ## Customization
 
@@ -86,18 +97,18 @@ If you are working on a complex project with lots of different access rules, etc
 
 If you want to use the access handler class as a standalone component, please add this global alias in `config/app.php`
 
-```
-  'aliases' => [
+```php
+'aliases' => [
     // ...
     'Access' => Styde\Html\Facades\Access,
     // ...
-  ],
+],
 ```
 
 Then you can use the facade wherever you want:
 
-```
-@if (Access:check(['roles' => ['admin, 'editor']]))
+```blade
+@if (Access:check(['roles' => ['admin', 'editor']]))
     <p>
         <a href='{{ url('admin/posts', [$post->id]) }}'>
             Edit this page
@@ -110,12 +121,14 @@ Then you can use the facade wherever you want:
 
 You can deactivate this component in the configuration:
 
-```
+```php
 //config/html.php
+
 return [
     //..
     'control_access' => true,
     //..
 ];
 ```
+
 By doing this, the callback, logged and roles attributes will simply be ignored and all users will be able to see all items. 

docs/alert-messages.md

@@ -2,38 +2,42 @@
 
 This component will allow you to generate complex alert messages.
 
- ```
-        Alert::info('Your account is about to expire')
-            ->details('Renew now to learn about:')
-            ->items([
-                'Laravel',
-                'PHP,
-                'And more',
-            ])
-            ->button('Renew now!', '#', 'primary');
+ ```php
+Alert::info('Your account is about to expire')
+    ->details('Renew now to learn about:')
+    ->items([
+        'Laravel',
+        'PHP',
+        'And more',
+    ])
+    ->button('Renew now!', '#', 'primary');
 ```
 
 The messages will persist in the session until they are presented to the user with:
 
-`{!! Alert::render() !!}`
+```blade
+{!! Alert::render() !!}
+```
 
 ## Create new alert messages
 
 You can generate new alert messages with:
 
-`{!! Alert::message('This is a message', 'alert-type') !!}`
+```blade
+{!! Alert::message('This is a message', 'alert-type') !!}
+```
 
 The first argument is the text of the message, and the second one is the type of alert.
 
 For example:
 
-```
+```php
 Alert::message('The end is near', 'danger');
 ```
 
 You can also use magic methods, the name of the method then becomes the alert type:
 
-```
+```php
 Alert::success("It's all good now");
 ```
 
@@ -45,39 +49,49 @@ You can specify more options by method chaining:
 
 You can pass a more detailed message chaining the details() method:
 
-`{!! Alert::info('Some info')->details('A more detailed explanation goes here') !!}`
+```php
+{!! Alert::info('Some info')->details('A more detailed explanation goes here') !!}
+```
 
 ### call to actions
 
 You can assign buttons to an alert message:
 
-`{!! Alert::info()->button('Call to action', 'some-url', 'primary') !!}`
+```blade
+{!! Alert::info()->button('Call to action', 'some-url', 'primary') !!}
+```
 
 ### html
 
 You can directly pass HTML to the alert message
 
-`{!! Alert::info()->html('<strong>HTML goes here</strong>') !!}`
+```blade
+{!! Alert::info()->html('<strong>HTML goes here</strong>') !!}
+```
 
 Be careful since this won't be escaped
 
 ### view
 
 You can even render a partial inside an alert message:
 
-`{!! Alert::info()->view('partials/alerts/partial') !!}`
+```blade
+{!! Alert::info()->view('partials/alerts/partial') !!}
+```
 
 ### items
 
 You can pass an array of items (maybe an error list):
 
-`{!! Alert::danger('Please fix these errors')->items($errors) !!}`
+```blade
+{!! Alert::danger('Please fix these errors')->items($errors) !!}
+```
 
 ## Persist alert messages
 
 Add the following middleware to the `$middleware` array in `app/Http/Kernel.php` **BEFORE** the `\App\Http\Middleware\EncryptCookies`: 
 
-```
+```php
 protected $middleware = [
     //...
     \Styde\Html\Alert\Middleware::class
@@ -95,8 +109,9 @@ If the `'translate_texts'` options is set to true in the configuration (it's tru
 
 If you don't need to use the translator component, just set translate_texts to false in the configuration:
 
-```
+```php
 //config/html.php
+
 return [
     //...
     'translate_texts' => false
@@ -108,8 +123,12 @@ return [
 
 By default, the alert messages will be rendered with the default template, located in themes/[theme]/alert, for example, for the Bootstrap theme that would be:
 
-`vendor/styde/html/themes/bootstrap/alert.blade.php`
+```bash
+vendor/styde/html/themes/bootstrap/alert.blade.php
+```
 
 You can pass a custom template as the first argument of the render() method, i.e.:
 
-`{!! Alert::render('partials/custom-alert-template') !!}`
+```blade
+{!! Alert::render('partials/custom-alert-template') !!}
+```