Twine 2 руководство: Twine 2. Обзор и руководство для начинающих

Допустим, вы хотите создать игру, в которой вы спрашиваете имя игрока, а затем даете индивидуальный отзыв, если узнаете его.

В первом отрывке используйте встроенный код SugarCube для отображения текстового поля и вставки всего, что игрок пишет в переменную:

Введите ваше имя:
<< текстовое поле "$ name" "" >>
Когда будете готовы, щелкните [[здесь]].
 

Этот код указывает, что все, что игрок вводит в текстовое поле, будет сохранено в переменной с именем $ name («» просто означает, что в поле нет текста по умолчанию - если вы написали «Введите свое имя здесь» в этом поле. , текстовое поле изначально будет отображаться с надписью «Введите здесь свое имя».)

Теперь, на следующей странице, вы можете настроить так, чтобы ваша игра отображала специальное сообщение, если кто-то ввел свое имя как «Адам».

<< если $ name - "Адам" >> Эй, тебя зовут Адам! Так и мое!
<> Привет, $ name.
<>
 

Twine будет отображать только «Эй, тебя зовут Адам! Как и мое! » если переменная $ name равна «Адам». В противном случае - <> - он просто скажет «Привет» и повторит имя человека в ответ (да, это классная вещь о переменных.Если вы запишете имя переменной в обычный текст, Twine заменит его значением переменной, когда он действительно показывает его игроку.)

Допустим, вы хотите, чтобы ваша игра фиксировала текущий подсчет того, насколько «счастлив» ваш игрок. Вы можете сделать это с помощью числовой переменной. Например, в начале игры вы можете включить:

<< установить для $ счастья значение 0 >>
 

Затем, когда что-то происходит, чтобы сделать вашего игрока счастливым, вы можете включить эту строку:

<< установить $ Счастье в $ Счастье + 1 >>
 

Если в этом проходе уровень счастья игрока равен нулю, эта строка кода установит его на 1 (0 + 1 = 1).Если уровень счастья игрока равен 3, эта строка кода установит его на 4 (3 + 1 = 4). Причина, по которой вы не хотите, чтобы эта строка была << установкой $ счастья на 1 >>, заключается в том, что это сотрет все ваши «текущие подсчеты» и просто установит значение счастья на 1, независимо от того, насколько счастливы ваш игрок был до того, как наткнулся на этот конкретный отрывок.

Когда что-то случится, что расстроит вашего игрока, вы можете включить эту строку кода:

<< установить $ Счастье в $ Счастье - 1 >>
 

Позже, допустим, вашему игроку позвонил друг.Если их уровень счастья выше определенного порога, они решают пойти за мороженым. Если их уровень счастья ниже этого порога, они не берут трубку и остаются внутри. Вы можете закодировать это следующим образом:

<< if $ Счастье gte 5 >> Вы берете трубку, и она просит вас принести мороженое, и вы [[полностью уходите]].
<> Тебе не хочется брать трубку. Думаю, ты никогда не узнаешь, о чем она хотела тебя спросить. Вы [[сидите дома]].
<>
 

Здесь, если ваша переменная $ счастья имеет значение 5 или выше (gte - SugarCube, говоря «больше или равно»), ваш игрок получит возможность перейти к проходу с мороженым.В противном случае - <> - их единственный выход - перейти к переходу «оставайся дома».

Это всего лишь несколько примеров для начала. Если вас это взволновало, вам стоит ознакомиться с полным списком макросов SugarCube 2.x.

Вот и все! А теперь вперед и создавайте потрясающие игры Twine !!!

Добро пожаловать в документацию по шпагату! - документация twine 3.4.1

Обеспечивает независимую загрузку исходных и двоичных файлов от системы сборки. артефакты распространения как новых, так и существующих проекты.

Цель Twine - улучшить взаимодействие PyPI за счет улучшения безопасность и тестируемость.

Самая большая причина использовать Twine заключается в том, что он надежно аутентифицирует вы к PyPI через HTTPS, используя проверенное соединение, независимо от базовая версия Python. Между тем, python setup.py загрузить будет работать правильно и безопасно только в том случае, если ваша система сборки Python версия и соответствующая операционная система настроены правильно.

Во-вторых, Twine рекомендует вам создавать свои файлы распространения. питон setup.py upload позволяет загружать пакет только в качестве последнего шага после сборка с distutils или setuptools в рамках той же команды призыв. Это означает, что вы не можете протестировать именно тот файл, который собираетесь загрузите в PyPI, чтобы убедиться, что он работает, перед загрузкой.

Наконец, Twine позволяет предварительно подписывать файлы и передавать .asc файлов в вызов командной строки (загрузка шпагата myproject-1.0.1.tar.gz myproject-1.0.1.tar.gz.asc ). Это позволяет вам чтобы быть уверенным, что вы вводите кодовую фразу gpg в код gpg сам, а не что-либо еще, так как вы будете непосредственно выполнение gpg --detach-sign -a <имя файла> .

1. Создайте несколько дистрибутивов обычным способом:

    $ ​​python setup.py sdist bdist_wheel
    

2. Загрузите со шпагатом для тестирования PyPI и убедитесь, что все работает правильно.Twine автоматически запросит ваше имя пользователя и пароль:

    $ ​​загрузка шпагата -r testpypi dist / *
   имя пользователя: ...
   пароль:
   ...
    

3. Загрузить в PyPI:

4. Готово!

Дополнительная документация по использованию Twine для загрузки пакетов в PyPI находится в Руководство пользователя Python Packaging.

Загружает один или несколько дистрибутивов в репозиторий.

 $ ​​загрузка шпагата -h
использование: загрузка шпагата [-h] [-r REPOSITORY] [--repository-url REPOSITORY_URL]
                    [-s] [--sign-with SIGN_WITH] [-i IDENTITY] [-u ИМЯ ПОЛЬЗОВАТЕЛЯ]
                    [-p ПАРОЛЬ] [-c КОММЕНТАРИЙ] [--config-file CONFIG_FILE]
                    [--skip-existing] [--cert path] [--client-cert path]
                    [--verbose] [--disable-progress-bar]
                    расст [расст...]

позиционные аргументы:
  dist Файлы дистрибутива для загрузки в репозиторий
                        (индекс пакета). Обычно dist / *. Может дополнительно
                        содержать файл .asc для включения существующей подписи
                        с загрузкой файла.

необязательные аргументы:
  -h, --help показать это справочное сообщение и выйти
  -r РЕПОЗИТОРИЙ, --repository РЕПОЗИТОРИЙ
                        Репозиторий (индекс пакета) для загрузки пакета
                        к.Должен быть раздел в файле конфигурации (по умолчанию:
                        pypi). (Также можно установить через TWINE_REPOSITORY
                        переменная среды.)
  --repository-url REPOSITORY_URL
                        URL-адрес репозитория (индекса пакета) для загрузки
                        пакет в. Это отменяет --repository. (Так же может быть
                        устанавливается через переменную среды TWINE_REPOSITORY_URL.)
  -s, --sign Подписать файлы для загрузки с помощью GPG.
  --sign-with SIGN_WITH
                        Программа GPG, используемая для подписи загрузок (по умолчанию: gpg).-i ИДЕНТИЧНОСТЬ, --identity ИДЕНТИЧНОСТЬ
                        Идентификатор GPG, используемый для подписи файлов.
  -u ИМЯ ПОЛЬЗОВАТЕЛЯ, --username ИМЯ ПОЛЬЗОВАТЕЛЯ
                        Имя пользователя для аутентификации в репозитории
                        (индекс пакета) как. (Также можно установить через
                        Переменная среды TWINE_USERNAME.)
  -p ПАРОЛЬ, --password ПАРОЛЬ
                        Пароль для аутентификации в репозитории
                        (индекс пакета) с. (Также можно установить через
                        Переменная окружения TWINE_PASSWORD.)
  --non-interactive Не запрашивать имя пользователя / пароль в интерактивном режиме
                        если требуемые учетные данные отсутствуют. (Может также
                        устанавливается через среду TWINE_NON_INTERACTIVE
                        Переменная.)
  -c КОММЕНТАРИЙ, --comment КОММЕНТАРИЙ
                        Комментарий для включения в файл распространения.
  --config-файл CONFIG_FILE
                        Используемый файл конфигурации .pypirc.
  --skip-existing Продолжить загрузку файлов, если они уже существуют.(Только
                        действует при загрузке в PyPI. Другие реализации
                        может не поддерживать это.)
  --cert path Путь к альтернативному пакету CA (также можно задать через
                        Переменная окружения TWINE_CERT).
  --client-cert path Путь к SSL-сертификату клиента, отдельный файл
                        содержащий закрытый ключ и сертификат в PEM
                        формат.
  --verbose Показать подробный вывод.
  --disable-progress-bar
                        Отключить индикатор выполнения.

