mirror of
https://github.com/a2nt/silverstripe-webpack.git
synced 2024-10-22 17:05:31 +02:00
Update README.md
This commit is contained in:
parent
ffae7ce849
commit
6423e9b027
43
README.md
43
README.md
@ -4,17 +4,54 @@
|
|||||||
|
|
||||||
Checkout files at /site/ folder for details
|
Checkout files at /site/ folder for details
|
||||||
|
|
||||||
## Requirements:
|
### Features:
|
||||||
|
+ You can use /site/_config/webpack.yml to setup webpack server parameters which will be used by webpack server and by SilverStripe to serve static content
|
||||||
|
+ You can use WebpackJS('file-name') and WebpackCSS('file-name') functions at templates to require JS and CSS. It will be served using static files or by using Webpack if the website in development mode and Webpack server is running
|
||||||
|
+ WebpackTemplateProvider::WebpackJS('file-name') and WebpackTemplateProvider::WebpackCSS('file-name') can be used at php area
|
||||||
|
+ All images will be optimised at /site/src/img and will be written to /site/dist/img (by default)
|
||||||
|
+ Favicons will be generated at /site/dist/icons using /site/src/favicon.png
|
||||||
|
+ Folder /site/src/js/types is used to create page specific JS (just create a JS file there and it will be compiled)
|
||||||
|
+ Bootstrap 4 included by default
|
||||||
|
|
||||||
|
### Folder structure:
|
||||||
|
+ /site/_config/webpack.yml (Webpack configurtion)
|
||||||
|
+ /site/code/WebpackTemplateProvider.php (WebpackJS and WebpackCSS functionality)
|
||||||
|
+ /site/templates/Page.ss (An example Page.ss)
|
||||||
|
+ /site/src (Your sources)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
+ /site/src/js (Your JS-scripts)
|
||||||
|
+ /site/src/js/_components (Your JS components to be included)
|
||||||
|
+ /site/src/js/_components/_spinner.js (An example to display and hide loading spinner)
|
||||||
|
+ /site/src/js/app.js (main application file to include website-wide components)
|
||||||
|
+ /site/src/js/main.js (Your custom site-wide functionality)
|
||||||
|
+ /site/src/js/_events.js (Your custom site-wide events)
|
||||||
|
+ /site/src/js/_pageType_and_component_template.js (A template which can be used to create new modules)
|
||||||
|
+ /site/src/types/*.js (Extra page-specific modules to be autocompiled. My suggestion is to use *ClassName*.js and then Require it as at SilverStripe automatically)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
+ /site/src/scss (Your styling to be compiled)
|
||||||
|
+ /site/src/scss/_components (Your custom SCSS components)
|
||||||
|
+ /site/src/scss/app.scss (main application file to include sie-wide components)
|
||||||
|
+ /site/src/scss/_variables.sccs (your custom variables, ex. bootstrap)
|
||||||
|
+ /site/src/scss/_layout.sccs (Your site-wide styling)
|
||||||
|
|
||||||
|
##### P.S to compile page specific styling add following line to /site/src/types/*PageClassName*.js
|
||||||
|
###### import "../scss/types/*PageClassName*.scss";
|
||||||
|
|
||||||
|
### Requirements:
|
||||||
|
|
||||||
+ composer
|
+ composer
|
||||||
+ yarn
|
+ yarn
|
||||||
|
|
||||||
## Instalation:
|
### Instalation:
|
||||||
|
|
||||||
+ composer install
|
+ composer install
|
||||||
+ yarn install
|
+ yarn install
|
||||||
|
|
||||||
## Commands:
|
### Commands:
|
||||||
|
|
||||||
+ yarn - to update packages
|
+ yarn - to update packages
|
||||||
+ yarn start - to start webpack webserver
|
+ yarn start - to start webpack webserver
|
||||||
|
Loading…
Reference in New Issue
Block a user