]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/index.rst
Merge branch 'master' of git.debian.org:/git/pkg-exppsy/neurodebian
[neurodebian.git] / sphinx / index.rst
index e87a3cedb127c28b548e9198e53711b97a4a9024..2c788fe03cf716177e308cf55362da7ebe07097c 100644 (file)
@@ -1,27 +1,29 @@
 .. _WELCOme:
 
-***********************************************
- Welcome to the Debian Neuroscience Repository
-***********************************************
+***************************************************
+ Welcome to the Ultimate Platform for Neuroscience
+***************************************************
 
 .. 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_
-archive, as well as backported or simply rebuilt packages also available
-elsewhere. Please see the :ref:`faq` for more information about the goals of
-this project, and :ref:`read what people say about it <testimonials>`.
-Take a look at the :ref:`list of our current and planned projects <projects>` if
-you want to get involved. If you appreciate this service, please |spread|.
-
-.. note::
-
-  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 <#contacts>`_ them.
-
+The NeuroDebian project provides a turnkey platform for neuroscience
+through integrating of related software within the Debian_ operating
+system.  If you are using neuroscience-related software which
+comes with you installation of Debian_ or its derivative, such as
+Ubuntu_, good chance is that you are already *using NeuroDebian*.
+
+This website provides an additional repository with both unofficial
+or prospective packages which are not (yet) available from the main
+Debian_ archive, as well as backported or simply rebuilt newest
+versions of packages.  Please see the :ref:`faq` for more information
+about the goals of this project, and :ref:`read what people say about
+it <testimonials>`.  Take a look at the :ref:`list of our current and
+planned projects <projects>` if you want to get involved. If you
+appreciate this service, please |spread|.
+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 <#contacts>`_ them.
 
 .. raw:: html
 
@@ -31,7 +33,7 @@ you want to get involved. If you appreciate this service, please |spread|.
  <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>
  <a href="projects.html"><img border="0" src="_static/workarea.png" title="Current and planned projects: Get involved!" /></a>
- <a href="feeds/blog.xml"><img border="0" src="_static/rssfeeds.png" title="NeuroDebian Insider feed" /></a>
+ <a href="blog/index.html"><img border="0" src="_static/rssfeeds.png" title="NeuroDebian Insider Blog" /></a>
  </p>
 
 .. _Ubuntu: http://www.ubuntu.com
@@ -53,8 +55,9 @@ News
                                     rate: 300000});
  </script>
 
-Older news items are available on identi.ca_. Follow us on identi.ca_
-(preferred) or twitter_ to subscribe to the NeuroDebian news.
+For more news and information see our :ref:`blog <blog>`. Older news items are
+available on identi.ca_. Follow us on identi.ca_ (preferred) or twitter_ to
+subscribe to the NeuroDebian news.
 
 .. _identi.ca: http://identi.ca/neurodebian
 .. _twitter: http://twitter.com/NeuroDebian
@@ -74,14 +77,11 @@ with the NeuroDebian repository key and package source information.
 
 .. include:: sources_lists
 
-Once this is done, you have to update the package index. Use your favorite
-package manager, e.g. synaptic, adept. In the terminal you can use
-:command:`apt-get` to achieve this::
+Once this is done, you have to update the package index and you are ready to
+install packages. Use your favorite package manager, e.g. synaptic, adept. In
+the terminal you can use :command:`apt-get`::
 
   sudo apt-get update
-
-Now, you can install packages, e.g.::
-
   sudo apt-get install mricron
 
 .. note::
@@ -90,6 +90,38 @@ Now, you can install packages, e.g.::
   about which package version is available for which release and architecture,
   please have a look at the corresponding package pages.
 
+.. raw:: html
+
+ <p><img border="0" src="_files/nd_subscriptionstats.png" title="Statistics of new repository subscriptions for all supported releases. Note: subscription is only done once per machine." /></p>
+
+Popularity Contest
+------------------
+
+We encourage you to participate in the `popularity
+contest <http://popcon.debian.org>`_ (popcon), which anonymously
+collects the list of packages you installed/use on your system.
+Collecting such statistics is of particular importance for research
+software projects as a prove of an existing user-base.  If upon
+installation of the system you rejected the invitation to participate
+you can always change your decision by running::
+
+ sudo dpkg-reconfigure popularity-contest
+
+.. note::
+
+   If you are deploying multiple systems through cloning, to not have
+   all systems considered as one, it would be necessary to re-generate
+   the random MY_HOSTID.  Following commands ran as root should do it
+   (as root) without any interactive dialog::
+
+    sed -i -e 's,PARTICIPATE *= *.no.,PARTICIPATE="yes",g' -e '/^ *MY_HOSTID/d' /etc/popularity-contest.conf
+    DEBIAN_FRONTEND=noninteractive dpkg-reconfigure popularity-contest
+
+In addition to popcon pages for your "core" distribution (e.g. `Debian
+<http://popcon.debian.org/>`__ or `Ubuntu
+<http://popcon.ubuntu.com/>`__) you can see/get statistics for
+submissions to `NeuroDebian <http://neuro.debian.net/popcon/>`__ and
+know that you are already contributing back to the community.
 
 .. _chap_installation:
 
