tex2lyx - Интернет в облаке

ПРОГРАММА:

ИМЯ

tex2lyx - переводит LaTeX с хорошим поведением в LyX

СИНТАКСИС

Самый простой способ использования tex2lyx осуществляется через пункт меню File-> Import-> LaTeX (plain) в LyX.
Это работает tex2lyx для данного файла и загружает полученный файл в LyX. Ты должен попытаться
это первое и вызывайте его из командной строки только в том случае, если вам нужно использовать более сложные
настройки.

tex2lyx [ -userdir пользовательский каталог ] [ -системный каталог системный каталог ] [ -f ] [ -n ] [ -c текстовый класс ] [ -e
кодирование ] [ -fixedenc кодирование ] [ -m module1[,module2...]] [ -s профиль1[,профиль2...]] [
-скиподетей ] [ -поездка в оба конца ] [ -копифайлы ] входной_файл [ выходной файл ]

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-c Класс. По умолчанию, когда tex2lyx видит команду \ documentclass {foo}, он создает
файл текстового класса «foo» и читает файл макета LyX для этого класса (что-то
например /usr/local/share/lyx/layouts/foo.layout ИЛИ ГЛАВНАЯ/.lyx/layouts/foo.layout). Использовать
-c чтобы объявить другой текстовый класс (и прочитать другой файл макета).

Эта опция необходима, если входной файл является фрагментом LaTeX без преамбулы.
вопрос или команду \ begin {document}. Файлы LyX, созданные tex2lyx из частичных файлов
могут быть включены в существующий файл LyX с помощью команды «Включить файл LyX» из
Меню "Вставка" LyX.

-m Модуль. Загрузите данные модули. Это полезно, если tex2lyx не автоматически
обнаруживать данный модуль, но вы знаете модули, которые предоставляют некоторые команды или
среды, которые используются в импортированном файле. Модули загружаются в
данный заказ. Если модуль Foo зависит от модуля бар, бар должно быть дано до Foo.

-f Силы. tex2lyx не запустится, если файл .lyx, который он создаст, уже существует. Использовать
домен -f вариант (осторожно) затереть любые существующие файлы.

-e Укажите кодировку по умолчанию, используя имя LaTeX, как определено в файле кодировок.
tex2lyx будет использовать эту кодировку, но переключиться, если обнаружит изменение кодировки
команды на входе.

-fixedenc
Укажите кодировку, используя имя LaTeX, как определено в файле кодировок.
tex2lyx будет игнорировать любые команды изменения кодировки во входных данных.

-n Новеб. Переведите файл noweb (он же грамотное программирование). Это должно быть (почти?)
эквивалентно запуску «noweb2lyx foo.tex foo.lyx». Для этого варианта требуется -c
опцию.

-скиподетей
Не переводите дочерние документы, включенные через \ include и \ input. Этот вариант
полезно, если дочерние документы являются сгенерированными файлами и / или содержат много команд, которые
tex2lyx пока не понимает.

-s Файлы синтаксиса. Входные файлы синтаксиса (один или несколько в кавычках, разделенных запятыми) для чтения
дополнение к дефолту. (см. раздел о Синтаксис Файлы для более подробной информации).

-sysdir
Укажите системный каталог. Обычно в этом нет необходимости. Ваша система LyX
каталог выбран. Ср. подробности в разделе ФАЙЛЫ.

-userdir
Укажите каталог пользователя. Обычно в этом нет необходимости. Ваш пользователь LyX
каталог выбран. Ср. подробности в разделе ФАЙЛЫ.

-поездка в оба конца
Вызовите LyX, чтобы повторно экспортировать созданный выходной файл в LaTeX. Если имя выходного файла
не задано, определяется автоматически, чтобы избежать перезаписи входного файла
авария: Если входной файл назван foo.tex выходной файл будет назван
foo.lyx.lyx, и повторно экспортированный файл будет назван foo.lyx.tex.

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

-Помощь Помощь. Распечатайте информацию об использовании и выйдите.

-версия
Распечатайте номер версии и информацию о сборке и выйдите.

ОПИСАНИЕ

Введение
tex2lyx создаст файл LyX с указанным именем (или dir / foo.lyx если бы не было имени
дано) из файла LaTeX dir / foo.tex.

