ALA header, footer, theme and javascript files required for 2019 website refresh
This repository contains a couple of git submodules. Therefore, there is a bit more work than just cloning repo from github. Run the following commands.
git clone --recurse-submodules https://github.com/AtlasOfLivingAustralia/commonui-bs3-2019.git
cd commonui-bs3-2019
git submodule foreach --recursive 'git checkout commonui-bs3-2019'
Above command will checkout the correct branch of submodule.
Make sure changes submodules are made on commonui-bs3-2019 branch. Then publish those changes to github
using git push. In order for others to checkout your change, run the following command on the root repository - commonui-bs3-2019.
git add bootstrap-sass
git add ala-wordpress-2019
Install dependencies using yarn.
brew install yarn
cd PROJECT-PATH
yarn install
Copy the buildvars-example.js file to a new file named buildvars.js (which is git-ignored). Edit the variables as needed to define things like the login/logout URLs etc for different dev/build/prod environments. You can also store copies of different buildvars files in a directory named 'buildvars-ignored'
Build project to generate CSS from SCSS, compress and concatenate files. The tool used to build project is Gulp.
./node_modules/.bin/gulp build
You might want to test the integration of built files with applications like ala-hub, specieslist etc locally.
The built in server will do it. The address is http://localhost:8099.
node server.js
Example usage - http://localhost:8099/css/jquery-ui.css
The project has a test page to visualise changes. Use the following link.
http://localhost:8099/testPage.html
Add a npm library using yarn. Yarn is used to preserve the version of the dependency across installations of this repo.
yarn add xxx
It is possible to build project after editing a file automatically. Use the following command.
./node_modules/.bin/gulp watch