[tryton-debian-vcs] debian.tryton.org branch master updated. e2429873f42198ecd6fd41a18a0ba074440c48ab
Mathias Behrle
tryton-debian-vcs at alioth.debian.org
Sat Apr 11 13:57:07 UTC 2015
The following commit has been merged in the master branch:
https://alioth.debian.org/plugins/scmgit/cgi-bin/gitweb.cgi/?p=tryton/debian.tryton.org.git;a=commitdiff;h=e2429873f42198ecd6fd41a18a0ba074440c48ab
commit e2429873f42198ecd6fd41a18a0ba074440c48ab
Author: Mathias Behrle <mathiasb at m9s.biz>
Date: Sat Apr 11 15:57:02 2015 +0200
Polishing of the documentation.
diff --git a/doc/source/gnuhealth.rst b/doc/source/gnuhealth.rst
index a08310d..a2eb758 100644
--- a/doc/source/gnuhealth.rst
+++ b/doc/source/gnuhealth.rst
@@ -15,20 +15,20 @@ Introduction
* Hospital Information System (HIS)
* Health Information System
-This site provides native distribution packages by `Debian Tryton Maintainers`_, that are available
+This site provides distribution packages by `Debian Tryton Maintainers`_, that are available
for Debian stable, testing and unstable.
With the intent to provide a common installation method the `GNU Health Project`_ provides
-an installation method by bash script (see also the `GNU Health Installation Guide`_). Since this script
-aims to be distribution agnostic, it must use methods that do not integrate well with best practice procedures
-of a Debian system.
+an installation method using a bash script (see also the `GNU Health Installation Guide`_). Since this script
+aims to be distribution agnostic, it uses methods that do not integrate well with best practices
+on Debian systems.
-A short listing of the advantages of using proper Debian packages:
+A short listing of the advantages when using proper Debian packages:
- * Full automatic handling of package dependencies
- * Full integration with apt, the distribution package manager (e.g. automatic update of the GNU Health installation together with system updates)
- * Integration of the daemon start and maintenance (e.g. configuration and start of the daemon provided by the integrated init system)
- * Management of the server with distribution tools
+ * Full automatic handling of package dependencies.
+ * Full integration with apt, the distribution package manager (e.g. automatic update of the GNU Health installation together with system updates).
+ * Integration of the daemon start and maintenance (e.g. configuration and start of the daemon provided by the integrated init system).
+ * Management of the server with distribution tools.
Quick Start
===========
@@ -71,6 +71,11 @@ Now that you know that you have to use Tryton series 3.4, just proceed to instal
the sources.list for Tryton 3.4 as described under :doc:`mirror` and you will automatically
get the appropriate GNU Health modules.
+For the server configuration please refer as usual to /usr/share/doc/tryton-server/README.Debian on your
+Debian system or look at the `latest version of README.Debian in the VCS`_.
+
+.. _latest version of README.Debian in the VCS: https://alioth.debian.org/plugins/scmgit/cgi-bin/gitweb.cgi?p=tryton/tryton-server.git;a=blob_plain;f=debian/tryton-server.README.Debian;hb=HEAD
+
.. note:: Packaging by Debian Tryton Maintainers has started from
GNU Health series 2.8.
@@ -81,7 +86,7 @@ The Health modules
GNU Health modules are individually packaged and installable in the style of all
Tryton modules in Debian to provide the modularity of the framework on installation level.
-For ease of installation there are special modules available providing common setups.
+For ease of installation there are special modules available providing common setups:
For installing the GNU Health base profile (incl. server)
diff --git a/doc/source/mirror.rst b/doc/source/mirror.rst
index 80c7f7a..6dbcb9a 100644
--- a/doc/source/mirror.rst
+++ b/doc/source/mirror.rst
@@ -13,25 +13,29 @@ Due to the different release schemata and policies of Tryton and Debian it is
currently impossible to make all Tryton releases available for the different
Debian suites in the main repository of Debian.
-We try to make Tryton releases including their bug fix releases available via this aptable
-package mirror on debian.tryton.org. So you can run the Tryton release of your choice
-on your current stable or testing Debian system
+Out intention is to make available Tryton releases including their bug fix releases
+via this aptable package mirror on debian.tryton.org.
-* without the need to upgrade immediately to the next Tryton major as soon as it enters Debian main.
-* providing the ability to upgrade to the next Tryton series as soon as `you` decide to do so.
+Using this mirror
-Note:
-Those packages are maintained by the Debian Tryton Maintainers, but nevertheless they
-are unofficial and you are using them at your own risk (as always).
+* you can run the Tryton release of your choice on your current stable or testing Debian system.
+* you are able to upgrade to the next Tryton series as soon as `you` wish to do so.
+* you are independent from the next Tryton major entering in Debian main.
+* you get all bug fix releases for all supported Tryton series.
+
+.. note: Those packages are maintained by the `Debian Tryton Maintainers`_, but nevertheless they
+ are unofficial and you are using them at your own risk (as always).
+
+.. _Debian Tryton Maintainers: https://qa.debian.org/developer.php?login=maintainers%40debian.tryton.org
Scope
=====
The scope provided by Debian Tryton Maintainers is
-* released series of the `Tryton Project`_
-* some additional dependencies needed by the Tryton packages
-* released series of the `GNU Health Project`_
+* Released series of the `Tryton Project`_.
+* Some additional dependencies needed by the Tryton packages.
+* Released series of the `GNU Health Project`_.
.. _Tryton Project: http://www.tryton.org/
.. _GNU Health Project: http://health.gnu.org/
@@ -48,17 +52,21 @@ them. You will also find instructions below on how to do that.
For the installation of GNU Health you find additional instructions at :doc:`gnuhealth`.
+For the server configuration please refer to /usr/share/doc/tryton-server/README.Debian on your
+Debian system or look at the `latest version of README.Debian in the VCS`_.
+
+.. _latest version of README.Debian in the VCS: https://alioth.debian.org/plugins/scmgit/cgi-bin/gitweb.cgi?p=tryton/tryton-server.git;a=blob_plain;f=debian/tryton-server.README.Debian;hb=HEAD
Distributions
=============
Naming convention for distributions is <Debian-Release>-<Tryton-Version>
-e.g. wheezy-2.2, wheezy-2.6, etc.
+e.g. wheezy-2.2, jessie-3.4
Packages suitable for testing and unstable are available under the distribution <Debian-Future-Release>-<Tryton-Version>
-e.g. at the time of writing jessie-2.6, jessie-2.8, jessie-3.0 jessie-3.2 etc.
+e.g. at the time of writing stretch-3.6
The available distributions can be found at `Debian Tryton Distributions`_.
@@ -85,7 +93,7 @@ Adding the sources to apt basically works like
Ready-to-use
------------
-There are ready-to-use source list files. They can be downloaded and saved directly to /etc/apt/sources.list.d with
+The following list are ready-to-use source list files. They can be downloaded and saved directly to /etc/apt/sources.list.d with
*Distribution wheezy-2.2*
commit 614a7570f76635952fb1922e41818da1c197fdbb
Author: Mathias Behrle <mathiasb at m9s.biz>
Date: Sat Apr 11 15:18:31 2015 +0200
Using sphinx_rtd_theme.
diff --git a/doc/source/conf.py b/doc/source/conf.py
index df3884f..36a7a07 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -91,7 +91,9 @@ pygments_style = 'sphinx'
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
-html_theme = 'default'
+#html_theme = 'default'
+html_theme = "sphinx_rtd_theme"
+html_theme_path = ["_themes", ]
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
commit 1a9b7081fee4489485515415761512cb37a4551b
Author: Mathias Behrle <mathiasb at m9s.biz>
Date: Sat Apr 11 14:34:56 2015 +0200
Making list links clickable.
diff --git a/doc/source/mailinglists.rst b/doc/source/mailinglists.rst
index a8eac6c..354245a 100644
--- a/doc/source/mailinglists.rst
+++ b/doc/source/mailinglists.rst
@@ -13,11 +13,11 @@ To read the archives or to subscribe follow the links on the Overview Page.
Overview
========
-::
-
- http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/tryton-debian
-
- http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/tryton-debian-vcs
+ `Tryton Debian`_ (Conversation of all kind for Debian Tryton Maintainers)
+
+ `Tryton Debian VCS`_ (Commit messages on Debian Tryton repsoitories)
+.. _Tryton Debian: http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/tryton-debian
+.. _Tryton Debian VCS: http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/tryton-debian-vcs
commit 829205226498a8132dc8bbbb6b77960adb06eae4
Author: Mathias Behrle <mathiasb at m9s.biz>
Date: Sat Apr 11 14:28:39 2015 +0200
Improving GNU Health documentation to explain better the Debian way.
diff --git a/doc/source/gnuhealth.rst b/doc/source/gnuhealth.rst
index f5db527..a08310d 100644
--- a/doc/source/gnuhealth.rst
+++ b/doc/source/gnuhealth.rst
@@ -6,18 +6,50 @@
GNU Health Debian Apt Repository
================================
-What is different?
-==================
+Introduction
+============
-Not much;)
+`GNU Health`_ is a Free Health and Hospital Information System that provides the following functionalities:
-GNU Health modules are technically just another set of Tryton modules. The
+ * Electronic Medical Record (EMR)
+ * Hospital Information System (HIS)
+ * Health Information System
+
+This site provides native distribution packages by `Debian Tryton Maintainers`_, that are available
+for Debian stable, testing and unstable.
+
+With the intent to provide a common installation method the `GNU Health Project`_ provides
+an installation method by bash script (see also the `GNU Health Installation Guide`_). Since this script
+aims to be distribution agnostic, it must use methods that do not integrate well with best practice procedures
+of a Debian system.
+
+A short listing of the advantages of using proper Debian packages:
+
+ * Full automatic handling of package dependencies
+ * Full integration with apt, the distribution package manager (e.g. automatic update of the GNU Health installation together with system updates)
+ * Integration of the daemon start and maintenance (e.g. configuration and start of the daemon provided by the integrated init system)
+ * Management of the server with distribution tools
+
+Quick Start
+===========
+
+For the quick and impatient there exists a `Docker Setup for GNU Health Demoserver`_, that allows one to get up and running easily
+a ready-to-use GNU Health Demo server based on Debian packages (see below).
+
+
+What is different from Tryton core modules?
+===========================================
+
+Only the numbering schema. GNU Health modules are technically just another set of Tryton modules. The
only difference to bear in mind is that the `GNU Health Project`_ uses a different
-numbering schema from the `Tryton`_ series they use. So you have to gather just
+numbering schema compared to the targeted `Tryton`_ series. So you have to gather just
the correct Tryton series to match the GNU Health modules you want to use.
.. _Tryton: http://www.tryton.org/
.. _GNU Health Project: http://health.gnu.org/
+.. _GNU Health: https://en.wikipedia.org/wiki/GNU_Health
+.. _GNU Health Installation Guide: https://en.wikibooks.org/wiki/GNU_Health/Installation
+.. _Debian Tryton Maintainers: http://debian.tryton.org
Tryton series to GNU Health series
==================================
@@ -31,37 +63,38 @@ GNU Health Series Tryton Series
2.8 3.4
================= =============
-.. note:: Packaging by Debian Tryton Maintainers has started with
- GNU Health series 2.8.
-
Example:
If you want to install GNU Health 2.8, use the Tryton series 3.4.
Now that you know that you have to use Tryton series 3.4, just proceed to install
-the sources.list for Tryton 3.4 as described under :doc:`mirror`.
+the sources.list for Tryton 3.4 as described under :doc:`mirror` and you will automatically
+get the appropriate GNU Health modules.
+
+.. note:: Packaging by Debian Tryton Maintainers has started from
+ GNU Health series 2.8.
-Health modules
---------------
+The Health modules
+------------------
-GNU Health modules are separately packaged and installable in the style of all
+GNU Health modules are individually packaged and installable in the style of all
Tryton modules in Debian to provide the modularity of the framework on installation level.
For ease of installation there are special modules available providing common setups.
-Installing the gnuhealth base profile (incl. server)
+For installing the GNU Health base profile (incl. server)
::
- # apt-get install tryton-modules-health-profile [-t <distribution>]
+ # apt-get install tryton-modules-health-profile
-Installing all health modules (incl. server) (e.g. for testing)
+For installing all GNU Health modules at once (incl. server, e.g. for testing)
::
- # apt-get install tryton-modules-health-all [-t <distribution>]
+ # apt-get install tryton-modules-health-all
@@ -76,12 +109,12 @@ GNU Health Demoserver using the same database that is used in the `GNU Health On
Instructions for the usage of this docker setup can be found at
- `Docker Setup for GNUHealth Demoserver`_
+ `Docker Setup for GNU Health Demoserver`_
`Run GNU Health from Docker (Lightweight Containers)`_
-.. _Docker Setup for GNUHealth Demoserver: https://github.com/mbehrle/docker-gnuhealth-demo
+.. _Docker Setup for GNU Health Demoserver: https://github.com/mbehrle/docker-gnuhealth-demo
.. _Run GNU Health from Docker (Lightweight Containers): https://en.wikibooks.org/wiki/GNU_Health/Different_ways_to_test_GNU_Health#Option_4:_Run_GNU_Health_from_Docker_.28Lightweight_Containers.29
--
debian.tryton.org
More information about the tryton-debian-vcs
mailing list