Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-14489

Generalize lsst-sphinx-bootstrap-theme for multiple projects

    XMLWordPrintable

    Details

      Description

      1. Allow different projects, with different names, to use lsst-sphinx-bootstrap-theme (make the name templated)
      2. Fix LSST logo branding (don't use the inverted version)
      3. Further improve colours and typography.

      This will allow the theme to be used with the nb.lsst.io site ( DM-14406)

        Attachments

          Issue Links

            Activity

            Hide
            jsick Jonathan Sick added a comment -

            This work is released as version 0.2.0. Release notes:

             

            Infrastructure changes

            • Adopted Gulp for building front-end web assets.
            • Adopted Sass for generating CSS.
              The build pipeline involves gulp-sass, gulp-clean-css, gulp-sourcemaps, and autoprefixer with gulp-postcss.
              Because of the new build pipeline, we've been able to concatenate all the CSS together into a single GET.
              To make this possible, we've had to fork the basic theme's CSS file into this repo.
            • Using Prettier with a precommit hook to maintain Sass code style (and eventually JavaScript too).
            • Improved the PyPI deployment script so that it doesn't double-push to PyPI.
            • Adopted setuptools_scm to automate the process of setting package versions for PyPI based on Git tags.

            Design changes

            • Switched logo to white-outlined version.
            • Removed Index, Module links, and search bar in header.
              Replaced those with a LSST-global links (forum, www.lsst.org, and www.lsst.io)
            • Moved the search box to the top of the side bar since another search bar isn't present in the top nav bar.
            • Set up a color system based on www.lsst.org's blue, including a triad-based red, and blue tinted greys and whites.
              All elements of the page are using this colour system. H2s are blue, for example.
            • Improved the appear of admonitions to tone them down just a smidge and also to integrate them with the colour system.
            • Tweaked wording for page TOC
            • Improved spacing in sidebar's navigation list.
            Show
            jsick Jonathan Sick added a comment - This work is released as version 0.2.0. Release notes:   Infrastructure changes Adopted Gulp for building front-end web assets. Adopted Sass for generating CSS. The build pipeline involves gulp-sass, gulp-clean-css, gulp-sourcemaps, and autoprefixer with gulp-postcss. Because of the new build pipeline, we've been able to concatenate all the CSS together into a single GET. To make this possible, we've had to fork the basic theme's CSS file into this repo. Using Prettier with a precommit hook to maintain Sass code style (and eventually JavaScript too). Improved the PyPI deployment script so that it doesn't double-push to PyPI. Adopted setuptools_scm to automate the process of setting package versions for PyPI based on Git tags. Design changes Switched logo to white-outlined version. Removed Index, Module links, and search bar in header. Replaced those with a LSST-global links (forum, www.lsst.org, and www.lsst.io) Moved the search box to the top of the side bar since another search bar isn't present in the top nav bar. Set up a color system based on www.lsst.org's blue, including a triad-based red, and blue tinted greys and whites. All elements of the page are using this colour system. H2s are blue, for example. Improved the appear of admonitions to tone them down just a smidge and also to integrate them with the colour system. Tweaked wording for page TOC Improved spacing in sidebar's navigation list.

              People

              Assignee:
              jsick Jonathan Sick
              Reporter:
              jsick Jonathan Sick
              Watchers:
              Jonathan Sick
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:

                  Jenkins

                  No builds found.