Skip to content

Commit a915680

Browse files
mattmakaimattmakai
committed
updating cross page references so it's easier to know where to go next on FSP
1 parent 88acbac commit a915680

File tree

16 files changed

+135
-61
lines changed

16 files changed

+135
-61
lines changed

‎all.html‎

Lines changed: 40 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ <h1>Why Use Python?</h1>
6262
language is also widely taught in universities and used for working with
6363
beginner-friendly devices such as the
6464
<a href="http://www.raspberrypi.org/">Raspberry Pi</a>.</p>
65-
<div class="well">
65+
<div class="well see-also">
6666
If you're learning about why to use Python you should also take a look at
6767
<a href="/best-python-resources.html">the best Python resources</a> and read
6868
<a href="/what-full-stack-means.html">what "full stack" means</a>.
@@ -574,17 +574,27 @@ <h2>Development environment resources</h2>
574574
</li>
575575
</ul>
576576
<h1>Vim</h1>
577-
<p>Vim, shorthand for Vi IMproved, is a text editor with numerous configuration
578-
options and wide-ranging extensions that can be used to write Python code.</p>
577+
<p>Vim, short for Vi IMproved, is a configurable text editor often used as
578+
a Python development environment. Vim proponents commonly cite the numerous
579+
plugins, Vimscript and logical command language as major Vim strengths.</p>
579580
<h2>Why is Vim a good Python development environment?</h2>
580-
<p>Vim's philosophy is that developers are fastest when they never take their
581-
hands off the keys. Even using the mouse is a detriment to the rate at which
582-
your thoughts can flow into code. </p>
583-
<p>Vim has a language behind its commands. When a beginner is learning the
584-
editor she may feel like it is impossible to understand all the key commands.
585-
However, the commands stack together in a logical way so that over time
586-
the editor becomes predictable.</p>
587-
<h2>Configuring Vim with a Vimrc</h2>
581+
<p>Vim's philosophy is that developers are more productive when they avoid
582+
taking their hands off the keyboard. Code should flow naturally from the
583+
developer's thoughts through the keyboard and onto the screen. Using a mouse
584+
or other perphipheral is a detriment to the rate at which a developer's
585+
thoughts become code.</p>
586+
<p>Vim has a logical, structured command language. When a beginner is learning
587+
the editor she may feel like it is impossible to understand all the key
588+
commands. However, the commands stack together in a logical way so that over
589+
time the editor becomes predictable.</p>
590+
<div class="well see-also">
591+
If you're interested in Vim you'll also want to read about
592+
<a href="/development-environments.html">development environments for coding</a>
593+
and learn
594+
<a href="/why-use-python.html">what makes Python a great programming language</a>.
595+
</div>
596+
597+
<h2>Configuring Vim with a Vimrc file</h2>
588598
<p>The Vimrc file is used to configure the Vim editor. A Vimrc file can range
589599
from nothing in it to very complicated with hundreds or thousands of lines
590600
of configuration commands.</p>
@@ -895,7 +905,13 @@ <h2>Common web framework functionality</h2>
895905
use with non-relational databases by incorporating external Python libraries.
896906
There is a spectrum between minimal functionality with easy extensibility and
897907
including everything in the framework with tight integration.</p>
898-
<h2>General web framework resources</h2>
908+
<div class="well see-also">
909+
While you're learning about web frmaeworks you should also find out about
910+
<a href="/deployment.html">web application deployment</a> and
911+
<a href="/application-programming-interfaces.html">web APIs</a>.
912+
</div>
913+
914+
<h2>Web framework resources</h2>
899915
<ul>
900916
<li>
901917
<p>"<a href="http://www.jeffknupp.com/blog/2014/03/03/what-is-a-web-framework/">What is a web framework?</a>"
@@ -993,6 +1009,12 @@ <h2>Why is Django a good web framework choice?</h2>
9931009
<a href="http://www.jeffknupp.com/blog/2012/12/11/learning-python-via-django-considered-harmful/">learning Python by using Django is a bad idea</a>.
9941010
However, that criticism is invalid if you take the time to learn the Python
9951011
syntax and language semantics first before diving into web development.</p>
1012+
<div class="well see-also">
1013+
While you're learning about Django you should also read up on
1014+
<a href="/web-frameworks.html">web frameworks</a> and check out the
1015+
<a href="/bottle.html">Bottle framework</a>.
1016+
</div>
1017+
9961018
<h2>Django tutorials</h2>
9971019
<ul>
9981020
<li>
@@ -1329,12 +1351,6 @@ <h1>Flask</h1>
13291351
<p><a href="http://flask.pocoo.org/">Flask</a> is a Python web framework built with a
13301352
<a href="http://flask.pocoo.org/docs/design/">small core and easy-to-extend philosophy</a>.
13311353
<a href="http://flask.pocoo.org/" style="border: none;"><img src="theme/img/flask.jpg" width="100%" alt="Official Flask logo. Flask Artwork License." class="technical-diagram"></a></p>
1332-
<div class="well" style="margin-top: 20px;">
1333-
If you're learning about Flask you should also understand
1334-
<a href="/web-frameworks.html">web frameworks</a> and read
1335-
how to <a href="/deployment.html">deploy web applications</a>.
1336-
</div>
1337-
13381354
<h2>Why is Flask a good web framework choice?</h2>
13391355
<p>Flask is considered more
13401356
<a href="http://blog.startifact.com/posts/older/what-is-pythonic.html">Pythonic</a>
@@ -1359,6 +1375,12 @@ <h2>Why is Flask a good web framework choice?</h2>
13591375
learned from the Python community's reactions as the framework evolved.
13601376
Jökull Sólberg wrote a great piece articulating to this effect in his
13611377
<a href="http://jokull.calepin.co/my-flask-to-django-experience.html">experience switching between Flask and Django</a>.</p>
1378+
<div class="well see-also">
1379+
If you're learning about Flask you should also understand
1380+
<a href="/web-frameworks.html">web frameworks</a> and read
1381+
how to <a href="/deployment.html">deploy web applications</a>.
1382+
</div>
1383+
13621384
<h2>Flask resources</h2>
13631385
<ul>
13641386
<li>

