X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=sphinx%2Findex.rst;h=f9973f845a665a0c9295457baad3e933856e8ea7;hb=c9e4cba0769efda1c15d2526e48b59109bb8fe2f;hp=f61cf245ca21cb10d15d23d6b2cf7b2f9dfe954d;hpb=89098526462e1c82c831e7c599b0a7fe33bc69cf;p=neurodebian.git diff --git a/sphinx/index.rst b/sphinx/index.rst index f61cf24..f9973f8 100644 --- a/sphinx/index.rst +++ b/sphinx/index.rst @@ -1,33 +1,32 @@ -.. _welcome: +.. _WELCOme: *********************************************** Welcome to the Debian Neuroscience Repository *********************************************** 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 backported or simply rebuilt packages also available +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. This service is provided "as is". There is no guarantee that a package -works as expected, so use them at your own risk. They might kill your -system (although that is rather unlikely). You've been warned! +works as expected, so use them at your own risk. If you encounter problems, +please `report <#contacts>`_ them. -The repository contains both neuroscience-related packages, as well as general -purpose software which is necessary to resolve dependencies, or such that is -simply useful in the neuroscience context. All featured neuroscience software -packages are available from the :ref:`full package list `. +Please |spread|, if you like it. .. raw:: html

- + +

+.. _Ubuntu: http://www.ubuntu.com News ==== @@ -39,7 +38,7 @@ News new TWTR.Widget({ version: 2, type: 'profile', - rpp: 10, + rpp: 15, interval: 6000, width: 'auto', height: 150, @@ -90,14 +89,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 @@ -114,56 +123,35 @@ 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. Making -APT happy again is easy: - -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 `. .. _chap_installation: -Installation -============ +Ways to use NeuroDebian +======================= -Virtual Machine +Virtual machine --------------- -If your are not running Debian_ on a particular machine a :ref:`chap_vm` is -provided as a convenient testing and evaluation environment. After a -few simple steps to setup the virtual machine, you will be able to use -NeuroDebian_ as an integral part of your existing working -environment without any sacrifice. +If you are not running Debian_ on a particular machine a :ref:`chap_vm` is +provided as a convenient testing and evaluation environment. After a few +simple steps to setup the virtual machine, you will be able to use NeuroDebian_ +as an integral part of your existing working environment without any sacrifice. +The virtual machine is also a suitable environment to temporarily deploy +neuroscience software on machines running other operating systems, e.g. for the +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 @@ -176,13 +164,13 @@ 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 +Our main goal is to provide neuroscience FOSS_ for Debian_. Thus the whole project would not be possible without the work of over 3,000 Debian_ developers and contributors who are as enthusiastically pursuing -a similar goal. To add our share -- Debian_ packages of FOSS for +a similar goal. To add our share -- Debian_ packages of FOSS_ for neuroscience research -- the `Experimental Psychology Debian packaging project `_ was created to formally join the forces of @@ -190,17 +178,43 @@ to formally join the forces of * `Michael Hanke `_ * `Yaroslav Halchenko `_ -A number of packages that are now provided within the NeuroDebian repository +A number of packages that are now available from the NeuroDebian repository were not packaged by our team, but similar Debian teams. Therefore we want to -express particular gratitude to `Debian Med`_ and `Debian Science`_ teams for -all their work. +express particular gratitude to the `Debian Med`_ and `Debian Science`_ teams +for all their work. +.. _FOSS: http://en.wikipedia.org/wiki/Free_and_open_source_software -Contact -======= -`Email us `_ if you have any suggestions or -simply |spread| if you liked it. +Contacts +======== + +`Email us directly `_ 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 `. + .. toctree:: :hidden: @@ -209,8 +223,7 @@ simply |spread| if you liked it. pkgs spread vm - links_names - substitutions + coffeeart .. probably should be purged altogether .. toctree:: @@ -219,6 +232,8 @@ simply |spread| if you liked it. livecd gpg setup + links_names + substitutions .. include:: links_names.rst .. include:: substitutions.rst