Skip to content

Commit 2fc711b

Browse files
committed
major update to Vim page. 1000th commit wooo
1 parent b893e5e commit 2fc711b

File tree

10 files changed

+191
-44
lines changed

10 files changed

+191
-44
lines changed

Diff for: all.html

+63-15
Original file line numberDiff line numberDiff line change
@@ -635,14 +635,24 @@ <h2>Configuring Vim with a Vimrc file</h2>
635635
</pre></div>
636636

637637

638+
<p>Here is how these configuration options look with a dark background on
639+
Mac OS X while editing the markdown for this webpage (how meta!).</p>
640+
<p><img src="theme/img/vim-dark-bg.jpg" width="100%" alt="Vim with basic configuration options on a dark background." class="technical-diagram" style="border-radius: 5px;"></p>
641+
<p>Take a look at another example using these configuration options, this time
642+
with a light background and editing Python code from my
643+
<a href="https://github.com/makaimc/choose-your-own-adventure-presentations">Choose Your Own Adventures Presentations</a>
644+
project.</p>
645+
<p><img src="theme/img/vim-white-bg.png" width="100%" alt="Vim with basic configuration options on a white background." class="technical-diagram" style="border-radius: 5px; border: 1px solid #999;"></p>
638646
<p>The Vimrc file lives under the home directory of the user account running
639647
Vim. For example, when my user account is 'matt', on Mac OS X my Vimrc
640-
file is found at <code>/Users/matt/.vimrc</code>. On Ubuntu Linux my Vimrc file
641-
can be found within <code>/home/matt/.vimrc</code>. </p>
642-
<p>If the Vimrc file does not already exist, just create it within the user's
643-
home directory and it will be picked up by Vim the next time you start the
644-
program.</p>
645-
<h2>General Vim resources</h2>
648+
file is found at <code>/Users/matt/.vimrc</code>. On Ubuntu Linux my .vimrc file
649+
can be found within the <code>/home/matt/</code> directory. </p>
650+
<p>If a Vimrc file does not already exist, just create it within the user's
651+
home directory and it will be picked up by Vim the next time you open the
652+
editor.</p>
653+
<h2>Vim tutorials</h2>
654+
<p>Vim has a reputation for a difficult learning curve, but it's much easier
655+
to get started with these tutorials.</p>
646656
<ul>
647657
<li>
648658
<p><a href="http://vim-adventures.com/">Vim Adventures</a> is a cute, fun browser-based
@@ -659,15 +669,6 @@ <h2>General Vim resources</h2>
659669
incredibly deep study in how to go from beginner to knowledgeable in Vim.</p>
660670
</li>
661671
<li>
662-
<p><a href="http://haridas.in/vim-as-your-ide.html">Vim as Your IDE</a> discusses how to
663-
set up Vim for greater productivity once you learn the initial Vim language
664-
for using the editor.</p>
665-
</li>
666-
<li>
667-
<p><a href="http://stackoverflow.com/questions/9172802/setting-up-vim-for-python">Setting up Vim for Python</a>
668-
has a well written answer on Stack Overflow for getting started with Vim.</p>
669-
</li>
670-
<li>
671672
<p><a href="http://benmccormick.org/2014/07/02/learning-vim-in-2014-vim-as-language/">Vim as a Language</a>
672673
explains the language syntax and how you can build up over time to master
673674
the editor.</p>
@@ -679,7 +680,40 @@ <h2>General Vim resources</h2>
679680
code editting tool.</p>
680681
</li>
681682
</ul>
683+
<h2>Vim Python IDE bundles and resources</h2>
684+
<p>Once you get comfortable with Vim as an editor, there are several
685+
configuration options and plugins you can use to enhance your Python
686+
productivity. These are the resources and tutorials to read when you're
687+
ready to take that step.</p>
688+
<ul>
689+
<li>
690+
<p>The <a href="https://github.com/klen/python-mode">python-mode</a> project is a Vim
691+
plugin with syntax highlighting, breakpoints, PEP8 linting, code completion
692+
and many other features you'd expect from an integrated development
693+
environment.</p>
694+
</li>
695+
<li>
696+
<p><a href="https://github.com/gmarik/Vundle.vim">Vundle</a> comes highly recommended
697+
as a plug-in manager for Vim.</p>
698+
</li>
699+
<li>
700+
<p><a href="http://haridas.in/vim-as-your-ide.html">Vim as Your IDE</a> discusses how to
701+
set up Vim for greater productivity once you learn the initial Vim language
702+
for using the editor.</p>
703+
</li>
704+
<li>
705+
<p><a href="unlogic.co.uk/2013/02/08/vim-as-a-python-ide/">Vim as a Python IDE</a>
706+
goes through the steps necessary to make Vim into a more comfortable
707+
environment for Python development.</p>
708+
</li>
709+
<li>
710+
<p><a href="http://stackoverflow.com/questions/9172802/setting-up-vim-for-python">Setting up Vim for Python</a>
711+
has a well written answer on Stack Overflow for getting started with Vim.</p>
712+
</li>
713+
</ul>
682714
<h2>Vim installation guides</h2>
715+
<p>These installation guides will help you get Vim up and running on Mac OS X,
716+
Linux and Windows.</p>
683717
<ul>
684718
<li>
685719
<p><a href="http://prioritized.net/blog/upgrading-vim-on-os-x/">Upgrading Vim on OS X</a>
@@ -697,6 +731,9 @@ <h2>Vim installation guides</h2>
697731
</li>
698732
</ul>
699733
<h2>Vimrc resources</h2>
734+
<p>These are a few resources for learning how to structure a .vimrc file. I
735+
recommend adding configuration options one at a time to test them
736+
individually instead of going whole hog with a Vimrc you are unfamiliar with.</p>
700737
<ul>
701738
<li>
702739
<p><a href="http://dougblack.io/words/a-good-vimrc.html">A Good Vimrc</a> is a fantastic,
@@ -707,6 +744,11 @@ <h2>Vimrc resources</h2>
707744
<p><a href="https://justin.abrah.ms/vim/vim_and_python.html">Vim and Python</a> shows
708745
and explains many Python-specific .vimrc options.</p>
709746
</li>
747+
<li>
748+
<p>This
749+
<a href="https://github.com/amix/vimrc/tree/master/vimrcs">repository's folder with Vimrc files</a>
750+
has example configurations that are well commented and easy to learn from. </p>
751+
</li>
710752
</ul>
711753
<h2>Vim Plugin resources</h2>
712754
<ul>
@@ -721,6 +763,10 @@ <h2>Vim Plugin resources</h2>
721763
usefulness. The comments at the bottom are also interesting as people have
722764
suggested alternatives to some of the plugins mentioned in the post.</p>
723765
</li>
766+
<li>
767+
<p><a href="https://github.com/powerline/powerline">Powerline</a> is a popular statusline
768+
plugin for Vim that works with both Python 2 and 3.</p>
769+
</li>
724770
</ul>
725771
<h3>What do you want to learn about Python development?</h3>
726772
<h1>Emacs</h1>
@@ -5439,6 +5485,8 @@ <h1>Change Log</h1>
54395485
<h2>2015</h2>
54405486
<h3>March</h3>
54415487
<ul>
5488+
<li>Major update to <a href="/vim.html">Vim</a> page to add screenshots, a better example
5489+
.vimrc configuration and many more resources.</li>
54425490
<li>Updated the <a href="/web-analytics.html">web analytics</a> page with a new
54435491
Python-specific section for walkthroughs that are specific to building or
54445492
using analytics with Python applications.</li>

