blob: dc591a5a89c4ed40d8581ad7567b340e487f7b3b (
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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
www.g.o
---
This repository is the home of www.gentoo.org.
## Building the site
### Using bundler
Ensure dev-ruby/bundler has been emerged:
`# emerge -a dev-ruby/bundler`
From the base of the installation directory run the following to get the dependencies:
`bundler install`
Then issue the following to start the jekyll server:
`bundler exec jekyll serve`
### Building the site natively (depreciated)
This section has been depreciated due to certain ruby dependencies not being available in main Gentoo ebuild repository.
### 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. This gem is required for GLEP generation (used by _plugins/gleps.rb).
* dev-ruby/base32 - A Ruby library for base32 decoding and encoding. This gem is required for OpenPGP keys (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. Once the site builds it will (by default) be hosted at http://127.0.0.1:4000
## Maintaining the site
## Posting news items
Front page news item are built from the `_posts/` directory. The simple method is to copy and paste one of the recent news posts and then edit as necessary.
|
GitWeb