Проверяет, будет ли длинное описание вашего дистрибутива правильно отображаться на PyPI.

 $ ​​проверка шпагата -h
использование: проверка шпагата [-h] [--strict] dist [dist ...]

позиционные аргументы:
  dist Файлы дистрибутива для проверки, обычно dist / *

необязательные аргументы:
  -h, --help показать это справочное сообщение и выйти
  --strict Fail при предупреждениях
 

ПРЕДУПРЕЖДЕНИЕ : Команда register больше не нужна, если вы загрузка в pypi.орг. Таким образом, он больше не поддерживается в Warehouse. (новое программное обеспечение PyPI, работающее на pypi.org). Однако вам это может понадобиться, если вы используют другой индекс пакета.

Для полноты его использования:

 $ ​​регистр шпагата -h

использование: регистр шпагата [-h] -r REPOSITORY [--repository-url REPOSITORY_URL]
                      [-u ИМЯ ПОЛЬЗОВАТЕЛЯ] [-p ПАРОЛЬ] [-c КОММЕНТАРИЙ]
                      [--config-file CONFIG_FILE] [--cert путь]
                      [--client-cert path]
                      упаковка

позиционные аргументы:
  package Файл, из которого мы читаем метаданные пакета.необязательные аргументы:
  -h, --help показать это справочное сообщение и выйти
  -r РЕПОЗИТОРИЙ, --repository РЕПОЗИТОРИЙ
                        Репозиторий (индекс пакета) для регистрации пакета
                        к. Должен быть раздел в файле конфигурации. (Может также
                        устанавливается через переменную окружения TWINE_REPOSITORY.)
                        Первоначальная регистрация пакета больше не требуется на
                        pypi.org:
                        https: // упаковка.python.org/guides/migrating-to-pypi-
                        org /
  --repository-url REPOSITORY_URL
                        URL-адрес репозитория (индекса пакета) для регистрации
                        пакет в. Это отменяет --repository. (Так же может быть
                        устанавливается через переменную среды TWINE_REPOSITORY_URL.)
  -u ИМЯ ПОЛЬЗОВАТЕЛЯ, --username ИМЯ ПОЛЬЗОВАТЕЛЯ
                        Имя пользователя для аутентификации в репозитории
                        (индекс пакета) как. (Также можно установить через
                        Переменная среды TWINE_USERNAME.)
  -p ПАРОЛЬ, --password ПАРОЛЬ
                        Пароль для аутентификации в репозитории
                        (индекс пакета) с. (Также можно установить через
                        Переменная среды TWINE_PASSWORD.)
  --non-interactive Не запрашивать имя пользователя / пароль в интерактивном режиме
                        если требуемые учетные данные отсутствуют. (Может также
                        устанавливается через среду TWINE_NON_INTERACTIVE
                        Переменная.)
  -c КОММЕНТАРИЙ, --comment КОММЕНТАРИЙ
                        Комментарий для включения в файл распространения.--config-файл CONFIG_FILE
                        Используемый файл конфигурации .pypirc.
  --cert path Путь к альтернативному пакету CA (также можно задать через
                        Переменная окружения TWINE_CERT).
  --client-cert path Путь к SSL-сертификату клиента, отдельный файл
                        содержащий закрытый ключ и сертификат в PEM
                        формат.
 

Twine может считывать конфигурацию репозитория из файла .pypirc либо в вашем домашний каталог или с опцией --config-file .Подробнее о написание и использование .pypirc , см. спецификацию в Python Руководство пользователя упаковки.

Переменные среды

Twine также поддерживает настройку с помощью переменных среды. Параметры переданы командная строка будет иметь приоритет над параметрами, установленными через среду переменные. Определение через переменную среды полезно в средах, где не удобно создавать файл .pypirc (например, на сервере CI / build).

• TWINE_USERNAME - имя пользователя для аутентификации в репозиторий.
• TWINE_PASSWORD - пароль для аутентификации в репозиторий.
• TWINE_REPOSITORY - конфигурация репозитория, определенная как раздел в .pypirc или предоставляется как полный URL-адрес.
• TWINE_REPOSITORY_URL - URL-адрес репозитория для использования.
• TWINE_CERT - настраиваемый сертификат CA для использования в репозиториях с самоподписанные или ненадежные сертификаты.
• TWINE_NON_INTERACTIVE - Не запрашивать имя пользователя / пароль в интерактивном режиме если требуемые учетные данные отсутствуют.

Вместо того, чтобы вводить пароль каждый раз при загрузке дистрибутива, Twine позволяет безопасно хранить имя пользователя и пароль с помощью связки ключей. Связка ключей устанавливается вместе со Twine, но для некоторых систем (в основном Linux) может требуются дополнительные шаги по установке.

После установки Twine используйте программу keyring , чтобы установить имя пользователя и пароль для использования для каждого индекса пакета (репозитория) для который вы можете загрузить.

Например, чтобы установить имя пользователя и пароль для PyPI:

 $ ​​набор ключей для ключей https: // upload.pypi.org/legacy/ ваше-имя пользователя
 

или

 $ ​​python3 -m набор ключей для ключей https://upload.pypi.org/legacy/ ваше-имя пользователя
 

и введите пароль, когда будет предложено.

Для другого репозитория замените URL на соответствующий репозиторий. URL. Например, для Test PyPI используйте https://test.pypi.org/legacy/ .

В следующий раз, когда вы запустите шпагат , вам будет предложено ввести имя пользователя и возьмите соответствующий пароль из связки ключей.

Примечание: Если вы используете Linux в автономной среде (например, на сервер) вам нужно будет выполнить некоторые дополнительные действия, чтобы связка ключей могла надежно хранить секреты. См. Использование связки ключей в безголовых системах.

Отключение брелока

В большинстве случаев, если просто не установить пароль с помощью брелка , Twine вернуться к запросу пароля. В некоторых случаях наличие Связка ключей вызовет неожиданные или нежелательные запросы от системы поддержки.В этих случаях может быть желательно полностью отключить Связку ключей. Отключить Брелок, просто вызвать:

или

 $ ​​python -m keyring --disable
 

Эта команда настроит для текущего пользователя «нулевую» связку ключей, эффективное отключение функциональности и разрешение Twine запрашивать для паролей.

См. Шпагат 338 для обсуждение и предыстория.

Как использовать Twine и SugarCube для создания интерактивных приключенческих игр

Рассказывание историй - неотъемлемая часть человеческой натуры.Это праздное времяпрепровождение, это форма искусства, это инструмент коммуникации, это форма терапии и связи. Мы все любим рассказывать истории - вы сейчас читаете одну - и самые мощные технологии, которые у нас есть, - это, как правило, вещи, которые позволяют нам выражать наши творческие идеи. Проект с открытым исходным кодом Twine - инструмент для этого.

