This is the source code for my personal site logological.org.

It's built using Pelican.

When cloning this repository, make sure to use the --recursive option in order to initialize the submodules.

You'll need the following Python libraries to build the website:

• Pelican
• Markdown
• GitPython

There are various ways you can install these dependencies:

You can install the dependencies system-wide using pip:

sudo pip install pelican markdown gitpython

But if your OS's package manager handles Python libaries, it may be better to use it instead. For example, on openSUSE Tumbleweed, you can get the latest releases of everything with zypper:

sudo zypper ar --refresh --check http://download.opensuse.org/repositories/devel:/languages:/python/openSUSE_Tumbleweed/ devel:languages:python
sudo zypper dup --from devel:languages:python
sudo zypper in python3-pelican python3-Markdown python3-GitPython

While installing dependencies system-wide will usually get you the latest versions, Pelican itself may require older versions. To get around this, you can install the dependencies in a virtual environment:

virtualenv virtualenv
source virtualenv/bin/activate
python -m pip install "pelican[markdown]" gitpython

Use the Makefile:

make html
make serve &
make regenerate &

The command make serve will start a simple server for the output directory where the generated HTML files are. Point your browser to http://localhost:8000 to view the site. Use Ctrl+C to kill the server.

make deploy

The website style has been adapted from the StartBootstrap resume theme. Icons are provided by FontAwesome, Academicons, and Material Design Icons.

The theme and source code (but not the content!) is licensed under the MIT License.