aboutsummaryrefslogblamecommitdiffstatshomepage
path: root/README.md
blob: c2c5cacffd5fd121fac962a18f447d9ab1225d09 (plain) (tree)
1
2
3
4
5
6
7
8

                  
 
                                             
                                                                              
 
                                        
 




                                                                         
                                                   

                                                                             




                                




                               
 
                                  
 
                                                                                  
 
                                

                                                           

                                                                       
 
                                                                                                  
 
                                                                            
 

                                                                            
                 
 
                                                                              

                                                                            
                                                                            

                                                                              
 
                      

                                                                               

                                                                      
 
                                                           
 

       
 
                                  
                              
 

                                                                             
 
                          
Sorting algorithms
==================

Getting the hang out of (sorting) algorithms.
Hosted on [GitHub Pages] at https://egor-tensin.github.io/sorting-algorithms/.

[GitHub Pages]: https://pages.github.com

Prerequisites
-------------

[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

    bundle install

in the project's root directory.

[Jekyll]: https://jekyllrb.com/
[Bundler]: http://bundler.io/

Usage
-----

To run a local web server, execute

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

in the project's root directory.
You can then review your changes at http://localhost:4000/.

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, 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.
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 `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/sorting-algorithms/).

### 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 be to `wget` the website and convert the links:

    wget --convert-links --recursive http://localhost:4000/

License
-------

Distributed under the MIT License.
See [LICENSE.txt] for details.

This website is build upon the Twitter Bootstrap framework, which is also MIT
Licensed and copyright 2015 Twitter.

[LICENSE.txt]: LICENSE.txt