Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/dev/env.rst
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ to do that which also shows status and warning messages in the statusbar would b
Python-mode
^^^^^^^^^^^

Python-mode_ is a complex solution in VIM for working with python code.
Python-mode_ is a complex solution in VIM for working with Python code.
It has:

- Asynchronous Python code checking (pylint, pyflakes, pep8, mccabe) in any combination
Expand Down Expand Up @@ -94,7 +94,7 @@ Emacs is a powerful text editor. It's fully programmable (lisp), but
it can be some work to wire up correctly. A good start if you're
already an Emacs user is `Python Programming in Emacs`_ at EmacsWiki.

1. Emacs itself comes with a python mode.
1. Emacs itself comes with a Python mode.
2. Python ships with an alternate version:
`python-mode.el <https://launchpad.net/python-mode>`_
3. Fabián Ezequiel Gallina's `python.el <https://github.com/fgallina/python.el>`_
Expand Down
24 changes: 12 additions & 12 deletions docs/intro/learning.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ Beginner
Learn Python Interactive Tutorial
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Learnpython.org is an easy non-intimidating way to get introduced to python.
Learnpython.org is an easy non-intimidating way to get introduced to Python.
The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_
website, it has an interactive python interpreter built into the site that
website, it has an interactive Python interpreter built into the site that
allows you to go through the lessons without having to install Python locally.

`Learn Python <http://www.learnpython.org/>`_
Expand Down Expand Up @@ -52,11 +52,11 @@ Think Python: How to Think Like a Computer Scientist
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Think Python attempts to give an introduction to basic concepts in computer
science through the use of the python language. The focus was to create a book
science through the use of the Python language. The focus was to create a book
with plenty of exercises, minimal jargon and a section in each chapter devoted
to the subject of debugging.

While exploring the various features available in the python language the
While exploring the various features available in the Python language the
author weaves in various design patterns and best practices.

The book also includes several case studies which have the reader explore the
Expand All @@ -72,11 +72,11 @@ Python Koans

Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven
approach, q.v. TEST DRIVEN DESIGN SECTION to provide an interactive tutorial
teaching basic python concepts. By fixing assertion statements that fail in a
test script, this provides sequential steps to learning python.
teaching basic Python concepts. By fixing assertion statements that fail in a
test script, this provides sequential steps to learning Python.

For those used to languages and figuring out puzzles on their own, this can be
a fun, attractive option. For those new to python and programming, having an
a fun, attractive option. For those new to Python and programming, having an
additional resource or reference will be helpful.

`Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_
Expand All @@ -88,7 +88,7 @@ More information about test driven development can be found at these resources:
A Byte of Python
~~~~~~~~~~~~~~~~

A free introductory book that teaches python at the beginner level, it assumes no
A free introductory book that teaches Python at the beginner level, it assumes no
previous programming experience.

`A Byte of Python for Python 2.x <http://www.ibiblio.org/swaroopch/byteofpython/read/>`_
Expand Down Expand Up @@ -137,16 +137,16 @@ A Primer on Scientific Programming with Python
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

A Primer on Scientific Programming with Python, written by Hans Petter Langtangen,
mainly covers python's usage in scientific field. In the book, examples are
choosen from mathematics and the natural sciences.
mainly covers Python's usage in scientific field. In the book, examples are
chosen from mathematics and the natural sciences.

`A Primer on Scientific Programming with Python <http://www.springer.com/mathematics/computational+science+%26+engineering/book/978-3-642-18365-2>`_

Numerical Methods in Engineering with Python
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Numerical Methods in Engineering with Python,written by Jaan Kiusalaas, attempts to
emphasis on numerical methods and how to implement them in python.
emphasis on numerical methods and how to implement them in Python.

`Numerical Methods in Engineering with Python <http://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_

Expand All @@ -157,7 +157,7 @@ Python in a Nutshell
~~~~~~~~~~~~~~~~~~~~

Python in a Nutshell, written by Alex Martelli, covers most cross-platform
python's usage, from its syntax to built-in libraries to advanced topics such
Python's usage, from its syntax to built-in libraries to advanced topics such
as writing C extensions.

`Python in a Nutshell <http://shop.oreilly.com/product/9780596001889.do>`_
Expand Down
2 changes: 1 addition & 1 deletion docs/intro/news.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Python-related news.
Pycoder's Weekly
~~~~~~~~~~~~~~~~

Pycoder's Weekly is a free weekly python newsletter for Python developers
Pycoder's Weekly is a free weekly Python newsletter for Python developers
by Python developers (Project, Articles, News, and Jobs).

`Pycoder's Weekly <http://www.pycoders.com/>`_
Expand Down
8 changes: 4 additions & 4 deletions docs/scenarios/admin.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Fabric

`Fabric <http://docs.fabfile.org>`_ is a library for simplifying system
administration tasks. While Chef and Puppet tend to focus on managing servers
and system libraries, fabric is more focused on application level tasks such
and system libraries, Fabric is more focused on application level tasks such
as deployment.

Install Fabric:
Expand Down Expand Up @@ -77,7 +77,7 @@ It supports remote command execution from a central point (master host) to multi
hosts (minions). It also supports system states which can be used to configure
multiple servers using simple template files.

Salt supports python versions 2.6 and 2.7 and can be installed via pip:
Salt supports Python versions 2.6 and 2.7 and can be installed via pip:

.. code-block:: console

Expand All @@ -95,7 +95,7 @@ The following command lists all available minion hosts, using the ping module.
The host filtering is accomplished by matching the minion id, or using the grains system.
The `grains <http://docs.saltstack.org/en/latest/topics/targeting/grains.html>`_ system
uses static host information like the operating system version or the CPU architecture to
provide a host taxonomy for the salt modules.
provide a host taxonomy for the Salt modules.

