aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2016-03-08 05:01:14 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2016-03-08 05:01:14 +0300
commit11ec9eec0a49a0975dea6a03ef3d6e20b5d72875 (patch)
tree6b97125328f19d0976422bb3e0fda214bc85fada
parentcode style (diff)
downloadblog-11ec9eec0a49a0975dea6a03ef3d6e20b5d72875.tar.gz
blog-11ec9eec0a49a0975dea6a03ef3d6e20b5d72875.zip
README update
-rw-r--r--README.md38
1 files changed, 23 insertions, 15 deletions
diff --git a/README.md b/README.md
index 1f5d17b..3a57157 100644
--- a/README.md
+++ b/README.md
@@ -8,12 +8,14 @@ https://egor-tensin.github.io/cpp_tips/.
[Jekyll](http://jekyllrb.com/) is used to build a set of static HTML pages from
a collection of templates and resources.
-Jekyll doesn't support Windows, however at the moment of writing one can get it
-to work using the excellent tutorial at http://jekyll-windows.juthilo.com/.
+It might seem like Jekyll doesn't support Windows very well.
+However, at the moment of writing one can get it to work using the excellent
+tutorial at http://jekyll-windows.juthilo.com/.
+I personally had no problems running Jekyll on Windows whatsoever.
-I'm using [Bundler](http://bundler.io/) to set up a development environment.
-After the `bundler` gem is installed, project dependencies can be installed by
-running
+I use [Bundler](http://bundler.io/) to manage project's dependencies.
+Make sure you have the `bundler` gem installed; project dependencies can then
+be installed by executing
bundle install
@@ -21,22 +23,19 @@ in the project's root directory.
## Development
-To run a local web server, run
+To run a local web server, execute
bundle exec jekyll serve --watch --drafts --config _config.yml,_config_dev.yml
-from the project's root directory.
+in the project's root directory.
You can then review your changes at http://localhost:4000/.
-Please note that the support for `--watch`ing for modification on Windows is
-kind of iffy at the moment of writing.
-One possible workaround is to add `--force_polling` to `jekyll`s options:
+If you can't get Jekyll to properly `--watch` for file modifications on
+Windows, try adding `--force_polling` to `jekyll`s options:
bundle exec jekyll serve --watch --force_polling --drafts --config _config.yml,_config_dev.yml
-It might still not work though, so you might end up having to re-run `jekyll`
-manually.
-For details, refer to http://jekyll-windows.juthilo.com/4-wdm-gem/.
+It might still not work though, but you can always re-run `jekyll` manually.
Note that `_config_dev.yml` is included to rewrite some of the `site` fields
from `_config.yml` during development.
@@ -47,8 +46,17 @@ In particular, it
`min`ified versions,
* sets `include_comments` to `false` to exclude the Disqus comments section
from the posts,
-* sets `baseurl` to an empty string, pretending the website access from the
- root directory of a domain instead of from `cpp_tips/`.
+* sets `baseurl` to an empty string so that the website can be accessed from
+ local web server's root directory (i.e. from http://localhost:4000/ instead
+ of http://localhost:4000/cpp_tips/).
+
+## Accessing via file://
+
+Jekyll doesn't provide native support for generating a static website which can
+be viewed without a web server.
+One easy workaround might be to `wget` the website and convert the links:
+
+ wget -k -r http://localhost:4000/
## Licensing