Compare commits
9 Commits
4f0c2ce16d
...
d5b6f4b89e
| Author | SHA1 | Date | |
|---|---|---|---|
 Arseny
|
d5b6f4b89e | ||
|
Arseny
|
82cde7b94b | ||
|
Arseny
|
2a0333c673 | ||
|
Arseny
|
a3d41af022 | ||
|
Arseny
|
7f20bd9831 | ||
|
Arseny
|
c765892d7d | ||
|
Arseny
|
5ebdf8f9db | ||
|
Arseny
|
f426e865b5 | ||
|
Arseny
|
6b1f508825 |
@@ -15,8 +15,8 @@ _CAPTION_RE = re.compile(r"^\s*Листинг\s+\d+\s*[—–-]+\s*(.+?)\s*$")
|
||||
# подсветки код набирается моноширинным без выделения ключевых слов.
|
||||
_LANGUAGES = {
|
||||
"c": "C",
|
||||
"c++": "C++",
|
||||
"cpp": "C++",
|
||||
"c++": "[modern]C++",
|
||||
"cpp": "[modern]C++",
|
||||
"bash": "bash",
|
||||
"sh": "bash",
|
||||
"shell": "bash",
|
||||
@@ -51,9 +51,15 @@ def _lstlisting(tok: Token, caption: str | None) -> str:
|
||||
language = _language(tok.info)
|
||||
opts = []
|
||||
if language:
|
||||
opts.append(f"language={language}")
|
||||
# Значение в фигурных скобках обязательно: имя диалекта задаётся
|
||||
# квадратными скобками (`[modern]C++`), и без обёртки парсер опций
|
||||
# listings принимает их за начало следующего опционального аргумента.
|
||||
opts.append(f"language={{{language}}}")
|
||||
if caption:
|
||||
opts.append(f"caption={{{escape_latex(caption)}}}")
|
||||
# Плавающий листинг не разрывается между страницами: иначе рамка кода
|
||||
# обрывается на границе и продолжается на следующей странице.
|
||||
opts.append("float=htbp")
|
||||
suffix = f"[{','.join(opts)}]" if opts else ""
|
||||
return f"\\begin{{lstlisting}}{suffix}\n{tok.content.rstrip()}\n\\end{{lstlisting}}"
|
||||
|
||||
|
||||
@@ -14,7 +14,10 @@
|
||||
- абзац с картинкой и посторонним текстом не является рисунком: инлайн-
|
||||
картинка внутри текста пропускается с предупреждением;
|
||||
- ширина задаётся суффиксом ``|N`` или ``|N%`` (доля от textwidth),
|
||||
по умолчанию 80 %.
|
||||
по умолчанию 80 %;
|
||||
- размещение ``[ht]``, а не ``[H]``: жёсткая привязка к месту оставляла до
|
||||
половины страницы пустой, когда рисунок не помещался в её остаток. ГОСТ
|
||||
допускает перенос иллюстрации на следующую страницу.
|
||||
|
||||
Паттерн чистый: match() смотрит на срез токенов, render_figure() строит
|
||||
LaTeX из того же среза; renderer.pos двигает рендерер.
|
||||
@@ -93,7 +96,7 @@ def figure(tokens: list[Token]) -> str:
|
||||
caption = escape_latex(m.group(1))
|
||||
|
||||
lines = [
|
||||
"\\begin{figure}[H]",
|
||||
"\\begin{figure}[ht]",
|
||||
" \\centering",
|
||||
rf" \includegraphics[width={width}]{{\detokenize{{{path}}}}}",
|
||||
]
|
||||
|
||||
@@ -6,6 +6,7 @@
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import sys
|
||||
|
||||
from markdown_it.token import Token
|
||||
@@ -32,9 +33,25 @@ def escape_latex(text: str) -> str:
|
||||
return text.translate(_LATEX_SPECIAL)
|
||||
|
||||
|
||||
# Инициалы не должны отрываться друг от друга и от фамилии переносом строки:
|
||||
# «/ И.» на одной строке и «В. Гилев» на следующей — ошибка оформления списка
|
||||
# источников. Связывается одиночная заглавная буква с точкой и следующее слово,
|
||||
# начинающееся с заглавной.
|
||||
_INITIALS_RE = re.compile(r"(?<![\w.])([A-ZА-ЯЁ]\.)\s+(?=[A-ZА-ЯЁ])")
|
||||
|
||||
|
||||
def bind_initials(text: str) -> str:
|
||||
"""Заменить пробел после инициала на неразрывный."""
|
||||
previous = None
|
||||
while previous != text:
|
||||
previous = text
|
||||
text = _INITIALS_RE.sub(r"\1~", text)
|
||||
return text
|
||||
|
||||
|
||||
@inline("text")
|
||||
def _text(tok: Token) -> str:
|
||||
return escape_latex(tok.content)
|
||||
return bind_initials(escape_latex(tok.content))
|
||||
|
||||
|
||||
@inline("strong_open")
|
||||
|
||||
@@ -33,6 +33,18 @@ from md2gost.registry import block, pattern
|
||||
|
||||
_CAPTION_RE = re.compile(r"^\s*Таблица\s+\d+\s*[—–-]+\s*(.+?)\s*$")
|
||||
|
||||
# Длина слова, начиная с которой ему нужны точки разрыва. Идентификаторы вроде
|
||||
# HackRFTestingServer:идентификатор не содержат пробелов и дефисов, поэтому в
|
||||
# узкой колонке LaTeX не может их перенести: строка уезжает за границу колонки
|
||||
# и печатается поверх соседней.
|
||||
_LONG_WORD = 18
|
||||
|
||||
# Колонка, где самое длинное значение короче этого, в растягивании не нуждается:
|
||||
# отдав ей равную долю ширины, мы отнимаем место у колонок с текстом, и те
|
||||
# начинают переноситься по одному слову.
|
||||
_NARROW_CELL = 16
|
||||
_BREAK_AFTER = ":/_.-"
|
||||
|
||||
_ALIGN_BY_STYLE = {
|
||||
"text-align:left": "l",
|
||||
"text-align:center": "c",
|
||||
@@ -40,6 +52,26 @@ _ALIGN_BY_STYLE = {
|
||||
}
|
||||
|
||||
|
||||
def _breakable(cell: str) -> str:
|
||||
"""Расставить точки переноса внутри длинных слов ячейки.
|
||||
|
||||
Ячейка уже отрендерена в LaTeX, поэтому слова с обратной косой чертой или
|
||||
фигурными скобками пропускаются: вставка внутрь имени команды сломала бы её.
|
||||
"""
|
||||
words = []
|
||||
for word in cell.split(" "):
|
||||
if len(word) < _LONG_WORD or any(ch in word for ch in "\\{}"):
|
||||
words.append(word)
|
||||
continue
|
||||
out = []
|
||||
for ch in word:
|
||||
out.append(ch)
|
||||
if ch in _BREAK_AFTER:
|
||||
out.append("\\allowbreak ")
|
||||
words.append("".join(out))
|
||||
return " ".join(words)
|
||||
|
||||
|
||||
def _cell_align(tok: Token) -> str:
|
||||
style = str(tok.attrGet("style") or "").replace(" ", "")
|
||||
return _ALIGN_BY_STYLE.get(style, "l")
|
||||
@@ -69,7 +101,7 @@ def _collect_rows(
|
||||
pos += 1
|
||||
break
|
||||
if ctok.type in ("th_open", "td_open"):
|
||||
row.append(render_inline(tokens[pos + 1]))
|
||||
row.append(_breakable(render_inline(tokens[pos + 1])))
|
||||
row_aligns.append(_cell_align(ctok))
|
||||
pos += 3
|
||||
else:
|
||||
@@ -100,8 +132,14 @@ def _tabular(rows: list[list[str]], aligns: list[str]) -> str:
|
||||
row.extend([""] * (cols - len(row)))
|
||||
|
||||
spec = list(aligns[:cols]) + ["l"] * max(0, cols - len(aligns))
|
||||
stretchable = "l" in spec
|
||||
col_spec = "|".join(_STRETCH if col == "l" else col for col in spec)
|
||||
widths = [max(len(row[i]) for row in rows) for i in range(cols)]
|
||||
stretch = [
|
||||
align == "l" and width >= _NARROW_CELL for align, width in zip(spec, widths)
|
||||
]
|
||||
stretchable = any(stretch)
|
||||
col_spec = "|".join(
|
||||
_STRETCH if is_wide else col for col, is_wide in zip(spec, stretch)
|
||||
)
|
||||
|
||||
env = "tabularx" if stretchable else "tabular"
|
||||
width = "{\\textwidth}" if stretchable else ""
|
||||
@@ -153,7 +191,7 @@ def captioned_table(tokens: list[Token]) -> str:
|
||||
|
||||
return "\n".join(
|
||||
[
|
||||
"\\begin{table}[H]",
|
||||
"\\begin{table}[ht]",
|
||||
f" \\caption{{{caption}}}",
|
||||
" \\centering",
|
||||
_tabular(rows, aligns),
|
||||
|
||||
@@ -39,9 +39,14 @@ def abbreviations(text: str) -> str:
|
||||
for abbr, desc in rows:
|
||||
pad = max_abbr - len(abbr) + 2
|
||||
tabular_rows.append(
|
||||
f"{abbr} {' ' * pad}& \\hangafter=1\\hangindent=2em ------ {desc} \\\\"
|
||||
f"{abbr} {' ' * pad}& \\hangafter=1\\hangindent=2em --- {desc} \\\\"
|
||||
)
|
||||
|
||||
col_spec = f"@{{\\hspace{{0pt}}}}p{{{abbr_col}em}}@{{\\hspace{{0pt}}}}p{{\\dimexpr\\linewidth-{abbr_col}em\\relax}}"
|
||||
# Отбивки колонок убраны с обеих сторон и между ними: иначе сумма ширин
|
||||
# превышает \linewidth на 2\tabcolsep и перечень выходит за правое поле.
|
||||
col_spec = (
|
||||
f"@{{\\hspace{{0pt}}}}p{{{abbr_col}em}}"
|
||||
f"@{{}}p{{\\dimexpr\\linewidth-{abbr_col}em\\relax}}@{{\\hspace{{0pt}}}}"
|
||||
)
|
||||
body = "\n".join(tabular_rows)
|
||||
return f"\\noindent\\begin{{tabular}}{{{col_spec}}}\n{body}\n\\end{{tabular}}"
|
||||
|
||||
@@ -0,0 +1,128 @@
|
||||
"""Разбор журнала xelatex: ошибки, предупреждения и дефекты вёрстки.
|
||||
|
||||
Без этого разбора журнал остаётся во временном каталоге сборки и исчезает
|
||||
вместе с ним — при запуске в контейнере узнать о выходе текста за поле
|
||||
можно было только открыв PDF и заметив это глазом.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from dataclasses import dataclass
|
||||
|
||||
# «Overfull \hbox (56.7pt too wide) in alignment at lines 220--220»
|
||||
# «Underfull \hbox (badness 7000) in paragraph at lines 10--11»
|
||||
# «Overfull \hbox (7.2pt too wide) detected at line 14»
|
||||
_BOX_RE = re.compile(
|
||||
r"^(?P<kind>Overfull|Underfull)\s+\\hbox\s+"
|
||||
r"\((?:(?P<pt>[\d.]+)pt too wide|badness (?P<badness>\d+))\)"
|
||||
r"(?:.*?(?:at lines (?P<lines>\d+)--\d+|detected at line (?P<line>\d+)))?",
|
||||
re.MULTILINE,
|
||||
)
|
||||
_ERROR_RE = re.compile(r"^! (?P<message>.+)$", re.MULTILINE)
|
||||
_WARNING_RE = re.compile(
|
||||
r"^(?P<message>(?:LaTeX|Package|Class)[^\n]*Warning:[^\n]*"
|
||||
r"(?:\n(?!\s*$)(?!(?:LaTeX|Package|Class)[^\n]*Warning:)[^\n]*)*)",
|
||||
re.MULTILINE,
|
||||
)
|
||||
|
||||
# Пакет unicode-math на каждой сборке сообщает, что перекрывает команды
|
||||
# mathtools. Это ожидаемо и ничего не требует, но два многострочных сообщения
|
||||
# в каждом документе заглушают собой те предупреждения, на которые надо смотреть.
|
||||
_IGNORED_WARNINGS = (
|
||||
"unicode-math Warning: Using \\overbracket",
|
||||
"unicode-math Warning: I'm going to overwrite",
|
||||
# Оформление подписей объявлено в преамбуле для всех видов объектов сразу;
|
||||
# в документе без таблиц или листингов часть настроек закономерно не нужна.
|
||||
"caption Warning: Unused \\captionsetup",
|
||||
)
|
||||
|
||||
# Виды, при которых --strict считает сборку неудачной. Разреженные строки и
|
||||
# предупреждения пакетов бывают следствием намеренной вёрстки (растяжки на
|
||||
# титульном листе), а выход текста за поле — всегда видимый брак.
|
||||
STRICT_KINDS = ("error", "overfull")
|
||||
|
||||
_TITLES = {
|
||||
"error": "ошибки LaTeX",
|
||||
"warning": "предупреждения LaTeX",
|
||||
"overfull": "текст выходит за правое поле",
|
||||
"underfull": "разреженные строки",
|
||||
}
|
||||
_MAX_PER_KIND = 20
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class Diagnostic:
|
||||
kind: str
|
||||
message: str
|
||||
line: int | None = None
|
||||
amount: float | None = None
|
||||
|
||||
|
||||
def parse_log(
|
||||
text: str,
|
||||
*,
|
||||
overfull_threshold_pt: float = 1.0,
|
||||
underfull_threshold: int = 5000,
|
||||
) -> list[Diagnostic]:
|
||||
"""Диагностика из журнала сборки.
|
||||
|
||||
Пороги отсекают шум: вылет в доли пункта глазом не виден, а строки с
|
||||
небольшой разреженностью встречаются в любом нормально свёрстанном тексте.
|
||||
"""
|
||||
diags: list[Diagnostic] = []
|
||||
|
||||
for match in _ERROR_RE.finditer(text):
|
||||
diags.append(Diagnostic("error", match.group("message").strip()))
|
||||
|
||||
for match in _WARNING_RE.finditer(text):
|
||||
message = " ".join(match.group("message").split())
|
||||
if any(noise in message for noise in _IGNORED_WARNINGS):
|
||||
continue
|
||||
diags.append(Diagnostic("warning", message))
|
||||
|
||||
for match in _BOX_RE.finditer(text):
|
||||
line_group = match.group("lines") or match.group("line")
|
||||
line = int(line_group) if line_group else None
|
||||
if match.group("pt") is not None:
|
||||
amount = float(match.group("pt"))
|
||||
if amount < overfull_threshold_pt:
|
||||
continue
|
||||
diags.append(Diagnostic("overfull", match.group(0).strip(), line, amount))
|
||||
else:
|
||||
badness = float(match.group("badness"))
|
||||
if badness < underfull_threshold:
|
||||
continue
|
||||
diags.append(Diagnostic("underfull", match.group(0).strip(), line, badness))
|
||||
|
||||
return diags
|
||||
|
||||
|
||||
def _describe(diag: Diagnostic) -> str:
|
||||
where = f"строка {diag.line}" if diag.line is not None else "место не указано"
|
||||
if diag.kind == "overfull":
|
||||
return f" {where}: на {diag.amount:.1f} pt шире поля"
|
||||
if diag.kind == "underfull":
|
||||
return f" {where}: разреженность {diag.amount:.0f}"
|
||||
return f" {diag.message}"
|
||||
|
||||
|
||||
def format_diagnostics(diags: list[Diagnostic]) -> str:
|
||||
"""Человекочитаемая сводка; пустая строка, если сообщать не о чем."""
|
||||
if not diags:
|
||||
return ""
|
||||
|
||||
blocks: list[str] = []
|
||||
for kind in ("error", "warning", "overfull", "underfull"):
|
||||
group = [d for d in diags if d.kind == kind]
|
||||
if not group:
|
||||
continue
|
||||
if kind in ("overfull", "underfull"):
|
||||
group.sort(key=lambda d: d.amount or 0.0, reverse=True)
|
||||
lines = [f"{_TITLES[kind]}: {len(group)}"]
|
||||
lines += [_describe(d) for d in group[:_MAX_PER_KIND]]
|
||||
if len(group) > _MAX_PER_KIND:
|
||||
lines.append(f" и ещё {len(group) - _MAX_PER_KIND}")
|
||||
blocks.append("\n".join(lines))
|
||||
|
||||
return "\n".join(blocks)
|
||||
+67
-13
@@ -14,8 +14,10 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\usepackage{graphicx}
|
||||
\graphicspath{ {./} {./images/} }
|
||||
\usepackage{float}
|
||||
\usepackage[section]{placeins}
|
||||
\usepackage{wrapfig}
|
||||
\sloppy
|
||||
\setlength{\emergencystretch}{2em}
|
||||
\clubpenalty=10000
|
||||
\widowpenalty=10000
|
||||
\usepackage{enumitem}
|
||||
@@ -28,17 +30,47 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\captionsetup[figure]{labelsep=emdash,font=onehalfspacing,position=bottom,name=Рисунок}
|
||||
\captionsetup[table]{labelsep=emdash,font=onehalfspacing,position=top,name=Таблица,singlelinecheck=false,justification=raggedright}
|
||||
\usepackage{listings}
|
||||
\usepackage{xcolor}
|
||||
|
||||
% Палитра подсветки. Тона различаются не только цветом, но и светлотой,
|
||||
% поэтому листинг остаётся читаемым и на чёрно-белой печати.
|
||||
\definecolor{lstkeyword}{RGB}{0,0,139}
|
||||
\definecolor{lstcomment}{RGB}{110,110,110}
|
||||
\definecolor{lststring}{RGB}{139,0,0}
|
||||
\definecolor{lstlineno}{RGB}{130,130,130}
|
||||
|
||||
% Встроенный диалект C++ в listings старше стандарта: auto, nullptr, override
|
||||
% и прочее он не знает. Расширяем его, а не подменяем, чтобы сохранить разбор
|
||||
% строк, комментариев и препроцессора.
|
||||
\lstdefinelanguage[modern]{C++}[ISO]{C++}{%
|
||||
morekeywords={%
|
||||
auto,nullptr,constexpr,consteval,constinit,noexcept,override,final,%
|
||||
decltype,static_assert,thread_local,alignas,alignof,concept,requires,%
|
||||
co_await,co_yield,co_return,import,module,%
|
||||
Q_OBJECT,Q_SLOTS,Q_SIGNALS,Q_PROPERTY,signals,slots,emit%
|
||||
}%
|
||||
}
|
||||
|
||||
\lstset{
|
||||
basicstyle=\ttfamily\small\setstretch{1.0},
|
||||
keywordstyle=\bfseries\color{lstkeyword},
|
||||
% Начертание прямое: курсива кириллицы в моноширинном шрифте нет, и
|
||||
% комментарий распадался бы на прямые русские и курсивные латинские слова.
|
||||
commentstyle=\color{lstcomment},
|
||||
stringstyle=\color{lststring},
|
||||
numberstyle=\scriptsize\color{lstlineno},
|
||||
identifierstyle=,
|
||||
breakatwhitespace=false,
|
||||
breaklines=true,
|
||||
captionpos=t,
|
||||
inputencoding=utf8,
|
||||
frame=single,
|
||||
keepspaces=true,
|
||||
keywordstyle=\bf,
|
||||
numbers=left,
|
||||
numbersep=5pt,
|
||||
numbersep=7pt,
|
||||
aboveskip=0.7\baselineskip,
|
||||
belowskip=0.4\baselineskip,
|
||||
postbreak=\mbox{\textcolor{lstlineno}{$\hookrightarrow$}\space},
|
||||
xleftmargin=25pt,
|
||||
xrightmargin=25pt,
|
||||
showspaces=false,
|
||||
@@ -62,9 +94,9 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\titleformat{\section}{\fontsize{14pt}{18pt}\selectfont\bfseries}{}{0em}{\thesection. }
|
||||
\titleformat{\subsection}{\fontsize{14pt}{18pt}\selectfont\bfseries}{}{0em}{\thesubsection. }
|
||||
\titleformat{\subsubsection}{\fontsize{14pt}{18pt}\selectfont\bfseries}{}{0em}{\thesubsubsection. }
|
||||
\titlespacing*{\section}{1.25cm}{0.5ex plus 0.2ex minus 0.2ex}{0.3ex plus 0.1ex minus 0.1ex}
|
||||
\titlespacing*{\subsection}{1.25cm}{0.5ex plus 0.2ex minus 0.2ex}{0.3ex plus 0.1ex minus 0.1ex}
|
||||
\titlespacing*{\subsubsection}{1.25cm}{0.5ex plus 0.2ex minus 0.2ex}{0.3ex plus 0.1ex minus 0.1ex}
|
||||
\titlespacing*{\section}{1.25cm}{1ex plus 0.3ex minus 0.2ex}{0.6ex plus 0.2ex minus 0.1ex}
|
||||
\titlespacing*{\subsection}{1.25cm}{1ex plus 0.3ex minus 0.2ex}{0.6ex plus 0.2ex minus 0.1ex}
|
||||
\titlespacing*{\subsubsection}{1.25cm}{1ex plus 0.3ex minus 0.2ex}{0.6ex plus 0.2ex minus 0.1ex}
|
||||
\usepackage{tocloft}
|
||||
\addto\captionsrussian{%
|
||||
\renewcommand{\contentsname}{СОДЕРЖАНИЕ}%
|
||||
@@ -83,12 +115,15 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\renewcommand{\cftsecpagefont}{\mdseries}
|
||||
\renewcommand{\cftsubsecfont}{\mdseries}
|
||||
\renewcommand{\cftsubsubsecfont}{\mdseries}
|
||||
% Ширина поля номера в оглавлении измеряется по шрифту, а не задаётся
|
||||
% константой: при фиксированных 1.5em номер 2.10. не помещается и печатается
|
||||
% поверх названия главы, а у остальных пропадает пробел после точки.
|
||||
\setlength{\cftsecindent}{0em}
|
||||
\setlength{\cftsecnumwidth}{1em}
|
||||
\setlength{\cftsubsecindent}{0em}
|
||||
\setlength{\cftsubsecnumwidth}{1.5em}
|
||||
\setlength{\cftsubsubsecindent}{0em}
|
||||
\setlength{\cftsubsubsecnumwidth}{2.1em}
|
||||
\settowidth{\cftsecnumwidth}{\cftsecfont 9.\enspace}
|
||||
\settowidth{\cftsubsecnumwidth}{\cftsubsecfont 9.99.\enspace}
|
||||
\settowidth{\cftsubsubsecnumwidth}{\cftsubsubsecfont 9.99.99.\enspace}
|
||||
|
||||
\newcommand{\sigline}[3][4cm]{%
|
||||
\begin{tabular}[t]{@{}c@{}}%
|
||||
@@ -98,6 +133,17 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\end{tabular}%
|
||||
}
|
||||
|
||||
% Ширины шапки титульного листа. Колонка эмблемы задаётся явно, ширина
|
||||
% текстовой части — остаток от текстового поля за вычетом рамки и отбивок,
|
||||
% поэтому шапка не может вылезти за рамку при смене полей страницы.
|
||||
\newlength{\ptpemblemwidth}
|
||||
\newlength{\ptpheadwidth}
|
||||
\newlength{\ptpheadpad}
|
||||
\setlength{\ptpemblemwidth}{0.14\textwidth}
|
||||
\setlength{\ptpheadpad}{4pt}
|
||||
\setlength{\ptpheadwidth}{%
|
||||
\dimexpr\textwidth-\ptpemblemwidth-4\ptpheadpad-3\arrayrulewidth\relax}
|
||||
|
||||
\newcommand{\ptpfieldw}[4][4.5cm]{%
|
||||
\par\noindent
|
||||
\makebox[#1][l]{#2}%
|
||||
@@ -112,7 +158,10 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\newcommand{\ptpfieldnote}[4][4.5cm]{%
|
||||
\ptpfield[#1]{#2}{#3}%
|
||||
\par\vspace{-0.45em}%
|
||||
\hspace*{#1}\makebox[\dimexpr\textwidth-#1\relax][c]{\footnotesize\itshape #4}\par}
|
||||
% \noindent обязателен: иначе к строке подписи прибавляется абзацный отступ,
|
||||
% и она ровно на \parindent выходит за правое поле.
|
||||
\noindent\hspace*{#1}%
|
||||
\makebox[\dimexpr\textwidth-#1\relax][c]{\footnotesize\itshape #4}\par}
|
||||
|
||||
\newcommand{\ptpfieldpar}[3][4.5cm]{%
|
||||
\par\noindent
|
||||
@@ -122,12 +171,17 @@ PREAMBLE = r"""\documentclass[a4paper, 14pt]{extarticle}
|
||||
\rule{\dimexpr\textwidth-#1\relax}{0.4pt}%
|
||||
\end{tabular}\par}
|
||||
|
||||
% Блок подписи: метка слева, две подписи прижаты к правому полю.
|
||||
% Через tabularx с колонкой X это не работало — при длинной метке
|
||||
% («Руководитель практики от кафедры») колонка схлопывалась, и подписи
|
||||
% уезжали за правое поле. Здесь ширина подписей фиксирована, а \hfill
|
||||
% забирает остаток, поэтому правые края блоков всегда совпадают.
|
||||
\newcommand{\ptpsig}[3]{%
|
||||
\par\noindent
|
||||
\begin{tabularx}{\textwidth}{@{}l X c c@{}}%
|
||||
#1 & & \sigline[4.2cm]{}{\itshape подпись, дата}
|
||||
& \sigline[4.2cm]{#2}{\itshape #3} \\%
|
||||
\end{tabularx}\par}
|
||||
#1\hfill
|
||||
\sigline[3.8cm]{}{\itshape подпись, дата}%
|
||||
\hspace{0.5cm}%
|
||||
\sigline[3.8cm]{#2}{\itshape #3}\par}
|
||||
|
||||
\begin{document}"""
|
||||
|
||||
|
||||
@@ -27,13 +27,14 @@ def render(fm: dict[str, str]) -> str:
|
||||
"% --- Шапка в рамке с разделителем, как в бланке ---\n"
|
||||
"\\vspace*{-45pt}\n"
|
||||
"\\noindent\\begin{tabular}"
|
||||
"{|@{\\hspace{4pt}}c@{\\hspace{4pt}}|@{\\hspace{4pt}}c@{\\hspace{4pt}}|}\n"
|
||||
"{|@{\\hspace{\\ptpheadpad}}c@{\\hspace{\\ptpheadpad}}"
|
||||
"|@{\\hspace{\\ptpheadpad}}c@{\\hspace{\\ptpheadpad}}|}\n"
|
||||
"\\hline\n"
|
||||
"\\begin{minipage}{0.16\\textwidth}\\centering\\vspace{3pt}\n"
|
||||
"\\begin{minipage}{\\ptpemblemwidth}\\centering\\vspace{3pt}\n"
|
||||
"\\includegraphics[width=0.92\\textwidth]{emblem}\n"
|
||||
"\\vspace{3pt}\\end{minipage}\n"
|
||||
"&\n"
|
||||
"\\begin{minipage}{0.775\\textwidth}\\small\\bfseries\n"
|
||||
"\\begin{minipage}{\\ptpheadwidth}\\small\\bfseries\n"
|
||||
"\\vspace*{2pt}\n"
|
||||
f"{ministry_lines(fm)}\n"
|
||||
"\\vspace*{0.5ex}\n"
|
||||
|
||||
+28
-6
@@ -6,15 +6,25 @@ import tempfile
|
||||
from pathlib import Path
|
||||
|
||||
import md2gost
|
||||
from md2gost.latex.log import STRICT_KINDS, format_diagnostics, parse_log
|
||||
from md2gost.parser import Parser, iter_image_sources
|
||||
from md2gost.render import Renderer
|
||||
|
||||
|
||||
def _print_latex_errors(log_path: Path) -> None:
|
||||
if log_path.exists():
|
||||
for line in log_path.read_text(errors="replace").splitlines():
|
||||
if line.startswith("!"):
|
||||
print(f" {line}", file=sys.stderr)
|
||||
def _report_latex_log(log_path: Path) -> bool:
|
||||
"""Печатает диагностику сборки. Возвращает True при серьёзных дефектах.
|
||||
|
||||
Журнал живёт во временном каталоге и исчезает вместе с ним, поэтому всё,
|
||||
о чём сообщил xelatex, нужно вывести наружу здесь — иначе при запуске
|
||||
в контейнере узнать о дефектах вёрстки неоткуда.
|
||||
"""
|
||||
if not log_path.exists():
|
||||
return False
|
||||
diags = parse_log(log_path.read_text(errors="replace"))
|
||||
summary = format_diagnostics(diags)
|
||||
if summary:
|
||||
print(summary, file=sys.stderr)
|
||||
return any(d.kind in STRICT_KINDS for d in diags)
|
||||
|
||||
|
||||
def run_xelatex(tex_path: Path, output_dir: Path) -> bool:
|
||||
@@ -85,6 +95,11 @@ def main() -> None:
|
||||
action="store_true",
|
||||
help="только .tex, без компиляции в PDF",
|
||||
)
|
||||
cli.add_argument(
|
||||
"--strict",
|
||||
action="store_true",
|
||||
help="выйти с ошибкой, если xelatex сообщил о предупреждениях",
|
||||
)
|
||||
args = cli.parse_args()
|
||||
|
||||
if not args.input.exists():
|
||||
@@ -118,13 +133,20 @@ def main() -> None:
|
||||
if not run_xelatex(tex_path, cache_dir):
|
||||
stage = "" if attempt == 1 else " (2-й проход)"
|
||||
print(f"ошибка: xelatex{stage} не собрал PDF", file=sys.stderr)
|
||||
_print_latex_errors(log_path)
|
||||
_report_latex_log(log_path)
|
||||
sys.exit(1)
|
||||
|
||||
final_pdf = args.output / pdf_name
|
||||
shutil.copy2(cache_dir / pdf_name, final_pdf)
|
||||
print(f"-> {final_pdf}")
|
||||
|
||||
# Разбирается журнал второго прохода: после первого ссылки и номера
|
||||
# страниц ещё не разложены, и часть предупреждений ложная.
|
||||
has_defects = _report_latex_log(log_path)
|
||||
if has_defects and args.strict:
|
||||
print("ошибка: --strict, а вёрстка содержит дефекты", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
||||
@@ -0,0 +1,122 @@
|
||||
"""Сквозная проверка вёрстки: документ должен собираться без дефектов.
|
||||
|
||||
Отдельные обработчики проверяются модульными тестами, но выход текста за поле
|
||||
проявляется только после сборки: он зависит от шрифта, ширины колонок и
|
||||
взаимодействия пакетов. Этот тест ловит регресс, который иначе видно лишь
|
||||
глазами в готовом PDF.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import shutil
|
||||
import subprocess
|
||||
import tempfile
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
import md2gost
|
||||
from md2gost.latex.log import parse_log
|
||||
from md2gost.parser import Parser
|
||||
from md2gost.render import Renderer
|
||||
|
||||
pytestmark = pytest.mark.skipif(
|
||||
shutil.which("xelatex") is None, reason="xelatex не установлен"
|
||||
)
|
||||
|
||||
# Документ собран из конструкций, на которых вёрстка ломалась:
|
||||
# длинный токен в узкой колонке, подглава с двузначным номером в оглавлении,
|
||||
# перечень сокращений, листинг с подписью и длинными строками.
|
||||
FRONT_MATTER = """---
|
||||
титульник: ptp-report
|
||||
факультет: Информатика и системы управления (ИУ)
|
||||
кафедра: Теоретическая информатика и компьютерные технологии (ИУ9)
|
||||
тип: Отчёт
|
||||
название: Проверка вёрстки
|
||||
студент: Иванов И. И.
|
||||
студент_полностью: Иванов Иван Иванович
|
||||
группа: ИУ9-22Б
|
||||
тип_практики: проектно-технологическая практика
|
||||
предприятие: МГТУ имени Н. Э. Баумана
|
||||
команда: Проверка вёрстки
|
||||
хранилище: https://example.invalid/very/long/repository/path
|
||||
руководитель: Петров П. П.
|
||||
год: 2026
|
||||
---
|
||||
"""
|
||||
|
||||
SUBSECTIONS = "\n".join(
|
||||
f"## Подглава номер {i}\n\nТекст подглавы номер {i}.\n" for i in range(1, 12)
|
||||
)
|
||||
|
||||
BODY = f"""
|
||||
# АННОТАЦИЯ
|
||||
|
||||
Проверка вёрстки.
|
||||
|
||||
# СОДЕРЖАНИЕ
|
||||
|
||||
# ПЕРЕЧЕНЬ ПРИНЯТЫХ СОКРАЩЕНИЙ
|
||||
|
||||
SDR — Software-Defined Radio — программно-определяемая радиосистема
|
||||
PSO — Particle Swarm Optimisation — метод роевой оптимизации
|
||||
|
||||
# ВВЕДЕНИЕ
|
||||
|
||||
Введение.
|
||||
|
||||
# Раздел
|
||||
|
||||
{SUBSECTIONS}
|
||||
|
||||
Таблица 1 —— Таблица с длинным токеном
|
||||
|
||||
| Направление | Формат | Назначение |
|
||||
| :--- | :--- | :--- |
|
||||
| сервер | HackRFTestingServer:идентификатор | Приветствие, подтверждает подключение |
|
||||
|
||||
Листинг 1 —— Листинг с длинными строками
|
||||
|
||||
```cpp
|
||||
template <typename Rep, typename Period>
|
||||
std::vector<T> drain_with_timeout(const std::atomic<bool>& running,
|
||||
const std::chrono::duration<Rep, Period>& timeout);
|
||||
```
|
||||
|
||||
# ЗАКЛЮЧЕНИЕ
|
||||
|
||||
Заключение.
|
||||
|
||||
# СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ
|
||||
|
||||
1. Гилев, И. В. Использование технологии SDR / И. В. Гилев. – Воронеж, 2025. – С. 324–328.
|
||||
"""
|
||||
|
||||
|
||||
def _build(md_text: str) -> str:
|
||||
"""Собрать документ и вернуть журнал xelatex."""
|
||||
parser = Parser(md_text)
|
||||
# Картинок в эталонном документе нет — копировать нужно только эмблему.
|
||||
latex = Renderer(parser.tokens, parser.front_matter).render()
|
||||
emblem = Path(md2gost.__file__).parent.parent / "emblem.png"
|
||||
|
||||
with tempfile.TemporaryDirectory(prefix="md2gost-layout-") as cache:
|
||||
cache_dir = Path(cache)
|
||||
tex = cache_dir / "doc.tex"
|
||||
tex.write_text(latex, encoding="utf-8")
|
||||
if emblem.is_file():
|
||||
shutil.copy2(emblem, cache_dir / "emblem.png")
|
||||
for _ in range(2):
|
||||
subprocess.run(
|
||||
["xelatex", "-interaction=nonstopmode", str(tex)],
|
||||
cwd=cache_dir,
|
||||
capture_output=True,
|
||||
)
|
||||
assert (cache_dir / "doc.pdf").is_file(), "xelatex не собрал PDF"
|
||||
return (cache_dir / "doc.log").read_text(errors="replace")
|
||||
|
||||
|
||||
def test_reference_document_has_no_layout_defects() -> None:
|
||||
diags = parse_log(_build(FRONT_MATTER + BODY))
|
||||
defects = [d for d in diags if d.kind in ("error", "overfull")]
|
||||
assert not defects, "\n".join(f"{d.kind}: {d.message}" for d in defects)
|
||||
@@ -0,0 +1,112 @@
|
||||
from md2gost.latex.log import (
|
||||
STRICT_KINDS,
|
||||
Diagnostic,
|
||||
format_diagnostics,
|
||||
parse_log,
|
||||
)
|
||||
|
||||
ERROR_LOG = """
|
||||
This is XeTeX
|
||||
! LaTeX Error: File `emblem' not found.
|
||||
See the LaTeX manual or LaTeX Companion for explanation.
|
||||
"""
|
||||
|
||||
OVERFULL_LOG = r"""
|
||||
Overfull \hbox (56.70982pt too wide) in alignment at lines 220--220
|
||||
[]
|
||||
Overfull \hbox (7.2pt too wide) detected at line 14
|
||||
[]
|
||||
Overfull \hbox (0.4pt too wide) in paragraph at lines 30--31
|
||||
"""
|
||||
|
||||
UNDERFULL_LOG = r"""
|
||||
Underfull \hbox (badness 3000) in paragraph at lines 10--11
|
||||
Underfull \hbox (badness 7000) in paragraph at lines 20--21
|
||||
"""
|
||||
|
||||
WARNING_LOG = """
|
||||
LaTeX Warning: Reference `fig:1' on page 3 undefined on input line 42.
|
||||
LaTeX Warning: There were undefined references.
|
||||
"""
|
||||
|
||||
|
||||
def test_error_is_parsed() -> None:
|
||||
diags = parse_log(ERROR_LOG)
|
||||
assert len(diags) == 1
|
||||
assert diags[0].kind == "error"
|
||||
assert "File `emblem' not found" in diags[0].message
|
||||
|
||||
|
||||
def test_overfull_amount_and_line() -> None:
|
||||
diags = [d for d in parse_log(OVERFULL_LOG) if d.kind == "overfull"]
|
||||
assert [d.amount for d in diags] == [56.70982, 7.2]
|
||||
assert [d.line for d in diags] == [220, 14]
|
||||
|
||||
|
||||
def test_overfull_below_threshold_is_dropped() -> None:
|
||||
"""Вылеты в доли пункта не видны глазом и только зашумляют вывод."""
|
||||
diags = parse_log(OVERFULL_LOG, overfull_threshold_pt=1.0)
|
||||
assert all(d.amount != 0.4 for d in diags if d.amount is not None)
|
||||
|
||||
|
||||
def test_underfull_threshold() -> None:
|
||||
diags = [d for d in parse_log(UNDERFULL_LOG, underfull_threshold=5000)]
|
||||
assert len(diags) == 1
|
||||
assert diags[0].kind == "underfull"
|
||||
assert diags[0].amount == 7000
|
||||
assert diags[0].line == 20
|
||||
|
||||
|
||||
def test_warning_is_parsed() -> None:
|
||||
diags = parse_log(WARNING_LOG)
|
||||
assert [d.kind for d in diags] == ["warning", "warning"]
|
||||
assert "undefined" in diags[0].message
|
||||
|
||||
|
||||
def test_clean_log_gives_nothing() -> None:
|
||||
assert parse_log("This is XeTeX\nOutput written on a.pdf (3 pages).\n") == []
|
||||
|
||||
|
||||
def test_format_sorts_overfull_by_amount() -> None:
|
||||
text = format_diagnostics(parse_log(OVERFULL_LOG))
|
||||
first = text.index("56.7")
|
||||
second = text.index("7.2")
|
||||
assert first < second
|
||||
|
||||
|
||||
def test_format_is_empty_for_no_diagnostics() -> None:
|
||||
assert format_diagnostics([]) == ""
|
||||
|
||||
|
||||
def test_format_mentions_every_kind() -> None:
|
||||
diags = parse_log(ERROR_LOG + OVERFULL_LOG + UNDERFULL_LOG + WARNING_LOG)
|
||||
text = format_diagnostics(diags)
|
||||
for word in ("ошибк", "предупрежд", "за правое поле", "разрежен"):
|
||||
assert word in text
|
||||
|
||||
|
||||
def test_diagnostic_is_hashable() -> None:
|
||||
assert Diagnostic("error", "x", None, None) == Diagnostic("error", "x", None, None)
|
||||
|
||||
|
||||
NOISE_LOG = r"""
|
||||
Package unicode-math Warning: Using \overbracket and \underbracket from
|
||||
(unicode-math) `mathtools' package.
|
||||
|
||||
LaTeX Warning: There were undefined references.
|
||||
"""
|
||||
|
||||
|
||||
def test_known_package_noise_is_suppressed() -> None:
|
||||
"""Постоянный шум unicode-math заглушает собой полезные предупреждения."""
|
||||
diags = parse_log(NOISE_LOG)
|
||||
assert len(diags) == 1
|
||||
assert "undefined references" in diags[0].message
|
||||
|
||||
|
||||
def test_strict_ignores_underfull_and_warnings() -> None:
|
||||
"""Разреженная строка бывает намеренной, выход за поле — никогда."""
|
||||
assert "overfull" in STRICT_KINDS
|
||||
assert "error" in STRICT_KINDS
|
||||
assert "underfull" not in STRICT_KINDS
|
||||
assert "warning" not in STRICT_KINDS
|
||||
+122
-18
@@ -48,7 +48,7 @@ def test_figure_with_caption(tmp_path) -> None:
|
||||
"![[images/antenna.png]]\n\nРисунок 1 — Антенна\n\n"
|
||||
"Данная антенна используется для ...\n"
|
||||
)
|
||||
assert "\\begin{figure}[H]" in tex
|
||||
assert "\\begin{figure}[ht]" in tex
|
||||
assert "\\centering" in tex
|
||||
assert (
|
||||
"\\includegraphics[width=0.8\\textwidth]{\\detokenize{images/antenna.png}}"
|
||||
@@ -60,7 +60,7 @@ def test_figure_with_caption(tmp_path) -> None:
|
||||
|
||||
def test_figure_without_caption() -> None:
|
||||
tex = render("![[images/photo.png]]\n\nОбычный абзац после картинки.\n")
|
||||
assert "\\begin{figure}[H]" in tex
|
||||
assert "\\begin{figure}[ht]" in tex
|
||||
assert "\\caption{" not in tex
|
||||
assert "Обычный абзац после картинки." in tex
|
||||
|
||||
@@ -127,7 +127,7 @@ TABLE_MD = (
|
||||
|
||||
def test_table_with_caption() -> None:
|
||||
tex = render(TABLE_MD)
|
||||
assert "\\begin{table}[H]" in tex
|
||||
assert "\\begin{table}[ht]" in tex
|
||||
assert "\\caption{Сравнение скорости}" in tex
|
||||
assert "\\begin{tabularx}{\\textwidth}" in tex
|
||||
assert "\\textbf{1} & 0.027852 & 0.000285 \\\\" in tex
|
||||
@@ -221,9 +221,7 @@ def test_ptp_report_team_line_includes_repository() -> None:
|
||||
|
||||
|
||||
def test_ptp_report_team_line_without_repository() -> None:
|
||||
fm = PTP_REPORT_FM.replace(
|
||||
"хранилище: https://monitor.yss.su/IU9/radio-serv\n", ""
|
||||
)
|
||||
fm = PTP_REPORT_FM.replace("хранилище: https://monitor.yss.su/IU9/radio-serv\n", "")
|
||||
tex = render_fm(fm)
|
||||
assert "хранилище" not in tex
|
||||
|
||||
@@ -313,7 +311,14 @@ def test_ptp_task_has_no_hardcoded_assignment_text() -> None:
|
||||
from md2gost.latex.titlepages import ptp_task
|
||||
|
||||
source = inspect.getsource(ptp_task)
|
||||
for forbidden in ("Web", "2D-игра", "GitFlic", "Javascript", "Посевин", "Коновалов"):
|
||||
for forbidden in (
|
||||
"Web",
|
||||
"2D-игра",
|
||||
"GitFlic",
|
||||
"Javascript",
|
||||
"Посевин",
|
||||
"Коновалов",
|
||||
):
|
||||
assert forbidden not in source
|
||||
|
||||
|
||||
@@ -329,7 +334,7 @@ LISTING_MD = (
|
||||
def test_listing_with_caption() -> None:
|
||||
tex = render(LISTING_MD)
|
||||
assert "caption={Потокобезопасная очередь}" in tex
|
||||
assert "language=C++" in tex
|
||||
assert "language={[modern]C++}" in tex
|
||||
assert "class ThreadSafeQueue {};" in tex
|
||||
|
||||
|
||||
@@ -345,14 +350,14 @@ def test_listing_caption_paragraph_is_not_duplicated() -> None:
|
||||
|
||||
def test_listing_without_caption_stays_bare() -> None:
|
||||
tex = render("```cpp\nint main() {}\n```\n")
|
||||
assert "\\begin{lstlisting}[language=C++]" in tex
|
||||
assert "\\begin{lstlisting}[language={[modern]C++}]" in tex
|
||||
assert "caption=" not in tex
|
||||
|
||||
|
||||
def test_listing_caption_without_language() -> None:
|
||||
tex = render("Листинг 2 —— Формат строки\n\n```\nid,freq,power\n```\n")
|
||||
assert "caption={Формат строки}" in tex
|
||||
assert "language=" not in tex
|
||||
assert "language={" not in tex
|
||||
|
||||
|
||||
def test_paragraph_starting_with_listing_word_is_not_a_caption() -> None:
|
||||
@@ -364,12 +369,12 @@ def test_paragraph_starting_with_listing_word_is_not_a_caption() -> None:
|
||||
def test_listing_language_is_mapped_to_listings_name() -> None:
|
||||
"""listings не знает 'cpp', только 'C++'."""
|
||||
tex = render("```cpp\nint x;\n```\n")
|
||||
assert "language=C++" in tex
|
||||
assert "language={[modern]C++}" in tex
|
||||
|
||||
|
||||
def test_listing_unsupported_language_falls_back_to_plain() -> None:
|
||||
tex = render("```yaml\nkey: value\n```\n")
|
||||
assert "language=" not in tex
|
||||
assert "language={" not in tex
|
||||
assert "key: value" in tex
|
||||
|
||||
|
||||
@@ -389,19 +394,118 @@ def test_wide_table_uses_tabularx_so_it_fits_the_page() -> None:
|
||||
|
||||
|
||||
def test_table_left_columns_become_stretchable() -> None:
|
||||
"""Растягиваются колонки с текстом; «Сценарий» короткая и остаётся узкой."""
|
||||
tex = render(WIDE_TABLE_MD)
|
||||
assert tex.count(">{\\raggedright\\arraybackslash}X") == 3
|
||||
assert tex.count(">{\\raggedright\\arraybackslash}X") == 2
|
||||
|
||||
|
||||
def test_table_keeps_center_columns_narrow() -> None:
|
||||
"""Числовые колонки не должны растягиваться — растягивается только текст."""
|
||||
tex = render(TABLE_MD)
|
||||
assert "\\begin{tabularx}{\\textwidth}" in tex
|
||||
assert tex.count(">{\\raggedright\\arraybackslash}X") == 1
|
||||
assert f"{{|{_STRETCH}|c|r|}}" in tex
|
||||
"""Все колонки короткие: растягивать нечего, таблица идёт по содержимому."""
|
||||
tex = body(render(TABLE_MD))
|
||||
assert "\\begin{tabular}{|l|c|r|}" in tex
|
||||
assert "\\begin{tabularx}" not in tex
|
||||
|
||||
|
||||
def test_table_without_left_columns_stays_plain_tabular() -> None:
|
||||
tex = body(render("| a | b |\n| :---: | :---: |\n| 1 | 2 |\n"))
|
||||
assert "\\begin{tabular}{|c|c|}" in tex
|
||||
assert "\\begin{tabularx}" not in tex
|
||||
|
||||
|
||||
LONG_TOKEN_TABLE_MD = (
|
||||
"| Направление | Формат | Назначение |\n"
|
||||
"| :--- | :--- | :--- |\n"
|
||||
"| сервер | HackRFTestingServer:идентификатор | Приветствие, подтверждает |\n"
|
||||
)
|
||||
|
||||
|
||||
def test_long_token_in_cell_gets_break_points() -> None:
|
||||
"""Иначе токен не переносится и печатается поверх соседней колонки."""
|
||||
tex = body(render(LONG_TOKEN_TABLE_MD))
|
||||
assert "HackRFTestingServer:\\allowbreak" in tex
|
||||
|
||||
|
||||
def test_short_cells_are_left_alone() -> None:
|
||||
tex = body(render("| a | b |\n| :--- | :--- |\n| ping | сервер |\n"))
|
||||
assert "\\allowbreak" not in tex
|
||||
|
||||
|
||||
def test_break_points_do_not_touch_latex_commands() -> None:
|
||||
"""В ячейке с разметкой есть команды; ломать их вставками нельзя."""
|
||||
tex = body(
|
||||
render(
|
||||
"| Поле | Значение |\n| :--- | :--- |\n"
|
||||
"| **оченьдлинноежирноеслово_подчёркивание** | x |\n"
|
||||
)
|
||||
)
|
||||
assert "\\textbf{" in tex
|
||||
assert "\\textbf\\allowbreak" not in tex
|
||||
|
||||
|
||||
MIXED_WIDTH_TABLE_MD = (
|
||||
"| Сценарий | Что делает |\n"
|
||||
"| :--- | :--- |\n"
|
||||
"| build.yml | Собирает образ Docker целиком и публикует его в реестр |\n"
|
||||
"| test.yml | Собирает проект через CMake и прогоняет набор тестов |\n"
|
||||
)
|
||||
|
||||
|
||||
def test_narrow_column_is_not_stretched() -> None:
|
||||
"""Колонка из коротких значений не должна занимать половину ширины."""
|
||||
tex = body(render(MIXED_WIDTH_TABLE_MD))
|
||||
assert f"{{|l|{_STRETCH}|}}" in tex
|
||||
|
||||
|
||||
def test_all_short_columns_stay_plain_tabular() -> None:
|
||||
tex = body(render("| a | b |\n| :--- | :--- |\n| ping | сервер |\n"))
|
||||
assert "\\begin{tabular}{|l|l|}" in tex
|
||||
assert "\\begin{tabularx}" not in tex
|
||||
|
||||
|
||||
ABBR_MD = (
|
||||
"# ПЕРЕЧЕНЬ ПРИНЯТЫХ СОКРАЩЕНИЙ\n\n"
|
||||
"SDR — Software-Defined Radio — программно-определяемая радиосистема\n"
|
||||
"PSO — Particle Swarm Optimisation — метод роевой оптимизации\n"
|
||||
)
|
||||
|
||||
|
||||
def test_abbreviation_dash_is_single() -> None:
|
||||
"""Шесть дефисов дают в LaTeX два длинных тире подряд вместо одного."""
|
||||
tex = body(render(ABBR_MD))
|
||||
assert "------" not in tex
|
||||
assert "--- Software-Defined Radio" in tex
|
||||
|
||||
|
||||
def test_abbreviation_table_has_no_extra_column_padding() -> None:
|
||||
"""Отбивка между колонками добавляется к \\linewidth и роняет строку за поле."""
|
||||
tex = body(render(ABBR_MD))
|
||||
assert "@{}p{\\dimexpr\\linewidth" in tex
|
||||
|
||||
|
||||
def test_cpp_uses_extended_dialect() -> None:
|
||||
"""Встроенный C++ в listings не знает auto, nullptr и override."""
|
||||
tex = body(render("```cpp\nauto x = nullptr;\n```\n"))
|
||||
assert "language={[modern]C++}" in tex
|
||||
|
||||
|
||||
def test_captioned_listing_floats() -> None:
|
||||
"""Неплавающий листинг рвётся между страницами с незамкнутой рамкой."""
|
||||
tex = body(render(LISTING_MD))
|
||||
assert "float=htbp" in tex
|
||||
|
||||
|
||||
def test_bare_listing_does_not_float() -> None:
|
||||
"""Фрагмент без подписи — часть абзаца, ему плавать незачем."""
|
||||
tex = body(render("```cpp\nint x;\n```\n"))
|
||||
assert "float=" not in tex
|
||||
|
||||
|
||||
def test_initials_are_not_split_across_lines() -> None:
|
||||
"""«/ И.» на одной строке и «В. Гилев» на следующей — ошибка оформления."""
|
||||
tex = body(render("Гилев, И. В. Использование технологии SDR.\n"))
|
||||
assert "И.~В.~Использование" in tex
|
||||
|
||||
|
||||
def test_lowercase_abbreviation_is_left_alone() -> None:
|
||||
tex = body(render("В 3 т., Воронеж, 2025.\n"))
|
||||
assert "т.~Воронеж" not in tex
|
||||
|
||||
Reference in New Issue
Block a user