specs/DEVELOPMENT.md
Jakub Sokołowski 6ba977e701 clean up docs headers, add layout to all
Splits docs to use three different `permalink` paths:
- `/raw/`
- `/draft/`
- `/stable/`

Otherwise docs like these clash and only one is accessible:
```
docs/draft/3-whisper-usage.md
docs/stable/3-whisper-usage.md
```
```
docs/draft/6-payloads.md
docs/stable/6-payloads.md
```

Signed-off-by: Jakub Sokołowski <jakub@status.im>
2021-11-22 19:47:57 +01:00

1.1 KiB

permalink title layout
/development DEVELOPMENT default

Description

This file explains the process of local development for this repository.

Dependencies

This repository is built using Jekyll 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.

Then you can install other Gems like the just-the-docs theme:

bundle install

Building

To simply build the site use:

bundle exec jekyll build --config _config_local.yml

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/.