94 lines
1.8 KiB
ReStructuredText
94 lines
1.8 KiB
ReStructuredText
Available states
|
|
----------------
|
|
|
|
The following states are found in this formula:
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
|
|
``gitea``
|
|
^^^^^^^^^
|
|
*Meta-state*.
|
|
|
|
This installs Gitea,
|
|
manages its configuration
|
|
and then starts the ``gitea`` service.
|
|
|
|
|
|
``gitea.package``
|
|
^^^^^^^^^^^^^^^^^
|
|
Installs Gitea only.
|
|
|
|
Releases are downloaded from the official server by default
|
|
and their signatures verified.
|
|
|
|
|
|
``gitea.config``
|
|
^^^^^^^^^^^^^^^^
|
|
Manages Gitea configuration.
|
|
Has a dependency on `gitea.package`_.
|
|
|
|
|
|
``gitea.service``
|
|
^^^^^^^^^^^^^^^^^
|
|
Starts the Gitea service and enables it at boot time.
|
|
Has a dependency on `gitea.config`_.
|
|
|
|
|
|
``gitea.go``
|
|
^^^^^^^^^^^^
|
|
Creates a build user and downloads Go.
|
|
Required for building Chroma.
|
|
|
|
|
|
``gitea.mods.rst``
|
|
^^^^^^^^^^^^^^^^^^
|
|
Compiles `Chroma <https://github.com/alecthomas/chroma>`_ from source
|
|
and installs a Python script that can be setup as an external renderer
|
|
for ``*.rst`` files.
|
|
|
|
Has a dependency on `gitea.go`_.
|
|
|
|
|
|
``gitea.clean``
|
|
^^^^^^^^^^^^^^^
|
|
*Meta-state*.
|
|
|
|
Undoes everything performed in the ``gitea`` meta-state
|
|
in reverse order, i.e.
|
|
stops the service,
|
|
removes the configuration file and then
|
|
uninstalls the package.
|
|
Some paths are left to avoid accidental data loss
|
|
(namely ``GITEA_WORKDIR``, ``APP_DATA_PATH`` and the gitea user home).
|
|
|
|
|
|
``gitea.package.clean``
|
|
^^^^^^^^^^^^^^^^^^^^^^^
|
|
Removes Gitea.
|
|
Has a dependency on `gitea.config.clean`_.
|
|
|
|
|
|
``gitea.config.clean``
|
|
^^^^^^^^^^^^^^^^^^^^^^
|
|
Removes Gitea configuration. Has a dependency on `gitea.service.clean`_.
|
|
|
|
|
|
``gitea.service.clean``
|
|
^^^^^^^^^^^^^^^^^^^^^^^
|
|
Stops the gitea service and disables it at boot time.
|
|
|
|
|
|
``gitea.go.clean``
|
|
^^^^^^^^^^^^^^^^^^
|
|
Removes the build user and Go installation.
|
|
|
|
|
|
``gitea.mods.rst.clean``
|
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
|
Removes the built ``chroma`` binary, the build path and the
|
|
``grst`` script.
|
|
|
|
|