mirror of
https://github.com/biobulkbende/biobulkbende.org.git
synced 2024-12-25 20:45:24 +00:00
README pass & new lock file (node v14)
This commit is contained in:
parent
f3a81238fd
commit
ddd86ad045
53
README.md
53
README.md
@ -1,48 +1,53 @@
|
|||||||
# biobulkbende.org
|
# biobulkbende.org
|
||||||
|
|
||||||
> https://biobulkbende.org
|
> [biobulkbende.org](https://biobulkbende.org)
|
||||||
|
|
||||||
Our public website made by members.
|
Our public website made by members.
|
||||||
|
|
||||||
## Hacking
|
## Hacking
|
||||||
|
|
||||||
- Make sure you have installed git, node.js and npm
|
- Make sure you have installed `git`, `node` (v14 LTS) and `npm`
|
||||||
- Clone this repo: `git clone https://github.com/biobulkbende/biobulkbende.org`
|
- Clone this repo: `git clone https://github.com/biobulkbende/biobulkbende.org`
|
||||||
- From within the folder install all packages: `npm install`
|
- From within the folder install all packages: `npm install`
|
||||||
- Run gulp for automation: `gulp watch`
|
- Run gulp for automation: `gulp watch`
|
||||||
|
|
||||||
## Structure
|
## Structure
|
||||||
|
|
||||||
The website is served from the folder `/app`
|
The website is served from the folder `/app`. The folder `/assets` is only for
|
||||||
|
development while the folder `/bundle` contains the files linked to
|
||||||
|
`index.html` and `/en/index.html`
|
||||||
|
|
||||||
The folder `/assets` is only for developement while the folde `/bundle` contains the files linked to `index.html` and `/en/index.html`
|
### HTML
|
||||||
|
|
||||||
### Html
|
|
||||||
|
|
||||||
There are two pages:
|
There are two pages:
|
||||||
|
|
||||||
- `index.html` (Dutch)
|
- `index.html` (Dutch)
|
||||||
- `/en/index.html` (English)
|
- `/en/index.html` (English)
|
||||||
|
|
||||||
Changes to the text can be done directly to these files without having to run any automation.
|
Changes to the text can be done directly to these files without having to run
|
||||||
|
any automation.
|
||||||
|
|
||||||
### (S)CSS
|
### (S)CSS
|
||||||
|
|
||||||
The CSS files to be changed are stored in /assets/scss which contains:
|
The CSS files to be changed are stored in /assets/scss which contains:
|
||||||
|
|
||||||
- /base (global CSS declarations)
|
- `/base` (global CSS declarations)
|
||||||
- /modules (specific CSS declarations)
|
- `/modules` (specific CSS declarations)
|
||||||
|
|
||||||
The CSS is written in SCSS and after changing it must be compiled and bundled togheter.
|
The CSS is written in SCSS and after changing it must be compiled and bundled
|
||||||
The command `gulp watch` runs automation and make sure that when you save the change in atuomatic everything is compiled and bundled.
|
together. The command `gulp watch` runs automation and make sure that when you
|
||||||
The final file is stored in `/bundle/styles` and provide the CSS to `index.html` and `/en/index.html`.
|
save the change in automatic everything is compiled and bundled. The final file
|
||||||
|
is stored in `/bundle/styles` and provide the CSS to `index.html` and
|
||||||
|
`/en/index.html`.
|
||||||
|
|
||||||
### JS
|
### JS
|
||||||
|
|
||||||
The JS file to be changed are stored in `assets/js/modules`
|
The JS files to be changed are stored in `assets/js/modules`. The JS is written
|
||||||
The JS is writted in ES6 and after changing it must be compiled in ES5 and bundled togheter.
|
in ES6 and after changing it must be compiled in ES5 and bundled together. The
|
||||||
The command `gulp watch` runs automation and make sure that when you save the change in atuomatic everything is compiled and bundled.
|
command `gulp watch` runs automation and make sure that when you save the
|
||||||
The final file is stored in `/bundle/scripts` and provide the JS to `index.html` and `/en/index.html`.
|
change in automatic everything is compiled and bundled. The final file is
|
||||||
|
stored in `/bundle/scripts` and provide the JS to `index.html` and
|
||||||
|
`/en/index.html`.
|
||||||
|
|
||||||
### Media
|
### Media
|
||||||
|
|
||||||
@ -52,11 +57,19 @@ The media are stored in `/assets/media` containing:
|
|||||||
- Fonts
|
- Fonts
|
||||||
- Images
|
- Images
|
||||||
|
|
||||||
Icons are compressed in a sprite through the command `gulp icons`. (This is complicated as it generates a single sprite with all the icons togheter and a CSS which points at the right icon in the sprite). After this command automation for the CSS must be runned.
|
Icons are compressed in a sprite through the command `gulp icons`. (This is
|
||||||
Images are minified through the command `gulp images`.
|
complicated as it generates a single sprite with all the icons together and a
|
||||||
All the media are copied with the command `gulp copyMediaInBundle` (it also minified the images) into the folder `/bundle/media` which provide the media to `index.html` and `/en/index.html`.
|
CSS which points at the right icon in the sprite). After this command
|
||||||
|
automation for the CSS must be run.
|
||||||
|
|
||||||
If you want to change an Image you have to put it in `/assets/media/images` and run `gulp copyMediaInBundle`. The html must refer to the image that has been copied and minified in `/bundle/media/images`.
|
Images are minified through the command `gulp images`. All the media are copied
|
||||||
|
with the command `gulp copyMediaInBundle` (it also minified the images) into
|
||||||
|
the folder `/bundle/media` which provide the media to `index.html` and
|
||||||
|
`/en/index.html`.
|
||||||
|
|
||||||
|
If you want to change an Image you have to put it in `/assets/media/images` and
|
||||||
|
run `gulp copyMediaInBundle`. The html must refer to the image that has been
|
||||||
|
copied and minified in `/bundle/media/images`.
|
||||||
|
|
||||||
### Video
|
### Video
|
||||||
|
|
||||||
|
21053
package-lock.json
generated
21053
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user