blob: 154cc5e25f3e4208db6e5152a40334a61ffc81aa (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
jekyll-docker
=============
[](https://github.com/egor-tensin/jekyll-docker/actions/workflows/ci.yml)
**Archiving this because I no longer think this approach is valid.
Just using rbenv and installing dependencies there seems like a much saner option.**
----
Develop your Jekyll project in a Docker container, without installing all the
dependencies on the host.
Or don't.
| Feature | Command
| ---------------------- | ----------------------------------------------
| Install [ruby-install] | `make ruby-install && make ruby-install/clean`
| Install Ruby | `make ruby`
| Install [chruby] | `make chruby && make chruby/clean`
| Install [Bundler] | `make bundler`
| Install dependencies | `make dependencies`
| Run [Jekyll] | `make jekyll/serve`
| Run Jekyll in Docker | `make docker/up`
[ruby-install]: https://github.com/postmodern/ruby-install
[chruby]: https://github.com/postmodern/chruby
[Bundler]: https://bundler.io/
[Jekyll]: https://jekyllrb.com/
| Parameter | Default | Description
| -------------------- | --------- | --------------------------------------------------
| PROJECT_DIR | .. | Jekyll project directory
| RUBY_INSTALL_VERSION | 0.8.5 | ruby-install version
| RUBY_VERSION | 3.1.2 | Ruby version
| CHRUBY_VERSION | 0.3.9 | chruby version
| PREFIX | ~/.local/ | Installation directory for ruby-install and chruby
Set parameter values by passing them to make, i.e.
make ruby RUBY_VERSION=2.7.0
Examples
--------
### Jekyll in Docker
make docker/up PROJECT_DIR=../jekyll-project/
This builds two images: `jekyll_base` and `jekyll_project`, and runs a
container, which mounts PROJECT_DIR, and runs Jekyll there.
To rebuild the images (i.e. when you bump dependencies), run
make docker/build PROJECT_DIR=../jekyll-project/
Bring everything down:
make docker/down
### Jekyll on the host
make ruby-install
make ruby-install/clean
make ruby
make chruby
make chruby/clean
make bundler
make dependencies PROJECT_DIR=../jekyll-project/
make jekyll/serve PROJECT_DIR=../jekyll-project/
Some of these might not work on the first try (you'd need to install some
native dependencies for your gems, use `sudo`, etc.).
License
-------
Distributed under the MIT License.
See [LICENSE.txt] for details.
[LICENSE.txt]: LICENSE.txt
|
