62 lines
1.6 KiB
ReStructuredText
62 lines
1.6 KiB
ReStructuredText
russell.ballestrini.net
|
|
#######################
|
|
|
|
This is the source code for `my blog <https://russell.ballestrini.net>`_. My blog is a static web site with just HTML!
|
|
This project uses Pelican (a static site generator) to produce HTML from ``.rst`` or ``.md`` files.
|
|
|
|
Pelican is written in Python and uses Jinja2 template engine by default.
|
|
|
|
Need a new blog post entry?
|
|
===============================
|
|
|
|
Try running:
|
|
|
|
.. code-block:: bash
|
|
|
|
./new_entry
|
|
|
|
|
|
development
|
|
===============================
|
|
|
|
Clone this repo, then in the ``pelican-themes`` directory clone this repo:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd pelican-themes
|
|
git clone git@github.com:russellballestrini/pelican-svbhack.git
|
|
cd ..
|
|
|
|
To install this theme:
|
|
|
|
.. code-block:: bash
|
|
|
|
pelican-themes -i pelican-themes/pelican-svbhack/
|
|
|
|
|
|
Next clone the `pelican-plugins` repo (I use ``random_article``)
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone git@github.com:getpelican/pelican-plugins.git
|
|
|
|
In development I use a ``make`` file to hold common build and test commands::
|
|
|
|
make clean && make html && make serve
|
|
|
|
I also manage my resume using ``.rst`` and I use the ``rst2pdf`` tool to turn it into a ``.pdf``::
|
|
|
|
make clean && make html && make resume
|
|
|
|
|
|
|
|
production release process
|
|
===============================
|
|
|
|
I use Gitlab runners to build (look at .gitlab-ci.yml file) this site and Salt Stack to release the zipped artifacts.
|
|
|
|
Any web server may be used to host an HTML site. I choose nginx in production because it is known to be very fast at serving static files.
|
|
|
|
I use environment variables in my ``pelicanconf.py`` to store secrets.
|
|
|
|
For example: `Remarkbox comments <https://www.remarkbox.com>`_.
|