]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/index.rst
Merge remote branch 'alioth/master'
[neurodebian.git] / sphinx / index.rst
index 8a023ee532f120435245f2519de260514f23efbc..9c1b564e5767ecdc64a6623ef1fd3a398b57a47b 100644 (file)
@@ -1,9 +1,12 @@
-.. _welcome:
+.. _WELCOme:
 
 ***********************************************
  Welcome to the Debian Neuroscience Repository
 ***********************************************
 
+.. quotes::
+   :random: 1
+
 This repository provides mostly neuroscience-related packages to be used on
 Debian_ systems (or Debian-derivatives like Ubuntu_). It contains both unofficial
 or prospective packages which are not (yet) available from the main Debian_
@@ -13,14 +16,15 @@ this project.
 
 This service is provided "as is". There is no guarantee that a package
 works as expected, so use them at your own risk. If you encounter problems,
-please `report <#contact>`_ them.
+please `report <#contacts>`_ them.
 
 Please |spread|, if you like it.
 
 .. raw:: html
 
  <p>
- <a href="pkgs.html"><img border="0" src="_static/package.png" title="List of available packages" /></a>
+ <a href="pkgs.html"><img border="0" src="_static/package.png" title="Software package list" /></a>
+ <a href="datasets.html"><img border="0" src="_static/datasets.png" title="Dataset package list" /></a>
  <a href="vm.html"><img border="0" src="_static/machine.png" title="Get NeuroDebian for your non-Debian computer" /></a>
  <a href="debian/pool"><img border="0" src="_static/pool.png" title="Go to the package pool (deep and cold, only for experts)" /></a>
  </p>
