Skip to content

Commit e979813

Browse files
committed
working on mkdocs page
1 parent a904700 commit e979813

File tree

88 files changed

+395
-88
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

88 files changed

+395
-88
lines changed

all.html

Lines changed: 54 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3498,7 +3498,9 @@ <h2>Flask framework learning checklist</h2>
34983498
</li>
34993499
</ol>
35003500
<h1>Bottle</h1>
3501-
<p><a href="http://bottlepy.org/docs/dev/index.html">Bottle</a> is a WSGI-compliant
3501+
<p><a href="http://bottlepy.org/docs/dev/index.html">Bottle</a>
3502+
(<a href="https://github.com/bottlepy/bottle">source code</a>) is a
3503+
<a href="/wsgi-servers.html">WSGI-compliant</a>
35023504
<a href="https://github.com/defnull/bottle/blob/master/bottle.py">single source file</a>
35033505
web framework with no external dependencies other than the Python
35043506
<a href="https://docs.python.org/3/library/">standard library (stdlib)</a>.</p>
@@ -3547,6 +3549,12 @@ <h2>Bottle resources</h2>
35473549
<p>Digital Ocean provides an extensive <a href="https://www.digitalocean.com/community/articles/how-to-use-the-bottle-micro-framework-to-develop-python-web-apps">introductory post on Bottle</a>.</p>
35483550
</li>
35493551
<li>
3552+
<p><a href="https://www.youtube.com/watch?v=qakG9BYJ1tw&amp;list=PLqrz4nXepkz63z1y4-oHfZHWy11gSoAn0">First Steps with Python and Bottle</a>
3553+
is a quick 4 minute introduction that I created for developers so they
3554+
can get the simplest possible Bottle web app running. There is also a
3555+
<a href="https://www.twilio.com/blog/2016/11/first-steps-python-bottle-web-framework.html">companion blog post with the code</a>.</p>
3556+
</li>
3557+
<li>
35503558
<p><a href="https://www.twilio.com/blog/2016/08/getting-started-python-bottle-twilio-sms-mms.html">Getting Started with Python, Bottle and Twilio SMS / MMS</a>
35513559
shows how to build a simple Bottle web application that can send and
35523560
receive text and picture messages.
@@ -3597,11 +3605,6 @@ <h2>Bottle resources</h2>
35973605
shows how to use Jinja instead of the built-in templating engine for
35983606
Bottle page rendering.</p>
35993607
</li>
3600-
<li>
3601-
<p><a href="http://joemartaganna.com/jtblog/how-to-build-a-web-app-using-bottle-with-jinja2-in-google-app-engine.html">How to build a web app using Bottle with Jinja2 in Google App Engine</a>
3602-
provides a tutorial for using Bottle on the Google App Engine
3603-
<a href="/platform-as-a-service.html">platform-as-a-service</a>.</p>
3604-
</li>
36053608
</ul>
36063609
<h2>Open source Bottle example projects</h2>
36073610
<ul>
@@ -4913,6 +4916,51 @@ <h2>Lektor resources</h2>
49134916
<a href="https://www.silvrback.com/">Silvrback</a> to a format that Lektor can use
49144917
to generate a new site.</p>
49154918
</li>
4919+
</ul>
4920+
<h1>MkDocs</h1>
4921+
<p><a href="http://www.mkdocs.org/">MkDocs</a>
4922+
(<a href="https://github.com/mkdocs/mkdocs/">source code</a>, pronounced
4923+
"<a href="https://twitter.com/_tomchristie/status/805861272076042241">McDocs</a>" with
4924+
a Scottish accent or perhaps "Make Docs" otherwise, is a static site
4925+
generator that combines Markdown content with
4926+
<a href="/jinja2.html">Jinja2 templates</a> to produce websites. MkDocs uses
4927+
a YAML configuration file and can optionally use themes to easy change the
4928+
look-and-feel of the documentation output.</p>
4929+
<p><a href="http://www.mkdocs.org/" style="border: none;"><img src="/img/mkdocs-logo.jpg" width="100%" alt="MkDocs static site and documentation generator logo." class="technical-diagram" style="border-radius:5px"></a></p>
4930+
<h2>What's great about MkDocs?</h2>
4931+
<p>MkDocs has three great features for a static site generator: </p>
4932+
<ol>
4933+
<li>search</li>
4934+
<li>easy configuration</li>
4935+
<li>drop-in themes</li>
4936+
</ol>
4937+
<div class="well see-also">MkDocs is an implementation of the <a href="/static-site-generator.html">static site generators</a> concept. Learn how the parts fit together in the <a href="/web-development.html">web development</a> chapter or view <a href="/table-of-contents.html">all topics</a>.</div>
4938+
4939+
<h2>MkDocs resources</h2>
4940+
<ul>
4941+
<li>
4942+
<p>The official
4943+
<a href="http://www.mkdocs.org/#getting-started">Getting Started with MkDocs</a>
4944+
is likely the best place to go when you are just getting set up with your
4945+
first site that uses this project.</p>
4946+
</li>
4947+
<li>
4948+
<p><a href="http://toolsfortheweb.net/cms/building-markdown-based-sites-with-mkdocs/">Building Markdown-based Sites with MkDocs</a>
4949+
provides an initial perspective on using MkDocs to build a static website
4950+
along with some of the advantages and disadvantages that come with using
4951+
this static site generator.</p>
4952+
</li>
4953+
<li>
4954+
<p><a href="https://visibilityspots.org/mkdocs.html">Mkdocs documentation</a> is a quick
4955+
tutorial to get MkDocs installed and modify the initial mkdocs.yml file.</p>
4956+
</li>
4957+
<li>
4958+
<p><a href="http://www.dougalmatthews.com/2015/Jun/27/mkdocs-making-strides/">MkDocs making strides</a>
4959+
is a post from one of the project's core commiters on some changes that
4960+
greatly improved the project such as site regeneration during development
4961+
when a file is modified, search, the command-line client and packageable
4962+
theming.</p>
4963+
</li>
49164964
</ul>
49174965
<h1>WebSockets</h1>
49184966
<p>A WebSocket is a <a href="http://tools.ietf.org/html/rfc6455">standard protocol</a> for

apache-http-server.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

api-creation.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

api-integration.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

application-dependencies.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

application-programming-interfaces.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

best-python-podcasts.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

best-python-resources.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

best-python-videos.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

bots.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)