Source code for my personal website
CSS HTML ApacheConf Python Makefile JavaScript TeX
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
content
pelican-plugins @ 76a8be9
publications
theme
.gitignore
.gitmodules
Makefile
README.md
pelicanconf.py
publishconf.py
rsync_exclude.txt

README.md

Souce code for logological.org

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

It's built using Pelican and based on the website of Leonardo Uieda.

Dependencies

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

  • Pelican
  • Markdown
  • GitPython

You can install them using pip3:

sudo pip3 install pelican markdown gitpython

But if your OS's package manager handles Python libaries, it's 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 python-pelican python-Markdown python-GitPython

After cloning this repository, you'll need to initialize the Git submodules for the Pelican plugins:

cd pelican-plugins
git submodule init
git submodule update

Compiling the site

Use the Makefile:

make html
make serve

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.

Deploying the site

make deploy

The theme

The website theme is made using bootstrap and tweaked from the Bootswatch themes. Icons are provided by FontAwesome and Academicons.

The Jinja2 templates and CSS are located in the theme folder.

License

Creative Commons License The theme and source code (but not the content!) is licensed under a Creative Commons Attribution 4.0 International License.