@@ -37,7 +41,7 @@ News
  new TWTR.Widget({
    version: 2,
    type: 'profile',
-   rpp: 10,
+   rpp: 15,
    interval: 6000,
    width: 'auto',
    height: 150,
@@ -88,14 +92,24 @@ releases and repository mirrors:
 .. include:: sources_lists
 
 .. note::
-  Thanks to the `Department of Experimental Psychology at the University of
-  Magdeburg`_, and the `Department of Psychological and Brain Sciences at Dartmouth
-  College`_ for hosting a mirror.
+  Thanks to the following institutions and individuals for hosting a mirror:
+
+  * `Department of Psychological and Brain Sciences at Dartmouth College`_
+    *[us-nh]* (primary mirror)
+  * `Department of Experimental Psychology at the University of Magdeburg`_
+    *[de]*
+  * `Neurobot at Aristotle University of Thessaloniki, Greece`_ *[gr]*
+  * `Paul Ivanov`_ *[us-ca]*
+  * `Medical-image Analysis and Statistical Interpretation lab at Vanderbilt`_
+    *[us-tn]*
 
   If your are interested in mirroring the repository, please see the :ref:`faq`.
 
-.. _Department of Experimental Psychology at the University of Magdeburg: http://apsy.gse.uni-magdeburg.de
 .. _Department of Psychological and Brain Sciences at Dartmouth College: http://www.dartmouth.edu/~psych
+.. _Department of Experimental Psychology at the University of Magdeburg: http://apsy.gse.uni-magdeburg.de
+.. _Neurobot at Aristotle University of Thessaloniki, Greece: http://neurobot.bio.auth.gr
+.. _Paul Ivanov: http://www.pirsquared.org
+.. _Medical-image Analysis and Statistical Interpretation lab at Vanderbilt: https://masi.vuse.vanderbilt.edu
 
 Once this is done, you have to update the package index. Use your favorite
 package manager, e.g. synaptic, adept, or whatever you like. In the terminal
@@ -112,45 +126,21 @@ Now, you can proceed to install packages, e.g.::
   about which package version is available for which release and architecture,
   please have a look at the corresponding package pages.
 
-
-Package authentication
-----------------------
-
-When you start using this repository, you probably get warning messages
-like this::
-
-  The following signatures couldn't be verified because 
-  the public key is not available.`
-
-Or you will be asked questions like this over and over::
-
-  WARNING: The following packages cannot be authenticated!
-  ...
-  Install these packages without verification [y/N]?
-
-This is because your APT installation initially does not know the GPG
-key that is used to sign the release files of this repository. It is easy to
-make APT happy again:
-
-1. Get the key. Either download the `repository key from here
-   <_static/neuro.debian.net.asc>`_
-   or fetch it from http://wwwkeys.pgp.net (2649A5A9).
-
-2. Now feed the key into APT by invoking::
-
-     apt-key add #file#
-
-   Where `#file#` has to be replaced with the location of the key file you just
-   downloaded. You need to have superuser-privileges to do this (either do it
-   as root or use sudo).
+After this initial setup you probably also want to configure your package
+manager to recognize the NeuroDebian archive key. With this key the package
+manager can verify that packages haven't been modified and are identical with
+the ones in the main NeuroDebian archive, regardless of which mirror you
+downloaded them from. The NeuroDebian key id is **2649A5A9**. If you need further
+help setting up package authentication, please take a look at
+:ref:`corresponding FAQ <sec_pkg_authentication>`.
 
 
 .. _chap_installation:
 
-Installation
-============
+Ways to use NeuroDebian
+=======================
 
-Virtual Machine
+Virtual machine
 ---------------
 
 If you are not running Debian_ on a particular machine a :ref:`chap_vm` is
@@ -163,8 +153,8 @@ purpose of teaching a neuroimaging data analysis course in a multipurpose
 computer lab.
 
 
-Debian
-------
+Debian installation
+-------------------
 
 Having been exposed to the wonders of NeuroDebian_ you are no longer
 satisfied with your previous choice of operating system?  We would
@@ -177,7 +167,7 @@ hardware architecture and then simply add |repos|.
 .. _chap_team:
 
 
-The Team
+The team
 ========
 
 Our main goal is to provide neuroscience FOSS_ for Debian_. Thus the
@@ -199,11 +189,35 @@ for all their work.
 .. _FOSS: http://en.wikipedia.org/wiki/Free_and_open_source_software
 
 
-Contact
-=======
+Contacts
+========
+
+`Email us directly <team@neuro.debian.net>`_ with any "private"
+communication.  Otherwise please use our public mailing lists, which
+exist not only to provide user-support but also to establish
+communication channels within the NeuroDebian community
+
+* neurodebian-users_: Discussions and support of NeuroDebian users
+
+* neurodebian-upstream_: General discussions and knowledge sharing
+  among developers of the neuroscience software.  We will also use it
+  to update you with summaries of recent relevant developments in
+  Debian project
+
+* neurodebian-devel_: Technical mailing list for discussions on
+  NeuroDebian development
+
+.. _neurodebian-users: http://lists.alioth.debian.org/mailman/listinfo/neurodebian-users
+.. _neurodebian-devel: http://lists.alioth.debian.org/mailman/listinfo/neurodebian-devel
+.. _neurodebian-upstream: http://lists.alioth.debian.org/mailman/listinfo/neurodebian-upstream
+
+
+Acknowledgements
+================
+
+We are grateful to Jim Haxby for his continued support and :ref:`endless supply of
+Italian espresso <coffeeart>`.
 
-`Email us <team@neuro.debian.net>`_ if you have any suggestions or want to
-report a problem.
 
 .. toctree::
    :hidden:
@@ -212,8 +226,8 @@ report a problem.
    pkgs
    spread
    vm
-   links_names
-   substitutions
+   coffeeart
+   testimonials
 
 .. probably should be purged altogether
 .. toctree::
@@ -222,6 +236,10 @@ report a problem.
    livecd
    gpg
    setup
+   links_names
+   substitutions
+   quotes-nihr01
+   quotes-nitrc
 
 .. include:: links_names.rst
 .. include:: substitutions.rst