aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
blob: 1f5d17b8383adb503eb1ee0928253d373fa87521 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# C++ tips

Personal C++ notes.
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/.

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

    bundle install

in the project's root directory.

## Development

To run a local web server, run

    bundle exec jekyll serve --watch --drafts --config _config.yml,_config_dev.yml

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.
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.
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.
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,
* 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](LICENSE.txt) for details.

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.