mirror of
https://github.com/fooflington/selfdefined.git
synced 2025-01-22 17:30:00 +00:00
49 lines
1.2 KiB
Markdown
49 lines
1.2 KiB
Markdown
|
---
|
|||
|
|
title: Development & Build
|
|||
|
|
parent:
|
|||
|
|
title: Documentation
|
|||
|
|
href: '/documentation'
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
This guide will walk you through the current state of the development config. Things get a bit technical here. 🤖
|
|||
|
|
|
|||
|
|
All file names, except stated differently, are relative to the project root.
|
|||
|
|
|
|||
|
|
We are using [Eleventy](https://www.11ty.io/) to generate the site based on the given definitions. As a module bundle we use Parcel.
|
|||
|
|
|
|||
|
|
## Setup
|
|||
|
|
|
|||
|
|
You will need to have Node and Git installed on your machine. To start developing please create a fork of the root repository.
|
|||
|
|
|
|||
|
|
Afterwards, install the dependencies.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
That’s it, actually.
|
|||
|
|
|
|||
|
|
## Development Mode
|
|||
|
|
|
|||
|
|
To start the dev server run this command:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run serve
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
This will start Eleventy’s development server and watch the CSS entry point for changes. The output in the console will show the local URL to use.
|
|||
|
|
|
|||
|
|
### Eleventy Config
|
|||
|
|
|
|||
|
|
Configuration for Eleventy (e.g. filters and collections) are defined in `.eleventy.js`.
|
|||
|
|
|
|||
|
|
## Build
|
|||
|
|
|
|||
|
|
To build the production site run
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
This will generate a minified CSS bundle as well as run Eleventy’s production build. Build files are located in `dist`.
|