WIP

Author: tabuna

assets/colophon.html

@@ -19,7 +19,7 @@
         <p style="margin: 0; margin-top: 0.3em;">Формат: 148×210 мм (A5)</p>
         <p style="margin: 0; margin-top: 0.15em;">Бумага: офсетная 80 г/м², печать цифровая</p>
         <p style="margin: 0; margin-top: 0.15em;">Шрифты: EB Garamond, JetBrains Mono</p>
-        <p style="margin: 0; margin-top: 0.15em;">Тираж: 64 экз. | Заказ № 140574</p>
+        <p style="margin: 0; margin-top: 0.15em;">Тираж: 76 экз. | Заказ № 140574</p>
         <p style="margin: 0; margin-top: 0.15em;">Издательство: Полиграфия «Колор», ИП Москалёва Э. В.</p>
     </div>
 </div>

content/010-no-nonsense.md

@@ -264,6 +264,63 @@ echo (new Text($input))
 > **Обратите внимание на иммутабельность.**
 > Каждый шаг возвращает новый объект при котором не будет скрытых побочных эффектов.
 
+### Конкатенация строк
+
+Соединение строк с помощью оператора `.` кажется простым, но быстро теряет читаемость, особенно при длинных сообщениях или множестве переменных:
+
+```php
+// Плохо [✗]
+$message = 'Hello, ' . $name . '! Today is ' . date('Y-m-d');
+```
+
+При большом количестве переменных сложно сразу понять, как будет выглядеть итоговая строка.
+Чтобы избежать этого, можно использовать шаблон с подстановкой, например `sprintf`:
+
+```php
+// Хорошо [✓]
+$message = sprintf(
+    'Hello, %s! Today is %s',
+    $name,
+    date('Y-m-d')
+);
+```
+
+Такой подход делает структуру строки прозрачной и упрощает её поддержку.
+
+
+### Регулярные выражения
+
+Регулярные выражения часто превращаются в «магические строки»:
+
+```php
+// Плохо [✗]
+if (preg_match('/^(\d{4})-(\d{2})-(\d{2})$/', $date, $matches)) {
+    $year  = $matches[1];
+    $month = $matches[2];
+    $day   = $matches[3];
+}
+```
+
+Через месяц уже непонятно, что означает каждая группа. 
+И код начинает становиться путанным и явно обращаться к числовому индексу.
+
+По возможности, следует использовать именованные группы:
+
+```php
+// Хорошо [✓]
+if (preg_match(
+    '/^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/',
+    $date,
+    $matches
+)) {
+    $year  = $matches['year'];
+    $month = $matches['month'];
+    $day   = $matches['day'];
+}
+```
+
+Теперь каждая часть регулярного выражения имеет понятное имя, и при чтении кода сразу ясно, что именно извлекается.
+
 
 ### Ссылки делают код хрупким
 

src/MarkdownProcessor.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Support\Str;
 use JoliTypo\Fixer;
+use Laravelsu\Highlight\Languages\Shell\ShellLanguage;
 use League\CommonMark\Environment\Environment;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
 use League\CommonMark\Extension\GithubFlavoredMarkdownExtension;
@@ -31,6 +32,11 @@ public function __construct()
         $environment->addExtension(new TaskListExtension());
 
         $highlighter = new Highlighter(new InlineTheme(__DIR__.'/../assets/hightlight.css'));
+
+        $highlighter->addLanguage(
+            new ShellLanguage,
+        );
+
         $environment->addExtension(new HighlightExtension($highlighter));
 
         $this->converter = new MarkdownConverter($environment);
@@ -90,6 +96,13 @@ public function convert(string $markdown, int $index): string
 
         $html = $syllable->hyphenateHtmlText($html);
 
+        $html = Str::of($html)
+            ->replace('✓', '<span style="font-family: dejavusans;">✓</span>')
+            ->replace('✗', '<span style="font-family: dejavusans;">✗</span>')
+            ->replace('TODO:', '<span style="font-weight: bold;">TODO:</span>')
+            ->replace('HACK:', '<span style="font-weight: bold;">HACK:</span>')
+            ->replace('FIXME:', '<span style="font-weight: bold;">FIXME:</span>');
+
         $syllable->setLanguage('en-us');
 
         return $syllable->hyphenateHtmlText($html);