☰

Как можно поместить скрытые данные в LaTeX?

tag-icon • tag-icon latex-misc
Как можно поместить скрытые данные в LaTeX?

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

\documentclass[12pt]{article}

\usepackage[parfill]{parskip}
\usepackage[none]{hyphenat}
\sloppy
\usepackage[usenames,dvipsnames]{xcolor}
\usepackage{array,ragged2e, calc}
\usepackage{enumitem}
\usepackage{lipsum}
\usepackage{needspace}

\definecolor{shadecolor}{RGB}{217,217,217}  % Color used for highlighting
\definecolor{light-blue}{RGB}{0,175,236}    % Color for the footer

% ------------------------------------------------------------------------------------
% Header and footer management.
% ------------------------------------------------------------------------------------
\usepackage{fancyhdr}
\pagestyle{fancy}

% clear any old style settings
\fancyhf{}
\fancyheadoffset{0in}
\headheight = 53pt
\renewcommand{\headrulewidth}{0pt}

% ------------------------------------------------------------------------------------
% Defining the section style
\newcommand{\mysectionstyle}[1]{\colorbox{shadecolor}{\begin{tabular}{>{}p{\rectanglelength}}{\fontsize{13}{6}\selectfont\textbf{#1}}\end{tabular}}\vspace{6pt}}
% ------------------------------------------------------------------------------------
\addtolength{\footskip}{0.6cm}
\renewcommand{\footrulewidth}{1pt}
\renewcommand{\footrule}{{\color{light-blue}%
\vskip-\footruleskip\vskip-\footrulewidth
\hrule width\headwidth height\footrulewidth\vskip\footruleskip}}
% ------------------------------------------------------------------------------------

\usepackage[left=0.75in,top=1.5in,right=0.75in,bottom=1in]{geometry} % Document margins
\usepackage{titlesec}

\newlength{\rectanglelength}
\setlength{\rectanglelength}{\textwidth}
\addtolength{\rectanglelength}{-6pt}

\newlength{\foo}

\begin{document}
\lipsum[1]

\settototalheight{\foo}{\parbox[t]{\linewidth}{\begin{minipage}[t]{\linewidth} \begin{tabular}{@{}>{\RaggedRight}p{11cm}>{\RaggedLeft}p{6.35cm}@{}}\fontsize{13}{6}\selectfont{LaTeX}&\textbf{2011 to 2012}\end{tabular}\\\begin{tabular}{@{}>{\RaggedRight}p{11cm}>{\RaggedLeft}p{6.35cm}@{}}\textbf{Lead Programmer}&\textbf{}\end{tabular}%
\vspace{3pt}\begin{itemize}[parsep=0pt, topsep=0pt, itemsep=0pt, leftmargin=2ex]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\end{itemize}%
\vspace{7pt}\textbf{End Title}\\\lipsum[1]

\vspace{10pt}\end{minipage}}
}
\needspace{\foo}{\setlength{\parskip}{4pt}

% ******* I WANT TO INSERT A TAG OR MARKER HERE.*******
\mysectionstyle{Experiences}

\begin{tabular}{@{}>{\RaggedRight}p{11cm}>{\RaggedLeft}p{6.35cm}@{}}\fontsize{13}{6}\selectfont{LaTeX}&\textbf{2011 to 2012}\end{tabular}\\\begin{tabular}{@{}>{\RaggedRight}p{11cm}>{\RaggedLeft}p{6.35cm}@{}}\textbf{Lead Programmer}&\textbf{}\end{tabular}%
\vspace{3pt}\begin{itemize}[parsep=0pt, topsep=0pt, itemsep=0pt, leftmargin=2ex]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\item \lipsum[1]\end{itemize}%
\vspace{7pt}\textbf{End Title}\\\lipsum[1]

\vspace{10pt}}
\end{document}

Я хочу вставить тег или маркер в файл LaTeX, чтобы при возникновении ошибки я мог извлечь маркер и вернуть понятное пользователю сообщение. Что-то вроде: в разделе X есть ошибка.

Возможно ли это в LaTeX? Если да, то как это сделать?

решение1

Я исхожу из варианта использования, описанного в вашем последнем абзаце:

Я хочу вставить тег или маркер в файл LaTeX, чтобы при возникновении ошибки я мог извлечь маркер и вернуть понятное пользователю сообщение. Что-то вроде: в разделе X есть ошибка.

Команда \showостановит набор текста и выведет на терминал описание следующего токена. Аналогично \showtheостановит и выведет значение счетчика.

При остановке набора текста iкоманда позволит вам вставить токены для обработки.

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

\documentclass{article}
\usepackage{lipsum}

\makeatletter
\newcommand{\showsection}{%
   \showthe\c@section 
}
\makeatother

\begin{document}

\section{First}

\lipsum

\section{Second}

\lipsum

\foo% undefined cs

\section{Third}

\lipsum

\end{document}

Вот пример сеанса консоли:

! Undefined control sequence.
l.20 \foo
         % undefined cs
? i \showsection
> 2.
\showsection ->\showthe \c@section 

l.20 \foo
         % undefined cs
? s
OK, entering \scrollmode...

Я набрал текст i \showsectionна строке ввода терминала, и он вывел: 2. Вы можете оформить вывод по своему усмотрению.

Что касается того, как "пометить" документ, я бы использовал то, что уже есть, и подключился к этим макросам. Например, заметил, что использовал существующий счетчик для номеров разделов, а не создал что-то новое. Если бы я хотел распечатать разделимяЯ мог бы добавить команды в \sectionмакрос, которые сохраняли бы заголовок раздела в макросе, и \showэто вместо этого. (Я этого не сделал, потому что если вы прочитаете исходный код, то увидите, что \sectionэто не простой макрос.)

решение2

Вы можете просто дать определение, например:

\def\thissection{section X}

то в сообщениях об ошибках, которые вы контролируете, вы можете использовать эту команду

\PackageError{mypackage}{You made a mistake in \thissection: try harder}{}

и он выберет текущее определение.

Однако вы не можете настроить обработчик ошибок самого TeX. Если, например, пользователь неправильно введет команду, \fooobarTeX выдаст свою неопределенную ошибку команды, и вы не сможете настроить используемое им сообщение об ошибке.

Связанный контент