Usage
=====

Initiating
----------

For the first time run:

.. code:: sh

   rivista-adjust


This will create the defaut CSS and XSLT stylesheets.

Processing
----------

Process content:

.. code:: sh

   rivista-build

Utilize keyword arguments `gemini`, `http`, or `xmpp` to selectively create data
to one or several of these platforms. When no argument is selected, Rivista
Voyager will create all possible data.

.. note::

   The publishing content must be placed in? as a atom compatible file e.g. md, txt, rst

Operating
---------

Start servers:

.. code:: sh

   rivista-server



With no argument given, Rivista Voyager will operate local `gemini` and `http` servers.

There is the option to only start one of them with an argument like:

.. code:: sh

   rivista-server gemini


Alternatively, you can deploy any other Gemini or HTTP server (e.g. GmCapsule or
kHTTPd), preferably with support of CGI scripts, if desired.

.. note::

   While publishing from a local machine, make sure firewall has open ports?
   what else should we care?



.. figure:: _images/rivista_html_server.png
   :align: center

   Rivista html server

.. figure:: _images/rivista_gemini_server.png
   :align: center

   Rivista gemini server