Twine - интерактивный генератор историй. Он использует HTML, CSS и Javascript для создания автономных приключенческих игр в духе классических игр, таких как Zork и Colossal Cave.Поскольку Twine в значительной степени представляет собой объединение нескольких открытых технологий, он достаточно гибок, чтобы выполнять множество мультимедийных трюков, делая игры более похожими на HyperCard, чем вы обычно ожидаете от HTML.

Установка шпагата

Вы можете использовать Twine в Интернете или загрузить его локально с веб-сайта. Разархивируйте загрузку и щелкните значок приложения Twine , чтобы запустить его.

Начальный интерфейс по умолчанию довольно интуитивно понятен. Прочтите вводный материал, затем нажмите большую зеленую кнопку + Story справа, чтобы создать новую историю.

Привет, мир

Основы просты. Новая раскадровка содержит один узел, или «отрывок» в терминологии Twine, который называется Отрывок без названия . Прокрутите этот отрывок, чтобы увидеть параметры узла, затем щелкните значок карандаша, чтобы отредактировать его содержимое.

Назовите отрывок так, чтобы обозначить его место в вашей истории. В предыдущей версии Twine начальный отрывок должен был называться Start , ​​но в Twine 2 подойдет любое название. Это по-прежнему хорошая идея, чтобы сделать его разумным, поэтому придерживайтесь чего-то вроде Start или Home или init .

Чтобы получить текстовое содержание этой истории, введите:

  Привет [[мир]]  

Если вы знакомы с викитекстом, вы, вероятно, уже догадались, что слово «мир» в этом отрывке на самом деле является ссылкой на другой отрывок.

Ваши правки сохраняются автоматически, так что вы можете просто закрыть диалоговое окно редактирования, когда закончите. Вернувшись в раскадровку, Twine обнаружил, что вы создали ссылку, и предоставил вам новый проход под названием мир .

Откройте новый отрывок для редактирования и введите текст:

 
 Это было сделано с помощью шпагата. 
 

Чтобы проверить свой очень короткий рассказ, нажмите кнопку воспроизведения в правом нижнем углу окна Twine.

Это немного, но это начало!

Вы можете добавить больше вариантов навигации, добавив еще одну ссылку в двойных скобках, которая генерирует новый отрывок, пока вы не расскажете ту историю, которую хотите рассказать. Это действительно так просто.

Чтобы опубликовать свое приключение, щелкните заголовок истории в нижнем левом углу окна раскадровки и выберите Опубликовать в файл .Это сохранит весь ваш проект в виде одного HTML-файла. Загрузите этот файл на свой веб-сайт или отправьте его друзьям и попросите их открыть его в веб-браузере, и вы только что создали и доставили свое первое текстовое приключение.

Продвинутый шпагат

Зная только достаточно, чтобы построить эту историю hello world , вы можете создать отличное текстовое приключение, состоящее из исследований и выбора. Что касается быстрого старта, это не так уж и плохо. Как и во всех хороших технологиях с открытым исходным кодом, здесь нет потолка, и вы можете пойти дальше с помощью нескольких дополнительных приемов.

Twine работают так же хорошо, как и они, отчасти благодаря бэкэнду JavaScript под названием Harlowe. Он добавляет все красивые переходы и некоторые стили пользовательского интерфейса, обрабатывает основные мультимедийные функции и предоставляет некоторые специальные макросы для уменьшения объема кода, который вам придется писать для некоторых сложных задач. Однако это открытый исходный код, поэтому, естественно, есть альтернативы.

SugarCube - это альтернативная библиотека JavaScript для Twine, которая обрабатывает мультимедиа, функции воспроизведения мультимедиа, расширенное связывание переходов, элементы пользовательского интерфейса, файлы сохранения и многое другое.Он может превратить ваше обычное текстовое приключение в мультимедийную феерию, которая может соперничать с такими приключенческими играми, как Myst или Beneath the Steel Sky.

Установка SugarCube

Чтобы установить серверную часть SugarCube для вашего проекта:

• Загрузите библиотеку SugarCube. Несмотря на то, что Twine поставляется с более ранней версией SugarCube, вам следует загрузить последнюю версию.

• После загрузки распакуйте архив и поместите в удобное место. Если вы не привыкли систематизировать файлы или управлять творческими ресурсами для разработки проектов, поместите распакованный каталог SugarCube в каталог Twine для безопасного хранения.

• Каталог SugarCube содержит только несколько файлов, с фактическим кодом в формате .js . Если вы работаете в Linux, щелкните файл правой кнопкой мыши и выберите Копировать .

• В Twine вернитесь в библиотеку проектов, щелкнув значок домика в нижнем левом углу окна Twine.

• Нажмите кнопку Formats на правой боковой панели Twine. На вкладке Добавить новый формат вставьте путь к файлу в формате .js и нажмите зеленую кнопку Добавить .

  Если вы не в Linux, введите путь к файлу вручную в следующем формате:

  файл: ///home/your-username/path/to/SugarCube-2/format.js

Использование SugarCube

Чтобы переключить проект на SugarCube, войдите в режим раскадровки вашего проекта.

В представлении раскадровки щелкните заголовок раскадровки в нижнем левом углу окна Twine и выберите Изменить формат истории .

В появившемся окне Story format выберите параметр SugarCube 2.x.

Изображения

Перед добавлением изображений, аудио или видео в проект Twine создайте каталог проекта, в котором будут храниться копии ваших ресурсов. Это жизненно важно, потому что эти ресурсы остаются отдельно от HTML-файла, который экспортирует Twine, поэтому заключительный шаг создания вашей истории - взять экспортированный HTML-файл и поместить его на место вместе со всеми необходимыми мультимедийными материалами. Если вы привыкли к программированию, редактированию видео или веб-дизайну, это знакомая дисциплина, но если вы новичок в создании такого рода контента, возможно, вы не сталкивались с этим раньше, поэтому будьте особенно внимательны при организации своих ресурсов. .

Создайте где-нибудь каталог проекта. Внутри этого каталога создайте подкаталог с именем img для ваших изображений, audio для вашего аудио, video для видео и так далее.

В этом примере я использую изображение с openclipart.org. Вы можете использовать это или что-то подобное. Независимо от того, что вы используете, поместите свое изображение в каталог img .

Продолжая проект hello_world, вы можете добавить изображение в один из проходов, используя синтаксис изображения SugarCube:

 
  
 Привет [[мир]]. 
 

Если вы попытаетесь воспроизвести свой проект после добавления изображений, вы обнаружите, что все ссылки на изображения не работают. Это связано с тем, что Twine находится вне каталога вашего проекта. Чтобы протестировать мультимедийный проект Twine, экспортируйте его как файл и поместите файл в каталог своего проекта. Не помещайте его ни в один из созданных вами подкаталогов; просто поместите его в каталог своего проекта и откройте в веб-браузере.

Другие файлы мультимедиа работают в основном таким же образом, используя теги мультимедиа HTML5 для отображения мультимедиа и макросы SugarCube для управления началом и окончанием воспроизведения.

Переменные и программирование

Вы можете многое сделать, ведя игрока к тому или иному проходу, в зависимости от того, какой выбор он сделал, но вы можете сократить количество необходимых проходов, используя переменные.

Если вы никогда раньше не программировали, найдите время, чтобы прочитать мое введение в концепции программирования. В статье используется Python, но все те же концепции применимы к Twine и практически к любому другому языку программирования, с которым вы, вероятно, столкнетесь.

Например, поскольку история hello_world изначально происходит на Земле, следующим шагом в истории может быть предложение различных путешествий в другие миры.Каждый раз, когда читатель возвращается на Землю, игра может отображать количество миров, которые он посетил. Это было бы практически невозможно сделать линейно, потому что вы никогда не сможете сказать, какой путь пошел читатель в своем исследовании. Например, один читатель может сначала посетить Марс, а затем Меркурий. Другой может вообще никогда не полететь на Марс, вместо этого посетив Юпитер, Сатурн, а затем Меркурий. Вам придется сделать один проход для каждой возможной комбинации, и это решение просто не масштабируется.

