ФЭНДОМ


Прямо предшествуют телу скрипта. Каждый скрипт должен иметь заголовок, чтобы определить назначение и другие аттрибуты скрипта. Заголовок может содержать имя скрипта, автора, данные, версию, имя файла, дополнительную информацию. В REBOL-файлах данных, которые не связаны прямым определением не требуется заголовка. Заголовки используются по нескольким причинам:

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

Общая форма заголовка скрипта выглядит так:

REBOL [block]

Чтобы интерпретатор узнал заголовок, блок должен следовать за словом REBOL. Только следует поставить пробел (пространство, табуляцию или линии) между словом и блоком. Блок, что следует за словом REBOL есть объект дефиниция, которая описывает скрипт. Предпочтительный минимальный заголовок:

REBOL [
    Title:  "Scan Web Sites"
    Date:   2-Feb-2000
    File:   %webscan.r
    Author: "Jane Doer"
    Version: 1.2.3
]

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

REBOL [
    Title: "Scan Web Sites"
    Date:   12-Nov-1997
    Author: ["Ema User" "Wasa Writer"]
]

Заголовок может быть более сложным, предоставлять информацию об авторе, копирайте, форматировании, требуемой версии, истории ревизий и так далее. Блок, используемый для конструирования заголовка - объект и может расширяться новой информацией. Полный заголовок может выглядеть похожим на этот:

REBOL [
    Title:   "Full REBOL Header Example"
    Date:    8-Sep-1999
    Name:    'Full-Header  ; For window title bar

    Version: 1.1.1
    File:    %headfull.r
    Home:    http://www.rebol.com/rebex/

    Author:  "Carl Sassenrath"
    Owner:   "REBOL Headquarters"
    Rights:  "Copyright (C) Carl Sassenrath 1999"

    Needs:   [2.0 ODBC]
    Tabs:    4

    Purpose: {
        The purpose or general reason for the program
        should go here.
    }

    Note: {
        An important comment or notes about the program
        can go here.
    }

    History: [
        0.1.0 [5-Sep-1999 "Created this example" "Carl"]
        0.1.1 [8-Sep-1999 {Moved the header up, changed
            comment on extending the header, added
            advanced user comment.} "Carl"]
    ]

    Language: 'English
]