Skip to content

Commit bcc7285

Browse files
mattmakaimattmakai
committed
updating static website generators page
1 parent df93fef commit bcc7285

8 files changed

Lines changed: 69 additions & 10 deletions

File tree

‎all.html‎

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3024,10 +3024,24 @@ <h1>Static Site Generator</h1>
30243024
<a href="/static-content.html">content delivery network (CDN)</a>
30253025
without any additional dependencies such as a
30263026
<a href="/wsgi-server.html">WSGI server</a>.</p>
3027-
<h2>Why are static site generators useful?</h2>
3027+
<h2>Why are static website generators useful?</h2>
3028+
<p><a href="/static-content.html">Static content files</a> such as HTML, CSS, JavaScript
3029+
can be served from a content delivery network (CDN) for high scale and low
3030+
cost. If a statically generated website is hit by high concurrent traffic
3031+
it will be easily served by the CDN without dropped connections. </p>
3032+
<p>For example, when
3033+
<a href="https://news.ycombinator.com/item?id=7985692">Full Stack Python was on the top of Hacker News</a>
3034+
for a weekend, <a href="https://pages.github.com/">GitHub Pages</a> was used as a CDN
3035+
to serve the site and didn't have any issues even with close to 400
3036+
concurrent connections at a time, as shown in the following Google Analytics
3037+
screenshot captured during that traffic burst.</p>
3038+
<p><img src="theme/img/hacker-news-traffic.jpg" width="100%" alt="Example of how static websites scale with a CDN based on Full Stack Python on Hacker News front page traffic." class="technical-diagram"></a></p>
3039+
<h2>How do static website generators work?</h2>
30283040
<p>Static site generators allow a user to create HTML files by writing in a
3029-
markup language and coding template files. HTML does not need to be
3030-
maintained by hand other than what is in the template files.</p>
3041+
markup language and coding template files. The static site generator then
3042+
combines the markup language and templates to produce HTML. The output HTML
3043+
does not need to be maintained by hand because it is regenerated every time
3044+
the markup or templates are modified.</p>
30313045
<p>For example, as shown in the diagram below, the Pelican static site
30323046
generator can take in reStructuredText files and Jinja2 template files
30333047
as input then combine them to output a set of static HTML files.</p>
@@ -7142,6 +7156,11 @@ <h1>Change Log</h1>
71427156
the
71437157
<a href="https://github.com/makaimc/fullstackpython.github.com/commits/gh-pages">source repository's commit log</a> on GitHub.</p>
71447158
<h2>2015</h2>
7159+
<h3>November</h3>
7160+
<ul>
7161+
<li>Updated the <a href="/static-site-generator.html">static site generators</a> page
7162+
with a better explanation of why they are useful.</li>
7163+
</ul>
71457164
<h3>October</h3>
71467165
<ul>
71477166
<li>Starting a <a href="/microservices.html">microservices</a> page with some basic

‎change-log.html‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,11 @@ <h1>Change Log</h1>
3737
the
3838
<a href="https://github.com/makaimc/fullstackpython.github.com/commits/gh-pages">source repository's commit log</a> on GitHub.</p>
3939
<h2>2015</h2>
40+
<h3>November</h3>
41+
<ul>
42+
<li>Updated the <a href="/static-site-generator.html">static site generators</a> page
43+
with a better explanation of why they are useful.</li>
44+
</ul>
4045
<h3>October</h3>
4146
<ul>
4247
<li>Starting a <a href="/microservices.html">microservices</a> page with some basic

‎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-11-01T16:52:19Z</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-11-02T08:48:18Z</updated></feed>

‎source/content/pages/04-web-development/16-static-site-generator.markdown‎

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,28 @@ files. The HTML files can be hosted and served by a
1515
without any additional dependencies such as a
1616
[WSGI server](/wsgi-server.html).
1717

