(067) 248-82-60(099) 720-76-58

с 9:00 до 17:00 (сб, вс — выходные)

0

000грн

• Каталог товаров
• Главная
• Каталог
• Маникюр
• Вспомогательные средства и жидкости
• Праймеры кислотные, бескислотные и бондеры
• Kodi

Артикул:KODI-261

Код товара:11. 78.83

Производитель:Kodi

Наличие: Нет в наличии

Характеристики

Габариты упаковки60 мм x 25 мм x 25 мм

Вес брутто40 г

Описание

Важная информация!  Primer содержит компонент, который замерзает при температуре +17С (кристаллизируется). Не рекомендуется откручивать крышечку праймера при температуре ниже +17С (кисточка может сломаться)!!!

Кислотный праймер KODI PROFESSIONAL изготавливается на основе метакриловой кислоты. Использование этого средства обеспечивает надежное сцепление полимерного материала и пластины ногтя. Входящие в состав компоненты не вредят натуральному ногтю и предотвращают появления грибковых инфекций.

Зачем нужен кислотный праймер?

Кислотные праймеры для наращивания ногтей применяются для подготовки основы к моделированию. Это средство делает поверхность шершавой, повышая степень адгезии с искусственным покрытием. Помимо этого он еще обезвоживает и обезжиривает, что помогает прочно держаться полимеру и не отслаиваться значительное время.

К достоинствам этого косметического средства специалисты относят его способность предотвращать размножение бактерий под созданным покрытием. В случае неприменения препарата под гель-лаком может развиться грибок, вылечить ногти от которого не так уж просто.

Кислотный праймер для ногтей и как им пользоваться?

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

Инструкция к кислотному праймеру Коди:

• Пушером (апельсиновой палочкой) отодвиньте кутикулу, пилкой подготовьте ноготь, убрав натуральный блеск, а образовавшийся опил смахните щеточкой.
• Кислотный праймер нанесите на ногтевую пластину. Наберите малое количество вещества, отожмите лишнее о край флакона, дополнительно промокните кисть бумажной салфеткой.
• Приложите кисть к середине ногтя, позволив средству растечься по всей поверхности равномерно. Следите, чтобы вещество не попало в зону кутилы и не контактировало с кожей, в случае попадания на эпидермис промойте большим количеством воды. Для достижения максимального эффекта необходим тонкий слой PRIMER.
• Дайте высохнуть нанесенному слою.
• Поверхность готова к моделированию ногтей и созданию потрясающего нейл-арта.

Важно знать, что в PRIMER входит компонент, который при температуре +17С кристаллизуется. Все работы проводите при более высокой температуре.

Где купить кислотный праймер для ногтей в Украине?

На официальном сайте KODI PROFESSIONAL представлен большой ассортимент профессионального инструмента и средств для превосходного дизайна ногтей. На сайте постоянно проводятся акции и скидки, чтобы наша продукция была для вас еще доступнее. Товары в каталоге интернет-магазина постоянно обновляются, добавляется палитра гель-лаков, лаков. Все средства имеют сертификаты соответствия.

Заказать кислотный праймер для наращивания ногтей можно с доставкой по всей Украине. Наши специалисты помогут подобрать средства и сформируют заказ.

Загрузка…

Ошибка загрузки!

A Primer on Intel Assembly

Это краткое руководство/справочное руководство по архитектуре набора инструкций Intel (ISA).

• Обязательные знания
• Основы сборки Intel
• Регистры
• Инструкции
• Построение инструкции
• NASM Intro

BookMarks

Предварительные знания

В этом разделе подробно описаны несколько основных понятий, необходимых для начала работы со сборкой Intel.

Терминология

Понимание двоичного и шестнадцатеричного кодов, а также таких слов, как «бит», «байт» (8 бит) и « полубайт » (4 бита), является ключом к пониманию всего, что связано со сборкой Intel.

Стопка

9Стек 0021 — это структура данных Last-In-First-Out ( LIFO ), используемая для локальных переменных, параметров функций и помогающая с потоком управления программой. Узнайте больше о стеке здесь.

Структура стека поддерживает две основные инструкции push и pop . push поместит значение на вершину стека при вычитании из указателя стека, а pop удалит значение с вершины стека (при добавлении к указателю стека) и поместит извлеченное значение в месте хранения (например, в реестре).

* Стек растет вверх в сторону нижнего диапазона памяти.

* pop увеличивает регистр ESP на 4 байта, а push уменьшает регистр ESP на 4 байта.

Куча

Куча — это управляемая область памяти, позволяющая динамически распределять память во время выполнения. Куча обычно используется для объектов, слишком больших для размещения в стеке.

* Куча существует в нижних диапазонах памяти и растет вниз к стеку.

Дополнение 1 и 2

По сути, дополнение до 1 двоичного числа вычисляется путем перестановки каждого бита. Например, дополнением до 1 со значением «0011» будет «1100».

Дополнение до 2 для «0011» вычисляется путем инвертирования каждого бита, как это было сделано ранее (на «1100»), а затем добавления 1 к этому значению, таким образом, получая окончательное значение «1101». В качестве другого примера, если у вас есть число «0000» и вы берете Дополнение до 2 , вы получите «1111» в качестве дополнения до 1, затем добавьте 1, получив таким образом «10000». Как видите, 4-битное значение теперь является 5-битным после переноса в 5-й бит.

