Vie de document confortable avec Docutils et Ruby

Vie de document confortable avec Docutils et Ruby

Ce n'est pas une toute nouvelle histoire, mais je vais rejoindre le calendrier de l'avent pour organiser ce que j'ai fait auparavant.

  1. J'aime reST

Tout d'abord, j'ai aimé setext (texte structuré). Alors bien sûr, j'aime reST. La plupart du temps, si vous ne dites pas les détails, Markdown fera le travail, mais si vous voulez créer un fichier Office et faire des ajustements pour l'impression, j'utilise reST.

Naturellement parce que c'est reST

Est utilisé. La méthode d'installation est pliée. c'est simple.

  1. Écrivez avec rst2html.py + guard quand même

La première étape consiste à "tourner rapidement l'aperçu".

J'utilise donc guard, mon outil Ruby préféré qui est aussi bon ou meilleur que reST. Ceci est une bibliothèque pour surveiller les changements de fichiers et faire diverses choses, ici

  1. Appuyez sur rst2html.py depuis guard-shell pour générer du HTML
  2. Ouvrez le HTML résultant dans un navigateur et prévisualisez-le, mais surveillez la génération HTML et rechargez automatiquement avec guard-livereload.

Je vais vous faire prendre en charge les deux tâches de. Les trois bibliothèques suivantes sont effectivement utilisées.

En tant que serveur Web, utilisez SimpleHTTPServer de Python ou WEBrick de Ruby selon le cas.

est.

reST-writing environment with realtime HTML-preview — Gist

  1. Générez et terminez odt avec rst2odt.py + rake

S'il n'y a pas de problème avec le contenu de l'aperçu, cette fois mon travail

wtnabe/rst2odt_stylesheet

Utiliser. Git clonez ceci et renommez le premier fichier cible en sample.rst. Ce que ce gars peut faire

est. Malheureusement, le fichier reST et le fichier odt n'ont pas été modifiés pendant deux ans avec le nom sample, et je n'utilise que Mac, pensant que open devrait utiliser une bibliothèque qui résume cela. Ce n'est pas le cas, il en est ainsi.

Après avoir ouvert le fichier odt, ajustez le style d'impression, et si vous remarquez une erreur à ce stade, corrigez le premier fichier à chaque fois.

rake open

Ce sera un flux à faire.

Enfin, je pense que c'est plus facile à partager si vous exportez le PDF depuis LibreOffice (OpenOffice.org).

  1. Résumé

Ce n'est pas très unifié et ma tâche de râteau rst2odt_stylesheet n'est pas très complète, mais au moins je pense qu'il est beaucoup plus facile d'écrire un document que d'écrire soudainement dans Word.

reST est une notation très polyvalente car elle incarne l'une des fonctionnalités de son prédécesseur, setext, "il n'est pas anormal de l'intégrer dans un email tel quel", et la notation de table est également organisée. De plus, si vous le convertissez en odt de cette manière puis que vous l'exportez au format PDF, la structure de la phrase sera reflétée dans le PDF final, de sorte que même un long document sera plus facile à lire.

Les chats et la louche sont des Markdown ces jours-ci, alors pourquoi ne pas essayer d'écrire un document avec reST?

Ce qui est regrettable, c'est que les systèmes de traitement ne sont pas disponibles dans chaque langue comme Markdown. Comme il ne concerne pratiquement que Python, il peut être utilisé avec Trac, mais je pense qu'il est difficile de l'utiliser depuis Redmine. Je me demande si quelqu'un le portera

Recommended Posts

Vie de document confortable avec Docutils et Ruby
Vie de document confortable avec Sphinx + Drone + S3
Briller la vie avec Python et OpenCV
Scraping avec Node, Ruby et Python
Crypter avec Ruby (Rails) et décrypter avec Python
Scraping Web facile avec Python et Ruby
Désactivez les tendances Twitter et ayez une vie confortable sur Twitter! !!
Comparaison de CoffeeScript avec la grammaire JavaScript, Python et Ruby
Gestion des versions de Node, Ruby et Python avec anyenv
Ruby, Python et carte
Python et Ruby se séparent
Avec et sans WSGI
Résolution avec Ruby et Python AtCoder ABC178 D Méthode de planification dynamique
Résolution avec Ruby et Python AtCoder ABC151 D Recherche de priorité de largeur
Résolution avec Ruby et Python AtCoder ABC133 D Somme cumulée
Résolution avec Ruby, Perl, Java et Python AtCoder ATC 002 A
Résolution avec Ruby et Python AtCoder ABC011 C Méthode de planification dynamique
Résolution avec Ruby et Python AtCoder ABC153 E Méthode de planification dynamique
Résolution avec Ruby et Python AtCoder ARC067 C factorisation premier
Résolution avec Ruby, Perl, Java et Python AtCoder ATC 002 B
LaTeX confortable avec sous-système Windows pour Linux et VS Code