MasonSQ is a masonry, expanding grid, portfolio theme built with Bootstrap for Hugo. The base theme for MasonSQ is Shock. This project is a fork of Frances by Michael Crawford.
Grid functionality now utilizes Bootstrap exclusively. Content structure switched from JSON to Markdown. The jQuery, Modernizr, and ImagesLoaded plugins were removed.
This Hugo theme requires Hugo extended edition and Go.
- Hugo >=
0.146.0+extended - Go >=
1.20.0
This project supports PostCSS and is pre-configured for PurgeCSS. These features are disabled by default, and have additional dependencies if enabled.
- NodeJS >=
16.0.0 - NPM >=
7.0.0
Use Hugo as a local theme in your project directory. Navigate to your project directory and create a folder named themes, if it does not already exist.
cd ~/example.com
mkdir themesInside the themes directory, clone the MasonSQ git repository. Alternativley, download the repository zip file and manually extract it to the themes directory.
cd themes
git clone https://codeberg.org/aao-fyi/masonsq.git masonsqInside the Hugo configuration file, set the theme to masonsq.
theme = 'masonsq'Use MasonSQ as a Hugo module. Refer to the Hugo Modules documentation for more information.
Initialize the project as a module, specifying the project repository.
hugo mod init codeberg.org/username/projectAdd MasonSQ to a project as a theme compontent in the Hugo configuration file.
theme = 'codeberg.org/aao-fyi/masonsq'Fetch project modules.
hugo mod get -uTo utilize PostCSS and PurgeCSS functionality, install the required NPM packages before enabling the postCSS parameter. Refer to the PurgeCSS documentation for more information.
npm install postcss postcss-cli @fullhuman/postcss-purgecssEnable the postCSS parameter to enable PostCSS and utilize the PurgeCSS feature.
[postCSS]
state = trueMasonSQ is distributed under the MIT License.