X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=artwork%2Fbrochure%2Fbrochure_debian-neurodebian.tex;h=f216c088286f5d6d7c32278283e2b24a91a8ccbe;hb=32e54536a05e8ecf42b0268a6df6e6f2985b1b3a;hp=765821dd59928143376188ceb4e6ef7deaced5d7;hpb=b3bc4dd0986ba4abf5f53fccbbe50836375039ba;p=neurodebian.git

diff --git a/artwork/brochure/brochure_debian-neurodebian.tex b/artwork/brochure/brochure_debian-neurodebian.tex
index 765821d..f216c08 100644
--- a/artwork/brochure/brochure_debian-neurodebian.tex
+++ b/artwork/brochure/brochure_debian-neurodebian.tex
@@ -6,6 +6,10 @@
 \usepackage[landscape,margin=0.5cm]{geometry}
 \usepackage{color}
 \usepackage{flowfram}
+%\usepackage{booktabs}           % for rules in tables
+\usepackage{tabularx}           % for column-width tables
+\usepackage[table]{xcolor}      % color control
+
 \usepackage[colorlinks]{hyperref}
 
 \usepackage{multicol}
@@ -18,8 +22,47 @@
 }
 
 \usepackage{enumitem}           % useful for control of listings
+\usepackage[compact,raggedright]{titlesec}
+\usepackage{comment}
+
+\newcommand{\epigraph}[3]{\textit{#1}\linebreak \vspace{-1.5em} \begin{flushright}\hspace{5em}\ --\ #2\linebreak\small{#3} \end{flushright}}
 
 \pagestyle{empty}
+\parindent=0pt
+
+% Attempts to change bg color of *section headings
+%\definecolor{secbgcol}{rgb}{0.9, 0.85, 0.85}
+%\titleformat{\section}
+%{\color{red}\normalfont\Large\bfseries}{\ndsection}{1em}{}
+%\titleformat{\subsection}
+%{\color{red}\normalfont\large\bfseries}{\begin{flushright}\hfill\thesubsection
+%  \end{flushright}}{1em}{}
+%
+%\usepackage{pstricks}
+
+% To create tables within multicols
+\makeatletter
+\newenvironment{ndtable}
+  {\def\@captype{table}}
+  {}
+
+
+\newcommand{\ndheading}[3]{%
+\vspace{0.5em}
+\begin{ndtable}%
+\rowcolors[\hline]{1}{#2}{} \arrayrulecolor{#3}
+\begin{tabularx}{\columnwidth}{>{\centering\arraybackslash}X}\vspace{-.5em}\normalfont\large\bfseries
+  #1\\\end{tabularx}
+\end{ndtable}
+\vspace{-.5em}
+}
+
+\definecolor{secfgcol}{RGB}{215, 6, 83}
+\definecolor{secbgcol}{RGB}{255, 241, 248}
+\newcommand{\ndsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
+\newcommand{\ndsubsection}[1]{\ndheading{#1}{secbgcol}{secfgcol}}
+
+
 \begin{document}
 
 %%
@@ -27,27 +70,304 @@
 %%
 \begin{multicols}{3}    % 3 columns
 
+\section*{The Universal Operating System}
 \begin{center}
 \noindent
 \includegraphics[width=0.5\columnwidth]{openlogo}
+%\includegraphics[width=0.5\columnwidth]{openlogo-vsop}
 
 \url{http://www.debian.org}
-\section*{Debian GNU/Linux}
-\subsection*{The Universal Operating System}
+%\ndsection{Debian GNU/Linux}
+
+% \hrule
 \end{center}
+\vspace{-1em}
+
+\ndsection{Debian}
+
+was founded by Ian Murdock in August 1993 with the goal
+to create an easy-to-install and maintain non-commercial GNU/Linux
+operating system that would be able to compete in the
+commercial market.  Since then Debian established itself as an
+independent and unique project driven by more than 3000
+enthusiastic contributors all around the globe.
+Principles of \emph{do-ocracy} and democracy backed up by evolving transparent
+standards allowed Debian to deliver the most comprehensive operating system -- not
+only by amount of integrated software, but also by
+number of the supported hardware architectures.
+% Current installer of Debian has been translated more that to 60 languages.
+% (12 ???  officially supported architectures).
+% Well appreciated
+The high quality and openness of Debian made it the foundation of choice for
+more than 120 derivative GNU/Linux distributions, such as Ubuntu and
+Mint.
+
+\ndsubsection{Debian is}
+\begin{description}[nolistsep,leftmargin=0.8em]
+\item[V\textnormal{ersatile}]\hfill\url{http://packages.debian.org}\\
+  Over 15000 software packages maintained by experts to provide
+  a stable system for \textit{any} field of application.
+\item[S\textnormal{ecure}]\hfill\url{http://www.debian.org/security}\\
+  Security updates guarantee safe operation.
+%\item[S]table
+% \item[S\textnormal{imple}]\blank\\
+%   Single command is enough to install or upgrade single
+%   software or the entire system at once
+\item[O\textnormal{pen}]\hfill\url{http://www.debian.org/social_contract}\\
+  All software is free and open-source (FOSS).\\
+  Debian is governed by public democratic processes.
+\item[P\textnormal{opular}]\hfill\url{http://www.debian.org/users}\\
+  Used by governments, companies, educational institutions.
+\end{description}
 
+\begin{comment}
+Original: Very Special Old Pale
 
-buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
-\columnbreak
+Could also stand for
+Very (Special|Stable) Operating Platform
+\end{comment}
 
-buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
+%\ndsection{Understand Debian}
 \columnbreak
+\ndsubsection{Three Debian suites}
+
+% Debian distribution comes in 3 major flavors
+
+\begin{description}[nolistsep,leftmargin=1pc,topsep=0em]
+
+%\item[Unstable] \emph{Constantly changing distribution}\\
+\item[Development]\hfill\emph{Unstable} (always \emph{sid})\\
+  Never \emph{released}, constantly evolving platform to integrate new
+  versions of software into Debian.\\
+  %entry point for the software to appear in Debian.\\
+  Despite its name, \emph{Unstable} is a good platform for those
+  requiring the most recent versions of software.
+
+%\item[Testing] \emph{Constantly changing future release candidate}\\
+\item[``Almost-ready-to-release'']\hfill\emph{Testing} (now \emph{squeeze})\\
+%  What to become a next \emph{Stable} release candidate.\\
+  Software versions known to be secure and of good quality.
+%  Software migrated from \emph{Unstable} which is known to be of good
+%  quality.  Immediate updates are provided only
+%  to assure secure and robust performance. \\
+  \emph{Testing} provides a good balance between stability and recency
+  of software.
+
+%\item[Stable] \emph{Official release}\\
+\item[Official release]\hfill\emph{Stable} (now \emph{lenny})\\
+  % Software verified to be well tested and secure,
+  % Very stable (hence the name) and secure
+  % but might be lacking the most recent versions.\\% of the software.\\
+  % of not the most recent versions. \\
+  \emph{Stable} is released ``when it is ready'', \emph{i.e.} when
+  \emph{Testing} is assured to be robust. %, on average bi-yearly.
+  Complementary updates keep the
+  system secure. \\
+  \emph{Stable} is the choice where stability and security are of
+  primary importance.
+\end{description}
 
-buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
+\begin{comment}
+\ndsubsection{It has names}
+
+The code names of Debian releases are names of characters from the Toy
+Story animation, e.g. sid, squeeze, lenny.  \emph{Unstable}
+flavor always called \emph{sid}, while a new name chosen for every
+upcoming release and assigned to \emph{Testing} to become a code name
+of the release when it becomes \emph{Stable}.\\  At the moment
+\emph{squeeze} is \emph{Testing}, and \emph{lenny} is \emph{Stable}.
+As soon as \emph{squeeze} gets released, \emph{Testing} will be given
+a new name -- \emph{wheezy}.
+\end{comment}
+
+\ndsubsection{Three Debian components}
+
+% Debian distribution comes in 3 major flavors
+%Debian Free Software Guidelines (DFSG)\\
+%\url{http://www.debian.org/social_contract}
+
+\begin{description}[nolistsep,leftmargin=1pc,topsep=0em]
+\item[Free as in freedom]\hfill\emph{main}\\
+  % This is the actual Debian with full support.\\
+  All software in \emph{main} is distributed under FOSS licenses
+  compliant with Debian Free Software Guidelines (DFSG) to assure
+  complete freedom to use, modify, and (re-)distribute.
+\item[Wanna-be free]\hfill\emph{contrib}\\
+  FOSS depending on \emph{non-free} 3rd party software.
+%  Software which, despite being free itself, depends on
+%  \emph{non-free} 3rd party software, rendering it useless without
+\item[Somewhat free]\hfill\emph{non-free}\\
+  Software under restrictive licenses available at no charge.
+ % removing some freedoms
+ % (\emph{e.g.} non-commercial use only), but which is allowed to be
+ % used for free and re-distributed (\emph{e.g. NVidia drivers})
+\end{description}
 
-\section*{Acknowledgements}
 
-\columnbreak
+\ndsubsection{Debian enthusiastic experts}
+% could be simply 'Debian People' or 'Debian Community'
+
+Debian is the only major operating system developed
+solely by volunteer individuals who collaborate via the Internet.
+Debian developers, teams or individual contributors improve the operating
+system not by writing new applications (in most cases), but by
+\begin{itemize}[nolistsep,topsep=0em,leftmargin=1pc]
+\item integrating existing software into Debian
+\item fixing and communicating bug reports to original developers
+\item assuring overall quality of the distribution
+\item improving documentation and translations
+\item providing user support
+\end{itemize}
+
+Packaged software in Debian have individual maintainers who are
+often also users of a particular software, and who are therefore interested in its
+reliable operation. Certain fields of applications have dedicated maintainer
+teams, such as Debian-Science or Debian-Med.
+
+%\columnbreak
+\ndsubsection{How to get Debian}
+
+%\subsubsection*{Stable}
+\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+\item[Install on a hard-drive] \url{http://get.debian.net/}
+\item[Boot from CD/USB] \url{http://get.debian.net/live/}
+\item[Run in a Virtual Machine] \url{http://neuro.debian.net/vm.html}
+\item[More options (e.g. buy pre-installed machine)] \url{http://debian.org/distrib}
+\item[Testing/Unstable version] \url{http://www.debian.org/devel/debian-installer}
+\end{description}
+
+% \ndsubsection{Get \emph{Testing/Unstable} Debian}
+%
+% Install on a hard-drive or in a Virtual Machine\\
+% \url{http://www.debian.org/devel/debian-installer}
+%
+
+\ndsubsection{How to install software}
+
+GUI (Synaptic): \textit{Select and click ``Apply''}\\
+\includegraphics[width=\columnwidth]{shots/synaptic-fslview}
+
+Command line: \texttt{apt-get install <packagename>}
+
+
+
+\ndsubsection{How to upgrade the entire system}
+
+GUI (Synaptic):
+
+\quad\textit{Click ``Mark All Upgrades'', ``Apply''}\\
+Command line:
+
+\quad\texttt{apt-get update; apt-get dist-upgrade}
+
+\ndsubsection{How to get support}
+
+\url{http://www.debian.org/support}
+
+\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+%\item[GUI]
+%  Use \emph{Synaptic Package Manager}
+\item[Software bug]
+  \texttt{reportbug <packagename>}
+\item[Community support]
+  %\begin{description}[nolistsep,leftmargin=1pc]
+  %\item[Mailing lists] 
+  \url{http://www.debian.org/MailingLists}\\
+  \url{http://forums.debian.net}\\
+  \url{http://ask.debian.net}
+  %\end{description}
+\item[Commercial support]
+  \url{http://www.debian.org/consultants}
+\end{description}
+
+\begin{comment}
+\ndsection{Reasons to choose Debian}
+\paragraph{It is maintained by its users}
+
+If something needs to be fixed or improved, we just do it.
+
+\paragraph{Unparalleled support}
+
+Mail sent to the mailing lists often gets answers within 15 minutes (or less),
+for free, and by the people who developed it. Compare that to typical phone
+support: hours spent on the phone, for money, only to get someone who doesn't
+know the system well enough to even understand your question.
+
+\paragraph{You wouldn't be alone in your choice}
+
+A wide range of organizations and individuals use Debian. See our Who's Using
+Debian? page for a description of some high-profile sites which use Debian, and
+have chosen to submit a short description of how they use Debian and why.
+
+\paragraph{The best packaging system in the world.}
+
+Tired of old files from software three versions old cluttering your system? Or
+installing a piece of software only to find it causes your system to crash
+because of software conflicts? Dpkg, Debian's endured packaging system, takes
+care of these issues for you.
+
+\paragraph{Easy installation}
+
+If you have heard that GNU/Linux is difficult to install, then you haven't
+tried Debian lately. We are constantly improving the installation process. You
+can do the installation directly from CD, DOS, floppies or even over the
+network.
+
+\paragraph{Incredible amounts of software}
+
+Debian comes with over 25000 different pieces of software. Every bit of it is
+free. If you have proprietary software that runs under GNU/Linux, you can still
+use it - in fact, there may even be an installer in Debian that will
+automatically install and set up everything for you.
+
+\paragraph{Packages well integrated}
+
+Debian surpasses all other distributions in how well its packages are
+integrated. Since all software is packaged by a coherent group, not only can
+all packages be found at a single site, but you can be assured that we have
+already worked out all issues regarding complicated dependencies. While we feel
+that the deb format has some advantages over the rpm format, it is the
+integration between the packages that makes a Debian system more robust.
+
+\paragraph{Source code}
+
+If you are a software developer, you will appreciate the fact that there are
+hundreds of development tools and languages, plus millions of lines of source
+code in the base system. All of the software in the main distribution meets the
+criteria of the Debian Free Software Guidelines (DFSG). This means that you can
+freely use this code to study from, or to incorporate into new free software
+projects. There are also plenty of tools and code suitable for use in
+proprietary projects.
+
+\paragraph{Easy upgrades}
+
+Due to our packaging system, upgrading to a new version of Debian is a snap.
+Just run apt-get update ; apt-get dist-upgrade (or aptitude update; aptitude
+dist-upgrade in newer releases) and you can upgrade from a CD in a matter of
+minutes or point apt at one of the over 300 Debian mirrors and upgrade over the
+net.
+
+\rotatebox{90}{\includegraphics[height=.9\columnwidth]{distro-dev}}
+\rotatebox{90}{Description}
+
+\paragraph{Multiple architectures and kernels}
+
+Currently Debian supports an impressive number of CPU architectures: alpha,
+amd64, armel, hppa, i386, ia64, mips, mipsel, powerpc, s390, and sparc. It also
+runs on GNU Hurd and FreeBSD kernels besides Linux, and with the debootstrap
+utility you will be hard-pressed to find a device that can't run Debian.
+
+\paragraph{Bug tracking system}
+
+Debian's bug tracking system is publicly available. We don't try to hide the
+fact that software doesn't always work the way users want. Users are encouraged
+to submit bug reports and are notified when and why the bug was closed. This
+system allows Debian to respond to problems quickly and honestly.
+
+
+\ndsection{Acknowledgements}
+\end{comment}
+
 \end{multicols}
 
 
@@ -57,84 +377,173 @@ buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dug
 %%
 \begin{multicols}{3}    % 3 columns
 
+\section*{The Universal Research Platform}
 \begin{center}
 \noindent
-\vspace{-3em}
+
 \includegraphics[width=\columnwidth]{logo_tuned/label}
 
 \url{http://neuro.debian.net}
-\section*{NeuroDebian Project}
-\subsection*{The Universal Research Environment}
+%\ndsection{NeuroDebian Project:}
+% \hrule
+\end{center}
 
+\ndsection{NeuroDebian is}
 
-\end{center}
+a Debian project aiming to provide the Neuroscience community with a
+stable and versatile research platform -- the Debian OS.
+Since 2005, NeuroDebian integrates neuroscience software into the Debian
+operating system to allow neuroscientists to benefit from the advantages of
+the universal operating system in their day-to-day research activities.
+The NeuroDebian repository
+(\url{http://neuro.debian.net}) offers the latest research software for
+all Debian suites (and various releases of Ubuntu).
+The combination of a stable generic
+operating system, Debian, and a variety of conveniently accessible research
+software creates a versatile research platform for neuroscience that offers the
+latest methodologies of the field for everyone, for free.
+These advantages make NeuroDebian increasingly popular among
+neuroscientists and scientific software developers.
 
-\section*{What is NeuroDebian}
 
-\section*{What is in NeuroDebian}
+\ndsubsection{NeuroDebian is NOT}
 
-Icons for FSL, Caret, AFNI, etc
+yet another Debian GNU/Linux derivative distribution.  All work done
+by the NeuroDebian project targets the official Debian operating system. This
+approach helps to increase the longevity of the project by relying on the
+efforts of thousands of Debian contributors.
 
+\columnbreak
 
-%\columnbreak
+\ndsubsection{Benefits from Debian integration}
+
+\begin{itemize}[nolistsep,leftmargin=1pc]
+
+% rephrase to outline the benefit, not burden
+\item Debian standards and policies guarantee quality and robustness
+
+\item Debian centralized bug tracking system provides a unified
+  single-point of entry for bug reporting and troubleshooting for any
+  software in Debian
+
+\item Debian makes software available through a world-wide distribution
+  network, thus offloading bandwidth demands
+
+\item Other Debian enthusiasts take care about large-scale aspects of
+  deployment, quality assurance, porting and integration at the level
+  of the entire distribution:
+
+\begin{description}[nolistsep,leftmargin=1pc]
+\item[Porting] Software sources get built for 11 hardware
+  architectures and 3 kernels (Linux, HURD, kFreeBSD). Porter teams
+  maintain build infrastructure and help making the code
+  platform-agnostic.
+\item[QA] Whole-archive rebuilds assure robustness of packaging and
+  warn about upcoming problems (core libraries upgrades) beforehand.
+\item[Internationalization (I18n)] Translator teams help localizing
+  software for more than 60 languages
+\end{description}
 
-\section*{How to get NeuroDebian}
+\item Neuroscience software becomes 1st-class citizen within Debian
+  project, which guarantees its availability, longevity, smooth
+  installation and upgrades
+
+%\item Participation in the Debian community helps to assure Debian's
+%  aptness for the neuroscientific software demands
 
-\begin{itemize}
-\item Debian/Ubuntu -- Repository
-\item Others -- Virtual Appliance
 \end{itemize}
 
-\section*{Developers oriented information}
 
-buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
-sdflkj
-slkdjf
 
 %\columnbreak
 
-\section*{Who is using NeuroDebian}
+\ndsubsection{How to get NeuroDebian}
 
-\noindent
-\includegraphics[width=\columnwidth]{usage_worldmap}
+\textit{Debian/Ubuntu:} \url{neuro.debian.net} repository \\
+\textit{Others:} NeuroDebian Virtual Machine
 
-buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
+% Here place a left-top corner of OSX with seamless mode
+\vspace{1mm}
+\includegraphics[width=\columnwidth]{../shots/mac_vm_mricron}
+
+\begin{comment}
+\ndsubsection{Developers oriented information}
 
+%\columnbreak
 
-\section*{Future\ldots}
+\ndsubsection{Who is using NeuroDebian}
 
-\begin{description}[leftmargin=1em]
+\noindent
+%\includegraphics[width=\columnwidth]{usage_worldmap}
 
-\item[Wider coverage]:\\
-  BioSig, NEURON, FreeSurfer, etc.
+buga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga dugabuga duga
+\end{comment}
 
-\item[Assured interoperability]:\\
-  Intergration- and regression- testing
+\ndsubsection{NeuroDebian software coverage}
+\begin{flushright}
+\vspace{-0.5em}
+\url{http://neuro.debian.net/pkgs.html}
+\end{flushright}
+\textit{Electrophysiology:} BioSig, Sigviewer, Brian, \ldots\\
+\textit{Machine Learning:} PyMVPA, scikits.learn, \ldots\\
+\textit{Imaging:} AFNI, FSL, Mricron, NiPy, Voxbo, \ldots\\
+\textit{Psychophysics:} PsychoPy, PyEPL, PyOptical, \ldots\\
 
-\item[Snapshotting]
 
-\item[Data as 1st class citizen]
 
-\item[Universal Availability]:\\
-  \begin{itemize}
-  \item New versions of Virtual Appliance
-  \item Cloud computing images
-  \end{itemize}
+\def\blank{\hspace{0em}\vspace{-1em}}
+\columnbreak
+
+\ndsubsection{Work-in-progress}
+\begin{description}[nolistsep,leftmargin=1pc,style=nextline]
+\item[Increased coverage]
+\textit{Electrophysiology:} NEURON, OpenElectrophy, \ldots \\
+\textit{Matlab/Octave toolboxes:} SPM, EEGLAB, \ldots \\
+\textit{Distributed computing:} Condor \\
+\textit{Imaging:} Connectomeviewer, Freesurfer, MIPAV \\
+
+\epigraph{Having FreeSurfer integrated into the Debian operating system by the NeuroDebian team would have enormous benefits for us, and for the thousands of users of FreeSurfer across the world.}{Prof. Bruce Fischl}{Director, Computational Core at Martinos Center at Massachusetts General Hospital, Charlestown, Massachusetts, USA}
+\item[Improved quality assurance]
+  Extended integration and regression testing
+\item[Available snapshotting service]
+  % Entire NeuroDebian repository for any given past moment
+  All versions of packages readily available
+\item[Data as the 1st class citizen]
+  \url{http://neuro.debian.net/datasets.html}
+\item[Universal availability]
+  % \begin{itemize}[nolistsep,leftmargin=1pc,topsep=0em]
+  % \item Virtual Appliance enhancements
+  %\item
+  Cloud computing
+  %\end{itemize}
 
 \end{description}
 
 
-\section*{Endorsements}
+\ndsubsection{Testimonials}
+\begin{flushright}
+\vspace{-0.5em}
+\url{http://neuro.debian.net/testimonials.html}
+\vspace{-0.5em}
+\end{flushright}
 
-some quotes from letters of support
 
+\epigraph{The approach taken with NeuroDebian is plainly the most appropriate
+approach to software distribution for the dominant platform in brain
+image analysis, and I have great confidence that this project will be
+a major asset to the neuroscience community in facilitating the
+distribution of stable software, improving the reliability and
+replicability of analyses, and in helping to improve software
+development practices.}{Prof. Daniel Y. Kimberg}{Director, Data
+Processing Facility, Center for Functional Neuroimaging, University of
+Pennsylvania, Philadelphia, USA}
 
-\section*{Acknowledgements}
+\ndsubsection{Acknowledgements}
 
-We are grateful to all Debian developers and contributors for the
-development of Debian OS, and to Prof. Jim Haxby (PBS Department,
+NeuroDebian is grateful to all Debian developers and contributors for the
+development of Debian OS, and to Prof. James V. Haxby (PBS Department,
 Dartmouth College) for his continued support and endless supply of
-Italian espresso.
+Italian espresso (\url{http://neuro.debian.net/coffeeart.html}).
 
 %\columnbreak
 \end{multicols}