2021-11-16 14:48:05 +00:00
|
|
|
---
|
|
|
|
|
permalink: /development
|
|
|
|
|
title: DEVELOPMENT
|
|
|
|
|
layout: default
|
|
|
|
|
---
|
2021-09-10 08:59:08 +00:00
|
|
|
# Description
|
|
|
|
|
|
|
|
|
|
This file explains the process of local development for this repository.
|
|
|
|
|
|
|
|
|
|
# Dependencies
|
|
|
|
|
|
|
|
|
|
This repository is built using [Jekyll](https://jekyllrb.com/) along with some plugins and a theme.
|
|
|
|
|
|
|
|
|
|
To install the necessary dependencies on Ubuntu use:
|
|
|
|
|
```
|
|
|
|
|
sudo apt-get install ruby-full build-essential zlib1g-dev
|
|
|
|
|
gem install jekyll bundler
|
|
|
|
|
```
|
|
|
|
|
It might be necessary to specify installation destination for your Gems:
|
|
|
|
|
```
|
|
|
|
|
export GEM_HOME="$HOME/.gems"
|
|
|
|
|
export PATH="$HOME/gems/bin:$PATH"
|
|
|
|
|
```
|
|
|
|
|
For instructions on other systems use [these docs](https://jekyllrb.com/docs/installation/).
|
|
|
|
|
|
|
|
|
|
Then you can install other Gems like the `just-the-docs` theme:
|
|
|
|
|
```
|
|
|
|
|
bundle install
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# Building
|
|
|
|
|
|
|
|
|
|
To simply build the site use:
|
|
|
|
|
```
|
2021-11-15 13:30:06 +00:00
|
|
|
bundle exec jekyll build --config _config_local.yml
|
2021-09-10 08:59:08 +00:00
|
|
|
```
|
|
|
|
|
This will generate the site files and put them under `_site`.
|
|
|
|
|
|
|
|
|
|
But if you want Jekyll to continuously build and also serve the site use:
|
|
|
|
|
```
|
|
|
|
|
bundle exec jekyll serve --config _config_local.yml --incremental
|
|
|
|
|
```
|
|
|
|
|
This should make it available under http://127.0.0.1:4000/.
|
