mirror of https://github.com/mitsuhiko/flask.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
66 lines
2.0 KiB
66 lines
2.0 KiB
.. _tutorial: |
|
|
|
Tutorial |
|
======== |
|
|
|
.. toctree:: |
|
:caption: Contents: |
|
:maxdepth: 1 |
|
|
|
layout |
|
factory |
|
database |
|
views |
|
templates |
|
static |
|
blog |
|
install |
|
tests |
|
deploy |
|
next |
|
|
|
This tutorial will walk you through creating a basic blog application |
|
called Flaskr. Users will be able to register, log in, create posts, |
|
and edit or delete their own posts. You will be able to package and |
|
install the application on other computers. |
|
|
|
.. image:: flaskr_index.png |
|
:align: center |
|
:class: screenshot |
|
:alt: screenshot of index page |
|
|
|
It's assumed that you're already familiar with Python. The `official |
|
tutorial`_ in the Python docs is a great way to learn or review first. |
|
|
|
.. _official tutorial: https://docs.python.org/3/tutorial/ |
|
|
|
While it's designed to give a good starting point, the tutorial doesn't |
|
cover all of Flask's features. Check out the :ref:`quickstart` for an |
|
overview of what Flask can do, then dive into the docs to find out more. |
|
The tutorial only uses what's provided by Flask and Python. In another |
|
project, you might decide to use :ref:`extensions` or other libraries to |
|
make some tasks simpler. |
|
|
|
.. image:: flaskr_login.png |
|
:align: center |
|
:class: screenshot |
|
:alt: screenshot of login page |
|
|
|
Flask is flexible. It doesn't require you to use any particular project |
|
or code layout. However, when first starting, it's helpful to use a more |
|
structured approach. This means that the tutorial will require a bit of |
|
boilerplate up front, but it's done to avoid many common pitfalls that |
|
new developers encounter, and it creates a project that's easy to expand |
|
on. Once you become more comfortable with Flask, you can step out of |
|
this structure and take full advantage of Flask's flexibility. |
|
|
|
.. image:: flaskr_edit.png |
|
:align: center |
|
:class: screenshot |
|
:alt: screenshot of login page |
|
|
|
:gh:`The tutorial project is available as an example in the Flask |
|
repository <examples/tutorial>`, if you want to compare your project |
|
with the final product as you follow the tutorial. |
|
|
|
Continue to :doc:`layout`.
|
|
|