annotate Sphinx/source/plugins.rst @ 40:99b45a963bcf

contributing
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 19 Aug 2016 08:59:32 +0200
parents 2ee7f4462a6a
children a52f1dc48ebc
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 .. _plugins:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 Plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 =======
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
6 .. contents::
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
7
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
8 Overview
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
9 --------
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
10
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 The core of Orthanc can be extended through **plugins**. A plugin
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 takes the form of a shared library (``.DLL`` under Windows, ``.so``
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13 under Linux, ``.dylib`` under Apple OS X...). A plugin can do various
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 things, among others:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 * Serving new **Web applications** that have full access to the REST
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17 API of Orthanc, which makes easy to handle DICOM images from
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 JavaScript code.
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19 * Replacing **the way DICOM images are decoded** (e.g. the official
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20 :ref:`Web viewer plugin <webviewer>` introduces the decoding of
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21 JPEG2000 images, which is not available in the core of Orthanc).
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
22 * Replacing the default **database back-end** of Orthanc (that is built
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
23 upon SQLite) by another (:ref:`PostgreSQL <postgresql>`, MySQL, SQL Server...).
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
24 * Creating **new REST APIs** on the top of the Orthanc built-in API (as in
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
25 in the official :ref:`DICOMweb <dicomweb>` plugin).
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
26 * **Reacting** to the arrival of new DICOM images or other
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
27 DICOM-related events so as to carry on automated processing.
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
28 * ...
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
29
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
30 Developers external to the official Orthanc project are :ref:`invited
38
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
31 to contribute <contributing>` to the C/C++ part of Orthanc by creating
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
32 third-party plugins. A specific section of the Orthanc Book explains
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
33 :ref:`how to create new Orthanc plugins <creating-plugins>`.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35 .. _plugins-official:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 Index of the official plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 -----------------------------
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40 .. toctree::
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
41 :maxdepth: 1
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42
31
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
43 plugins/webviewer.rst
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
44 plugins/dicomweb.rst
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
45 plugins/postgresql.rst
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
46 plugins/worklists-plugin.rst
31
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
47 plugins/serve-folders.rst
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
48
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
49
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
50 .. _plugins-contributed:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
51
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
52 Index of the contributed plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
53 --------------------------------
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
54
31
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
55 * `Osimis <http://osimis.io/>`__ maintains an evolution of the
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
56 official Web viewer plugin. The Osimis plugin adds tools for
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
57 measuring, for viewing multiple series, and for split-pane. `Check
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
58 out their source code
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
59 <https://bitbucket.org/osimis/osimis-webviewer-plugin>`__.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
60 * `DWV Orthanc Plugin
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
61 <https://github.com/ivmartel/dwv-orthanc-plugin>`__: This plugin by
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
62 Yves Martelli is based on `dwv
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
63 <https://github.com/ivmartel/dwv/wiki>`__ and extends Orthanc with a
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
64 Web viewer of DICOM images.
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
65 * Another Web viewer is provided courtesy of `Emsy Chan
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
66 <https://groups.google.com/d/msg/orthanc-users/EC5Z2KaM4Hs/MG3KkzhCDAAJ>`__.
40
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
67 * Check out the `OrthancContributed repository on GitHub
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
68 <https://github.com/jodogne/OrthancContributed/tree/master/Plugins>`__, that
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
69 might contain plugins that are not tracked in this list.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
70
38
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
71 *Remark:* Do not hesitate to `contact us
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
72 <http://www.orthanc-server.com/static.php?page=contact>`__ if you have
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
73 developed a plugin so that we can include it in the list above!