Emacs для начинающих

       

Прямое форматирование


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

  • @emph{набранный-курсивом-текст}

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

    Пример:

    Для обработки файлов Texinfo

    пользуйтесь tex(1) @emph{а не}latex(1).

  • @strong{текст-набранный-жирным}

    Отображает текст-набранный-жирным шрифтом жирного начертания. В Info этому "примерно" соответствует символы "звездочка", охватывающие *текст-набранный-жирным*.

    Пример:

    Файлы Info @strong{не могут} содержать

    графику высокого разрешения.

  • @file{имя_файла}

    Выделяет имя_файла, окружая его одиночными кавычками, например так filename'. При подготовке версии для печати имя_файла печатается шрифтом пишущей машинки.

    Пример:

    Убедитесь, что в вашей Linux-системе

    установлена самая свежая версия @file{texinfo.tex}.



  • @url{универсальный-локатор-ресурса}

    Таким образом в тексте выделяется универсальный локатор ресурса (URL). В экранной версии универсальный-локатор-ресурса будет помещен в угловые скобки. При выводе на печать угловые скобки не добавляются, но универсальный-локатор-ресурса набирается моноширинным шрифтом "пишущей машинки".

    Пример:

    Дополнительная информация по Texinfo

    можно найти на @url{}.

  • @code{код-программы}

    Служит для выделения коротких участков программного кода.

    Предпочтительной является форма @code{bless}

    с двумя аргументами, поэтому всегда пишите

    @code{bless $objref, $class}.

  • @samp{текст, набираемый "как есть", буквально}

    Помечает символы, непосредственно набираемый текст, имена символов и т.д.

    Угловые скобки (@samp{<}, @samp{>}) являются

    основным разделителем в HTML.

  • @var{текст, подлежащий замене}

    Помечает мета-синтаксические [meta-syntactic] переменные, знаменитые foo и bar.

    Команды Perl @code{bless} лучше всего вызывать


    с двумя аргументами, например так @code{bless

    @var{object_reference}, @var{classname}}.


  • @kbd{названия клавиш}

    Помечает отдельные клавиши или серии клавиш.

    В emacs, нажмите @kbd{C-h i} для вызова

    встроенного браузера Info, или наберите @kbd{M-x

    info}.


  • @command{имя-команды}

    Помечает имя команды.

    Двумя наиболее важными командами шелла являются

    @command{ls} и @command{cd}.


  • @option{имя-опции}

    Метит имя опции командной строки @option вот так:

    Опция @option{--html} заставляет

    @command{makeinfo} создавать на выходе файл HTML

    вместо файла Info.

    @option не подходит для форматирования синопсиса команды. Для того, чтобы оформить краткое описание использования команды лучше воспользоваться окружением @example. Скажем так:

    @example

    makeinfo --html --output=@var{output-filename} @var{input-filename}

    @end example

    а в блоке текста к опциям обращаться, как @option{--html} и @option{--output}, а к аргументам команд как @var{output-filename} и @var{input-filename}.




  • Содержание раздела