jasonbrooks / centos / centos.org

Forked from centos/centos.org 5 years ago
Clone
README.md

The site is built with nanoc and Bootstrap 3.

We use haml for templates where it makes sense and mostly markdown for content.

Required Gems:

  • nanoc
  • cri
  • compass
  • haml
  • nokogiri // available from Fedora (EPEL?) repository
  • kramdown
  • pry
  • rainpress
  • rubypants
  • sass
  • susy
  • systemu
  • asciidoc // also requires the asciidoc package
  • adsf // if using 'nanoc view' command

May be in RPM:

  • ruby
  • asciidoc
  • nokogiri

Installing on CentOS 7 as well as F19/20/21:

sudo yum install ruby asciidoc rubygem-bundler make gcc ruby-devel zlib-devel zlib gcc-c++
bundle install

Using a built container (all platforms):

Assuming that you have this git repository cloned under /opt/data/git/centos.org :

sudo docker pull registry.centos.org/arrfab/nanoc:latest # Download the container
sudo docker run --rm -v /opt/data/git/centos.org/:/nanoc/:Z registry.centos.org/arrfab/nanoc:latest

Please note that it also works with Podman, so no need to install Docker anymore ! :

sudo yum install -y podman
podman run --rm -v /opt/data/git/centos.org/:/nanoc/:Z registry.centos.org/arrfab/nanoc:latest

View the output

You can just use python http server to view the locally rendered site, before pushing to httpd node. For this you can just use something like this :

cd /opt/data/git/centos.org
which python3 >/dev/null && python3 -m http.server 9000 || python -mSimpleHTTPServer 9000

Site Layout

  • Template and menu files live in /layouts
  • Markdown, erb and processed text files live in /content
  • Static site content such as images and javascript live in /static
  • The /lib directory contains nanoc helper files used to process the site
  • Compiled site content exists in /output