Go to file
Tomas Groth 2c5a4fad08 Merge branch 'remove-ppa-reference' into 'master'
Remove instructions to use the PPA

See merge request openlp/documentation!30
2023-06-13 19:13:09 +00:00
api Bump docs version to 3.0 2020-12-17 22:47:28 +01:00
common Moved things around a bit, put shared stuff into common. 2012-10-13 18:53:21 +02:00
manual Remove instructions to use the PPA 2023-06-07 10:31:30 -07:00
scripts Added docs for Xfce4 and workaround. 2015-10-15 21:38:03 +01:00
user-guide Added an introductory section on the front page with a link to the reference manual. 2012-12-03 20:35:55 +02:00
.gitignore Add the OpenLP documentation icon 2019-04-17 11:06:44 -07:00
.gitlab-ci.yml Use the documentation Docker image and build a PDF 2019-10-03 20:01:03 +00:00
LICENSE Add LICENSE file to release documentation under a CC-BY-SA-4.0 license. 2019-04-24 09:39:29 -07:00
openlp-docs-icon.png Add the OpenLP documentation icon 2019-04-17 11:06:44 -07:00
openlp-docs-icon.svg Add the OpenLP documentation icon 2019-04-17 11:06:44 -07:00
plugin.txt Initial import of documentation. 2011-05-08 23:22:30 +02:00
PluginDevelopersGuide.txt Initial import of documentation. 2011-05-08 23:22:30 +02:00
README.rst Fix up the link at the bottom 2019-04-18 10:44:36 -07:00
style_guide.rst Fixed #16 Add information about editing a Bible 2019-06-21 20:01:59 +00:00

OpenLP Documentation

This repository holds the OpenLP manual and some other documentation.

Getting Started

To get up and running with the documentation, you'll need to install Sphinx and the Read The Docs theme.

Linux

If you're using Linux, you'll want to check your package manager for those packages.

Ubuntu/Debian:

$ sudo apt install python3-sphinx python3-sphinx-rtd-theme

Fedora:

$ sudo dnf install python3-sphinx python3-sphinx_rtd_theme

macOS

On macOS you can install Sphinx via MacPorts or Homebrew.

MacPorts:

$ sudo port install py37-sphinx py37-sphinx_rtd_theme

Homebrew:

$ sudo brew install sphinx-doc

Homebrew doesn't have the Read The Docs theme, so you'll need to install it via pip:

$ sudo pip install sphinx_rtd_theme

Windows

On Windows you'll need to use pip to install Sphinx and the Read The Docs theme:

$ pip install sphinx sphinx_rtd_theme

Editing the Documentation

The documentation is written in reStructuredText. If you haven't ever used reStructuredText before, take a look at the reStructuredText primer for a good introduction to the format.

reStructuredText is a plain-text format, so any text editor will work. Popular editors are vim, Atom, Visual Studio Code (Linux, macOS, Windows), Notepad++ (Windows).

Building the Documentation

Now that you have the dependencies installed and you've edited some pages, you'll want to build the documentation. Let's start with the manual. Go into the manual directory, and then run make html:

$ cd manual
$ make html

This will run Sphinx on the documentation and build the HTML in the build/html directory. To view the documentation, let's run Python's built-in web server on that directory:

$ cd build/html
$ python3 -m http.server

Now open your browser to http://localhost:8000/ and you should see the OpenLP manual.