From 87f75102acb387864fa7a7b180de8b1a47c315aa Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Wed, 2 Mar 2022 12:58:14 +0500 Subject: README: update --- README.md | 34 ++++++++++++---------------------- 1 file changed, 12 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index b1a7eca..a47dabb 100644 --- a/README.md +++ b/README.md @@ -49,39 +49,29 @@ browser's debugging tools. Development ----------- -[Jekyll] is used to build a set of static HTML pages from a collection of -templates and resources. -[Bundler] is used to manage project's dependencies. -Make sure you have the `bundler` gem installed; project dependencies can then -be installed by executing +This is a "static" website, generated using [Jekyll]. - bundle install +Make sure you have Ruby and [Bundler] set up. +[GNU Make] is used for shortcuts. -in the project's root directory. - -To run a local web server, run - - bundle exec jekyll serve --drafts - -You can then review your changes at http://localhost:4000/wireguard-config/. - -Or you can use [jekyll-docker] to set up a development environment in Docker -and not bother with installing everything locally. +* Install dependencies by running `make deps`. +* Build the website by running `make build`. +* Launch a local web server by running `make serve`. +You can then access the website at http://localhost:4000/wireguard-config/. [jekyll-theme] is used as a remote Jekyll theme. [Jekyll]: https://jekyllrb.com/ -[Bundler]: http://bundler.io/ -[jekyll-docker]: https://github.com/egor-tensin/jekyll-docker +[Bundler]: https://bundler.io/ +[GNU Make]: https://www.gnu.org/software/make/ [jekyll-theme]: https://github.com/egor-tensin/jekyll-theme ### Access via file:// Jekyll doesn't provide native support for generating a static website which can -be browsed without running an instance of Jekyll's web server. -One easy workaround is to `wget` the website and convert the links: - - wget --no-verbose --recursive --convert-links --adjust-extension -- http://localhost:4000/wireguard-config/ +be browsed without running a web server. +One easy workaround is to `wget` the website and convert the links using +`make wget`. License ------- -- cgit v1.2.3