Rewrite

This will allow us to make modules completely self-contained.
It is a step closer to the ultimate goal of having a completely modular theme that makes no assumptions at all and allows devs to build whatever they need.

## General

- [x] Rename all `roots_*` functions to `shoestrap_` for consistency
- [x] Use tabs for identation instead of 2 spaces from now on. Closer to WordPress Coding Standards.
- [x] Rename all `Roots_*` classes to `Shoestrap_*`
- [x] Use a single translation domain: `shoestrap` for consistency. All strings that were using `roots` as a textdomain were switched to `shoestrap`.
- [x] Use the "alternative" NavWalker as a default. Deprecating the default NavWalker in favor of this.
- [x] Move jQuery CDN to the "core" module instead of `scripts.php`
- [x] Move Analytics scripts etc to the advanced module and removed it from `scripts.php` and `config.php`
- [x] Remove `custom.php` file. It was used in the Roots theme for user customizations but we advise against it in this theme as updates will delete user customizations anyway.
- [x] Move widgets initialization from the `widgets` module to `lib/widgets.php`. Widgets are now properly initialized and included in the theme.
- [x] Use filters for the widget modes: https://github.com/shoestrap/shoestrap-3/commit/4a68489365d9ad02ec66873e8ddef2fb2dcb28d8#diff-a599543e643e45f017e9692a3908d7c3R332 This way we can de-couple the layout module from widgets initialization as well.
- [x] Add filters in the template files themselves so that templates can be switched with the layouts module absent.
- [x] Move scripts to their respective modules and load them from there instead from the generic `scripts.php` file.
- [x] **Add support for post formats**
- [x] Clean up theme_supports and removed the ones we use by default. There's no point in having them in-code as they can be de-activated using the modules.
- [x] Inline documentation of all functions used.
- [x] Restructure the plugins in a more sensible way.
- [x] Check if modules exist before including them
- [x] Make layouts paly nicely on the stand-alone theme (without modules
- [x] Rewrite Contributing.md
- [x] Rewrite README.md

==========================================================================

deprecated `shoestrap_in_article_top` action. You can now use the `shoestrap_single_top` action for single posts

================================================================

Removed the `shoestrap_override_header` action. You can now use the `shoestrap_title_section` filter.

===========================================================================

Renamed the `shoestrap_entry_meta_override` action to `shoestrap_entry_meta`

===========================================================================

Removed the `shoestrap_after_entry_meta` action.
You should now use priorities in the `shoestrap_entry_meta` action.

===============================================================

Implemented the `shoestrap_alert` function.
Now you can use it like this:
```php
shoestrap_alert( 'alert alert-info', __( 'This is the content', 'textdomain' ) );
```
This will have the following output:
```php
<div class="alert alert-info">
  This is the content
</div>
```
===============================================================

## Simplified `base.php`

Removed from base.php:
```php
  <?php if ( $site_style == 'boxed' ) : ?>
    <div class="container boxed-container">
  <?php endif; ?>
```
Using an action on `get_header` instead.

=================================================================

Deprecated the `shoestrap_pre_navbar` action.
Introducing the `shoestrap_do_navbar` action instead. Priorities can be used to order the items.

=================================================================

`shoestrap_do_the_excerpt` is now a filter, not an action.

====================================================

Removed from `base.php` and moved in the menus module:
```php
  <?php if ( $navbar_toggle != 'none' ) : ?>
    <?php if ( $navbar_toggle != 'pills' ) : ?>
      <?php if ( !has_action( 'shoestrap_header_top_navbar_override' ) ) : ?>
        <?php get_template_part( 'templates/header-top-navbar' ); ?>
      <?php else : ?>
        <?php do_action( 'shoestrap_header_top_navbar_override' ); ?>
      <?php endif; ?>
    <?php else : ?>
      <?php if ( !has_action( 'shoestrap_header_override' ) ) : ?>
        <?php get_template_part( 'templates/header' ); ?>
      <?php else : ?>
        <?php do_action( 'shoestrap_header_override' ); ?>
      <?php endif; ?>
    <?php endif; ?>
  <?php endif; ?>
```
This is then added to base.php using the `shoestrap_do_navbar` action.

=================================================================

Deprecated the `shoestrap_post_navbar` action.
You can now use the `shoestrap_do_navbar` action with a high number of priority, or the `shoestrap_pre_wrap` action.

=================================================================

Moved from `base.php` to the layout module:
```php
  <?php if ( $site_style == 'boxed' ) : ?>
    </div>
  <?php endif; ?>
```
Extra wrappers depending on the layout are now opened and closed using actions.

=================================================================

Moved from `base.php` to the menus module:
```php
  <?php if ( $left ) : ?>
    <section class="static-menu-main <?php echo shoestrap_static_left_breakpoint(); ?> col-static-<?php echo ( 12 - shoestrap_getVariable( 'layout_secondary_width' ) ); ?>">
  <?php endif; ?>
```

=====================================================================

Deprecated the `shoestrap_below_top_navbar` action.
You can now use the `shoestrap_pre_wrap` action.

Moved from `base.php` to the layout module and added using an action:
```php
  <?php if ( has_action( 'shoestrap_below_top_navbar' ) ) : ?>
    <div class="before-main-wrapper">
      <?php do_action('shoestrap_below_top_navbar'); ?>
    </div>
  <?php endif; ?>
```

=========================================================================

Deprecating the `shoestrap_breadcrumbs` action.
You can now use the `shoestrap_pre_wrap` action instead.
Move from `base.php` to the breadcrumbs file and using new action:
```php
  <?php if ( has_action( 'shoestrap_breadcrumbs' ) ) : ?>
    <?php do_action('shoestrap_breadcrumbs'); ?>
  <?php endif; ?>
```

=========================================================================

Deprecating the `shoestrap_header_media` action.
You can now use the `shoestrap_pre_wrap` action instead.

========================================================================

```php
<div class="wrap main-section <?php echo shoestrap_container_class(); ?>" role="document">
```
Now becomes 
```php
<div class="wrap main-section <?php echo apply_filters( 'shoestrap_container_class', 'container' ); ?>" role="document">
```
We're using a filter instead of directly calling a function.
Even if the layout module is missing, a default value will be used.

===========================================================================

```php
<main class="main <?php echo shoestrap_section_class( 'main' ); ?>" <?php if (is_home()){ echo 'id="home-blog"';} ?> role="main">
```
Now becomes 
```php
<main class="main <?php echo apply_filters( 'shoestrap_section_class_main', 'col-md-7' ); ?>" <?php if (is_home()){ echo 'id="home-blog"';} ?> role="main">
```
Using a filter instead of directly calling a function, and adding a default value.

==================================================================

Removed all the conditionals for displaying sidebars from `base.php` and instead we're now handling this better from the `shoestrap_display_primary_sidebar` and `shoestrap_display_secondary_sidebar` functions: https://github.com/shoestrap/shoestrap-3/commit/f1c9824a7d202238ed959903d6206d39b8dd6781#diff-a1604a1bc940b4057d09f19346d21711R43

===================================================================

Deprecating the `shoestrap_after_wrap` function.
You can now use the `shoestrap_pre_footer` action with a low priority number.

## Simplified index.php

Deprecated the `shoestrap_before_the_content` and `shoestrap_in_loop_start_action` actions.
You can use `shoestrap_in_loop_start` instead.

====================================================================

Deprecated the `shoestrap_after_the_content` action and replacing it with `shoestrap_in_loop_end`.