1. How to install a local copy of www.gnome.org
This tutorial will show you how to create a local copy of the www.gnome.org (wgo) website. It basically involves two main steps: Installing WordPress, along with the GNOME Grass theme, and uploading the current existing content (posts and pages) to your local instance.
1.1. Pre-Requisites
LAMP stack (Linux, Apache, MySQL, PHP) - Version requirements, How to install LAMP on Fedora or Install LAMP Server on Fedora 20/19
- On Fedora 21, you can do
sudo yum install mariadb mariadb-server sudo yum install httpd php php-common php-mysqlnd
- On Fedora 21, you can do
- Git
- On Fedora 21, you can do
sudo yum install git
- On Fedora 21, you can do
1.2. Steps
1.2.1. 1. Install WordPress
WordPress is an Open Source CMS (Content Management System). WGO runs on top of a WordPress installation.
Follow the steps in the "Famous 5-Minute Install" tutorial to download and set up WordPress
For Step 1, the download step, download WordPress and either
Unzip the package in /var/www/html, e.g. in directory gnome-web-www; you will later be able to view the website at http://localhost/gnome-web-www - this is the way used in the examples through the rest of the page
cd /var/www/html sudo mkdir gnome-web-www sudo chown your-user-name gnome-web-www // extract files into this directory
If you initially extracted files in e.g. wordpress directory in your home directory, then you need to do
cd /var/www/html sudo mkdir gnome-web-www sudo mv ~/wordpress/ html/gnome-web-www restorecon -v -R .
Or enable userdirs (How to enable Apache Userdir on Fedora), which is good for avoiding permission problems; you will later be able to view the website at http://localhost/~your-user-dir/gnome-web-www
- For Step 2, the database creation step, you can create a database with a name "gnomewebwww", user "wordpressgnome" and password "gnomie" as following
sudo systemctl start mariadb sudo mysql CREATE DATABASE gnomewebwww; GRANT ALL PRIVILEGES ON gnomewebwww.* TO "wordpressgnome"@"localhost" IDENTIFIED by "gnomie"; FLUSH PRIVILEGES;
To get to the database console later, do mysql -u wordpressgnome -p gnomewebwww
- For Step 3, the config update step
cd /var/www/html/gnome-web-www/ mv wp-config-sample.php wp-config.php // update name, user, and password in wp-config.php as selected in Step 2
Then start httpd with sudo systemctl start httpd and set your WordPress instance up by visiting http://localhost/gnome-web-www/wp-admin/install.php
1.2.2. 2. Install the GNOME Grass theme
In /var/www/html/gnome-web-www/wp-content/themes, run git clone git://git.gnome.org/gnome-web-www or, if you have a GNOME Git account, git clone ssh://your-git-username@git.gnome.org/git/gnome-web-www
If you ran the first command, but later want to set up access with your GNOME Git account, edit /var/www/html/gnome-web-www/wp-content/themes/gnome-web-www/.git/config and update url to ssh://your-git-username@git.gnome.org/git/gnome-web-www
1.2.3. 3. Import content from WGO
Download the WGO content XML file (this is a file with content as of 2014; if you need latest content, ask someone with admin privileges for www.gnome.org to provide you with an export file; but most likely you don't need the latest content locally)
Install the WordPress Importer plugin following the instructions for installing a plugin.
- Make wp-content writable by Apache by running
cd /var/www/html/gnome-web-www/wp-content sudo chown -R apache wp-content
- Import the XML file
Set Home to the frontpage in Settings > Reading > Homepage.
Troubleshooting:
1.2.4. 4. View the pages
You can view the static pages by, for example, visiting http://localhost/gnome-web-www/wp-content/themes/gnome-web-www/theme/opw