moinmoin-acaro/README.md

68 lines
1.9 KiB
Markdown
Raw Normal View History

2017-08-26 13:36:31 +02:00
# Acaro
A theme for MoinMoin.
## How to install
Once you're connected to the server via SSH run the following commands as root.
git clone --depth 1 https://git.unit.macaomilano.org/unit/moinmoin-acaro.git
cd moinmoin-acaro
make install
## How to develop and test
### Installing MoinMoin locally
All you need is Python 2 (Python 3 is not supported and will likely never be)
and python-virtualenv.
Replace `/tmp/moin` with the path you want to install MoinMoin in.
mkdir /tmp/moin
cd /tmp/moin
virtualenv -p python2 env
source env/bin/activate
pip install moin
mkdir wiki
cp -pr env/share/moin/{data,config,underlay} wiki/
cp -pr env/share/moin/config/wikiconfig.py wiki/
moin --config-dir=wiki account create --name=admin --email=admin@localhost --password=admin
sed -i '/FrontPage/s/#//g' wiki/wikiconfig.py
sed -i '/superuser.*YourName/s/#//g' wiki/wikiconfig.py
sed -i '/superuser.*YourName/s/YourName/admin/g' wiki/wikiconfig.py
### Running MoinMoin
From now on you just need to activate the python virtualenv and execute the
following command to run a working testing MoinMoin instance.
cd /tmp/moin
source env/bin/activate
moin --config-dir=wiki server standalone
Something like this will show up. Follow the link to be greeted by MoinMoin.
2017-08-26 12:32:14,027 INFO werkzeug:87 * Running on http://localhost:8080/ (Press CTRL+C to quit)
### Installing Acaro in the test environment
Replace `/tmp/moin` with the path you have installed MoinMoin in.
git clone --depth 1 https://git.unit.macaomilano.org/unit/moinmoin-acaro.git
cd moinmoin-acaro
Eventually run the following command as command as root.
PREFIX=/tmp/moin/wiki UID=$(id -u) GID=$(id -g) make install
To enable the theme in the settings run the followin command.
cd /tmp/moin
sed -i "/theme_default/s/^\w+.*/theme_default = 'acaro'/" wiki/wikiconfig.py
You're ready to go!