hacks-guide-minimal-mistake.../docs/_docs/17-javascript.md
Alex Malaszkiewicz 0cf24b028d Update jquery v3.3.1 to v3.4.0 (#2129)
* Update jquery v3.3.1 to v3.4.0
* Update `main.min.js`

Close #2127
2019-04-15 16:23:58 -04:00

3 KiB

title permalink excerpt last_modified_at
JavaScript /docs/javascript/ Instructions for customizing and building the theme's scripts. 2019-04-03T15:25:36-04:00

The theme's assets/js/main.min.js script is built from several vendor, jQuery plugins, and other scripts found in assets/js/.

minimal mistakes
├── assets
|  ├── js
|  |  ├── plugins
|  |  |   ├── jquery.fitvids.js            # fluid width video embeds
|  |  |   ├── jquery.greedy-navigation.js  # priority plus navigation
|  |  |   ├── jquery.magnific-popup.js     # responsive lightbox
|  |  |   └── jquery.smooth-scroll.min.js  # make same-page links scroll smoothly
|  |  ├── vendor
|  |  |   └── jquery
|  |  |       └── jquery-3.4.0.min.js
|  |  ├── _main.js                         # jQuery plugin settings and other scripts
|  |  └── main.min.js                      # concatenated and minified scripts

Customizing

To modify or add your own scripts include them in assets/js/_main.js and then rebuild using npm run build:js. See below for more details.

If you add additional scripts to assets/js/plugins/ and would like them concatenated with the others, be sure to update the uglify script in package.json. Same goes for scripts that you remove.

You can also add scripts to the <head> or closing </body> elements by adding paths to following arrays in _config.yml.

Example:

head_scripts:
  - https://code.jquery.com/jquery-3.3.1.min.js
  - /assets/js/your-custom-head-script.js
footer_scripts:
  - /assets/js/your-custom-footer-script.js
after_footer_scripts:
  - /assets/js/custom-script-loads-after-footer.js

Note: If you assign footer_scripts the theme's /assets/js/main.min.js file will be deactivated. This script includes jQuery and various other plugins that you'll need to find replacements for and include separately. {: .notice--warning}


Build process

In an effort to reduce dependencies a set of npm scripts are used to build main.min.js instead of task runners like Gulp or Grunt. If those tools are more your style then by all means use them instead 😉.

To get started:

  1. Install Node.js.
  2. cd to the root of your project.
  3. Install all of the dependencies by running npm install.

Note: If you upgraded from a previous version of the theme be sure you copied over [package.json](https://github.com/{{ site.repository }}/blob/master/package.json) prior to running npm install. {: .notice--warning}

If all goes well, running npm run build:js will compress/concatenate _main.js and all plugin scripts into main.min.js.