mirror of
https://github.com/minetest/contentdb.git
synced 2025-01-03 03:37:28 +01:00
Fix small typos in dev_intro
This commit is contained in:
parent
81a85cbbe5
commit
7fdd2cc7c9
@ -6,7 +6,7 @@ Developed by rubenwardy, license AGPLv3.0+.
|
|||||||
|
|
||||||
See [Getting Started](docs/getting_started.md) for setting up a development/prodiction environment.
|
See [Getting Started](docs/getting_started.md) for setting up a development/prodiction environment.
|
||||||
|
|
||||||
See [Developer's Intro](docs/dev_intro.md) for an overview of the code organisation.
|
See [Developer Intro](docs/dev_intro.md) for an overview of the code organisation.
|
||||||
|
|
||||||
## How-tos
|
## How-tos
|
||||||
|
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
# Developer's Introduction
|
# Developer Introduction
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
@ -9,10 +9,10 @@ When a user makes a request, Python Flask will direct the request to a *route* i
|
|||||||
A [blueprint](https://flask.palletsprojects.com/en/2.0.x/blueprints/) is a Flask construct to hold a set of routes.
|
A [blueprint](https://flask.palletsprojects.com/en/2.0.x/blueprints/) is a Flask construct to hold a set of routes.
|
||||||
Routes are implemented using Python, and likely to respond by using database *models* and rendering HTML *templates*.
|
Routes are implemented using Python, and likely to respond by using database *models* and rendering HTML *templates*.
|
||||||
|
|
||||||
Routes may also use functions in the `logic` module, which is a directory containing reusable functions. This
|
Routes may also use functions in the `app/logic/` module, which is a directory containing reusable functions. This
|
||||||
allows the API, asynchronous tasks, and the front-end to reuse code.
|
allows the API, background tasks, and the front-end to reuse code.
|
||||||
|
|
||||||
To avoid blocking web requests, background jobs run as
|
To avoid blocking web requests, background tasks run as
|
||||||
[Celery](https://docs.celeryproject.org/en/stable/getting-started/introduction.html) tasks.
|
[Celery](https://docs.celeryproject.org/en/stable/getting-started/introduction.html) tasks.
|
||||||
|
|
||||||
|
|
||||||
@ -22,10 +22,10 @@ To avoid blocking web requests, background jobs run as
|
|||||||
|
|
||||||
The `app` directory contains the Python Flask application.
|
The `app` directory contains the Python Flask application.
|
||||||
|
|
||||||
* `blueprints` contains all the Python code behind each endpoint.
|
* `blueprints` contains all the Python code behind each endpoint / route.
|
||||||
* `templates` contains all the HTML templates used to generate responses. Each directory in here matches a director in blueprints.
|
* `templates` contains all the HTML templates used to generate responses. Each directory in here matches a directory in blueprints.
|
||||||
* `models` contains all the Database table classes. ContentDB uses [SQLAlchemy](https://docs.sqlalchemy.org/en/14/) to interact with PostgreSQL.
|
* `models` contains all the database table classes. ContentDB uses [SQLAlchemy](https://docs.sqlalchemy.org/en/14/) to interact with PostgreSQL.
|
||||||
* `flatpages` contains all the markdown user documentation, including `/help`.
|
* `flatpages` contains all the markdown user documentation, including `/help/`.
|
||||||
* `public` contains files that should be added to the web server unedited. Examples include CSS libraries, images, and JS scripts.
|
* `public` contains files that should be added to the web server unedited. Examples include CSS libraries, images, and JS scripts.
|
||||||
* `scss` contains the stylesheet files, that are compiled into CSS.
|
* `scss` contains the stylesheet files, that are compiled into CSS.
|
||||||
* `tasks` contains the background tasks executed by [Celery](https://docs.celeryproject.org/en/stable/getting-started/introduction.html).
|
* `tasks` contains the background tasks executed by [Celery](https://docs.celeryproject.org/en/stable/getting-started/introduction.html).
|
||||||
@ -61,7 +61,7 @@ A permission may be something like `Permission.EDIT_PACKAGE` or `Permission.DELE
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
if not package.checkPerm(current_user, Permission.EDIT_PACKAGE):
|
if not package.checkPerm(current_user, Permission.EDIT_PACKAGE):
|
||||||
abort(403)
|
abort(403)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
@ -55,4 +55,4 @@ To hot/live update CDB whilst it is running, use:
|
|||||||
|
|
||||||
This will only work with python code and templates, it won't update tasks or config.
|
This will only work with python code and templates, it won't update tasks or config.
|
||||||
|
|
||||||
Now consider reading the [Developer's Introduction](dev_intro.md).
|
Now consider reading the [Developer Introduction](dev_intro.md).
|
||||||
|
Loading…
Reference in New Issue
Block a user