The following command lists all available minions running CentOS using the grains system:

Expand All @@ -119,7 +119,7 @@ and start the Apache server:
- require:
- pkg: apache

State files can be written using YAML, the Jinja2 template system or pure python.
State files can be written using YAML, the Jinja2 template system or pure Python.

`Salt Documentation <http://docs.saltstack.com>`_

Expand Down
2 changes: 1 addition & 1 deletion docs/scenarios/ci.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ which provides the following features:
interpreters
* Running tests in each of the environments, configuring your test tool of
choice
* Acting as a frontend to Continuous Integration servers, reducing boilerplate
* Acting as a front-end to Continuous Integration servers, reducing boilerplate
and merging CI and shell-based testing.


Expand Down
12 changes: 6 additions & 6 deletions docs/scenarios/scientific.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Python is frequently used for high-performance scientific applications. Python
is widely used in academia and scientific projects because it is easy to write,
and it performs really well.

Due to its high performance nature, scientific computing in python often refers
Due to its high performance nature, scientific computing in Python often refers
to external libraries, typically written in faster languages (like C, or
FORTRAN for matrix operations). The main libraries used are `NumPy`_, `SciPy`_
and `Matplotlib`_. Going into detail about these libraries is beyond the scope
Expand All @@ -24,11 +24,11 @@ Tools
IPython
-------

`IPytthon <http://ipython.org/>`_ is an enhanced version of Python interpreter.
`IPython <http://ipython.org/>`_ is an enhanced version of Python interpreter.
The features it provides are of great interest for the scientists. The `inline mode`
allow graphics and plots to be displayed in the terminal (Qt based version).
Moreover the `notebook` mode supports literate programming and reproducible science
generating a web-based python notebook. This notebook allowing to store chunk of
generating a web-based Python notebook. This notebook allowing to store chunk of
Python code along side to the results and additional comments (HTML, LaTeX, Markdown).
The notebook could be shared and exported in various file formats.

Expand Down Expand Up @@ -64,7 +64,7 @@ SciPy

`SciPy <http://scipy.org/>`_ is a library that uses Numpy for more mathematical
functions. SciPy uses NumPy arrays as the basic data structure. SciPy comes
with modules for various commonly used tasks in scientific programing, for
with modules for various commonly used tasks in scientific programming, for
example: linear algebra, integration (calculus), ordinary differential equation
solvers and signal processing.

Expand All @@ -86,7 +86,7 @@ based on Numpy and which provides many useful functions for accessing,
indexing, merging and grouping data easily. The main data structure (DataFrame)
is close to what could be found in the R statistical package, that is
an heterogeneous data tables with name indexing, time series operations
and auto-alignement of data.
and auto-alignment of data.

Rpy2
----
Expand Down Expand Up @@ -120,7 +120,7 @@ Many people who do scientific computing are on Windows. And yet many of the
scientific computing packages are notoriously difficult to build and install.
`Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ however, has
compiled a list of Windows binaries for many useful Python packages. The list
of packages has grown from a mainly scientific python resource to a more
of packages has grown from a mainly scientific Python resource to a more
general list. It might be a good idea to check it out if you're on Windows.

Enthought Python Distribution (EPD)
Expand Down
6 changes: 3 additions & 3 deletions docs/scenarios/web.rst
Original file line number Diff line number Diff line change
Expand Up @@ -271,10 +271,10 @@ and to the templates themselves.
templates. This convenience can lead to uncontrolled
increase in complexity, and often harder to find bugs.

- It is often necessary to mix javascript templates with
- It is often necessary to mix JavaScript templates with
HTML templates. A sane approach to this design is to isolate
the parts where the HTML template passes some variable content
to the javascript code.
to the JavaScript code.



Expand Down Expand Up @@ -370,7 +370,7 @@ The `base.html` file can be used as base for all site pages which are for exampl
</body>


The next listing is our site page (`site.html`) loaded in the python app which extends `base.html`. The content block is
The next listing is our site page (`site.html`) loaded in the Python app which extends `base.html`. The content block is
automatically set into the corresponding block in the base.html page.

.. code-block:: html
Expand Down
10 changes: 5 additions & 5 deletions docs/scenarios/xml.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ untangle
an XML document and returns a Python object which mirrors the nodes and
attributes in its structure.

For example, an xml file like this:
For example, an XML file like this:

.. code-block:: xml

Expand Down Expand Up @@ -36,9 +36,9 @@ xmltodict
---------

`xmltodict <http://github.com/martinblech/xmltodict>`_ is another simple
library that aims at making xml feel like working with json.
library that aims at making XML feel like working with JSON.

An xml file like this:
An XML file like this:

.. code-block:: xml

Expand All @@ -52,7 +52,7 @@ An xml file like this:
</plus>
</mydocument>

can be loaded into a python dict like this:
can be loaded into a Python dict like this:

.. code-block:: python

Expand All @@ -68,6 +68,6 @@ and then you can access elements, attributes and values like this:
doc['mydocument']['plus']['@a'] # == u'complex'
doc['mydocument']['plus']['#text'] # == u'element as well'

xmltodict also lets you roundtrip back to xml with the unparse function,
xmltodict also lets you roundtrip back to XML with the unparse function,
has a streaming mode suitable for handling files that don't fit in memory
and supports namespaces.
2 changes: 1 addition & 1 deletion docs/shipping/packaging.rst
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Go to your command prompt and type:
$ python -m SimpleHTTPServer 9000

This runs a simple http server running on port 9000 and will list all packages
(like **MyPackage**). Now you can install **MyPackage** using any python
(like **MyPackage**). Now you can install **MyPackage** using any Python
package installer. Using Pip, you would do it like:

.. code-block:: console
Expand Down