API Blueprint внутристраничные ссылки в группе ресурсов? - PullRequest
Новая
       27

API Blueprint внутристраничные ссылки в группе ресурсов?

0 голосов
/ 06 июня 2018

Я пишу API данных продукта в Blueprint, и я хотел бы предоставить ссылку в параметре styleNumber на # Group Value References под Ресурсом.

## GET Details for products that match any combination of the parameters below [/productservice/products/{?language,styleNumber}]

### Product Service (Products) [GET]
+ Parameters

    + language (array[string],optional)-_One or more 2 letter language codes ([ISO 639-1](https://www.loc.gov/standards/iso639-2/php/code_list.php) format, comma separated)_
    + styleNumber (array[string],optional)-_One or more 5 digit proprietary product style IDs (comma separated) See **[Value References](#Group Value References)**._

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

1 Ответ

0 голосов
/ 07 июня 2018

Попробуйте 

    ... See [Value References](/reference/value-references)._

Это должен быть путь к фактическому заголовку, а не заголовок.

URI не может содержать пробелы и т. Д., Поэтому то, что у вас нетпредназначен для работы.Я считаю, что #value-references предназначен для работы в качестве якоря URI, но он не работает в документации по пасеке.Возможно, ошибка, но, возможно, дизайн.

...