gwbootstrap
v1.3.7
Published
Extensions to standard Bootstrap stylesheets for gravitational wave observatories
Downloads
24
Readme
Bootstrap for GW Observatories
This repository provides extensions to the standard bootstrap-5.x styling, with specific applications for the GW-DetChar and GWSumm suite of detector characterisation tools.
This collection of cascading style sheets (CSS) and JavaScript utilities is designed to represent the global network of ground-based gravitational wave observatories, with explicit style support for:
- LIGO-Hanford (H1: Washington, U.S.A.)
- LIGO-Livingston (L1: Louisiana, U.S.A.)
- Virgo (V1: Italy)
- GEO600 (G1: Germany)
- KAGRA (K1: Japan)
- LIGO-India (I1: Maharashtra, India)
Installation
GW-Bootstrap can be installed server-side with
npm
:
npm install --save-dev gwbootstrap
Using jsDelivr
However, the easiest way to import stylesheets and scripts is through the
content delivery network jsDelivr
. Simply include the
following lines somewhere near the end of the <head>
metadata elements
in your HTML:
<link href="https://cdn.jsdelivr.net/npm/gwbootstrap@<version>/lib/gwbootstrap.min.css" rel="stylesheet" media="all">
<script src="https://cdn.jsdelivr.net/npm/gwbootstrap@<version>/lib/gwbootstrap.min.js" type="text/javascript"></script>
where <version>
is the semantic version number, e.g. 1.3.7.
A heavier collection of more interactive features, including calendar
view and a figure overlay tool, is available from the gwbootstrap-extra
script:
<script src="https://cdn.jsdelivr.net/npm/gwbootstrap@<version>/lib/gwbootstrap-extra.min.js" type="text/javascript"></script>
Dependencies
The following table shows recommended package dependencies for stylesheets and JavaScript elements, depending on use case (note: import order is important).
Usage
The primary advantage of gwbootstrap
is that it provides
interferometer-specific color styling for navbars, buttons,
cards, and alerts through the following classes:
Contributing
All code should follow the Sass Guidelines and Airbnb JavaScript Style Guide for consistency. Users may use the stylelint CSS linter to check their stylesheets and eslint to parse JavaScript for issues before submitting.
The contributions guide outlines our recommended procedure for proposing additions and making and testing changes.