70 lines
2.1 KiB
ReStructuredText
70 lines
2.1 KiB
ReStructuredText
|
|
Rattail Tutorial
|
|
================
|
|
|
|
First of all, welcome to Rattail!
|
|
|
|
This project is a tutorial of sorts, to show how to use Rattail in the real
|
|
world. (It is accordingly named 'rattail-tutorial'.)
|
|
|
|
While it aims to cover many areas, this tutorial is not exhaustive. This
|
|
project's goals include:
|
|
|
|
* show how to setup your development environment
|
|
* show how to create a new project
|
|
* show how to get your project up and running, i.e. with a database and web app
|
|
* show how to customize and extend your app in various ways, to suit your needs
|
|
* show how to integrate with another system (CORE-POS) in a custom way
|
|
* provide a "working example" of all documented concepts
|
|
|
|
That last one means, you can install and run the rattail-tutorial app yourself,
|
|
and e.g. further customize it to get a feel for Rattail.
|
|
|
|
Please see `https://rattailproject.org/docs/rattail-tutorial/
|
|
<https://rattailproject.org/docs/rattail-tutorial/>`_ for the latest version of
|
|
this document.
|
|
|
|
|
|
Front Matter
|
|
------------
|
|
|
|
It will be helpful to understand a few things before you get started:
|
|
|
|
**Rattail itself is a "library" more than it is an "app".** The idea is that the
|
|
Rattail Project will provide "most" of the base functionality you need from an
|
|
app, but ultimately you must create a project of your own, which "uses" Rattail
|
|
functionality to accomplish *your* goals.
|
|
|
|
**Rattail docs always refer to "your" app with the name "Poser".** In fact this
|
|
tutorial will *not* be using the name "Poser" (much) - but that is usually what
|
|
you will see in all *other* docs, to represent "your" (i.e. any custom) app.
|
|
|
|
**This "rattail-tutorial" project is a proper app.** Following from the
|
|
previous point, this project/app is named "rattail-tutorial" and therefore
|
|
instead of using the name "Poser" within this tutorial, we will be using its
|
|
*actual* name.
|
|
|
|
|
|
Table of Contents
|
|
-----------------
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
setup-dev
|
|
create-project
|
|
start-docs
|
|
configure
|
|
pkg-release
|
|
make-db
|
|
run-webapp
|
|
customize/index
|
|
|
|
|
|
Indices and tables
|
|
==================
|
|
|
|
* :ref:`genindex`
|
|
* :ref:`modindex`
|
|
* :ref:`search`
|