Diff for: change-log.html

+2
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@ <h1>Change Log</h1>
4646
<h2>2015</h2>
4747
<h3>March</h3>
4848
<ul>
49+
<li>Major update to <a href="/vim.html">Vim</a> page to add screenshots, a better example
50+
.vimrc configuration and many more resources.</li>
4951
<li>Updated the <a href="/web-analytics.html">web analytics</a> page with a new
5052
Python-specific section for walkthroughs that are specific to building or
5153
using analytics with Python applications.</li>

Diff for: feeds/all.atom.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2015-03-21T11:46:29Z</updated></feed>
2+
<feed xmlns="http://www.w3.org/2005/Atom"><title>Matt Makai</title><link href="http://www.fullstackpython.com/" rel="alternate"></link><link href="http://www.fullstackpython.com/feeds/all.atom.xml" rel="self"></link><id>http://www.fullstackpython.com/</id><updated>2015-03-21T13:21:15Z</updated></feed>

Diff for: source/content/pages/02-learning-programming/05-vim.markdown

+62-13
Original file line numberDiff line numberDiff line change
@@ -79,18 +79,34 @@ to get a feel for some of the configuration statements:
7979
let python_highlight_all = 1
8080

8181

82+
Here is how these configuration options look with a dark background on
83+
Mac OS X while editing the markdown for this webpage (how meta!).
84+
85+
<img src="theme/img/vim-dark-bg.jpg" width="100%" alt="Vim with basic configuration options on a dark background." class="technical-diagram" style="border-radius: 5px;">
86+
87+
Take a look at another example using these configuration options, this time
88+
with a light background and editing Python code from my
89+
[Choose Your Own Adventures Presentations](https://github.com/makaimc/choose-your-own-adventure-presentations)
90+
project.
91+
92+
<img src="theme/img/vim-white-bg.png" width="100%" alt="Vim with basic configuration options on a white background." class="technical-diagram" style="border-radius: 5px; border: 1px solid #999;">
93+
94+
95+
8296
The Vimrc file lives under the home directory of the user account running
8397
Vim. For example, when my user account is 'matt', on Mac OS X my Vimrc
84-
file is found at ``/Users/matt/.vimrc``. On Ubuntu Linux my Vimrc file
85-
can be found within ``/home/matt/.vimrc``.
98+
file is found at ``/Users/matt/.vimrc``. On Ubuntu Linux my .vimrc file
99+
can be found within the ``/home/matt/`` directory.
86100

87-
If the Vimrc file does not already exist, just create it within the user's
88-
home directory and it will be picked up by Vim the next time you start the
89-
program.
101+
If a Vimrc file does not already exist, just create it within the user's
102+
home directory and it will be picked up by Vim the next time you open the
103+
editor.
90104

91105

106+
## Vim tutorials
107+
Vim has a reputation for a difficult learning curve, but it's much easier
108+
to get started with these tutorials.
92109

93-
## General Vim resources
94110
* [Vim Adventures](http://vim-adventures.com/) is a cute, fun browser-based
95111
game that helps you learn Vim commands by playing through the adventure.
96112

@@ -102,13 +118,6 @@ program.
102118
* [A vim Tutorial and Primer](https://danielmiessler.com/study/vim/) is an
103119
incredibly deep study in how to go from beginner to knowledgeable in Vim.
104120

105-
* [Vim as Your IDE](http://haridas.in/vim-as-your-ide.html) discusses how to
106-
set up Vim for greater productivity once you learn the initial Vim language
107-
for using the editor.
108-
109-
* [Setting up Vim for Python](http://stackoverflow.com/questions/9172802/setting-up-vim-for-python)
110-
has a well written answer on Stack Overflow for getting started with Vim.
111-
112121
* [Vim as a Language](http://benmccormick.org/2014/07/02/learning-vim-in-2014-vim-as-language/)
113122
explains the language syntax and how you can build up over time to master
114123
the editor.
@@ -119,7 +128,36 @@ program.
119128
code editting tool.
120129

121130

131+
## Vim Python IDE bundles and resources
132+
Once you get comfortable with Vim as an editor, there are several
133+
configuration options and plugins you can use to enhance your Python
134+
productivity. These are the resources and tutorials to read when you're
135+
ready to take that step.
136+
137+
* The [python-mode](https://github.com/klen/python-mode) project is a Vim
138+
plugin with syntax highlighting, breakpoints, PEP8 linting, code completion
139+
and many other features you'd expect from an integrated development
140+
environment.
141+
142+
* [Vundle](https://github.com/gmarik/Vundle.vim) comes highly recommended
143+
as a plug-in manager for Vim.
144+
145+
* [Vim as Your IDE](http://haridas.in/vim-as-your-ide.html) discusses how to
146+
set up Vim for greater productivity once you learn the initial Vim language
147+
for using the editor.
148+
149+
* [Vim as a Python IDE](unlogic.co.uk/2013/02/08/vim-as-a-python-ide/)
150+
goes through the steps necessary to make Vim into a more comfortable
151+
environment for Python development.
152+
153+
* [Setting up Vim for Python](http://stackoverflow.com/questions/9172802/setting-up-vim-for-python)
154+
has a well written answer on Stack Overflow for getting started with Vim.
155+
156+
122157
## Vim installation guides
158+
These installation guides will help you get Vim up and running on Mac OS X,
159+
Linux and Windows.
160+
123161
* [Upgrading Vim on OS X](http://prioritized.net/blog/upgrading-vim-on-os-x/)
124162
explains why to upgrade from Vim 7.2 to 7.3+ and how to do it using
125163
[Homebrew](http://brew.sh/).
@@ -133,13 +171,21 @@ program.
133171

134172

135173
## Vimrc resources
174+
These are a few resources for learning how to structure a .vimrc file. I
175+
recommend adding configuration options one at a time to test them
176+
individually instead of going whole hog with a Vimrc you are unfamiliar with.
177+
136178
* [A Good Vimrc](http://dougblack.io/words/a-good-vimrc.html) is a fantastic,
137179
detailed overview and opinionated guide to configuring Vim. Highly
138180
recommended for new and experienced Vim users.
139181

140182
* [Vim and Python](https://justin.abrah.ms/vim/vim_and_python.html) shows
141183
and explains many Python-specific .vimrc options.
142184

185+
* This
186+
[repository's folder with Vimrc files](https://github.com/amix/vimrc/tree/master/vimrcs)
187+
has example configurations that are well commented and easy to learn from.
188+
143189

144190
## Vim Plugin resources
145191
* [5 Essential VIM Plugins That Greatly Increase my Productivity](http://joelhooks.com/blog/2013/04/23/5-essential-vim-plugins/)
@@ -151,5 +197,8 @@ program.
151197
usefulness. The comments at the bottom are also interesting as people have
152198
suggested alternatives to some of the plugins mentioned in the post.
153199

200+
* [Powerline](https://github.com/powerline/powerline) is a popular statusline
201+
plugin for Vim that works with both Python 2 and 3.
202+
154203

155204
### What do you want to learn about Python development?

Diff for: source/content/pages/13-meta/02-change-log.markdown

+2
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ the
2626

2727
## 2015
2828
### March
29+
* Major update to [Vim](/vim.html) page to add screenshots, a better example
30+
.vimrc configuration and many more resources.
2931
* Updated the [web analytics](/web-analytics.html) page with a new
3032
Python-specific section for walkthroughs that are specific to building or
3133
using analytics with Python applications.

Diff for: source/theme/static/img/vim-dark-bg.jpg

257 KB
Loading

Diff for: source/theme/static/img/vim-white-bg.png

237 KB
Loading

Diff for: theme/img/vim-dark-bg.jpg

257 KB
Loading

Diff for: theme/img/vim-white-bg.png

237 KB
Loading

Diff for: vim.html

+61-15
Original file line numberDiff line numberDiff line change
@@ -94,14 +94,24 @@ <h2>Configuring Vim with a Vimrc file</h2>
9494
</pre></div>
9595

9696

97+
<p>Here is how these configuration options look with a dark background on
98+
Mac OS X while editing the markdown for this webpage (how meta!).</p>
99+
<p><img src="theme/img/vim-dark-bg.jpg" width="100%" alt="Vim with basic configuration options on a dark background." class="technical-diagram" style="border-radius: 5px;"></p>
100+
<p>Take a look at another example using these configuration options, this time
101+
with a light background and editing Python code from my
102+
<a href="https://github.com/makaimc/choose-your-own-adventure-presentations">Choose Your Own Adventures Presentations</a>
103+
project.</p>
104+
<p><img src="theme/img/vim-white-bg.png" width="100%" alt="Vim with basic configuration options on a white background." class="technical-diagram" style="border-radius: 5px; border: 1px solid #999;"></p>
97105
<p>The Vimrc file lives under the home directory of the user account running
98106
Vim. For example, when my user account is 'matt', on Mac OS X my Vimrc
99-
file is found at <code>/Users/matt/.vimrc</code>. On Ubuntu Linux my Vimrc file
100-
can be found within <code>/home/matt/.vimrc</code>. </p>
101-
<p>If the Vimrc file does not already exist, just create it within the user's
102-
home directory and it will be picked up by Vim the next time you start the
103-
program.</p>
104-
<h2>General Vim resources</h2>
107+
file is found at <code>/Users/matt/.vimrc</code>. On Ubuntu Linux my .vimrc file
108+
can be found within the <code>/home/matt/</code> directory. </p>
109+
<p>If a Vimrc file does not already exist, just create it within the user's
110+
home directory and it will be picked up by Vim the next time you open the
111+
editor.</p>
112+
<h2>Vim tutorials</h2>
113+
<p>Vim has a reputation for a difficult learning curve, but it's much easier
114+
to get started with these tutorials.</p>
105115
<ul>
106116
<li>
107117
<p><a href="http://vim-adventures.com/">Vim Adventures</a> is a cute, fun browser-based
@@ -118,15 +128,6 @@ <h2>General Vim resources</h2>
118128
incredibly deep study in how to go from beginner to knowledgeable in Vim.</p>
119129
</li>
120130
<li>
121-
<p><a href="http://haridas.in/vim-as-your-ide.html">Vim as Your IDE</a> discusses how to
122-
set up Vim for greater productivity once you learn the initial Vim language
123-
for using the editor.</p>
124-
</li>
125-
<li>
126-
<p><a href="http://stackoverflow.com/questions/9172802/setting-up-vim-for-python">Setting up Vim for Python</a>
127-
has a well written answer on Stack Overflow for getting started with Vim.</p>
128-
</li>
129-
<li>
130131
<p><a href="http://benmccormick.org/2014/07/02/learning-vim-in-2014-vim-as-language/">Vim as a Language</a>
131132
explains the language syntax and how you can build up over time to master
132133
the editor.</p>
@@ -138,7 +139,40 @@ <h2>General Vim resources</h2>
138139
code editting tool.</p>
139140
</li>
140141
</ul>
142+
<h2>Vim Python IDE bundles and resources</h2>
143+
<p>Once you get comfortable with Vim as an editor, there are several
144+
configuration options and plugins you can use to enhance your Python
145+
productivity. These are the resources and tutorials to read when you're
146+
ready to take that step.</p>
147+
<ul>
148+
<li>
149+
<p>The <a href="https://github.com/klen/python-mode">python-mode</a> project is a Vim
150+
plugin with syntax highlighting, breakpoints, PEP8 linting, code completion
151+
and many other features you'd expect from an integrated development
152+
environment.</p>
153+
</li>
154+
<li>
155+
<p><a href="https://github.com/gmarik/Vundle.vim">Vundle</a> comes highly recommended
156+
as a plug-in manager for Vim.</p>
157+
</li>
158+
<li>
159+
<p><a href="http://haridas.in/vim-as-your-ide.html">Vim as Your IDE</a> discusses how to
160+
set up Vim for greater productivity once you learn the initial Vim language
161+
for using the editor.</p>
162+
</li>
163+
<li>
164+
<p><a href="unlogic.co.uk/2013/02/08/vim-as-a-python-ide/">Vim as a Python IDE</a>
165+
goes through the steps necessary to make Vim into a more comfortable
166+
environment for Python development.</p>
167+
</li>
168+
<li>
169+
<p><a href="http://stackoverflow.com/questions/9172802/setting-up-vim-for-python">Setting up Vim for Python</a>
170+
has a well written answer on Stack Overflow for getting started with Vim.</p>
171+
</li>
172+
</ul>
141173
<h2>Vim installation guides</h2>
174+
<p>These installation guides will help you get Vim up and running on Mac OS X,
175+
Linux and Windows.</p>
142176
<ul>
143177
<li>
144178
<p><a href="http://prioritized.net/blog/upgrading-vim-on-os-x/">Upgrading Vim on OS X</a>
@@ -156,6 +190,9 @@ <h2>Vim installation guides</h2>
156190
</li>
157191
</ul>
158192
<h2>Vimrc resources</h2>
193+
<p>These are a few resources for learning how to structure a .vimrc file. I
194+
recommend adding configuration options one at a time to test them
195+
individually instead of going whole hog with a Vimrc you are unfamiliar with.</p>
159196
<ul>
160197
<li>
161198
<p><a href="http://dougblack.io/words/a-good-vimrc.html">A Good Vimrc</a> is a fantastic,
@@ -166,6 +203,11 @@ <h2>Vimrc resources</h2>
166203
<p><a href="https://justin.abrah.ms/vim/vim_and_python.html">Vim and Python</a> shows
167204
and explains many Python-specific .vimrc options.</p>
168205
</li>
206+
<li>
207+
<p>This
208+
<a href="https://github.com/amix/vimrc/tree/master/vimrcs">repository's folder with Vimrc files</a>
209+
has example configurations that are well commented and easy to learn from. </p>
210+
</li>
169211
</ul>
170212
<h2>Vim Plugin resources</h2>
171213
<ul>
@@ -180,6 +222,10 @@ <h2>Vim Plugin resources</h2>
180222
usefulness. The comments at the bottom are also interesting as people have
181223
suggested alternatives to some of the plugins mentioned in the post.</p>
182224
</li>
225+
<li>
226+
<p><a href="https://github.com/powerline/powerline">Powerline</a> is a popular statusline
227+
plugin for Vim that works with both Python 2 and 3.</p>
228+
</li>
183229
</ul>
184230
<h3>What do you want to learn about Python development?</h3>
185231
<div class="row">

0 commit comments

Comments
 (0)