Поддерживаются суффиксы .tex, .ltx и .latex. Если входной_файл не существует и не
иметь один из этих суффиксов, tex2lyx постараюсь перевести входной файл.tex. (Это похоже
к поведению LaTeX.)

Цель tex2lyx переводить хорошо себя LaTeX2e в LyX. Если ваш файл LaTeX
не компилируется --- или если вы делаете странные вещи, например, переопределяете стандартные команды LaTeX --- он
может задохнуться. LaTeX209 часто переводится правильно, но это не гарантируется.

tex2lyx не хватает нескольких функций. Однако его основные цели:

· Пройдите через хорошо работающий файл LaTeX2e без сбоев

· Перевести большую часть этого файла.

· Локализуйте части, которые нельзя перевести, и скопируйте их в режиме TeX

Он довольно хорошо достигает этих основных целей для большинства файлов.

Применение
Вот более подробное описание того, что вам нужно сделать, чтобы перевести документ LaTeX в
ЛиХ.

· Запустить tex2lyx.

tex2lyx сообщит вам о его ходе и выдаст любые предупреждения для stderr, поэтому, если вы
вообще не хотите вывода, попробуйте (в csh) `tex2lyx foo.tex> & / dev / null '. Вам следует
НЕ перенаправлять стандартный вывод на foo.lyx.

· Запустите LyX (версия 2.1 или новее) с полученным файлом .lyx.

Теоретически большая часть файла будет переведена, и все, что
непереводимый будет переведен в код TeX (на языке LyX - ERT). Теоретически LyX будет
уметь читать в файле и создавать из него печатные документы, потому что все это
непереведенный материал ERT будет передан непосредственно обратно в LaTeX, который LyX использует как
бэкэнд. К сожалению, реальность не всегда отражает теорию. Если tex2lyx сбои, или
LyX не может прочитать сгенерированный файл LyX, см. Раздел ОШИБКИ ниже.

· Преобразуйте вещи, которые были вставлены как код TeX вручную, в функции LyX, если это возможно.

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

tex2lyx не гарантируется создание файла LyX, который генерирует точно такой же вывод
как файл LaTeX, хотя его цель - добиться этого. tex2lyx обычно будет ошибаться
сторона перевода меньше, чтобы гарантировать, что результирующие выходные файлы будут точными,
хотя это приводит к большему количеству кода TeX и меньшему количеству WYSIWYM.

· ПРОЧИТАЙТЕ ДОКУМЕНТ !!

Я уверен, что вы все равно планировали это сделать, но это особенно важно после
перевод документа LaTeX. tex2lyx лучше умеет «макро-перевод» (перевод
весь документ), чем «микроперевод» (перевод каждой мелочи). Для
Например, вы можете увидеть лишние или удаленные пробелы. Управляемость пространства улучшилась, но
это не идеально.

Что tex2lyx Может Обрабатывание
tex2lyx понимает многие команды LaTeX. Это переведет:

· Обычный текст, включая мини-команды типа ~, `', \ @, \ TeX, а также с диакритическими знаками
такие символы, как \ '{a}, и особые случаи? `и!`

· Команды заголовка, такие как \ author, \ date, \ title, \ thanks и абстрактное окружение

· Заголовочные команды, такие как \ section, включая команды, отмеченные звездочкой (\ section *)

· Среда: цитата, цитата и стих; по центру, заподлицо и заподлицо слева

· Перечислить, перечислить и описать среды, а также их команды \ item. Также,
хорошо продуманные вложенные списки

· Команды перекрестных ссылок: \ ref, \ pageref, \ label и \ cite

· \ Footnote и \ margin

· Команды изменения шрифта, включая \ em, \ emph, \ textit, и соответствующие команды для
изменить семейство, размер, серию и форму

· \ Input {foo} (или \ input {foo.blah}) и \ include {foo}. Обычный TeX \ команда ввода «\ input
foo.tex »также поддерживается.

· Табличное окружение и входящие в него команды, такие как \ hline, \ cline и
\ multicolumn (но см. ниже)

· Таблица и таблица окружений с плавающей запятой *, а также команды \ caption внутри них

· Плавающие окружения figure и figure *, а также команды включения графики \ epsf,
\ epsffile, \ epsfbox, \ epsfxsize, \ epsfig, \ psfig и \ includegraphics. Оба
поддерживаются графические и графические формы \ includegraphics.