С помощью переменных, однако, вы можете отслеживать прогресс читателя и соответственно отображать сообщения.

Чтобы это работало, вы должны устанавливать переменную каждый раз, когда читатель достигает новой планеты. В игровой вселенной игры hello_world планеты на самом деле являются проектами с открытым исходным кодом, поэтому каждый раз, когда пользователь посещает отрывок о проекте с открытым исходным кодом, устанавливайте переменную, чтобы «доказать», что читатель посетил.

Переменные в синтаксисе SugarCube устанавливаются с помощью макроса <>.В SugarCube есть множество макросов, и все они удобны. В этом примере проекта используется несколько файлов.

Измените второй отрывок, который вы создали, чтобы предоставить читателю несколько новых возможностей для исследования:

 
 Это было сделано в [[Twine]] в [[Linux]]. 
 << выбор Старт «Вернуться на Землю». >> 
 

Здесь вы используете макрос <>, который связывает любую строку текста прямо с заданным отрывком. В этом случае макрос <<выбор>> связывает строку «Return to Earth» с переходом Start.

В новый отрывок вставить следующий текст:

 Twine - это интерактивная история. Он работает во всех операционных системах, но я предпочитаю использовать его в [[Linux]]. 
 << установить для $ шпагат значение true >> 
 << выбор Начать «Вернуться на Землю». >> 
 

В этом коде вы используете макрос <> для создания новой переменной с именем $ twine . Эта переменная является логической, потому что вы просто устанавливаете для нее значение «истина». Вы скоро поймете, почему это важно.

В отрывке из Linux введите этот текст:

 Linux - это [[Unix]] операционная система с открытым исходным кодом. 
 << установить для $ linux значение true >> 
 << выбрать Start «Вернуться на Землю». >> 
 

А в Unix отрывок:

 BSD - это версия операционной системы Unix компании AT&T с открытым исходным кодом. 
 << установить для $ bsd значение true >> 
 << выбор Start «Вернуться на Землю». >> 
 

Теперь, когда читатель может изучить пять отрывков, пришло время использовать SugarCube, чтобы определять, какая переменная была установлена ​​каждый раз, когда читатель возвращается на Землю.

Для определения состояния переменной и соответствующей генерации HTML используйте макрос <>.

  
 Привет [[мир]]. 
 <> 
 <
> 
 << если $ twine истинно >> <
> Planet Twine <
> <> 
 << если $ linux истинно> > <
> Planet Linux <
> <> 
 << если $ bsd истинно >> <
> Planet BSD <
> <> 
 <
> 
 

Для тестирования вы можете нажать кнопку Play в правом нижнем углу.Вы не увидите свое изображение, но посмотрите на него в интересах тестирования.

Перемещайтесь по сюжету, периодически возвращаясь на Землю. Обратите внимание, что счет каждого места, которое вы посетили, появляется внизу отрывка «Начало» каждый раз, когда вы возвращаетесь.

Но ничего не объясняет, почему появляется список посещенных мест. Сможете ли вы понять, как объяснить читателю количество исследованных отрывков?

Вы можете просто предварять итоговый список вводным предложением вроде «До сих пор вы посетили:», но когда пользователь впервые приходит, список будет пустым, так что ваше вступительное предложение ничего не вводит.

Лучший способ управлять этим - использовать еще одну переменную, указывающую, что пользователь покинул Землю.

Изменить мир пассаж:

 Это было сделано в [[Twine]] в [[Linux]]. 
 << установить для $ offworld значение true >> 
 << выбрать Start "Вернуться на Землю". >> 
 

Затем используйте другой макрос <>, чтобы определить, установлена ​​ли для переменной $ offworld значение true .

Способ, которым Twine анализирует викитекст, иногда приводит к появлению большего количества пустых строк, чем вы предполагали, поэтому для сжатия списка посещенных мест используйте макрос <> для предотвращения разрывов строк.

  
 Привет [[мир]]. 
 <> 
 <
> 
 << если $ twine истинно >> <
> Planet Twine <
> <> 
 << если $ linux истинно> > <
> Planet Linux <
> <> 
 << если $ bsd истинно >> <
> Planet BSD <
> <> 
 <
> 
 <> 
 

Попробуйте воспроизвести историю еще раз.Обратите внимание, что читателя не ждут обратно на Землю, пока он не покинет Землю.

Исследуй все

SugarCube - мощный двигатель. Часто для этого нужно знать, что доступно, а не не иметь возможности что-то сделать. К счастью, его документация очень хороша, поэтому почаще обращайтесь к его списку макросов.

Вы можете внести дополнительные изменения в свой проект, изменив таблицу стилей CSS. Для этого щелкните заголовок своего проекта в режиме раскадровки и выберите Изменить таблицу стилей истории .Если вы знакомы с JavaScript, вы также можете создавать сценарии для своих историй с помощью Edit Story JavaScript .

Нет предела тому, что Twine может делать в качестве движка интерактивной фантастики. Он может создавать текстовые приключения, и он может служить прототипом для более сложных игр, ролевых игр, бизнес-презентаций, дополнений к ночным ток-шоу и всего остального, что вы можете себе представить. Изучите вики Twine, взгляните на работы других людей в интерактивной базе данных художественной литературы, а затем создайте свои собственные.

A Quick Twine (2.2+) Учебное пособие: вычислительные подходы к повествованию

Эллисон Пэрриш

Загрузите Twine здесь. Это руководство посвящено Twine 2.2.1, и, надеюсь, будет полезен даже для немного более ранних или более поздних версий. (А несколько лет назад я сделал учебник специально для Twine 1.4, который все еще может быть полезен если вы хотите использовать эту версию!)

Игра Twine состоит из «узлов» (или «переходов»; в терминах гипертекста, мы бы назвали их «лексией») и связями между ними.Интерфейс приложения представляет каждый узел в виде блока, а ссылки между узлами в виде стрелок из одного блока к другому. Это полезно для понимания и отслеживания структура вашей игры.

Первые шаги

Когда вы запускаете Twine в первый раз, это выглядит примерно так:

Это список, в котором отображаются все созданные вами истории. Вы не сделали пока нет никаких историй, поэтому в списке ничего нет.

Изменение формата истории по умолчанию

На самом базовом уровне Twine - это способ создания историй, в которых разные части текста рассказа можно связать друг с другом.Сделать это легко. Но Twine также позволяет делать гораздо больше, чем просто писать текст со ссылками: такие вещи, как изменение форматирования текста, добавление мультимедиа и анимации, создание вещей интерактивность, сохранение прогресса и т. д. Чтобы все это произошло, вам нужно напишите немного кода.

Потому что существует так много разных пользователей Twine с разным мышлением и разных стилей, Twine поддерживает несколько различных наборов правил, касающихся как написать такой код, чтобы каждый мог писать код в стиле это им удобно.Эти наборы правил называются «рассказом». форматы ». Каждый История, которую вы создаете, должна использовать один (и только один) формат истории. История по умолчанию формат называется Harlowe, но мне нравится преподавать с помощью SugarCube. Так что я собираюсь использовать SugarCube для этого урока. Однако для этого вам нужно необходимо изменить формат истории по умолчанию с Harlowe на SugarCube.

В списке историй на правой боковой панели есть текст, который гласит «Форматы» - ссылка, при активации которой открывается диалоговое окно.В моем версии Twine диалоговое окно выглядит так:

В этом диалоговом окне выберите альтернативу SugarCube с последней версией число (SugarCube 2.x.x, чем выше число, тем лучше). Затем закройте чат.

Создание новой истории

