Skip to content

Latest commit

 

History

History
71 lines (54 loc) · 2.96 KB

README.md

File metadata and controls

71 lines (54 loc) · 2.96 KB
Raw

CLARIN Bootstrap Barrio sub-theme for Drupal 8.

The CLARIN theme for Drupal 8 is a sub-theme of Bootstrap Barrio Bootstrap 4 theme.

Here you will find the sub-theme distribution files and releases. Additionally, this repository can be used as a composer VCS, see bellow for details.

This repository is NOT used for development. The sub-theme sources are maintained at the sub-theme source repository. All commits to this repository are automatically pushed by the corresponding CI build of the source repository.

Installation

  • Using composer

To configure composer to use this repository as VCS add the following to the repositories: section of your website's composer.json file:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/clarin-eric/clarin-drupal-bootstrap-theme-dist",
        "extra": {
            "branch-alias": {
                "dev-main": "1.x"
            }
        }
    }
]

Due to GitHub API rate limitations you will also need to create a GitHub PAT and add it to the config: section of your website's comppser.json:

"config": {
    "github-oauth": { "github.com": "<YOUR PAT HERE>" }
},

When installing Bootstrap Barrio via composer, bootstrap is automatically downloaded and copied into vendors directory. See Boostrap Barrio documentation.

To copy dist files into libraries directory during installation, add the following lines to the scripts: section of your website's composer.json:

"scripts": {
    "post-install-cmd": [                                          
        "@composer drupal:scaffold"             
    ],
    "post-update-cmd": [
       "@composer drupal:scaffold",
       "mkdir -p web/libraries/bootstrap",
       "cp -R vendor/twbs/bootstrap/dist web/libraries/bootstrap"
    ]
}

This will maintain the bootstrap version up to date when updating via composer.

  • Manual installation

    • Install Bootstrap Barrio theme.
    • Unpack and copy the sub-theme on web/themes/custom directory.
    • Install Bootstrap Library module (or manually install the JS and CSS libaries (Download) in: web/libraries/bootstrap/dist/)

  • Popper.js library (applies to both: manual and composer installation types)

    • Popper.js (Download) in. web/libraries/popper.js/dist/umd/

Runtime requirements

Same as the Bootstrap Barrio parent theme:

  • bootstrap.min.[js, css]
  • popper.min.js