Skip to content

Commit bcd5cd0

Browse files
gayratvgayratvgmyusosnovskay
authored
fix(guides YFM syntax) описал использование якорей в YFM (yandex-cloud#268)
* fix(guides YFM syntax) описал использование якорей в YFM Добавлено описание использования якорей в YFM, поправлены грамматические ошибки. https://github.com/yandex-cloud/docs/blob/master/guides/yfm-syntax-ru.md#links * Update yfm-syntax-ru.md * Update yfm-syntax-ru.md * Update yfm-syntax-ru.md Co-authored-by: Ulibka68 <gena68@inbox.ru> Co-authored-by: myusosnovskay <75673473+myusosnovskay@users.noreply.github.com>
1 parent d57fcbc commit bcd5cd0

File tree

1 file changed

+29
-4
lines changed

1 file changed

+29
-4
lines changed

guides/yfm-syntax-ru.md

Lines changed: 29 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
* [Упорядоченный список](#ordered-list)
1111
* [Таблицы](#tabels)
1212
* [Ссылки](#links)
13+
* [Ссылки на якорь](#links-to-anchor)
1314
* [Ссылки с автоматической подстановкой текста из заголовка](#auto-links)
1415
* [Вставка кода](#code)
1516
* [Фрагмент кода внутри текста](#inline-code)
@@ -128,7 +129,7 @@
128129

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

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

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

@@ -168,7 +169,7 @@
168169

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

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

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

@@ -203,6 +204,30 @@
203204

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

207+
### Ссылки на якорь <a name="links-to-anchor"></a>
208+
209+
Ссылки на якорь имеют вид `[текст](путь_до_файла#якорь)`.
210+
211+
Например, чтобы сделать ссылку на якорь `anchor` в файле `basic.md`, воспользуйтесь разметкой вида:
212+
213+
```markdown
214+
[Link to anchor](./basic.md#anchor)
215+
```
216+
217+
Если файл `basic.md` расположен в папке `_includes`, в ссылке необходимо указать путь до того файла, в котором он используется.
218+
219+
Например, файл `basic.md` расположен в папке `_includes` и используется в файле `hard.md`:
220+
221+
```markdown
222+
{% include [File content](../_includes/basic.md) %}
223+
```
224+
225+
В таком случае, чтобы сделать ссылку на якорь `anchor` в файле `basic.md`, воспользуйтесь разметкой вида:
226+
227+
```markdown
228+
[Link to anchor](./hard.md#anchor)
229+
```
230+
206231
### Ссылки с автоматической подстановкой текста из заголовка <a name="auto-links"></a>
207232

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

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

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

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

@@ -364,7 +389,7 @@ let a= 10;
364389

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

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

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

0 commit comments

Comments
 (0)