aboutsummaryrefslogtreecommitdiff
blob: 9b047f7dc8433cb9b893686e21ae1affde113308 (plain)
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
## Dependencies

To get the dependencies on Gentoo systems using Portage:

`emerge www-apps/jekyll dev-ruby/nokogiri dev-ruby/kramdown dev-ruby/rbst dev-ruby/base32`

* www-apps/jekyll - The static web engine for this site.
* dev-ruby/nokogiri - A Ruby plugin to add support for parsing HTML/XML documents. Takes action on devaway, mirror information, packages, blogs (planet), and wiki articles (see files in the _data directory).
* dev-ruby/kramdown - A Ruby plugin to add support for kramdown, a superset of the Markdown markup language. kramdown is used throughout this site.
* dev-ruby/rbst - A Ruby wrapper for processing reStructuredText via Python's Docutils. Required for GLEP generation.
* dev-ruby/base32 - A Ruby library for base32 decoding and encoding (used by _plugins/wkd.rb).

### Optional

* net-misc/wget - Downloads files containing dynamic data (see below).

## Dynamic data

Once the dependencies have been emerged, run `bash ./bin/update.sh` from this repository's base directory to update the site's data that is dynamically generated. Expect "LDAP user information" to be skipped on systems that are not directly connected to Gentoo's LDAP infrastructure.

## Generation

Issue a `jekyll serve` to build the site.

## Posting news items

Frontpage news item are built from the `_posts/` directory.