Skip to content

fix(guides YFM syntax) описал использование якорей в YFM #268

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jan 11, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 29 additions & 4 deletions guides/yfm-syntax-ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
* [Упорядоченный список](#ordered-list)
* [Таблицы](#tabels)
* [Ссылки](#links)
* [Ссылки на якорь](#links-to-anchor)
* [Ссылки с автоматической подстановкой текста из заголовка](#auto-links)
* [Вставка кода](#code)
* [Фрагмент кода внутри текста](#inline-code)
Expand Down Expand Up @@ -128,7 +129,7 @@

### Упорядоченный список <a name="ordered-list"></a>

Чтобы оформить упорядоченный нумерованый список, используйте цифры с символом `.` или `)`. Рекомендованный формат разметки: цифра `1` и символ `.`.
Чтобы оформить упорядоченный нумерованный список, используйте цифры с символом `.` или `)`. Рекомендованный формат разметки: цифра `1` и символ `.`.

Например, разметка:

Expand Down Expand Up @@ -168,7 +169,7 @@

Каждая строка таблицы состоит из ячеек, отделенных друг от друга символами `|`.

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

Таблицу нужно отделять от предшествующего и последующего текста пустыми строками.

Expand Down Expand Up @@ -203,6 +204,30 @@

[ссылка на README.md](README.md)

### Ссылки на якорь <a name="links-to-anchor"></a>

Ссылки на якорь имеют вид `[текст](путь_до_файла#якорь)`.

Например, чтобы сделать ссылку на якорь `anchor` в файле `basic.md`, воспользуйтесь разметкой вида:

```markdown
[Link to anchor](./basic.md#anchor)
```

Если файл `basic.md` расположен в папке `_includes`, в ссылке необходимо указать путь до того файла, в котором он используется.

Например, файл `basic.md` расположен в папке `_includes` и используется в файле `hard.md`:

```markdown
{% include [File content](../_includes/basic.md) %}
```

В таком случае, чтобы сделать ссылку на якорь `anchor` в файле `basic.md`, воспользуйтесь разметкой вида:

```markdown
[Link to anchor](./hard.md#anchor)
```

### Ссылки с автоматической подстановкой текста из заголовка <a name="auto-links"></a>

В YFM вы можете добавлять ссылки на другие md-файлы без указания текста ссылки. Он подставится автоматически из заголовка указанного файла.
Expand Down Expand Up @@ -275,7 +300,7 @@ let a= 10;

### Вставка через ссылку <a name="link-insert"></a>

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

1. Объявите изображение:

Expand Down Expand Up @@ -364,7 +389,7 @@ let a= 10;

## Переиспользование контента <a name="includes"></a>

Вы можете вынести повторяющийся контент в отдельный файл и вставлять его в документ с помощью элемента **{% include %}**. Часто такой подход оказывается удобнне, чем "копировать-вставить".
Вы можете вынести повторяющийся контент в отдельный файл и вставлять его в документ с помощью элемента **{% include %}**. Часто такой подход оказывается удобнее, чем "копировать-вставить".

Чтобы использовать один и тот же контент в нескольких местах:

Expand Down