{"id":2960,"date":"2020-06-18T13:57:54","date_gmt":"2020-06-18T11:57:54","guid":{"rendered":"https:\/\/ceo.oric.org\/?p=2960"},"modified":"2020-06-18T13:57:54","modified_gmt":"2020-06-18T11:57:54","slug":"creer-des-ecrans-texte-a-partir-de-fichiers-markdown","status":"publish","type":"post","link":"https:\/\/oric.bqtt.net\/index.php\/2020\/06\/18\/creer-des-ecrans-texte-a-partir-de-fichiers-markdown\/","title":{"rendered":"Cr\u00e9er des \u00e9crans texte \u00e0 partir de fichiers Markdown"},"content":{"rendered":"\n

md2hlp est un outil programm\u00e9 en python qui permet de g\u00e9n\u00e9rer des \u00e9crans textes Oric \u00e0 partir de fichier Markdown (.md). L’outil est tr\u00e8s utile pour faire par exemple des man pages sur Orix.<\/p>\n\n\n\n

Il fonctionne avec un script python, un fichier de conf et un fichier markdown en entr\u00e9e. Ci dessous une image g\u00e9n\u00e9r\u00e9e avec un markdown en entr\u00e9e.<\/p>\n\n\n\n

\"\"
Le r\u00e9sultat<\/figcaption><\/figure>\n\n\n\n

Le but de l’outil est d’avoir un \u00e9cran texte g\u00e9n\u00e9r\u00e9 par un fichier mark down tout en se basant sur un fichier de conf qui d\u00e9finira la mise en forme de l’\u00e9cran, sans avoir \u00e0 faire la mise en forme manuellement.<\/p>\n\n\n\n

Commen\u00e7ons<\/h2>\n\n\n\n

Nous allons faire un \u00e9cran avec un exemple de base (il vous faudra python3. Pour python2, il y a aussi la version du script python dans src\/)<\/p>\n\n\n\n

$ git clone https:\/\/github.com\/assinie\/md2hlp.git\n$ cd md2hlp\/src\/\n$ python md2hlp.py3 -f ..\/examples\/basic11.md -o basic11.hlp<\/pre>\n\n\n\n
A ce stade, vous obtenez un fichier .hlp. C’est juste un \u00e9cran texte.<\/p>\n\n\n\n
Maintenant, ajoutons un header pour qu’il se charge en $BB80. Il faudra osdk avec le binaire header et sp\u00e9cifier l’adresse $bb80 pour charger le .tap \u00e0 la bonne adresse texte<\/p>\n\n\n\n
Allons plus loin<\/h2>\n\n\n\n
Nous avons affich\u00e9 la page avec la configuration par d\u00e9faut qui est contenue ici : https:\/\/github.com\/assinie\/md2hlp\/blob\/master\/src\/md2hlp.cfg<\/a><\/p>\n\n\n\n
Cette configuration d\u00e9finit comment le programme python doit convertir le fichier .md (c’est une sorte de template)<\/p>\n\n\n\n
Cherchons la ligne contenant  [Heading1] et rempla\u00e7ons cette ligne : <\/p>\n\n\n\n
Head = __^J ^Q_ORIX    1.0  ^P___ <\/p>\n\n\n\n
par <\/p>\n\n\n\n
Head = __^J ^Q_POUET  POUET  ^P___ <\/p>\n\n\n\n
Notez les ^J ^Q etc : Cela correspond aux attributs d\u00e9finis dans le fichier de conf. Si vous cherchez ^J, vous tomberez sur :  double_height = ^J <\/p>\n\n\n\n
Nous avons d\u00e9fini que le double_height est le contr\u00f4le ^J. Ainsi, le titre sera en double hauteur.<\/p>\n\n\n\n
paper_red = ^Q  indique que ^Q sera le paper en rouge. Ainsi, notre POUET POUET sera \u00e9galement sur fond rouge. Je vous laisse trouver \u00e0 quoi sert le ^P<\/p>\n\n\n\n
Pour finir, il suffit de d\u00e9finir un template qui d\u00e9terminera ensuite l’apparence de votre fichier .md en sortie sur l’\u00e9cran texte.<\/p>\n\n\n\n
L’outil md2hlp est utilis\u00e9 pour faire les man pages sur Orix. Nous avons juste \u00e0 mettre \u00e0 jour les fichiers md, puis nous lan\u00e7ons md2hlp qui fera le reste. Par exemple, pour Orix, le fichier .hlp doit \u00eatre plac\u00e9 dans \/usr\/share\/man.<\/p>\n\n\n\n
Au lancement de man, il suffira de sp\u00e9cifier en param\u00e8tre le fichier hlp d\u00e9pos\u00e9 dans le r\u00e9pertoire sans le .hlp<\/p>\n","protected":false},"excerpt":{"rendered":"
md2hlp est un outil programm\u00e9 en python qui permet de g\u00e9n\u00e9rer des \u00e9crans textes Oric \u00e0 partir de fichier Markdown (.md). L’outil est tr\u00e8s utile pour faire par exemple des man pages sur Orix. Il fonctionne avec un script python, un fichier de conf et un fichier markdown en entr\u00e9e. Ci dessous une image g\u00e9n\u00e9r\u00e9e […]<\/p>\n","protected":false},"author":1,"featured_media":2962,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[338,344,22,318],"tags":[671],"class_list":["post-2960","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-338","category-applications","category-ceomag","category-software","tag-ceomag361"],"_links":{"self":[{"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/posts\/2960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/comments?post=2960"}],"version-history":[{"count":0,"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/posts\/2960\/revisions"}],"wp:attachment":[{"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/media?parent=2960"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/categories?post=2960"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oric.bqtt.net\/index.php\/wp-json\/wp\/v2\/tags?post=2960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}