[PYTHON] Komfortables Dokumentenleben mit Docutils und Ruby

Komfortables Dokumentenleben mit Docutils und Ruby

Es ist keine ganz neue Geschichte, aber ich werde mich dem Adventskalender anschließen, um zu organisieren, was ich vorher gemacht habe.

0. Ich mag reST

Zunächst mochte ich Setext (strukturierter Text). Natürlich mag ich reST. Wenn Sie die Details nicht angeben, erledigt Markdown die Aufgabe meistens. Wenn Sie jedoch eine Office-Datei erstellen und Anpassungen für den Druck vornehmen möchten, verwende ich reST.

Natürlich, weil es reST ist

• Python
• docutils

Wird genutzt. Die Installationsmethode ist gefaltet. Es ist einfach.

1. Schreiben Sie trotzdem mit rst2html.py + guard

Der erste Schritt besteht darin, "die Vorschau schnell zu drehen".

Also benutze ich Guard, mein Lieblings-Ruby-Tool, das so gut oder besser als reST ist. Dies ist eine Bibliothek zum Überwachen von Dateiänderungen und zum Ausführen verschiedener Aufgaben

1. Klicken Sie in der Guard-Shell auf rst2html.py, um HTML zu generieren
2. Öffnen Sie den resultierenden HTML-Code in einem Browser und zeigen Sie eine Vorschau an. Überwachen Sie jedoch die HTML-Generierung und laden Sie sie automatisch mit Guard-Livereload neu.

Ich werde Sie die beiden Aufgaben von übernehmen lassen. Die folgenden drei Bibliotheken werden tatsächlich verwendet.

• guard/guard
• guard/guard-shell
• guard/guard-livereload

Verwenden Sie als Webserver je nach Bedarf SimpleHTTPServer von Python oder WEBrick von Ruby.

• Bereite die folgende Gemfile und Wache vor
• Wache starten
• Jeder Inhalt ist in Ordnung, also generieren Sie HTML und erfassen Sie mit Livereload
• Sie müssen lediglich die erste Datei bearbeiten

ist.

reST-writing environment with realtime HTML-preview — Gist

2. Generieren und beenden Sie odt mit rst2odt.py + rake

Wenn es kein Problem mit dem Inhalt in der Vorschau gibt, diesmal meine Arbeit

wtnabe/rst2odt_stylesheet

Benutzen. Git klont dies und benennt die erste Zieldatei in sample.rst um. Was dieser Kerl tun kann

• Klicken Sie auf rst2odt.py, um eine ODT-Datei aus reST zu generieren
• Kompilieren Sie das Stylesheet, das beim Generieren der Odt-Datei verwendet wird
• Sie können das Stylesheet auch selbst in XML anpassen
• Öffnen Sie die mit dem Befehl open erstellte Odt-Datei

ist. Leider sind sowohl die reST-Datei als auch die odt-Datei zwei Jahre lang mit dem Namensbeispiel unberührt geblieben, und ich verwende nur den Mac, da ich denke, dass open eine Bibliothek verwenden sollte, die dies abstrahiert. Es ist nicht so, wie es ist.

Passen Sie nach dem Öffnen der odt-Datei den Druckstil an. Wenn Sie zu diesem Zeitpunkt einen Fehler feststellen, korrigieren Sie die erste Datei jedes Mal.

rake open

Es wird ein Fluss sein.

Schließlich denke ich, dass es einfacher ist, sie zu teilen, wenn Sie das PDF aus LibreOffice (OpenOffice.org) exportieren.

3. Zusammenfassung

Es ist nicht sehr einheitlich und meine Rechenaufgabe rst2odt_stylesheet ist nicht sehr vollständig, aber zumindest denke ich, dass es viel einfacher ist, ein Dokument zu schreiben, als plötzlich in Word zu schreiben.

reST ist eine sehr vielseitige Notation, da es eines der Merkmale seines Vorgängers, den Setext, verkörpert: "Es ist nicht unnatürlich, es so wie es ist in eine E-Mail einzubetten", und die Notation der Tabelle ist ebenfalls organisiert. Wenn Sie es auf diese Weise in odt konvertieren und dann in PDF exportieren, wird die Satzstruktur im endgültigen PDF wiedergegeben, sodass auch lange Dokumente leichter zu lesen sind.

Sowohl Katzen als auch Schöpflöffel sind heutzutage Markdown. Warum also nicht versuchen, ein Dokument mit reST zu schreiben?

Bedauerlich ist, dass Verarbeitungssysteme nicht in jeder Sprache wie Markdown verfügbar sind. Da es praktisch nur für Python ist, kann es mit Trac verwendet werden, aber ich denke, es ist schwierig, es von Redmine aus zu verwenden. Ich frage mich, ob jemand es portieren wird