This is a big dump of old notes from my trying things out.

Yes there are passwords here. It doesn't matter because they're all dead, all these attempts ended in failure and I blew everything away afterwards.

<<TableOfContents>>

= Wagtail =

https://docs.wagtail.io/en/stable/getting_started/tutorial.html

{{{
mkdir -p ~/public_html/rant.meidokon.net/wagtail
cd ~/public_html/rant.meidokon.net/wagtail/
sudo apt install python3.8-venv
python -m venv venv

. ~/public_html/rant.meidokon.net/wagtail/venv/bin/activate
pip install wagtail

# Initialise new site
wagtail start mysite

# Install deps
cd mysite/
pip install -r requirements.txt

# Prep DB
python manage.py migrate

# Setup user
python manage.py createsuperuser
# furinkan // rah.tzr.gzk5MGK1cvk

# Run it, pushing aside Writefreely for the moment
python manage.py runserver 127.0.0.1:9081
https://rant.meidokon.net/
}}}


= Mezzanine =

Then I tried Mezzanine, another CMS/blog.

{{{
# make a new venv, activate it

mkdir -p ~/public_html/rant.meidokon.net/mezzanine
cd ~/public_html/rant.meidokon.net/mezzanine/
sudo apt install python3.8-venv

python -m venv venv
. venv/bin/activate
pip install wheel
pip install Django==2.2.8

#pip install mezzanine
#pip install https://github.com/stephenmcd/mezzanine/archive/refs/heads/master.zip
pip install Mezzanine==5.0.0a1

mezzanine-project myproject
cd myproject

python manage.py createdb

python manage.py runserver 127.0.0.1:9081

fix up myproject/local_settings.py
}}}

At the time of writing these notes (Aug 2021), the quickstart guide on Mezzanine's homepage simply ''does not work'', it's quite broken.



= Zinnia =

Zinnia seemed promising, but it was unmaintained and their demo site had been infected or hijacked with something nasty.

== venv ==

New venv, activate it

Clone git repo, cd there
{{{
python setup.py install
}}}

Now we have a bleeding edge version installed in our environment.

{{{
pip install wheel
apt install libpq-dev
pip install psycopg2
}}}

== prepare DB ==
{{{
furinkan // xpj2BWV5qaz8fzb.mcq

postgres@suomi:~$ createuser --echo --pwprompt furinkan
Enter password for new role: 
Enter it again: 
SELECT pg_catalog.set_config('search_path', '', false);
CREATE ROLE furinkan PASSWORD 'md5e4265ae16636fbcd284aa47e8c9cd121' NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;

postgres@suomi:~$ createdb --echo --encoding=UTF8 --owner=furinkan rant_meidokon "Blog at rant.meidokon.net"
SELECT pg_catalog.set_config('search_path', '', false);
CREATE DATABASE rant_meidokon OWNER furinkan ENCODING 'UTF8';
COMMENT ON DATABASE rant_meidokon IS 'Blog at rant.meidokon.net';
}}}

== setup django project ==

{{{
django-admin startproject rant

cd into rant/

configure rant/settings.py

# populate DB
./manage.py migrate

./manage.py runserver
}}}

== wrangle secrets ==

Put them outside the settings file, eg. `/home/furinkan/git/rant/deployment_secrets.py`

Then in `/home/furinkan/git/rant/rant/settings.py` you can do `import deployment_settings`


