1
0
Fork 0
mirror of https://github.com/Oreolek/undum-docs.git synced 2024-06-26 03:40:52 +03:00

russian index

This commit is contained in:
Alexander Yakovlev 2014-07-24 17:34:16 +07:00
parent 160189c7cd
commit f3d25ff2ca
5 changed files with 60 additions and 84 deletions

5
AUTHORS.md Normal file
View file

@ -0,0 +1,5 @@
Authors
=======
Original book: Iam Millington <idmillington@googlemail.com>
Russian translation and DocBook conversion: Alexander Yakovlev <keloero@oreolek.ru>

View file

@ -1 +1,49 @@
# Документация Undum 2
# High Level Overview
Undum games are based around three concepts: Situations, Actions and
Qualities.
## Situations
A situation is a chunk of code that is responsible for adding content
to the screen and responding to user interaction. All user interaction
is performed by clicking links in the content.
Often a link will change the current situation, in which case another
situation is loaded, can write to the screen, and can begin responding
to user interaction. When a situation changes, all links that were
previously available are removed, so that the player can't unfairly go
back and try alternative options after committing to one. It is
possible to override this behavior, see the section on 'Sticky',
below.
There is always exactly one active situation. These situations, and
the links between them, form the structure of the game.
## Actions
A situation may offer the player a series of actions to perform. These
actions are internal to that situation and normally do not cause the
situation to change. Actions may output more content, including new
links for the user to select.
## Qualities
Qualities represent the current state of the character. Internally
they are all numeric values, able to take on any decimal value,
positive or negative. They have no meaning to Undum - they are given
meaning by your code as you perform calculations or make decisions
based on their value.
Qualities display themselves to the user through a formatting
function, which can turn the number into any kind of indicator: a
progress bar, a symbol, a word, an integer, and so on. So as far as
the user is concerned, qualities can represent any kind of value.
## Other Concepts
There are a handful of other elements to an Undum game, but they are
very much in a supporting role. Quality groups allow you to display a
set of qualities under a common heading; and character text is a short
chunk of HTML that you can use to summarize a character's qualities,
or to give hints.

View file

@ -1,4 +1,9 @@
# Summary
* [Javascript API](api.md)
* [Создавая игру на Undum](creating.md)
* [Неявный выбор](implicit.md)
* [HTML API](HTML.md)
* [Javascript API](API.md)
* [Перевод и интернационализация](i18n.md)
* [Загрузка и сохранение](files.md)

View file

@ -1,31 +0,0 @@
#Содержание
## [Общий обзор](introduction)
Описывает концепции игры Undum и их взаимодействие.
## [Создавая игру на Undum](creating)
Описывает файлы, которые вам надо создать, чтобы сделать игру на Undum, и что будет написано в них.
## [Неявный выбор](implicit)
Вторая версия Undum включает новый фреймворк для автоматической генерации вариантов выбора для игрока. Глава посвящена разметке ситуаций игры и условий для выбора.
## [HTML API](HTML)
Игры Undum используют HTML для вывода текста и медиа, но в рамках некоторых ограничений.
Undum также предоставляет стандартное поведение, привязанное к определённым HTML классам. Версия Undum 2 позволяет задавать многие ситуации в HTML, без помощи Javascript.
## [Javascript API](API)
Полный разбор API, доступного через Javascript. Детали по каждому методу, который вы можете вызвать для вывода содержимого, генерации случайных чисел и перевода игры на другие языки.
## [Перевод и интернационализация](i18n)
Этот раздел описывает ядро системы перевода Undum, и как вы можете писать игры с поддержкой нескольких языков.
## [Загрузка и сохранение](files)
Undum использует необычный способ загрузки и сохранения игр, чтобы поддерживать как можно больше браузеров, сайтов и стилей игры. В этой главе описываются технические детали, и как они влияют на вас как автора игры.

View file

@ -1,52 +1 @@
# High Level Overview
Undum games are based around three concepts: Situations, Actions and
Qualities.
## Situations
A situation is a chunk of code that is responsible for adding content
to the screen and responding to user interaction. All user interaction
is performed by clicking links in the content.
Often a link will change the current situation, in which case another
situation is loaded, can write to the screen, and can begin responding
to user interaction. When a situation changes, all links that were
previously available are removed, so that the player can't unfairly go
back and try alternative options after committing to one. It is
possible to override this behavior, see the section on 'Sticky',
below.
There is always exactly one active situation. These situations, and
the links between them, form the structure of the game.
## Actions
A situation may offer the player a series of actions to perform. These
actions are internal to that situation and normally do not cause the
situation to change. Actions may output more content, including new
links for the user to select.
## Qualities
Qualities represent the current state of the character. Internally
they are all numeric values, able to take on any decimal value,
positive or negative. They have no meaning to Undum - they are given
meaning by your code as you perform calculations or make decisions
based on their value.
Qualities display themselves to the user through a formatting
function, which can turn the number into any kind of indicator: a
progress bar, a symbol, a word, an integer, and so on. So as far as
the user is concerned, qualities can represent any kind of value.
## Other Concepts
There are a handful of other elements to an Undum game, but they are
very much in a supporting role. Quality groups allow you to display a
set of qualities under a common heading; and character text is a short
chunk of HTML that you can use to summarize a character's qualities,
or to give hints.