soltys/slate-bundle

This package is abandoned and no longer maintained. No replacement package was suggested.

This bundle provides a configurable Slate documentation for your REST APIs.

Maintainers

Details

github.com/hugosoltys/SoltysSlateBundle

Homepage

Source

Issues

Installs: 2 347

Dependents: 0

Suggesters: 0

Security: 0

Stars: 4

Watchers: 1

Forks: 2

Open Issues: 0

Language:HTML

Type:symfony-bundle

1.0.2 2017-12-12 16:42 UTC

Requires

MIT 78efea091d7f0d8d5a880ef4e1846532fae12504

  • Hugo Soltys <hugo.soltys.woop@gmail.com>

symfonyrestapibundleslatesoltys

This package is auto-updated.

Last update: 2022-02-01 13:11:15 UTC

README

This bundle provides a configurable Slate documentation for your REST APIs.

Step 1: Download the Bundle

Add SoltysSlateBundle to your project via Composer:

$ composer require soltys/slate-bundle "~1"

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Soltys\Bundle\SoltysSlateBundle\SoltysSlateBundle(),
        );

        // ...
    }

    // ...
}

Step 3: Configure the Bundle

In your routing.yml file add the following lines:

# app/config/routing.yml
SoltysSlateBundle:
    resource: "@SoltysSlateBundle/Resources/config/routing.yml"
    prefix:   /api/documentation

Then configure the bundle by adding the following in your config.yml:

# app/config/config.yml
soltys_slate:
    language_tabs: ["shell", "ruby", "python", "javascript"]
    includes: ["SoltysSlateBundle:Slate/Includes:_errors.md.twig"]
    toc_footers: ["SoltysSlateBundle:Slate/Footers:_footer.html.twig"]

The full bundle configuration reference is below:

# app/config/config.yml
soltys_slate:
    title: "API Documentation"                            # Your documentation title
    navbar_path: "bundles/soltysslate/images/navbar.png"  # Your navbar image path
    logo_path: "bundles/soltysslate/images/logo.png"      # Your logo path
    with_search: true                                     # Enable/Disable the search bar
    page_classes: "index"                                 # Add this CSS class to the HTML <body> tag
    language_tabs: ["shell", "ruby", "python", "javascript"] # List the languages in which you want to write your examples
    includes: ["SoltysSlateBundle:Slate/Includes:_errors.md.twig"] # Additional templates
    toc_footers: ["SoltysSlateBundle:Slate/Footers:_footer.html.twig"] # Footer template

You can now install your assets with the following command:

$ bin/console assets:install web --symlink

Then clear your cache:

$ bin/console cache:clear

Step 4: Usage

To write your own documentation (unless if you like kittens), create an index.md.twig file under the app/Resources/SoltysSlateBundle/views/Slate/MarkDown directory to override the default one.