rstpad

RSTPAD

Umstrukturierter Editor mit Live -Vorschau.

Inhalt

• Merkmale
• Bekannte Einschränkungen
• Implementierungsdetails
• Zusammenstellung
  • Voraussetzungen
  • Konfiguration erstellen
  • Windows -Bereitstellung
  • OS X -Bereitstellung
  • Andere Plattformen

Merkmale

• Live -Vorschau mit Autoscroll
• Konfigurierbare Ausrichtung (horizontal / vertikal)
• Suche & Ersetzen
• Symbolleiste mit gemeinsamen Elementen:
  • Überschriften
  • mutig, kursiv
  • Inline -Code
  • Codeblöcke
  • horizontale Regel
  • Listen
  • Link
  • Bild
• Einfügen von hervorgehobenen Codeblöcken (Pygmente)
  • Autocomplete für bekannte Lexer -Namen
• Eingebaute Hilfeseiten
  • Syntax -Cheat -Blatt
  • Richtlinien
• Export in PDF

Bekannte Einschränkungen

• Nur UTF-8-Dokumente

Implementierungsdetails

• Die Anwendung enthält einen eingebetteten Python -Dolmetscher
  • Python -Bibliotheken befinden sich im Verzeichnis / im Bündel der Anwendung
• Die Docutils -Bibliothek wird verwendet, um im laufend
  • Die Bewertung erfolgt in einem separaten Thread
  • Ressourcen/Vorschau/docutils_extensions.py überschreibt einige der Methoden des HTML -Schriftstellers, um zusätzliche Tags und Attribute einzufügen
• Die HTML -Ausgabe wird mit QT WebEngine angezeigt
  • Externe Links werden an QDesktopServices delegiert
  • AutoScroll ist in JavaScript implementiert
  • Die Vorschau ist während des Ladens und Autoscrolling "eingefroren", um reibungslose Übergänge zu ermöglichen (ein zuvor gerenderter Rahmen wird für die Dauer verwendet)

Zusammenstellung

Voraussetzungen

• QT 5.8 & QT Creator
• Python 2.7 (32bit oder 64bit abhängig vom verwendeten Compiler)
• Pygmente (getestet mit 2.1.3)
• DOCUTILS (getestet mit 0,13, Revision 7975)

Konfiguration erstellen

Notiz

• Die unten verwendeten Pfade (wie C:/Python ) sind nur Beispiele. Verwenden Sie die tatsächlichen Pfade :)
• Verwenden Sie Vorwärts -Schrägstriche auf allen Pfaden. Nachlaufströmen auslassen.
• OS X -Hinweise und Beispiele gehen davon aus, dass Python 2.7 mit Homebrew installiert wurde. Ihre Wege können variieren.

Kopieren Sie rstpad.local.pro.dist , nennen Sie es rstpad.local.pro und legen Sie die folgenden Variablen fest:

• PYTHON_LINK
  • Python Linker Flags
  • Windows: -LC:/python/libs -lpython27
  • OS X: Verwenden Sie das Python-Config-Dienstprogramm, um Linker-Flags zu bestimmen:
    • python2.7-config --ldflags
• PYTHON_INCLUDE_PATH
  • Pfad zu einem Verzeichnis, das die Header -Dateien von Python enthält
    • Windows: C:/python/include
    • OS X: /usr/include/python2.7
• PYTHON_SYS_PATH
  • Pfad zu einem Verzeichnis mit:
    • libs.zip - Die Python -Standardbibliothek als Zip -Archiv
    • pygments , docutils - Bibliotheksverzeichnisse (diese können nicht in libs.zip sein)
    • Alle .pyd- , .dll- und .so -Module, die in einer Standard -Python -Installation verfügbar sein sollten
  • .PYC -Dateien sollten ausgeschlossen werden

Windows -Bereitstellung

1. Verwenden Sie das Windows -Bereitstellungswerkzeug mit dem Release Binary, um die erforderlichen DLLs zu holen.

   Beispiel: windeployqt.exe --release --no-translations rstpad.exe

2. Suchen Sie und kopieren Sie die richtige python27.dll -Datei, oder die Anwendung funktioniert nicht auf Maschinen, ohne dass Python 2.7 installiert ist.

   • Mögliche Standorte hängen davon ab, wie Sie Python installiert haben und in seiner Version:
     • C: Windows System Python27.dll
     • C: Windows Sywow64 Python27.dll
   • Stellen Sie sicher, dass Sie die richtige Version (32 vs 64bit) usingieren (32 gegenüber 64bit).

OS X -Bereitstellung

Verwenden Sie das Mac -Bereitstellungstool, um die resultierende Anwendung in eine .dmg -Datei umzuwandeln:

 MacDeployqt rstpad.app -dmg

Andere Plattformen

Noch nicht getestet. Du bist alleine :)