{"id":137,"date":"2005-07-11T18:43:05","date_gmt":"2005-07-11T18:43:05","guid":{"rendered":"http:\/\/www.lucas-nussbaum.net\/blog\/?p=137"},"modified":"2005-07-11T18:43:05","modified_gmt":"2005-07-11T18:43:05","slug":"le-format-rst-restructuredtext","status":"publish","type":"post","link":"https:\/\/www.lucas-nussbaum.net\/blog\/?p=137","title":{"rendered":"Le format RST : reStructuredText"},"content":{"rendered":"<p>Le format <a href=\"http:\/\/docutils.sourceforge.net\/rst.html\">RST<\/a> (reStructuredText) est un format ouvert WYSIWYG tr\u00e8s simple et tr\u00e8s pratique, avec un rapport signal\/bruit proche de l&#8217;optimal. Son cas d&#8217;utilisation typique est l&#8217;\u00e9criture de petits documents (TODO lists, r\u00e9sum\u00e9s, courts articles, etc&#8230;). Il permet d&#8217;\u00e9crire des documents naturellement, avec simple \u00e9diteur de texte. Mais prenons plut\u00f4t un petit exemple :<\/p>\n<pre> ================= Titre du document ================= Titre de section ================ Titre de sous-section --------------------- Titre de sous-sous-section ~~~~~~~~~~~~~~~~~~~~~~~~~~ ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe. - Une liste - 2eme item   * imbrication de listes   * imbrication de listes, 2eme item - 3e item 1) liste ordonn\u00e9e 2) suite de la liste ordonn\u00e9e --------- Il y avait une ligne de s\u00e9paration avant ce paragraphe. Une autre section ================= Les liens comme http:\/\/www.perdu.com sont transform\u00e9s dans la version HTML. On peut aussi faire des liens avec des titres comme `ce lien &lt;http:\/\/www.perdu.com&gt;` <\/pre>\n<p>Et on peut exporter vers de l&#8217;HTML (XHTML 1.0 Transitional, en fait), du LaTeX (pour faire du PostScript ou du PDF) ou du XML (id\u00e9al si vous maitrisez XSLT). Le convertisseur vers l&#8217;HTML est suffisamment rapide pour l&#8217;ex\u00e9cuter depuis un fichier PHP : ca vous fait un moyen de lire facilement votre TODO list \u00e0 distance.<\/p>\n<p>Pour installer rst2html, rst2latex et rst2xml sous Debian, c&#8217;est le paquet <i>python-docutils<\/i> (RST \u00e9tant utilis\u00e9 pour \u00e9crire de la doc Python).<\/p>\n<p>Si vous voulez en savoir plus :<\/p>\n<ul>\n<li>Le site du format RST : <a href=\"http:\/\/docutils.sourceforge.net\/rst.html\">http:\/\/docutils.sourceforge.net\/rst.html<\/a><\/li>\n<li>Une courte introduction : <a href=\"http:\/\/docutils.sourceforge.net\/docs\/user\/rst\/quickstart.html\">http:\/\/docutils.sourceforge.net\/docs\/user\/rst\/quickstart.html<\/a><\/li>\n<li>Une doc plus compl\u00e8te : <a href=\"http:\/\/docutils.sourceforge.net\/docs\/user\/rst\/quickref.html\">http:\/\/docutils.sourceforge.net\/docs\/user\/rst\/quickref.html<\/a> <\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Le format RST (reStructuredText) est un format ouvert WYSIWYG tr\u00e8s simple et tr\u00e8s pratique, avec un rapport signal\/bruit proche de l&#8217;optimal. Son cas d&#8217;utilisation typique est l&#8217;\u00e9criture de petits documents (TODO lists, r\u00e9sum\u00e9s, courts articles, etc&#8230;). Il permet d&#8217;\u00e9crire des documents naturellement, avec simple \u00e9diteur de texte. Mais prenons plut\u00f4t un petit exemple : ================= [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"0","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-137","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/137","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=137"}],"version-history":[{"count":0,"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/137\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=137"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=137"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.lucas-nussbaum.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}