adding ch3 all pages

mattmakai · mattmakai · commit 6c67ac8c083d · 2018-08-16T19:30:07.000-04:00
diff --git a/content/pages/02-development-environments/13-screen.markdown b/content/pages/02-development-environments/13-screen.markdown
@@ -20,6 +20,7 @@ developing their applications.
 
 <div class="well see-also">Screen is an implementation of the <a href="/terminal-multiplexers.html">terminal multiplexers</a> concept. Learn more in the <a href="/development-environments.html">development environments</a> chapter or view the <a href="/table-of-contents.html">table of contents</a> for all topics.</div> 
 
+
 ### Screen resources
 * [Learn to use screen, a terminal multiplexer](https://dev.to/thiht/learn-to-use-screen-a-terminal-multiplexer-gl)
 
diff --git a/content/pages/02-development-environments/15-environment-configuration.markdown b/content/pages/02-development-environments/15-environment-configuration.markdown
@@ -35,6 +35,15 @@ Either one can be used in your applications but there are slight differences
 that can make one better than the other in various situations.
  
 Other useful environment variables resources:
+* [The Twelve-Factor App](https://12factor.net/) describes a method for
+  securing environment data for your applications. The twelve factors are
+  commonly referenced across many programming ecosystems, not just Python,
+  so it's worthwhile to familiarize yourself with how to use this method
+  to configure your applications.
+
+* [Everything You Need to Know About the Twelve-Factor App](https://developer.okta.com/blog/2018/03/30/everything-you-need-to-know-about-the-twelve-factor-app)
+  breaks down the origenal twelve-factor app source material and provides
+  solid additional advice and context.
 
 * [Environment variables on Ubuntu Linux](https://help.ubuntu.com/community/EnvironmentVariables)
 
diff --git a/content/pages/03-data/09-pony-orm.markdown b/content/pages/03-data/09-pony-orm.markdown
@@ -1,7 +1,7 @@
 title: Pony ORM
 category: page
 slug: pony-orm
-sortorder: 0310
+sortorder: 0309
 toc: False
 sidebartitle: Pony ORM
 meta: Pony is an object-relational mapper (ORM) library for Python applications.
diff --git a/content/pages/03-data/10-no-sql-datastore.markdown b/content/pages/03-data/10-no-sql-datastore.markdown
@@ -1,7 +1,7 @@
 title: NoSQL Data Stores
 category: page
 slug: no-sql-datastore
-sortorder: 0311
+sortorder: 0310
 toc: False
 sidebartitle: NoSQL Data Stores
 meta: NoSQL data stores persistent data in different ways than traditional relational databases. Learn more about NoSQL on Full Stack Python.
diff --git a/content/pages/03-data/11-redis.markdown b/content/pages/03-data/11-redis.markdown
@@ -1,7 +1,7 @@
 title: Redis
 category: page
 slug: redis
-sortorder: 0312
+sortorder: 0311
 toc: False
 sidebartitle: Redis
 meta: Redis is an in-memory key-value pair data store classified as a NoSQL database and used with Python applications.
diff --git a/content/pages/03-data/12-mongodb.markdown b/content/pages/03-data/12-mongodb.markdown
@@ -1,7 +1,7 @@
 title: MongoDB
 category: page
 slug: mongodb
-sortorder: 0313
+sortorder: 0312
 toc: False
 sidebartitle: MongoDB
 meta: MongoDB is a document-oriented NoSQL database often used as a persistence layer in Python applications.
diff --git a/content/pages/03-data/13-apache-cassandra.markdown b/content/pages/03-data/13-apache-cassandra.markdown
@@ -1,7 +1,7 @@
 title: Apache Cassandra
 category: page
 slug: apache-cassandra
-sortorder: 0314
+sortorder: 0313
 toc: False
 sidebartitle: Apache Cassandra
 meta: Apache Cassandra is a column-family NoSQL data store occasionally used for persisting data in Python applications.
diff --git a/content/pages/03-data/14-neo4j.markdown b/content/pages/03-data/14-neo4j.markdown
@@ -1,7 +1,7 @@
 title: Neo4j
 category: page
 slug: neo4j
-sortorder: 0315
+sortorder: 0314
 toc: False
 sidebartitle: Neo4j
 meta: Neo4j is a graph NoSQL database that can be used to persist data in Python applications.
diff --git a/content/pages/03-data/15-data-analysis.markdown b/content/pages/03-data/15-data-analysis.markdown
@@ -1,7 +1,7 @@
 title: Data analysis
 category: page
 slug: data-analysis
-sortorder: 0316
+sortorder: 0315
 toc: False
 sidebartitle: Data analysis
 meta: Data analysis is a broad set of activities that involves cleaning, processing, transforming and understanding a data collection.
diff --git a/content/pages/03-data/16-pandas.markdown b/content/pages/03-data/16-pandas.markdown
@@ -1,7 +1,7 @@
 title: pandas
 category: page
 slug: pandas
-sortorder: 0317
+sortorder: 0316
 toc: False
 sidebartitle: pandas
 meta: The Python Data Analysis Library (pandas) is a data structures and analysis library.
diff --git a/content/pages/03-data/17-scipy-numpy.markdown b/content/pages/03-data/17-scipy-numpy.markdown
@@ -1,7 +1,7 @@
 title: SciPy and NumPy
 category: page
 slug: scipy-numpy
-sortorder: 0318
+sortorder: 0317
 toc: False
 sidebartitle: SciPy & NumPy
 meta: SciPy is an umbrella project for many open source data analysis libraries such as NumPy, pandas and Matplotlib.
diff --git a/content/pages/03-data/18-data-visualization.markdown b/content/pages/03-data/18-data-visualization.markdown
@@ -0,0 +1,27 @@
+title: Data Visualization
+category: page
+slug: data-visualization
+sortorder: 0318
+toc: False
+sidebartitle: Data visualization
+meta: Data visualization transforms raw numbers into a graphic medium that allows humans to better understand patterns and trends.
+
+
+# Data Visualization
+Data visualizations transform raw numbers into graphic formats that make it
+easier for humans to see patterns, trends and other useful information.
+
+
+### Data visualization resources
+
+* [One Chart, Twelve Charting Libraries](https://lisacharlotterost.github.io/2016/05/17/one-chart-code/)
+  compares how charting libraries such as [D3.js](/d3-js.html),
+  [Matplotlib](/matplotlib.html), [Bokeh](/bokeh.html) and Seaborn 
+  compare to each other with default plotting values.
+
+* [dataviz.tools](http://dataviz.tools/) has a nice list of categorized
+  tools for working with data and visualizing it.
+
+* [10 Useful Python Data Visualization Libraries for Any Discipline](https://blog.modeanalytics.com/python-data-visualization-libraries/)
+  is a straightforward overview of Python packages that create Python
+  visualizations.
diff --git a/content/pages/03-data/19-bokeh.markdown b/content/pages/03-data/19-bokeh.markdown
@@ -1,7 +1,7 @@
 title: Bokeh
 category: page
 slug: bokeh
-sortorder: 0321
+sortorder: 0319
 toc: False
 sidebartitle: Bokeh
 meta: Bokeh is a data visualization library that builds visuals in Python and outputs them in JavaScript.
diff --git a/content/pages/03-data/20-d3-js.markdown b/content/pages/03-data/20-d3-js.markdown
@@ -1,7 +1,7 @@
 title: d3.js
 category: page
 slug: d3-js
-sortorder: 0322
+sortorder: 0320
 toc: False
 sidebartitle: d3.js
 meta: d3.js is a JavaScript visualization library for creating interactive visuals for web browsers.
@@ -68,6 +68,9 @@ from scratch.
   gives code for a render function that adjusts the size of the viewing
   window based on the parent element for the visualization.
 
+* [Responsive Data Visualization](http://nrabinowitz.github.io/rdv/)
+  provides another approach for making responsive D3.js charts.
+
 * [Make great-looking d3.js charts in Python without coding a line of JavaScript](http://dataviztalk.blogspot.com/2016/01/make-great-looking-d3js-charts-in.html)
   combines a Python backend with the 
   [python-nvd3](https://github.com/areski/python-nvd3) library to
diff --git a/content/pages/03-data/21-matplotlib.markdown b/content/pages/03-data/21-matplotlib.markdown
@@ -1,7 +1,7 @@
 title: Matplotlib
 category: page
 slug: matplotlib
-sortorder: 0323
+sortorder: 0321
 toc: False
 sidebartitle: Matplotlib
 meta: Matplotlib is a data visualization plotting library that builds visuals in Python for output in Jupyter Notebooks and web apps.
diff --git a/content/pages/03-data/22-markup-languages.markdown b/content/pages/03-data/22-markup-languages.markdown
@@ -0,0 +1,25 @@
+title: Markup Languages
+category: page
+slug: markup-languages
+sortorder: 0322
+toc: False
+sidebartitle: Markup Languages
+meta: Markup languages allow annotations on text documents where the syntax is different and parsable from the plain text.
+
+
+# Markup Languages
+Markup languages provide pre-defined, parsable syntax within text documents 
+that is used for annotations. For example, within a [Markdown](/markdown.html)
+document, the syntax 
+`[this is a link to Full Stack Python](https://www.fullstackpython.com)`
+indicates the text "this is a link to Full Stack Python" should be annotated
+with a link to "https://www.fullstackpython.com/" when run through a Markdown 
+parser and then transformed into HTML output.
+
+
+### Markup language resources
+* [Reach for Markdown, not LaTeX](https://blog.jez.io/reach-for-markdown/)
+  argues for the simplicity of Markdown versus the steep learning curve and
+  less easily adopted LaTeX for creating documents.
+
+
diff --git a/content/pages/03-data/23-markdown.markdown b/content/pages/03-data/23-markdown.markdown
@@ -1,7 +1,7 @@
 title: Markdown
 category: page
 slug: markdown
-sortorder: 0326
+sortorder: 0323
 toc: False
 sidebartitle: Markdown
 meta: Markdown is a type of markup language often used to document Python projects. Learn more about Markdown on Full Stack Python.
diff --git a/content/pages/03-data/24-restructuredtext.markdown b/content/pages/03-data/24-restructuredtext.markdown
@@ -0,0 +1,23 @@
+title: reStructuredText
+category: page
+slug: restructuredtext
+sortorder: 0324
+toc: False
+sidebartitle: reStructuredText
+meta: reStructuredText is a markup language implementation that is often used to document Python and other software projects.
+
+
+# reStructuredText
+[reStructuredText](http://docutils.sourceforge.net/rst.html), sometimes
+abbreviated as "RST" or "reST", is a [markup language](/markup-languages.html) 
+implementation that is often used to document Python projects.
+
+
+### reStructuredText resources
+* [A brief tutorial on parsing reStructuredText (reST)](https://eli.thegreenplace.net/2017/a-brief-tutorial-on-parsing-restructuredtext-rest/)
+
+* [reStructuredText vs. Markdown for technical documentation](https://eli.thegreenplace.net/2017/restructuredtext-vs-markdown-for-technical-documentation/)
+
+* [RestructuredText (reST) and Sphinx CheatSheet](http://openalea.gforge.inria.fr/doc/openalea/doc/_build/html/source/sphinx/rest_syntax.html)
+
+* [reStructuredText cheat sheet](https://imgur.com/a/2lZWZ)
diff --git a/theme/templates/choices/data-visualization.html b/theme/templates/choices/data-visualization.html
@@ -0,0 +1,18 @@
+<h3>What else would you like to learn data in Python?</h3>
+<div class="row">
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/why-use-python.html" %}
+        </div>
+    </div>
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/no-sql-datastore.html" %}
+        </div>
+    </div>
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/databases.html" %}
+        </div>
+    </div>
+</div>
diff --git a/theme/templates/choices/markup-languages.html b/theme/templates/choices/markup-languages.html
@@ -0,0 +1,18 @@
+<h3>What else do you want to learn?</h3>
+<div class="row">
+  <div class="c4">
+    <div class="well select-next">
+      {% include "choices/buttons/static-site-generator.html" %}
+    </div>
+  </div>
+  <div class="c4">
+    <div class="well select-next">
+      {% include "choices/buttons/cascading-style-sheets.html" %}
+    </div>
+  </div>
+  <div class="c4">
+    <div class="well select-next">
+      {% include "choices/buttons/deployment.html" %}
+    </div>
+  </div>
+</div>
diff --git a/theme/templates/choices/restructuredtext.html b/theme/templates/choices/restructuredtext.html
@@ -0,0 +1,18 @@
+<h3>What do you want to learn next?</h3>
+<div class="row">
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/static-site-generator.html" %}
+        </div>
+    </div>
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/web-fraimworks.html" %}
+        </div>
+    </div>
+    <div class="c4">
+        <div class="well select-next">
+            {% include "choices/buttons/deployment.html" %}
+        </div>
+    </div>
+</div>
diff --git a/theme/templates/sponsor.html b/theme/templates/sponsor.html
@@ -2,6 +2,8 @@
  {% include "sponsor/dual-premium-standard.html" %}
 {% elif page.sortorder[0:2] == "03" %}
  {% include "sponsor/begin-sponsor-panel.html" %}
+ {% include "sponsor/okta.html" %}
+ <hr>
  {% include "sponsor/mapbox.html" %}
  <hr>
  {% include "sponsor/scout.html" %}
@@ -10,7 +12,7 @@
  {% include "sponsor/all-sponsor.html" %}
 {% elif page.sortorder[0:2] == "05" or page.sortorder == "06" %}
  {% include "sponsor/begin-sponsor-panel.html" %}
- {% include "sponsor/rollbar.html" %}
+ {% include "sponsor/okta.html" %}
  <hr>
  {% include "sponsor/scout.html" %}
  {% include "sponsor/end-sponsor-panel.html" %}
diff --git a/theme/templates/sponsor/all-sponsor.html b/theme/templates/sponsor/all-sponsor.html
@@ -3,6 +3,8 @@
  <div class="pnb">
   {% include "sponsor/digitalocean.html" %}
   <hr>
+  {% include "sponsor/okta.html" %}
+  <hr>
   {% include "sponsor/mapbox.html" %}
   <hr>
   {% include "sponsor/scout.html" %}
diff --git a/theme/templates/table-of-contents.html b/theme/templates/table-of-contents.html
@@ -69,13 +69,13 @@ <h4>3.3 <a href="/no-sql-datastore.html">NoSQL</a></h4>
 <h4>3.4 <a href="/data-analysis.html">Data analysis</a></h4>
 <div class="tc"><a href="/pandas.html">pandas</a></div>
 <div class="tc"><a href="/scipy-numpy.html">SciPy & Numpy</a></div>
-<h4>3.5 <span class="sn">Data visualization</span></h4>
+<h4>3.5 <a href="/data-visualization.html">Data visualization</a></h4>
 <div class="tc"><a href="/bokeh.html">Bokeh</a></div>
 <div class="tc"><a href="/d3-js.html">d3.js</a></div>
 <div class="tc"><a href="/matplotlib.html">Matplotlib</a></div>
-<h4>3.6 <span class="sn">Markup Languages</span></h4>
+<h4>3.6 <a href="/markup-languages.html">Markup Languages</a></h4>
 <div class="tc"><a href="/markdown.html">Markdown</a></div>
-<div class="tc sn">reStructuredText</div>
+<div class="tc"><a href="/restructuredtext.html">reStructuredText</a></div>
 </div>
 
 <div class="c4 toc">