Чтобы создать новую историю, нажмите кнопку с надписью + История . Вы получите диалог поле, которое просит вас назвать вашу игру. Вы можете не знать, что это за игра пока, и это нормально. Просто введите что-нибудь.Вы всегда можете изменить это позже.

После того, как вы нажмете + Добавить , вы увидите следующий экран. Это где ты собственно напишите свою историю. В поле с надписью «Отрывок без названия» рядом с ним маленький зеленый значок ракеты. Здесь и начнется ваша история.

В нижнем левом углу есть значок «Домой», с помощью которого вы можете вернуться к списку историй.

В конце концов, это окно будет заполнено маленькими коробками, каждая из которых представляет «отрывок.”Отрывок - это небольшой фрагмент текста, который может содержать ссылки на других переходы, и сам быть целью ссылок. Обычно основная работа по изготовлению история Twine - это написание отрывков и решение, к которым отрывки будут связаны друг друга, и как эти ссылки работают.

Редактирование отрывков

Чтобы изменить текст отрывка, дважды щелкните его в режиме просмотра истории. Ты будешь см. интерфейс редактирования, который выглядит следующим образом:

Когда я делаю снимок экрана диалогового окна редактирования текста отрывка, я добавляю расшифровка содержимого окна в следующем формате, чтобы вы могли использовать программа для чтения с экрана или легко скопируйте / вставьте.

  Название проезда: Железнодорожный вокзал
Тело перехода:

    Вы стоите на переполненном вокзале.

    Пора [[купить билет | Билетная касса]].
  

Странный текст в [[ и ]] - это ссылка . Текст слева от вертикальная черта ( | ) - это текст ссылки, а текст справа от вертикальной черты находится название отрывка, на который вы хотите создать ссылку.

При закрытии окна редактирования текста отрывка (ваши изменения будут сохранены автоматически), вы заметите, что появился новый отрывок:

Ага, верно! Когда вы создаете ссылку, нацеленную на несуществующий отрывок, Шпагат идет вперед и создает его за вас.Удобно. Интерфейс редактирования истории также визуализирует связи между отрывками со стрелками, что упрощает сохранение отслеживайте, как связаны ваши отрывки.

Я собираюсь дважды щелкнуть новый отрывок, созданный для меня Twine, и добавить новый текст:

  Название прохода: Билетная касса
Тело перехода:

    Вы пойдете на юг, в [[Cosmopolitan City]]? Или на север, к этому
    крошечная деревушка, в которую вы ходили летом, [[Ghost Lake]]?
  

Когда вы закроете это окно, Twine снова создаст проходы на которую вы ссылались.Обратите внимание: если вы не добавите | по вашей ссылке, Twine будет считать, что текст ссылки также является названием отрывка. на который вы хотите создать ссылку. Теперь ваша история должна выглядеть так:

Теперь вернитесь и добавьте текст к новым отрывкам, которые вы создали.

  Название пассажа: Cosmopolitan City
Тело перехода:

    Суета большого города бодрит вас.
    Но почувствуете ли вы когда-нибудь, что вы принадлежите? КОНЕЦ
  

  Название прохода: Призрачное озеро
Тело перехода:

    Озеро Призрак приятно в это время года.Говорят вой
    шум - это просто эффект ветра, движущегося по поверхности
    воды, но вы в этом не уверены. КОНЕЦ
  

Удаление отрывков

Вы можете удалить отрывок с помощью значка «Корзина», который появляется при выборе прохождение. Twine запросит подтверждение. После удаления отрывка значок В режиме редактирования истории будет отображаться большой красный крестик везде, где есть ссылки на отрывок. что вы только что удалили:

Когда вы это увидите, вам следует вернуться и исправить ссылку! (Вы можете удалить ссылку из текста отрывка, или добавить новый отрывок с названием, которое цель ссылки.)

Играем в вашу игру

Теперь вы создали простую ветвящуюся историю в Twine. Если хочешь попробовать, используйте кнопку ▶ ️ Воспроизвести на панели в нижней части окна Twine. Это будет откройте новое окно, в котором показана ваша история! Это будет выглядеть примерно так:

Вы можете переходить по ссылкам в своей истории, а затем закрыть окно, когда законченный. Кнопка Test выполняет то же действие, что и Play , за исключением того, что она также показывает специфичную для формата истории «отладочную» информацию (т.е., аннотации и сообщения, которые могут облегчить решение проблем, когда они возникнут). Видеть Тестовый режим SugarCube Руководство для получения дополнительной информации Информация.

Также можно запустить игру в тестовом режиме с произвольного отрывка, выбрав переход в режиме редактирования истории и с помощью появившейся кнопки ▶ ️ . Этот полезно, если вы хотите протестировать лишь небольшую часть игры, а не Все это.

Добавление медиа в вашу историю

К сожалению, Twine 2 в настоящее время не поддерживает возможность объединения медиафайлов. (например, изображения, видео и звук) с вашим файлом истории.Но под капотом Twine - это просто модный способ создания файлов HTML, поэтому вы можете использовать теги HTML для легко ссылаться на медиа, размещенные на вашем собственном веб-сайте.

Например, я взял изображение с лицензии Creative Commons из Викимедиа. Commons и загрузил на свой личный веб-хостинг сайт. (Спасибо, пользователь Викимедиа Фамартин!). Теперь я могу включить URL-адрес файла в тег прямо внутри текст отрывка. (Не забудьте добавить атрибут alt для людей, которые не могут загрузить изображение или кто использует программу чтения с экрана.)

  Название прохода: Призрачное озеро
Тело перехода:

    Озеро Призрак приятно в это время года. Говорят
    воющий шум - это просто эффект ветра, движущегося по
    поверхность воды, но вы в этом не уверены. КОНЕЦ

    
  

Теперь, когда вы играете в игру, вы увидите изображение в том месте, куда вы положили тег:

Вы можете использовать аналогичную стратегию для встраивания аудио и видео.Официальный в документации есть хорошие инструкции о том, как сделать так.

Недавняя (2020 г.) проблема GitHub при добавлении ресурсов в игры Twine 2, ссылки на много разных решений проблема, включая кодировку ваши медиаресурсы как Base64.

Сохранение и отправка вашей игры

Twine автоматически сохраняет вашу работу на ходу. Если вы хотите поделиться своей игрой с другими людьми вам необходимо опубликовать его в файл. Сделайте это либо вернувшись к списку историй и используя значок шестеренки, или нажав на имя истории в интерфейсе редактирования истории и выбор Опубликовать в файл .Это создаст HTML-файл с вашей историей в выбранном вами месте.

Вы можете отправить этот файл своим друзьям или загрузить в Интернет с помощью любого сервис, который позволяет загружать файлы HTML (также известные как «статическое содержимое хостинг »). Если у вас нет места в Интернете для загрузки файла, попробуйте:

• Neocities: бесплатный общий веб-хостинг с дружественный интерфейс
• itch.io: сайт по раздаче игр. Много шпагата авторы используют это!

Я загрузил законченную версию игры, над которой мы работаем, поэтому далеко от меня персональный веб-хостинг.

Слежение за вещами

В этом разделе я расскажу обо всех способах, которыми ваша игра Twine может реагировать на выбор вашего читателя, включая «запоминание» информацию от одного отрывка к другому и придание формы вашему тексту в зависимости от того, какой выбор сделал читатель.

Мы собираемся поговорить о макросах , , переменных, и , функциях .

Макросы и переменные

«Макрос» - это фрагмент предварительно определенного кода, который вы бесплатно получаете с Twine.Среди в остальном, макросы позволяют сохранить дополнительную информацию в вашей игре. сцены, а затем измените способ отображения вашей истории на основе этого Информация.

Макросы записываются так:

  <<что-то>>
  

… то есть две угловые скобки вокруг чего-то, где что-то - это имя макроса, который вы хотите использовать. Некоторые макросы содержат другую информацию между скобки, как мы увидим ниже. Обратите внимание, что макросы - это , а не HTML-тегов! Они работает только в Twine, а не на старых веб-страницах.Если вы хотите просмотреть все доступные вам макросы, официальный SugarCube документация - хорошее место для смотрю.