Дополнительная информация

• Если установлен верхний бит (т.е. 0x80000000 ), значение отрицательное.
• Учитывая 32-битное число, наш диапазон составляет от -31 бита до +31 бита (минус 1).
• Узнайте о дополнении 1 и 2 здесь.
• Ресурсы для выполнения двоичных/шестнадцатеричных арифметических операций и преобразований включены в раздел Инструменты и ресурсы.

Основы сборки Intel

Инструменты

• Компилятор используется для получения исходного кода высокого уровня (например, C) и создания кода сборки.
• Ассемблер берет ассемблерный код и генерирует машинный/объектный код.
• Компоновщик берет несколько перемещаемых кодов объектов и создает один двоичный файл.
• Загрузчик загружает исполняемый файл во время выполнения.
• Дизассемблер преобразует машинный код обратно в ассемблерный.

Размер слова

• байт — это наименьший адресуемый размер в архитектуре Intel. (пример: 0xFF )
• A WORD (обычно) состоит из 2 последовательных байтов (пример: 0xFFCC ). (Это восходит к временам 16-битных систем.)
• В 32-битной системе СЛОВО можно рассматривать как 4 байта (32 бита). Точно так же в 64-битной системе СЛОВО будет 8 байт.
• A DWORD и QWORD — это 4 последовательных байта и 8 последовательных байтов соответственно.

Синтаксис

Синтаксис Intel — Первый операнд является адресатом, а второй операнд — источником. (например: mov edx, ecx ). Этот синтаксис гораздо более распространен.

Синтаксис AT&T — первый операнд является операндом-источником, а второй операнд — приемником. (пример: movl %ecx, %edx ). Очень узнаваем по амперсандам среди других отличий.

Порядок байтов

Порядок байтов относится к порядку байтов (обычно в памяти) двоичного числа.

Рассмотрим серию адресов памяти 0x00 , 0x01 , 0x02 и 0x03 и рассмотрим шестнадцатеричное целое число 0x41424344 . Чтобы сохранить это целое число в заданных адресах памяти в формате Little Endian , оно будет сохранено с младшими байтами первыми — 0x44 , 0x43 , 0x42 , 0x41 соответственно по адресам 0x00 , 0x01 , 0x02 и 0x03 , 0x02 и 0x03 . Big Endian будет хранить Integer с байтами высшего порядка первой 0x41 , 0x42 , 0x43 , 0x44 соответственно в адресах 0x00 , 0x., .

• Порядок следования байтов вступает в игру, когда имеется 2 или более последовательных байта.
• Big Endian также известен как « Network Byte Order ». (TCP отправляет данные в формате Big Endian)
• Когда речь идет о значениях, хранящихся в регистре, не существует понятия порядка следования байтов.

Пролог/Эпилог/Фрейм стека

Фрейм стека настраивается с помощью функции пролог . (Пример показан ниже)

 push ebp
mov ebp, esp
суб всп, N
 

Фрейм стека помещает текущий базовый указатель в стек (через push ebp ), затем сохраняет указатель стека в EBP в начале вызова функции. Это делается для того, чтобы на локальные переменные и аргументы этой функции можно было ссылаться относительно EBP во время выполнения функции. Локальные переменные ссылаются на выше (-)EBP, в то время как аргументы ссылаются на ниже (+)EBP.

Кадр стека уничтожается с помощью функции эпилог .

 мов всп, эбп
поп
рет
 

Соглашения о вызовах

* Инструкция call помещает адрес возврата на вершину стека и переходит к адресу памяти, указанному в инструкции call (путем установки EIP в место назначения вызова). Адрес возврата — это адрес инструкции вызова плюс 4 байта (по сути, следующая инструкция после вызова).

* ret / retn (возврат) инструкция (по существу) извлекает вершину стека (адрес возврата) в EIP и направляет на него поток исполнения.

* retn [int] делает шаг вперед и увеличивает ESP [int] байт, чтобы очистить любые параметры стека, используемые во время вызова соответствующей функции.

stdcall
При таком соглашении аргументы функции помещаются в обратном порядке, после чего вызываемая функция (вызываемая) отвечает за последующую очистку стека. В этом соглашении retn [int] 9Используется инструкция возврата 0022.

cdecl
При вызове cdecl функция , вызывающая , отвечает за очистку стека. Обычно это делается с помощью оператора add esp, int после возврата функции. (показано ниже)

• Преимущество cdecl заключается в том, что он позволяет использовать переменное количество аргументов для функции.

 Функция:
  нажать ebp
  поп
  ретн
нажать 10101010h
функция вызова
добавить спец, 4
 

fastcall
This convention stores arguments in registers (x86 stores first two in ecx , edx and the rest on the stack, x64 stores first four in rcx , rdx , r8 and r9 ), так как регистры быстрее, чем хранение в стеке (памяти). Затем вызываемый объект очищает стек в x86 (аналогично stdcall), а в x64 вызывающий очищает стек (аналогично cdecl ).

