2016-02-12 1 views
1

J'utilise des commentaires JSDoc dans un fichier JS et j'exécute JSDoc2MD pour restituer ces commentaires dans un fichier readme.md markdown. Je veux inclure des exemples de code dans ma documentation en utilisant le @example tag de JSDoc. J'ai des problèmes avec le rendu d'une chaîne avec des guillemets.Exemple de code de démarquage avec chaîne (JSDoc2MD)

Dans mes JS commentaires J'ai:

/** @example 
* // returns true 
* yesNo("Do you like cheese?"); 
*/ 

Ce commentaire est le suivant dans JSON:

{ 
"examples": [ 
     "// returns true\nyesNo(\"Do you like cheese?\");" 
    ] 
} 

J'ai une configuration de modèle de guidon personnalisés qui JSDoc2MD utilise pour générer le readme. Dans mon modèle de guidon je:

```js 
{{#each examples}} 
{{this}} 
{{/each}} 
``` 

Le readme généré a le nom HTML au lieu des guillemets:

```js 

// returns true 
yesNo("Do you like cheese?"); 

``` 

Ainsi, la sortie de démarquage semble bien attendre pour les guillemets:

// returns true 
yesNo("Do you like cheese?"); 

Quelqu'un d'autre qui travaille avec JSDoc2MD a ce problème? Est-ce que je viens de taper quelque chose de mal ici?

+0

Quel est le problème? Les entités HTML s'affichent sous forme de guillemets dans le navigateur. En fait, certaines implémentations de Markdown convertissent divers caractères en leurs entités HTML. – Waylan

+0

Et [most] (http://johnmacfarlane.net/babelmark2/?normalize=1&text=yesNo (% 26quot% 3BDo + you + like + cheese% 3F% 26quot% 3B)% 3B) Les implémentations de Markdown transmettent les entités HTML sans les modifier . En passant, utilisez l'onglet "Aperçu" pour voir que les navigateurs affichent les choses correctement. – Waylan

Répondre

0

c'est une chose guidon, essayez ceci:

```js 
{{#each examples}} 
{{{this}}} 
{{/each}} 
``` 

les notes triple crochets autour this .. voir here et chercher "planque triple".

+1

Exactement ce dont j'avais besoin. Merci Lloyd. – Sara