Api-blueprint: Destaque de sintaxe no Apiary.io

Criado em 29 fev. 2016 · 6Comentários · Fonte: apiaryio/api-blueprint

Gostaria de colocar alguns exemplos de código adicionais (Código PHP de como usar nossa API) na API Blueprint Specification no Apiary.io.

O destaque de código padrão assim funciona

my code

O realce de sintaxe de código PHP não funciona, parece o realce de código padrão:

``` php

$private_key = file_get_contents('id_rsa');
$client_id = ' https://www.my-client-app.com ';
$user_id = ' [email protected] ';
$grant_type = ' urn:ietf : params: oauth :grant-type:jwt-bearer ';

$jwt = gerar
``````

Apiary.io Feature

Fonte

Perni1984

👍6

Comentários muito úteis

Alguma novidade sobre isso?

yardensachs em 29 ago. 2016

👍5

Todos 6 comentários

Eu li que, por exemplo, Atlassian está usando CodeMirror para realce de sintaxe. Eventualmente, isso também seria possível para apiary.io (ele tem uma licença MIT)

Perni1984 em 9 mar. 2016

outra ideia seria usar highlight.js , que suporta realce de sintaxe PHP e HTTP e várias outras linguagens.

Perni1984 em 9 mar. 2016

Alguma novidade sobre isso?

yardensachs em 29 ago. 2016

👍5

talkoren em 16 nov. 2016

Isso seria muito bom para nós também.

O Github faz isso da melhor maneira e suporta a maioria dos idiomas, até onde posso dizer (fico especialmente feliz quando o elixir-lang está devidamente destacado).

https://help.github.com/articles/creating-and-highlighting-code-blocks/#syntax -highlighting

ryanwinchester em 2 fev. 2018

Olá, confira o anúncio sobre nossa nova documentação da API https://blog.apiary.io/ApiaryUI. Introduzimos o realce de sintaxe, ele ainda não suporta todos os idiomas (você pode ver uma lista de idiomas suportados no anúncio).

Veja como fica:

screenshot 2019-01-17 at 10 09 22

import requests

requests.get('https://api.example.com')

Se você tiver outras solicitações de recursos ou relatórios de bugs específicos da documentação renderizada do Apiary, entre em contato com o suporte do Apiary. Este repositório e rastreador de problemas está rastreando a especificação do API Blueprint. Se você tiver alguns pedidos de idiomas suportados, não deixe de entrar em contato com o suporte do Apiary para que possamos priorizá-los de acordo.