‎django.html‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,12 @@ <h2>Why is Django a good web framework choice?</h2>
7777
<a href="http://www.jeffknupp.com/blog/2012/12/11/learning-python-via-django-considered-harmful/">learning Python by using Django is a bad idea</a>.
7878
However, that criticism is invalid if you take the time to learn the Python
7979
syntax and language semantics first before diving into web development.</p>
80+
<div class="well see-also">
81+
While you're learning about Django you should also read up on
82+
<a href="/web-frameworks.html">web frameworks</a> and check out the
83+
<a href="/bottle.html">Bottle framework</a>.
84+
</div>
85+
8086
<h2>Django tutorials</h2>
8187
<ul>
8288
<li>

‎feeds/all.atom.xml‎

Lines changed: 1 addition & 1 deletion
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-20T07:25:51Z</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-20T12:39:33Z</updated></feed>

‎flask.html‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,6 @@ <h1>Flask</h1>
4242
<p><a href="http://flask.pocoo.org/">Flask</a> is a Python web framework built with a
4343
<a href="http://flask.pocoo.org/docs/design/">small core and easy-to-extend philosophy</a>.
4444
<a href="http://flask.pocoo.org/" style="border: none;"><img src="theme/img/flask.jpg" width="100%" alt="Official Flask logo. Flask Artwork License." class="technical-diagram"></a></p>
45-
<div class="well" style="margin-top: 20px;">
46-
If you're learning about Flask you should also understand
47-
<a href="/web-frameworks.html">web frameworks</a> and read
48-
how to <a href="/deployment.html">deploy web applications</a>.
49-
</div>
50-
5145
<h2>Why is Flask a good web framework choice?</h2>
5246
<p>Flask is considered more
5347
<a href="http://blog.startifact.com/posts/older/what-is-pythonic.html">Pythonic</a>
@@ -72,6 +66,12 @@ <h2>Why is Flask a good web framework choice?</h2>
7266
learned from the Python community's reactions as the framework evolved.
7367
Jökull Sólberg wrote a great piece articulating to this effect in his
7468
<a href="http://jokull.calepin.co/my-flask-to-django-experience.html">experience switching between Flask and Django</a>.</p>
69+
<div class="well see-also">
70+
If you're learning about Flask you should also understand
71+
<a href="/web-frameworks.html">web frameworks</a> and read
72+
how to <a href="/deployment.html">deploy web applications</a>.
73+
</div>
74+
7575
<h2>Flask resources</h2>
7676
<ul>
7777
<li>

