ABlog
=====

This blog is written using `ABlog <https://ablog.readthedocs.io>`_, an extension to `Sphinx <https://www.sphinx-doc.org/en/master/>`_
that adds blogging features (posts, tags, categories, archives, feeds) on top of plain
`Restructured Text <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html>`_ pages.

A page becomes a blog post by adding ABlog's ``post`` directive near the top, as shown in :doc:`rst`. ABlog then uses
the ``blog_title``, ``blog_baseurl`` and ``blog_authors`` settings in ``conf.py`` to generate the archive, author and
category pages under ``_build/html/blog``.

https://ablog.readthedocs.io/manual/ablog-commands/

.. code-block:: text

    start       start a new blog project
    build       build your blog project
    clean       clean your blog build files
    serve       serve and view your project
    post        create a blank post
    deploy      deploy your website build files

    See 'ablog <command> -h' for more information on a specific command.

.. code-block:: bash

    $ ablog clean && ablog build && ablog serve  # Ctrl+C to stop the local server
    $ ablog serve -r                             # rebuild and reload on changes

``ablog build`` writes to ``_website`` by default, whereas ``sphinx-build`` (used in :doc:`build`) writes to
``_build/html``.

See :doc:`build` for how ``ablog build``/``deploy`` fits into publishing this site, and
:doc:`github_pages` for the deployment target itself.