KDE.org/Local Setup

From KDE Community Wiki

Introduction

This page will help you getting started improving the KDE websites. Currently all pages are being ported to WordPress since it offers a full CMS.

Prerequirements

You should have some things running on your machine already before starting. You will need:

  • Apache2 and the usual modules (php such as libapache2-mod-php5)
  • mysql

This could for example look like:

apt-get install apache2 libapache2-mod-php5 php5-mysql mysql-server

Make sure that it works by checking out localhost in a web browser.


You can modify the default setup to do the development in your home directory if it isn't already set up like that. Read up on apache if you want to. Some hints:

sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/kdesites
sudo a2ensite kdesites

The easiest will be to have all kde sites in a subfolder structure, such as:

~/public_html/kdesites/kde.org
~/public_html/kdesites/edu.kde.org

Thus point the apache setup to ~/public_html/kdesites

You can set up local subdomains in /etc/hosts

Setting up

For new sites we use WordPress. You should get the latest WordPress release from: wordpress.org

Simply unzip/tar the download in a sub-folder. Get WordPress working. Next after testing that wordpress works, check out the Neverland theme and create a symlink:

git clone git://anongit.kde.org/websites/neverland
cd neverland
git checkout devel # currently the devel branch is the right one, this might change
cd ../wordpress/wp-content/themes
ln -s ../../../neverland/themes/wordpress/neverland/ .

Check that you have the Neverland theme in wordpress. The header of the page will look a bit strange until you configured a menu in wordpress. Log in as administrator and use Appearance -> Menus to set it up. Also select Screen Options -> Description to be able to edit the menu description (second line of the header).