‎source/content/pages/02-learning-programming/01-why-use-python.markdown‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ language is also widely taught in universities and used for working with
3030
beginner-friendly devices such as the
3131
[Raspberry Pi](http://www.raspberrypi.org/).
3232

33-
<div class="well">
33+
<div class="well see-also">
3434
If you're learning about why to use Python you should also take a look at
3535
<a href="/best-python-resources.html">the best Python resources</a> and read
3636
<a href="/what-full-stack-means.html">what "full stack" means</a>.

‎source/content/pages/02-learning-programming/05-vim.markdown‎

Lines changed: 24 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,32 @@ choice4text:
1818

1919

2020
# Vim
21-
Vim, shorthand for Vi IMproved, is a text editor with numerous configuration
22-
options and wide-ranging extensions that can be used to write Python code.
21+
Vim, short for Vi IMproved, is a configurable text editor often used as
22+
a Python development environment. Vim proponents commonly cite the numerous
23+
plugins, Vimscript and logical command language as major Vim strengths.
2324

2425

2526
## Why is Vim a good Python development environment?
26-
Vim's philosophy is that developers are fastest when they never take their
27-
hands off the keys. Even using the mouse is a detriment to the rate at which
28-
your thoughts can flow into code.
29-
30-
Vim has a language behind its commands. When a beginner is learning the
31-
editor she may feel like it is impossible to understand all the key commands.
32-
However, the commands stack together in a logical way so that over time
33-
the editor becomes predictable.
34-
35-
36-
## Configuring Vim with a Vimrc
27+
Vim's philosophy is that developers are more productive when they avoid
28+
taking their hands off the keyboard. Code should flow naturally from the
29+
developer's thoughts through the keyboard and onto the screen. Using a mouse
30+
or other perphipheral is a detriment to the rate at which a developer's
31+
thoughts become code.
32+
33+
Vim has a logical, structured command language. When a beginner is learning
34+
the editor she may feel like it is impossible to understand all the key
35+
commands. However, the commands stack together in a logical way so that over
36+
time the editor becomes predictable.
37+
38+
<div class="well see-also">
39+
If you're interested in Vim you'll also want to read about
40+
<a href="/development-environments.html">development environments for coding</a>
41+
and learn
42+
<a href="/why-use-python.html">what makes Python a great programming language</a>.
43+
</div>
44+
45+
46+
## Configuring Vim with a Vimrc file
3747
The Vimrc file is used to configure the Vim editor. A Vimrc file can range
3848
from nothing in it to very complicated with hundreds or thousands of lines
3949
of configuration commands.
@@ -66,6 +76,7 @@ home directory and it will be picked up by Vim the next time you start the
6676
program.
6777

6878

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

‎source/content/pages/04-web-development/01-web-frameworks.markdown‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,14 @@ There is a spectrum between minimal functionality with easy extensibility and
5858
including everything in the framework with tight integration.
5959

6060

61-
## General web framework resources
61+
<div class="well see-also">
62+
While you're learning about web frmaeworks you should also find out about
63+
<a href="/deployment.html">web application deployment</a> and
64+
<a href="/application-programming-interfaces.html">web APIs</a>.
65+
</div>
66+
67+
68+
## Web framework resources
6269
* "[What is a web framework?](http://www.jeffknupp.com/blog/2014/03/03/what-is-a-web-framework/)"
6370
by [Jeff Knupp](https://twitter.com/jeffknupp)
6471
is an in-depth explanation of what web frameworks are and their relation

‎source/content/pages/04-web-development/02-django.markdown‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,13 @@ However, that criticism is invalid if you take the time to learn the Python
6767
syntax and language semantics first before diving into web development.
6868

6969

70+
<div class="well see-also">
71+
While you're learning about Django you should also read up on
72+
<a href="/web-frameworks.html">web frameworks</a> and check out the
73+
<a href="/bottle.html">Bottle framework</a>.
74+
</div>
75+
76+
7077
## Django tutorials
7178
* [Test-Driven Development with Python](http://www.obeythetestinggoat.com/)
7279
focuses on web development using Django and JavaScript. This book uses

‎source/content/pages/04-web-development/03-flask.markdown‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,6 @@ choice4text: How can I version and store my source code so I don't lose it?
2323
<a href="http://flask.pocoo.org/" style="border: none;"><img src="theme/img/flask.jpg" width="100%" alt="Official Flask logo. Flask Artwork License." class="technical-diagram"></a>
2424

2525

26-
<div class="well" style="margin-top: 20px;">
27-
If you're learning about Flask you should also understand
28-
<a href="/web-frameworks.html">web frameworks</a> and read
29-
how to <a href="/deployment.html">deploy web applications</a>.
30-
</div>
31-
32-
3326
## Why is Flask a good web framework choice?
3427
Flask is considered more
3528
[Pythonic](http://blog.startifact.com/posts/older/what-is-pythonic.html)
@@ -55,6 +48,12 @@ learned from the Python community's reactions as the framework evolved.
5548
Jökull Sólberg wrote a great piece articulating to this effect in his
5649
[experience switching between Flask and Django](http://jokull.calepin.co/my-flask-to-django-experience.html).
5750

51+
<div class="well see-also">
52+
If you're learning about Flask you should also understand
53+
<a href="/web-frameworks.html">web frameworks</a> and read
54+
how to <a href="/deployment.html">deploy web applications</a>.
55+
</div>
56+
5857

5958
## Flask resources
6059
* The Flask mega tutorial by

‎source/theme/static/css/f.css‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1733,4 +1733,5 @@ h3.panel-head {margin: 5px 0 0 0; font-size: 26px; color: #fff;}
17331733
}
17341734
}
17351735
.technical-diagram {margin: 10px 0 5px 0;}
1736-
1736+
.see-also {margin-top: 20px; background: #22B24C; color: #eee;}
1737+
.see-also a {color: #fff;}

0 commit comments

Comments
 (0)