· Среда thebibliography и команда \ bibitem, а также \ bibliography BibTeX
и команды \ bibliographystyle

· Разные команды: \ hfill, \\, \ noindent, \ ldots ...

· Окружения, относящиеся к классам документов (и некоторые команды), которые могут быть переведены на LyX
макеты

· Аргументы некоторых непереводимых команд (например, \ mbox)

Часть этой поддержки, возможно, еще не на 100%. Подробнее см. Ниже

tex2lyx копирует математику (почти) дословно из вашего файла LaTeX. К счастью, LyX читает в LaTeX.
math, поэтому (почти) любая математика, поддерживаемая LyX, должна работать нормально.

tex2lyx будет копировать любые команды преамбулы (т. е. все, что находится перед \ begin {document}) дословно.
Таким образом, модные вещи, которые у вас есть в преамбуле, должны быть сохранены в печатных документах.
хотя, конечно, он не будет отображаться в окне LyX. Проверьте Документ-> Настройки-> LaTeX
Преамбула, чтобы увидеть результат.

Что tex2lyx Не может Обрабатывание Напишите нам в чат или Email Но это OK
· Некоторые команды интервалов (\ hspace, \ pagebreak и \ linebreak)

· \ Центрирование, \ рваное влево, \ рваное вправо

· \ Verb и дословное окружение. tex2lyx осторожно копировать точно, в таком случае,
включая комментарии и пробелы.

· Неизвестные (например, определяемые пользователем) среды и команды

tex2lyx дословно копирует неизвестные команды вместе с их аргументами в файл LyX.
Кроме того, если он видит \ begin {foo}, где он не распознает среду «foo», он
копируйте дословно, пока не увидите \ end {foo} (если вы не используете -r вариант). Большинство из них
неизвестные команды не вызовут tex2lyx сломать; они просто потребуют от вас
редактирование после загрузки файла в LyX. Это должно быть менее болезненно, чем редактирование
файл .tex или .lyx с помощью текстового редактора.

Что tex2lyx Ручки Плохо Напишите нам в чат или Email ака ОШИБКИ
С tex2lyx относительно новый, в нем есть ряд проблем. По мере созревания эти ошибки
будет раздавлен.

· «Точное» копирование неизвестных сред и команд не совсем точное. Это будет
дают уродливый LyX, но почти во всех случаях результат будет одинаковым. Однако большинство
части файла будут скопированы идеально, включая пробелы и комментарии. Этот
включает в себя: преамбулу LaTeX, дословное окружение, а также команды \ verb и
пропускать блоки.

· tex2lyx переводит только часть параметров класса документа в собственные функции.
Остальные параметры помещаются в поле «Параметры» во всплывающем окне «Документ-> Настройки».

Важнее, tex2lyx не переводит команды \ newcommands, unknown \ usepackage
и другой неизвестный код в преамбуле. Он просто копирует это в преамбулу LaTeX.
Если вы используете специальные команды, например, чтобы указать макет текста таким образом, чтобы
понимается LyX, tex2lyx не распознает его. Обратите внимание, что эти настройки будут
перезаписывается, если вы изменяете макет текста в настройках документа LyX. Лучше удалить
эти специальные параметры из преамбулы LaTeX (Документ-> Настройки-> Преамбула LaTeX) и
если возможно, используйте соответствующие настройки документа LyX.

· В классе документов фольги есть пара ошибок. tex2lyx может делать странные вещи с
необязательные аргументы для команд \ foilhead. Также он может обрабатывать \ begin {dinglist}
неправильно (хотя вещи в окружении должны нормально переводиться).

Все известные баги tex2lyx Можно найти на http://www.lyx.org/trac/wiki/BugTrackerHome.

tex2lyx довольно надежный. Как упоминалось выше, он может не переводить ваш файл идеально,
но результат должен быть пригодным для использования и не должен падать. Если у вас возникнут проблемы --- и
проблема не в одной из упомянутых выше или
http://www.lyx.org/trac/wiki/BugTrackerHome--- сообщите о проблеме, как описано в
раздел о Ошибка Отчеты.