@@ -162,6 +194,8 @@ communication channels within the NeuroDebian community
 * neurodebian-devel_: Technical mailing list for discussions on
   NeuroDebian development
 
+You are welcome also to join #neurodebian IRC room on OFTC network if
+you have quick questions or want to join a live discussion.
 
 Acknowledgements
 ================
@@ -181,6 +215,9 @@ Thanks to the following institutions and individuals for hosting a mirror:
 * `Paul Ivanov`_ *[us-ca]*
 * `Medical-image Analysis and Statistical Interpretation lab at Vanderbilt`_
   *[us-tn]*
+* `Australia's research and education network (AARNET)
+  <http://www.aarnet.edu.au>`_ *[au]*
+* Kiyotaka Nemoto (AKA Mr. Lin4Neuro_) *[jp]*
 
 If your are interested in mirroring the repository, please see the :ref:`faq`.
 
@@ -194,13 +231,49 @@ If your are interested in mirroring the repository, please see the :ref:`faq`.
 Publications
 ============
 
+Halchenko, Y.O. & Hanke, M. (2012). `Environments for efficient
+contemporary research in neuroimaging: PyMVPA and NeuroDebian
+<_files/HalchenkoHanke_ContemporaryNeuroimaging_PENN2012.pdf>`_.
+*Talk given at the University of Pennsylvania School of Medicine*,
+Philadelphia, PA, USA.
+
+Hanke, M. (2012). `Rock solid, brand new, everyday, for free, not a joke:
+NeuroDebian <_files/Hanke_NeuroDebian_MPI2012.pdf>`_.
+*Talk given at the Max-Planck-Institute for Human Cognitive and Brain
+Sciences*, Leipzig, Germany.
+
+Hanke, M. (2011). `More than batteries included: NeuroDebian
+<_files/Hanke_NeuroDebian_EuroSciPy2011.pdf>`_.
+*Talk given at the Python in Neuroscience satellite of EuroScipy 2011*,
+Paris, France.
+
+Halchenko, Y. O. (2011). `π's in Debian or Scientific Debian: NumPy, SciPy and beyond
+<_files/Halchenko_EuroScipy11_3_14s_in_Debian.pdf>`_.
+*Talk given at* `EuroScipy 2011 <http://www.euroscipy.org/talk/4379>`_,
+Paris, France.
+
+Hanke, M. & Halchenko, Y. O. (2011). `Neuroscience runs on GNU/Linux
+<http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2011.00008/full>`_.
+*Frontiers in Neuroinformatics, 5:8*.
+
+Hanke, M., Halchenko, Y. O. & Haxby, J. V. (2011). `NeuroDebian -- versatile
+platform for brain-imaging research <_files/NeuroDebian_HBM2011.png>`_
+*Poster presented at the annual meeting of the Organisation for Human Brain
+Mapping*, Quebec City, Canada.
+
+Hanke, M. (2011). `Integrating Condor into the Debian operating system
+<_files/Hanke_CondorDebianIntegration_CondorWeek2011.pdf>`_.
+*Talk given at* `CondorWeek 2011
+<http://www.cs.wisc.edu/condor/CondorWeek2011/wednesday_condor.html>`_,
+Madison, Wisconsin, USA.
+
 Hanke, M. & Halchenko, Y. O. (2010). :ref:`Report from the Debian booth at
 SfN2010 <chap_debian_booth_sfn2010>`. *Annual meeting of the Society for
 Neuroscience*, San Diego, USA.
 
 Halchenko, Y. O., Hanke, M., Haxby, J. V., Pollmann, S. & Raizada, R. D.
 (2010). `Having trouble getting your Nature paper? Maybe you are not using the
-right tools? <_files/NeuroDebian_SfN2010.png>`_ *Poster to be presented at the
+right tools? <_files/NeuroDebian_SfN2010.png>`_ *Poster presented at the
 annual meeting of the Society for Neuroscience*, San Diego, USA.
 
 Hanke, M., Halchenko, Y. O. (2010). `Debian: The ultimate platform for
@@ -227,6 +300,7 @@ efficient, more open, and more fun
 .. toctree::
    :hidden:
 
+   blog/index
    faq
    pkgs
    spread