Jump to content

KDE.org/Local Setup: Difference between revisions

From KDE Community Wiki
m fix typo
Remove page contents as it's no longer needed
Tag: Replaced
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
This documentation has been simplified and moved.


[[Image:Webworld-128.png|right]]
Please visit https://community.kde.org/KDE.org to see general instructions on how to set up websites locally, or visit the [https://invent.kde.org/websites/hugo-kde/-/wikis/home Hugo KDE repository wiki] to see how to set up websites that use Hugo, which comprise the majority of our websites.
 
== Setting up kde.org ==
 
This was done with Arch Linux, PHP 7.3 and Apache 2.4. Expect minor change with another distribution.
 
* Install and enable apache and php-fpm (See https://wiki.archlinux.org/index.php/Apache_HTTP_Server#Using_php-fpm_and_mod_proxy_fcgi).
 
* In {{Path|/var/www/}}, clone the following repositories:
{{Input|svn co svn://anonsvn.kde.org/home/kde/trunk/www/sites/www/ kde.org
git clone https://anongit.kde.org/websites/capacity
cd kde.org
git clone git@invent.kde.org:websites/kde-org-applications.git applications
cd applications
git clone [email protected]:websites/kde-org-applications-extractor.git
}}
 
You should get the following directory structure:
{{Output|├── capacity
└── kde.org
    └── applications
        └── kde-org-applications-extractor
}}
 
 
* Create the following vhost file
{{Input|<VirtualHost *:80>
    ServerName localhost
 
    DocumentRoot /var/www/kde.org
    ErrorLog /var/log/httpd/kde.org-error.log
    CustomLog /var/log/httpd/kde.org.log combined
 
    <Directory /var/www/kde.org>
        AllowOverride All
        Require all granted
        FallbackResource /index.php
    </Directory>
</VirtualHost>}}
 
* Enable the virtual host
 
* In {{Path|/etc/php/php.ini}}, update the <code>include_path</code> variable.
{{Input|1=include_path = ".:/php/includes:/var/www/capacity/includes:"}}
 
* Restart the httpd and php-fpm services
{{Input|1=systemctl restart httpd php-fpm}}
 
* Setup kde.org/applications. See [[KDE.org/applications]].
 
If the instruction didn't work for you, and you were able to fix it. Please add how you did it.
 
If the instruction didn't work for you, and you weren't able to fix it. Please contact kde-www at kde dot org and ask for help.
 
{{Note|The information below is mostly outdated.}}
== 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: [http://wordpress.org/ 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).
 
[[Category:KDE Web Team]]

Latest revision as of 01:27, 5 October 2024

This documentation has been simplified and moved.

Please visit https://community.kde.org/KDE.org to see general instructions on how to set up websites locally, or visit the Hugo KDE repository wiki to see how to set up websites that use Hugo, which comprise the majority of our websites.