Skip to content

Latest commit

 

History

History
171 lines (127 loc) · 4.25 KB

index.rst

File metadata and controls

171 lines (127 loc) · 4.25 KB

Recovery Source

Recovery Source provides a collection of tools that are meant to demystify website maintenance, leaving :ref:`anyone <def-anyone>` with the skills required to build, deploy, maintain, and support websites for :ref:`12-Step <def-12step>` groups.

:ref:`Our goal <principles>` is to help 12-Step groups reach out to those who are still suffering.

What We Provide ...

This Recovery Source Handbook is designed to take our :ref:`target audience <audience>` from absolute beginner to a competent website administrator who is able to support a website for their 12-Step group.

The documentation provided here covers the breadth of our projects and provides the foundational knowledge required to understand how websites work and how all of the pieces fit together.

The primary purpose of Sober Page is to offer a free :ref:`domain name <def-domain>` and directory listing to 12-Step Sober Support Groups, allowing them to easily create a website and place it onto the internet using a standardized URL format (ex. https://aa0-1.sober.page for Area 0, District 1 of A.A.).

This :ref:`domain solution <domain>` allows us to easily absorb the overhead required to provide a :ref:`basic set of services <soberpage>`, which grants us a tremendous amount of flexibility to resolve a wide variety of "common" issues.

With Sober Page, groups can avoid the cost and hassle of purchasing and naming their own domain, or they use some of the services along with their own existing domain.

Our Website Template provides a "turn-key" website solution that enables you to focus on little more than meeting accuracy. This removes many common stumbling blocks that often lead to financially-problematic results.

Unlike website builders (wix, shopify, squarespace, etc.) or content management systems (wordpress, drupal, etc.), our solution is based on a :ref:`Static Site Generator (SSG) <def-ssg>`, which means there are many options for no-cost website hosting.

The real heavy lifter behind our Website Template is AAMod; this improves accessibility and adds website features designed for 12-Step sites.

This plugin adds many extra features, including automatic generation of foldable meeting schedule (PDF).

Support

Our goal is for :ref:`this handbook <start>` to serve all of your educational needs; if something is missing or explained poorly, we certainly want about it.

Not all things can be answered in documentation, especially if you would like us to help with maintenance tasks; our Discord Link is Open to all.

.. toctree::
   :hidden:
   :includehidden:
   :caption: Our Project

   self
   project/internals
   project/getting-started
   project/glossary

.. toctree::
   :hidden:
   :includehidden:
   :caption: Essentials

   essentials/websites
   essentials/registrars
   essentials/version_control
   essentials/github
   essentials/git
   essentials/formats

.. toctree::
   :hidden:
   :includehidden:
   :caption: Your First Website

   basic/website
   basic/jekyll

.. toctree::
   :hidden:
   :includehidden:
   :caption: Our Domain Solution

   domain/about
   domain/services
   domain/address
   domain/email

.. toctree::
   :hidden:
   :includehidden:
   :caption: Our Website Template

   template/about
   template/new
   template/setup
   template/meeting
   template/page
   template/event
   template/menu
   template/update

.. toctree::
   :hidden:
   :includehidden:
   :caption: Our Template Plugin

   module/about
   module/features
   module/format
   module/prebuild

.. toctree::
   :hidden:
   :includehidden:
   :caption: Helping Others

   helping/issues
   helping/pulls

.. toctree::
   :hidden:
   :includehidden:
   :caption: Developer Corner

   guide/hugo-themes
   guide/html
   guide/css
   guide/actions