Получение пользовательского ввода с текстовым полем

Первый макрос, о котором мы поговорим, - это <> , который позволяет предложите вашему читателю что-нибудь напечатать. Затем вы можете взять все, что они набрал и использовать в другом отрывке. Начни новую игру Twine с нуля, и отредактируйте начальный «Отрывок без названия» так, чтобы он выглядел так. (Примечание: я не буду включать скриншоты для окна редактирования отрывка для оставшейся части этого руководство.)

  Название прохода: Добро пожаловать!
Тело перехода:

    Пожалуйста, введите ваше имя ниже.

    << textbox "$ player_name" "Ваше имя" "Приветствую" >>
  

Это выглядит сложным, поэтому давайте разберемся с ним. Текстовое поле указывает в Twine, что мы хотим использовать макрос текстового поля , который вызывает ввод текста поле появится на экране. Макрос текстового поля требует немного больше информация, тем не менее, делает свою работу. В частности, необходимо как минимум три , параметры или дополнительные биты информации, которые вы предоставляете, следуя имя макроса с тремя разными строками символов внутри двойного Котировки.

Что именно это за струны? Ну, во-первых, читатель введет какой-то текст, и мы хотим использовать этот текст позже. Нам нужно дать этому тексту немного вид дескриптора или имени, чтобы мы могли обратиться к нему позже. Имя, под которым значение в Twine называется «именем переменной». В этом случае $ player_name имя переменной. (Мы могли выбрать любое имя, какое захотим - оно просто чтобы начать с $ и содержать только буквы, цифры и символы подчеркивания.)

Во-вторых, в текстовом поле должен быть текст «по умолчанию», то есть текст, который появляется в поле до того, как пользователь взаимодействует с ним. Это второй параметр, в нашем случае текст Ваше имя .

Наконец, третий параметр позволяет указать, какой отрывок читатель после ввода информации в текстовое поле следует перейти к. В этом случае я указал отрывок под названием «Приветствия», которого я еще не произносил (хотя однажды вы закрыли окно редактирования отрывка, вы заметите, что у Twine автоматически сделал это для нас.)

Вот снова текст макроса:

  << текстовое поле "$ player_name" "Ваше имя" "Приветствую" >>
  

В целом, вы можете прочитать этот макрос как: «Привет, Шпагат! Сделайте ввод текста коробка. Что бы ни вводил читатель, запомните это в переменной с именем $ имя_плеера . Сначала введите текст Ваше имя в текстовое поле, а когда читатель отправляет свою запись, отведите их в отрывок под названием Привет, ».

Обратите внимание, что нет причин, по которым вы должны были знать макушку что означают эти параметры или в каком порядке они должны быть указаны.Для этой информации вам просто нужно найти часть SugarCube. документация об этом конкретном макрос. Большая часть процесса изучения того, как использовать SugarCube, означает изучение всех макросов и каков порядок параметров.

Отображение значения переменной

Конечно, просто поместить то, что игрок ввел в переменную, не поможет. много. На самом деле нам нужно сделать что-то с этой переменной. SugarCube имеет номер макросов для управления переменными и изменения того, что делает игра на основе значение переменной.Самый простой из них - <> , который вы используете вот так:

  << print $ имя_переменной >>
  

… замена $ имя_переменной именем переменной, которую вы хотите отобразить. Я собираюсь отредактировать отрывок «Приветствия» в игре, которую делаю, чтобы он отображает все, что читатель набрал в первом отрывке. Отредактируйте «Приветствия» отрывок так:

  Название отрывка: Приветствую
Тело перехода:

    Здравствуйте, << print $ player_name >>!
  

В приведенном выше примере мы указали макросу <> использовать имя переменной $ player_name , поэтому мы помещаем $ player_name в <> макрос.Сыграйте в игру с самого начала, и вы заметите, что все, что вы наберете в первом отрывке, появится во втором!

УПРАЖНЕНИЕ: сделайте игру Twine, которая задает читателю несколько вопросов о сами, один за другим. (Например, «как тебя зовут?», «Какие у тебя волосы цвет »,« придумайте число от одного до пятнадцати »и т. д.). В последнем отрывке отображать всю информацию, введенную читателем.

Поскольку отображение значения переменной является обычным явлением, SugarCube имеет ярлык.Можно просто указать имя переменной (включая $ ). Для Например, следующий текст отрывка будет делать то же самое, что и текст отрывка выше:

  Название отрывка: Приветствую
Тело перехода:

    Привет, $ player_name!
  

Установка переменных

Макрос <> - это лишь один из многих способов получить переменные в нашем игры. Иногда мы хотим создать свои собственные переменные и установить для них значения что-то из нашего собственного воображения, а не из воображения читателя.Мы можем сделать это с макрос <> . Синтаксис макроса <> выглядит следующим образом:

  << установить $ имя_переменной в значение >>
  

… где $ имя_переменной (снова) - это имя, которое мы выбираем для переменной, и значение - это какое-то значение, обычно либо число (например, 5 ), либо строка текста (например, «Мать сказала, что будут такие дни» ). (Больше о различные виды значений ниже.)

Включение этого макроса в отрывок установит для переменной заданное значение всякий раз, когда читатель посещает этот отрывок. Чтобы продемонстрировать, я сделал игру Twine с четырьмя проходами. Текст отрывков приведен ниже. Убедись в том, что игра начинается с прохождения «Начало викторины». (Вы можете контролировать это, используя Начать историю здесь опция в расширенном меню после выбора отрывка в Окно редактирования истории.)

Прохождение # 1:

  Название прохождения: Начало викторины
Тело перехода:

    Добро пожаловать в личную викторину 2000!

    Вы предпочитаете [[шартрез]] или [[серо-коричневый]]?
  

Прохождение # 2:

  Название пассажа: шартрез
Тело перехода:

    Ярко и живо, а? Очень интересно.<< установить для $ личность значение "кокетливый" >>

    [[Смотрите свои результаты | Результаты]]
  

Прохождение # 3:

  Название пассажа: серо-коричневый
Тело перехода:

    Ах, мягкий и элегантный.

    << установить для $ личность значение "заслуживающий доверия" >>

    [[Смотрите свои результаты | Результаты]]
  

Прохождение # 4:

  Название прохода: Результаты
Тело перехода:

    Наш тест показал, что ваш тип личности
    $ личность. Спасибо за участие!
  

Вот как должна выглядеть история в редакторе:

Сыграть завершенную версию этой личности викторина, чтобы увидеть, как это работает и узнайте, какова ваша личность!

Различные виды ценностей

Макрос <> позволяет вам устанавливать переменные для различных типов значений.
В приведенном выше примере значение, которое мы установили для $ индивидуальности как своего рода значение, называемое строкой . Строки содержат «цепочки» символов и что вы хотите использовать для любой текстовой информации, которую хотите сохранить. Когда ты сделайте строковое значение, вы должны заключить значение в двойные кавычки ", например это ".

Макрос <> также может устанавливать числовых значений , например 5 или 19,42 . Когда вы пишете число, вам не нужно включать кавычки.

Разница между этими двумя типами значений (строки и числа) будет станет более очевидным позже, когда мы будем говорить о выражениях. Пока что, просто отбросьте идею, что это две разные вещи.

УПРАЖНЕНИЕ. Создайте игру Twine, в которой <> задает переменную $ score для читатель, исходя из того, какой из нескольких проходов они выберут в игре. Есть все переходы приводят к переходу «Игра окончена», в котором отображается переменная $ score .

Изменение значения переменной

