v/tutorials/building-a-simple-web-blog-...

## Building a 150 KB web blog in V with 0 dependencies

Hello,

In this guide, we'll build a simple web blog in V.

The benefits of using V for web:
- A safe, fast, language with the development agility of Python or Ruby and
the performance of C.
- Zero dependencies: everything you need for web development comes with the language
in a 1 MB package.
- Very small resulting binaries: the blog we'll create in this tutorial is about 150 KB.
- Easy deployments: a single binary file that even  includes the precompiled templates.
- Runs on the cheapest hardware with minimum footprint: for most apps a $3 instance
is enough.
- Fast development without any boilerplate.

*Please note that V and Vweb are at a very early stage and are changing rapidly.*

The code is available <a href='https://github.com/vlang/v/tree/master/tutorials/code/blog'>here</a>.


### Installing V

```
wget https://github.com/vlang/v/releases/latest/download/v_linux.zip
unzip v_linux.zip
cd v
sudo ./v symlink
```

Now V should be globally available on your system.

> On macOS use `v_macos.zip`, on Windows - `v_windows.zip`.
If you use a BSD system, Solaris, Android, or simply want to install V
from source, follow the simple instructions here:
https://github.com/vlang/v#installing-v-from-source


### Install SQLite development dependency

If you don't have it already installed, look at the
[`sqlite` README](../vlib/sqlite/README.md) for instructions.


### Creating a new Vweb project

V projects can be created anywhere and don't need to have a certain structure:

```bash
mkdir blog
cd blog
touch blog.v
```

First, let's create a simple hello world website:

```v
// blog.v
module main

import vweb

struct App {
	vweb.Context
}

fn main() {
	vweb.run<App>(8081)
}

pub fn (mut app App) index() vweb.Result {
	return app.text('Hello world from vweb!')
}

pub fn (app &App) init() {
}

pub fn (app &App) init_once() {
}
```

Run it with

```bash
v run blog.v
```

```
Running a Vweb app on http://localhost:8081 ...
```

Vweb helpfully provided a link, open http://localhost:8081/ in your browser:

<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/hello.png?raw=true">

The `App` struct is an entry point of our web application. If you have experience
with an MVC web framework, you can think of it as a controller. (Vweb is
not an MVC framework however.) It embeds the vweb Context object, that's why we get access
to methods like `.text()`.


As you can see, there are no routing rules. The `index()` action handles the `/` request by default.
Vweb often uses convention over configuration and adding a new action requires
no routing rules either:

```v oksyntax
import vweb
import time

fn (mut app App) time() vweb.Result {
	return app.text(time.now().format())
}
```


<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/time.png?raw=true">

>You have to rebuild and restart the website every time you change the code.
In the future, Vweb will detect changes and recompile the website in the background
while it's running.

The `.text(string)` method returns a plain text document with the provided
text, which isn't frequently used in websites.


### HTML View

Let's return an HTML view instead. Create `index.html` in the same directory:

```html
<html>
<head>
	<title>V Blog</title>
</head>
<body>
	<b>@message</b>
	<br>
	<img src='https://vlang.io/img/v-logo.png' width=100>
</body>
</html>
```

and update our `index()` action so that it returns the HTML view we just created:

```v ignore
pub fn (mut app App) index() vweb.Result {
	message := 'Hello, world from Vweb!'
	return $vweb.html()
}
```

<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/hello_html.png?raw=true">

Good, now we have an actual HTML page.

The V template language is similar to C#'s Razor: `@message` prints the value
of `message`.

You may notice something unusual: the `message` variable created in the `index()`
action is automatically available in the view.

It's another feature of Vweb to reduce the boilerplate in your web apps.
No need to create view models just to pass data, or use an unsafe and untyped
alternative, like C#'s `ViewBag["message"]`.

Making all action variables available in the view may seem crazy,
but V is a language with pure functions by default, and you won't be able
to modify any data from a view. `<b>@foo.bar()</b>` will only work if the `bar()` method
doesn't modify `foo`.

The HTML template is compiled to V during the compilation of the website,
that's done by the `$vweb.html()` line.
(`$` always means compile time actions in V.) offering the following benefits:

- Great performance, since the templates don't need to be compiled
on every request, like in almost every major web framework.

- Easier deployment, since all your HTML templates are  compiled
into a single binary file together with the web application itself.

