From 20b8bfc1ff3f2dbe76380e82f8170c35b1dd9550 Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Wed, 2 Mar 2022 13:37:08 +0500 Subject: README: update --- README.md | 34 ++++++++++++---------------------- 1 file changed, 12 insertions(+), 22 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 63f3072..4396b45 100644 --- a/README.md +++ b/README.md @@ -10,39 +10,29 @@ This is my website hosted on [GitHub Pages] at https://egor-tensin.github.io/. 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 - -You can then review your changes at http://localhost:4000/. - -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`. +Access the website at http://localhost:4000/. [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/ +be browsed without running a web server. +One workaround is to `wget` the website (use `make wget`). +The truly static version will be downloaded to the .wget/ directory. License ------- -- cgit v1.2.3