18+
## Why are static website generators useful?
19+
[Static content files](/static-content.html) such as HTML, CSS, JavaScript
20+
can be served from a content delivery network (CDN) for high scale and low
21+
cost. If a statically generated website is hit by high concurrent traffic
22+
it will be easily served by the CDN without dropped connections.
1823

19-
## Why are static site generators useful?
24+
For example, when
25+
[Full Stack Python was on the top of Hacker News](https://news.ycombinator.com/item?id=7985692)
26+
for a weekend, [GitHub Pages](https://pages.github.com/) was used as a CDN
27+
to serve the site and didn't have any issues even with close to 400
28+
concurrent connections at a time, as shown in the following Google Analytics
29+
screenshot captured during that traffic burst.
30+
31+
<img src="theme/img/hacker-news-traffic.jpg" width="100%" alt="Example of how static websites scale with a CDN based on Full Stack Python on Hacker News front page traffic." class="technical-diagram"></a>
32+
33+
34+
## How do static website generators work?
2035
Static site generators allow a user to create HTML files by writing in a
21-
markup language and coding template files. HTML does not need to be
22-
maintained by hand other than what is in the template files.
36+
markup language and coding template files. The static site generator then
37+
combines the markup language and templates to produce HTML. The output HTML
38+
does not need to be maintained by hand because it is regenerated every time
39+
the markup or templates are modified.
2340

2441
For example, as shown in the diagram below, the Pelican static site
2542
generator can take in reStructuredText files and Jinja2 template files

‎source/content/pages/13-meta/02-change-log.markdown‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ the
1313

1414

1515
## 2015
16+
### November
17+
* Updated the [static site generators](/static-site-generator.html) page
18+
with a better explanation of why they are useful.
19+
1620
### October
1721
* Starting a [microservices](/microservices.html) page with some basic
1822
definitions and resources.

‎source/theme/static/img/hacker-news-traffic.jpg‎

74.8 KB
Loading

‎static-site-generator.html‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,24 @@ <h1>Static Site Generator</h1>
4040
<a href="/static-content.html">content delivery network (CDN)</a>
4141
without any additional dependencies such as a
4242
<a href="/wsgi-server.html">WSGI server</a>.</p>
43-
<h2>Why are static site generators useful?</h2>
43+
<h2>Why are static website generators useful?</h2>
44+
<p><a href="/static-content.html">Static content files</a> such as HTML, CSS, JavaScript
45+
can be served from a content delivery network (CDN) for high scale and low
46+
cost. If a statically generated website is hit by high concurrent traffic
47+
it will be easily served by the CDN without dropped connections. </p>
48+
<p>For example, when
49+
<a href="https://news.ycombinator.com/item?id=7985692">Full Stack Python was on the top of Hacker News</a>
50+
for a weekend, <a href="https://pages.github.com/">GitHub Pages</a> was used as a CDN
51+
to serve the site and didn't have any issues even with close to 400
52+
concurrent connections at a time, as shown in the following Google Analytics
53+
screenshot captured during that traffic burst.</p>
54+
<p><img src="theme/img/hacker-news-traffic.jpg" width="100%" alt="Example of how static websites scale with a CDN based on Full Stack Python on Hacker News front page traffic." class="technical-diagram"></a></p>
55+
<h2>How do static website generators work?</h2>
4456
<p>Static site generators allow a user to create HTML files by writing in a
45-
markup language and coding template files. HTML does not need to be
46-
maintained by hand other than what is in the template files.</p>
57+
markup language and coding template files. The static site generator then
58+
combines the markup language and templates to produce HTML. The output HTML
59+
does not need to be maintained by hand because it is regenerated every time
60+
the markup or templates are modified.</p>
4761
<p>For example, as shown in the diagram below, the Pelican static site
4862
generator can take in reStructuredText files and Jinja2 template files
4963
as input then combine them to output a set of static HTML files.</p>

‎theme/img/hacker-news-traffic.jpg‎

74.8 KB
Loading

0 commit comments

Comments
 (0)