Что Ликс Не может Обрабатывание
В самом LyX отсутствует пара функций, например, даже если tex2lyx переводит вещи
в идеале, LyX все еще может иметь проблемы с его чтением. Если вам действительно нужны эти функции, вы
можете экспортировать ваш окончательный документ как LaTeX и вернуть его. См. ОШИБКИ Больше подробностей
об этих ошибках.

· Для ряда команд (например, \\) LyX не поддерживает необязательный аргумент.
tex2lyx автоматически отбрасывает необязательные аргументы с предупреждением для stdout.
LyX также игнорирует аргумент ширины для среды библиографии.

· Поддержка LyX для таблиц не идеальна. Для сложных таблиц используйте блок «пропустить», поэтому
что они будут скопированы в режиме TeX.

· LyX позволяет фигурам иметь размеры в единицах, известных TeX, таких как дюймы, см и т. Д.
также переводит проценты от \ textwidth, \ textheight, \ columnwidth, но никакие другие
длины (например, если вы по какой-то причине хотели масштабировать фигуру до размера \ topmargin).
tex2lyx скопирует фигуры непереводимого размера в режиме TeX. Опять же, ты мог бы быть
в состоянии исправить это в LyX.

ПРИМЕРЫ

tex2lyx -f -r «Myenv» foo.tex

Приведенное выше создаст файл foo.lyx из foo.tex, при необходимости перезаписав его. Когда это
находит блок \ begin {myenv} ... \ end {myenv}, он переведет содержимое этого блока,
но скопируйте команды \ begin и \ end в режиме TeX.

tex2lyx -n -c «Грамотная статья» foo.tex

Приведенное выше преобразует документ noweb в документ LyX с грамотной статьей. Пользователь бы
сделайте это, если в документе noweb была статья класса документа.

ПРИМЕЧАНИЯ

Ошибка Отчеты
Об ошибках следует сообщать в систему отслеживания ошибок LyX по адресу
http://www.lyx.org/trac/wiki/BugTrackerHome. Кроме того, вы можете отправить сообщение в
Список рассылки разработчиков LyX. Его адрес в настоящее время [электронная почта защищена]. Если ваш
сообщение возвращается, вы можете проверить домашнюю страницу LyX, http://www.lyx.org/, Если вы работаете
tex2lyx на большом файле, пожалуйста, не отправляйте весь вывод в своем отчете об ошибке. Просто
включить последние десять или двадцать строк вывода вместе с частью файла LaTeX, который он
разбился. Или, что еще лучше, прикрепите небольшой, но полный файл, который вызывает то же
проблема в качестве исходного файла.

Планировка Файлы
tex2lyx читает файл макета LyX, чтобы знать, как работать со средами и командами LaTeX
которые переводятся в макеты LyX. Этот файл будет включать все "нормальные" нематематические
среды (т. е. включая цитаты и элементы, но не таблицы, мини-страницы и некоторые другие
причудливые среды) и такие команды, как \ section и \ title. Если вы хотите использовать tex2lyx класс
у которого нет существующего файла макета, тогда вам придется создать файл макета. Но
вы все равно должны это сделать, чтобы LyX файл, поскольку LyX зависит от файлов макета для
знать, как отображать и обрабатывать свои файлы. Обратитесь к документации LyX за помощью с этим.
задача (которая может быть сложной или легкой, в зависимости от класса, в котором вы хотите создать файл макета
для.) Если ваш класс очень похож на класс, у которого есть файл макета, рассмотрите
используя -c опцию.

Синтаксис Файлы
tex2lyx всегда читает хотя бы один файл синтаксиса, называемый файлом синтаксиса по умолчанию. tex2lyx
прочитает ваш личный файл синтаксиса, если он существует; в противном случае он будет читать общесистемный
. tex2lyx будет читать дополнительные файлы синтаксиса, если вы укажете их с помощью -s опцию.
(Эти дополнительные файлы должны иметь тот же формат, что и файл по умолчанию, но, как правило,
короче, поскольку им нужно только указать дополнительные команды, которых нет в файле по умолчанию.) A
файл синтаксиса сообщает tex2lyx несколько вещей.