- All errors in the templates are guaranteed to be caught during compilation.


### Fetching data with V ORM

Now let's display some articles!

We'll be using V's builtin ORM and a SQLite database.
(V ORM will also support MySQL, Postgre, and SQL Server soon.)

Create a SQLite file with the schema:
```sql
drop table if exists Article;

create table Article (
	id integer primary key,
	title text default "",
	text text default ""
);

insert into Article (title, text) values (
	"Hello, world!",
	"V is great."
);

insert into Article (title, text) values (
	"Second post.",
	"Hm... what should I write about?"
);
```

Run the file with `sqlite3 blog.db < blog.sqlite`.


Add a SQLite handle to `App`:

```v oksyntax
import sqlite
import vweb

struct App {
pub mut:
	vweb vweb.Context
	db   sqlite.DB
}
```


Modify the `init_once()` method we created earlier to connect to a database:

```v oksyntax
pub fn (mut app App) init_once() {
	db := sqlite.connect(':memory:') or { panic(err) }
	db.exec('create table `Article` (id integer primary key, title text default "", text text default "")')
	db.exec('insert into Article (title, text) values ("Hello, world!", "V is great.")')
	db.exec('insert into Article (title, text) values ("Second post.", "Hm... what should I write about?")')
	app.db = db
}
```

Code in the `init_once()` function is run only once during app's startup, so we are going
to have one DB connection for all requests.

Create a new file `article.v`:


```v oksyntax
// article.v
module main

struct Article {
	id    int
	title string
	text  string
}

pub fn (app &App) find_all_articles() []Article {
	return sql app.db {
		select from Article
	}
}
```

Let's fetch the articles in the `index()` action:

```v ignore
pub fn (app &App) index() vweb.Result {
	articles := app.find_all_articles()
	return $vweb.html()
}
```


Finally, let's update our view:

```html
<body>
	@for article in articles
		<div>
			<b>@article.title</b> <br>
			@article.text
		</div>
	@end
</body>
```

```bash
v run .
```

<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/articles1.png?raw=true">

That was very simple, wasn't it?

The built-in V ORM uses a syntax very similar to SQL. The queries are built with V.
For example, if we only wanted to find articles with ids between 100 and 200, we'd do:

```v oksyntax
return sql app.db {
	select from Article where id >= 100 && id <= 200
}
```

Retrieving a single article is very simple:

```v oksyntax
pub fn (app &App) retrieve_article() ?Article {
	return sql app.db {
		select from Article limit 1
	}
}
```

V ORM uses V's optionals for single values, which is very useful, since
bad queries will always be handled by the developer:

```v oksyntax
article := app.retrieve_article(10) or {
	app.text('Article not found')
	return
}
```


### Adding new articles

Create `new.html`:

```html
<html>
<head>
	<title>V Blog</title>
</head>
<body>
	<form action='/new_article' method='post'>
		<input type='text' placeholder='Title' name='title'> <br>
		<textarea placeholder='Text' name='text'></textarea>
		<input type='submit'>
	</form>
</body>
</html>
```

```v oksyntax
import vweb

pub fn (mut app App) new_article() vweb.Result {
	title := app.form['title']
	text := app.form['text']
	if title == '' || text == '' {
		return app.text('Empty text/title')
	}
	article := Article{
		title: title
		text: text
	}
	println(article)
	sql app.db {
		insert article into Article
	}
	return app.redirect('/')
}
```

> Untyped `form['key']` is temporary. Very soon Vweb will accept query and form
parameters via function arguments: `new_article(title, text string) {`.

We need to update `index.html` to add a link to the "new article" page:

```html
<a href='/new'>New article</a>
```


### JSON endpoints

This tutorial used the traditional server-side rendering. If you prefer
to render everything on the client or need an API, creating JSON endpoints
in V is very simple:

```v oksyntax
import vweb
import json

pub fn (mut app App) articles() vweb.Result {
	articles := app.find_all_articles()
	return app.json(json.encode(articles))
}
```

<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/articles_json.png?raw=true">


To be continued...

For an example of a more sophisticated web app written in V, check out Vorum: https://github.com/vlang/vorum
tutorial: add a title 2019-12-14 05:39:51 +01:00			`## Building a 150 KB web blog in V with 0 dependencies`

vweb tutorial 2019-12-14 03:31:09 +01:00			`Hello,`

tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`In this guide, we'll build a simple web blog in V.`
vweb tutorial 2019-12-14 03:31:09 +01:00
			`The benefits of using V for web:`
tutorial: change speed to agility (#5590) 2020-07-01 10:30:22 +02:00			`- A safe, fast, language with the development agility of Python or Ruby and`
vweb tutorial 2019-12-14 03:31:09 +01:00			`the performance of C.`
			`- Zero dependencies: everything you need for web development comes with the language`
			`in a 1 MB package.`
			`- Very small resulting binaries: the blog we'll create in this tutorial is about 150 KB.`
			`- Easy deployments: a single binary file that even includes the precompiled templates.`
tutorial: minor fixes 2019-12-14 05:36:18 +01:00			`- Runs on the cheapest hardware with minimum footprint: for most apps a $3 instance`
vweb tutorial 2019-12-14 03:31:09 +01:00			`is enough.`
vweb tutorial: add a link to Vorum 2019-12-14 06:24:14 +01:00			`- Fast development without any boilerplate.`
vweb tutorial 2019-12-14 03:31:09 +01:00
			`Please note that V and Vweb are at a very early stage and are changing rapidly.`

tutorial: minor fixes + move code and images to a separate dir 2019-12-14 16:50:25 +01:00			`The code is available <a href='https://github.com/vlang/v/tree/master/tutorials/code/blog'>here</a>.`
tutorial: minor fixes 2019-12-14 05:36:18 +01:00
vweb tutorial 2019-12-14 03:31:09 +01:00
			`### Installing V`

			```
tutorial: update the wget line in the instructions, to use v_linux.zip too (#8069) I think the right URL is https://github.com/vlang/v/releases/latest/download/v_linux.zip with a "v". Regards. 2021-01-12 20:27:00 +01:00			`wget https://github.com/vlang/v/releases/latest/download/v_linux.zip`
doc: mention module shadowing (#7051) 2020-12-01 16:09:33 +01:00			`unzip v_linux.zip`
vweb tutorial 2019-12-14 03:31:09 +01:00			`cd v`
			`sudo ./v symlink`
			```

			`Now V should be globally available on your system.`

doc: mention module shadowing (#7051) 2020-12-01 16:09:33 +01:00			> On macOS use `v_macos.zip`, on Windows - `v_windows.zip`.
vweb tutorial 2019-12-14 03:31:09 +01:00			`If you use a BSD system, Solaris, Android, or simply want to install V`
			`from source, follow the simple instructions here:`
			`https://github.com/vlang/v#installing-v-from-source`


sqlite: add Windows instructions to readme (#7041) 2020-12-01 04:00:41 +01:00			`### Install SQLite development dependency`

			`If you don't have it already installed, look at the`
			[`sqlite` README](../vlib/sqlite/README.md) for instructions.


vweb tutorial 2019-12-14 03:31:09 +01:00			`### Creating a new Vweb project`

tutorial: minor fixes 2019-12-14 05:36:18 +01:00			`V projects can be created anywhere and don't need to have a certain structure:`
vweb tutorial 2019-12-14 03:31:09 +01:00
			```bash
			`mkdir blog`
			`cd blog`
			`touch blog.v`
			```

tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`First, let's create a simple hello world website:`
vweb tutorial 2019-12-14 03:31:09 +01:00
			```v
			`// blog.v`
			`module main`

tutorials: update import syntax 2020-05-20 14:21:30 +02:00			`import vweb`
vweb tutorial 2019-12-14 03:31:09 +01:00
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`struct App {`
tutorials: update vweb 2020-12-31 17:31:17 +01:00			`vweb.Context`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`

			`fn main() {`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`vweb.run<App>(8081)`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`

tutorials: fix index() (#5732) 2020-07-07 22:01:18 +02:00			`pub fn (mut app App) index() vweb.Result {`
vweb: remove `return vweb.Result{}` everywhere 2021-01-08 04:57:02 +01:00			`return app.text('Hello world from vweb!')`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`

check-md: verify code example formatting (#7143) 2020-12-05 22:54:41 +01:00			`pub fn (app &App) init() {`
			`}`

			`pub fn (app &App) init_once() {`
			`}`
vweb tutorial 2019-12-14 03:31:09 +01:00			```

			`Run it with`

			```bash
			`v run blog.v`
			```

tutorial: minor fixes 2019-12-14 16:59:02 +01:00			```
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`Running a Vweb app on http://localhost:8081 ...`
tutorial: minor fixes 2019-12-14 16:59:02 +01:00			```

tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`Vweb helpfully provided a link, open http://localhost:8081/ in your browser:`
vweb tutorial 2019-12-14 03:31:09 +01:00
tutorial: update image links 2019-12-14 17:26:22 +01:00			`<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/hello.png?raw=true">`
vweb tutorial 2019-12-14 03:31:09 +01:00
			The `App` struct is an entry point of our web application. If you have experience
			`with an MVC web framework, you can think of it as a controller. (Vweb is`
tutorials: update vweb 2020-12-31 17:31:17 +01:00			`not an MVC framework however.) It embeds the vweb Context object, that's why we get access`
			to methods like `.text()`.

vweb tutorial 2019-12-14 03:31:09 +01:00
			As you can see, there are no routing rules. The `index()` action handles the `/` request by default.
tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`Vweb often uses convention over configuration and adding a new action requires`
vweb tutorial 2019-12-14 03:31:09 +01:00			`no routing rules either:`

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
docs: fix most of the examples (ensure they at least have a valid syntax) 2020-11-27 12:03:32 +01:00			`import vweb`
check-md: verify code example formatting (#7143) 2020-12-05 22:54:41 +01:00			`import time`

building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`fn (mut app App) time() vweb.Result {`
vweb: remove `return vweb.Result{}` everywhere 2021-01-08 04:57:02 +01:00			`return app.text(time.now().format())`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```


tutorial: update image links 2019-12-14 17:26:22 +01:00			`<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/time.png?raw=true">`
vweb tutorial 2019-12-14 03:31:09 +01:00
			`>You have to rebuild and restart the website every time you change the code.`
tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`In the future, Vweb will detect changes and recompile the website in the background`
vweb tutorial 2019-12-14 03:31:09 +01:00			`while it's running.`

tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			The `.text(string)` method returns a plain text document with the provided
vweb tutorial 2019-12-14 03:31:09 +01:00			`text, which isn't frequently used in websites.`


			`### HTML View`

			Let's return an HTML view instead. Create `index.html` in the same directory:

			```html
			`<html>`
building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`<head>`
vweb tutorial 2019-12-14 03:31:09 +01:00			`<title>V Blog</title>`
building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`</head>`
vweb tutorial 2019-12-14 03:31:09 +01:00			`<body>`
			`<b>@message</b>`
			`<br>`
			`<img src='https://vlang.io/img/v-logo.png' width=100>`
			`</body>`
			`</html>`
			```

			and update our `index()` action so that it returns the HTML view we just created:

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v ignore
tutorials: fix index() (#5732) 2020-07-07 22:01:18 +02:00			`pub fn (mut app App) index() vweb.Result {`
vweb tutorial 2019-12-14 03:31:09 +01:00			`message := 'Hello, world from Vweb!'`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`return $vweb.html()`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```

tutorial: update image links 2019-12-14 17:26:22 +01:00			`<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/hello_html.png?raw=true">`
vweb tutorial 2019-12-14 03:31:09 +01:00
			`Good, now we have an actual HTML page.`

			The V template language is similar to C#'s Razor: `@message` prints the value
			of `message`.

			You may notice something unusual: the `message` variable created in the `index()`
			`action is automatically available in the view.`

			`It's another feature of Vweb to reduce the boilerplate in your web apps.`
			`No need to create view models just to pass data, or use an unsafe and untyped`
			alternative, like C#'s `ViewBag["message"]`.

tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`Making all action variables available in the view may seem crazy,`
vweb tutorial 2019-12-14 03:31:09 +01:00			`but V is a language with pure functions by default, and you won't be able`
			to modify any data from a view. `<b>@foo.bar()</b>` will only work if the `bar()` method
			doesn't modify `foo`.

sqlite: add Windows instructions to readme (#7041) 2020-12-01 04:00:41 +01:00			`The HTML template is compiled to V during the compilation of the website,`
docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			that's done by the `$vweb.html()` line.
vweb tutorial 2019-12-14 03:31:09 +01:00			(`$` always means compile time actions in V.) offering the following benefits:

			`- Great performance, since the templates don't need to be compiled`
			`on every request, like in almost every major web framework.`

			`- Easier deployment, since all your HTML templates are compiled`
			`into a single binary file together with the web application itself.`

			`- All errors in the templates are guaranteed to be caught during compilation.`

tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00
vweb tutorial 2019-12-14 03:31:09 +01:00			`### Fetching data with V ORM`

			`Now let's display some articles!`

sqlite: add Windows instructions to readme (#7041) 2020-12-01 04:00:41 +01:00			`We'll be using V's builtin ORM and a SQLite database.`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`(V ORM will also support MySQL, Postgre, and SQL Server soon.)`
vweb tutorial 2019-12-14 03:31:09 +01:00
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`Create a SQLite file with the schema:`
vweb tutorial 2019-12-14 03:31:09 +01:00			```sql
tutorials: fix index() (#5732) 2020-07-07 22:01:18 +02:00			`drop table if exists Article;`
vweb tutorial 2019-12-14 03:31:09 +01:00
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`create table Article (`
			`id integer primary key,`
			`title text default "",`
			`text text default ""`
vweb tutorial 2019-12-14 03:31:09 +01:00			`);`

tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`insert into Article (title, text) values (`
			`"Hello, world!",`
			`"V is great."`
vweb tutorial 2019-12-14 03:31:09 +01:00			`);`

tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`insert into Article (title, text) values (`
			`"Second post.",`
			`"Hm... what should I write about?"`
vweb tutorial 2019-12-14 03:31:09 +01:00			`);`
			```

tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			Run the file with `sqlite3 blog.db < blog.sqlite`.
vweb tutorial 2019-12-14 03:31:09 +01:00

tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			Add a SQLite handle to `App`:
vweb tutorial 2019-12-14 03:31:09 +01:00
docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`import sqlite`
docs: fix most of the examples (ensure they at least have a valid syntax) 2020-11-27 12:03:32 +01:00			`import vweb`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00
vweb tutorial 2019-12-14 03:31:09 +01:00			`struct App {`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`pub mut:`
vweb tutorial 2019-12-14 03:31:09 +01:00			`vweb vweb.Context`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`db sqlite.DB`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```



tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			Modify the `init_once()` method we created earlier to connect to a database:
vweb tutorial 2019-12-14 03:31:09 +01:00
docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`pub fn (mut app App) init_once() {`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`db := sqlite.connect(':memory:') or { panic(err) }`
			db.exec('create table `Article` (id integer primary key, title text default "", text text default "")')
			`db.exec('insert into Article (title, text) values ("Hello, world!", "V is great.")')`
			`db.exec('insert into Article (title, text) values ("Second post.", "Hm... what should I write about?")')`
vweb tutorial 2019-12-14 03:31:09 +01:00			`app.db = db`
			`}`
			```

tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			Code in the `init_once()` function is run only once during app's startup, so we are going
vweb tutorial 2019-12-14 03:31:09 +01:00			`to have one DB connection for all requests.`

			Create a new file `article.v`:


docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`// article.v`
vweb tutorial 2019-12-14 03:31:09 +01:00			`module main`

			`struct Article {`
			`id int`
			`title string`
			`text string`
			`}`

for: check for redefinitions 2019-12-14 17:58:55 +01:00			`pub fn (app &App) find_all_articles() []Article {`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`return sql app.db {`
			`select from Article`
			`}`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```

			Let's fetch the articles in the `index()` action:

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v ignore
tutorials: fix index() (#5732) 2020-07-07 22:01:18 +02:00			`pub fn (app &App) index() vweb.Result {`
vweb tutorial 2019-12-14 03:31:09 +01:00			`articles := app.find_all_articles()`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`return $vweb.html()`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```


			`Finally, let's update our view:`

			```html
			`<body>`
			`@for article in articles`
			`<div>`
			`<b>@article.title</b> <br>`
			`@article.text`
			`</div>`
			`@end`
			`</body>`
			```

			```bash
			`v run .`
			```

tutorial: update image links 2019-12-14 17:26:22 +01:00			`<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/articles1.png?raw=true">`
vweb tutorial 2019-12-14 03:31:09 +01:00
			`That was very simple, wasn't it?`

			`The built-in V ORM uses a syntax very similar to SQL. The queries are built with V.`
			`For example, if we only wanted to find articles with ids between 100 and 200, we'd do:`

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`return sql app.db {`
			`select from Article where id >= 100 && id <= 200`
			`}`
vweb tutorial 2019-12-14 03:31:09 +01:00			```

			`Retrieving a single article is very simple:`

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
vweb tutorial 2019-12-14 03:31:09 +01:00			`pub fn (app &App) retrieve_article() ?Article {`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`return sql app.db {`
			`select from Article limit 1`
			`}`
vweb tutorial 2019-12-14 03:31:09 +01:00			`}`
			```

			`V ORM uses V's optionals for single values, which is very useful, since`
			`bad queries will always be handled by the developer:`

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
vweb tutorial 2019-12-14 03:31:09 +01:00			`article := app.retrieve_article(10) or {`
tutorials: update vweb 2020-12-31 17:31:17 +01:00			`app.text('Article not found')`
vweb tutorial 2019-12-14 03:31:09 +01:00			`return`
			`}`
			```


tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`### Adding new articles`

			Create `new.html`:

			```html
			`<html>`
building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`<head>`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`<title>V Blog</title>`
building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`</head>`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`<body>`
			`<form action='/new_article' method='post'>`
			`<input type='text' placeholder='Title' name='title'> <br>`
			`<textarea placeholder='Text' name='text'></textarea>`
			`<input type='submit'>`
			`</form>`
			`</body>`
			`</html>`
			```

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
docs: fix most of the examples (ensure they at least have a valid syntax) 2020-11-27 12:03:32 +01:00			`import vweb`
check-md: verify code example formatting (#7143) 2020-12-05 22:54:41 +01:00
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`pub fn (mut app App) new_article() vweb.Result {`
tutorials: update vweb 2020-12-31 17:31:17 +01:00			`title := app.form['title']`
			`text := app.form['text']`
check-md: verify code example formatting (#7143) 2020-12-05 22:54:41 +01:00			`if title == '' \|\| text == '' {`
vweb: remove `return vweb.Result{}` everywhere 2021-01-08 04:57:02 +01:00			`return app.text('Empty text/title')`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`}`
			`article := Article{`
			`title: title`
			`text: text`
			`}`
tutorials: more blog fixes (#5657) 2020-07-04 18:56:18 +02:00			`println(article)`
tutorials: update markdown guide (#5589) 2020-07-01 00:45:19 +02:00			`sql app.db {`
			`insert article into Article`
			`}`
vweb: remove `return vweb.Result{}` everywhere 2021-01-08 04:57:02 +01:00			`return app.redirect('/')`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`}`
			```

			> Untyped `form['key']` is temporary. Very soon Vweb will accept query and form
			parameters via function arguments: `new_article(title, text string) {`.

			We need to update `index.html` to add a link to the "new article" page:
tutorials: article json 2019-12-14 23:00:04 +01:00
			```html
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`<a href='/new'>New article</a>`
tutorials: article json 2019-12-14 23:00:04 +01:00			```
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00


			`### JSON endpoints`

tutorial: Improve grammar 2020-01-18 17:03:47 +01:00			`This tutorial used the traditional server-side rendering. If you prefer`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`to render everything on the client or need an API, creating JSON endpoints`
			`in V is very simple:`

docs_ci: check all md files except thirdparty (#6855) 2020-11-18 18:28:28 +01:00			```v oksyntax
docs: fix most of the examples (ensure they at least have a valid syntax) 2020-11-27 12:03:32 +01:00			`import vweb`
check-md: verify code example formatting (#7143) 2020-12-05 22:54:41 +01:00			`import json`

building-a-simple-web-blog-with-vweb.md: fix bugs in code snippets (#5990) 2020-07-28 10:29:51 +02:00			`pub fn (mut app App) articles() vweb.Result {`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`articles := app.find_all_articles()`
vweb: remove `return vweb.Result{}` everywhere 2021-01-08 04:57:02 +01:00			`return app.json(json.encode(articles))`
tutorials: vweb: add an article 2019-12-14 22:55:05 +01:00			`}`
			```

			`<img width=662 src="https://github.com/vlang/v/blob/master/tutorials/img/articles_json.png?raw=true">`



add ./v2 to gitignore 2019-12-16 23:21:10 +01:00			`To be continued...`
vweb tutorial 2019-12-14 03:31:09 +01:00
vweb tutorial: add a link to Vorum 2019-12-14 06:24:14 +01:00			`For an example of a more sophisticated web app written in V, check out Vorum: https://github.com/vlang/vorum`