-
Notifications
You must be signed in to change notification settings - Fork 2
Expand file tree
/
Copy pathchoosing_editor.html
More file actions
212 lines (200 loc) · 11.3 KB
/
choosing_editor.html
File metadata and controls
212 lines (200 loc) · 11.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Course on Practical Neuroimaging in Python — Practical neuroimaging analysis</title>
<link rel="stylesheet" href="_static/nature.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<link rel="author" title="About these documents" href="about.html" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Cryptographic hashes" href="cryptographic_hashes.html" />
<link rel="prev" title="Day 15: statistical inference" href="day15.html" />
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="cryptographic_hashes.html" title="Cryptographic hashes"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="day15.html" title="Day 15: statistical inference"
accesskey="P">previous</a> |</li>
<big><big><big><li><a href="index.html">Home</a> | </li>
<li><a href="https://github.com/practical-neuroimaging/pna2015">Exercises</a> | </li>
<li><a href="https://calmail.berkeley.edu/manage/list/listinfo/practical_fmri@lists.berkeley.edu">Mailing list</a> | </li></big></big></big>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="choosing-an-editor">
<span id="choosing-editor"></span><h1>Choosing an editor<a class="headerlink" href="#choosing-an-editor" title="Permalink to this headline">¶</a></h1>
<p>Being efficient means being able to use your tools well. If you are fluent in
using your editor, you will be able think better. You will do better work
more quickly and you will make fewer mistakes.</p>
<p>This is particularly so for a text file editor. Bear in mind that you will
likely spend many hundreds of hours using this editor for various parts of
your work over the rest of your career. Be careful with your choice, and
consider investing time to learn an editor well.</p>
<p>If you do learn your text editor well, you will find yourself using it for
many different tasks, including editing code, documents and configuration
files.</p>
<p>Programmers are a strange bunch of people who are extremely intolerant of
tools that waste their time or energy. Take their impatience seriously when
you consider choosing your editor. No programmer would use Windows Notepad
for writing code, and that is for a very good reason.</p>
<p>The two most well-known and fully-featured cross-platform general text editors
are <a class="reference external" href="http://www.gnu.org/software/emacs/">emacs</a> and <a class="reference external" href="http://www.vim.org">vim</a> / <a class="reference external" href="http://www.vim.org">gvim</a>. These run on any platform.</p>
<p>No doubt you want to know what your instructors use? No? Well, in any case,
the answer is that Matthew and JB use vim, and Stéfan uses emacs.</p>
<div class="section" id="vim">
<h2>vim<a class="headerlink" href="#vim" title="Permalink to this headline">¶</a></h2>
<p>Vim is based on a classic Unix editor called <a class="reference external" href="http://en.wikipedia.org/wiki/Vi">vi</a>. To quote from the <a class="reference external" href="http://www.vim.org/about.php">about
vim</a> page:</p>
<blockquote>
<div>Vim isn’t an editor designed to hold its users’ hands. It is a tool, the
use of which must be learned.</div></blockquote>
<p>To use Vim well, you have to practice using its commands, by following any one
of several online tutorials. For example, you might try the <a class="reference external" href="http://www.openvim.com/tutorial.html">openvim tutorial</a>. The trick is to teach your fingers
what to do so you don’t think about it any more. This takes a long time,
budget a week of 30 minutes a day to start to feel comfortable.</p>
<p>If you do invest this effort, vim is an immensely satisfying editor to use,
because you quickly find that your fingers remember what to do. A
programmer’s joke about vim is that “the cursor follows your eyes”, because
your fingers are moving the cursor around the text without any apparent
thought or effort on your part.</p>
<p>It is relatively complicated to configure vim to its full potential. Please
ask for help if you are interested to do this. It is time well spent.</p>
</div>
<div class="section" id="emacs">
<h2>Emacs<a class="headerlink" href="#emacs" title="Permalink to this headline">¶</a></h2>
<p>Emacs is a classic and highly configurable text editor originally written by
the great <a class="reference external" href="http://en.wikipedia.org/wiki/Richard_Stallman">Richard Stallman</a>. It is quicker to learn than vim, probably
harder to configure, and has great power. A good place to start is the <a class="reference external" href="http://www.gnu.org/software/emacs/tour/">emacs
tour</a>. About an hour of research and practice gets you far enough to learn
how to start learning emacs.</p>
<p>As for vim, to use it well, it needs some practice to get used to the
keystrokes used, and as for vim, this practice is amply repaid by very fluent
movement and editing.</p>
<p>Emacs hard to configure, largely because it is so powerful. We are very happy
to help with this if you are interested.</p>
</div>
<div class="section" id="other-editors-that-you-might-consider">
<h2>Other editors that you might consider<a class="headerlink" href="#other-editors-that-you-might-consider" title="Permalink to this headline">¶</a></h2>
<p>We will support these editors too for anyone who wants to use them. If you
prefer another editor, we will help as best we can.</p>
<p>This suggested set of editors comes from the top four editors from <a class="reference external" href="http://www.rackspace.com/blog/text-editor-madness-bracket-vote-for-your-favorite">text
editor competition</a> with the addition of TextMate (because we know at least
one extremely efficient coder who uses it).</p>
<div class="section" id="for-any-platform">
<h3>For any platform<a class="headerlink" href="#for-any-platform" title="Permalink to this headline">¶</a></h3>
<p>Some people really like <a class="reference external" href="http://www.sublimetext.com/">Sublime text</a>. It is free to try, and the trial
version does not expire, but if you continue to use it, the authors ask you to
buy a license for 70 USD.</p>
</div>
<div class="section" id="for-osx">
<h3>For OSX<a class="headerlink" href="#for-osx" title="Permalink to this headline">¶</a></h3>
<p><a class="reference external" href="http://macromates.com">textmate</a> has some very serious enthusiasts among people who know what they
are doing on OSX. There’s a free <a class="reference external" href="http://ist.berkeley.edu/software-central/textmate">textmate download for UC Berkeley</a>.</p>
</div>
<div class="section" id="for-windows">
<h3>For Windows<a class="headerlink" href="#for-windows" title="Permalink to this headline">¶</a></h3>
<p><a class="reference external" href="http://notepad-plus-plus.org/">Notepad++</a> seems to be a Windows favorite.</p>
</div>
</div>
<div class="section" id="suggestions">
<h2>Suggestions?<a class="headerlink" href="#suggestions" title="Permalink to this headline">¶</a></h2>
<p>If you have any other suggestions or recommendations, please let us know.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Choosing an editor</a><ul>
<li><a class="reference internal" href="#vim">vim</a></li>
<li><a class="reference internal" href="#emacs">Emacs</a></li>
<li><a class="reference internal" href="#other-editors-that-you-might-consider">Other editors that you might consider</a><ul>
<li><a class="reference internal" href="#for-any-platform">For any platform</a></li>
<li><a class="reference internal" href="#for-osx">For OSX</a></li>
<li><a class="reference internal" href="#for-windows">For Windows</a></li>
</ul>
</li>
<li><a class="reference internal" href="#suggestions">Suggestions?</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="day15.html"
title="previous chapter">Day 15: statistical inference</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="cryptographic_hashes.html"
title="next chapter">Cryptographic hashes</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/choosing_editor.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="cryptographic_hashes.html" title="Cryptographic hashes"
>next</a> |</li>
<li class="right" >
<a href="day15.html" title="Day 15: statistical inference"
>previous</a> |</li>
<big><big><big><li><a href="index.html">Home</a> | </li>
<li><a href="https://github.com/practical-neuroimaging/pna2015">Exercises</a> | </li>
<li><a href="https://calmail.berkeley.edu/manage/list/listinfo/practical_fmri@lists.berkeley.edu">Mailing list</a> | </li></big></big></big>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2013-2015, Matthew Brett and J-B Poline.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.1.
</div>
</body>
</html>