Вы можете изменить переменную на новое значение после того, как вы установили это значение изначально. Вы можете использовать эту возможность, чтобы отслеживать прогресс читателя в вашей истории. со временем. Чтобы изменить значение переменной, просто используйте <> макрос снова. В одном отрывке вы можете сначала установить переменную так:

  << установить для $ favourite_color значение "красный" >>
  

… а затем в другом отрывке:

  << установить для $ favourite_color значение "синий" >>
  

Переменная $ favourite_color теперь будет иметь вид "синий" до конца история (или пока ваша история снова не изменит свое значение!).Вот пример игры который изменяет переменную, которая отслеживает уровень голода читателя в ответ на выбор, который они делают.

Обычно требуется изменить значение переменной в зависимости от того, какое значение в настоящее время есть. Скажем, например, вы отслеживаете счет игрока. Вы можете захотеть увеличить (или уменьшить) оценку пользователя на некоторую величину, без необходимости устанавливать значение на какое-то точное число.

Есть простой способ сделать это с помощью SugarCube, используя выражений. An «Выражение» - это комбинация значений, переменных и операторов, которые компьютер проверяет и оценивает , выдавая единственное значение. Мы поговорим еще о выражениях ниже (что это такое, как они работают и правила для соединяя их вместе). А пока вот как написать выражение, которое заставляет макрос <> увеличивать переменную на единицу.

Допустим, вы начинаете один отрывок с этого кода:

  << установить $ score на 0 >>
  

Если вы хотите увеличить значение в $ score на 1, вы можете поместить этот макрос в другом отрывке:

  << установить $ score на $ score + 1 >>
  

Слишком много виджетов

Давайте сделаем быструю игру, которая воспользуется этим преимуществом.В игре ты предлагается использовать столько виджетов, сколько хотите, навсегда. Создайте новую историю Twine и создайте следующие три прохода:

Прохождение # 1:

  Название прохода: Добро пожаловать
Тело перехода:

    Добро пожаловать в магазин виджетов.

    Поздравляю! Вы наш миллионный клиент. У тебя есть
    выиграл неограниченный запас виджетов! Как здорово.

    << установить для $ widget_count значение 0 >>

    [[Войти в выставочный зал | Выставочный зал]]
  

Прохождение # 2:

  Название прохода: Выставочный зал
Тело перехода:

    Вы находитесь в демонстрационном зале виджетов.Вы окружены
    красивые, сверкающие виджеты.

    У вас есть виджет (ы) $ widget_count.

    [[Взять виджет]]
  

Прохождение # 3:

  Название перехода: Виджет взять
Тело перехода:

    Берешь виджет.

    << установить для $ widget_count значение $ widget_count + 1 >>

    [[Назад | Выставочный зал]]
  

Ваша игра должна выглядеть так:

Я загрузил для вас полную версию игры с виджетами.

Вы можете заменить + в выражении на - , если хотите, чтобы значение до уменьшите на единицу вместо увеличения.Вы также можете изменить номер: если поставить 20 вместо 1 , значение увеличится на двадцать вместо один. Попробуйте!

Установочные звенья

Мы потратили много времени на создание отрывков, которые служат только одной цели: использовать макрос <> для установки переменной на определенное значение, затем перейти к другому отрывку. Оказывается, это очень обычное дело хотеть делать - настолько часто, что у Twine есть сокращение, позволяющее вы можете установить переменную прямо внутри ссылки! Этот метод называется сеттером. ссылка »и выглядит так:

  [[Текст ссылки | PassageName] [$ variable = value]]
  

… где Текст ссылки - текст, который должна отображать ссылка, PassageName - это отрывок, на который должна перейти ссылка, $ переменная - это имя переменная, которую вы хотите установить, а значение - это значение, которое вы хотите установить переменная к.

Используя установочные ссылки, мы можем сделать версию Личностной викторины всего на два проходы.

Прохождение # 1:

  Название прохождения: Начало викторины
Тело перехода:

    Добро пожаловать в личную викторину 2000!

    Вы предпочитаете [[шартрез | Результаты] [$ identity = "flirtatious"]]
    или [[серо-коричневый | Результаты] [$ identity = "trustworthy"]]?
  

Прохождение # 2:

  Название прохода: Результаты
Тело перехода:

    Наш тест показал, что ваш тип личности
    $ личность.Спасибо за участие!
  

УПРАЖНЕНИЕ: Используя ссылки установщика, можете ли вы создать версию Widget Emporium игра, в которой используется всего два прохождения? Только один пассаж?

Принятие решений с помощью

На данный момент мы знаем, как устанавливать переменные, печатать переменные и как изменять значение переменной после ее установки. Теперь мы узнаем, как заставить наши истории Twine делать разные вещи в зависимости от значения переменной.

Макрос <> / <> / <> проверяет соответствие значения переменной определенные критерии. Если это так, то текст между Отображаются <> и <> , и любые макросы в них будут выполнен. Если это , а не , тогда текст между <> и <> , снова вместе с любыми макросами. (Если вам не нужно особенное поведение, когда <> условие не выполняется, вы можете просто пропустить <> ).

Самый простой способ использовать <> / <> / <> - использовать имя переменной после , если . В следующем коде будет отображаться «У вас есть ключ!» только если переменной $ player_has_key присвоено значение с помощью макроса <> ранее.

  << if $ player_has_key >> У вас есть ключ! <> Этот ключ должен
быть где-нибудь здесь ... <>
  

Вот игра Twine, в которой используется макрос <> / <> для отображения фрагмент текста в отрывке, только если игрок посетил другой отрывок.

Прохождение # 1:

  Название прохода: Начало
Тело перехода:

    Вы находитесь на лесной поляне.

    << если $ wear_spectacles >>
    Поскольку вы носите хрустальные очки, вы видите [[кошку]]
    здесь его усы, посеребренные в лунном свете.
    <>
    Вам приходит в голову рыться в своих [[вещах]].
    <>
  

Прохождение # 2:

  Название пассажа: вещи
Тело перехода:

    В ваших вещах вы найдете пару хрустальных очков.Ты
    решили надеть их.

    << установить для $ wear_spectacles значение 1 >>

    [[Назад | Начать]]
  

Прохождение # 3:

  Название прохождения: cat
Тело перехода:

    Кот говорит. «Я Кот Времени», - говорит он. "Я могу взять
    вы в любое время, когда захотите ".

    ЛУЧШИЙ КОНЕЦ 100% ЗАВЕРШЕНИЕ
  

Вот как должен выглядеть готовый макет:

Здесь вы можете увидеть, что вещи проезд <> s $ wear_spectacles от до 1 , когда читатель посещает отрывок.Когда игрок возвращается к Start , ранее скрытый фрагмент текста (ссылка на cat ) появляется, позволяя читателю завершить рассказ.

Сыграйте в «Кошку времени» здесь.

Вы также можете использовать <> для цепочки проверок на наличие нескольких условий; увидеть пример для либо () ниже.

Функции

SugarCube есть еще один способ привнести интересное поведение в ваши истории: функции.«Функция» - это небольшой фрагмент кода, определяемый SugarCube за кулисами, который вы можете использовать в своем коде Twine, как если бы это был значение или выражение. О некоторых из них мы поговорим ниже, или вы можете прочитать полный список SugarCube функции в официальном документация.

либо ()

Функция либо () принимает серию значений, разделенных запятыми, внутри своего круглые скобки. Когда вы играете свою историю, Twine случайным образом выбирает один из этих значения. Вы можете использовать это, чтобы добавить немного цвета в свои игры:

  Дождь льется из << принта ("шифер", "камень", "мрачный") >>
небо. 

… или чтобы произошло что-то случайное:

  << установить $ player_fate в любое ("смерть", "счастье", "фондю") >>
<< если $ player_fate - "смерть" >>
Вы умираете окончательно и мучительно.
<< elseif $ player_fate - это "счастье" >>
Вы живете долго и счастливо.
<< elseif $ player_fate - фондю >>
Вы устраиваете вечеринку с фондю со всеми своими ближайшими друзьями.
<>
  

