openlp/website
1
0
Fork 0
mirror of https://gitlab.com/openlp/website.git synced 2024-12-22 04:52:49 +00:00
Code Issues Projects Releases Wiki Activity
This is a mirror of the official repository at https://gitlab.com/openlp/website
31 Commits 1 Branch 0 Tags 60 MiB
PHP 51.1%
JavaScript 27.2%
HTML 8.1%
CSS 7.1%
Python 6.5%
96437d41a0
Go to file
Raoul Snyman 96437d41a0 - Fix up some styling and image issues; add another image from the old site. 
- Make the spacing between the menu items slightly smaller so that they all fit on the same line on my netbook
- Add latest blog post
- Set code colour to monokai and show teasers
- Add cover image for server and support post
- Add a cover image to the 2.0.4 release post
- Migrate images to new site
- Fix up some more posts
- Fixed up various rST issues after the conversion from HTML

bzr-revno: 13
2015-08-31 21:17:20 +02:00
blog Fix up some styling and image issues; add another image from the old blog 2015-08-30 22:18:34 +02:00
files Fix up some styling and image issues; add another image from the old blog 2015-08-30 22:18:34 +02:00
pages Make theme use the preview image 2015-07-15 23:14:54 +02:00
themes/openlp2v2 Fix up some styling and image issues; add another image from the old blog 2015-08-30 22:18:34 +02:00
.bzrignore Ignore tarballs 2015-08-28 22:09:52 +02:00
conf.py Upstream 2015-08-29 00:03:21 +02:00
README.rst Add a README.rst file so that folks know how to get set up to build the website. 2015-08-06 23:26:16 +02:00

README.rst

OpenLP Website

This repository holds the OpenLP website, so that anyone can contribute to the site.

The website is built using Nikola, the static site generator. It uses Disqus for comments, which has superior spam detection and moderation tools. The instructions below show you how to get set up on your local machine.

Installing Nikola

The OpenLP site is built on Nikola 7.6.x. This means you'll probably need to install it in a virtual environment. Not to worry, this is pretty simple.

First up, install the python-virtualenv package:

$ sudo apt-get install python-virtualenv

Now create a virtual environment somewhere. I usually put it in the same directory as my Bazaar repositories:

$ virtualenv venv

Once that has been created, you can install Nikola with pip:

$ cd venv/bin
$ ./pip install --upgrade nikola

Note: I'm using ``--upgrade`` to make sure that I install the latest version of Nikola, so that even if I have a version of Nikola installed, I'll have the latest and greatest here.

I like to symlink the nikola binary into the project directory I'm working in, for ease of use:

$ cd ~/projects/openlp/website
$ ln -s ~/venv/bin/nikola nikola

Now you're ready to start working on the web site. Next step is to build the site:

$ nikola build

That will run through a whole bunch of stuff and build the site for you. To run the site, simply use the serve command:

$ nikola serve

This will start a local Python web server and tell you where to go in your browser in order to preview the site.

Once you're this far, you'll be ready to start contributing toward the we site. Have fun!