== customisation ==
{{{
pip install markdown

mkdir -p templates/zinnia

Add
BASE_DIR / 'templates',
to the TEMPLATES['DIRS'] in settings.py (literally as shown, it's hax)
}}}

Create the django superuser
{{{
furinkan // fric@whus9joss6SUCH
fric@whus9joss6SUCH
}}}


Try adding a nice theme, this seemed kinda promising that they even have themes: https://github.com/django-blog-zinnia/zinnia-theme-foundation
{{{
pip install git+git://github.com/django-blog-zinnia/zinnia-theme-foundation.git
}}}

Fix up templates loader as directed, and install the loader from pip:
{{{
pip install django-app-namespace-template-loader
}}}

== Fixes ==

Ran into this problem, I had to fix 3 templates: https://stackoverflow.com/questions/55929472/django-templatesyntaxerror-staticfiles-is-not-a-registered-tag-library

== Lock it down for deployment ==

Should do this: https://docs.djangoproject.com/en/3.2/howto/deployment/checklist/



= Puput =

== Latest ==

Try to run latest version of Puput.

New venv, activate it, install wheel
{{{
. ~/venvs/puput/bin/activate

pip install puput  # this gets django 3.0.14 and wagtail 2.14.1

django-admin startproject puputrant
cd puputrant
python manage.py migrate
}}}

Edit `settings.py` and append `PUPUT_APPS`

and I've just found a new DB problem: https://stackoverflow.com/questions/68024060/assertionerror-database-connection-isnt-set-to-utc

This may be due to the order that I've installed and migrated the server. Again. :/

{{{
// use this requirement as a preinstall
psycopg2>=2.8,<2.9
}}}

== Try with stricter versions ==
{{{
pip install 'Django>=2.2,<3.0'
pip install 'wagtail>=2.7,<2.14'
pip install puput
}}}

We now have django 2.2.24, wagtail 2.13.4, puput 1.1.1

{{{
django-admin startproject puputrant2
cd puputrant2
python manage.py migrate

// edit settings.py and append PUPUT_APPS

// middleware stuff is wrong? I used this last time
'wagtail.contrib.legacy.sitemiddleware.SiteMiddleware',
'wagtail.contrib.redirects.middleware.RedirectMiddleware',
}}}

Stumble through rest of guide https://puput.readthedocs.io/en/latest/setup.html
{{{
./manage.py createsuperuser
./manage.py runserver 0:8081

furinkan // fric@whus9joss6SUCH
}}}



== A clean working attempt ==

Okay let's document '''the whole thing''' from scratch, so it's reproducible.

This should be kinda copypasta-able, so when you screw it up you can just blow it away and try again with minimal effort.

{{{
deactivate
rm -rf ~/venvs/rant
pip cache purge
python -m venv ~/venvs/rant
. ~/venvs/rant/bin/activate
pip install wheel

pip install 'Django>=2.2,<3.0'
pip install 'wagtail>=2.7,<2.14'
pip install 'psycopg2>=2.8,<2.9'
pip install puput

pip install 'Django>=2.2,<3.0' 'wagtail>=2.7,<2.14' 'psycopg2>=2.8,<2.9' --no-cache-dir
pip install puput==1.1.1 --no-cache-dir  # this just happens to be the current version
}}}

We now have django 2.2.24, wagtail 2.13.4, puput 1.1.1, psycopg2 2.8.6

Clean database up now
{{{
sudo -u postgres createuser --echo --pwprompt furinkan
sudo -u postgres dropdb rant_meidokon
sudo -u postgres -- createdb --echo --encoding=UTF8 --owner=furinkan rant_meidokon "Blog at rant.meidokon.net"
}}}

Setup the django project
{{{
cd ~/git/
rm -rf ~/git/rant/
django-admin startproject rant
cd rant/
}}}

Now do DB and TZ setup in settings.py
{{{
cp ../deployment_secrets.py ./
vim rant/settings.py
import deployment_secrets
TIME_ZONE = 'Australia/Sydney'
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'rant_meidokon',
        'USER': deployment_secrets.DB_USER,
        'PASSWORD': deployment_secrets.DB_PASS,
}}}

Create data structures in the DB
{{{
python manage.py migrate
python manage.py createsuperuser

# furinkan // fric@whus9joss6SUCH
}}}

And try running it now:
{{{
python manage.py runserver 0.0.0.0:8081
}}}


Edit `settings.py` according to docs, adding this
{{{
from puput import PUPUT_APPS
INSTALLED_APPS += PUPUT_APPS
}}}

Try `runserver`, see it suggests migrating. So migrate now:
{{{
python manage.py migrate
}}}

Try runserver again and it works fine? Okay let's keep going.

 * Add two lines to `MIDDLEWARE`, test again.
 * Fails, because the dot paths are wrong.
 * Try the `contrib` path, which became a thing in wagtail 2.11(?)
  * https://docs.wagtail.io/en/v2.11.2/releases/2.11.html?highlight=SiteMiddleware#sitemiddleware-moved-to-wagtail-contrib-legacy
 * Good to know this is a deprecated thing too... {{{
    'wagtail.contrib.legacy.sitemiddleware.SiteMiddleware',
    'wagtail.contrib.redirects.middleware.RedirectMiddleware',
}}}

Well, `runserver` works again, so let's try the next step. Set the `WAGTAIL_SITE_NAME` variable, this shouldn't break anything.
{{{
WAGTAIL_SITE_NAME = 'Meidokon Rants'
}}}

Now setup some minimal urlpatterns:
{{{
import puput
from django.contrib import admin
from django.urls import path
from django.urls import include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include(puput.urls)),
]
}}}

And with any luck, it might even work now??!?

=== Nope no code highlighting ===

Some random links, the first two relate to code highlighting. I dunno why I have the third one:
 * https://github.com/APSL/puput/issues/240
 * https://github.com/farlandliu/puputblog
 * https://titanwolf.org/Network/Articles/Article?AID=b57e9467-a8c5-4774-bde9-0bf450c3b047#gsc.tab=0

=== Migrations ===

I don't know why I have this noted down either.
{{{
activate rant venv
cd /home/furinkan/git/rant
python manage.py runserver 0.0.0.0:8081


add migration modules to rant/settings.py
    MIGRATION_MODULES = {'puput': 'rant.puput_migrations'}
makemigrations puput
add/edit rant/models.py
makemigrations again
}}}



= Bulma =

Alright let's try this one: https://github.com/Pei2tech/Django-Puput-Bulma-Demo

Notes made on 2021-09-25

== Install ==

{{{
deactivate
rm -rf ~/venvs/bulma
pip cache purge
python -m venv ~/venvs/bulma
. ~/venvs/bulma/bin/activate
pip install wheel

pip install Django==3.0.14 puput==1.1.1 wagtail-markdown==0.7.0 Unidecode==1.2.0 'psycopg2>=2.8,<2.9' --no-cache-dir

# We now have:
#   Django 3.0.14
#   Wagtail 2.14.1 (happens to be latest?)
#   Puput 1.1.1 (happens to be latest)
#   Psycopg2 2.8.6
}}}

== Clean up database ==
{{{
sudo -u postgres createuser --echo --pwprompt furinkan
sudo -u postgres dropdb bulma
sudo -u postgres -- createdb --echo --encoding=UTF8 --owner=furinkan bulma "Blog using bulma"
}}}

== Setup django project ==
{{{
cd ~/git/
rm -rf ~/git/bulma/
git clone https://github.com/Pei2tech/Django-Puput-Bulma-Demo.git bulma
cd bulma/Myblog/

# Now do DB and TZ setup in settings.py
cp ../deployment_secrets.py ./
vim rant/settings.py
import deployment_secrets
TIME_ZONE = 'Australia/Sydney'
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'rant_meidokon',
        'USER': deployment_secrets.DB_USER,
        'PASSWORD': deployment_secrets.DB_PASS,
}}}

Create data structures
{{{
python manage.py migrate
python manage.py createsuperuser

# furinkan // fric@whus9joss6SUCH

python manage.py runserver 0.0.0.0:8081
}}}


== Edit settings.py according to docs ==
{{{
from puput import PUPUT_APPS
INSTALLED_APPS += PUPUT_APPS

# try runserver, see it suggests migrating. So migrate now
python manage.py migrate

# runserver again and it works fine, let's keep going
# add two lines to MIDDLEWARE, test again
# fails, because the dot paths are wrong. try the contrib, which became a thing in wagtail 2.11(?)
# https://docs.wagtail.io/en/v2.11.2/releases/2.11.html?highlight=SiteMiddleware#sitemiddleware-moved-to-wagtail-contrib-legacy
# Good to know this is a deprecated thing too...
    'wagtail.contrib.legacy.sitemiddleware.SiteMiddleware',
    'wagtail.contrib.redirects.middleware.RedirectMiddleware',
}}}

runserver works again, let's try the next step

{{{
# Set the WAGTAIL_SITE_NAME variable
WAGTAIL_SITE_NAME = 'Meidokon Rants'

# Set minimal urlpatterns
import puput
from django.contrib import admin
from django.urls import path
from django.urls import include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include(puput.urls)),
]

}}}