посетил ()

Функция посещена () может сказать вам, сколько раз читатель посещал конкретный отрывок в игре.Просто введите название отрывка, который вы хотите отметить в круглых скобках (и в кавычках):

  Вы посетили сырный магазин << распечатать посещение ("Сырный магазин") >> раз.
  

Эту функцию также можно использовать в макросах <> для принятия решений на основе посетил ли читатель конкретный отрывок:

  << при посещении ("Университет")> 0 >>
Вы были в университете, поэтому знаете все, что вам нужно знать
об интерактивном тексте.<>
  

предыдущая ()

Функция previous () вычисляет имя последнего прохода, читатель посетил. Вы можете использовать это, чтобы узнать, какой отрывок читатель только что пришел, если отрывок имеет более одной точки входа:

  Вы успешны в своей карьере, даже если << if previous () является
"Университет" >> вы начинаете без реального опыта << иначе, если предыдущий () -
"Тренинг" >> у вас нет формального образования <>. 

Подробнее о выражениях

Прочтите документацию SugarCube на выражения.

Оператор - проверяет, что значение слева от оператора совпадает со значением справа. Но есть ряд других операторы, которые мы тоже можем использовать! Изучение того, как использовать эти операторы, поможет откройте новые возможности для интересных правил и процедур в ваших рассказах. Вот список:

• - это : истина, если левое значение равно правому значению.
• neq : истина, если левое значение НЕ равно правому значению ( neq сокращенно для не равно ).
• > : истина, если левое значение больше правого.
• <: истина, если левое значение меньше правого.
• > = : истина, если левое значение больше или равно правому значению.
• <= : истина, если левое значение меньше или равно правому значению.

Так, например, чтобы проверить, имеет ли переменная $ player_name какое-то значение , кроме Josephine, вы можете добавить в свой код следующий макрос:

  << if $ player_name neq "Josephine" >>
Эта мадлен предназначена только для Жозефины! Уходите!
<>
  

Вы также можете комбинировать выражений с помощью операторов и и или . В Операторы и принимают два выражения, одно слева, а другое - right и считается «истиной», если оба выражения верны.Оператор или аналогично принимает два выражения и считается «истиной», если одно из левых выражение истинно, или правое выражение истинно (или и то, и другое). В выражения по обе стороны от и и или должны быть окружены круглые скобки.

Так, например, чтобы какой-то текст появлялся только в том случае, если у ридера пять монет И что их зовут Роберт:

  << if ($ player_name - "Роберт") and ($ coin_count> = 5) >>
Вы Роберт, и у вас достаточно монет, чтобы купить этот великолепный
и волшебный меч.<>
  

Чтобы отобразить текст, если у игрока либо 0 очков, либо 100 очков:

  << если ($ оценка равна 0) или ($ оценка равна 100) >>
Вы либо действительно хороши в этой игре, либо очень плохи в этой игре.
<>
  

Наконец, оператор , а не , принимает выражение прямо вправо, и считается «истина», если выражение «ложь», и «ложь», если выражение правда." Вы можете использовать это, чтобы проверить, соответствует ли определенное условие , а не получить:

  << если нет ($ оценка 0) >>
У вас больше или меньше нуля! Отличная работа.<>
  

Удаление лишних пробелов

Вы могли заметить, что каждый раз, когда мы используем макрос, какие-то странные дополнительные в готовом выводе появляется пробел. Это происходит потому, что Twine считает новые строки, которые находятся внутри макроса (т.е. после >> ), даже если макрос ничего не отображает (например, если условие <> не выполняется). Например, такой код:

  Вот текст раньше.<< если $ player_name - "Sandra" >>
Вы Сандра.
<>

А вот и текст после.
  

… отображается с дополнительными пустыми строками. Эти пустые строки соответствуют строке прерывает после тегов макросов, которые SugarCube по умолчанию игнорирует , а не . С эстетической точки зрения это довольно неприятно. К счастью, есть способы исправить это.

Один из способов исправить это - просто удалить как можно больше новых строк, размещение макроса <> против другого текста:

  Вот текст раньше.<< если $ player_name - "Sandra" >>

Ты Сандра. <>

А вот и текст после.
  

Это нормально (попробуйте!), Но это немного сбивает с толку, потому что <> Макрос находится в странном месте. В идеале мы хотели бы сохранить пробелы в нашем коде, чтобы не усложнять избегая появления нежелательных пробелов.

Другой способ сделать это - использовать символ \ (обратная косая черта).Если вы положите этот символ в конце строки, он указывает Twine не отображать новая строка в визуализированном выводе:

  Вот текст раньше.

<< если $ player_name - "Sandra" >> \
Вы Сандра.

<> \
А вот и текст после.
  

Если у вас есть несколько макросов, которые вы хотите включить в свой код без вводя нежелательные пробелы, вы можете использовать тег <> . В <> Макрос , который предписывает Twine игнорировать новые строки до тех пор, пока встречает <> .Например, чтобы включить число <> макросы без большого количества пробелов:

  <>
<< установить $ сыр на 1 >>
<< установите для $ room_title значение "Вестибюль" >>
<< установите для $ current_trouser_type значение "Denim" >>
<>
  

Стили ссылок

Раздел «Ссылки в лексике» книги Стейси Мейсон и Марка Бернстайна «О Ссылки: Упражнения в Стиль »описывает несколько стили ссылок, которые реализует Sugarcube.Давайте посмотрим на некоторые из них!

Это список не исчерпывающий! Я просто пишу о некоторых низко висящих фрукты. Использование интерактивной программы Sugarcube макросы, ссылки макросы и DOM макросы, это возможно создавать связи с очень сложным и выразительным поведением с очень немного кодирования.

Велосипедные звенья

Макрос <> создает «циклическую» ссылку. Такая ссылка не ведет к другому проходу; вместо этого, когда читатель нажимает на нее, текст ссылки изменения.Этот макрос функционально похож на выпадающий виджет или серию радиокнопок, а Sugarcube сохраняет любую опцию, отображаемую в данный момент на экран. Схематично макрос выглядит так:

  << цикл автоматического выбора "$ var_to_store_result" >>
  << option "Label1" "value1" >>
  << option "Label2" "value2" >>
  ...
<>
  

Sugarcube сохранит выбранный в данный момент параметр в переменной с именем между кавычками в первом параметре макроса <> .Каждый шаг цикл включен как макрос <> в <> ; первое параметр <> - это текст отображаемой ссылки, а второй Параметр - это значение, сохраняемое в указанной выше переменной.

Вот пример:

  Я съел бранч << cycle "$ brunch" autoselect >>
  << вариант "huevos rancheros" "яйца" >>
  << вариант "вафли" "вафли" >>
  << вариант "Кобб салат" "салат" >>
<>
  

В этом примере значение выбранной опции заканчивается в $ бранч , что затем вы можете использовать в следующем отрывке:

  Днем позже я с любовью вспомнил о бранче. 

Как выглядит:

Замена звеньев

При нажатии замещающая ссылка заменяется заданным текстом. Его довольно просто с синтаксической точки зрения:

  << linkreplace "исходный текст ссылки" >> замена <>
  

В следующем коде я показал, как можно создавать вложенные ссылки замены. для создания рекурсивно расширяющегося текста:

  Нет места лучше << linkreplace "home" >> my << linkreplace
"брат" >> сосед зятя по комнате в колледже <>
квартира <>. 

Как выглядит:

Синхронизированный текст

  << с таймером 100 мс >> Текст для отображения ... <>
  

  Совсем не так, это как ... \
<< по времени 1500 мс >> разное. \
<< следующие 2000 мс >> Как что-то совсем другое.\
<< следующие 2500 мс >> Вы даже не догадываетесь, что это такое.
<>
  

  << включить "Название перехода" "div" >>