From ecb4b7f4650ba18beece0dd38eda5447a24ff75c Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Sun, 12 Jul 2015 02:41:03 +0300 Subject: README update --- README.md | 46 +++++++++++++++++++++++++++++++--------------- 1 file changed, 31 insertions(+), 15 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 59bafc9..48888a8 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,19 @@ # C++ tips Personal C++ notes. -Hosted on [GitHub Pages](https://pages.github.com) at https://egor-tensin.github.io/cpp_tips/. +Hosted on [GitHub Pages](https://pages.github.com) at +https://egor-tensin.github.io/cpp_tips/. ## Installation -[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/. +[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/. 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 +After the `bundler` gem is installed, project dependencies can be installed by +running bundle install @@ -24,27 +28,39 @@ To run a local web server, run from 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. +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: 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. +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/. -Note that `_config_dev.yml` is included to rewrite some of the `site` fields from `_config.yml` during development. +Note that `_config_dev.yml` is included to rewrite some of the `site` fields +from `_config.yml` during development. In particular, it -* sets `minified_externals` to `false` so that the properly formatted versions of external CSS stylesheets and JavaScript files are included instead of the `min`ified versions, -* sets `include_comments` to `false` to exclude the Disqus comments section from the posts, -* opts for the `rouge` gem for syntax highlighting instead of the default [Pygments](http://pygments.org/), -* sets `baseurl` to an empty string, pretending the website access from the root directory of a domain instead of from `cpp_tips/`. +* sets `minified_externals` to `false` so that the properly formatted versions + of external CSS stylesheets and JavaScript files are included instead of the + `min`ified versions, +* sets `include_comments` to `false` to exclude the Disqus comments section + from the posts, +* opts for the `rouge` gem for syntax highlighting instead of the default + [Pygments](http://pygments.org/), +* sets `baseurl` to an empty string, pretending the website access from the + root directory of a domain instead of from `cpp_tips/`. ## Licensing -This project, including all of the files and their contents, is licensed under the terms of the MIT License. -See LICENSE.txt for details. +This project, including all of the files and their contents, is licensed under +the terms of the MIT License. +See [LICENSE.txt](LICENSE.txt) for details. -This website is build upon the Twitter Bootstrap framework, which is also MIT Licensed and copyright 2015 Twitter. +This website is build upon the Twitter Bootstrap framework, which is also MIT +Licensed and copyright 2015 Twitter. -A MIT Licensed CSS style sheet from https://github.com/mojombo/tpw/blob/master/css/syntax.css created by Tom Preston-Werner is used for syntax highlighting. +A MIT Licensed CSS style sheet from +https://github.com/mojombo/tpw/blob/master/css/syntax.css created by Tom +Preston-Werner is used for syntax highlighting. -- cgit v1.2.3