|
 |
e94fa4 |
The site is built with *nanoc* and *Bootstrap 3*.
|
|
|
e94fa4 |
|
|
|
e94fa4 |
* http://www.nanoc.ws
|
|
|
e94fa4 |
* http://getbootstrap.com
|
|
|
e94fa4 |
|
|
|
e94fa4 |
We use haml for templates where it makes sense and mostly markdown for
|
|
|
e94fa4 |
content.
|
|
|
e94fa4 |
|
|
|
e94fa4 |
|
|
|
e94fa4 |
Required Gems:
|
|
|
e94fa4 |
|
|
|
e94fa4 |
* nanoc
|
|
|
e94fa4 |
* cri
|
|
|
e94fa4 |
* compass
|
|
|
e94fa4 |
* haml
|
|
|
e94fa4 |
* nokogiri // available from Fedora (EPEL?) repository
|
|
|
e94fa4 |
* kramdown
|
|
|
e94fa4 |
* pry
|
|
|
e94fa4 |
* rainpress
|
|
|
e94fa4 |
* rubypants
|
|
|
e94fa4 |
* sass
|
|
|
e94fa4 |
* susy
|
|
|
e94fa4 |
* systemu
|
|
|
e94fa4 |
* asciidoc // also requires the asciidoc package
|
|
|
e94fa4 |
* adsf // if using 'nanoc view' command
|
|
|
e94fa4 |
|
|
|
e94fa4 |
May be in RPM:
|
|
|
e94fa4 |
|
|
|
e94fa4 |
* ruby
|
|
|
e94fa4 |
* asciidoc
|
|
|
e94fa4 |
* nokogiri
|
|
|
e94fa4 |
|
|
|
e94fa4 |
Installing on Fedora 19/20:
|
|
|
e94fa4 |
Packages will come later for the dependencies.
|
|
|
e94fa4 |
|
|
|
e94fa4 |
sudo yum install ruby asciidoc nokogiri
|
|
|
e94fa4 |
gem install nanoc adsf cri compass haml kramdown pry rainpress rubypants sass susy systemu guard-nanoc
|
|
|
e94fa4 |
|
|
|
e94fa4 |
|
|
|
e94fa4 |
|
|
|
e94fa4 |
#Site Layout
|
|
|
e94fa4 |
* Template and menu files live in /layouts
|
|
|
e94fa4 |
* Markdown, erb and processed text files live in /content
|
|
|
e94fa4 |
* Static site content such as images and javascript live in /static
|
|
|
e94fa4 |
* The /lib directory contains nanoc helper files used to process the site
|
|
|
e94fa4 |
* Compiled site content exists in /output
|
|
|
e94fa4 |
|
|
|
e94fa4 |
#Building the site
|
|
|
e94fa4 |
* Run 'nanoc' to compile assemble the static site. files from /static, /content, and /layouts will be combined.
|
|
|
e94fa4 |
* You may view the site with 'nanoc view' and then pointing your browser at http://127.0.0.1:3000
|
|
|
e94fa4 |
|
|
|
e94fa4 |
You may compile and view the site live as you make changes using the guard module. To do this, run 'guard init' at the root of the site.
|
|
|
e94fa4 |
This will create a watch file that will serve as list for what files the guard module will keep an eye on. Changes to these files will trigger an automatic rebuild of the site.
|
|
|
e94fa4 |
Next run 'nanoc view &', followed by 'guard'
|
|
|
e94fa4 |
Now in another terminal, you may make changes to the website content, and it will rebuild as you touch files.
|
|
|
e94fa4 |
|
|
|
e94fa4 |
|
|
|
e94fa4 |
#Deploying the site
|
|
|
e94fa4 |
Simply run 'nanoc deploy --target=' where the target value is either prod1 or prod2. These targets are defined in the nanoc.yaml file.
|