From 2fe8b034294531c503c35820681eb34a9995c13c Mon Sep 17 00:00:00 2001 From: Matthew Marchese Date: Sun, 6 Feb 2022 21:18:51 -0800 Subject: Break README.md file into sections. Build the site and maintain the site. Mention bundler should now be used to pull the latest dependency information from a Gentoo system since Ruby is in shambles. Signed-off-by: Matthew Marchese --- README.md | 39 +++++++++++++++++++++++++++++++++------ 1 file changed, 33 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index f730997..dc591a5 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,29 @@ -## Dependencies +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: @@ -10,18 +35,20 @@ To get the dependencies on Gentoo systems using Portage: * 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 +#### Optional * net-misc/wget - Downloads files containing dynamic data (see below). -## Dynamic data +### 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. +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 +### 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 -Frontpage news item are built from the `_posts/` directory. +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. -- cgit v1.2.3-65-gdbad