centos.org website repository
Fabian Arrotin
2018-10-23 4f77192b895ec17fadcf1d17fa8ff3c033ad0180
commit | author | age
e8ec7a 1
e94fa4 2 The site is built with *nanoc* and *Bootstrap 3*.
JP 3
4   * http://www.nanoc.ws
5   * http://getbootstrap.com
6
7 We use haml for templates where it makes sense and mostly markdown for
8 content.
9
10
11 Required Gems:
12
13   * nanoc
14   * cri
15   * compass
16   * haml
17   * nokogiri // available from Fedora (EPEL?) repository
18   * kramdown 
19   * pry
20   * rainpress
21   * rubypants
22   * sass
23   * susy
24   * systemu
25   * asciidoc // also requires the asciidoc package
26   * adsf // if using 'nanoc view' command
27
28 May be in RPM:
29
30   * ruby
31   * asciidoc
32   * nokogiri
33
fdc62c 34 ## Installing on CentOS 7 as well as F19/20/21:
e8ec7a 35
e94fa4 36 <pre>
1e5375 37 sudo yum install ruby asciidoc rubygem-bundler make gcc ruby-devel zlib-devel zlib gcc-c++
ce0219 38 bundle install
e94fa4 39 </pre>
7f616c 40
fdc62c 41
FA 42 ## Using a built container (all platforms):
43 Assuming that you have this git repository cloned under /opt/data/git/centos.org : 
44 ```
4f7719 45 sudo docker pull registry.centos.org/arrfab/nanoc:latest # Download the container
FA 46 sudo docker run --rm -v /opt/data/git/centos.org/:/nanoc/:Z registry.centos.org/arrfab/nanoc:latest
fdc62c 47 ```
4f7719 48 Please note that it also works with Podman, so no need to install Docker anymore ! :
FA 49
50 ```
51 sudo yum install -y podman
52 sudo podman run --rm -v /opt/data/git/centos.org/:/nanoc/:Z registry.centos.org/arrfab/nanoc:latest
53 ```
54
fdc62c 55
7f616c 56 #Site Layout
JP 57   * Template and menu files live in /layouts
58   * Markdown, erb and processed text files live in /content
59   * Static site content such as images and javascript live in /static
60   * The /lib directory contains nanoc helper files used to process the site
61   * Compiled site content exists in /output
62
63 #Building the site
64   * Run 'nanoc' to compile assemble the static site. files from /static, /content, and /layouts will be combined.
65   * You may view the site with 'nanoc view' and then pointing your browser at http://127.0.0.1:3000
66
67 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. 
68 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.
69 Next run 'nanoc view &', followed by 'guard'
70 Now in another terminal, you may make changes to the website content, and it will rebuild as you touch files. 
71
72
73 #Deploying the site
74 Simply run 'nanoc deploy --target=' where the target value is either prod1 or prod2. These targets are defined in the nanoc.yaml file.