aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2022-03-02 13:37:08 +0500
committerEgor Tensin <Egor.Tensin@gmail.com>2022-03-02 15:09:40 +0500
commit20b8bfc1ff3f2dbe76380e82f8170c35b1dd9550 (patch)
tree8a637cc7d7fe8a3f6e9e86c02dfeb5360bb40255 /README.md
parentMakefile: exclude external directories from wget (diff)
downloadegor-tensin.github.io-20b8bfc1ff3f2dbe76380e82f8170c35b1dd9550.tar.gz
egor-tensin.github.io-20b8bfc1ff3f2dbe76380e82f8170c35b1dd9550.zip
README: update
Diffstat (limited to '')
-rw-r--r--README.md34
1 files changed, 12 insertions, 22 deletions
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
-------