tag:linuxfr.org,2005:/tags/asciidoc/publicLinuxFr.org : les contenus étiquetés avec « asciidoc »2022-07-21T22:13:32+02:00/favicon.pngtag:linuxfr.org,2005:Bookmark/49412022-07-19T16:30:09+02:002022-07-19T16:30:09+02:00Les limites de Markdown (pour rédiger de la documentation) face aux capacités d’Asciidoc<a href="https://mister-gold.pro/posts/do-not-use-markdown-for-docs/">https://mister-gold.pro/posts/do-not-use-markdown-for-docs/</a> <p>
<strong>Commentaires :</strong>
<a href="//linuxfr.org/nodes/128333/comments.atom">voir le flux Atom</a>
<a href="https://linuxfr.org/users/terhemis/liens/les-limites-de-markdown-pour-rediger-de-la-documentation-face-aux-capacites-d-asciidoc#comments">ouvrir dans le navigateur</a>
</p>
terhemishttps://linuxfr.org/nodes/128333/comments.atomtag:linuxfr.org,2005:Diary/388052019-11-27T23:01:05+01:002019-11-27T23:01:05+01:00Documentation du format AsciiDoc en françaisLicence CC By‑SA http://creativecommons.org/licenses/by-sa/4.0/deed.fr<p>Bonjour,</p>
<p>Comme annoncé sur le Grimoire-Command.es (<a href="https://www.grimoire-command.es/2019/asciidoc_quickdoc_in_french.html#_version_fr">https://www.grimoire-command.es/2019/asciidoc_quickdoc_in_french.html#_version_fr</a> ) le sous-ensemble « <em>quickdoc</em> » de la documentation officielle d’AsciiDoctor a été traduit en français (par des bénévoles de Gebull.org dont je fais partie).</p>
<p>Dans l’attente de la publication de cette traduction par l’équipe du projet, il est possible de la consulter en ligne sur Framagit :</p>
<p><a href="https://framagit.org/Siltaar/asciidoctor-docs-fr">https://framagit.org/Siltaar/asciidoctor-docs-fr</a></p>
<p>Le travail peut être complété et mis à jour si vous souhaiter y contribuer.</p>
<p>En attendant, puisque Framagit sait interpréter le format AsciiDoc, il est agréable de lire cette version de la documentation directement depuis le dépôt de code.</p>
<div><a href="https://linuxfr.org/users/siltaar/journaux/documentation-du-format-asciidoc-en-francais.epub">Télécharger ce contenu au format EPUB</a></div> <p>
<strong>Commentaires :</strong>
<a href="//linuxfr.org/nodes/118753/comments.atom">voir le flux Atom</a>
<a href="https://linuxfr.org/users/siltaar/journaux/documentation-du-format-asciidoc-en-francais#comments">ouvrir dans le navigateur</a>
</p>
Siltaärhttps://linuxfr.org/nodes/118753/comments.atomtag:linuxfr.org,2005:Diary/352432014-09-13T14:13:17+02:002014-09-13T14:13:17+02:00int *(*(*foo[])(int))(float*);Licence CC By‑SA http://creativecommons.org/licenses/by-sa/4.0/deed.fr<p>Salut,</p>
<p>J'ai profité de mes vacances pour rédiger un petit article sur la lecture des déclarations complexes (dans le sens "obscures") en <strong>C</strong>. Ces "monstres" comme celui du titre, ne sont pas forcément fréquents, mais il peut-être utile de savoir les lire et de manière symétrique de pouvoir les construire.</p>
<p>Un petit rappel des déclarations est proposé autour de quelques éléments clés :</p>
<ul>
<li>déclaration vs définition, </li>
<li>décomposition d'une déclaration : <em>storage class, type qualifier, type specifier, declarator</em>
</li>
<li>les opérateurs légaux dans une déclaration (<code>*, [], ()</code>) et les précédences</li>
</ul><p>Finalement, une méthode de lecture simple et facile à retenir est présentée. Cette méthode permet d'attaquer toutes les déclarations, aussi complexes soient-elles . Références et outils (<code>cdecl</code> !) concluent l'article.</p>
<p>Il s'agissait aussi pour moi de tester AsciiDoc (via AsciiDoctor) qui est une espèce de super Markdown et dont je ne pourrai plus me passer maintenant :-) Je ne sais pas si quelqu'un a fait une dépêche ou un journal sur AsciiDoctor d'ailleurs ? Quoiqu'il en soit, l'article est sous licence <strong>CC-by-sa</strong>. S'il peut-être utile à quelqu'un j'aurai gagné ma journée !</p>
<ul>
<li><a href="http://dcpweb.fr/articles/declarations_c.html">Les déclarations complexes en C</a></li>
<li><a href="http://dcpweb.fr/articles/asciidoc/declarations_c.ad">La source de l'article en AsciiDoc</a></li>
<li><a href="http://asciidoctor.org/">AsciiDoctor</a></li>
</ul><div><a href="https://linuxfr.org/users/dcp/journaux/int-foo-int-float.epub">Télécharger ce contenu au format EPUB</a></div> <p>
<strong>Commentaires :</strong>
<a href="//linuxfr.org/nodes/103276/comments.atom">voir le flux Atom</a>
<a href="https://linuxfr.org/users/dcp/journaux/int-foo-int-float#comments">ouvrir dans le navigateur</a>
</p>
dcphttps://linuxfr.org/nodes/103276/comments.atom