Ассорти знаний по сборке

• EAX обычно содержит возвращаемое значение для вызовов функций.
• Некоторые инструкции x86 должны работать с 64-битными операциями, в этих случаях обычно используется EDX:EAX .
• В инструкции IDIV 64-битное значение EDX:EAX делится на ECX . Частное хранится в EAX , а остаток хранится в EDX .
• Переходы могут использоваться как свидетельство подписанных и неподписанных операций. JA , JAE , JB и JBE связаны с USINGED , в то время как JL , JLE , JG и JGE .

Регистры

Регистры расположены на ЦП и очень быстро доступны.

EIP — Расширенный указатель инструкций (EIP) или счетчик программ — это зарезервированный регистр, который содержит указатель на ячейку памяти выполняемой в данный момент инструкции. 32-битная арка не разрешает прямой доступ к этому регистру.

General Purpose Registers (GPRs)

Дополнительная информация

• « E » перед каждым регистром означает «расширенный», что связано с переносом из старых 16-битных архитектур.
• Доступ к младшим 16 битам каждого регистра общего назначения можно получить, удалив « e » из имени регистра (например, ax , cx , dx , bx
  7, sp , п.н. , си , по ).
  • Only eax , ecx , ebx and edx can reference high/low 8-bits (e.g., ah / al , ch / cl , bh / bl , dh / dl соответственно).

  Регистры сегментов

  • CS — Регистр сегмента кода — Поддерживает уровень кольца (0–3) в поле Текущий уровень привилегий (CPL).
  • ДС — Регистр сегмента данных
  • SS — Регистр сегмента стека
  • ES — Регистр сегмента дополнительных данных.
  • GS — Регистр дополнительных сегментов

  Прочие регистры

  EFLAGS

  Регистр EFLAGS используется для хранения состояния и состояний выполнения.

  • Флаг ZF/Zero — Устанавливается, если предыдущая арифметическая операция равна нулю, иначе сбрасывается.
  • Флаг SF/Sign — Устанавливается, когда результат операции отрицательный, и сбрасывается, когда положительный. Также устанавливается, когда старший значащий бит устанавливается после арифметической операции.
  • Флаг CF/Carry — Устанавливается, когда результат операции требует переноса (применяется к числам без знака), потому что результат слишком велик/мал для места назначения.
  • Флаг OF/Overflow — Устанавливается, если результат превышает максимальный размер (применяется к числам со знаком).
  • Флаг TF/ловушки — используется для отладки. x86 будет выполнять только одну инструкцию за раз, если этот флаг установлен.

  Регистры управления

  • CR0 — Управляет включением или выключением подкачки.
    • Бит 0 — Защищенный режим включен
    • Бит 16 — Защита от записи (если установлено, ЦП не может записывать в постоянную память даже в кольце 0)
    • Бит 31 — Включить пейджинг (позволяет использовать CR3)
  • CR2 — содержит линейный адрес, вызвавший ошибку страницы.
  • CR3 — содержит физический базовый адрес базового регистра физического каталога ( PDBR ). Используется, когда включена виртуальная адресация.
  • CR4 — управляет настройками аппаратной виртуализации.
    • Бит 5 — Расширения физических адресов ( PAE ) (расширяет 32-битную адресацию до 36-битной)
    • Бит 20 — SMEP (Предотвращение выполнения в режиме супервизора), который запрещает Ring 0 выполнять память пользовательского режима.
    • Бит 21 — SMAP (защита доступа в режиме супервизора) запрещает Ring 0 доступ к памяти пользовательского режима.

  Регистры отладки

  • DR0 — DR3 — Содержит линейный адрес ячейки памяти для наблюдения
  • DR4 , DR5 — псевдонимы для DR6 и DR7
  • DR6 — регистр состояния отладки, который содержит тип последнего произошедшего исключения (выполнение/доступ/запись). Эти биты должен очищать отладчик, а не процессор.
  • DR7 — Регистр управления отладкой

  ---

  Инструкции

  Intel x86 ISA поддерживает множество инструкций. Подробную информацию об этих инструкциях можно просмотреть в руководствах для разработчиков программного обеспечения для архитектур Intel 64 и IA-32.

  Инструкции Intel имеют формат переменной длины, общий машинный формат показан ниже. Далее поясняются части инструкции.

  ПРЕФИКС | OPCODE | МОДР/М | СИБ | ОБЪЕМ | НЕМЕДЛЕННО

  * Инструкции по кодированию инструкций по сборке в их машинные аналоги можно найти здесь.

  Дополнительная информация

  • Операнды инструкции могут быть регистр , непосредственный (постоянное значение) или адрес памяти .
  • Метка — необязательный идентификатор, за которым следует двоеточие.
  • A Mnemnoic — это зарезервированное имя для удобочитаемой формы машинной инструкции. (например: код операции 0x03 равен , добавить ).
  • Инструкции по сборке имеют удобочитаемый формат: этикетка : мнемоника операнд1 , операнд2 , операнд3
  • Разыменование памяти выполняется в ассемблере с использованием скобок [ ebx ]. Это означает, что осуществляется доступ к памяти. Другими словами, когда память разыменована, вы читаете/записываете значение, которое хранится по адресу памяти, а не по самому адресу памяти.

  Классы инструкций

  Простой — Инструкция mov — это простая и часто используемая инструкция, которая перемещает данные из одного места в другое.

  Арифметика — Существует множество арифметических операций для сложения, вычитания и т. д. (например: добавить , под, вкл. , dec , mul ,

  6 div… и т. д.).

  NOP — Инструкция nop ничего не делает, выполнение просто переходит на следующую строку. (забавный факт: NOP на самом деле представляет собой xchg eax, eax .)

  Stack — включает инструкции по перемещению данных в стек и из него, например нажмите и нажмите .

  Функция — Сюда входят инструкции для вызова и возврата из функций (например: call , ret , retn и т. д.)

  Conditionals — Эти инструкции предназначены для сравнения. (например: test , cmp и т. д.)

  Ветвление — Эти инструкции, состоящие из условных и безусловных переходов, управляют потоком программы. (например: jz , jnz , je , jg и многие другие…).

  Rep — Инструкции по работе с буферами данных. (например: rep , repz , repne и т. д.)

  *Этот список инструкций далеко не исчерпывающий. Полный список см. в руководстве Intel.

  Анатомия инструкции

  Префикс
  Дополнительные подробности…

  Код операции
  1-3-байтовое значение, представляющее значение машинного кода для инструкции.

  ModR/M
  1-байтовое значение, которое следует за кодом операции и определяет режим адресации, а также операнды регистра/памяти. Этот байт требуется только для некоторых инструкций. Инструкции, для которых требуется этот байт, будут иметь метку «ModRM» в соответствующей таблице кодирования операндов инструкций.

  Формат байта MODR/M

  443 3-битный R32 Operand или Opcode Extension

  MOD	REG	R/M
  3-битный регистр или операнд памяти

  SIB
  Подробнее. который представляет ячейку памяти или смещение от ячейки памяти. (пример: mov dword [ecx + 0xAABBCCDD], 0x11223344 )

  Немедленное
  8-, 16- или 32-битное значение, представляющее собой буквальное число. (пример: 0xAABBCCDD в инструкции mov eax, 0xAABBCCDD )

  ---

  Построение инструкции

  В таблице ниже описаны различные режимы адресации MODR/M, которые необходимы для построения многих типов инструкций.

  MODR/M Addressing Modes

  MOD	Assembly	Explanation
  00	[r/m]	r/m32 operand memory address is located in the r/m register
  00	[disp32]	, если MOD равен 00, а R/M равен 101, указанная ячейка r/m32 является ячейкой памяти, которая представляет собой только смещение32 адрес памяти операнда находится в регистре r/m + 1-байтовое смещение
  10	[r/m + двойное слово]	r/m32 адрес памяти операнда находится в регистре r/m + a 4- смещение байта
  11	об/м	об/м32 операнд — прямой доступ к регистру

  Пример 1

  , например, инструкция Add EAX, EBX

  1. Найти Инструкция Add Инструкция Intel (показано выше. инструкция, которая принимает два операнда r/m32. В этом случае коды операций, соответствующие этому описанию, — «01 /r » и «03 /r ».
  2. Проверяя таблицу кодирования операндов инструкций, мы можем сопоставить Op/En для каждого из кодов операций, найденных выше, с записью в таблице. Например, 01 9Код операции 0046 /r имеет Op/En из MR, что на основе таблицы кодирования операндов делает операнд 1 r/m, а операнд 2 — reg.
  3. Поскольку из таблицы кодирования операндов мы видим ModRM в строке MR, мы знаем, что для этой инструкции требуется байт MODR/M.
  4. Из таблицы режимов адресации MODR/M видно, что, поскольку операнд r/m32 является прямым регистром, значение первых двух битов байта MODR/M равно 11.
  5. Поскольку «01 /r ” это ДОБАВИТЬ об/м32, р32 мы знаем, что следующие три бита байта MODR/M — это reg, который в данном случае является вторым операндом инструкции «ebx», закодированной как 011. Последние три бита — это инструкция «eax», которая закодирована как «000». (Эти кодировки можно найти в таблице регистров общего назначения)
  6. Собрав все вместе, мы имеем код операции 0x01 плюс 11011000b, который транслируется в 0x01 0xD8, что в разобранном виде транслируется в add eax, ebx !

  Дополнительная информация

  • r/m32 означает, что вы можете использовать регистр или память.
  • r32 означает, что вы можете использовать только регистр.
  • Инструкция Intel имеет переменную длину и может иметь размер до 15 байт (120 бит).

  Флаги кода операции

  • NP — указывает на то, что использование префиксов 66 / F2 / F3 (кроме тех, которые уже являются частью кода операции инструкции) не разрешено с командой. Такое использование либо вызовет исключение недопустимого кода операции (#UD), либо приведет к кодированию для другой инструкции.
  • / цифра — цифра от 0 до 7 указывает, что поле REG (2-е поле) байта ModR/M содержит 3-битное значение (0-7), которое обеспечивает расширение кода операции инструкции.
  • /r — Указывает, что поле REG (2-е поле) байта ModR/M содержит 3-битное значение операнда r32 .
  • cb , cw , cd , cp , co , ct — 1 байт ( cb ), 2-байтовое ( cw ), 4-байтовое ( cd ), 6-байтовое ( cp ), 8-байтовое ( co ) или 10-байтовое ( ct ) значение после кода операции. Это значение используется для указания смещения кода и, возможно, нового значения для регистра сегмента кода.
  • ib , iw , id , io — A 1 байт ( ib ), 2 байта ( iw ), 4 байта 8 id (900) io ) непосредственный операнд инструкции, которая следует за кодом операции, байтами ModR/M или байтами индексации шкалы. Код операции определяет, является ли операнд значением со знаком. Все слова WORD, DWORD и QWORD задаются с младшим байтом первым.
  • +rb , +rw , +rd , +ro — указанные младшие 3 бита байта кода операции используются для кодирования операнда регистра без байта modR/M. Инструкция перечисляет соответствующее шестнадцатеричное значение байта кода операции с младшими 3 битами как 000b. В не64-битном режиме код регистра от 0 до 7 добавляется к шестнадцатеричному значению байта кода операции. В 64-битном режиме указывает четырехбитное поле REX.b, а поле кода операции [2:0] кодирует регистровый операнд инструкции. +ro ” применим только в 64-битном режиме.

  ---

  NASM Intro

  NASM (Netwide Assembler) — кроссплатформенный ассемблер. Это быстрый способ ассемблирования и дизассемблирования ассемблерного кода и машинного кода соответственно

  Ниже приведен пример файла листинга ассемблера. (Сохранено с расширением .s )

  Файл листинга сборки

   [БИТЫ 32]
  нажать ebp
  нажать эди
  ретн
  моя_первая_метка:
  mov dword [eax], esp
  нажать ebp
  нажать эди
  ретн
  jmp my_first_label
   

  Запустив nasm file. s можно получить собранный файл. Запустив ndisasm -u файл , вы можете получить дизассемблированный ассемблерный код, как показано ниже.

   00000000 55 push ebp
  00000001 57 push edi
  00000002 C3 возврат
  00000003 8920 мов [eax],esp
  00000005 55 push ebp
  00000006 57 push edi
  00000007 C3 возврат
  00000008 EBF9 jmp короткий 0x
   

  ---

  • Двоичный/шестнадцатеричный калькулятор в сборку
  • Defuse Assembler & Disassembler — Assemble/Diassemble Произвольные инструкции/Машинный код
  • Disasm.pro — Онлайн ассемблер/дизассемблер
  • Ссылка на прыжок
  • Типы данных в C
  • Cyberchef — анализ и декодирование данных
  • Проект Terminus — Diff структур Windows, собранных из NTDLL PDBS
  • NASM Download
  • . reStructuredText Primer — документация Sphinx

    reStructuredText — язык разметки открытого текста по умолчанию, используемый Sphinx. Этот
    раздел представляет собой краткое введение в концепции и синтаксис reStructuredText (reST),
    предназначен для предоставления авторам достаточной информации для создания документов
    продуктивно. Поскольку reST был разработан как простая, ненавязчивая разметка
    язык, это не займет много времени.

    См. также

    Официальная пользовательская документация reStructuredText. Ссылки «ref» в этом
    ссылка на документ с описанием отдельных конструкций в reST
    ссылка.

    Пункты

    Абзац (ссылка) является самым основным блоком в REST
    документ. Абзацы — это просто фрагменты текста, разделенные одним или несколькими пробелами.
    линии. Как и в Python, в reST важны отступы, поэтому все строки
    один и тот же абзац должен быть выровнен по левому краю с одинаковым уровнем отступа.

    Встроенная разметка

    Стандартная встроенная разметка reST довольно проста: используйте

    .

    • одна звездочка: *текст* для выделения (курсив),

    • две звездочки: **текст** для выделения жирным шрифтом и

    • обратные кавычки: ``текст`` ​​ для примеров кода.

    Если в бегущем тексте появляются звездочки или обратные кавычки, которые можно спутать с
    встроенные разделители разметки, они должны быть экранированы обратной косой чертой.

    Помните о некоторых ограничениях этой разметки:

    • не может быть вложенным,

    • содержимое не может начинаться или заканчиваться пробелом: * text* неверно,

    • должен быть отделен от окружающего текста несловными символами. Использовать
      обратная косая черта экранировала пробел, чтобы обойти это: thisis\ *one*\ word .

    Эти ограничения могут быть сняты в будущих версиях docutils.

    Также можно заменить или расширить часть этой встроенной разметки с помощью
    роли. Дополнительные сведения см. в разделе Роли.

    Списки и блоки, подобные котировкам

    Разметка списка (ссылка) естественна: просто поместите звездочку в
    начало абзаца и правильный отступ. То же самое и с номером
    списки; их также можно пронумеровать с помощью знака # :

     * Это маркированный список.
    * Имеет два предмета, второй
      элемент использует две строки.
    1. Это пронумерованный список. 
    2. В нем тоже два предмета.
    #. Это нумерованный список.
    #. Там тоже два предмета.
     

    Вложенные списки возможны, но имейте в виду, что они должны быть отделены от
    элементы родительского списка по пустым строкам:

     * это
    * список
      * с вложенным списком
      * и некоторые подпункты
    * и здесь продолжается родительский список
     

    Списки определений (ref) создаются следующим образом:

     термин (до строки текста)
       Определение термина, который должен иметь отступ
       и даже может состоять из нескольких абзацев
    следующий семестр
       Описание.
     

    Обратите внимание, что термин не может содержать более одной строки текста.

    Абзацы в кавычках (ссылка) создаются простым отступом
    их больше, чем окружающие абзацы.

    Блоки строк (ссылка) позволяют сохранить разрывы строк:

     | Эти строки
    | сломан точно так же, как в
    | исходный файл.
     

    Также доступны еще несколько специальных блоков:

    • списки полей (ссылка, с предостережениями, указанными в
      Списки полей)

    • списки опций (ссылка)

    • литеральные блоки в кавычках (ref)

    • блоки doctest (ссылка)

    Буквенные блоки

    Блоки литерального кода (ссылка) вводятся путем окончания
    абзац специальным маркером :: . Буквенный блок должен иметь отступ
    (и, как и все абзацы, отделенные от окружающих пробелом
    строки):

     Это обычный текстовый абзац. Следующий абзац — пример кода::
       Никак не обрабатывается, кроме
       что вмятина удалена.
       Он может охватывать несколько строк.
    Это снова обычный текстовый абзац.
     

    Умное обращение с маркером :: :

    • Если он встречается как отдельный абзац, этот абзац полностью опускается
      документа.

    • Если ему предшествует пробел, маркер удаляется.

    • Если ему предшествует непробельный символ, маркер заменяется одним
      двоеточие.

    Таким образом, второе предложение в первом абзаце вышеприведенного примера будет
    отображается как «Следующий абзац — пример кода:».

    Подсветка кода может быть включена для этих литеральных блоков во всем документе.
    на основе директивы Highlight и на основе всего проекта
    используя параметр конфигурации highlight_language .
    Директива code-block может использоваться для установки выделения на
    поблочной основе. Эти директивы обсуждаются позже.

    Блоки Doctest

    блока Doctest (ссылка) — это интерактивные сеансы Python.
    вырезаны и вставлены в строки документации. Они не требуют
    синтаксис литеральных блоков. Блок doctest должен заканчиваться
    с пустой строкой и должен вместо заканчиваются неиспользуемой подсказкой:

     >>> 1 + 1
    2
     

    Столы

    Для таблиц сетки (ref) необходимо «закрасить» ячейку
    сетка сама. Выглядят они так:

     +------------------------+-------------+---------- +----------+
    | Строка заголовка, столбец 1 | Заголовок 2 | Заголовок 3 | Заголовок 4 |
    | (строки заголовков необязательны) | | | |
    +=======================+=======================+ ==========+
    | строка тела 1, столбец 1 | столбец 2 | столбец 3 | столбец 4 |
    +------------------------+--------------+----------+ ----------+
    | основной ряд 2 | ... | .. . | |
    +------------------------+--------------+----------+ ----------+
     

    Простые таблицы (ref) писать легче, но
    ограничено: они должны содержать более одной строки, а ячейки первого столбца не могут
    содержать несколько строк. Выглядят они так:

     ===== ===== =======
    А Б А и Б
    ===== ===== =======
    Ложь Ложь Ложь
    Верно Ложно Ложно
    Ложно Верно Ложно
    Правда Правда Правда
    ===== ===== =======
     

    Поддерживаются еще два синтаксиса: Таблицы CSV и Таблицы списка . Они используют
    блок явной разметки . См. Таблицы для получения дополнительной информации.

    Гиперссылки

    Внешние ссылки

    Используйте `Текст ссылки `_ для встроенных веб-ссылок. Если
    текст ссылки должен быть веб-адресом, вам вообще не нужна специальная разметка,
    парсер находит ссылки и почтовые адреса в обычном тексте.

    Важно

    Между текстом ссылки и открывающим < для URL-адреса должен быть пробел.

    Вы также можете разделить ссылку и целевое определение (ref), например:

     Это абзац, содержащий `ссылку`_.
    .. _ссылка: https://domain.invalid/
     

    Внутренние ссылки

    Внутреннее связывание выполняется с помощью специальной роли reST, предоставляемой Sphinx, см.
    раздел о специальной разметке, перекрестные ссылки на произвольные местоположения.

    Секции

    Заголовки разделов (ссылка) создаются путем подчеркивания (и
    необязательно с подчёркиванием) название раздела со знаком пунктуации, по крайней мере
    пока текст:

     =================
    это заголовок
    =================
     

    Обычно уровни заголовков не назначаются определенным символам в качестве
    структура определяется последовательностью заголовков. Однако это
    соглашение используется в Руководстве по стилю Python для документирования, которое вы можете
    Следуйте:

    • # с надрезом, для деталей

    • * с чертой, для разделов

    • = для секций

    • - для подразделов 9 для подразделов

    • " для пунктов

    Конечно, вы можете использовать свои собственные маркеры (см.
    документации) и использовать более глубокий уровень вложенности, но имейте в виду, что большинство
    целевые форматы (HTML, LaTeX) имеют ограниченную поддерживаемую глубину вложенности.

    Списки полей

    Списки полей (ссылка) представляют собой последовательности полей, размеченных как
    это:

     :fieldname: содержимое поля
     

    Они обычно используются в документации Python:

     определение my_function (my_arg, my_other_arg):
        """Функция только для меня.
        :param my_arg: Первый из моих аргументов.
        :param my_other_arg: Второй из моих аргументов.
        :returns: Сообщение (только для меня, конечно).
        """
     

    Sphinx расширяет стандартное поведение docutils и перехватывает указанные списки полей
    в начале документов. Дополнительные сведения см. в списках полей.
    Информация.

    ролей

    Роль или «пользовательская интерпретируемая текстовая роль» (ссылка) является встроенной
    кусок явной разметки. Это означает, что вложенный текст должен быть
    интерпретируется определенным образом. Sphinx использует это для обеспечения семантической разметки и
    перекрестные ссылки идентификаторов, как описано в соответствующем разделе.
    общий синтаксис :rolename:`content` .

    Docutils поддерживает следующие роли:

    • ударение – эквивалент *выделение*

    • сильный – эквивалент **сильный**

    • литерал – эквивалент ``литерал``

    • нижний индекс – текст нижнего индекса

    • верхний индекс – текст верхнего индекса

    • title-reference – для названий книг, периодических изданий и др.
      материалы

    См. Роли, добавленные Sphinx.

    Явная разметка

    «Явная разметка» (ref) используется в reST для
    большинство конструкций, требующих специальной обработки, таких как сноски,
    специально выделенные параграфы, комментарии и общие директивы.

    Блок явной разметки начинается со строки, начинающейся с . . , за которой следует
    пробел и завершается следующим абзацем на том же уровне
    отступ. (Должна быть пустая строка между явной разметкой и
    нормальные абзацы. Все это может показаться немного сложным, но это интуитивно понятно
    достаточно, когда вы это пишете.)

    Директивы

    Директива (ref) — это общий блок явной разметки.
    Наряду с ролями это один из механизмов расширения reST и Sphinx.
    интенсивно использует его.

    Docutils поддерживает следующие директивы:

    • Предупреждения: внимание, осторожность, опасность,
      ошибка, подсказка, важное, примечание,
      совет, предупреждение и общий
      замечание. (Большинство тем оформляют только «примечание» и
      специально «предупреждение».)

    • Изображения:

    • Дополнительные элементы кузова:

      • содержимое (локальное, т.е. для текущего файла
        только оглавление)

      • контейнер (контейнер с пользовательским классом, полезный для создания
        внешний

        в HTML)

      • рубрика (заголовок без привязки к разделу документа)

      • тема, боковая панель (специально выделенные элементы тела)

      • parsed-literal (литеральный блок, поддерживающий встроенную разметку)

      • эпиграф (блочная цитата с необязательным указанием авторства)

      • основные моменты, кавычки (блочные кавычки со своими
        атрибут класса)

      • составной (составной абзац)

    • Специальные столы:

      • таблица (таблица с заголовком)

      • csv-таблица (таблица, созданная из значений, разделенных запятыми)

      • таблица-список (таблица, созданная из списка списков)

    • Специальные директивы:

      • необработанный (включая необработанную разметку целевого формата)

      • include (включить reStructuredText из другого файла) — в Sphinx,
        когда задан абсолютный путь к включаемому файлу, эта директива принимает его как
        относительно исходного каталога

      • класс (назначить атрибут класса следующему элементу)

        Примечание

        Если домен по умолчанию содержит директиву класса , эта директива
        будет затенен. Поэтому Sphinx реэкспортирует его как первый класс .

    • Особенности HTML:

      • мета
        (генерация тегов HTML , см. также метаданные HTML ниже)

      • название (переопределить название документа)

    • Влияющая наценка:

      Так как это только для каждого файла, лучше использовать возможности Sphinx для установки
      роль_по умолчанию .

    Предупреждение

    Выполнить Не использовать директивы sectnum, header и
    нижний колонтитул.

    Директивы, добавленные Sphinx, описаны в Директивах.

    По сути, директива состоит из имени, аргументов, опций и содержимого.
    (Запомните эту терминологию, она используется в следующей главе, описывающей
    пользовательские директивы.) Глядя на этот пример,

     .. функция:: foo(x)
                  фу(у, г)
       :module: некоторый.module.name
       Возвращает строку ввода текста от пользователя. 
     

    функция — это имя директивы. Здесь приведены два аргумента:
    остаток первой строки и второй строки, а также один вариант
    модуль (как видите варианты даны в строках сразу
    следующие за аргументами и отмеченные двоеточием). Опции должны быть с отступом
    на том же уровне, что и директивное содержание.

    Содержимое директивы следует после пустой строки и имеет отступ относительно
    начало директивы или, если присутствуют параметры, на ту же величину, что и
    опции.

    Будьте осторожны, так как отступ не является фиксированным количеством пробелов, например. три, но
    любое количество пробелов. Это может удивить, когда используется фиксированный отступ.
    по всему документу и может иметь значение для директив, которые
    чувствителен к пробелам. Сравните:

     .. кодовый блок::
       :caption: Классный пример
           Вывод этой строки начинается с четырех пробелов.
    .. кодовый блок::
           Вывод этой строки не имеет пробелов в начале.
     

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

    Изображения

    reST поддерживает директиву изображения (ref), используемую следующим образом:

     .. изображение:: gnu.png
       (опции)
     

    При использовании в Sphinx указанное имя файла (здесь gnu.png ) должно быть
    относительно исходного файла или абсолютные, что означает, что они относятся к
    верхний исходный каталог. Например, файл sketch/spam.rst может
    обращаться к изображению images/spam.png как ../images/spam.png или
    /images/spam.png .

    Sphinx автоматически копирует файлы изображений в подкаталог вывода
    каталог по зданию (например, _static каталог для вывода HTML.)

    Интерпретация параметров размера изображения ( ширина и высота ) выглядит следующим образом:
    если размер не имеет единицы измерения или единицей измерения являются пиксели, заданный размер будет только
    соблюдается для выходных каналов, поддерживающих пиксели. Другие единицы (например, pt для
    точек) будет использоваться для вывода HTML и LaTeX (последний заменяет pt на
    bp , так как это единица TeX, такая, что 72bp=1in ).

    Sphinx расширяет стандартное поведение docutils, позволяя использовать звездочку для
    расширение:

     .. изображение:: gnu.*
     

    Затем

    Sphinx ищет все изображения, соответствующие предоставленному шаблону, и
    определяет их тип. Затем каждый строитель выбирает лучшее изображение из этих
    кандидаты. Например, если было задано имя файла gnu.* и два файла
    gnu.pdf и gnu.png существовали в исходном дереве, LaTeX
    строитель выберет первое, в то время как строитель HTML предпочтет
    последний. Поддерживаемые типы изображений и приоритет выбора определяются на
    Строители.

    Обратите внимание, что имена файлов изображений не должны содержать пробелов.

    Изменено в версии 0.4: Добавлена ​​поддержка имен файлов, оканчивающихся звездочкой.

    Изменено в версии 0.6: Пути к изображениям теперь могут быть абсолютными.

    Изменено в версии 1.5: цель латекса поддерживает пиксели (по умолчанию 96px=1in ).

    Сноски

    Для сносок (ref) используйте [#name]_ , чтобы отметить сноску
    месте и добавьте тело сноски внизу документа после
    Заголовок рубрики «Сноски», например:

     Lorem ipsum [#f1]_ dolor sit amet ... [#f2]_
    .. рубрика:: Сноски
    .. [#f1] Текст первой сноски.
    .. [#f2] Текст второй сноски.
     

    Вы также можете явно нумеровать сноски ( [1]_ ) или использовать автоматическую нумерацию
    сноски без имен ( [#]_ ).

    Цитаты

    Поддерживаются стандартные ссылки reST (ссылка), с
    дополнительная особенность в том, что они являются «глобальными», т. е. на все цитаты можно ссылаться
    из всех файлов. Используйте их так:

     Lorem ipsum [Ref]_ dolor sit amet.
    .. [Ref] Ссылка на книгу или статью, URL или что-то еще. 
     

    Использование цитирования похоже на использование сносок, но с меткой, которая не
    числовой или начинается с # .

    Замены

    reST поддерживает «замены» (ссылка), которые
    фрагменты текста и/или разметки, на которые в тексте ссылается |name| . Они
    определяются как сноски с явными блоками разметки, например:

     .. |имя| replace:: замена *текст*
     

    или это:

     .. |осторожно| изображение:: предупреждение.png
                 :alt: Внимание!
     

    См. справочник reST для замен
    для деталей.

    Если вы хотите использовать некоторые замены для всех документов, поместите их в
    rst_prolog или rst_epilog или поместите их в отдельный файл
    и включите его во все документы, в которых вы хотите их использовать, используя
    включает директиву . (Обязательно дайте включаемому файлу имя файла
    расширение, отличающееся от расширения других исходных файлов, чтобы Sphinx не нашел его
    как самостоятельный документ. )

    Sphinx определяет некоторые замены по умолчанию, см. Замены.

    Метаданные HTML

    Директива meta (ссылка) позволяет указать HTML
    элемент метаданных страницы документации Sphinx. Например,
    директива:

     .. мета::
       :description: Конструктор документации Sphinx
       :keywords: Sphinx, документация, конструктор
     

    будет генерировать следующий вывод HTML:

    Кроме того, Sphinx добавит ключевые слова, указанные в мета-директиве, в
    индекс поиска. Таким образом, атрибут lang метаэлемента
    считается. Например, директива:

     .. мета::
       :ключевые слова: резервное копирование
       :keywords lang=en: пожалуйста, найдите этот ключ, пожалуйста, найдите этот ключ тоже
       :keywords lang=de: bittediesenkeyfinden
     

    добавляет следующие слова в поисковые индексы сборок с другим языком
    конфигурации:

    • пожалуйста, найдите этот ключ , пожалуйста, найдите этот ключ тоже от до Английский сборок;

    • bittediesenkeyfinden — Немецкий сборок;

    • резервное копирование для сборок на всех языках.