Словарь, нумерация глав, подписи картинок (#5)

* * glossary format
* + section numbering
* + automatic numbering of images with RU caption
* + centred image captions
* ! `++` in Chapter2
* ! subsections numbering in Chapter2

Author: vkutuev

Chapters/Chapter1.adoc

@@ -1,5 +1,5 @@
 [#section-chapter1]
-== Глава 1. Инструментарий компилятора
+== Инструментарий компилятора
 
 Технологии компиляции стали важны как никогда. 
 Как небольшие, так и крупные технологические компании нанимают разработчиков компиляторов. 
@@ -204,7 +204,7 @@ gcc --sysroot=/path/to/aarch64/sysroot -march=armv8-a hello.c
 Кросс-компилятор в A (CA) сгенерирует другой кросс-компилятор (CB), который будет работать на B. 
 CB сгенерирует код для машины C.
 
-image::canadian_cross.png[title="Схематичный пример канадской сборки",caption="Рис. 1: ",alt="Канадская сборка"] 
+image::canadian_cross.png[title="Схематичный пример канадской сборки",alt="Канадская сборка"]
 
 === Введение в инструментарий GCC
 

Chapters/Chapter2.adoc

@@ -1,4 +1,4 @@
-== Глава 2. Введение в компиляторные оптимизации
+== Введение в компиляторные оптимизации
 
 В этой главе вы узнаете о часто используемых компиляторных оптимизациях, которые используются для уменьшения размера кода
 и повышения производительности, а также о различных инструментах и методах профилирования.
@@ -87,7 +87,7 @@
 
 * *Флаги, предоставляющие значение*
 +
-Такие флаги, как `-D`, `-fprofile-use`, `-stdlib=libstdc++`, предоставляют компилятору дополнительные входные данные, которые могут помочь в оптимизации,
+Такие флаги, как `-D`, `-fprofile-use`, `-stdlib=libstdc{pp}`, предоставляют компилятору дополнительные входные данные, которые могут помочь в оптимизации,
 диагностике, инструментировании и т. д.
 
 === Оптимизация производительности
@@ -102,7 +102,7 @@
 
 Это тривиальный случай, когда оптимизация компилятора не выполняется.
 Тем не менее оптимизация для конкретного языка в соответствии с требованиями стандарта по-прежнему выполняется.
-Например, вычисления во время компиляции, требуемые стандартом C++, по-прежнему выполняются.
+Например, вычисления во время компиляции, требуемые стандартом C{pp}, по-прежнему выполняются.
 Этот уровень очень полезен для целей отладки в сочетании с флагом компилятора `-g`.
 Поскольку `-O0` не выполняет оптимизацию, время компиляции является самым быстрым,
 что весьма полезно для итеративной разработки.
@@ -201,7 +201,7 @@ https://www.keil.com/support/man/docs/armclang_ref/armclang_ref_cjh1548250046139
 Файл покрытия -- это, по сути, гистограмма частот выполнения различных точек программы.
 Для создания файла покрытия существует две методики, которые подробно описаны ниже.
 
-==== 1. Использование инструментирования
+==== Использование инструментирования
 
 Компиляторы могут вставлять «счетчики» в интересующие точки программы для сбора профилей времени выполнения.
 Код инструментируется путем передачи компилятору команды `+-fprofile-generate+`.
@@ -225,7 +225,7 @@ gcc -O2 -fprofile-use=/path/to/outputfile test.c -o b.out
 Компилятор часто оптимизирует размещение кода, вставку функций и циклы с учетом информации профиля.
 Обычно при использовании PGO (Profile-Guided Optimization) наблюдается повышение производительности более чем на 10%.
 
-==== 2. Использование семплирующих профиляторов
+==== Использование семплирующих профиляторов
 
 Семплирующие профиляторы, такие как Linux perf, используют аппаратные счетчики для регистрации определенных событий во время выполнения программы.
 Программы можно профилировать как с самого начала, так и во время их выполнения.
@@ -292,7 +292,7 @@ gcc -O3 -fauto-profile=a.gcov test.c -o b.out
 
 [source,bash]
 ----
-size gcc/11/libstdc++.dylib
+size gcc/11/libstdc{pp}.dylib
 ----
 
 [source,bash]
@@ -307,7 +307,7 @@ __TEXT    __DATA    __OBJC    others    dec    hex
 
 [source,bash]
 ----
-strings gcc/11/libstdc++.dylib | wc -l
+strings gcc/11/libstdc{pp}.dylib | wc -l
 ----
 
 [source,bash]
@@ -322,7 +322,7 @@ strings gcc/11/libstdc++.dylib | wc -l
 
 [source,bash]
 ----
-bloaty gcc/11/libstdc++.dylib
+bloaty gcc/11/libstdc{pp}.dylib
 ----
 
 [source,bash]
@@ -451,7 +451,7 @@ https://www.youtube.com/watch?v=6IuDWfuMEno[«Code Size Compiler Optimizations a
 Оба подхода помогают уменьшить размер двоичного файла.
 Ниже приведены мотивирующие примеры.
 
-Раннее вычисление: используя такие возможности языка, как `constexpr`, `static_assert` из C++, некоторые выражения могут быть вычислены раньше, например:
+Раннее вычисление: используя такие возможности языка, как `constexpr`, `static_assert` из C{pp}, некоторые выражения могут быть вычислены раньше, например:
 
 [source,cpp]
 ----
@@ -473,7 +473,7 @@ int main() {
 }
 ----
 
-Компилируя программу, представленную выше, используя команду `g++ std=c++17 -fno-exceptions -S`:
+Компилируя программу, представленную выше, используя команду `g{pp} std=c{pp}17 -fno-exceptions -S`:
 
 [source,nasm]
 ----
@@ -583,7 +583,7 @@ nm <Binary> | grep -i "test\|debug"
 === Справочные материалы
 
 * https://www.youtube.com/watch?v=6IuDWfuMEno[Адитья Кумар -- Оптимизация размера кода компилятора и методы для встраиваемых систем]
-* https://www.youtube.com/watch?v=OTCp_AkAyRQ[Адитья Кумар и Себастьян Поп -- Анализ производительности и оптимизация стандартных библиотек C++]
+* https://www.youtube.com/watch?v=OTCp_AkAyRQ[Адитья Кумар и Себастьян Поп -- Анализ производительности и оптимизация стандартных библиотек C{pp}]
 * https://developercommunity.visualstudio.com/t/192628900-pragma-optimize-off-is-not-working-as-ex/1091452[Сообщество разработчиков Visual Studio -- pragma optimize off работает не так, как ожидалось]
 * https://linux.die.net/man/1/nm[nm(1) -- страница руководства Linux]
 * https://hacktalks.blogspot.com/2013/08/gcc-instrument-functions.html[Инструментирующие функции GCC]

Chapters/Chapter3.adoc

@@ -1,4 +1,4 @@
-== Глава 3. Создание приложений RISC-V
+== Создание приложений RISC-V
 
 В этой главе мы узнаем, как использовать популярные наборы инструментов компилятора (как LLVM, так и GCC) для создания приложений RISC-V,
 а также как запускать приложения на симуляторах и эмуляторах.

Chapters/Chapter4.adoc

@@ -1,4 +1,4 @@
-== Глава 4. Методы отладки
+== Методы отладки
 
 Отладка -- неотъемлемая часть жизненного цикла разработки программного обеспечения.
 Даже при самых надежных методах программирования возникают ошибки, и их отладка -- не самое приятное занятие.

Chapters/TechnicalTerms.adoc

@@ -1,35 +1,36 @@
 [#section-terms]
+[glossary]
 == Список терминов
 
-* _toolchain_ -- инструментарий, набор инструментов
-* _high-level/low-level languages_ -- языки высокого/низкого уровня
-* _static analysis_ -- статический анализ
-* _instrumentation_ -- инструментирование
-* _introspection_ -- интроспекция
-* _compiler-driver_ ­-- драйвер компилятора
-* _bottleneck_ -- узкое место
-* _runtime profile_ -- профиль времени выполнения
-* _loop unrolling_ -- развертывание циклов
-* _inlining_ -- встраивание функций или инлайнинг
-* _instruction scheduling_ -- планирование инструкций
-* _register allocation_ -- распределение регистров
-* _benchmark_ -- тест производительности
-* _stack frame_ -- кадр стека
-* _buffer overflow_ -- переполнение буфера
-* _coverage file_ -- файл покрытия
-* _code layout_ -- размещение кода
-* _sampling profiler_ -- семплирующий профилятор
-* _call site devirtualization_ -- девиртуализация вызовов
-* _instantiate_ -- инстанцировать
-* _dead code_ -- мертвый код
-* _comprehensive test suite_ -- комплексный набор тестов
-* _rich performance profiles_ -- расширенные профили производительности
-* _ELF targets_ -- целевые платформы ELF
-* _sub-architecture_ -- субархитектура
-* _SoCs_ -- однокристальные системы
-* _print debugging_ -- отладочная печать
-* _sanitizer_ -- санитайзер
-* _assertion_ -- в курсе не переводится
-* _breakpoint_ -- точка останова или контрольная точка
-* _backtrace_ -- в курсе не переводится
-* _single-stepping instructions_ -- пошаговые инстукции
+toolchain:: инструментарий, набор инструментов
+high-level/low-level languages:: языки высокого/низкого уровня
+static analysis:: статический анализ
+instrumentation:: инструментирование
+introspection:: интроспекция
+compiler-driver:: драйвер компилятора
+bottleneck:: узкое место
+runtime profile:: профиль времени выполнения
+loop unrolling:: развертывание циклов
+inlining:: встраивание функций или инлайнинг
+instruction scheduling:: планирование инструкций
+register allocation:: распределение регистров
+benchmark:: тест производительности
+stack frame:: кадр стека
+buffer overflow:: переполнение буфера
+coverage file:: файл покрытия
+code layout:: размещение кода
+sampling profiler:: семплирующий профилятор
+call site devirtualization:: девиртуализация вызовов
+instantiate:: инстанцировать
+dead code:: мертвый код
+comprehensive test suite:: комплексный набор тестов
+rich performance profiles:: расширенные профили производительности
+ELF targets:: целевые платформы ELF
+sub-architecture:: субархитектура
+SoCs:: однокристальные системы
+print debugging:: отладочная печать
+sanitizer:: санитайзер
+assertion:: в курсе не переводится
+breakpoint:: точка останова или контрольная точка
+backtrace:: в курсе не переводится
+single-stepping instructions:: пошаговые инстукции

Course.adoc

@@ -3,6 +3,8 @@
 :doctype: book
 :toc: macro
 :toc-title: Содержание
+:chapter-signifier: Глава
+:figure-caption: Рисунок
 
 Данные материалы являются переводом курса https://training.linuxfoundation.org/training/risc-v-toolchain-and-compiler-optimization-techniques-lfd113x/[RISC-V Toolchain and Compiler Optimization Techniques (LFD113x)], распространяемого под лицензией https://creativecommons.org/licenses/by/4.0/[CC BY 4.0].
 
@@ -13,6 +15,7 @@ toc::[]
 :imagesdir: images
 :pp: ++
 
+:sectnums:
 include::Chapters/Chapter1.adoc[Глава 1. Инструментарий компилятора]
 
 include::Chapters/Chapter2.adoc[Глава 2. Введение в компиляторные оптимизации]

Makefile

@@ -8,11 +8,15 @@ CHAPTERS = $(wildcard $(CHAPTERS_DIR)/*.adoc)
 ROOT_ASCIIDOC = $(ROOT_ASCIIDOC_NAME).adoc
 RESULT_PDF = $(ROOT_ASCIIDOC_NAME).pdf
 
+THEME = theme.yml
+
 .PHONY: all
 all: $(RESULT_PDF)
 
-$(RESULT_PDF): $(ROOT_ASCIIDOC) $(CHAPTERS)
-	$(ASCIIDOCTOR_PDF) --trace --out-file='$@' '$<'
+$(RESULT_PDF): $(ROOT_ASCIIDOC) $(CHAPTERS) $(THEME)
+	$(ASCIIDOCTOR_PDF) \
+		--theme $(THEME) \
+		--out-file='$@' '$<'
 
 .PHONY: clean
 clean:

theme.yml

@@ -0,0 +1,4 @@
+extends: default
+image:
+  caption:
+    align: center