# Začněte s Total.js

> Instalace Total.js 5 vytvoří startovací skript a první trasy, akce a zobrazení a spustí aplikaci.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: cs
Content-SHA256: c77eedf9ace2db0eb0ce420ffa9b81910889f376a2e561555588156341ed2645
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Total.js 5 je npm balíček `total5`. Potřebujete Node.js (příklady na tomto webu běží na Node.js 24) a prázdnou složku. Vytvořte projekt a nainstalujte balíček:

```bash
mkdir hello && cd hello
npm init -y
npm install total5
```

Spouštěcí skript je soubor s názvem `index.js` v kořenu projektu. Načte framework a spustí server:

```js
require('total5');

Total.run({ port: 8000 });
```

To je veškerý kód, který pro start napíšete. Soubory ve složkách projektu (viz stránka o struktuře projektu) se načtou automaticky. Vytvořte tyto tři soubory.

**Kontroler** deklaruje routy. `ROUTE('GET /')` bez obsluhy by zobrazil pohled se stejným názvem; zde obsluha vykreslí `views/index.html` s modelem:

```js controllers/index.js
exports.install = function() {
	ROUTE('GET /', home);
	ROUTE('POST /greet/ --> *Greet/say');
};

function home($) {
	$.view('index', { title: 'Hello Total.js' });
}
```

**Akce** má vlastní validaci. Uvedená routa spustí `Greet/say` s JSON tělem požadavku a framework odmítne tělo, které neodpovídá `input`:

```js definitions/greet.js
NEWACTION('Greet/say', {
	name: 'Say hello',
	input: '*name:String',
	action: function($, model) {
		$.callback({ message: 'Hello, ' + model.name + '!' });
	}
});
```

**Pohled** je HTML s bloky `@{...}`. `views/layout.html` obaluje každý pohled a `@{body}` je místo pohledu:

```html views/layout.html
<!DOCTYPE html>
<html>
<head><meta charset="utf-8" /><title>Hello</title></head>
<body>@{body}</body>
</html>
```

```html views/index.html
<h1>@{model.title}</h1>
```

Spusťte aplikaci příkazem `node index.js`. Ve výchozím režimu `debug` se aplikace po změně souboru restartuje a vypíše svou adresu do terminálu. Režim `release` spustíte příkazem `node index.js --release`. Rozdíly popisuje průvodce režimy spouštění.