Во-первых, он описывает синтаксис каждой команды, то есть сколько требуемых аргументов и
сколько необязательных аргументов принимает команда. Знание этого облегчает tex2lyx в
копировать (в режиме TeX) команды, которые он не умеет переводить. Файл синтаксиса просто
имеет команду, за которой следуют фигурные скобки или скобки, описывающие ее аргументы в правильном
порядок. Например, запись в файле синтаксиса \ bibitem [] {} означает, что команда \ bibitem принимает
необязательный аргумент, за которым следует обязательный, а запись \ bf означает, что \ bf
команда вообще не принимает аргументов. Когда tex2lyx встречает токен, о котором не знает
как перевести в LyX, он скопирует токен --- вместе с правильным количеством
аргументы --- точно. Если токена нет в файле синтаксиса, тогда tex2lyx просто копирует как
много аргументов, как он находит. Это означает, что он может копировать слишком много. Но поскольку пользователь может
указать дополнительные файлы синтаксиса, что должно происходить нечасто.

Некоторые команды, которые нельзя перевести в LyX, например \ mbox, имеют в качестве одного из аргументов
обычный текст LaTeX. Если строка «translate» вставлена ​​в аргумент
(непереводимо) команду в файле синтаксиса, затем tex2lyx переведу этот аргумент
вместо того, чтобы копировать его дословно. Так, например, файл синтаксиса по умолчанию имеет
\ raisebox {} [] [] {перевод}. Это означает, что команда \ raisebox и первый аргумент
(и необязательные аргументы, если они существуют) копируются в режиме TeX, но последний аргумент
(который может содержать математику, сложный LaTeX, другие непереводимые команды и т. д.) будет
переведен на LyX. Вы не можете использовать «перевод» для необязательных аргументов.

Файлы с пользовательским синтаксисом могут определять новые команды и их синтаксис или переопределять
количество аргументов для команды, заданное в файле синтаксиса по умолчанию. (Например, если вы
используя стиль, который дает дополнительный аргумент какой-либо команде ...) Однако это будет только
полезно для команд, скопированных в режиме TeX. Команды, которые фактически переводятся tex2lyx
(например, \ item) имеют жестко запрограммированный синтаксис аргументов. Жестко запрограммированные команды идентифицированы
в файле синтаксиса по умолчанию.

Во-вторых, файл синтаксиса описывает любые «обычные среды». Обычно все неизвестное
окружение будет скопировано в режиме TeX. Однако если вы определите обычную среду «foo»,
тогда в режиме TeX будут скопированы только команды \ begin {foo} и \ end {foo}; текст
в среде будут обрабатываться (т. е. переводиться) tex2lyx как обычный LaTeX,
вместо копирования в режим TeX. Не пытайтесь объявлять «табуляцию» и «картинку» как
обычные среды, так как текст в этих средах будет путать tex2lyx; использовать этот
возможность создания новых сред, которые вы создаете с простым текстом, математикой или простыми командами
в них. Вы также не можете объявить неизвестные математические среды (например, уравнение *) как обычные.
среды также, поскольку математический редактор LyX их не поймет. Имена
появляются обычные окружения, разделенные пробелами, между \ begin {tex2lyxre} и
Операторы \ end {tex2lyxre} в файле синтаксиса. (Если у вас есть обычная среда,
вы не будете использовать очень часто, вы можете использовать -r вариант, а не писать файл синтаксиса.)

ПРЕДУПРЕЖДЕНИЯ

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

Если вы импортируете foo.tex для создания foo.lyx, затем отредактируете foo.lyx и хотите повторно экспортировать его, обратите внимание
что он перезапишет исходный файл foo.tex. (LyX спросит вас, хотите ли вы перезаписать
Это.)

ОКРУЖАЮЩАЯ СРЕДА

LYX_DIR_21x
можно использовать, чтобы указать, какой системный каталог использовать.

Системный каталог определяется путем поиска файла «chkconfig.ltx». Справочники
ищутся в таком порядке:
1) -sysdir параметр командной строки
2) переменная окружения LYX_DIR_21x
3) Может быть / TOP_SRCDIR / lib
4) /../Поделиться/ /
5) жестко запрограммированный lyx_dir (во время сборки: / usr / share / lyx)

LYX_USERDIR_21x
можно использовать, чтобы указать, какой пользовательский каталог использовать.

Каталог пользователя в порядке приоритета:
1) -userdir параметр командной строки
2) переменная окружения LYX_USERDIR_21x
3) $ HOME /. если нет явной настройки

Используйте tex2lyx онлайн с помощью сервисов onworks.net